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

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-BcA8F0S-.d.cts} +16 -9
  11. package/dist/Cron-BcA8F0S-.d.cts.map +1 -0
  12. package/dist/{Cron-zsoSAwZo.d.cts → Cron-z2CiuQT_.d.mts} +15 -8
  13. package/dist/Cron-z2CiuQT_.d.mts.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-BZvo34X2.d.cts +47 -0
  17. package/dist/CronBuilder-BZvo34X2.d.cts.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-BbgKo8OI.d.mts +47 -0
  21. package/dist/CronBuilder-BbgKo8OI.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-oS-Fe3d_.d.mts → Endpoint-CIDUreMW.d.mts} +104 -23
  25. package/dist/Endpoint-CIDUreMW.d.mts.map +1 -0
  26. package/dist/{Endpoint-DBflWAe4.d.cts → Endpoint-COisi9jw.d.cts} +101 -20
  27. package/dist/Endpoint-COisi9jw.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/{index-Cc4kKPag.d.mts → EndpointFactory-CIM80WIK.d.mts} +189 -106
  33. package/dist/EndpointFactory-CIM80WIK.d.mts.map +1 -0
  34. package/dist/{index-C1ZwNOOk.d.cts → EndpointFactory-CfBg6jJE.d.cts} +187 -104
  35. package/dist/EndpointFactory-CfBg6jJE.d.cts.map +1 -0
  36. package/dist/{EndpointFactory-CLvWuHyt.cjs → EndpointFactory-Cf_Cs1ym.cjs} +309 -51
  37. package/dist/EndpointFactory-Cf_Cs1ym.cjs.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-Ci_Cc-WZ.d.mts +129 -0
  47. package/dist/ObjectSubscriberBuilder-Ci_Cc-WZ.d.mts.map +1 -0
  48. package/dist/ObjectSubscriberBuilder-DWtLxfAJ.d.cts +129 -0
  49. package/dist/ObjectSubscriberBuilder-DWtLxfAJ.d.cts.map +1 -0
  50. package/dist/ProcessorBuilder-CdLwJK4k.d.mts +216 -0
  51. package/dist/ProcessorBuilder-CdLwJK4k.d.mts.map +1 -0
  52. package/dist/ProcessorBuilder-ClD7tmEe.d.cts +216 -0
  53. package/dist/ProcessorBuilder-ClD7tmEe.d.cts.map +1 -0
  54. package/dist/Queue-9Hh20ZCk.mjs +104 -0
  55. package/dist/Queue-9Hh20ZCk.mjs.map +1 -0
  56. package/dist/{Queue-D9X6OoON.d.mts → Queue-B8HGg439.d.mts} +42 -41
  57. package/dist/Queue-B8HGg439.d.mts.map +1 -0
  58. package/dist/{Queue-DYPB2KWL.d.cts → Queue-C4rijiM7.d.cts} +43 -42
  59. package/dist/Queue-C4rijiM7.d.cts.map +1 -0
  60. package/dist/Queue-W1wueijP.cjs +109 -0
  61. package/dist/Queue-W1wueijP.cjs.map +1 -0
  62. package/dist/QueueBuilder-BDcv9B71.cjs +135 -0
  63. package/dist/QueueBuilder-BDcv9B71.cjs.map +1 -0
  64. package/dist/QueueBuilder-CjULiiDN.d.mts +75 -0
  65. package/dist/QueueBuilder-CjULiiDN.d.mts.map +1 -0
  66. package/dist/QueueBuilder-CrZL8HHs.mjs +118 -0
  67. package/dist/QueueBuilder-CrZL8HHs.mjs.map +1 -0
  68. package/dist/QueueBuilder-Dacm9qAv.d.cts +75 -0
  69. package/dist/QueueBuilder-Dacm9qAv.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-BGoOeCT6.mjs +99 -0
  79. package/dist/Topic-BGoOeCT6.mjs.map +1 -0
  80. package/dist/Topic-DLCZBNwK.cjs +104 -0
  81. package/dist/Topic-DLCZBNwK.cjs.map +1 -0
  82. package/dist/adaptors/aws.cjs +147 -168
  83. package/dist/adaptors/aws.cjs.map +1 -1
  84. package/dist/adaptors/aws.d.cts +57 -48
  85. package/dist/adaptors/aws.d.cts.map +1 -1
  86. package/dist/adaptors/aws.d.mts +58 -49
  87. package/dist/adaptors/aws.d.mts.map +1 -1
  88. package/dist/adaptors/aws.mjs +142 -164
  89. package/dist/adaptors/aws.mjs.map +1 -1
  90. package/dist/adaptors/awsWebsocket.cjs +354 -0
  91. package/dist/adaptors/awsWebsocket.cjs.map +1 -0
  92. package/dist/adaptors/awsWebsocket.d.cts +156 -0
  93. package/dist/adaptors/awsWebsocket.d.cts.map +1 -0
  94. package/dist/adaptors/awsWebsocket.d.mts +156 -0
  95. package/dist/adaptors/awsWebsocket.d.mts.map +1 -0
  96. package/dist/adaptors/awsWebsocket.mjs +347 -0
  97. package/dist/adaptors/awsWebsocket.mjs.map +1 -0
  98. package/dist/adaptors/hono.cjs +1 -1
  99. package/dist/adaptors/hono.d.cts +8 -7
  100. package/dist/adaptors/hono.d.cts.map +1 -1
  101. package/dist/adaptors/hono.d.mts +10 -9
  102. package/dist/adaptors/hono.d.mts.map +1 -1
  103. package/dist/adaptors/hono.mjs +1 -1
  104. package/dist/adaptors/testing.cjs +1174 -41
  105. package/dist/adaptors/testing.cjs.map +1 -1
  106. package/dist/adaptors/testing.d.cts +517 -40
  107. package/dist/adaptors/testing.d.cts.map +1 -1
  108. package/dist/adaptors/testing.d.mts +517 -40
  109. package/dist/adaptors/testing.d.mts.map +1 -1
  110. package/dist/adaptors/testing.mjs +1140 -36
  111. package/dist/adaptors/testing.mjs.map +1 -1
  112. package/dist/auth-CutSfNlr.d.mts +274 -0
  113. package/dist/auth-CutSfNlr.d.mts.map +1 -0
  114. package/dist/auth-b9ADezz9.d.cts +274 -0
  115. package/dist/auth-b9ADezz9.d.cts.map +1 -0
  116. package/dist/auth.cjs +311 -26
  117. package/dist/auth.cjs.map +1 -1
  118. package/dist/auth.d.cts +2 -104
  119. package/dist/auth.d.mts +2 -104
  120. package/dist/auth.mjs +307 -28
  121. package/dist/auth.mjs.map +1 -1
  122. package/dist/cache-9wLNSy3O.d.cts +44 -0
  123. package/dist/cache-9wLNSy3O.d.cts.map +1 -0
  124. package/dist/cache-BFPs_CGs.d.mts +44 -0
  125. package/dist/cache-BFPs_CGs.d.mts.map +1 -0
  126. package/dist/cache.cjs +4 -20
  127. package/dist/cache.cjs.map +1 -1
  128. package/dist/cache.d.cts +2 -43
  129. package/dist/cache.d.mts +2 -43
  130. package/dist/cache.mjs +4 -20
  131. package/dist/cache.mjs.map +1 -1
  132. package/dist/cipher-C1lEFX63.mjs +225 -0
  133. package/dist/cipher-C1lEFX63.mjs.map +1 -0
  134. package/dist/cipher-CVxfwLjk.cjs +332 -0
  135. package/dist/cipher-CVxfwLjk.cjs.map +1 -0
  136. package/dist/cipher-DSDxPRIp.d.cts +106 -0
  137. package/dist/cipher-DSDxPRIp.d.cts.map +1 -0
  138. package/dist/cipher-DSDxPRIp.d.mts +106 -0
  139. package/dist/cipher-DSDxPRIp.d.mts.map +1 -0
  140. package/dist/{construct-interface-DPlxfpoS.d.mts → construct-interface-CVoejIpo.d.cts} +79 -8
  141. package/dist/construct-interface-CVoejIpo.d.cts.map +1 -0
  142. package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-Nw5Dt9AC.d.mts} +79 -8
  143. package/dist/construct-interface-Nw5Dt9AC.d.mts.map +1 -0
  144. package/dist/construct-interface.cjs +62 -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 +59 -5
  149. package/dist/construct-interface.mjs.map +1 -1
  150. package/dist/credential-B80mOxwT.mjs +222 -0
  151. package/dist/credential-B80mOxwT.mjs.map +1 -0
  152. package/dist/credential-RlgbzZAc.cjs +257 -0
  153. package/dist/credential-RlgbzZAc.cjs.map +1 -0
  154. package/dist/credential.cjs +7 -129
  155. package/dist/credential.d.cts +2 -58
  156. package/dist/credential.d.mts +2 -58
  157. package/dist/credential.mjs +2 -128
  158. package/dist/crons/index.cjs +127 -1
  159. package/dist/crons/index.cjs.map +1 -1
  160. package/dist/crons/index.d.cts +43 -3
  161. package/dist/crons/index.d.cts.map +1 -1
  162. package/dist/crons/index.d.mts +43 -3
  163. package/dist/crons/index.d.mts.map +1 -1
  164. package/dist/crons/index.mjs +126 -2
  165. package/dist/crons/index.mjs.map +1 -1
  166. package/dist/database/kysely.cjs +3 -194
  167. package/dist/database/kysely.d.cts +2 -149
  168. package/dist/database/kysely.d.mts +2 -149
  169. package/dist/database/kysely.mjs +2 -192
  170. package/dist/email.cjs +24 -17
  171. package/dist/email.cjs.map +1 -1
  172. package/dist/email.d.cts +15 -5
  173. package/dist/email.d.cts.map +1 -1
  174. package/dist/email.d.mts +16 -6
  175. package/dist/email.d.mts.map +1 -1
  176. package/dist/email.mjs +23 -17
  177. package/dist/email.mjs.map +1 -1
  178. package/dist/encryption/kms.cjs +95 -0
  179. package/dist/encryption/kms.cjs.map +1 -0
  180. package/dist/encryption/kms.d.cts +7 -0
  181. package/dist/encryption/kms.d.cts.map +1 -0
  182. package/dist/encryption/kms.d.mts +7 -0
  183. package/dist/encryption/kms.d.mts.map +1 -0
  184. package/dist/encryption/kms.mjs +93 -0
  185. package/dist/encryption/kms.mjs.map +1 -0
  186. package/dist/encryption.cjs +116 -0
  187. package/dist/encryption.cjs.map +1 -0
  188. package/dist/encryption.d.cts +37 -0
  189. package/dist/encryption.d.cts.map +1 -0
  190. package/dist/encryption.d.mts +37 -0
  191. package/dist/encryption.d.mts.map +1 -0
  192. package/dist/encryption.mjs +101 -0
  193. package/dist/encryption.mjs.map +1 -0
  194. package/dist/endpoints/index.cjs +32 -10
  195. package/dist/endpoints/index.d.cts +106 -3
  196. package/dist/endpoints/index.d.cts.map +1 -0
  197. package/dist/endpoints/index.d.mts +106 -3
  198. package/dist/endpoints/index.d.mts.map +1 -0
  199. package/dist/endpoints/index.mjs +6 -4
  200. package/dist/expire-C586zznE.d.cts +38 -0
  201. package/dist/expire-C586zznE.d.cts.map +1 -0
  202. package/dist/expire-C586zznE.d.mts +38 -0
  203. package/dist/expire-C586zznE.d.mts.map +1 -0
  204. package/dist/external-api.cjs +106 -0
  205. package/dist/external-api.cjs.map +1 -0
  206. package/dist/external-api.d.cts +2 -0
  207. package/dist/external-api.d.mts +2 -0
  208. package/dist/external-api.mjs +103 -0
  209. package/dist/external-api.mjs.map +1 -0
  210. package/dist/fake-JI5uN1SF.d.cts +201 -0
  211. package/dist/fake-JI5uN1SF.d.cts.map +1 -0
  212. package/dist/fake-zpuXpBmY.d.mts +201 -0
  213. package/dist/fake-zpuXpBmY.d.mts.map +1 -0
  214. package/dist/file-server.cjs +170 -49
  215. package/dist/file-server.cjs.map +1 -1
  216. package/dist/file-server.d.cts +148 -16
  217. package/dist/file-server.d.cts.map +1 -1
  218. package/dist/file-server.d.mts +148 -16
  219. package/dist/file-server.d.mts.map +1 -1
  220. package/dist/file-server.mjs +168 -51
  221. package/dist/file-server.mjs.map +1 -1
  222. package/dist/functions/index.cjs +1 -1
  223. package/dist/functions/index.d.cts +2 -1
  224. package/dist/functions/index.d.mts +2 -1
  225. package/dist/functions/index.mjs +1 -1
  226. package/dist/{functions-C53GW2eQ.mjs → functions-BvIDQKAA.mjs} +117 -22
  227. package/dist/functions-BvIDQKAA.mjs.map +1 -0
  228. package/dist/{functions-B6qCvfmy.cjs → functions-DLF6-IK8.cjs} +122 -18
  229. package/dist/functions-DLF6-IK8.cjs.map +1 -0
  230. package/dist/inbox-CXLU7h_8.d.cts +195 -0
  231. package/dist/inbox-CXLU7h_8.d.cts.map +1 -0
  232. package/dist/inbox-DYFsLd9A.d.mts +195 -0
  233. package/dist/inbox-DYFsLd9A.d.mts.map +1 -0
  234. package/dist/inbox.cjs +291 -0
  235. package/dist/inbox.cjs.map +1 -0
  236. package/dist/inbox.d.cts +2 -0
  237. package/dist/inbox.d.mts +2 -0
  238. package/dist/inbox.mjs +283 -0
  239. package/dist/inbox.mjs.map +1 -0
  240. package/dist/index-BpE9_6l5.d.mts +115 -0
  241. package/dist/index-BpE9_6l5.d.mts.map +1 -0
  242. package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
  243. package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
  244. package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
  245. package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
  246. package/dist/index-zRChehJ9.d.cts +115 -0
  247. package/dist/index-zRChehJ9.d.cts.map +1 -0
  248. package/dist/index.cjs +4 -1
  249. package/dist/index.d.cts +26 -3
  250. package/dist/index.d.cts.map +1 -0
  251. package/dist/index.d.mts +26 -3
  252. package/dist/index.d.mts.map +1 -0
  253. package/dist/index.mjs +3 -2
  254. package/dist/kysely-5PAqFBzo.d.mts +216 -0
  255. package/dist/kysely-5PAqFBzo.d.mts.map +1 -0
  256. package/dist/kysely-Bc9xzaik.mjs +371 -0
  257. package/dist/kysely-Bc9xzaik.mjs.map +1 -0
  258. package/dist/kysely-D7f6J2lh.cjs +384 -0
  259. package/dist/kysely-D7f6J2lh.cjs.map +1 -0
  260. package/dist/kysely-lxNUBSTP.d.cts +216 -0
  261. package/dist/kysely-lxNUBSTP.d.cts.map +1 -0
  262. package/dist/{telemetry-DGcFlVpB.d.cts → lambdaTelemetry-8vnmVZQ5.d.cts} +2 -2
  263. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +1 -0
  264. package/dist/{telemetry-DGcFlVpB.d.mts → lambdaTelemetry-8vnmVZQ5.d.mts} +2 -2
  265. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +1 -0
  266. package/dist/mobile-app.cjs +79 -0
  267. package/dist/mobile-app.cjs.map +1 -0
  268. package/dist/mobile-app.d.cts +78 -0
  269. package/dist/mobile-app.d.cts.map +1 -0
  270. package/dist/mobile-app.d.mts +78 -0
  271. package/dist/mobile-app.d.mts.map +1 -0
  272. package/dist/mobile-app.mjs +78 -0
  273. package/dist/mobile-app.mjs.map +1 -0
  274. package/dist/object-storage.cjs +50 -7
  275. package/dist/object-storage.cjs.map +1 -1
  276. package/dist/object-storage.d.cts +37 -3
  277. package/dist/object-storage.d.cts.map +1 -1
  278. package/dist/object-storage.d.mts +37 -3
  279. package/dist/object-storage.d.mts.map +1 -1
  280. package/dist/object-storage.mjs +49 -9
  281. package/dist/object-storage.mjs.map +1 -1
  282. package/dist/optionalPeers-D7Wt6dnF.mjs +140 -0
  283. package/dist/optionalPeers-D7Wt6dnF.mjs.map +1 -0
  284. package/dist/optionalPeers-DuNQXXe1.cjs +223 -0
  285. package/dist/optionalPeers-DuNQXXe1.cjs.map +1 -0
  286. package/dist/origins-BjxYht13.cjs +96 -0
  287. package/dist/origins-BjxYht13.cjs.map +1 -0
  288. package/dist/origins-Boc9qbo-.mjs +73 -0
  289. package/dist/origins-Boc9qbo-.mjs.map +1 -0
  290. package/dist/pattern-C1CEcglD.mjs +241 -0
  291. package/dist/pattern-C1CEcglD.mjs.map +1 -0
  292. package/dist/pattern-QFaUIr77.cjs +288 -0
  293. package/dist/pattern-QFaUIr77.cjs.map +1 -0
  294. package/dist/privateAddress-Bg5fUsbp.mjs +21 -0
  295. package/dist/privateAddress-Bg5fUsbp.mjs.map +1 -0
  296. package/dist/privateAddress-CqGyuFHn.cjs +26 -0
  297. package/dist/privateAddress-CqGyuFHn.cjs.map +1 -0
  298. package/dist/processors/index.cjs +214 -0
  299. package/dist/processors/index.cjs.map +1 -0
  300. package/dist/processors/index.d.cts +78 -0
  301. package/dist/processors/index.d.cts.map +1 -0
  302. package/dist/processors/index.d.mts +78 -0
  303. package/dist/processors/index.d.mts.map +1 -0
  304. package/dist/processors/index.mjs +193 -0
  305. package/dist/processors/index.mjs.map +1 -0
  306. package/dist/queue/index.cjs +5 -192
  307. package/dist/queue/index.d.cts +3 -53
  308. package/dist/queue/index.d.mts +3 -53
  309. package/dist/queue/index.mjs +3 -190
  310. package/dist/random-password.cjs +86 -0
  311. package/dist/random-password.cjs.map +1 -0
  312. package/dist/random-password.d.cts +30 -0
  313. package/dist/random-password.d.cts.map +1 -0
  314. package/dist/random-password.d.mts +30 -0
  315. package/dist/random-password.d.mts.map +1 -0
  316. package/dist/random-password.mjs +84 -0
  317. package/dist/random-password.mjs.map +1 -0
  318. package/dist/readOnlyStorage-C7bCe-z5.cjs +101 -0
  319. package/dist/readOnlyStorage-C7bCe-z5.cjs.map +1 -0
  320. package/dist/readOnlyStorage-DMCeLuS2.mjs +78 -0
  321. package/dist/readOnlyStorage-DMCeLuS2.mjs.map +1 -0
  322. package/dist/readRequestBody-BmKnPl0a.mjs +293 -0
  323. package/dist/readRequestBody-BmKnPl0a.mjs.map +1 -0
  324. package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-CN9GVdeE.cjs} +141 -47
  325. package/dist/readRequestBody-CN9GVdeE.cjs.map +1 -0
  326. package/dist/{processAudits-D_2W5x8k.cjs → requestLogger-CnoYd-Ah.cjs} +63 -3
  327. package/dist/requestLogger-CnoYd-Ah.cjs.map +1 -0
  328. package/dist/{processAudits-BpRlPQMW.mjs → requestLogger-D2JS7pPM.mjs} +51 -3
  329. package/dist/requestLogger-D2JS7pPM.mjs.map +1 -0
  330. package/dist/rest-api.cjs +100 -73
  331. package/dist/rest-api.cjs.map +1 -1
  332. package/dist/rest-api.d.cts +83 -59
  333. package/dist/rest-api.d.cts.map +1 -1
  334. package/dist/rest-api.d.mts +83 -59
  335. package/dist/rest-api.d.mts.map +1 -1
  336. package/dist/rest-api.mjs +97 -76
  337. package/dist/rest-api.mjs.map +1 -1
  338. package/dist/runSubscriber-HEqXkin1.mjs +117 -0
  339. package/dist/runSubscriber-HEqXkin1.mjs.map +1 -0
  340. package/dist/runSubscriber-sVJfLA0-.cjs +134 -0
  341. package/dist/runSubscriber-sVJfLA0-.cjs.map +1 -0
  342. package/dist/shutdown-BMJmAhSt.cjs +38 -0
  343. package/dist/shutdown-BMJmAhSt.cjs.map +1 -0
  344. package/dist/shutdown-C7xa8x9S.mjs +27 -0
  345. package/dist/shutdown-C7xa8x9S.mjs.map +1 -0
  346. package/dist/site.cjs +140 -10
  347. package/dist/site.cjs.map +1 -1
  348. package/dist/site.d.cts +156 -3
  349. package/dist/site.d.cts.map +1 -1
  350. package/dist/site.d.mts +156 -3
  351. package/dist/site.d.mts.map +1 -1
  352. package/dist/site.mjs +120 -13
  353. package/dist/site.mjs.map +1 -1
  354. package/dist/stages-DaTaoQei.d.cts +73 -0
  355. package/dist/stages-DaTaoQei.d.cts.map +1 -0
  356. package/dist/stages-DaTaoQei.d.mts +73 -0
  357. package/dist/stages-DaTaoQei.d.mts.map +1 -0
  358. package/dist/subscribers/index.cjs +134 -1
  359. package/dist/subscribers/index.cjs.map +1 -0
  360. package/dist/subscribers/index.d.cts +74 -3
  361. package/dist/subscribers/index.d.cts.map +1 -0
  362. package/dist/subscribers/index.d.mts +74 -3
  363. package/dist/subscribers/index.d.mts.map +1 -0
  364. package/dist/subscribers/index.mjs +132 -2
  365. package/dist/subscribers/index.mjs.map +1 -0
  366. package/dist/telemetry-BbLyS7ln.d.cts +57 -0
  367. package/dist/telemetry-BbLyS7ln.d.cts.map +1 -0
  368. package/dist/telemetry-DWX-qKUh.d.mts +57 -0
  369. package/dist/telemetry-DWX-qKUh.d.mts.map +1 -0
  370. package/dist/telemetry.cjs +64 -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 +63 -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-9ndLBolx.d.cts +1207 -0
  385. package/dist/websocket-api-9ndLBolx.d.cts.map +1 -0
  386. package/dist/websocket-api-BPPXF79i.d.mts +1207 -0
  387. package/dist/websocket-api-BPPXF79i.d.mts.map +1 -0
  388. package/dist/websocket-api-C6LGg9-D.mjs +1716 -0
  389. package/dist/websocket-api-C6LGg9-D.mjs.map +1 -0
  390. package/dist/websocket-api-CoKPJJRl.cjs +1895 -0
  391. package/dist/websocket-api-CoKPJJRl.cjs.map +1 -0
  392. package/dist/websocket-api.cjs +42 -0
  393. package/dist/websocket-api.d.cts +2 -0
  394. package/dist/websocket-api.d.mts +2 -0
  395. package/dist/websocket-api.mjs +3 -0
  396. package/dist/worker.cjs +174 -32
  397. package/dist/worker.cjs.map +1 -1
  398. package/dist/worker.d.cts +147 -47
  399. package/dist/worker.d.cts.map +1 -1
  400. package/dist/worker.d.mts +147 -47
  401. package/dist/worker.d.mts.map +1 -1
  402. package/dist/worker.mjs +175 -33
  403. package/dist/worker.mjs.map +1 -1
  404. package/package.json +180 -43
  405. package/dist/Construct-BeYVu_QF.mjs.map +0 -1
  406. package/dist/Construct-DfbwIntp.d.cts +0 -115
  407. package/dist/Construct-DfbwIntp.d.cts.map +0 -1
  408. package/dist/Construct-DqdlARxq.cjs.map +0 -1
  409. package/dist/Construct-l5aOn_jv.d.mts +0 -115
  410. package/dist/Construct-l5aOn_jv.d.mts.map +0 -1
  411. package/dist/Cron-l4Wlz6G9.d.mts.map +0 -1
  412. package/dist/Cron-zsoSAwZo.d.cts.map +0 -1
  413. package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
  414. package/dist/CronBuilder-CyT71Nzg.d.cts +0 -41
  415. package/dist/CronBuilder-CyT71Nzg.d.cts.map +0 -1
  416. package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
  417. package/dist/CronBuilder-UoNgFe8S.d.mts +0 -41
  418. package/dist/CronBuilder-UoNgFe8S.d.mts.map +0 -1
  419. package/dist/Endpoint-BpZHtJ2W.cjs +0 -1689
  420. package/dist/Endpoint-BpZHtJ2W.cjs.map +0 -1
  421. package/dist/Endpoint-DBflWAe4.d.cts.map +0 -1
  422. package/dist/Endpoint-ONsly_dq.mjs +0 -1671
  423. package/dist/Endpoint-ONsly_dq.mjs.map +0 -1
  424. package/dist/Endpoint-oS-Fe3d_.d.mts.map +0 -1
  425. package/dist/EndpointFactory-Bm3aKRdV.mjs.map +0 -1
  426. package/dist/EndpointFactory-CLvWuHyt.cjs.map +0 -1
  427. package/dist/HonoEndpointAdaptor-92zavCsV.cjs.map +0 -1
  428. package/dist/HonoEndpointAdaptor-yYaU7jVJ.mjs.map +0 -1
  429. package/dist/Queue-D9X6OoON.d.mts.map +0 -1
  430. package/dist/Queue-DYPB2KWL.d.cts.map +0 -1
  431. package/dist/Subscriber-C4heaAyO.d.mts +0 -51
  432. package/dist/Subscriber-C4heaAyO.d.mts.map +0 -1
  433. package/dist/Subscriber-CotDUELC.d.cts +0 -51
  434. package/dist/Subscriber-CotDUELC.d.cts.map +0 -1
  435. package/dist/SubscriberBuilder-BEv0eoHy.d.cts +0 -59
  436. package/dist/SubscriberBuilder-BEv0eoHy.d.cts.map +0 -1
  437. package/dist/SubscriberBuilder-C0ZEtGDI.cjs +0 -125
  438. package/dist/SubscriberBuilder-C0ZEtGDI.cjs.map +0 -1
  439. package/dist/SubscriberBuilder-h7B_cHMr.mjs +0 -114
  440. package/dist/SubscriberBuilder-h7B_cHMr.mjs.map +0 -1
  441. package/dist/SubscriberBuilder-tyH5yTk5.d.mts +0 -59
  442. package/dist/SubscriberBuilder-tyH5yTk5.d.mts.map +0 -1
  443. package/dist/Topic-DEVGo0Dm.d.cts +0 -89
  444. package/dist/Topic-DEVGo0Dm.d.cts.map +0 -1
  445. package/dist/Topic-zk_6Gthr.d.mts +0 -89
  446. package/dist/Topic-zk_6Gthr.d.mts.map +0 -1
  447. package/dist/auth.d.cts.map +0 -1
  448. package/dist/auth.d.mts.map +0 -1
  449. package/dist/cache.d.cts.map +0 -1
  450. package/dist/cache.d.mts.map +0 -1
  451. package/dist/construct-interface-DPlxfpoS.d.mts.map +0 -1
  452. package/dist/construct-interface-DgXTJcOD.d.cts.map +0 -1
  453. package/dist/credential.cjs.map +0 -1
  454. package/dist/credential.d.cts.map +0 -1
  455. package/dist/credential.d.mts.map +0 -1
  456. package/dist/credential.mjs.map +0 -1
  457. package/dist/database/kysely.cjs.map +0 -1
  458. package/dist/database/kysely.d.cts.map +0 -1
  459. package/dist/database/kysely.d.mts.map +0 -1
  460. package/dist/database/kysely.mjs.map +0 -1
  461. package/dist/functions-B6qCvfmy.cjs.map +0 -1
  462. package/dist/functions-C53GW2eQ.mjs.map +0 -1
  463. package/dist/index-B2urf3YI.d.cts +0 -26
  464. package/dist/index-B2urf3YI.d.cts.map +0 -1
  465. package/dist/index-C1ZwNOOk.d.cts.map +0 -1
  466. package/dist/index-Cc4kKPag.d.mts.map +0 -1
  467. package/dist/index-DMCDvnsM.d.mts +0 -26
  468. package/dist/index-DMCDvnsM.d.mts.map +0 -1
  469. package/dist/index-D_frT6MP.d.cts +0 -165
  470. package/dist/index-D_frT6MP.d.cts.map +0 -1
  471. package/dist/index-DcyIYbDS.d.mts +0 -165
  472. package/dist/index-DcyIYbDS.d.mts.map +0 -1
  473. package/dist/lazyAccessors-BHtcqgz2.mjs +0 -211
  474. package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
  475. package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
  476. package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
  477. package/dist/processAudits-D_2W5x8k.cjs.map +0 -1
  478. package/dist/queue/index.cjs.map +0 -1
  479. package/dist/queue/index.d.cts.map +0 -1
  480. package/dist/queue/index.d.mts.map +0 -1
  481. package/dist/queue/index.mjs.map +0 -1
  482. package/dist/telemetry-DGcFlVpB.d.cts.map +0 -1
  483. package/dist/telemetry-DGcFlVpB.d.mts.map +0 -1
  484. package/dist/topic/index.cjs.map +0 -1
  485. package/dist/topic/index.mjs.map +0 -1
@@ -1,4 +1,137 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_SubscriberBuilder = require("../SubscriberBuilder-C0ZEtGDI.cjs");
2
+ const require_SubscriberBuilder = require("../SubscriberBuilder-DJEvNRdD.cjs");
3
+ const require_runSubscriber = require("../runSubscriber-sVJfLA0-.cjs");
4
+ let _geekmidas_events = require("@geekmidas/events");
5
+ let _geekmidas_services = require("@geekmidas/services");
6
+ let _geekmidas_errors = require("@geekmidas/errors");
7
+ let _geekmidas_events_sns_message = require("@geekmidas/events/sns/message");
8
+ //#region src/subscribers/SnsPushSubscriberAdaptor.ts
9
+ /**
10
+ * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
11
+ * poller.
12
+ *
13
+ * The notification is read as the Lambda event SNS would have invoked a
14
+ * function with, and run through the same parsing, services and handler as the
15
+ * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
16
+ * server serving this route has no reason to install `@middy/core`.
17
+ */
18
+ var SnsPushSubscriberAdaptor = class {
19
+ envParser;
20
+ subscriber;
21
+ options;
22
+ constructor(envParser, subscriber, options) {
23
+ this.envParser = envParser;
24
+ this.subscriber = subscriber;
25
+ this.options = options;
26
+ }
27
+ async handle(body, request = {}) {
28
+ const message = body;
29
+ if (typeof message?.Type !== "string" || !message.TopicArn) return refuse(400, "not an SNS message");
30
+ if (message.TopicArn !== this.options.topicArn) return refuse(403, `not subscribed to ${message.TopicArn}`);
31
+ if (this.options.verify) try {
32
+ await (0, _geekmidas_events_sns_message.verifySnsMessage)(message);
33
+ } catch (error) {
34
+ this.subscriber.logger.warn({
35
+ err: error,
36
+ topicArn: message.TopicArn
37
+ }, "Refused an SNS message that did not verify");
38
+ return refuse(403, error.name);
39
+ }
40
+ switch (message.Type) {
41
+ case "SubscriptionConfirmation":
42
+ if (this.options.confirm) {
43
+ await this.options.confirm(message);
44
+ this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
45
+ return {
46
+ status: 200,
47
+ body: { status: "confirmed" }
48
+ };
49
+ }
50
+ await (0, _geekmidas_events_sns_message.confirmSnsSubscription)(this.options.emulatorEndpoint && message.SubscribeURL ? {
51
+ ...message,
52
+ SubscribeURL: throughEndpoint(message.SubscribeURL, this.options.emulatorEndpoint)
53
+ } : message);
54
+ this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
55
+ return {
56
+ status: 200,
57
+ body: { status: "confirmed" }
58
+ };
59
+ case "Notification":
60
+ if (this.options.subscriptionArn && request.subscriptionArn !== this.options.subscriptionArn) {
61
+ this.subscriber.logger.warn({
62
+ topicArn: message.TopicArn,
63
+ subscriptionArn: request.subscriptionArn
64
+ }, "Refused an SNS notification from a subscription the deploy did not make");
65
+ return refuse(403, "not the recorded subscription");
66
+ }
67
+ try {
68
+ await this.notify(message);
69
+ return {
70
+ status: 200,
71
+ body: { status: "ok" }
72
+ };
73
+ } catch (error) {
74
+ return refuse(500, error.name);
75
+ }
76
+ default: return {
77
+ status: 200,
78
+ body: { status: "ignored" }
79
+ };
80
+ }
81
+ }
82
+ async notify(message) {
83
+ const requestId = message.MessageId;
84
+ const logger = this.subscriber.logger.child({ requestId });
85
+ await (0, _geekmidas_services.runWithRequestContext)({
86
+ logger,
87
+ requestId,
88
+ startTime: Date.now(),
89
+ operation: `subscriber ${this.subscriber.topicName ?? "sns"}`
90
+ }, () => (0, _geekmidas_events.consumeTraced)({
91
+ system: "aws_sns",
92
+ destination: this.subscriber.topicName ?? message.TopicArn.split(":").pop() ?? message.TopicArn,
93
+ type: message.MessageAttributes?.type?.Value,
94
+ messageId: message.MessageId
95
+ }, (0, _geekmidas_events.carrierFromAttributes)(message.MessageAttributes), () => this.run(message, logger)));
96
+ }
97
+ async run(message, logger) {
98
+ try {
99
+ const { services, db } = await require_runSubscriber.subscriberContext(this.subscriber, this.envParser);
100
+ const events = await require_runSubscriber.subscribedEvents(this.subscriber, (0, _geekmidas_events_sns_message.toSnsEvent)(message), logger);
101
+ await require_runSubscriber.runSubscriber(this.subscriber, {
102
+ events,
103
+ services,
104
+ logger,
105
+ db
106
+ });
107
+ } catch (error) {
108
+ logger.error(error, "Error processing subscriber");
109
+ throw (0, _geekmidas_errors.wrapError)(error);
110
+ }
111
+ }
112
+ };
113
+ /** `url`, sent to `endpoint`'s origin instead of its own. */
114
+ function throughEndpoint(url, endpoint) {
115
+ const target = new URL(url);
116
+ const origin = new URL(endpoint);
117
+ target.protocol = origin.protocol;
118
+ target.host = origin.host;
119
+ return target.toString();
120
+ }
121
+ function refuse(status, error) {
122
+ return {
123
+ status,
124
+ body: {
125
+ status: "refused",
126
+ error
127
+ }
128
+ };
129
+ }
130
+ //#endregion
131
+ exports.ObjectSubscriberBuilder = require_SubscriberBuilder.ObjectSubscriberBuilder;
132
+ exports.ObjectSubscriberHasNoEvents = require_SubscriberBuilder.ObjectSubscriberHasNoEvents;
133
+ exports.SnsPushSubscriberAdaptor = SnsPushSubscriberAdaptor;
3
134
  exports.Subscriber = require_SubscriberBuilder.Subscriber;
4
135
  exports.SubscriberBuilder = require_SubscriberBuilder.SubscriberBuilder;
136
+
137
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.cjs","names":["verifySnsMessage","confirmSnsSubscription","runWithRequestContext","consumeTraced","carrierFromAttributes","subscriberContext","subscribedEvents","toSnsEvent","runSubscriber","wrapError"],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport { wrapError } from '@geekmidas/errors';\nimport { carrierFromAttributes, consumeTraced } from '@geekmidas/events';\nimport {\n\tconfirmSnsSubscription,\n\ttype SnsHttpMessage,\n\ttoSnsEvent,\n\tverifySnsMessage,\n} from '@geekmidas/events/sns/message';\nimport { runWithRequestContext } from '@geekmidas/services';\nimport {\n\trunSubscriber,\n\tsubscribedEvents,\n\tsubscriberContext,\n} from './runSubscriber';\nimport type { Subscriber } from './Subscriber';\n\nexport interface SnsPushOptions {\n\t/** The topic this subscriber is subscribed to. Anything else is refused. */\n\ttopicArn: string;\n\t/**\n\t * Verify each message's signature. Off only against an emulator, which\n\t * signs nothing — decided by the connection string's endpoint, never by\n\t * anything the request says about itself.\n\t */\n\tverify: boolean;\n\t/**\n\t * The emulator's address, as this server was configured with it. An\n\t * emulator names itself in `SubscribeURL` by the port it listens on inside\n\t * its container, which is not the port published to the host — so against\n\t * one, the confirmation is sent here instead. From configuration, never\n\t * from the request.\n\t */\n\temulatorEndpoint?: string;\n\t/**\n\t * The subscription the deploy made for this route, as it recorded it\n\t * (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its\n\t * `x-amz-sns-subscription-arn` header is refused — a subscription someone\n\t * added by hand, pointing at this route.\n\t *\n\t * Defence in depth, not authentication: SNS does not sign its headers.\n\t * What authenticates a message is its signature and its `TopicArn`.\n\t */\n\tsubscriptionArn?: string;\n\t/**\n\t * How a confirmation is confirmed. By visiting its `SubscribeURL` when\n\t * unset — what an emulator takes. Against SNS itself, the server confirms\n\t * through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`\n\t * every notification carries cannot cut the route off.\n\t */\n\tconfirm?: (message: SnsHttpMessage) => Promise<unknown>;\n}\n\n/** What SNS said about a request, outside its signed body. */\nexport interface SnsPushRequest {\n\t/** The `x-amz-sns-subscription-arn` header. */\n\tsubscriptionArn?: string;\n}\n\n/** What to answer SNS with. A non-2xx tells SNS to retry. */\nexport interface SnsPushResponse {\n\tstatus: 200 | 400 | 403 | 500;\n\tbody: { status: string; error?: string };\n}\n\n/**\n * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a\n * poller.\n *\n * The notification is read as the Lambda event SNS would have invoked a\n * function with, and run through the same parsing, services and handler as the\n * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a\n * server serving this route has no reason to install `@middy/core`.\n */\nexport class SnsPushSubscriberAdaptor {\n\tconstructor(\n\t\tprivate readonly envParser: EnvironmentParser<{}>,\n\t\treadonly subscriber: Subscriber<any, any, any, any, any, any, any>,\n\t\tprivate readonly options: SnsPushOptions,\n\t) {}\n\n\tasync handle(\n\t\tbody: unknown,\n\t\trequest: SnsPushRequest = {},\n\t): Promise<SnsPushResponse> {\n\t\tconst message = body as SnsHttpMessage;\n\t\tif (typeof message?.Type !== 'string' || !message.TopicArn) {\n\t\t\treturn refuse(400, 'not an SNS message');\n\t\t}\n\t\t// Checked before the signature: a genuine message for another topic is\n\t\t// still not this subscriber's to confirm or to handle.\n\t\tif (message.TopicArn !== this.options.topicArn) {\n\t\t\treturn refuse(403, `not subscribed to ${message.TopicArn}`);\n\t\t}\n\n\t\tif (this.options.verify) {\n\t\t\ttry {\n\t\t\t\tawait verifySnsMessage(message);\n\t\t\t} catch (error) {\n\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t{ err: error, topicArn: message.TopicArn },\n\t\t\t\t\t'Refused an SNS message that did not verify',\n\t\t\t\t);\n\t\t\t\treturn refuse(403, (error as Error).name);\n\t\t\t}\n\t\t}\n\n\t\tswitch (message.Type) {\n\t\t\tcase 'SubscriptionConfirmation':\n\t\t\t\tif (this.options.confirm) {\n\t\t\t\t\tawait this.options.confirm(message);\n\t\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t\t);\n\t\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\t\t}\n\t\t\t\tawait confirmSnsSubscription(\n\t\t\t\t\tthis.options.emulatorEndpoint && message.SubscribeURL\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t...message,\n\t\t\t\t\t\t\t\tSubscribeURL: throughEndpoint(\n\t\t\t\t\t\t\t\t\tmessage.SubscribeURL,\n\t\t\t\t\t\t\t\t\tthis.options.emulatorEndpoint,\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: message,\n\t\t\t\t);\n\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t);\n\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\tcase 'Notification':\n\t\t\t\tif (\n\t\t\t\t\tthis.options.subscriptionArn &&\n\t\t\t\t\trequest.subscriptionArn !== this.options.subscriptionArn\n\t\t\t\t) {\n\t\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttopicArn: message.TopicArn,\n\t\t\t\t\t\t\tsubscriptionArn: request.subscriptionArn,\n\t\t\t\t\t\t},\n\t\t\t\t\t\t'Refused an SNS notification from a subscription the deploy did not make',\n\t\t\t\t\t);\n\t\t\t\t\treturn refuse(403, 'not the recorded subscription');\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait this.notify(message);\n\t\t\t\t\treturn { status: 200, body: { status: 'ok' } };\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Already logged. A 500 makes SNS retry, which is the point of\n\t\t\t\t\t// answering at all.\n\t\t\t\t\treturn refuse(500, (error as Error).name);\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn { status: 200, body: { status: 'ignored' } };\n\t\t}\n\t}\n\n\tprivate async notify(message: SnsHttpMessage): Promise<void> {\n\t\tconst requestId = message.MessageId;\n\t\tconst logger = this.subscriber.logger.child({ requestId });\n\n\t\tawait runWithRequestContext(\n\t\t\t{\n\t\t\t\tlogger,\n\t\t\t\trequestId,\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\toperation: `subscriber ${this.subscriber.topicName ?? 'sns'}`,\n\t\t\t},\n\t\t\t// A CONSUMER span, child of the publisher's: SNS hands the trace\n\t\t\t// context on in the message attributes it was published with.\n\t\t\t() =>\n\t\t\t\tconsumeTraced(\n\t\t\t\t\t{\n\t\t\t\t\t\tsystem: 'aws_sns',\n\t\t\t\t\t\tdestination:\n\t\t\t\t\t\t\tthis.subscriber.topicName ??\n\t\t\t\t\t\t\tmessage.TopicArn.split(':').pop() ??\n\t\t\t\t\t\t\tmessage.TopicArn,\n\t\t\t\t\t\ttype: message.MessageAttributes?.type?.Value,\n\t\t\t\t\t\tmessageId: message.MessageId,\n\t\t\t\t\t},\n\t\t\t\t\tcarrierFromAttributes(message.MessageAttributes),\n\t\t\t\t\t() => this.run(message, logger),\n\t\t\t\t),\n\t\t);\n\t}\n\n\tprivate async run(\n\t\tmessage: SnsHttpMessage,\n\t\tlogger: Subscriber<any, any, any, any, any, any, any>['logger'],\n\t): Promise<void> {\n\t\ttry {\n\t\t\tconst { services, db } = await subscriberContext(\n\t\t\t\tthis.subscriber,\n\t\t\t\tthis.envParser,\n\t\t\t);\n\t\t\tconst events = await subscribedEvents(\n\t\t\t\tthis.subscriber,\n\t\t\t\ttoSnsEvent(message),\n\t\t\t\tlogger,\n\t\t\t);\n\t\t\tawait runSubscriber(this.subscriber, {\n\t\t\t\tevents,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t\tdb,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tlogger.error(error as object, 'Error processing subscriber');\n\t\t\tthrow wrapError(error);\n\t\t}\n\t}\n}\n\n/** `url`, sent to `endpoint`'s origin instead of its own. */\nfunction throughEndpoint(url: string, endpoint: string): string {\n\tconst target = new URL(url);\n\tconst origin = new URL(endpoint);\n\ttarget.protocol = origin.protocol;\n\ttarget.host = origin.host;\n\treturn target.toString();\n}\n\nfunction refuse(\n\tstatus: SnsPushResponse['status'],\n\terror: string,\n): SnsPushResponse {\n\treturn { status, body: { status: 'refused', error } };\n}\n"],"mappings":"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"}
@@ -1,3 +1,74 @@
1
- import { t as Subscriber } from "../Subscriber-CotDUELC.cjs";
2
- import { t as SubscriberBuilder } from "../SubscriberBuilder-BEv0eoHy.cjs";
3
- export { Subscriber, SubscriberBuilder };
1
+ import { t as Subscriber } from "../Subscriber-5rCX1Nph.cjs";
2
+ import { a as ObjectSubscriberHasNoEvents, i as ObjectSubscriberHandler, n as ObjectSubscriberBuilder, o as SubscriberBuilder, r as ObjectSubscriberContext, t as ObjectSubscriber } from "../ObjectSubscriberBuilder-DWtLxfAJ.cjs";
3
+ import { EnvironmentParser } from "@geekmidas/envkit";
4
+ import { SnsHttpMessage } from "@geekmidas/events/sns/message";
5
+ //#region src/subscribers/SnsPushSubscriberAdaptor.d.ts
6
+ interface SnsPushOptions {
7
+ /** The topic this subscriber is subscribed to. Anything else is refused. */
8
+ topicArn: string;
9
+ /**
10
+ * Verify each message's signature. Off only against an emulator, which
11
+ * signs nothing — decided by the connection string's endpoint, never by
12
+ * anything the request says about itself.
13
+ */
14
+ verify: boolean;
15
+ /**
16
+ * The emulator's address, as this server was configured with it. An
17
+ * emulator names itself in `SubscribeURL` by the port it listens on inside
18
+ * its container, which is not the port published to the host — so against
19
+ * one, the confirmation is sent here instead. From configuration, never
20
+ * from the request.
21
+ */
22
+ emulatorEndpoint?: string;
23
+ /**
24
+ * The subscription the deploy made for this route, as it recorded it
25
+ * (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its
26
+ * `x-amz-sns-subscription-arn` header is refused — a subscription someone
27
+ * added by hand, pointing at this route.
28
+ *
29
+ * Defence in depth, not authentication: SNS does not sign its headers.
30
+ * What authenticates a message is its signature and its `TopicArn`.
31
+ */
32
+ subscriptionArn?: string;
33
+ /**
34
+ * How a confirmation is confirmed. By visiting its `SubscribeURL` when
35
+ * unset — what an emulator takes. Against SNS itself, the server confirms
36
+ * through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`
37
+ * every notification carries cannot cut the route off.
38
+ */
39
+ confirm?: (message: SnsHttpMessage) => Promise<unknown>;
40
+ }
41
+ /** What SNS said about a request, outside its signed body. */
42
+ interface SnsPushRequest {
43
+ /** The `x-amz-sns-subscription-arn` header. */
44
+ subscriptionArn?: string;
45
+ }
46
+ /** What to answer SNS with. A non-2xx tells SNS to retry. */
47
+ interface SnsPushResponse {
48
+ status: 200 | 400 | 403 | 500;
49
+ body: {
50
+ status: string;
51
+ error?: string;
52
+ };
53
+ }
54
+ /**
55
+ * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
56
+ * poller.
57
+ *
58
+ * The notification is read as the Lambda event SNS would have invoked a
59
+ * function with, and run through the same parsing, services and handler as the
60
+ * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
61
+ * server serving this route has no reason to install `@middy/core`.
62
+ */
63
+ export declare class SnsPushSubscriberAdaptor {
64
+ private readonly envParser;
65
+ readonly subscriber: Subscriber<any, any, any, any, any, any, any>;
66
+ private readonly options;
67
+ constructor(envParser: EnvironmentParser<{}>, subscriber: Subscriber<any, any, any, any, any, any, any>, options: SnsPushOptions);
68
+ handle(body: unknown, request?: SnsPushRequest): Promise<SnsPushResponse>;
69
+ private notify;
70
+ private run;
71
+ }
72
+ //#endregion
73
+ export { type ObjectSubscriber, ObjectSubscriberBuilder, type ObjectSubscriberContext, type ObjectSubscriberHandler, ObjectSubscriberHasNoEvents, type SnsPushOptions, type SnsPushRequest, type SnsPushResponse, Subscriber, SubscriberBuilder };
74
+ //# sourceMappingURL=index.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"mappings":";;;;;UAiBiB;;EAEhB;;;;;;EAMA;;;;;;;;EAQA;;;;;;;;;;EAUA;;;;;;;EAOA,WAAW,SAAS,mBAAmB;;;UAIvB;;EAEhB;;;UAIgB;EAChB;EACA;IAAQ;IAAgB;;;;;;;;;;;;qBAYZ;mBAEM;WACR,YAAY;mBACJ;EAHlB,YACkB,WAAW,uBACnB,YAAY,+CACJ,SAAS;EAGrB,OACL,eACA,UAAS,iBACP,QAAQ;UA4EG;UA8BA"}
@@ -1,3 +1,74 @@
1
- import { t as Subscriber } from "../Subscriber-C4heaAyO.mjs";
2
- import { t as SubscriberBuilder } from "../SubscriberBuilder-tyH5yTk5.mjs";
3
- export { Subscriber, SubscriberBuilder };
1
+ import { t as Subscriber } from "../Subscriber-CtQXhcL7.mjs";
2
+ import { a as ObjectSubscriberHasNoEvents, i as ObjectSubscriberHandler, n as ObjectSubscriberBuilder, o as SubscriberBuilder, r as ObjectSubscriberContext, t as ObjectSubscriber } from "../ObjectSubscriberBuilder-Ci_Cc-WZ.mjs";
3
+ import { EnvironmentParser } from "@geekmidas/envkit";
4
+ import { SnsHttpMessage } from "@geekmidas/events/sns/message";
5
+ //#region src/subscribers/SnsPushSubscriberAdaptor.d.ts
6
+ interface SnsPushOptions {
7
+ /** The topic this subscriber is subscribed to. Anything else is refused. */
8
+ topicArn: string;
9
+ /**
10
+ * Verify each message's signature. Off only against an emulator, which
11
+ * signs nothing — decided by the connection string's endpoint, never by
12
+ * anything the request says about itself.
13
+ */
14
+ verify: boolean;
15
+ /**
16
+ * The emulator's address, as this server was configured with it. An
17
+ * emulator names itself in `SubscribeURL` by the port it listens on inside
18
+ * its container, which is not the port published to the host — so against
19
+ * one, the confirmation is sent here instead. From configuration, never
20
+ * from the request.
21
+ */
22
+ emulatorEndpoint?: string;
23
+ /**
24
+ * The subscription the deploy made for this route, as it recorded it
25
+ * (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its
26
+ * `x-amz-sns-subscription-arn` header is refused — a subscription someone
27
+ * added by hand, pointing at this route.
28
+ *
29
+ * Defence in depth, not authentication: SNS does not sign its headers.
30
+ * What authenticates a message is its signature and its `TopicArn`.
31
+ */
32
+ subscriptionArn?: string;
33
+ /**
34
+ * How a confirmation is confirmed. By visiting its `SubscribeURL` when
35
+ * unset — what an emulator takes. Against SNS itself, the server confirms
36
+ * through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`
37
+ * every notification carries cannot cut the route off.
38
+ */
39
+ confirm?: (message: SnsHttpMessage) => Promise<unknown>;
40
+ }
41
+ /** What SNS said about a request, outside its signed body. */
42
+ interface SnsPushRequest {
43
+ /** The `x-amz-sns-subscription-arn` header. */
44
+ subscriptionArn?: string;
45
+ }
46
+ /** What to answer SNS with. A non-2xx tells SNS to retry. */
47
+ interface SnsPushResponse {
48
+ status: 200 | 400 | 403 | 500;
49
+ body: {
50
+ status: string;
51
+ error?: string;
52
+ };
53
+ }
54
+ /**
55
+ * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
56
+ * poller.
57
+ *
58
+ * The notification is read as the Lambda event SNS would have invoked a
59
+ * function with, and run through the same parsing, services and handler as the
60
+ * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
61
+ * server serving this route has no reason to install `@middy/core`.
62
+ */
63
+ export declare class SnsPushSubscriberAdaptor {
64
+ private readonly envParser;
65
+ readonly subscriber: Subscriber<any, any, any, any, any, any, any>;
66
+ private readonly options;
67
+ constructor(envParser: EnvironmentParser<{}>, subscriber: Subscriber<any, any, any, any, any, any, any>, options: SnsPushOptions);
68
+ handle(body: unknown, request?: SnsPushRequest): Promise<SnsPushResponse>;
69
+ private notify;
70
+ private run;
71
+ }
72
+ //#endregion
73
+ export { type ObjectSubscriber, ObjectSubscriberBuilder, type ObjectSubscriberContext, type ObjectSubscriberHandler, ObjectSubscriberHasNoEvents, type SnsPushOptions, type SnsPushRequest, type SnsPushResponse, Subscriber, SubscriberBuilder };
74
+ //# sourceMappingURL=index.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"mappings":";;;;;UAiBiB;;EAEhB;;;;;;EAMA;;;;;;;;EAQA;;;;;;;;;;EAUA;;;;;;;EAOA,WAAW,SAAS,mBAAmB;;;UAIvB;;EAEhB;;;UAIgB;EAChB;EACA;IAAQ;IAAgB;;;;;;;;;;;;qBAYZ;mBAEM;WACR,YAAY;mBACJ;EAHlB,YACkB,WAAW,uBACnB,YAAY,+CACJ,SAAS;EAGrB,OACL,eACA,UAAS,iBACP,QAAQ;UA4EG;UA8BA"}
@@ -1,2 +1,132 @@
1
- import { n as Subscriber, t as SubscriberBuilder } from "../SubscriberBuilder-h7B_cHMr.mjs";
2
- export { Subscriber, SubscriberBuilder };
1
+ import { i as ObjectSubscriberHasNoEvents, n as Subscriber, r as ObjectSubscriberBuilder, t as SubscriberBuilder } from "../SubscriberBuilder-CpFhShTJ.mjs";
2
+ import { n as subscribedEvents, r as subscriberContext, t as runSubscriber } from "../runSubscriber-HEqXkin1.mjs";
3
+ import { carrierFromAttributes, consumeTraced } from "@geekmidas/events";
4
+ import { runWithRequestContext } from "@geekmidas/services";
5
+ import { wrapError } from "@geekmidas/errors";
6
+ import { confirmSnsSubscription, toSnsEvent, verifySnsMessage } from "@geekmidas/events/sns/message";
7
+ //#region src/subscribers/SnsPushSubscriberAdaptor.ts
8
+ /**
9
+ * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
10
+ * poller.
11
+ *
12
+ * The notification is read as the Lambda event SNS would have invoked a
13
+ * function with, and run through the same parsing, services and handler as the
14
+ * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
15
+ * server serving this route has no reason to install `@middy/core`.
16
+ */
17
+ var SnsPushSubscriberAdaptor = class {
18
+ envParser;
19
+ subscriber;
20
+ options;
21
+ constructor(envParser, subscriber, options) {
22
+ this.envParser = envParser;
23
+ this.subscriber = subscriber;
24
+ this.options = options;
25
+ }
26
+ async handle(body, request = {}) {
27
+ const message = body;
28
+ if (typeof message?.Type !== "string" || !message.TopicArn) return refuse(400, "not an SNS message");
29
+ if (message.TopicArn !== this.options.topicArn) return refuse(403, `not subscribed to ${message.TopicArn}`);
30
+ if (this.options.verify) try {
31
+ await verifySnsMessage(message);
32
+ } catch (error) {
33
+ this.subscriber.logger.warn({
34
+ err: error,
35
+ topicArn: message.TopicArn
36
+ }, "Refused an SNS message that did not verify");
37
+ return refuse(403, error.name);
38
+ }
39
+ switch (message.Type) {
40
+ case "SubscriptionConfirmation":
41
+ if (this.options.confirm) {
42
+ await this.options.confirm(message);
43
+ this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
44
+ return {
45
+ status: 200,
46
+ body: { status: "confirmed" }
47
+ };
48
+ }
49
+ await confirmSnsSubscription(this.options.emulatorEndpoint && message.SubscribeURL ? {
50
+ ...message,
51
+ SubscribeURL: throughEndpoint(message.SubscribeURL, this.options.emulatorEndpoint)
52
+ } : message);
53
+ this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
54
+ return {
55
+ status: 200,
56
+ body: { status: "confirmed" }
57
+ };
58
+ case "Notification":
59
+ if (this.options.subscriptionArn && request.subscriptionArn !== this.options.subscriptionArn) {
60
+ this.subscriber.logger.warn({
61
+ topicArn: message.TopicArn,
62
+ subscriptionArn: request.subscriptionArn
63
+ }, "Refused an SNS notification from a subscription the deploy did not make");
64
+ return refuse(403, "not the recorded subscription");
65
+ }
66
+ try {
67
+ await this.notify(message);
68
+ return {
69
+ status: 200,
70
+ body: { status: "ok" }
71
+ };
72
+ } catch (error) {
73
+ return refuse(500, error.name);
74
+ }
75
+ default: return {
76
+ status: 200,
77
+ body: { status: "ignored" }
78
+ };
79
+ }
80
+ }
81
+ async notify(message) {
82
+ const requestId = message.MessageId;
83
+ const logger = this.subscriber.logger.child({ requestId });
84
+ await runWithRequestContext({
85
+ logger,
86
+ requestId,
87
+ startTime: Date.now(),
88
+ operation: `subscriber ${this.subscriber.topicName ?? "sns"}`
89
+ }, () => consumeTraced({
90
+ system: "aws_sns",
91
+ destination: this.subscriber.topicName ?? message.TopicArn.split(":").pop() ?? message.TopicArn,
92
+ type: message.MessageAttributes?.type?.Value,
93
+ messageId: message.MessageId
94
+ }, carrierFromAttributes(message.MessageAttributes), () => this.run(message, logger)));
95
+ }
96
+ async run(message, logger) {
97
+ try {
98
+ const { services, db } = await subscriberContext(this.subscriber, this.envParser);
99
+ const events = await subscribedEvents(this.subscriber, toSnsEvent(message), logger);
100
+ await runSubscriber(this.subscriber, {
101
+ events,
102
+ services,
103
+ logger,
104
+ db
105
+ });
106
+ } catch (error) {
107
+ logger.error(error, "Error processing subscriber");
108
+ throw wrapError(error);
109
+ }
110
+ }
111
+ };
112
+ /** `url`, sent to `endpoint`'s origin instead of its own. */
113
+ function throughEndpoint(url, endpoint) {
114
+ const target = new URL(url);
115
+ const origin = new URL(endpoint);
116
+ target.protocol = origin.protocol;
117
+ target.host = origin.host;
118
+ return target.toString();
119
+ }
120
+ function refuse(status, error) {
121
+ return {
122
+ status,
123
+ body: {
124
+ status: "refused",
125
+ error
126
+ }
127
+ };
128
+ }
129
+ //#endregion
130
+ export { ObjectSubscriberBuilder, ObjectSubscriberHasNoEvents, SnsPushSubscriberAdaptor, Subscriber, SubscriberBuilder };
131
+
132
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport { wrapError } from '@geekmidas/errors';\nimport { carrierFromAttributes, consumeTraced } from '@geekmidas/events';\nimport {\n\tconfirmSnsSubscription,\n\ttype SnsHttpMessage,\n\ttoSnsEvent,\n\tverifySnsMessage,\n} from '@geekmidas/events/sns/message';\nimport { runWithRequestContext } from '@geekmidas/services';\nimport {\n\trunSubscriber,\n\tsubscribedEvents,\n\tsubscriberContext,\n} from './runSubscriber';\nimport type { Subscriber } from './Subscriber';\n\nexport interface SnsPushOptions {\n\t/** The topic this subscriber is subscribed to. Anything else is refused. */\n\ttopicArn: string;\n\t/**\n\t * Verify each message's signature. Off only against an emulator, which\n\t * signs nothing — decided by the connection string's endpoint, never by\n\t * anything the request says about itself.\n\t */\n\tverify: boolean;\n\t/**\n\t * The emulator's address, as this server was configured with it. An\n\t * emulator names itself in `SubscribeURL` by the port it listens on inside\n\t * its container, which is not the port published to the host — so against\n\t * one, the confirmation is sent here instead. From configuration, never\n\t * from the request.\n\t */\n\temulatorEndpoint?: string;\n\t/**\n\t * The subscription the deploy made for this route, as it recorded it\n\t * (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its\n\t * `x-amz-sns-subscription-arn` header is refused — a subscription someone\n\t * added by hand, pointing at this route.\n\t *\n\t * Defence in depth, not authentication: SNS does not sign its headers.\n\t * What authenticates a message is its signature and its `TopicArn`.\n\t */\n\tsubscriptionArn?: string;\n\t/**\n\t * How a confirmation is confirmed. By visiting its `SubscribeURL` when\n\t * unset — what an emulator takes. Against SNS itself, the server confirms\n\t * through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`\n\t * every notification carries cannot cut the route off.\n\t */\n\tconfirm?: (message: SnsHttpMessage) => Promise<unknown>;\n}\n\n/** What SNS said about a request, outside its signed body. */\nexport interface SnsPushRequest {\n\t/** The `x-amz-sns-subscription-arn` header. */\n\tsubscriptionArn?: string;\n}\n\n/** What to answer SNS with. A non-2xx tells SNS to retry. */\nexport interface SnsPushResponse {\n\tstatus: 200 | 400 | 403 | 500;\n\tbody: { status: string; error?: string };\n}\n\n/**\n * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a\n * poller.\n *\n * The notification is read as the Lambda event SNS would have invoked a\n * function with, and run through the same parsing, services and handler as the\n * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a\n * server serving this route has no reason to install `@middy/core`.\n */\nexport class SnsPushSubscriberAdaptor {\n\tconstructor(\n\t\tprivate readonly envParser: EnvironmentParser<{}>,\n\t\treadonly subscriber: Subscriber<any, any, any, any, any, any, any>,\n\t\tprivate readonly options: SnsPushOptions,\n\t) {}\n\n\tasync handle(\n\t\tbody: unknown,\n\t\trequest: SnsPushRequest = {},\n\t): Promise<SnsPushResponse> {\n\t\tconst message = body as SnsHttpMessage;\n\t\tif (typeof message?.Type !== 'string' || !message.TopicArn) {\n\t\t\treturn refuse(400, 'not an SNS message');\n\t\t}\n\t\t// Checked before the signature: a genuine message for another topic is\n\t\t// still not this subscriber's to confirm or to handle.\n\t\tif (message.TopicArn !== this.options.topicArn) {\n\t\t\treturn refuse(403, `not subscribed to ${message.TopicArn}`);\n\t\t}\n\n\t\tif (this.options.verify) {\n\t\t\ttry {\n\t\t\t\tawait verifySnsMessage(message);\n\t\t\t} catch (error) {\n\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t{ err: error, topicArn: message.TopicArn },\n\t\t\t\t\t'Refused an SNS message that did not verify',\n\t\t\t\t);\n\t\t\t\treturn refuse(403, (error as Error).name);\n\t\t\t}\n\t\t}\n\n\t\tswitch (message.Type) {\n\t\t\tcase 'SubscriptionConfirmation':\n\t\t\t\tif (this.options.confirm) {\n\t\t\t\t\tawait this.options.confirm(message);\n\t\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t\t);\n\t\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\t\t}\n\t\t\t\tawait confirmSnsSubscription(\n\t\t\t\t\tthis.options.emulatorEndpoint && message.SubscribeURL\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t...message,\n\t\t\t\t\t\t\t\tSubscribeURL: throughEndpoint(\n\t\t\t\t\t\t\t\t\tmessage.SubscribeURL,\n\t\t\t\t\t\t\t\t\tthis.options.emulatorEndpoint,\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: message,\n\t\t\t\t);\n\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t);\n\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\tcase 'Notification':\n\t\t\t\tif (\n\t\t\t\t\tthis.options.subscriptionArn &&\n\t\t\t\t\trequest.subscriptionArn !== this.options.subscriptionArn\n\t\t\t\t) {\n\t\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttopicArn: message.TopicArn,\n\t\t\t\t\t\t\tsubscriptionArn: request.subscriptionArn,\n\t\t\t\t\t\t},\n\t\t\t\t\t\t'Refused an SNS notification from a subscription the deploy did not make',\n\t\t\t\t\t);\n\t\t\t\t\treturn refuse(403, 'not the recorded subscription');\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait this.notify(message);\n\t\t\t\t\treturn { status: 200, body: { status: 'ok' } };\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Already logged. A 500 makes SNS retry, which is the point of\n\t\t\t\t\t// answering at all.\n\t\t\t\t\treturn refuse(500, (error as Error).name);\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn { status: 200, body: { status: 'ignored' } };\n\t\t}\n\t}\n\n\tprivate async notify(message: SnsHttpMessage): Promise<void> {\n\t\tconst requestId = message.MessageId;\n\t\tconst logger = this.subscriber.logger.child({ requestId });\n\n\t\tawait runWithRequestContext(\n\t\t\t{\n\t\t\t\tlogger,\n\t\t\t\trequestId,\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\toperation: `subscriber ${this.subscriber.topicName ?? 'sns'}`,\n\t\t\t},\n\t\t\t// A CONSUMER span, child of the publisher's: SNS hands the trace\n\t\t\t// context on in the message attributes it was published with.\n\t\t\t() =>\n\t\t\t\tconsumeTraced(\n\t\t\t\t\t{\n\t\t\t\t\t\tsystem: 'aws_sns',\n\t\t\t\t\t\tdestination:\n\t\t\t\t\t\t\tthis.subscriber.topicName ??\n\t\t\t\t\t\t\tmessage.TopicArn.split(':').pop() ??\n\t\t\t\t\t\t\tmessage.TopicArn,\n\t\t\t\t\t\ttype: message.MessageAttributes?.type?.Value,\n\t\t\t\t\t\tmessageId: message.MessageId,\n\t\t\t\t\t},\n\t\t\t\t\tcarrierFromAttributes(message.MessageAttributes),\n\t\t\t\t\t() => this.run(message, logger),\n\t\t\t\t),\n\t\t);\n\t}\n\n\tprivate async run(\n\t\tmessage: SnsHttpMessage,\n\t\tlogger: Subscriber<any, any, any, any, any, any, any>['logger'],\n\t): Promise<void> {\n\t\ttry {\n\t\t\tconst { services, db } = await subscriberContext(\n\t\t\t\tthis.subscriber,\n\t\t\t\tthis.envParser,\n\t\t\t);\n\t\t\tconst events = await subscribedEvents(\n\t\t\t\tthis.subscriber,\n\t\t\t\ttoSnsEvent(message),\n\t\t\t\tlogger,\n\t\t\t);\n\t\t\tawait runSubscriber(this.subscriber, {\n\t\t\t\tevents,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t\tdb,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tlogger.error(error as object, 'Error processing subscriber');\n\t\t\tthrow wrapError(error);\n\t\t}\n\t}\n}\n\n/** `url`, sent to `endpoint`'s origin instead of its own. */\nfunction throughEndpoint(url: string, endpoint: string): string {\n\tconst target = new URL(url);\n\tconst origin = new URL(endpoint);\n\ttarget.protocol = origin.protocol;\n\ttarget.host = origin.host;\n\treturn target.toString();\n}\n\nfunction refuse(\n\tstatus: SnsPushResponse['status'],\n\terror: string,\n): SnsPushResponse {\n\treturn { status, body: { status: 'refused', error } };\n}\n"],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ import { i as Declarable } from "./construct-interface-CVoejIpo.cjs";
2
+ import { ConstructName, Declaration } from "@geekmidas/manifest";
3
+ //#region src/telemetry.d.ts
4
+ interface TelemetryConfig {
5
+ /**
6
+ * Request paths no span is recorded for, on every surface that uses this —
7
+ * health checks, by default the only noise worth naming. A trailing `*`
8
+ * matches a prefix. One route on one surface says so itself:
9
+ * `.telemetry({ ignore: true })`.
10
+ */
11
+ ignorePaths?: readonly string[];
12
+ /**
13
+ * Resource attributes every span and log record carries —
14
+ * `{ 'service.namespace': 'shop' }`. The service's name is not one of
15
+ * them: it is the app's, set per process.
16
+ */
17
+ attributes?: Readonly<Record<string, string>>;
18
+ /**
19
+ * The label the log UI answers on under the stage's domain, where a stage
20
+ * serves it publicly (`deploy.telemetry.<stage>.public`). Defaults to the
21
+ * id kebab-cased — `telemetry.<stage domain>` for `Telemetry`.
22
+ *
23
+ * Here rather than in the stage's config because it is the same on every
24
+ * stage; whether it is served, and to whom, is the stage's.
25
+ */
26
+ subdomain?: string;
27
+ /**
28
+ * The image the self-hosted provider runs — OpenObserve, taken verbatim.
29
+ * Defaults to the version gkm pins.
30
+ */
31
+ image?: string;
32
+ }
33
+ declare class Telemetry<TName extends string = string> implements Declarable<TName> {
34
+ readonly id: TName;
35
+ readonly ignorePaths: readonly string[];
36
+ readonly attributes: Readonly<Record<string, string>>;
37
+ readonly subdomain: string | undefined;
38
+ readonly image: string | undefined;
39
+ constructor(id: ConstructName<TName>, config?: TelemetryConfig);
40
+ /**
41
+ * One node, providing OpenTelemetry's own variables. Where the telemetry
42
+ * goes is the deploy's, resolved by the target for each stage; what is
43
+ * declared is only what is the same on every stage — the log UI's label
44
+ * and the image that runs it.
45
+ */
46
+ declare(): Declaration[];
47
+ }
48
+ /** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */
49
+ interface EndpointTelemetry {
50
+ /** Record no span for this route. */
51
+ ignore?: boolean;
52
+ /** Attributes this route's request span carries. */
53
+ attributes?: Readonly<Record<string, string>>;
54
+ }
55
+ //#endregion
56
+ export { Telemetry as n, TelemetryConfig as r, EndpointTelemetry as t };
57
+ //# sourceMappingURL=telemetry-BbLyS7ln.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetry-BbLyS7ln.d.cts","names":[],"sources":["../src/telemetry.ts"],"mappings":";;;UAmCiB;;;;;;;EAOhB;;;;;;EAMA,aAAa,SAAS;;;;;;;;;EAStB;;;;;EAKA;;cAGY,UAAU,0CACX,WAAW;WAEb,IAAI;WACJ;WACA,YAAY,SAAS;WACrB;WACA;EAET,YAAY,IAAI,cAAc,QAAQ,SAAQ;;;;;;;EAiB9C,WAAW;;;UAkBK;;EAEhB;;EAEA,aAAa,SAAS"}
@@ -0,0 +1,57 @@
1
+ import { i as Declarable } from "./construct-interface-Nw5Dt9AC.mjs";
2
+ import { ConstructName, Declaration } from "@geekmidas/manifest";
3
+ //#region src/telemetry.d.ts
4
+ interface TelemetryConfig {
5
+ /**
6
+ * Request paths no span is recorded for, on every surface that uses this —
7
+ * health checks, by default the only noise worth naming. A trailing `*`
8
+ * matches a prefix. One route on one surface says so itself:
9
+ * `.telemetry({ ignore: true })`.
10
+ */
11
+ ignorePaths?: readonly string[];
12
+ /**
13
+ * Resource attributes every span and log record carries —
14
+ * `{ 'service.namespace': 'shop' }`. The service's name is not one of
15
+ * them: it is the app's, set per process.
16
+ */
17
+ attributes?: Readonly<Record<string, string>>;
18
+ /**
19
+ * The label the log UI answers on under the stage's domain, where a stage
20
+ * serves it publicly (`deploy.telemetry.<stage>.public`). Defaults to the
21
+ * id kebab-cased — `telemetry.<stage domain>` for `Telemetry`.
22
+ *
23
+ * Here rather than in the stage's config because it is the same on every
24
+ * stage; whether it is served, and to whom, is the stage's.
25
+ */
26
+ subdomain?: string;
27
+ /**
28
+ * The image the self-hosted provider runs — OpenObserve, taken verbatim.
29
+ * Defaults to the version gkm pins.
30
+ */
31
+ image?: string;
32
+ }
33
+ declare class Telemetry<TName extends string = string> implements Declarable<TName> {
34
+ readonly id: TName;
35
+ readonly ignorePaths: readonly string[];
36
+ readonly attributes: Readonly<Record<string, string>>;
37
+ readonly subdomain: string | undefined;
38
+ readonly image: string | undefined;
39
+ constructor(id: ConstructName<TName>, config?: TelemetryConfig);
40
+ /**
41
+ * One node, providing OpenTelemetry's own variables. Where the telemetry
42
+ * goes is the deploy's, resolved by the target for each stage; what is
43
+ * declared is only what is the same on every stage — the log UI's label
44
+ * and the image that runs it.
45
+ */
46
+ declare(): Declaration[];
47
+ }
48
+ /** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */
49
+ interface EndpointTelemetry {
50
+ /** Record no span for this route. */
51
+ ignore?: boolean;
52
+ /** Attributes this route's request span carries. */
53
+ attributes?: Readonly<Record<string, string>>;
54
+ }
55
+ //#endregion
56
+ export { Telemetry as n, TelemetryConfig as r, EndpointTelemetry as t };
57
+ //# sourceMappingURL=telemetry-DWX-qKUh.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetry-DWX-qKUh.d.mts","names":[],"sources":["../src/telemetry.ts"],"mappings":";;;UAmCiB;;;;;;;EAOhB;;;;;;EAMA,aAAa,SAAS;;;;;;;;;EAStB;;;;;EAKA;;cAGY,UAAU,0CACX,WAAW;WAEb,IAAI;WACJ;WACA,YAAY,SAAS;WACrB;WACA;EAET,YAAY,IAAI,cAAc,QAAQ,SAAQ;;;;;;;EAiB9C,WAAW;;;UAkBK;;EAEhB;;EAEA,aAAa,SAAS"}