@geekmidas/events 10.0.0-alpha.99 → 10.0.0

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 (352) hide show
  1. package/CHANGELOG.md +116 -0
  2. package/README.md +1 -46
  3. package/dist/BasicConnection-CQsJpx2J.d.cts +27 -0
  4. package/dist/BasicConnection-CQsJpx2J.d.cts.map +1 -0
  5. package/dist/BasicConnection-CxfNEvlb.cjs +48 -0
  6. package/dist/BasicConnection-CxfNEvlb.cjs.map +1 -0
  7. package/dist/BasicConnection-DcRelT64.d.mts +27 -0
  8. package/dist/BasicConnection-DcRelT64.d.mts.map +1 -0
  9. package/dist/BasicConnection-hl-Ogz3a.mjs +42 -0
  10. package/dist/BasicConnection-hl-Ogz3a.mjs.map +1 -0
  11. package/dist/BasicPublisher-C-hMX2Hy.d.mts +14 -0
  12. package/dist/BasicPublisher-C-hMX2Hy.d.mts.map +1 -0
  13. package/dist/BasicPublisher-CGMXg2I2.d.cts +14 -0
  14. package/dist/BasicPublisher-CGMXg2I2.d.cts.map +1 -0
  15. package/dist/BasicPublisher-CXAVKxgq.cjs +20 -0
  16. package/dist/BasicPublisher-CXAVKxgq.cjs.map +1 -0
  17. package/dist/BasicPublisher-DogbeHAH.mjs +14 -0
  18. package/dist/BasicPublisher-DogbeHAH.mjs.map +1 -0
  19. package/dist/BasicSubscriber-BJSZN22M.mjs +16 -0
  20. package/dist/BasicSubscriber-BJSZN22M.mjs.map +1 -0
  21. package/dist/BasicSubscriber-HzSJ_MbB.d.mts +14 -0
  22. package/dist/BasicSubscriber-HzSJ_MbB.d.mts.map +1 -0
  23. package/dist/BasicSubscriber-mVJRMXhZ.cjs +22 -0
  24. package/dist/BasicSubscriber-mVJRMXhZ.cjs.map +1 -0
  25. package/dist/BasicSubscriber-uW3IOyBj.d.cts +14 -0
  26. package/dist/BasicSubscriber-uW3IOyBj.d.cts.map +1 -0
  27. package/dist/EventConnection-4niMI6D8.d.mts +13 -0
  28. package/dist/EventConnection-4niMI6D8.d.mts.map +1 -0
  29. package/dist/EventConnection-BkA9FSVL.cjs +45 -0
  30. package/dist/EventConnection-BkA9FSVL.cjs.map +1 -0
  31. package/dist/EventConnection-Kr32GAzq.mjs +40 -0
  32. package/dist/EventConnection-Kr32GAzq.mjs.map +1 -0
  33. package/dist/EventConnection-dP42P87q.d.cts +13 -0
  34. package/dist/EventConnection-dP42P87q.d.cts.map +1 -0
  35. package/dist/EventConnection.cjs +5 -0
  36. package/dist/EventConnection.d.cts +3 -0
  37. package/dist/EventConnection.d.mts +3 -0
  38. package/dist/EventConnection.mjs +4 -0
  39. package/dist/PgBossConnection-B71ssr72.cjs +80 -0
  40. package/dist/PgBossConnection-B71ssr72.cjs.map +1 -0
  41. package/dist/PgBossConnection-Bj_Wo1lQ.mjs +74 -0
  42. package/dist/PgBossConnection-Bj_Wo1lQ.mjs.map +1 -0
  43. package/dist/PgBossConnection-DCfLGoHx.d.mts +32 -0
  44. package/dist/PgBossConnection-DCfLGoHx.d.mts.map +1 -0
  45. package/dist/PgBossConnection-oto_CAbP.d.cts +32 -0
  46. package/dist/PgBossConnection-oto_CAbP.d.cts.map +1 -0
  47. package/dist/PgBossPublisher-Bwo7qSoH.mjs +35 -0
  48. package/dist/PgBossPublisher-Bwo7qSoH.mjs.map +1 -0
  49. package/dist/PgBossPublisher-CqjigBVC.d.mts +20 -0
  50. package/dist/PgBossPublisher-CqjigBVC.d.mts.map +1 -0
  51. package/dist/PgBossPublisher-FTdYh58W.cjs +41 -0
  52. package/dist/PgBossPublisher-FTdYh58W.cjs.map +1 -0
  53. package/dist/PgBossPublisher-JIiB1zpA.d.cts +20 -0
  54. package/dist/PgBossPublisher-JIiB1zpA.d.cts.map +1 -0
  55. package/dist/PgBossSubscriber-BUiB1JKf.d.mts +24 -0
  56. package/dist/PgBossSubscriber-BUiB1JKf.d.mts.map +1 -0
  57. package/dist/PgBossSubscriber-BubVfuWm.cjs +52 -0
  58. package/dist/PgBossSubscriber-BubVfuWm.cjs.map +1 -0
  59. package/dist/PgBossSubscriber-Cozijfdj.d.cts +24 -0
  60. package/dist/PgBossSubscriber-Cozijfdj.d.cts.map +1 -0
  61. package/dist/PgBossSubscriber-DopATe80.mjs +46 -0
  62. package/dist/PgBossSubscriber-DopATe80.mjs.map +1 -0
  63. package/dist/Publisher-CKloIGh6.cjs +79 -0
  64. package/dist/Publisher-CKloIGh6.cjs.map +1 -0
  65. package/dist/Publisher-ChLTrUeP.mjs +74 -0
  66. package/dist/Publisher-ChLTrUeP.mjs.map +1 -0
  67. package/dist/Publisher-DDee6xau.d.cts +21 -0
  68. package/dist/Publisher-DDee6xau.d.cts.map +1 -0
  69. package/dist/Publisher-VHumMkrP.d.mts +21 -0
  70. package/dist/Publisher-VHumMkrP.d.mts.map +1 -0
  71. package/dist/Publisher.cjs +4 -0
  72. package/dist/Publisher.d.cts +3 -0
  73. package/dist/Publisher.d.mts +3 -0
  74. package/dist/Publisher.mjs +4 -0
  75. package/dist/RabbitMQConnection-BtKZjtZY.mjs +107 -0
  76. package/dist/RabbitMQConnection-BtKZjtZY.mjs.map +1 -0
  77. package/dist/RabbitMQConnection-DV9t3VYp.d.mts +44 -0
  78. package/dist/RabbitMQConnection-DV9t3VYp.d.mts.map +1 -0
  79. package/dist/RabbitMQConnection-DmMMosT4.cjs +113 -0
  80. package/dist/RabbitMQConnection-DmMMosT4.cjs.map +1 -0
  81. package/dist/RabbitMQConnection-jNME_eR7.d.cts +44 -0
  82. package/dist/RabbitMQConnection-jNME_eR7.d.cts.map +1 -0
  83. package/dist/RabbitMQPublisher-C94q6g8q.cjs +45 -0
  84. package/dist/RabbitMQPublisher-C94q6g8q.cjs.map +1 -0
  85. package/dist/RabbitMQPublisher-DKmgwqVj.d.mts +25 -0
  86. package/dist/RabbitMQPublisher-DKmgwqVj.d.mts.map +1 -0
  87. package/dist/RabbitMQPublisher-d257OHLa.d.cts +25 -0
  88. package/dist/RabbitMQPublisher-d257OHLa.d.cts.map +1 -0
  89. package/dist/RabbitMQPublisher-yUqWNq-P.mjs +39 -0
  90. package/dist/RabbitMQPublisher-yUqWNq-P.mjs.map +1 -0
  91. package/dist/RabbitMQSubscriber-BF7JGfYm.d.cts +27 -0
  92. package/dist/RabbitMQSubscriber-BF7JGfYm.d.cts.map +1 -0
  93. package/dist/RabbitMQSubscriber-BWniDtFs.mjs +56 -0
  94. package/dist/RabbitMQSubscriber-BWniDtFs.mjs.map +1 -0
  95. package/dist/RabbitMQSubscriber-CdbUy5mB.d.mts +27 -0
  96. package/dist/RabbitMQSubscriber-CdbUy5mB.d.mts.map +1 -0
  97. package/dist/RabbitMQSubscriber-DGEO-clQ.cjs +62 -0
  98. package/dist/RabbitMQSubscriber-DGEO-clQ.cjs.map +1 -0
  99. package/dist/SNSConnection-CAcbLQOy.cjs +76 -0
  100. package/dist/SNSConnection-CAcbLQOy.cjs.map +1 -0
  101. package/dist/SNSConnection-CG4iEwA8.d.mts +41 -0
  102. package/dist/SNSConnection-CG4iEwA8.d.mts.map +1 -0
  103. package/dist/SNSConnection-CVjH93lb.mjs +70 -0
  104. package/dist/SNSConnection-CVjH93lb.mjs.map +1 -0
  105. package/dist/SNSConnection-Dol9FuxA.d.cts +41 -0
  106. package/dist/SNSConnection-Dol9FuxA.d.cts.map +1 -0
  107. package/dist/SNSPublisher-CjlMS3Z2.mjs +41 -0
  108. package/dist/SNSPublisher-CjlMS3Z2.mjs.map +1 -0
  109. package/dist/SNSPublisher-D50dPCEh.d.mts +22 -0
  110. package/dist/SNSPublisher-D50dPCEh.d.mts.map +1 -0
  111. package/dist/SNSPublisher-DQunY4NM.d.cts +22 -0
  112. package/dist/SNSPublisher-DQunY4NM.d.cts.map +1 -0
  113. package/dist/SNSPublisher-DV_8GGsi.cjs +47 -0
  114. package/dist/SNSPublisher-DV_8GGsi.cjs.map +1 -0
  115. package/dist/SNSSubscriber-BWaCQFl6.mjs +139 -0
  116. package/dist/SNSSubscriber-BWaCQFl6.mjs.map +1 -0
  117. package/dist/SNSSubscriber-CUgHK4W2.d.mts +55 -0
  118. package/dist/SNSSubscriber-CUgHK4W2.d.mts.map +1 -0
  119. package/dist/SNSSubscriber-ZE_-Hsps.cjs +145 -0
  120. package/dist/SNSSubscriber-ZE_-Hsps.cjs.map +1 -0
  121. package/dist/SNSSubscriber-ZGJjhXFQ.d.cts +55 -0
  122. package/dist/SNSSubscriber-ZGJjhXFQ.d.cts.map +1 -0
  123. package/dist/SQSConnection-BtEkDha8.d.cts +41 -0
  124. package/dist/SQSConnection-BtEkDha8.d.cts.map +1 -0
  125. package/dist/SQSConnection-CT3S7_zP.mjs +70 -0
  126. package/dist/SQSConnection-CT3S7_zP.mjs.map +1 -0
  127. package/dist/SQSConnection-DVy43GCV.d.mts +41 -0
  128. package/dist/SQSConnection-DVy43GCV.d.mts.map +1 -0
  129. package/dist/SQSConnection-Y0mdVTcB.cjs +76 -0
  130. package/dist/SQSConnection-Y0mdVTcB.cjs.map +1 -0
  131. package/dist/SQSPublisher-B-32CC4G.mjs +57 -0
  132. package/dist/SQSPublisher-B-32CC4G.mjs.map +1 -0
  133. package/dist/SQSPublisher-CgUduk6H.cjs +63 -0
  134. package/dist/SQSPublisher-CgUduk6H.cjs.map +1 -0
  135. package/dist/SQSPublisher-kyl5HW3N.d.cts +25 -0
  136. package/dist/SQSPublisher-kyl5HW3N.d.cts.map +1 -0
  137. package/dist/SQSPublisher-qDE5Fp-N.d.mts +25 -0
  138. package/dist/SQSPublisher-qDE5Fp-N.d.mts.map +1 -0
  139. package/dist/SQSSubscriber-C4UA2hKq.cjs +120 -0
  140. package/dist/SQSSubscriber-C4UA2hKq.cjs.map +1 -0
  141. package/dist/SQSSubscriber-CDvaG4ij.d.cts +44 -0
  142. package/dist/SQSSubscriber-CDvaG4ij.d.cts.map +1 -0
  143. package/dist/SQSSubscriber-CQdSFzpe.mjs +114 -0
  144. package/dist/SQSSubscriber-CQdSFzpe.mjs.map +1 -0
  145. package/dist/SQSSubscriber-JfFuAAoP.d.mts +44 -0
  146. package/dist/SQSSubscriber-JfFuAAoP.d.mts.map +1 -0
  147. package/dist/Subscriber-CG_QUQZs.d.cts +21 -0
  148. package/dist/Subscriber-CG_QUQZs.d.cts.map +1 -0
  149. package/dist/Subscriber-CghW0A02.cjs +88 -0
  150. package/dist/Subscriber-CghW0A02.cjs.map +1 -0
  151. package/dist/Subscriber-DiYHmuF0.d.mts +21 -0
  152. package/dist/Subscriber-DiYHmuF0.d.mts.map +1 -0
  153. package/dist/Subscriber-bnkFtSvt.mjs +83 -0
  154. package/dist/Subscriber-bnkFtSvt.mjs.map +1 -0
  155. package/dist/Subscriber.cjs +4 -0
  156. package/dist/Subscriber.d.cts +3 -0
  157. package/dist/Subscriber.d.mts +3 -0
  158. package/dist/Subscriber.mjs +4 -0
  159. package/dist/basic/BasicConnection.cjs +4 -0
  160. package/dist/basic/BasicConnection.d.cts +3 -0
  161. package/dist/basic/BasicConnection.d.mts +3 -0
  162. package/dist/basic/BasicConnection.mjs +4 -0
  163. package/dist/basic/BasicPublisher.cjs +3 -0
  164. package/dist/basic/BasicPublisher.d.cts +4 -0
  165. package/dist/basic/BasicPublisher.d.mts +4 -0
  166. package/dist/basic/BasicPublisher.mjs +3 -0
  167. package/dist/basic/BasicSubscriber.cjs +3 -0
  168. package/dist/basic/BasicSubscriber.d.cts +4 -0
  169. package/dist/basic/BasicSubscriber.d.mts +4 -0
  170. package/dist/basic/BasicSubscriber.mjs +3 -0
  171. package/dist/basic/index.cjs +7 -100
  172. package/dist/basic/index.d.cts +5 -45
  173. package/dist/basic/index.d.mts +5 -45
  174. package/dist/basic/index.mjs +5 -96
  175. package/dist/{rolldown-runtime-C0BPl7ul.cjs → chunk-CUT6urMc.cjs} +10 -23
  176. package/dist/index.cjs +8 -87
  177. package/dist/index.d.cts +5 -102
  178. package/dist/index.d.mts +5 -102
  179. package/dist/index.mjs +5 -71
  180. package/dist/pgboss/PgBossConnection.cjs +4 -0
  181. package/dist/pgboss/PgBossConnection.d.cts +3 -0
  182. package/dist/pgboss/PgBossConnection.d.mts +3 -0
  183. package/dist/pgboss/PgBossConnection.mjs +4 -0
  184. package/dist/pgboss/PgBossPublisher.cjs +3 -0
  185. package/dist/pgboss/PgBossPublisher.d.cts +4 -0
  186. package/dist/pgboss/PgBossPublisher.d.mts +4 -0
  187. package/dist/pgboss/PgBossPublisher.mjs +3 -0
  188. package/dist/pgboss/PgBossSubscriber.cjs +3 -0
  189. package/dist/pgboss/PgBossSubscriber.d.cts +4 -0
  190. package/dist/pgboss/PgBossSubscriber.d.mts +4 -0
  191. package/dist/pgboss/PgBossSubscriber.mjs +3 -0
  192. package/dist/pgboss/index.cjs +7 -247
  193. package/dist/pgboss/index.d.cts +5 -107
  194. package/dist/pgboss/index.d.mts +5 -107
  195. package/dist/pgboss/index.mjs +5 -240
  196. package/dist/rabbitmq/RabbitMQConnection.cjs +4 -0
  197. package/dist/rabbitmq/RabbitMQConnection.d.cts +3 -0
  198. package/dist/rabbitmq/RabbitMQConnection.d.mts +3 -0
  199. package/dist/rabbitmq/RabbitMQConnection.mjs +4 -0
  200. package/dist/rabbitmq/RabbitMQPublisher.cjs +3 -0
  201. package/dist/rabbitmq/RabbitMQPublisher.d.cts +4 -0
  202. package/dist/rabbitmq/RabbitMQPublisher.d.mts +4 -0
  203. package/dist/rabbitmq/RabbitMQPublisher.mjs +3 -0
  204. package/dist/rabbitmq/RabbitMQSubscriber.cjs +3 -0
  205. package/dist/rabbitmq/RabbitMQSubscriber.d.cts +4 -0
  206. package/dist/rabbitmq/RabbitMQSubscriber.d.mts +4 -0
  207. package/dist/rabbitmq/RabbitMQSubscriber.mjs +3 -0
  208. package/dist/rabbitmq/index.cjs +7 -243
  209. package/dist/rabbitmq/index.d.cts +5 -92
  210. package/dist/rabbitmq/index.d.mts +5 -92
  211. package/dist/rabbitmq/index.mjs +5 -237
  212. package/dist/sns/SNSConnection.cjs +4 -0
  213. package/dist/sns/SNSConnection.d.cts +3 -0
  214. package/dist/sns/SNSConnection.d.mts +3 -0
  215. package/dist/sns/SNSConnection.mjs +4 -0
  216. package/dist/sns/SNSPublisher.cjs +3 -0
  217. package/dist/sns/SNSPublisher.d.cts +4 -0
  218. package/dist/sns/SNSPublisher.d.mts +4 -0
  219. package/dist/sns/SNSPublisher.mjs +3 -0
  220. package/dist/sns/SNSSubscriber.cjs +6 -0
  221. package/dist/sns/SNSSubscriber.d.cts +4 -0
  222. package/dist/sns/SNSSubscriber.d.mts +4 -0
  223. package/dist/sns/SNSSubscriber.mjs +6 -0
  224. package/dist/sns/index.cjs +9 -551
  225. package/dist/sns/index.d.cts +5 -273
  226. package/dist/sns/index.d.mts +5 -273
  227. package/dist/sns/index.mjs +7 -527
  228. package/dist/sqs/SQSConnection.cjs +4 -0
  229. package/dist/sqs/SQSConnection.d.cts +3 -0
  230. package/dist/sqs/SQSConnection.d.mts +3 -0
  231. package/dist/sqs/SQSConnection.mjs +4 -0
  232. package/dist/sqs/SQSPublisher.cjs +3 -0
  233. package/dist/sqs/SQSPublisher.d.cts +4 -0
  234. package/dist/sqs/SQSPublisher.d.mts +4 -0
  235. package/dist/sqs/SQSPublisher.mjs +3 -0
  236. package/dist/sqs/SQSSubscriber.cjs +3 -0
  237. package/dist/sqs/SQSSubscriber.d.cts +4 -0
  238. package/dist/sqs/SQSSubscriber.d.mts +4 -0
  239. package/dist/sqs/SQSSubscriber.mjs +3 -0
  240. package/dist/sqs/index.cjs +7 -35
  241. package/dist/sqs/index.d.cts +5 -118
  242. package/dist/sqs/index.d.mts +5 -118
  243. package/dist/sqs/index.mjs +5 -24
  244. package/dist/types-BrdcSEnd.mjs +18 -0
  245. package/dist/types-BrdcSEnd.mjs.map +1 -0
  246. package/dist/types-Byv8N9ma.cjs +24 -0
  247. package/dist/types-Byv8N9ma.cjs.map +1 -0
  248. package/dist/types-Dh9Jyinx.d.mts +67 -0
  249. package/dist/types-Dh9Jyinx.d.mts.map +1 -0
  250. package/dist/types-Dj23od3e.d.cts +67 -0
  251. package/dist/types-Dj23od3e.d.cts.map +1 -0
  252. package/dist/types.cjs +3 -0
  253. package/dist/types.d.cts +2 -0
  254. package/dist/types.d.mts +2 -0
  255. package/dist/types.mjs +3 -0
  256. package/package.json +12 -40
  257. package/src/EventConnection.ts +43 -0
  258. package/src/Publisher.ts +98 -0
  259. package/src/Subscriber.ts +113 -0
  260. package/src/__tests__/EventConnection.spec.ts +42 -0
  261. package/src/__tests__/Publisher.spec.ts +96 -0
  262. package/src/__tests__/Subscriber.spec.ts +109 -0
  263. package/src/basic/BasicConnection.ts +47 -0
  264. package/src/basic/BasicPublisher.ts +15 -0
  265. package/src/basic/BasicSubscriber.ts +21 -0
  266. package/src/basic/__tests__/BasicSubscriber.spec.ts +166 -0
  267. package/src/basic/index.ts +3 -0
  268. package/src/index.ts +25 -0
  269. package/src/pgboss/PgBossConnection.ts +91 -0
  270. package/src/pgboss/PgBossPublisher.ts +49 -0
  271. package/src/pgboss/PgBossSubscriber.ts +81 -0
  272. package/src/pgboss/__tests__/pgboss.spec.ts +196 -0
  273. package/src/pgboss/__tests__/setup.ts +21 -0
  274. package/src/pgboss/index.ts +5 -0
  275. package/src/rabbitmq/RabbitMQConnection.ts +148 -0
  276. package/src/rabbitmq/RabbitMQPublisher.ts +67 -0
  277. package/src/rabbitmq/RabbitMQSubscriber.ts +111 -0
  278. package/src/rabbitmq/__tests__/RabbitMQPublisher.spec.ts +378 -0
  279. package/src/rabbitmq/__tests__/RabbitMQSubscriber.spec.ts +292 -0
  280. package/src/rabbitmq/index.ts +6 -0
  281. package/src/sns/SNSConnection.ts +98 -0
  282. package/src/sns/SNSPublisher.ts +62 -0
  283. package/src/sns/SNSSubscriber.ts +218 -0
  284. package/src/sns/__tests__/SNS-SQS-Integration.spec.ts +389 -0
  285. package/src/sns/__tests__/SNSPublisher.spec.ts +449 -0
  286. package/src/sns/__tests__/SNSSubscriber.spec.ts +527 -0
  287. package/src/sns/index.ts +6 -0
  288. package/src/sqs/SQSConnection.ts +97 -0
  289. package/src/sqs/SQSPublisher.ts +105 -0
  290. package/src/sqs/SQSSubscriber.ts +181 -0
  291. package/src/sqs/__tests__/SQSPublisher.spec.ts +189 -0
  292. package/src/sqs/index.ts +6 -0
  293. package/src/types.ts +76 -0
  294. package/tsconfig.json +9 -0
  295. package/tsdown.config.ts +10 -0
  296. package/dist/SQSSubscriber-BEJBfNTe.mjs +0 -264
  297. package/dist/SQSSubscriber-BEJBfNTe.mjs.map +0 -1
  298. package/dist/SQSSubscriber-COTqWvOk.cjs +0 -288
  299. package/dist/SQSSubscriber-COTqWvOk.cjs.map +0 -1
  300. package/dist/basic/index.cjs.map +0 -1
  301. package/dist/basic/index.d.cts.map +0 -1
  302. package/dist/basic/index.d.mts.map +0 -1
  303. package/dist/basic/index.mjs.map +0 -1
  304. package/dist/index.cjs.map +0 -1
  305. package/dist/index.d.cts.map +0 -1
  306. package/dist/index.d.mts.map +0 -1
  307. package/dist/index.mjs.map +0 -1
  308. package/dist/pgboss/index.cjs.map +0 -1
  309. package/dist/pgboss/index.d.cts.map +0 -1
  310. package/dist/pgboss/index.d.mts.map +0 -1
  311. package/dist/pgboss/index.mjs.map +0 -1
  312. package/dist/rabbitmq/index.cjs.map +0 -1
  313. package/dist/rabbitmq/index.d.cts.map +0 -1
  314. package/dist/rabbitmq/index.d.mts.map +0 -1
  315. package/dist/rabbitmq/index.mjs.map +0 -1
  316. package/dist/registry-DIx25Q5s.d.cts +0 -255
  317. package/dist/registry-DIx25Q5s.d.cts.map +0 -1
  318. package/dist/registry-DIx25Q5s.d.mts +0 -255
  319. package/dist/registry-DIx25Q5s.d.mts.map +0 -1
  320. package/dist/registry-DXLY1Xf6.mjs +0 -99
  321. package/dist/registry-DXLY1Xf6.mjs.map +0 -1
  322. package/dist/registry-DlT36229.cjs +0 -122
  323. package/dist/registry-DlT36229.cjs.map +0 -1
  324. package/dist/rolldown-runtime-D7D4PA-g.mjs +0 -13
  325. package/dist/sns/index.cjs.map +0 -1
  326. package/dist/sns/index.d.cts.map +0 -1
  327. package/dist/sns/index.d.mts.map +0 -1
  328. package/dist/sns/index.mjs.map +0 -1
  329. package/dist/sns/snsUrl.cjs +0 -92
  330. package/dist/sns/snsUrl.cjs.map +0 -1
  331. package/dist/sns/snsUrl.d.cts +0 -57
  332. package/dist/sns/snsUrl.d.cts.map +0 -1
  333. package/dist/sns/snsUrl.d.mts +0 -57
  334. package/dist/sns/snsUrl.d.mts.map +0 -1
  335. package/dist/sns/snsUrl.mjs +0 -82
  336. package/dist/sns/snsUrl.mjs.map +0 -1
  337. package/dist/sqs/index.cjs.map +0 -1
  338. package/dist/sqs/index.d.cts.map +0 -1
  339. package/dist/sqs/index.d.mts.map +0 -1
  340. package/dist/sqs/index.mjs.map +0 -1
  341. package/dist/sqs/sqsUrl.cjs +0 -93
  342. package/dist/sqs/sqsUrl.cjs.map +0 -1
  343. package/dist/sqs/sqsUrl.d.cts +0 -56
  344. package/dist/sqs/sqsUrl.d.cts.map +0 -1
  345. package/dist/sqs/sqsUrl.d.mts +0 -56
  346. package/dist/sqs/sqsUrl.d.mts.map +0 -1
  347. package/dist/sqs/sqsUrl.mjs +0 -83
  348. package/dist/sqs/sqsUrl.mjs.map +0 -1
  349. package/dist/telemetry-DG3l807O.cjs +0 -309
  350. package/dist/telemetry-DG3l807O.cjs.map +0 -1
  351. package/dist/telemetry-DjjgJMul.mjs +0 -244
  352. package/dist/telemetry-DjjgJMul.mjs.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.mjs","names":["snsUrl.parse"],"sources":["../../src/sns/SNSConnection.ts","../../src/sns/SNSPublisher.ts","../../src/sns/SNSSubscriber.ts","../../src/sns/driver.ts","../../src/sns/push.ts"],"sourcesContent":["import { SNSClient, type SNSClientConfig } from '@aws-sdk/client-sns';\nimport type { EventConnection } from '../types';\nimport { EventPublisherType } from '../types';\nimport * as snsUrl from './snsUrl';\n\nexport interface SNSConnectionConfig {\n\ttopicArn: string;\n\tregion?: string;\n\tendpoint?: string; // Custom endpoint (e.g., for LocalStack)\n\tcredentials?: {\n\t\taccessKeyId: string;\n\t\tsecretAccessKey: string;\n\t\tsessionToken?: string;\n\t};\n}\n\nexport class SNSConnection implements EventConnection {\n\treadonly type = EventPublisherType.SNS;\n\tprivate client: SNSClient;\n\tprivate connected = false;\n\tprivate config: SNSConnectionConfig;\n\n\tconstructor(config: SNSConnectionConfig) {\n\t\tthis.config = config;\n\n\t\tconst clientConfig: SNSClientConfig = {\n\t\t\tregion: config.region,\n\t\t\tendpoint: config.endpoint,\n\t\t\tcredentials: config.credentials,\n\t\t};\n\n\t\tthis.client = new SNSClient(clientConfig);\n\t}\n\n\t/**\n\t * Create an SNSConnection from a connection string\n\t * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566\n\t */\n\tstatic async fromConnectionString(\n\t\tconnectionString: string,\n\t): Promise<SNSConnection> {\n\t\t// Through the codec, not a second hand-rolled parse: the deploy target\n\t\t// composes these with `snsUrl.build`, and a string it cannot read back is\n\t\t// exactly the drift one shared module rules out.\n\t\tconst { topicArn, region, endpoint } = snsUrl.parse(connectionString);\n\t\tconst params = new URL(connectionString).searchParams;\n\n\t\tconst config: SNSConnectionConfig = {\n\t\t\ttopicArn,\n\t\t\tregion,\n\t\t\tendpoint,\n\t\t};\n\n\t\t// Credentials are not part of the address — see `snsUrl` — but a caller\n\t\t// may still pin them here, so they are read beside it rather than in it.\n\t\tconst accessKeyId = params.get('accessKeyId');\n\t\tconst secretAccessKey = params.get('secretAccessKey');\n\t\tif (accessKeyId && secretAccessKey) {\n\t\t\tconfig.credentials = {\n\t\t\t\taccessKeyId,\n\t\t\t\tsecretAccessKey,\n\t\t\t\tsessionToken: params.get('sessionToken') || undefined,\n\t\t\t};\n\t\t}\n\n\t\tconst connection = new SNSConnection(config);\n\t\tawait connection.connect();\n\t\treturn connection;\n\t}\n\n\tasync connect(): Promise<void> {\n\t\t// SNS doesn't have a traditional connection, but we mark as connected\n\t\tthis.connected = true;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.client.destroy();\n\t\tthis.connected = false;\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Get the underlying SNS client\n\t */\n\tget snsClient(): SNSClient {\n\t\treturn this.client;\n\t}\n\n\t/**\n\t * Get the topic ARN for this connection\n\t */\n\tget topicArn(): string {\n\t\treturn this.config.topicArn;\n\t}\n}\n","import { PublishCommand } from '@aws-sdk/client-sns';\nimport { carrierAsAttributes, publishTraced } from '../telemetry';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SNSConnection } from './SNSConnection';\n\nexport type SNSPublisherOptions = {};\n\nexport class SNSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\tconstructor(\n\t\tprivate connection: SNSConnection,\n\t\t_options: SNSPublisherOptions = {},\n\t) {}\n\n\t/**\n\t * Create an SNSPublisher from a connection string\n\t * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SNSPublisher<TMessage>> {\n\t\tconst { SNSConnection } = await import('./SNSConnection');\n\t\tconst connection =\n\t\t\tawait SNSConnection.fromConnectionString(connectionString);\n\n\t\treturn new SNSPublisher<TMessage>(connection);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\tconst topicArn = this.connection.topicArn;\n\t\tconst destination = topicArn.split(':').pop() ?? topicArn;\n\t\tawait publishTraced(\n\t\t\tmessages,\n\t\t\t(message) => ({ system: 'aws_sns', destination, type: message.type }),\n\t\t\t(carriers) =>\n\t\t\t\tPromise.all(\n\t\t\t\t\tmessages.map((message, i) =>\n\t\t\t\t\t\tthis.publishMessage(message, carriers[i]),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t);\n\t}\n\n\tprivate async publishMessage(\n\t\tmessage: TMessage,\n\t\tcarrier: Record<string, string> | undefined,\n\t): Promise<void> {\n\t\tconst command = new PublishCommand({\n\t\t\tTopicArn: this.connection.topicArn,\n\t\t\tMessage: JSON.stringify({\n\t\t\t\ttype: message.type,\n\t\t\t\tpayload: message.payload,\n\t\t\t}),\n\t\t\tMessageAttributes: {\n\t\t\t\ttype: {\n\t\t\t\t\tDataType: 'String',\n\t\t\t\t\tStringValue: message.type,\n\t\t\t\t},\n\t\t\t\t// The trace context as message attributes: SNS hands them on to\n\t\t\t\t// an SQS subscription's envelope, an HTTP push and a Lambda record.\n\t\t\t\t...carrierAsAttributes(carrier),\n\t\t\t},\n\t\t});\n\n\t\tawait this.connection.snsClient.send(command);\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n","import { SubscribeCommand, UnsubscribeCommand } from '@aws-sdk/client-sns';\nimport {\n\tCreateQueueCommand,\n\tDeleteQueueCommand,\n\tGetQueueAttributesCommand,\n\tSetQueueAttributesCommand,\n\tSQSClient,\n} from '@aws-sdk/client-sqs';\nimport { SQSConnection } from '../sqs/SQSConnection';\nimport { SQSSubscriber } from '../sqs/SQSSubscriber';\nimport type { EventSubscriber, PublishableMessage } from '../types';\nimport type { SNSConnection } from './SNSConnection';\n\nexport interface SNSSubscriberOptions {\n\tqueueName?: string; // Optional queue name (defaults to auto-generated)\n\tcreateQueue?: boolean; // Auto-create SQS queue (default: true)\n\tdeleteQueueOnClose?: boolean; // Delete queue when subscriber closes (default: false for named queues, true for auto-generated)\n\twaitTimeSeconds?: number; // SQS long polling (default: 20)\n\tmaxMessages?: number; // Max messages per poll (default: 10)\n}\n\n/**\n * SNS Subscriber - receives push-based messages from SNS via SQS queue\n *\n * Architecture:\n * SNS Topic → (push) → SQS Queue → Subscriber\n *\n * This subscriber automatically:\n * 1. Creates an SQS queue (or uses existing one)\n * 2. Subscribes the queue to the SNS topic\n * 3. Receives messages pushed from SNS to the queue\n * 4. Filters messages by topic ARN and message type\n * 5. Processes and acknowledges messages\n *\n * Note: While SQS long-polling is used internally to receive messages,\n * this is an implementation detail of the SNS push delivery mechanism.\n * Messages are pushed from SNS to SQS, and we receive those pushed messages.\n */\nexport class SNSSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tprivate sqsClient: SQSClient;\n\tprivate queueUrl?: string;\n\tprivate queueArn?: string;\n\tprivate subscriptionArn?: string;\n\tprivate sqsSubscriber?: SQSSubscriber<TMessage>;\n\tprivate options: Required<SNSSubscriberOptions>;\n\n\tconstructor(\n\t\tprivate connection: SNSConnection,\n\t\toptions: SNSSubscriberOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tqueueName:\n\t\t\t\toptions.queueName ||\n\t\t\t\t`sns-sub-${Date.now()}-${Math.random().toString(36).substring(7)}`,\n\t\t\tcreateQueue: options.createQueue ?? true,\n\t\t\tdeleteQueueOnClose: options.deleteQueueOnClose ?? !options.queueName, // Delete auto-generated queues\n\t\t\twaitTimeSeconds: options.waitTimeSeconds ?? 20,\n\t\t\tmaxMessages: options.maxMessages ?? 10,\n\t\t};\n\n\t\t// Create SQS client with same config as SNS\n\t\tthis.sqsClient = new SQSClient({\n\t\t\tregion: (this.connection as any).config.region,\n\t\t\tendpoint: (this.connection as any).config.endpoint,\n\t\t\tcredentials: (this.connection as any).config.credentials,\n\t\t});\n\t}\n\n\t/**\n\t * Create an SNSSubscriber from a connection string\n\t * Format: sns://?topicArn=...&queueName=myqueue&region=us-east-1\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SNSSubscriber<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SNSConnection } = await import('./SNSConnection');\n\t\tconst connection =\n\t\t\tawait SNSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SNSSubscriberOptions = {\n\t\t\tqueueName: params.get('queueName') || undefined,\n\t\t\tcreateQueue: params.get('createQueue') !== 'false',\n\t\t\tdeleteQueueOnClose: params.get('deleteQueueOnClose') === 'true',\n\t\t\twaitTimeSeconds: params.get('waitTimeSeconds')\n\t\t\t\t? Number.parseInt(params.get('waitTimeSeconds')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SNSSubscriber<TMessage>(connection, options);\n\t}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\t// Setup SQS queue and SNS subscription\n\t\tawait this.setupQueue();\n\t\tawait this.subscribeToTopic();\n\n\t\t// Create SQS connection for the subscriber\n\t\tconst sqsConnection = new SQSConnection({\n\t\t\tqueueUrl: this.queueUrl!,\n\t\t\tregion: (this.connection as any).config.region,\n\t\t\tendpoint: (this.connection as any).config.endpoint,\n\t\t\tcredentials: (this.connection as any).config.credentials,\n\t\t});\n\t\tawait sqsConnection.connect();\n\n\t\t// Use SQSSubscriber to receive messages, with topic filtering\n\t\tthis.sqsSubscriber = new SQSSubscriber<TMessage>(sqsConnection, {\n\t\t\twaitTimeSeconds: this.options.waitTimeSeconds,\n\t\t\tmaxMessages: this.options.maxMessages,\n\t\t\texpectedTopicArn: this.connection.topicArn,\n\t\t});\n\n\t\tawait this.sqsSubscriber.subscribe(messages, listener);\n\t}\n\n\t/**\n\t * Stop receiving messages and clean up resources\n\t */\n\tasync stop(): Promise<void> {\n\t\t// Stop SQS subscriber\n\t\tif (this.sqsSubscriber) {\n\t\t\tthis.sqsSubscriber.stop();\n\t\t}\n\n\t\t// Unsubscribe from topic\n\t\tif (this.subscriptionArn) {\n\t\t\ttry {\n\t\t\t\tconst command = new UnsubscribeCommand({\n\t\t\t\t\tSubscriptionArn: this.subscriptionArn,\n\t\t\t\t});\n\t\t\t\tawait this.connection.snsClient.send(command);\n\t\t\t} catch (_error) {}\n\t\t}\n\n\t\t// Delete queue if configured\n\t\tif (this.queueUrl && this.options.deleteQueueOnClose) {\n\t\t\ttry {\n\t\t\t\tconst command = new DeleteQueueCommand({\n\t\t\t\t\tQueueUrl: this.queueUrl,\n\t\t\t\t});\n\t\t\t\tawait this.sqsClient.send(command);\n\t\t\t} catch (_error) {}\n\t\t}\n\n\t\tthis.sqsClient.destroy();\n\t}\n\n\tprivate async setupQueue(): Promise<void> {\n\t\tif (this.options.createQueue) {\n\t\t\t// Create queue\n\t\t\tconst createCommand = new CreateQueueCommand({\n\t\t\t\tQueueName: this.options.queueName,\n\t\t\t});\n\t\t\tconst response = await this.sqsClient.send(createCommand);\n\t\t\tthis.queueUrl = response.QueueUrl!;\n\t\t} else {\n\t\t\tthrow new SnsQueueMissing(this.options.queueName);\n\t\t}\n\n\t\t// Get queue ARN\n\t\tconst attrsCommand = new GetQueueAttributesCommand({\n\t\t\tQueueUrl: this.queueUrl,\n\t\t\tAttributeNames: ['QueueArn'],\n\t\t});\n\t\tconst attrsResponse = await this.sqsClient.send(attrsCommand);\n\t\tthis.queueArn = attrsResponse.Attributes?.QueueArn!;\n\n\t\t// Set queue policy to allow SNS\n\t\tawait this.setQueuePolicy();\n\t}\n\n\tprivate async setQueuePolicy(): Promise<void> {\n\t\tconst policy = {\n\t\t\tVersion: '2012-10-17',\n\t\t\tStatement: [\n\t\t\t\t{\n\t\t\t\t\tEffect: 'Allow',\n\t\t\t\t\tPrincipal: '*',\n\t\t\t\t\tAction: 'SQS:SendMessage',\n\t\t\t\t\tResource: this.queueArn,\n\t\t\t\t\tCondition: {\n\t\t\t\t\t\tArnEquals: {\n\t\t\t\t\t\t\t'aws:SourceArn': this.connection.topicArn,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\n\t\tconst command = new SetQueueAttributesCommand({\n\t\t\tQueueUrl: this.queueUrl,\n\t\t\tAttributes: {\n\t\t\t\tPolicy: JSON.stringify(policy),\n\t\t\t},\n\t\t});\n\n\t\tawait this.sqsClient.send(command);\n\t}\n\n\tprivate async subscribeToTopic(): Promise<void> {\n\t\tconst command = new SubscribeCommand({\n\t\t\tTopicArn: this.connection.topicArn,\n\t\t\tProtocol: 'sqs',\n\t\t\tEndpoint: this.queueArn,\n\t\t});\n\n\t\tconst response = await this.connection.snsClient.send(command);\n\t\tthis.subscriptionArn = response.SubscriptionArn!;\n\t}\n}\n\n/**\n * A subscriber asked to use a queue it may not create. The SQS queue behind an\n * SNS subscription has to exist first, or `createQueue` has to allow it.\n */\nexport class SnsQueueMissing extends Error {\n\tconstructor(readonly queueName: string | undefined) {\n\t\tsuper(\n\t\t\t`The SNS subscriber's queue${queueName ? ` \"${queueName}\"` : ''} is not created here: pass createQueue: true, or create the queue first.`,\n\t\t);\n\t\tthis.name = 'SnsQueueMissing';\n\t}\n}\n","import type { EventsDriver } from '../registry';\nimport { EventPublisherType } from '../types';\nimport { SNSConnection } from './SNSConnection';\nimport { SNSPublisher } from './SNSPublisher';\nimport { SNSSubscriber } from './SNSSubscriber';\n\n/**\n * `sns://` — an SNS topic, consumed through an SQS queue subscribed to it.\n * Register it with `registerEventsDriver(snsEventsDriver)`; an AWS entry\n * registers `sqsEventsDriver` beside it.\n */\nexport const snsEventsDriver: EventsDriver = {\n\tscheme: EventPublisherType.SNS,\n\tconnect: (url) => SNSConnection.fromConnectionString(url),\n\tpublisher: (url) => SNSPublisher.fromConnectionString(url),\n\tpublisherFor: (connection) => new SNSPublisher(connection as SNSConnection),\n\tsubscriber: (url) => SNSSubscriber.fromConnectionString(url),\n\tsubscriberFor: (connection) => new SNSSubscriber(connection as SNSConnection),\n};\n","import { createVerify } from 'node:crypto';\nimport {\n\tGetSubscriptionAttributesCommand,\n\tListSubscriptionsByTopicCommand,\n\tSetSubscriptionAttributesCommand,\n\tSubscribeCommand,\n\ttype SubscribeCommandInput,\n\tUnsubscribeCommand,\n} from '@aws-sdk/client-sns';\nimport type { SNSConnection } from './SNSConnection';\n\n/**\n * SNS delivering to an HTTP(S) endpoint, rather than to a queue that is polled.\n *\n * SNS POSTs each message to the subscribed URL as JSON. That is the whole\n * transport: no queue in between, no poller, and the endpoint is handed the\n * same envelope a Lambda subscription receives inside `Records[].Sns` — so the\n * handler that runs deployed can be the one that runs here.\n *\n * The endpoint is public, so a message is trusted only once its signature\n * checks out against a certificate SNS itself serves. Anything else that POSTs\n * there is somebody's guess at the shape.\n */\n\n/** A message SNS POSTs to a subscribed HTTP endpoint. */\nexport interface SnsHttpMessage {\n\tType: 'Notification' | 'SubscriptionConfirmation' | 'UnsubscribeConfirmation';\n\tMessageId: string;\n\tTopicArn: string;\n\tMessage: string;\n\tTimestamp: string;\n\tSignatureVersion: string;\n\tSignature: string;\n\tSigningCertURL: string;\n\tSubject?: string;\n\t/** Confirmation messages only. */\n\tToken?: string;\n\t/** Confirmation messages only: GET it to confirm. */\n\tSubscribeURL?: string;\n\t/** Notifications only. */\n\tUnsubscribeURL?: string;\n\tMessageAttributes?: Record<string, { Type: string; Value: string }>;\n}\n\n/** The fields signed, in the order SNS signs them, per message type. */\nconst SIGNED_FIELDS: Record<SnsHttpMessage['Type'], (keyof SnsHttpMessage)[]> =\n\t{\n\t\tNotification: [\n\t\t\t'Message',\n\t\t\t'MessageId',\n\t\t\t'Subject',\n\t\t\t'Timestamp',\n\t\t\t'TopicArn',\n\t\t\t'Type',\n\t\t],\n\t\tSubscriptionConfirmation: [\n\t\t\t'Message',\n\t\t\t'MessageId',\n\t\t\t'SubscribeURL',\n\t\t\t'Timestamp',\n\t\t\t'Token',\n\t\t\t'TopicArn',\n\t\t\t'Type',\n\t\t],\n\t\tUnsubscribeConfirmation: [\n\t\t\t'Message',\n\t\t\t'MessageId',\n\t\t\t'SubscribeURL',\n\t\t\t'Timestamp',\n\t\t\t'Token',\n\t\t\t'TopicArn',\n\t\t\t'Type',\n\t\t],\n\t};\n\n/**\n * Where SNS serves its signing certificates. Anywhere else is a certificate\n * the sender chose, which would let the sender sign its own forgeries.\n */\nconst SNS_CERTIFICATE_HOST = /^sns\\.[a-z0-9-]+\\.amazonaws\\.com(\\.cn)?$/;\n\nexport interface VerifySnsMessageOptions {\n\t/**\n\t * Fetch the PEM at a certificate URL. `fetch` by default; replaceable so a\n\t * test signs with its own key instead of SNS's.\n\t */\n\tfetchCertificate?: (url: string) => Promise<string>;\n}\n\nconst certificates = new Map<string, Promise<string>>();\n\nasync function defaultFetchCertificate(url: string): Promise<string> {\n\tconst response = await fetch(url);\n\tif (!response.ok) throw new SnsCertificateUnavailable(url, response.status);\n\treturn response.text();\n}\n\n/**\n * A URL, or undefined for a value that is not one at all — what an emulator\n * sends — so it is untrusted rather than a crash. (`URL.parse` is Node 22.1+.)\n */\nfunction parseUrl(value: unknown): URL | undefined {\n\ttry {\n\t\treturn new URL(String(value));\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/** The string SNS signed for this message. */\nexport function snsStringToSign(message: SnsHttpMessage): string {\n\tconst fields = SIGNED_FIELDS[message.Type];\n\tif (!fields) throw new SnsMessageTypeUnknown(String(message.Type));\n\n\treturn fields\n\t\t.filter((field) => message[field] !== undefined)\n\t\t.map((field) => `${field}\\n${message[field]}\\n`)\n\t\t.join('');\n}\n\n/**\n * Check that SNS sent this message: the certificate is SNS's own, and the\n * signature over the message's signed fields verifies against it.\n *\n * Throws rather than returning false, so a caller cannot forget to look.\n */\nexport async function verifySnsMessage(\n\tmessage: SnsHttpMessage,\n\toptions: VerifySnsMessageOptions = {},\n): Promise<void> {\n\tconst url = parseUrl(message.SigningCertURL);\n\tif (url?.protocol !== 'https:' || !SNS_CERTIFICATE_HOST.test(url.hostname)) {\n\t\tthrow new SnsCertificateUntrusted(message.SigningCertURL);\n\t}\n\n\tconst algorithm =\n\t\tmessage.SignatureVersion === '1'\n\t\t\t? 'RSA-SHA1'\n\t\t\t: message.SignatureVersion === '2'\n\t\t\t\t? 'RSA-SHA256'\n\t\t\t\t: undefined;\n\tif (!algorithm) {\n\t\tthrow new SnsSignatureVersionUnknown(message.SignatureVersion);\n\t}\n\n\tconst fetchCertificate = options.fetchCertificate ?? defaultFetchCertificate;\n\tlet certificate = certificates.get(message.SigningCertURL);\n\tif (!certificate || options.fetchCertificate) {\n\t\tcertificate = fetchCertificate(message.SigningCertURL);\n\t\t// Only SNS's real fetch is cached: a test's key belongs to that test.\n\t\tif (!options.fetchCertificate) {\n\t\t\tcertificates.set(message.SigningCertURL, certificate);\n\t\t\tcertificate.catch(() => certificates.delete(message.SigningCertURL));\n\t\t}\n\t}\n\n\tconst verifier = createVerify(algorithm);\n\tverifier.update(snsStringToSign(message), 'utf8');\n\tif (!verifier.verify(await certificate, message.Signature, 'base64')) {\n\t\tthrow new SnsSignatureInvalid(message.MessageId, message.TopicArn);\n\t}\n}\n\n/**\n * Confirm a subscription by visiting the URL SNS sent. Until this happens SNS\n * delivers nothing to the endpoint.\n */\nexport async function confirmSnsSubscription(\n\tmessage: SnsHttpMessage,\n\trequest: (url: string) => Promise<{ ok: boolean; status: number }> = fetch,\n): Promise<void> {\n\tif (message.Type !== 'SubscriptionConfirmation' || !message.SubscribeURL) {\n\t\tthrow new SnsNotAConfirmation(message.Type);\n\t}\n\n\tconst response = await request(message.SubscribeURL);\n\tif (!response.ok) {\n\t\tthrow new SnsConfirmationFailed(message.TopicArn, response.status);\n\t}\n}\n\nexport interface SubscribeHttpEndpointOptions {\n\t/** The URL SNS POSTs to — `http:` or `https:`, which picks the protocol. */\n\tendpoint: string;\n\t/**\n\t * The event types this endpoint takes. Becomes the subscription's filter\n\t * policy on the `type` attribute `SNSPublisher` sets, so SNS sends nothing\n\t * else — fan-out to every subscriber, each seeing only what it named.\n\t */\n\tevents: readonly string[];\n\t/**\n\t * An SQS queue's ARN for what SNS gives up delivering. SNS retries an HTTP\n\t * endpoint for a limited time and then drops the message, so without one an\n\t * outage longer than that loses events.\n\t */\n\tdeadLetterQueueArn?: string;\n}\n\n/**\n * Subscribe an HTTP endpoint to the connection's topic, converging on one\n * confirmed subscription with the filter asked for — so it is safe on every\n * start:\n *\n * - **none yet** — subscribed; SNS sends a confirmation to the endpoint.\n * - **confirmed** — its filter and dead-letter queue are brought up to date.\n * Subscribing again with different attributes is an error on SNS, and the\n * events a subscriber names change.\n * - **stuck pending** — a confirmation that never landed (the endpoint was\n * down, or answered wrong). Subscribing the same endpoint again is a no-op\n * on an emulator, so it is dropped and subscribed afresh, which sends a new\n * confirmation.\n */\nexport async function subscribeHttpEndpoint(\n\tconnection: SNSConnection,\n\toptions: SubscribeHttpEndpointOptions,\n): Promise<string | undefined> {\n\tconst protocol = new URL(options.endpoint).protocol.replace(':', '');\n\tif (protocol !== 'http' && protocol !== 'https') {\n\t\tthrow new SnsEndpointNotHttp(options.endpoint);\n\t}\n\n\tconst attributes: Record<string, string> = {\n\t\tFilterPolicyScope: 'MessageAttributes',\n\t\tFilterPolicy: JSON.stringify({ type: [...options.events] }),\n\t};\n\tif (options.deadLetterQueueArn) {\n\t\tattributes.RedrivePolicy = JSON.stringify({\n\t\t\tdeadLetterTargetArn: options.deadLetterQueueArn,\n\t\t});\n\t}\n\n\tconst client = connection.snsClient;\n\tconst existing = await existingSubscription(connection, options.endpoint);\n\tif (existing) {\n\t\tconst { Attributes = {} } = await client.send(\n\t\t\tnew GetSubscriptionAttributesCommand({ SubscriptionArn: existing }),\n\t\t);\n\t\tif (Attributes.PendingConfirmation === 'true') {\n\t\t\tawait client.send(new UnsubscribeCommand({ SubscriptionArn: existing }));\n\t\t} else {\n\t\t\tfor (const [name, value] of Object.entries(attributes)) {\n\t\t\t\tif (Attributes[name] === value) continue;\n\t\t\t\tawait client.send(\n\t\t\t\t\tnew SetSubscriptionAttributesCommand({\n\t\t\t\t\t\tSubscriptionArn: existing,\n\t\t\t\t\t\tAttributeName: name,\n\t\t\t\t\t\tAttributeValue: value,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn existing;\n\t\t}\n\t}\n\n\tconst { SubscriptionArn } = await client.send(\n\t\tnew SubscribeCommand({\n\t\t\tTopicArn: connection.topicArn,\n\t\t\tProtocol: protocol,\n\t\t\tEndpoint: options.endpoint,\n\t\t\tAttributes: attributes as SubscribeCommandInput['Attributes'],\n\t\t\tReturnSubscriptionArn: true,\n\t\t}),\n\t);\n\treturn SubscriptionArn;\n}\n\n/**\n * The ARN of the endpoint's subscription to the topic, if it has one SNS will\n * name. (Real SNS lists a pending one as `PendingConfirmation`, with no ARN to\n * act on — and resends its confirmation on a new Subscribe anyway.)\n */\nasync function existingSubscription(\n\tconnection: SNSConnection,\n\tendpoint: string,\n): Promise<string | undefined> {\n\tlet NextToken: string | undefined;\n\tdo {\n\t\tconst page = await connection.snsClient.send(\n\t\t\tnew ListSubscriptionsByTopicCommand({\n\t\t\t\tTopicArn: connection.topicArn,\n\t\t\t\tNextToken,\n\t\t\t}),\n\t\t);\n\t\tconst match = page.Subscriptions?.find(\n\t\t\t(s) => s.Endpoint === endpoint && s.SubscriptionArn?.startsWith('arn:'),\n\t\t);\n\t\tif (match) return match.SubscriptionArn;\n\t\tNextToken = page.NextToken;\n\t} while (NextToken);\n\treturn undefined;\n}\n\n/**\n * A pushed notification as the Lambda event SNS would have invoked a function\n * with, so it can be handed to the same adaptor.\n */\nexport function toSnsEvent(message: SnsHttpMessage, subscriptionArn = '') {\n\treturn {\n\t\tRecords: [\n\t\t\t{\n\t\t\t\tEventSource: 'aws:sns',\n\t\t\t\tEventVersion: '1.0',\n\t\t\t\tEventSubscriptionArn: subscriptionArn,\n\t\t\t\tSns: {\n\t\t\t\t\tType: message.Type,\n\t\t\t\t\tMessageId: message.MessageId,\n\t\t\t\t\tTopicArn: message.TopicArn,\n\t\t\t\t\tSubject: message.Subject ?? null,\n\t\t\t\t\tMessage: message.Message,\n\t\t\t\t\tTimestamp: message.Timestamp,\n\t\t\t\t\tSignatureVersion: message.SignatureVersion,\n\t\t\t\t\tSignature: message.Signature,\n\t\t\t\t\t// Lambda spells these two differently from the HTTP envelope.\n\t\t\t\t\tSigningCertUrl: message.SigningCertURL,\n\t\t\t\t\tUnsubscribeUrl: message.UnsubscribeURL ?? '',\n\t\t\t\t\tMessageAttributes: message.MessageAttributes ?? {},\n\t\t\t\t},\n\t\t\t},\n\t\t],\n\t};\n}\n\nexport class SnsCertificateUntrusted extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(\n\t\t\t`The SNS message names a signing certificate at '${url}', which is not ` +\n\t\t\t\t'an https URL on sns.<region>.amazonaws.com. Only SNS can send to ' +\n\t\t\t\t'this endpoint; reject the request.',\n\t\t);\n\t\tthis.name = 'SnsCertificateUntrusted';\n\t}\n}\n\nexport class SnsCertificateUnavailable extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly status: number,\n\t) {\n\t\tsuper(\n\t\t\t`Fetching the SNS signing certificate at '${url}' answered ${status}. ` +\n\t\t\t\t'The message cannot be verified, so it is not handled; SNS will retry.',\n\t\t);\n\t\tthis.name = 'SnsCertificateUnavailable';\n\t}\n}\n\nexport class SnsSignatureVersionUnknown extends Error {\n\tconstructor(readonly version: string) {\n\t\tsuper(\n\t\t\t`SNS signature version '${version}' is not one this endpoint verifies ` +\n\t\t\t\t\"(it knows '1' and '2'). Reject the request.\",\n\t\t);\n\t\tthis.name = 'SnsSignatureVersionUnknown';\n\t}\n}\n\nexport class SnsSignatureInvalid extends Error {\n\tconstructor(\n\t\treadonly messageId: string,\n\t\treadonly topicArn: string,\n\t) {\n\t\tsuper(\n\t\t\t`SNS message '${messageId}' from '${topicArn}' does not verify against ` +\n\t\t\t\t'its signing certificate. It was not sent by SNS, or was altered ' +\n\t\t\t\t'on the way; reject it.',\n\t\t);\n\t\tthis.name = 'SnsSignatureInvalid';\n\t}\n}\n\nexport class SnsMessageTypeUnknown extends Error {\n\tconstructor(readonly type: string) {\n\t\tsuper(\n\t\t\t`'${type}' is not an SNS message type (Notification, ` +\n\t\t\t\t'SubscriptionConfirmation, UnsubscribeConfirmation). Reject it.',\n\t\t);\n\t\tthis.name = 'SnsMessageTypeUnknown';\n\t}\n}\n\nexport class SnsNotAConfirmation extends Error {\n\tconstructor(readonly type: string) {\n\t\tsuper(\n\t\t\t`Only a SubscriptionConfirmation carries a URL to confirm; this is a ` +\n\t\t\t\t`'${type}'.`,\n\t\t);\n\t\tthis.name = 'SnsNotAConfirmation';\n\t}\n}\n\nexport class SnsConfirmationFailed extends Error {\n\tconstructor(\n\t\treadonly topicArn: string,\n\t\treadonly status: number,\n\t) {\n\t\tsuper(\n\t\t\t`Confirming the subscription to '${topicArn}' answered ${status}. ` +\n\t\t\t\t'SNS will deliver nothing until it is confirmed; it resends the ' +\n\t\t\t\t'confirmation, or subscribe the endpoint again.',\n\t\t);\n\t\tthis.name = 'SnsConfirmationFailed';\n\t}\n}\n\nexport class SnsEndpointNotHttp extends Error {\n\tconstructor(readonly endpoint: string) {\n\t\tsuper(\n\t\t\t`'${endpoint}' is not an http(s) URL. SNS pushes to an HTTP endpoint; ` +\n\t\t\t\t'subscribe a queue for anything else.',\n\t\t);\n\t\tthis.name = 'SnsEndpointNotHttp';\n\t}\n}\n"],"mappings":"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"}
@@ -1,92 +0,0 @@
1
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- //#region src/sns/snsUrl.ts
3
- var snsUrl_exports = /* @__PURE__ */ require("../rolldown-runtime-C0BPl7ul.cjs").__exportAll({
4
- MalformedTopicUrl: () => MalformedTopicUrl,
5
- MissingTopicArn: () => MissingTopicArn,
6
- UnexpectedTopicScheme: () => UnexpectedTopicScheme,
7
- build: () => build,
8
- parse: () => parse
9
- });
10
- const SCHEME = "sns:";
11
- /**
12
- * Compose an address into a connection string.
13
- *
14
- * Credentials never appear, for the same reason they never appear in an
15
- * `s3://` URL: the SDK resolves them from its own chain.
16
- */
17
- function build(address) {
18
- const { topicArn, region, endpoint, queueName } = address;
19
- if (!topicArn) throw new MissingTopicArn("");
20
- const url = new URL(`${SCHEME}//`);
21
- url.searchParams.set("topicArn", topicArn);
22
- if (region) url.searchParams.set("region", region);
23
- if (endpoint) url.searchParams.set("endpoint", endpoint);
24
- if (queueName) url.searchParams.set("queueName", queueName);
25
- return url.toString();
26
- }
27
- /** Parse a connection string back into an address. */
28
- function parse(connectionString) {
29
- let parsed;
30
- try {
31
- parsed = new URL(connectionString);
32
- } catch {
33
- throw new MalformedTopicUrl(connectionString);
34
- }
35
- if (parsed.protocol !== SCHEME) throw new UnexpectedTopicScheme(connectionString, SCHEME, parsed.protocol);
36
- const topicArn = parsed.searchParams.get("topicArn");
37
- if (!topicArn) throw new MissingTopicArn(connectionString);
38
- const region = parsed.searchParams.get("region") ?? void 0;
39
- const endpoint = parsed.searchParams.get("endpoint") ?? void 0;
40
- const queueName = parsed.searchParams.get("queueName") ?? void 0;
41
- return {
42
- topicArn,
43
- ...region ? { region } : {},
44
- ...endpoint ? { endpoint } : {},
45
- ...queueName ? { queueName } : {}
46
- };
47
- }
48
- /** The string is not a URL at all. */
49
- var MalformedTopicUrl = class extends Error {
50
- url;
51
- constructor(url) {
52
- super(`'${url}' is not a valid connection string.`);
53
- this.url = url;
54
- this.name = "MalformedTopicUrl";
55
- }
56
- };
57
- /** The string is a URL, but not an `sns://` one. */
58
- var UnexpectedTopicScheme = class extends Error {
59
- url;
60
- expected;
61
- actual;
62
- constructor(url, expected, actual) {
63
- super(`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`);
64
- this.url = url;
65
- this.expected = expected;
66
- this.actual = actual;
67
- this.name = "UnexpectedTopicScheme";
68
- }
69
- };
70
- /** An `sns://` string with no topic names nothing. */
71
- var MissingTopicArn = class extends Error {
72
- url;
73
- constructor(url) {
74
- super(url ? `'${url}' names no topic: an sns:// connection string needs ?topicArn=.` : "An sns:// connection string needs a topicArn.");
75
- this.url = url;
76
- this.name = "MissingTopicArn";
77
- }
78
- };
79
- //#endregion
80
- exports.MalformedTopicUrl = MalformedTopicUrl;
81
- exports.MissingTopicArn = MissingTopicArn;
82
- exports.UnexpectedTopicScheme = UnexpectedTopicScheme;
83
- exports.build = build;
84
- exports.parse = parse;
85
- Object.defineProperty(exports, "snsUrl_exports", {
86
- enumerable: true,
87
- get: function() {
88
- return snsUrl_exports;
89
- }
90
- });
91
-
92
- //# sourceMappingURL=snsUrl.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"snsUrl.cjs","names":[],"sources":["../../src/sns/snsUrl.ts"],"sourcesContent":["/**\n * The `sns://` connection-string codec — how a topic is addressed as one string.\n *\n * The twin of `sqsUrl`, and separate from it for the same reason `gs://` would\n * be separate from `s3://`: a topic ARN and a queue URL are different\n * vocabularies, and a shared codec would have to contain both. What they share\n * is only the rule that a construct provides one string.\n *\n * Both directions live here so they cannot drift: `parse(build(x))` is `x`.\n */\n\n/** What an SNS connection string addresses. */\nexport interface SnsAddress {\n\ttopicArn: string;\n\t/** Read off the topic, never inherited: a topic may live in another region. */\n\tregion?: string;\n\t/** Set for SNS-compatible backends such as LocalStack. */\n\tendpoint?: string;\n\t/**\n\t * The queue a subscriber drains.\n\t *\n\t * Present only on the subscriber's string: fan-out delivers to a queue per\n\t * subscriber, so the publisher's string names the topic and nothing else.\n\t */\n\tqueueName?: string;\n}\n\nconst SCHEME = 'sns:';\n\n/**\n * Compose an address into a connection string.\n *\n * Credentials never appear, for the same reason they never appear in an\n * `s3://` URL: the SDK resolves them from its own chain.\n */\nexport function build(address: SnsAddress): string {\n\tconst { topicArn, region, endpoint, queueName } = address;\n\tif (!topicArn) throw new MissingTopicArn('');\n\n\tconst url = new URL(`${SCHEME}//`);\n\turl.searchParams.set('topicArn', topicArn);\n\tif (region) url.searchParams.set('region', region);\n\tif (endpoint) url.searchParams.set('endpoint', endpoint);\n\tif (queueName) url.searchParams.set('queueName', queueName);\n\n\treturn url.toString();\n}\n\n/** Parse a connection string back into an address. */\nexport function parse(connectionString: string): SnsAddress {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(connectionString);\n\t} catch {\n\t\tthrow new MalformedTopicUrl(connectionString);\n\t}\n\n\tif (parsed.protocol !== SCHEME) {\n\t\tthrow new UnexpectedTopicScheme(connectionString, SCHEME, parsed.protocol);\n\t}\n\n\tconst topicArn = parsed.searchParams.get('topicArn');\n\tif (!topicArn) throw new MissingTopicArn(connectionString);\n\n\tconst region = parsed.searchParams.get('region') ?? undefined;\n\tconst endpoint = parsed.searchParams.get('endpoint') ?? undefined;\n\tconst queueName = parsed.searchParams.get('queueName') ?? undefined;\n\n\treturn {\n\t\ttopicArn,\n\t\t...(region ? { region } : {}),\n\t\t...(endpoint ? { endpoint } : {}),\n\t\t...(queueName ? { queueName } : {}),\n\t};\n}\n\n/** The string is not a URL at all. */\nexport class MalformedTopicUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(`'${url}' is not a valid connection string.`);\n\t\tthis.name = 'MalformedTopicUrl';\n\t}\n}\n\n/** The string is a URL, but not an `sns://` one. */\nexport class UnexpectedTopicScheme extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly expected: string,\n\t\treadonly actual: string,\n\t) {\n\t\tsuper(\n\t\t\t`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`,\n\t\t);\n\t\tthis.name = 'UnexpectedTopicScheme';\n\t}\n}\n\n/** An `sns://` string with no topic names nothing. */\nexport class MissingTopicArn extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(\n\t\t\turl\n\t\t\t\t? `'${url}' names no topic: an sns:// connection string needs ?topicArn=.`\n\t\t\t\t: 'An sns:// connection string needs a topicArn.',\n\t\t);\n\t\tthis.name = 'MissingTopicArn';\n\t}\n}\n"],"mappings":";;;;;;;;;AA2BA,MAAM,SAAS;;;;;;;AAQf,SAAgB,MAAM,SAA6B;CAClD,MAAM,EAAE,UAAU,QAAQ,UAAU,cAAc;CAClD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,EAAE;CAE3C,MAAM,MAAM,IAAI,IAAI,GAAG,OAAO,GAAG;CACjC,IAAI,aAAa,IAAI,YAAY,QAAQ;CACzC,IAAI,QAAQ,IAAI,aAAa,IAAI,UAAU,MAAM;CACjD,IAAI,UAAU,IAAI,aAAa,IAAI,YAAY,QAAQ;CACvD,IAAI,WAAW,IAAI,aAAa,IAAI,aAAa,SAAS;CAE1D,OAAO,IAAI,SAAS;AACrB;;AAGA,SAAgB,MAAM,kBAAsC;CAC3D,IAAI;CACJ,IAAI;EACH,SAAS,IAAI,IAAI,gBAAgB;CAClC,QAAQ;EACP,MAAM,IAAI,kBAAkB,gBAAgB;CAC7C;CAEA,IAAI,OAAO,aAAa,QACvB,MAAM,IAAI,sBAAsB,kBAAkB,QAAQ,OAAO,QAAQ;CAG1E,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU;CACnD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,gBAAgB;CAEzD,MAAM,SAAS,OAAO,aAAa,IAAI,QAAQ,KAAK,KAAA;CACpD,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU,KAAK,KAAA;CACxD,MAAM,YAAY,OAAO,aAAa,IAAI,WAAW,KAAK,KAAA;CAE1D,OAAO;EACN;EACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC3B,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;EAC/B,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;CAClC;AACD;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACvB;CAArB,YAAY,KAAsB;EACjC,MAAM,IAAI,IAAI,oCAAoC;EAD9B,KAAA,MAAA;EAEpB,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,wBAAb,cAA2C,MAAM;CAEtC;CACA;CACA;CAHV,YACC,KACA,UACA,QACC;EACD,MACC,eAAe,SAAS,iCAAiC,OAAO,UAAU,IAAI,GAC/E;EANS,KAAA,MAAA;EACA,KAAA,WAAA;EACA,KAAA,SAAA;EAKT,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,kBAAb,cAAqC,MAAM;CACrB;CAArB,YAAY,KAAsB;EACjC,MACC,MACG,IAAI,IAAI,mEACR,+CACJ;EALoB,KAAA,MAAA;EAMpB,KAAK,OAAO;CACb;AACD"}
@@ -1,57 +0,0 @@
1
- declare namespace snsUrl_d_exports {
2
- export { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse };
3
- }
4
- /**
5
- * The `sns://` connection-string codec — how a topic is addressed as one string.
6
- *
7
- * The twin of `sqsUrl`, and separate from it for the same reason `gs://` would
8
- * be separate from `s3://`: a topic ARN and a queue URL are different
9
- * vocabularies, and a shared codec would have to contain both. What they share
10
- * is only the rule that a construct provides one string.
11
- *
12
- * Both directions live here so they cannot drift: `parse(build(x))` is `x`.
13
- */
14
- /** What an SNS connection string addresses. */
15
- export interface SnsAddress {
16
- topicArn: string;
17
- /** Read off the topic, never inherited: a topic may live in another region. */
18
- region?: string;
19
- /** Set for SNS-compatible backends such as LocalStack. */
20
- endpoint?: string;
21
- /**
22
- * The queue a subscriber drains.
23
- *
24
- * Present only on the subscriber's string: fan-out delivers to a queue per
25
- * subscriber, so the publisher's string names the topic and nothing else.
26
- */
27
- queueName?: string;
28
- }
29
- /**
30
- * Compose an address into a connection string.
31
- *
32
- * Credentials never appear, for the same reason they never appear in an
33
- * `s3://` URL: the SDK resolves them from its own chain.
34
- */
35
- export declare function build(address: SnsAddress): string;
36
- /** Parse a connection string back into an address. */
37
- export declare function parse(connectionString: string): SnsAddress;
38
- /** The string is not a URL at all. */
39
- export declare class MalformedTopicUrl extends Error {
40
- readonly url: string;
41
- constructor(url: string);
42
- }
43
- /** The string is a URL, but not an `sns://` one. */
44
- export declare class UnexpectedTopicScheme extends Error {
45
- readonly url: string;
46
- readonly expected: string;
47
- readonly actual: string;
48
- constructor(url: string, expected: string, actual: string);
49
- }
50
- /** An `sns://` string with no topic names nothing. */
51
- export declare class MissingTopicArn extends Error {
52
- readonly url: string;
53
- constructor(url: string);
54
- }
55
- //#endregion
56
- export { snsUrl_d_exports as t };
57
- //# sourceMappingURL=snsUrl.d.cts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"snsUrl.d.cts","names":[],"sources":["../../src/sns/snsUrl.ts"],"mappings":";;;;;;;;;;;;;;iBAYiB;EAChB;;EAEA;;EAEA;;;;;;;EAOA;;;;;;;;wBAWe,MAAM,SAAS;;wBAcf,MAAM,2BAA2B;;qBA4BpC,0BAA0B;WACjB;EAArB,YAAqB;;;qBAOT,8BAA8B;WAEhC;WACA;WACA;EAHV,YACU,aACA,kBACA;;;qBAUE,wBAAwB;WACf;EAArB,YAAqB"}
@@ -1,57 +0,0 @@
1
- declare namespace snsUrl_d_exports {
2
- export { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse };
3
- }
4
- /**
5
- * The `sns://` connection-string codec — how a topic is addressed as one string.
6
- *
7
- * The twin of `sqsUrl`, and separate from it for the same reason `gs://` would
8
- * be separate from `s3://`: a topic ARN and a queue URL are different
9
- * vocabularies, and a shared codec would have to contain both. What they share
10
- * is only the rule that a construct provides one string.
11
- *
12
- * Both directions live here so they cannot drift: `parse(build(x))` is `x`.
13
- */
14
- /** What an SNS connection string addresses. */
15
- export interface SnsAddress {
16
- topicArn: string;
17
- /** Read off the topic, never inherited: a topic may live in another region. */
18
- region?: string;
19
- /** Set for SNS-compatible backends such as LocalStack. */
20
- endpoint?: string;
21
- /**
22
- * The queue a subscriber drains.
23
- *
24
- * Present only on the subscriber's string: fan-out delivers to a queue per
25
- * subscriber, so the publisher's string names the topic and nothing else.
26
- */
27
- queueName?: string;
28
- }
29
- /**
30
- * Compose an address into a connection string.
31
- *
32
- * Credentials never appear, for the same reason they never appear in an
33
- * `s3://` URL: the SDK resolves them from its own chain.
34
- */
35
- export declare function build(address: SnsAddress): string;
36
- /** Parse a connection string back into an address. */
37
- export declare function parse(connectionString: string): SnsAddress;
38
- /** The string is not a URL at all. */
39
- export declare class MalformedTopicUrl extends Error {
40
- readonly url: string;
41
- constructor(url: string);
42
- }
43
- /** The string is a URL, but not an `sns://` one. */
44
- export declare class UnexpectedTopicScheme extends Error {
45
- readonly url: string;
46
- readonly expected: string;
47
- readonly actual: string;
48
- constructor(url: string, expected: string, actual: string);
49
- }
50
- /** An `sns://` string with no topic names nothing. */
51
- export declare class MissingTopicArn extends Error {
52
- readonly url: string;
53
- constructor(url: string);
54
- }
55
- //#endregion
56
- export { snsUrl_d_exports as t };
57
- //# sourceMappingURL=snsUrl.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"snsUrl.d.mts","names":[],"sources":["../../src/sns/snsUrl.ts"],"mappings":";;;;;;;;;;;;;;iBAYiB;EAChB;;EAEA;;EAEA;;;;;;;EAOA;;;;;;;;wBAWe,MAAM,SAAS;;wBAcf,MAAM,2BAA2B;;qBA4BpC,0BAA0B;WACjB;EAArB,YAAqB;;;qBAOT,8BAA8B;WAEhC;WACA;WACA;EAHV,YACU,aACA,kBACA;;;qBAUE,wBAAwB;WACf;EAArB,YAAqB"}
@@ -1,82 +0,0 @@
1
- import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
2
- //#region src/sns/snsUrl.ts
3
- var snsUrl_exports = /* @__PURE__ */ __exportAll({
4
- MalformedTopicUrl: () => MalformedTopicUrl,
5
- MissingTopicArn: () => MissingTopicArn,
6
- UnexpectedTopicScheme: () => UnexpectedTopicScheme,
7
- build: () => build,
8
- parse: () => parse
9
- });
10
- const SCHEME = "sns:";
11
- /**
12
- * Compose an address into a connection string.
13
- *
14
- * Credentials never appear, for the same reason they never appear in an
15
- * `s3://` URL: the SDK resolves them from its own chain.
16
- */
17
- function build(address) {
18
- const { topicArn, region, endpoint, queueName } = address;
19
- if (!topicArn) throw new MissingTopicArn("");
20
- const url = new URL(`${SCHEME}//`);
21
- url.searchParams.set("topicArn", topicArn);
22
- if (region) url.searchParams.set("region", region);
23
- if (endpoint) url.searchParams.set("endpoint", endpoint);
24
- if (queueName) url.searchParams.set("queueName", queueName);
25
- return url.toString();
26
- }
27
- /** Parse a connection string back into an address. */
28
- function parse(connectionString) {
29
- let parsed;
30
- try {
31
- parsed = new URL(connectionString);
32
- } catch {
33
- throw new MalformedTopicUrl(connectionString);
34
- }
35
- if (parsed.protocol !== SCHEME) throw new UnexpectedTopicScheme(connectionString, SCHEME, parsed.protocol);
36
- const topicArn = parsed.searchParams.get("topicArn");
37
- if (!topicArn) throw new MissingTopicArn(connectionString);
38
- const region = parsed.searchParams.get("region") ?? void 0;
39
- const endpoint = parsed.searchParams.get("endpoint") ?? void 0;
40
- const queueName = parsed.searchParams.get("queueName") ?? void 0;
41
- return {
42
- topicArn,
43
- ...region ? { region } : {},
44
- ...endpoint ? { endpoint } : {},
45
- ...queueName ? { queueName } : {}
46
- };
47
- }
48
- /** The string is not a URL at all. */
49
- var MalformedTopicUrl = class extends Error {
50
- url;
51
- constructor(url) {
52
- super(`'${url}' is not a valid connection string.`);
53
- this.url = url;
54
- this.name = "MalformedTopicUrl";
55
- }
56
- };
57
- /** The string is a URL, but not an `sns://` one. */
58
- var UnexpectedTopicScheme = class extends Error {
59
- url;
60
- expected;
61
- actual;
62
- constructor(url, expected, actual) {
63
- super(`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`);
64
- this.url = url;
65
- this.expected = expected;
66
- this.actual = actual;
67
- this.name = "UnexpectedTopicScheme";
68
- }
69
- };
70
- /** An `sns://` string with no topic names nothing. */
71
- var MissingTopicArn = class extends Error {
72
- url;
73
- constructor(url) {
74
- super(url ? `'${url}' names no topic: an sns:// connection string needs ?topicArn=.` : "An sns:// connection string needs a topicArn.");
75
- this.url = url;
76
- this.name = "MissingTopicArn";
77
- }
78
- };
79
- //#endregion
80
- export { MalformedTopicUrl, MissingTopicArn, UnexpectedTopicScheme, build, parse, snsUrl_exports as t };
81
-
82
- //# sourceMappingURL=snsUrl.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"snsUrl.mjs","names":[],"sources":["../../src/sns/snsUrl.ts"],"sourcesContent":["/**\n * The `sns://` connection-string codec — how a topic is addressed as one string.\n *\n * The twin of `sqsUrl`, and separate from it for the same reason `gs://` would\n * be separate from `s3://`: a topic ARN and a queue URL are different\n * vocabularies, and a shared codec would have to contain both. What they share\n * is only the rule that a construct provides one string.\n *\n * Both directions live here so they cannot drift: `parse(build(x))` is `x`.\n */\n\n/** What an SNS connection string addresses. */\nexport interface SnsAddress {\n\ttopicArn: string;\n\t/** Read off the topic, never inherited: a topic may live in another region. */\n\tregion?: string;\n\t/** Set for SNS-compatible backends such as LocalStack. */\n\tendpoint?: string;\n\t/**\n\t * The queue a subscriber drains.\n\t *\n\t * Present only on the subscriber's string: fan-out delivers to a queue per\n\t * subscriber, so the publisher's string names the topic and nothing else.\n\t */\n\tqueueName?: string;\n}\n\nconst SCHEME = 'sns:';\n\n/**\n * Compose an address into a connection string.\n *\n * Credentials never appear, for the same reason they never appear in an\n * `s3://` URL: the SDK resolves them from its own chain.\n */\nexport function build(address: SnsAddress): string {\n\tconst { topicArn, region, endpoint, queueName } = address;\n\tif (!topicArn) throw new MissingTopicArn('');\n\n\tconst url = new URL(`${SCHEME}//`);\n\turl.searchParams.set('topicArn', topicArn);\n\tif (region) url.searchParams.set('region', region);\n\tif (endpoint) url.searchParams.set('endpoint', endpoint);\n\tif (queueName) url.searchParams.set('queueName', queueName);\n\n\treturn url.toString();\n}\n\n/** Parse a connection string back into an address. */\nexport function parse(connectionString: string): SnsAddress {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(connectionString);\n\t} catch {\n\t\tthrow new MalformedTopicUrl(connectionString);\n\t}\n\n\tif (parsed.protocol !== SCHEME) {\n\t\tthrow new UnexpectedTopicScheme(connectionString, SCHEME, parsed.protocol);\n\t}\n\n\tconst topicArn = parsed.searchParams.get('topicArn');\n\tif (!topicArn) throw new MissingTopicArn(connectionString);\n\n\tconst region = parsed.searchParams.get('region') ?? undefined;\n\tconst endpoint = parsed.searchParams.get('endpoint') ?? undefined;\n\tconst queueName = parsed.searchParams.get('queueName') ?? undefined;\n\n\treturn {\n\t\ttopicArn,\n\t\t...(region ? { region } : {}),\n\t\t...(endpoint ? { endpoint } : {}),\n\t\t...(queueName ? { queueName } : {}),\n\t};\n}\n\n/** The string is not a URL at all. */\nexport class MalformedTopicUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(`'${url}' is not a valid connection string.`);\n\t\tthis.name = 'MalformedTopicUrl';\n\t}\n}\n\n/** The string is a URL, but not an `sns://` one. */\nexport class UnexpectedTopicScheme extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly expected: string,\n\t\treadonly actual: string,\n\t) {\n\t\tsuper(\n\t\t\t`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`,\n\t\t);\n\t\tthis.name = 'UnexpectedTopicScheme';\n\t}\n}\n\n/** An `sns://` string with no topic names nothing. */\nexport class MissingTopicArn extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(\n\t\t\turl\n\t\t\t\t? `'${url}' names no topic: an sns:// connection string needs ?topicArn=.`\n\t\t\t\t: 'An sns:// connection string needs a topicArn.',\n\t\t);\n\t\tthis.name = 'MissingTopicArn';\n\t}\n}\n"],"mappings":";;;;;;;;;AA2BA,MAAM,SAAS;;;;;;;AAQf,SAAgB,MAAM,SAA6B;CAClD,MAAM,EAAE,UAAU,QAAQ,UAAU,cAAc;CAClD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,EAAE;CAE3C,MAAM,MAAM,IAAI,IAAI,GAAG,OAAO,GAAG;CACjC,IAAI,aAAa,IAAI,YAAY,QAAQ;CACzC,IAAI,QAAQ,IAAI,aAAa,IAAI,UAAU,MAAM;CACjD,IAAI,UAAU,IAAI,aAAa,IAAI,YAAY,QAAQ;CACvD,IAAI,WAAW,IAAI,aAAa,IAAI,aAAa,SAAS;CAE1D,OAAO,IAAI,SAAS;AACrB;;AAGA,SAAgB,MAAM,kBAAsC;CAC3D,IAAI;CACJ,IAAI;EACH,SAAS,IAAI,IAAI,gBAAgB;CAClC,QAAQ;EACP,MAAM,IAAI,kBAAkB,gBAAgB;CAC7C;CAEA,IAAI,OAAO,aAAa,QACvB,MAAM,IAAI,sBAAsB,kBAAkB,QAAQ,OAAO,QAAQ;CAG1E,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU;CACnD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,gBAAgB;CAEzD,MAAM,SAAS,OAAO,aAAa,IAAI,QAAQ,KAAK,KAAA;CACpD,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU,KAAK,KAAA;CACxD,MAAM,YAAY,OAAO,aAAa,IAAI,WAAW,KAAK,KAAA;CAE1D,OAAO;EACN;EACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC3B,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;EAC/B,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;CAClC;AACD;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACvB;CAArB,YAAY,KAAsB;EACjC,MAAM,IAAI,IAAI,oCAAoC;EAD9B,KAAA,MAAA;EAEpB,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,wBAAb,cAA2C,MAAM;CAEtC;CACA;CACA;CAHV,YACC,KACA,UACA,QACC;EACD,MACC,eAAe,SAAS,iCAAiC,OAAO,UAAU,IAAI,GAC/E;EANS,KAAA,MAAA;EACA,KAAA,WAAA;EACA,KAAA,SAAA;EAKT,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,kBAAb,cAAqC,MAAM;CACrB;CAArB,YAAY,KAAsB;EACjC,MACC,MACG,IAAI,IAAI,mEACR,+CACJ;EALoB,KAAA,MAAA;EAMpB,KAAK,OAAO;CACb;AACD"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.cjs","names":["SQSConnection","SQSPublisher","eventsDriverFor","SQSSubscriber"],"sources":["../../src/sqs/driver.ts"],"sourcesContent":["import { type EventsDriver, eventsDriverFor } from '../registry';\nimport { EventPublisherType } from '../types';\nimport { SQSConnection } from './SQSConnection';\nimport { SQSPublisher } from './SQSPublisher';\nimport { SQSSubscriber } from './SQSSubscriber';\n\n/**\n * `sqs://` — an SQS queue. Register it with\n * `registerEventsDriver(sqsEventsDriver)`; this subpath is the only one that\n * imports `@aws-sdk/client-sqs` on its own.\n */\nexport const sqsEventsDriver: EventsDriver = {\n\tscheme: EventPublisherType.SQS,\n\tconnect: (url) => SQSConnection.fromConnectionString(url),\n\tpublisher: (url) => SQSPublisher.fromConnectionString(url),\n\tpublisherFor: (connection) => new SQSPublisher(connection as SQSConnection),\n\tasync subscriber(url) {\n\t\t// A queue named with the topic it is subscribed to is a managed SNS→SQS\n\t\t// subscription, which is the SNS driver's to build — reached through the\n\t\t// registry, so this subpath never imports the SNS client.\n\t\tif (new URL(url).searchParams.get('topicArn')) {\n\t\t\treturn eventsDriverFor(EventPublisherType.SNS, 'subscriber').subscriber(\n\t\t\t\turl.replace(/^sqs:/, 'sns:'),\n\t\t\t);\n\t\t}\n\t\treturn new SQSSubscriber(await SQSConnection.fromConnectionString(url));\n\t},\n\tsubscriberFor: (connection) => new SQSSubscriber(connection as SQSConnection),\n};\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,kBAAgC;CAC5C,QAAA;CACA,UAAU,QAAQA,sBAAAA,cAAc,qBAAqB,GAAG;CACxD,YAAY,QAAQC,sBAAAA,aAAa,qBAAqB,GAAG;CACzD,eAAe,eAAe,IAAIA,sBAAAA,aAAa,UAA2B;CAC1E,MAAM,WAAW,KAAK;EAIrB,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,aAAa,IAAI,UAAU,GAC3C,OAAOC,iBAAAA,gBAAAA,OAAwC,YAAY,CAAC,CAAC,WAC5D,IAAI,QAAQ,SAAS,MAAM,CAC5B;EAED,OAAO,IAAIC,sBAAAA,cAAc,MAAMH,sBAAAA,cAAc,qBAAqB,GAAG,CAAC;CACvE;CACA,gBAAgB,eAAe,IAAIG,sBAAAA,cAAc,UAA2B;AAC7E"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.cts","names":[],"sources":["../../src/sqs/driver.ts","../../src/sqs/SQSConnection.ts","../../src/sqs/SQSPublisher.ts","../../src/sqs/SQSSubscriber.ts"],"mappings":";;;;;;;;;qBAWa,iBAAiB;;;UCNb;EAChB;EACA;EACA;EACA;IACC;IACA;IACA;;;qBAIW,yBAAyB;WAKhB,QAAQ;WAJpB,OAAI,mBAAA;UACL;UACA;EAER,YAAqB,QAAQ;;;;;SAgBhB,qBACZ,2BACE,QAAQ;EA8BL,WAAW;EAKX,SAAS;EAKf;;;;MAOI,aAAa;;;;MAOb;;;;UCnFY;EAChB;;qBAGY,aAAa,iBAAiB,4CAC/B,eAAe;WAKhB,YAAY;WAHb,SAAS,SAAS;EAE3B,YACU,YAAY,eACrB,UAAS;;;;;SAWG,qBACZ,iBAAiB,iCAChB,2BAA2B,QAAQ,aAAa;EAiB5C,QAAQ,UAAU,aAAa;UAcvB;UA2BA;EAqBR,SAAS;;;qBAOH,6BAA6B;WAE/B;IACR;IACA;IACA;;EAJF,YACU;IACR;IACA;IACA;;;;;UC/Gc;EAChB;EACA;EACA;;;;;;;;;;;;;;;qBAgBY,cAAc,iBAAiB,4CAChC,gBAAgB;UAQlB;UAND;UACA;UACA;UACA;EAER,YACS,YAAY,eACpB,UAAS;EASJ,UACL,UAAU,oBACV,WAAW,SAAS,aAAa,gBAC/B;EAYH;UAIc;UAqBA;;;;UA8DN;UAuCM;UAUN"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/sqs/driver.ts","../../src/sqs/SQSConnection.ts","../../src/sqs/SQSPublisher.ts","../../src/sqs/SQSSubscriber.ts"],"mappings":";;;;;;;;;qBAWa,iBAAiB;;;UCNb;EAChB;EACA;EACA;EACA;IACC;IACA;IACA;;;qBAIW,yBAAyB;WAKhB,QAAQ;WAJpB,OAAI,mBAAA;UACL;UACA;EAER,YAAqB,QAAQ;;;;;SAgBhB,qBACZ,2BACE,QAAQ;EA8BL,WAAW;EAKX,SAAS;EAKf;;;;MAOI,aAAa;;;;MAOb;;;;UCnFY;EAChB;;qBAGY,aAAa,iBAAiB,4CAC/B,eAAe;WAKhB,YAAY;WAHb,SAAS,SAAS;EAE3B,YACU,YAAY,eACrB,UAAS;;;;;SAWG,qBACZ,iBAAiB,iCAChB,2BAA2B,QAAQ,aAAa;EAiB5C,QAAQ,UAAU,aAAa;UAcvB;UA2BA;EAqBR,SAAS;;;qBAOH,6BAA6B;WAE/B;IACR;IACA;IACA;;EAJF,YACU;IACR;IACA;IACA;;;;;UC/Gc;EAChB;EACA;EACA;;;;;;;;;;;;;;;qBAgBY,cAAc,iBAAiB,4CAChC,gBAAgB;UAQlB;UAND;UACA;UACA;UACA;EAER,YACS,YAAY,eACpB,UAAS;EASJ,UACL,UAAU,oBACV,WAAW,SAAS,aAAa,gBAC/B;EAYH;UAIc;UAqBA;;;;UA8DN;UAuCM;UAUN"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../../src/sqs/driver.ts"],"sourcesContent":["import { type EventsDriver, eventsDriverFor } from '../registry';\nimport { EventPublisherType } from '../types';\nimport { SQSConnection } from './SQSConnection';\nimport { SQSPublisher } from './SQSPublisher';\nimport { SQSSubscriber } from './SQSSubscriber';\n\n/**\n * `sqs://` — an SQS queue. Register it with\n * `registerEventsDriver(sqsEventsDriver)`; this subpath is the only one that\n * imports `@aws-sdk/client-sqs` on its own.\n */\nexport const sqsEventsDriver: EventsDriver = {\n\tscheme: EventPublisherType.SQS,\n\tconnect: (url) => SQSConnection.fromConnectionString(url),\n\tpublisher: (url) => SQSPublisher.fromConnectionString(url),\n\tpublisherFor: (connection) => new SQSPublisher(connection as SQSConnection),\n\tasync subscriber(url) {\n\t\t// A queue named with the topic it is subscribed to is a managed SNS→SQS\n\t\t// subscription, which is the SNS driver's to build — reached through the\n\t\t// registry, so this subpath never imports the SNS client.\n\t\tif (new URL(url).searchParams.get('topicArn')) {\n\t\t\treturn eventsDriverFor(EventPublisherType.SNS, 'subscriber').subscriber(\n\t\t\t\turl.replace(/^sqs:/, 'sns:'),\n\t\t\t);\n\t\t}\n\t\treturn new SQSSubscriber(await SQSConnection.fromConnectionString(url));\n\t},\n\tsubscriberFor: (connection) => new SQSSubscriber(connection as SQSConnection),\n};\n"],"mappings":";;;;;;;;;;AAWA,MAAa,kBAAgC;CAC5C,QAAA;CACA,UAAU,QAAQ,cAAc,qBAAqB,GAAG;CACxD,YAAY,QAAQ,aAAa,qBAAqB,GAAG;CACzD,eAAe,eAAe,IAAI,aAAa,UAA2B;CAC1E,MAAM,WAAW,KAAK;EAIrB,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,aAAa,IAAI,UAAU,GAC3C,OAAO,gBAAA,OAAwC,YAAY,CAAC,CAAC,WAC5D,IAAI,QAAQ,SAAS,MAAM,CAC5B;EAED,OAAO,IAAI,cAAc,MAAM,cAAc,qBAAqB,GAAG,CAAC;CACvE;CACA,gBAAgB,eAAe,IAAI,cAAc,UAA2B;AAC7E"}
@@ -1,93 +0,0 @@
1
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- //#region src/sqs/sqsUrl.ts
3
- var sqsUrl_exports = /* @__PURE__ */ require("../rolldown-runtime-C0BPl7ul.cjs").__exportAll({
4
- MalformedQueueUrl: () => MalformedQueueUrl,
5
- MissingQueueUrl: () => MissingQueueUrl,
6
- UnexpectedQueueScheme: () => UnexpectedQueueScheme,
7
- build: () => build,
8
- parse: () => parse
9
- });
10
- const SCHEME = "sqs:";
11
- /**
12
- * Compose an address into a connection string.
13
- *
14
- * Credentials never appear. The AWS SDK resolves them from its own chain — an
15
- * execution role deployed, environment locally — so the string stays safe to log
16
- * and identical across environments that differ only in who is calling.
17
- */
18
- function build(address) {
19
- const { queueUrl, region, endpoint, maxBatchSize } = address;
20
- if (!queueUrl) throw new MissingQueueUrl("");
21
- const url = new URL(`${SCHEME}//`);
22
- url.searchParams.set("queueUrl", queueUrl);
23
- if (region) url.searchParams.set("region", region);
24
- if (endpoint) url.searchParams.set("endpoint", endpoint);
25
- if (maxBatchSize !== void 0) url.searchParams.set("maxBatchSize", String(maxBatchSize));
26
- return url.toString();
27
- }
28
- /** Parse a connection string back into an address. */
29
- function parse(connectionString) {
30
- let parsed;
31
- try {
32
- parsed = new URL(connectionString);
33
- } catch {
34
- throw new MalformedQueueUrl(connectionString);
35
- }
36
- if (parsed.protocol !== SCHEME) throw new UnexpectedQueueScheme(connectionString, SCHEME, parsed.protocol);
37
- const queueUrl = parsed.searchParams.get("queueUrl");
38
- if (!queueUrl) throw new MissingQueueUrl(connectionString);
39
- const region = parsed.searchParams.get("region") ?? void 0;
40
- const endpoint = parsed.searchParams.get("endpoint") ?? void 0;
41
- const batch = parsed.searchParams.get("maxBatchSize");
42
- return {
43
- queueUrl,
44
- ...region ? { region } : {},
45
- ...endpoint ? { endpoint } : {},
46
- ...batch ? { maxBatchSize: Number(batch) } : {}
47
- };
48
- }
49
- /** The string is not a URL at all. */
50
- var MalformedQueueUrl = class extends Error {
51
- url;
52
- constructor(url) {
53
- super(`'${url}' is not a valid connection string.`);
54
- this.url = url;
55
- this.name = "MalformedQueueUrl";
56
- }
57
- };
58
- /** The string is a URL, but not an `sqs://` one. */
59
- var UnexpectedQueueScheme = class extends Error {
60
- url;
61
- expected;
62
- actual;
63
- constructor(url, expected, actual) {
64
- super(`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`);
65
- this.url = url;
66
- this.expected = expected;
67
- this.actual = actual;
68
- this.name = "UnexpectedQueueScheme";
69
- }
70
- };
71
- /** An `sqs://` string with no queue names nothing. */
72
- var MissingQueueUrl = class extends Error {
73
- url;
74
- constructor(url) {
75
- super(url ? `'${url}' names no queue: an sqs:// connection string needs ?queueUrl=.` : "An sqs:// connection string needs a queueUrl.");
76
- this.url = url;
77
- this.name = "MissingQueueUrl";
78
- }
79
- };
80
- //#endregion
81
- exports.MalformedQueueUrl = MalformedQueueUrl;
82
- exports.MissingQueueUrl = MissingQueueUrl;
83
- exports.UnexpectedQueueScheme = UnexpectedQueueScheme;
84
- exports.build = build;
85
- exports.parse = parse;
86
- Object.defineProperty(exports, "sqsUrl_exports", {
87
- enumerable: true,
88
- get: function() {
89
- return sqsUrl_exports;
90
- }
91
- });
92
-
93
- //# sourceMappingURL=sqsUrl.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sqsUrl.cjs","names":[],"sources":["../../src/sqs/sqsUrl.ts"],"sourcesContent":["/**\n * The `sqs://` connection-string codec — how a queue is addressed as one string.\n *\n * It lives beside the client rather than in a neutral package because\n * `queueUrl`, `region`, and `endpoint` are SQS's vocabulary. The neutral layer\n * knows only that a queue provides *one* connection string; what that string\n * says is between the component that composes it and the publisher that parses\n * it. The `pgboss://` form sits beside its own client and shares nothing here.\n *\n * Both directions live in this module so they cannot drift: `parse(build(x))`\n * is `x`, and the deploy target composing a string it cannot parse back is the\n * failure this shape rules out.\n */\n\n/** What an SQS connection string addresses. */\nexport interface SqsAddress {\n\tqueueUrl: string;\n\t/** Read off the queue, never inherited: a queue may live in another region. */\n\tregion?: string;\n\t/** Set for SQS-compatible backends such as LocalStack. */\n\tendpoint?: string;\n\t/** Largest batch the publisher may send in one call. */\n\tmaxBatchSize?: number;\n}\n\nconst SCHEME = 'sqs:';\n\n/**\n * Compose an address into a connection string.\n *\n * Credentials never appear. The AWS SDK resolves them from its own chain — an\n * execution role deployed, environment locally — so the string stays safe to log\n * and identical across environments that differ only in who is calling.\n */\nexport function build(address: SqsAddress): string {\n\tconst { queueUrl, region, endpoint, maxBatchSize } = address;\n\tif (!queueUrl) throw new MissingQueueUrl('');\n\n\tconst url = new URL(`${SCHEME}//`);\n\turl.searchParams.set('queueUrl', queueUrl);\n\tif (region) url.searchParams.set('region', region);\n\tif (endpoint) url.searchParams.set('endpoint', endpoint);\n\tif (maxBatchSize !== undefined) {\n\t\turl.searchParams.set('maxBatchSize', String(maxBatchSize));\n\t}\n\n\treturn url.toString();\n}\n\n/** Parse a connection string back into an address. */\nexport function parse(connectionString: string): SqsAddress {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(connectionString);\n\t} catch {\n\t\tthrow new MalformedQueueUrl(connectionString);\n\t}\n\n\tif (parsed.protocol !== SCHEME) {\n\t\tthrow new UnexpectedQueueScheme(connectionString, SCHEME, parsed.protocol);\n\t}\n\n\tconst queueUrl = parsed.searchParams.get('queueUrl');\n\tif (!queueUrl) throw new MissingQueueUrl(connectionString);\n\n\tconst region = parsed.searchParams.get('region') ?? undefined;\n\tconst endpoint = parsed.searchParams.get('endpoint') ?? undefined;\n\tconst batch = parsed.searchParams.get('maxBatchSize');\n\n\treturn {\n\t\tqueueUrl,\n\t\t...(region ? { region } : {}),\n\t\t...(endpoint ? { endpoint } : {}),\n\t\t...(batch ? { maxBatchSize: Number(batch) } : {}),\n\t};\n}\n\n/** The string is not a URL at all. */\nexport class MalformedQueueUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(`'${url}' is not a valid connection string.`);\n\t\tthis.name = 'MalformedQueueUrl';\n\t}\n}\n\n/** The string is a URL, but not an `sqs://` one. */\nexport class UnexpectedQueueScheme extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly expected: string,\n\t\treadonly actual: string,\n\t) {\n\t\tsuper(\n\t\t\t`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`,\n\t\t);\n\t\tthis.name = 'UnexpectedQueueScheme';\n\t}\n}\n\n/** An `sqs://` string with no queue names nothing. */\nexport class MissingQueueUrl extends Error {\n\tconstructor(readonly url: string) {\n\t\tsuper(\n\t\t\turl\n\t\t\t\t? `'${url}' names no queue: an sqs:// connection string needs ?queueUrl=.`\n\t\t\t\t: 'An sqs:// connection string needs a queueUrl.',\n\t\t);\n\t\tthis.name = 'MissingQueueUrl';\n\t}\n}\n"],"mappings":";;;;;;;;;AAyBA,MAAM,SAAS;;;;;;;;AASf,SAAgB,MAAM,SAA6B;CAClD,MAAM,EAAE,UAAU,QAAQ,UAAU,iBAAiB;CACrD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,EAAE;CAE3C,MAAM,MAAM,IAAI,IAAI,GAAG,OAAO,GAAG;CACjC,IAAI,aAAa,IAAI,YAAY,QAAQ;CACzC,IAAI,QAAQ,IAAI,aAAa,IAAI,UAAU,MAAM;CACjD,IAAI,UAAU,IAAI,aAAa,IAAI,YAAY,QAAQ;CACvD,IAAI,iBAAiB,KAAA,GACpB,IAAI,aAAa,IAAI,gBAAgB,OAAO,YAAY,CAAC;CAG1D,OAAO,IAAI,SAAS;AACrB;;AAGA,SAAgB,MAAM,kBAAsC;CAC3D,IAAI;CACJ,IAAI;EACH,SAAS,IAAI,IAAI,gBAAgB;CAClC,QAAQ;EACP,MAAM,IAAI,kBAAkB,gBAAgB;CAC7C;CAEA,IAAI,OAAO,aAAa,QACvB,MAAM,IAAI,sBAAsB,kBAAkB,QAAQ,OAAO,QAAQ;CAG1E,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU;CACnD,IAAI,CAAC,UAAU,MAAM,IAAI,gBAAgB,gBAAgB;CAEzD,MAAM,SAAS,OAAO,aAAa,IAAI,QAAQ,KAAK,KAAA;CACpD,MAAM,WAAW,OAAO,aAAa,IAAI,UAAU,KAAK,KAAA;CACxD,MAAM,QAAQ,OAAO,aAAa,IAAI,cAAc;CAEpD,OAAO;EACN;EACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC3B,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;EAC/B,GAAI,QAAQ,EAAE,cAAc,OAAO,KAAK,EAAE,IAAI,CAAC;CAChD;AACD;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACvB;CAArB,YAAY,KAAsB;EACjC,MAAM,IAAI,IAAI,oCAAoC;EAD9B,KAAA,MAAA;EAEpB,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,wBAAb,cAA2C,MAAM;CAEtC;CACA;CACA;CAHV,YACC,KACA,UACA,QACC;EACD,MACC,eAAe,SAAS,iCAAiC,OAAO,UAAU,IAAI,GAC/E;EANS,KAAA,MAAA;EACA,KAAA,WAAA;EACA,KAAA,SAAA;EAKT,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,kBAAb,cAAqC,MAAM;CACrB;CAArB,YAAY,KAAsB;EACjC,MACC,MACG,IAAI,IAAI,mEACR,+CACJ;EALoB,KAAA,MAAA;EAMpB,KAAK,OAAO;CACb;AACD"}
@@ -1,56 +0,0 @@
1
- declare namespace sqsUrl_d_exports {
2
- export { MalformedQueueUrl, MissingQueueUrl, SqsAddress, UnexpectedQueueScheme, build, parse };
3
- }
4
- /**
5
- * The `sqs://` connection-string codec — how a queue is addressed as one string.
6
- *
7
- * It lives beside the client rather than in a neutral package because
8
- * `queueUrl`, `region`, and `endpoint` are SQS's vocabulary. The neutral layer
9
- * knows only that a queue provides *one* connection string; what that string
10
- * says is between the component that composes it and the publisher that parses
11
- * it. The `pgboss://` form sits beside its own client and shares nothing here.
12
- *
13
- * Both directions live in this module so they cannot drift: `parse(build(x))`
14
- * is `x`, and the deploy target composing a string it cannot parse back is the
15
- * failure this shape rules out.
16
- */
17
- /** What an SQS connection string addresses. */
18
- export interface SqsAddress {
19
- queueUrl: string;
20
- /** Read off the queue, never inherited: a queue may live in another region. */
21
- region?: string;
22
- /** Set for SQS-compatible backends such as LocalStack. */
23
- endpoint?: string;
24
- /** Largest batch the publisher may send in one call. */
25
- maxBatchSize?: number;
26
- }
27
- /**
28
- * Compose an address into a connection string.
29
- *
30
- * Credentials never appear. The AWS SDK resolves them from its own chain — an
31
- * execution role deployed, environment locally — so the string stays safe to log
32
- * and identical across environments that differ only in who is calling.
33
- */
34
- export declare function build(address: SqsAddress): string;
35
- /** Parse a connection string back into an address. */
36
- export declare function parse(connectionString: string): SqsAddress;
37
- /** The string is not a URL at all. */
38
- export declare class MalformedQueueUrl extends Error {
39
- readonly url: string;
40
- constructor(url: string);
41
- }
42
- /** The string is a URL, but not an `sqs://` one. */
43
- export declare class UnexpectedQueueScheme extends Error {
44
- readonly url: string;
45
- readonly expected: string;
46
- readonly actual: string;
47
- constructor(url: string, expected: string, actual: string);
48
- }
49
- /** An `sqs://` string with no queue names nothing. */
50
- export declare class MissingQueueUrl extends Error {
51
- readonly url: string;
52
- constructor(url: string);
53
- }
54
- //#endregion
55
- export { sqsUrl_d_exports as t };
56
- //# sourceMappingURL=sqsUrl.d.cts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sqsUrl.d.cts","names":[],"sources":["../../src/sqs/sqsUrl.ts"],"mappings":";;;;;;;;;;;;;;;;;iBAeiB;EAChB;;EAEA;;EAEA;;EAEA;;;;;;;;;wBAYe,MAAM,SAAS;;wBAgBf,MAAM,2BAA2B;;qBA4BpC,0BAA0B;WACjB;EAArB,YAAqB;;;qBAOT,8BAA8B;WAEhC;WACA;WACA;EAHV,YACU,aACA,kBACA;;;qBAUE,wBAAwB;WACf;EAArB,YAAqB"}