@fedify/fedify 2.0.0-dev.1641 → 2.0.0-dev.167

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 (316) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +66 -30
  3. package/dist/{assert_rejects-7UF4R_Qs.js → assert_rejects-Ce45JcFg.js} +1 -1
  4. package/dist/{assert_is_error-B035L3om.js → assert_throws-BNXdRGWP.js} +31 -1
  5. package/dist/{builder-E2Icrl_a.js → builder-CRQGVq_N.js} +15 -8
  6. package/dist/{client-bgSdkFa2.d.ts → client-CUTUGgvJ.d.ts} +19 -19
  7. package/dist/{client-BW4V0OJx.js → client-Dg7OfUDA.js} +28 -23
  8. package/dist/{client-CegPX0Rn.d.cts → client-by-PEGAJ.d.cts} +19 -19
  9. package/dist/compat/mod.cjs +1 -1
  10. package/dist/compat/mod.d.cts +6 -12
  11. package/dist/compat/mod.d.ts +6 -12
  12. package/dist/compat/mod.js +1 -1
  13. package/dist/compat/transformers.test.js +21 -19
  14. package/dist/context-Bns6uTJq.js +109 -0
  15. package/dist/{context-CDSZdQHD.d.ts → context-C7vzWilY.d.ts} +374 -182
  16. package/dist/{context-Dq8aCtMH.d.cts → context-CrB9RFy5.d.cts} +374 -182
  17. package/dist/deno-Bvf4AA-X.js +117 -0
  18. package/dist/{testing-ByQmUvf-.js → dist-B5f6a8Tt.js} +90 -111
  19. package/dist/{authdocloader-BkIZCKQv.js → docloader-2gNKaklf.js} +17 -8
  20. package/dist/{esm-mtx3XJAD.js → esm-DGl7uK1r.js} +32 -17
  21. package/dist/federation/builder.test.js +9 -9
  22. package/dist/federation/collection.test.js +3 -6
  23. package/dist/federation/handler.test.js +113 -145
  24. package/dist/federation/idempotency.test.js +202 -0
  25. package/dist/federation/inbox.test.js +5 -6
  26. package/dist/federation/keycache.test.js +4 -5
  27. package/dist/federation/kv.test.js +58 -7
  28. package/dist/federation/middleware.test.js +306 -111
  29. package/dist/federation/mod.cjs +8 -12
  30. package/dist/federation/mod.d.cts +7 -13
  31. package/dist/federation/mod.d.ts +7 -13
  32. package/dist/federation/mod.js +8 -13
  33. package/dist/federation/mq.test.js +7 -8
  34. package/dist/federation/negotiation.test.js +25 -0
  35. package/dist/federation/retry.test.js +2 -4
  36. package/dist/federation/router.test.js +4 -6
  37. package/dist/federation/send.test.js +53 -13
  38. package/dist/{webfinger/handler.test.js → federation/webfinger.test.js} +25 -23
  39. package/dist/{federation-H2_En3j5.cjs → federation-B431K2gm.cjs} +22 -0
  40. package/dist/{federation-D1U8YY9t.js → federation-BbZwNNWj.js} +28 -6
  41. package/dist/{http-C7uYFcBo.js → http-0lpbWrFT.js} +371 -11
  42. package/dist/{http-BS6766zs.d.cts → http-ClB3pLcL.d.cts} +2 -2
  43. package/dist/{http-DqSNLFNY.d.ts → http-DLBDPal9.d.ts} +2 -2
  44. package/dist/{http-Cox5GsED.js → http-DP374h--.js} +3 -2
  45. package/dist/{http-ZhcoaYEa.cjs → http-d_vxukl7.cjs} +410 -14
  46. package/dist/{inbox-BDdRbWNI.js → inbox-Dv3k4z7l.js} +25 -7
  47. package/dist/{key-CfiBDu3o.js → key-t0uDOx8t.js} +3 -2
  48. package/dist/{keycache-CVBjz3xi.js → keycache-DRxpZ5r9.js} +1 -1
  49. package/dist/{keys-CBKbYaJA.js → keys-ZbcByPg9.js} +2 -1
  50. package/dist/{kv-63Cil1MD.d.cts → kv-B4vFhIYL.d.cts} +30 -1
  51. package/dist/{kv-C7sopW2E.d.ts → kv-CYySNrsn.d.ts} +30 -1
  52. package/dist/{kv-CRZrzyXm.js → kv-QzKcOQgP.js} +22 -0
  53. package/dist/kv-cache-BEeqyGER.js +107 -0
  54. package/dist/kv-cache-KFREoRaI.cjs +134 -0
  55. package/dist/kv-cache-aVS_ypNU.js +122 -0
  56. package/dist/{ld-CxgmnSO3.js → ld-CpXPfqRW.js} +4 -2
  57. package/dist/middleware-6Nb3n763.js +12 -0
  58. package/dist/{middleware-LyCG_YVM.cjs → middleware-Clcecst5.cjs} +309 -303
  59. package/dist/{middleware-DXidHY4N.js → middleware-DEy7WEOy.js} +254 -254
  60. package/dist/{middleware-ByPnvMMS.js → middleware-DLaPtWGX.js} +215 -313
  61. package/dist/middleware-DRg9fmN1.js +26 -0
  62. package/dist/middleware-lkdHuEk5.cjs +12 -0
  63. package/dist/mod-0p9zUdzg.d.cts +107 -0
  64. package/dist/mod-0qnPv4EC.d.cts +62 -0
  65. package/dist/{mod-BClfg3ej.d.cts → mod-BrS8tiad.d.cts} +3 -3
  66. package/dist/mod-C3SOvTD1.d.ts +64 -0
  67. package/dist/{mod-BhMnAkFX.d.cts → mod-D6pS5_xJ.d.cts} +4 -4
  68. package/dist/{mod-Drmz72EK.d.ts → mod-jOa7W503.d.ts} +3 -3
  69. package/dist/{mod-RI3-KvUI.d.ts → mod-waqu-BL_.d.ts} +4 -4
  70. package/dist/mod-xc20HhMD.d.ts +109 -0
  71. package/dist/mod.cjs +17 -112
  72. package/dist/mod.d.cts +11 -17
  73. package/dist/mod.d.ts +11 -17
  74. package/dist/mod.js +11 -17
  75. package/dist/negotiation-5NPJL6zp.js +71 -0
  76. package/dist/nodeinfo/client.test.js +5 -8
  77. package/dist/nodeinfo/handler.test.js +23 -22
  78. package/dist/nodeinfo/mod.cjs +2 -3
  79. package/dist/nodeinfo/mod.d.cts +2 -4
  80. package/dist/nodeinfo/mod.d.ts +2 -4
  81. package/dist/nodeinfo/mod.js +2 -3
  82. package/dist/nodeinfo/types.test.js +4 -7
  83. package/dist/otel/exporter.test.js +893 -0
  84. package/dist/otel/mod.cjs +256 -0
  85. package/dist/otel/mod.d.cts +230 -0
  86. package/dist/otel/mod.d.ts +232 -0
  87. package/dist/otel/mod.js +255 -0
  88. package/dist/{owner-Cxob5_PK.js → owner-BaG2jUgZ.js} +45 -8
  89. package/dist/{owner-CQPnQVtf.d.ts → owner-BgI8C-VY.d.ts} +2 -3
  90. package/dist/{owner-B-7Ptt_m.d.cts → owner-C-zfmVAD.d.cts} +2 -3
  91. package/dist/{proof-DkxwMaWE.js → proof-ClXweyp2.js} +47 -11
  92. package/dist/{proof-2Gcor0_N.cjs → proof-Cy-QcHCv.cjs} +69 -33
  93. package/dist/{proof-BiSQNUmQ.js → proof-D8bfMlig.js} +3 -2
  94. package/dist/router-D9eI0s4b.js +118 -0
  95. package/dist/{send-DSEhWIYD.js → send-BLogwy3G.js} +9 -4
  96. package/dist/sig/http.test.js +9 -11
  97. package/dist/sig/key.test.js +7 -9
  98. package/dist/sig/ld.test.js +8 -10
  99. package/dist/sig/mod.cjs +7 -11
  100. package/dist/sig/mod.d.cts +3 -7
  101. package/dist/sig/mod.d.ts +3 -7
  102. package/dist/sig/mod.js +3 -7
  103. package/dist/sig/owner.test.js +31 -10
  104. package/dist/sig/proof.test.js +11 -12
  105. package/dist/testing/mod.d.ts +243 -6982
  106. package/dist/testing/mod.js +4 -4
  107. package/dist/{transformers-CoBS-oFG.cjs → transformers-BjBg6Lag.cjs} +2 -2
  108. package/dist/{transformers-BFT6d7J5.js → transformers-N_ip_y4P.js} +2 -2
  109. package/dist/{types-l2uh_ZhP.js → types-8l28uC8o.js} +31 -26
  110. package/dist/{types-Bqt2EgP0.cjs → types-B6z6CqIz.cjs} +33 -28
  111. package/dist/{types-BSuWJsOm.js → types-CPz01LGH.js} +3 -3
  112. package/dist/{runtime/authdocloader.test.js → utils/docloader.test.js} +11 -13
  113. package/dist/utils/kv-cache.test.js +211 -0
  114. package/dist/utils/mod.cjs +10 -0
  115. package/dist/utils/mod.d.cts +4 -0
  116. package/dist/utils/mod.d.ts +6 -0
  117. package/dist/utils/mod.js +9 -0
  118. package/package.json +34 -75
  119. package/dist/actor-C22bXuuC.d.ts +0 -130
  120. package/dist/actor-CP03csrm.cjs +0 -37786
  121. package/dist/actor-DMgu-ZjT.d.cts +0 -128
  122. package/dist/actor-DU511yTk.js +0 -37312
  123. package/dist/actor-DVpsNXhn.js +0 -146
  124. package/dist/assert_throws-53_pKeP3.js +0 -39
  125. package/dist/authdocloader-BnsFSERg.cjs +0 -58
  126. package/dist/authdocloader-DCgMyo82.js +0 -52
  127. package/dist/denokv-jZ0Z2h0M.js +0 -57
  128. package/dist/docloader-BtqIh1OE.js +0 -4795
  129. package/dist/docloader-CxWcuWqQ.d.ts +0 -221
  130. package/dist/docloader-D-MrRyHl.d.cts +0 -219
  131. package/dist/docloader-kae6M-GI.cjs +0 -4861
  132. package/dist/fixtures/activitypub.academy/users/brauca_darradiul.json +0 -83
  133. package/dist/fixtures/example.com/announce.json +0 -6
  134. package/dist/fixtures/example.com/collection.json +0 -19
  135. package/dist/fixtures/example.com/create.json +0 -6
  136. package/dist/fixtures/example.com/cross-origin-actor.json +0 -6
  137. package/dist/fixtures/example.com/hong-gildong.json +0 -11
  138. package/dist/fixtures/example.com/invite.json +0 -7
  139. package/dist/fixtures/example.com/key.json +0 -7
  140. package/dist/fixtures/example.com/key2.json +0 -6
  141. package/dist/fixtures/example.com/object.json +0 -6
  142. package/dist/fixtures/example.com/orderedcollectionpage.json +0 -24
  143. package/dist/fixtures/example.com/paged/a.json +0 -13
  144. package/dist/fixtures/example.com/paged/b.json +0 -16
  145. package/dist/fixtures/example.com/paged-collection.json +0 -6
  146. package/dist/fixtures/example.com/person.json +0 -22
  147. package/dist/fixtures/example.com/person2.json +0 -40
  148. package/dist/fixtures/example.com/test.json +0 -5
  149. package/dist/fixtures/example.com/users/handle.json +0 -16
  150. package/dist/fixtures/example.com/wrong-type.json +0 -3
  151. package/dist/fixtures/oeee.cafe/ap/users/3609fd4e-d51d-4db8-9f04-4189815864dd.json +0 -24
  152. package/dist/fixtures/remote.domain/users/bob.json +0 -20
  153. package/dist/fixtures/server.example/users/alice.json +0 -20
  154. package/dist/fixtures/w3id.org/identity/v1.json +0 -152
  155. package/dist/fixtures/w3id.org/security/data-integrity/v1.json +0 -74
  156. package/dist/fixtures/w3id.org/security/multikey/v1.json +0 -35
  157. package/dist/fixtures/w3id.org/security/v1.json +0 -50
  158. package/dist/fixtures/wizard.casa/users/hongminhee.json +0 -69
  159. package/dist/fixtures/www.w3.org/ns/activitystreams.json +0 -379
  160. package/dist/fixtures/www.w3.org/ns/did/v1.json +0 -58
  161. package/dist/key-B9Z5ZuX9.js +0 -10
  162. package/dist/key-Cc0JlcKe.js +0 -260
  163. package/dist/key-CgwCzDC4.js +0 -10
  164. package/dist/key-D-7DPHNl.cjs +0 -10
  165. package/dist/key-HqzOCwDc.cjs +0 -290
  166. package/dist/lookup-CiU3QxQz.js +0 -322
  167. package/dist/lookup-NuT9cCSl.js +0 -131
  168. package/dist/lookup-QHjmy4Og.cjs +0 -137
  169. package/dist/middleware-BHboQ4BE.js +0 -25
  170. package/dist/middleware-Bp3I9z8r.js +0 -17
  171. package/dist/middleware-oYqSU5ky.cjs +0 -17
  172. package/dist/mod-Cxt4Kpf6.d.ts +0 -291
  173. package/dist/mod-DBzN0aCM.d.ts +0 -115
  174. package/dist/mod-Dc_-mf8s.d.cts +0 -102
  175. package/dist/mod-FZd39qVq.d.cts +0 -1
  176. package/dist/mod-TFoH2Ql8.d.ts +0 -104
  177. package/dist/mod-evzlRVZq.d.cts +0 -289
  178. package/dist/mod-g0xFzAP9.d.ts +0 -2
  179. package/dist/mod-jQ4OODsl.d.cts +0 -113
  180. package/dist/mq-B7R1Q-M5.d.cts +0 -140
  181. package/dist/mq-CRGm1e_F.d.ts +0 -143
  182. package/dist/runtime/docloader.test.js +0 -522
  183. package/dist/runtime/key.test.js +0 -103
  184. package/dist/runtime/langstr.test.js +0 -39
  185. package/dist/runtime/link.test.js +0 -61
  186. package/dist/runtime/mod.cjs +0 -25
  187. package/dist/runtime/mod.d.cts +0 -6
  188. package/dist/runtime/mod.d.ts +0 -8
  189. package/dist/runtime/mod.js +0 -13
  190. package/dist/runtime/multibase/multibase.test.d.ts +0 -3
  191. package/dist/runtime/multibase/multibase.test.js +0 -358
  192. package/dist/runtime/url.test.d.ts +0 -3
  193. package/dist/runtime/url.test.js +0 -45
  194. package/dist/src/vocab/accept.yaml +0 -15
  195. package/dist/src/vocab/activity.yaml +0 -98
  196. package/dist/src/vocab/add.yaml +0 -16
  197. package/dist/src/vocab/announce.yaml +0 -30
  198. package/dist/src/vocab/application.yaml +0 -324
  199. package/dist/src/vocab/arrive.yaml +0 -15
  200. package/dist/src/vocab/article.yaml +0 -46
  201. package/dist/src/vocab/audio.yaml +0 -11
  202. package/dist/src/vocab/block.yaml +0 -16
  203. package/dist/src/vocab/chatmessage.yaml +0 -50
  204. package/dist/src/vocab/collection.yaml +0 -154
  205. package/dist/src/vocab/collectionpage.yaml +0 -55
  206. package/dist/src/vocab/create.yaml +0 -28
  207. package/dist/src/vocab/dataintegrityproof.yaml +0 -56
  208. package/dist/src/vocab/delete.yaml +0 -27
  209. package/dist/src/vocab/didservice.yaml +0 -22
  210. package/dist/src/vocab/dislike.yaml +0 -14
  211. package/dist/src/vocab/document.yaml +0 -31
  212. package/dist/src/vocab/emoji.yaml +0 -12
  213. package/dist/src/vocab/emojireact.yaml +0 -17
  214. package/dist/src/vocab/endpoints.yaml +0 -85
  215. package/dist/src/vocab/event.yaml +0 -11
  216. package/dist/src/vocab/export.yaml +0 -9
  217. package/dist/src/vocab/flag.yaml +0 -15
  218. package/dist/src/vocab/follow.yaml +0 -19
  219. package/dist/src/vocab/group.yaml +0 -324
  220. package/dist/src/vocab/hashtag.yaml +0 -14
  221. package/dist/src/vocab/ignore.yaml +0 -14
  222. package/dist/src/vocab/image.yaml +0 -9
  223. package/dist/src/vocab/intransitiveactivity.yaml +0 -15
  224. package/dist/src/vocab/invite.yaml +0 -14
  225. package/dist/src/vocab/join.yaml +0 -14
  226. package/dist/src/vocab/key.yaml +0 -28
  227. package/dist/src/vocab/leave.yaml +0 -14
  228. package/dist/src/vocab/like.yaml +0 -16
  229. package/dist/src/vocab/link.yaml +0 -101
  230. package/dist/src/vocab/listen.yaml +0 -12
  231. package/dist/src/vocab/mention.yaml +0 -9
  232. package/dist/src/vocab/move.yaml +0 -15
  233. package/dist/src/vocab/multikey.yaml +0 -36
  234. package/dist/src/vocab/note.yaml +0 -48
  235. package/dist/src/vocab/object.yaml +0 -404
  236. package/dist/src/vocab/offer.yaml +0 -15
  237. package/dist/src/vocab/orderedcollection.yaml +0 -39
  238. package/dist/src/vocab/orderedcollectionpage.yaml +0 -50
  239. package/dist/src/vocab/organization.yaml +0 -324
  240. package/dist/src/vocab/page.yaml +0 -11
  241. package/dist/src/vocab/person.yaml +0 -324
  242. package/dist/src/vocab/place.yaml +0 -75
  243. package/dist/src/vocab/profile.yaml +0 -26
  244. package/dist/src/vocab/propertyvalue.yaml +0 -32
  245. package/dist/src/vocab/question.yaml +0 -103
  246. package/dist/src/vocab/read.yaml +0 -13
  247. package/dist/src/vocab/reject.yaml +0 -14
  248. package/dist/src/vocab/relationship.yaml +0 -52
  249. package/dist/src/vocab/remove.yaml +0 -14
  250. package/dist/src/vocab/service.yaml +0 -324
  251. package/dist/src/vocab/source.yaml +0 -26
  252. package/dist/src/vocab/tentativeaccept.yaml +0 -14
  253. package/dist/src/vocab/tentativereject.yaml +0 -14
  254. package/dist/src/vocab/tombstone.yaml +0 -24
  255. package/dist/src/vocab/travel.yaml +0 -16
  256. package/dist/src/vocab/undo.yaml +0 -26
  257. package/dist/src/vocab/update.yaml +0 -58
  258. package/dist/src/vocab/video.yaml +0 -11
  259. package/dist/src/vocab/view.yaml +0 -13
  260. package/dist/testing/docloader.test.js +0 -24
  261. package/dist/type-B4NJkfVg.js +0 -42187
  262. package/dist/vocab/actor.test.d.ts +0 -3
  263. package/dist/vocab/actor.test.js +0 -5965
  264. package/dist/vocab/lookup.test.d.ts +0 -3
  265. package/dist/vocab/lookup.test.js +0 -206
  266. package/dist/vocab/mod.cjs +0 -87
  267. package/dist/vocab/mod.d.cts +0 -6
  268. package/dist/vocab/mod.d.ts +0 -8
  269. package/dist/vocab/mod.js +0 -10
  270. package/dist/vocab/schema.yaml +0 -247
  271. package/dist/vocab/type.test.d.ts +0 -3
  272. package/dist/vocab/type.test.js +0 -25
  273. package/dist/vocab/vocab.test.d.ts +0 -3
  274. package/dist/vocab/vocab.test.js +0 -3398
  275. package/dist/vocab-B0-5a8pw.cjs +0 -282
  276. package/dist/vocab-DJTYMqyU.d.cts +0 -14632
  277. package/dist/vocab-SOE1ifCr.d.ts +0 -14634
  278. package/dist/vocab-lBFcVxVF.js +0 -246
  279. package/dist/webfinger/handler.test.d.ts +0 -3
  280. package/dist/webfinger/lookup.test.d.ts +0 -3
  281. package/dist/webfinger/lookup.test.js +0 -195
  282. package/dist/webfinger/mod.cjs +0 -9
  283. package/dist/webfinger/mod.d.cts +0 -4
  284. package/dist/webfinger/mod.d.ts +0 -6
  285. package/dist/webfinger/mod.js +0 -9
  286. package/dist/webfinger-BjOEdFPs.cjs +0 -4
  287. package/dist/webfinger-De_bU0iE.js +0 -4
  288. package/dist/x/cfworkers.cjs +0 -100
  289. package/dist/x/cfworkers.d.cts +0 -59
  290. package/dist/x/cfworkers.d.ts +0 -61
  291. package/dist/x/cfworkers.js +0 -98
  292. package/dist/x/cfworkers.test.d.ts +0 -3
  293. package/dist/x/cfworkers.test.js +0 -179
  294. package/dist/x/hono.cjs +0 -61
  295. package/dist/x/hono.d.cts +0 -54
  296. package/dist/x/hono.d.ts +0 -56
  297. package/dist/x/hono.js +0 -60
  298. package/dist/x/sveltekit.cjs +0 -69
  299. package/dist/x/sveltekit.d.cts +0 -46
  300. package/dist/x/sveltekit.d.ts +0 -48
  301. package/dist/x/sveltekit.js +0 -68
  302. /package/dist/{runtime/authdocloader.test.d.ts → federation/idempotency.test.d.ts} +0 -0
  303. /package/dist/{runtime/docloader.test.d.ts → federation/negotiation.test.d.ts} +0 -0
  304. /package/dist/{runtime/key.test.d.ts → federation/webfinger.test.d.ts} +0 -0
  305. /package/dist/{mod-1pDWKvUL.d.ts → mod-1E3W847c.d.ts} +0 -0
  306. /package/dist/{mod-C2tOeRkN.d.cts → mod-C81L6_lQ.d.cts} +0 -0
  307. /package/dist/{nodeinfo-DfycQ8Wf.js → nodeinfo-BlLsRSiT.js} +0 -0
  308. /package/dist/{nodeinfo-Co9lJrWl.cjs → nodeinfo-DuMYTpbZ.cjs} +0 -0
  309. /package/dist/{runtime/langstr.test.d.ts → otel/exporter.test.d.ts} +0 -0
  310. /package/dist/{retry-CfF8Gn4d.js → retry-D4GJ670a.js} +0 -0
  311. /package/dist/{runtime-DPYEDf-o.js → sig-CwuONEzF.js} +0 -0
  312. /package/dist/{runtime-C58AJWSv.cjs → sig-DeXX2xnj.cjs} +0 -0
  313. /package/dist/{testing → utils}/docloader.test.d.ts +0 -0
  314. /package/dist/{runtime/link.test.d.ts → utils/kv-cache.test.d.ts} +0 -0
  315. /package/dist/{sig-ByHXzqUi.cjs → utils-Db0ZmjcD.cjs} +0 -0
  316. /package/dist/{sig-Cj3tk-ig.js → utils-Wranxuoe.js} +0 -0
@@ -1,246 +0,0 @@
1
-
2
- import { Temporal } from "@js-temporal/polyfill";
3
- import { URLPattern } from "urlpattern-polyfill";
4
-
5
- import { deno_default, getDocumentLoader } from "./docloader-BtqIh1OE.js";
6
- import { Object as Object$1, getTypeId } from "./actor-DU511yTk.js";
7
- import { lookupWebFinger } from "./lookup-NuT9cCSl.js";
8
- import { getLogger } from "@logtape/logtape";
9
- import { SpanStatusCode, trace } from "@opentelemetry/api";
10
- import { delay } from "es-toolkit";
11
-
12
- //#region src/vocab/handle.ts
13
- /**
14
- * Regular expression to match a fediverse handle in the format `@user@server`
15
- * or `user@server`. The `user` part can contain alphanumeric characters and
16
- * some special characters except `@`. The `server` part is all characters
17
- * after the `@` symbol in the middle.
18
- */
19
- const handleRegexp = /^@?((?:[-A-Za-z0-9._~!$&'()*+,;=]|%[A-Fa-f0-9]{2})+)@([^@]+)$/;
20
- /**
21
- * Parses a fediverse handle in the format `@user@server` or `user@server`.
22
- * The `user` part can contain alphanumeric characters and some special
23
- * characters except `@`. The `server` part is all characters after the `@`
24
- * symbol in the middle.
25
- *
26
- * @example
27
- * ```typescript
28
- * const handle = parseFediverseHandle("@username@example.com");
29
- * console.log(handle?.username); // "username"
30
- * console.log(handle?.host); // "example.com"
31
- * ```
32
- *
33
- * @param handle - The fediverse handle string to parse.
34
- * @returns A {@link FediverseHandle} object with `username` and `host`
35
- * if the input is valid; otherwise `null`.
36
- * @since 1.8.0
37
- */
38
- function parseFediverseHandle(handle) {
39
- const match = handleRegexp.exec(handle);
40
- if (match) return {
41
- username: match[1],
42
- host: match[2]
43
- };
44
- return null;
45
- }
46
- /**
47
- * Checks if a string is a valid fediverse handle in the format `@user@server`
48
- * or `user@server`. The `user` part can contain alphanumeric characters and
49
- * some special characters except `@`. The `server` part is all characters
50
- * after the `@` symbol in the middle.
51
- *
52
- * @example
53
- * ```typescript
54
- * console.log(isFediverseHandle("@username@example.com")); // true
55
- * console.log(isFediverseHandle("username@example.com")); // true
56
- * console.log(isFediverseHandle("@username@")); // false
57
- * ```
58
- *
59
- * @param handle - The string to test as a fediverse handle.
60
- * @returns `true` if the string matches the fediverse handle pattern;
61
- * otherwise `false`.
62
- * @since 1.8.0
63
- */
64
- function isFediverseHandle(handle) {
65
- return handleRegexp.test(handle);
66
- }
67
- /**
68
- * Converts a fediverse handle in the format `@user@server` or `user@server`
69
- * to an `acct:` URI, which is a URL-like identifier for ActivityPub actors.
70
- *
71
- * @example
72
- * ```typescript
73
- * const identifier = toAcctUrl("@username@example.com");
74
- * console.log(identifier?.href); // "acct:username@example.com"
75
- * ```
76
- *
77
- * @param handle - The fediverse handle string to convert.
78
- * @returns A `URL` object representing the `acct:` URI if conversion succeeds;
79
- * otherwise `null`.
80
- * @since 1.8.0
81
- */
82
- function toAcctUrl(handle) {
83
- const parsed = parseFediverseHandle(handle);
84
- if (!parsed) return null;
85
- const identifier = new URL(`acct:${parsed.username}@${parsed.host}`);
86
- return identifier;
87
- }
88
-
89
- //#endregion
90
- //#region src/vocab/lookup.ts
91
- const logger = getLogger([
92
- "fedify",
93
- "vocab",
94
- "lookup"
95
- ]);
96
- /**
97
- * Looks up an ActivityStreams object by its URI (including `acct:` URIs)
98
- * or a fediverse handle (e.g., `@user@server` or `user@server`).
99
- *
100
- * @example
101
- * ``` typescript
102
- * // Look up an actor by its fediverse handle:
103
- * await lookupObject("@hongminhee@fosstodon.org");
104
- * // returning a `Person` object.
105
- *
106
- * // A fediverse handle can omit the leading '@':
107
- * await lookupObject("hongminhee@fosstodon.org");
108
- * // returning a `Person` object.
109
- *
110
- * // A `acct:` URI can be used as well:
111
- * await lookupObject("acct:hongminhee@fosstodon.org");
112
- * // returning a `Person` object.
113
- *
114
- * // Look up an object by its URI:
115
- * await lookupObject("https://todon.eu/@hongminhee/112060633798771581");
116
- * // returning a `Note` object.
117
- *
118
- * // It can be a `URL` object as well:
119
- * await lookupObject(new URL("https://todon.eu/@hongminhee/112060633798771581"));
120
- * // returning a `Note` object.
121
- * ```
122
- *
123
- * @param identifier The URI or fediverse handle to look up.
124
- * @param options Lookup options.
125
- * @returns The object, or `null` if not found.
126
- * @since 0.2.0
127
- */
128
- async function lookupObject(identifier, options = {}) {
129
- const tracerProvider = options.tracerProvider ?? trace.getTracerProvider();
130
- const tracer = tracerProvider.getTracer(deno_default.name, deno_default.version);
131
- return await tracer.startActiveSpan("activitypub.lookup_object", async (span) => {
132
- try {
133
- const result = await lookupObjectInternal(identifier, options);
134
- if (result == null) span.setStatus({ code: SpanStatusCode.ERROR });
135
- else {
136
- if (result.id != null) span.setAttribute("activitypub.object.id", result.id.href);
137
- span.setAttribute("activitypub.object.type", getTypeId(result).href);
138
- if (result.replyTargetIds.length > 0) span.setAttribute("activitypub.object.in_reply_to", result.replyTargetIds.map((id) => id.href));
139
- }
140
- return result;
141
- } catch (error) {
142
- span.setStatus({
143
- code: SpanStatusCode.ERROR,
144
- message: String(error)
145
- });
146
- throw error;
147
- } finally {
148
- span.end();
149
- }
150
- });
151
- }
152
- async function lookupObjectInternal(identifier, options = {}) {
153
- const documentLoader = options.documentLoader ?? getDocumentLoader({ userAgent: options.userAgent });
154
- if (typeof identifier === "string") identifier = toAcctUrl(identifier) ?? new URL(identifier);
155
- let document = null;
156
- if (identifier.protocol === "http:" || identifier.protocol === "https:") try {
157
- const remoteDoc = await documentLoader(identifier.href, { signal: options.signal });
158
- document = remoteDoc.document;
159
- } catch (error) {
160
- logger.debug("Failed to fetch remote document:\n{error}", { error });
161
- }
162
- if (document == null) {
163
- const jrd = await lookupWebFinger(identifier, {
164
- userAgent: options.userAgent,
165
- tracerProvider: options.tracerProvider,
166
- allowPrivateAddress: "allowPrivateAddress" in options && options.allowPrivateAddress === true,
167
- signal: options.signal
168
- });
169
- if (jrd?.links == null) return null;
170
- for (const l of jrd.links) {
171
- if (l.type !== "application/activity+json" && !l.type?.match(/application\/ld\+json;\s*profile="https:\/\/www.w3.org\/ns\/activitystreams"/) || l.rel !== "self" || l.href == null) continue;
172
- try {
173
- const remoteDoc = await documentLoader(l.href, { signal: options.signal });
174
- document = remoteDoc.document;
175
- break;
176
- } catch (error) {
177
- logger.debug("Failed to fetch remote document:\n{error}", { error });
178
- continue;
179
- }
180
- }
181
- }
182
- if (document == null) return null;
183
- try {
184
- return await Object$1.fromJsonLd(document, {
185
- documentLoader,
186
- contextLoader: options.contextLoader,
187
- tracerProvider: options.tracerProvider
188
- });
189
- } catch (error) {
190
- if (error instanceof TypeError) {
191
- logger.debug("Failed to parse JSON-LD document: {error}\n{document}", {
192
- error,
193
- document
194
- });
195
- return null;
196
- }
197
- throw error;
198
- }
199
- }
200
- /**
201
- * Traverses a collection, yielding each item in the collection.
202
- * If the collection is paginated, it will fetch the next page
203
- * automatically.
204
- *
205
- * @example
206
- * ``` typescript
207
- * const collection = await lookupObject(collectionUrl);
208
- * if (collection instanceof Collection) {
209
- * for await (const item of traverseCollection(collection)) {
210
- * console.log(item.id?.href);
211
- * }
212
- * }
213
- * ```
214
- *
215
- * @param collection The collection to traverse.
216
- * @param options Options for traversing the collection.
217
- * @returns An async iterable of each item in the collection.
218
- * @since 1.1.0
219
- */
220
- async function* traverseCollection(collection, options = {}) {
221
- if (collection.firstId == null) for await (const item of collection.getItems(options)) yield item;
222
- else {
223
- const interval = Temporal.Duration.from(options.interval ?? { seconds: 0 }).total("millisecond");
224
- let page = await collection.getFirst(options);
225
- while (page != null) {
226
- for await (const item of page.getItems(options)) yield item;
227
- if (interval > 0) await delay(interval);
228
- page = await page.getNext(options);
229
- }
230
- }
231
- }
232
-
233
- //#endregion
234
- //#region src/vocab/constants.ts
235
- /**
236
- * The special public collection for [public addressing]. *Do not mutate this
237
- * object.*
238
- *
239
- * [public addressing]: https://www.w3.org/TR/activitypub/#public-addressing
240
- *
241
- * @since 0.7.0
242
- */
243
- const PUBLIC_COLLECTION = new URL("https://www.w3.org/ns/activitystreams#Public");
244
-
245
- //#endregion
246
- export { PUBLIC_COLLECTION, isFediverseHandle, lookupObject, parseFediverseHandle, toAcctUrl, traverseCollection };
@@ -1,3 +0,0 @@
1
- import { Temporal } from "@js-temporal/polyfill";
2
- import { URLPattern } from "urlpattern-polyfill";
3
- globalThis.addEventListener = () => {};
@@ -1,3 +0,0 @@
1
- import { Temporal } from "@js-temporal/polyfill";
2
- import { URLPattern } from "urlpattern-polyfill";
3
- globalThis.addEventListener = () => {};
@@ -1,195 +0,0 @@
1
-
2
- import { Temporal } from "@js-temporal/polyfill";
3
- import { URLPattern } from "urlpattern-polyfill";
4
- globalThis.addEventListener = () => {};
5
-
6
- import { lookupWebFinger } from "../type-B4NJkfVg.js";
7
- import { assertEquals } from "../assert_equals-DSbWqCm3.js";
8
- import "../assert-MZs1qjMx.js";
9
- import "../assert_instance_of-DHz7EHNU.js";
10
- import "../lookup-CiU3QxQz.js";
11
- import { test } from "../testing-ByQmUvf-.js";
12
- import "../std__assert-DWivtrGR.js";
13
- import "../assert_rejects-7UF4R_Qs.js";
14
- import "../assert_is_error-B035L3om.js";
15
- import "../assert_not_equals-C80BG-_5.js";
16
- import "../assert_throws-53_pKeP3.js";
17
- import { esm_default } from "../esm-mtx3XJAD.js";
18
- import { withTimeout } from "es-toolkit";
19
-
20
- //#region src/webfinger/lookup.test.ts
21
- test({
22
- name: "lookupWebFinger()",
23
- sanitizeOps: false,
24
- sanitizeResources: false,
25
- async fn(t) {
26
- await t.step("invalid resource", async () => {
27
- assertEquals(await lookupWebFinger("acct:johndoe"), null);
28
- assertEquals(await lookupWebFinger(new URL("acct:johndoe")), null);
29
- assertEquals(await lookupWebFinger("acct:johndoe@"), null);
30
- assertEquals(await lookupWebFinger(new URL("acct:johndoe@")), null);
31
- });
32
- await t.step("connection refused", async () => {
33
- assertEquals(await lookupWebFinger("acct:johndoe@fedify-test.internal"), null);
34
- assertEquals(await lookupWebFinger("https://fedify-test.internal/foo"), null);
35
- });
36
- esm_default.spyGlobal();
37
- esm_default.get("begin:https://example.com/.well-known/webfinger?", { status: 404 });
38
- await t.step("not found", async () => {
39
- assertEquals(await lookupWebFinger("acct:johndoe@example.com"), null);
40
- assertEquals(await lookupWebFinger("https://example.com/foo"), null);
41
- });
42
- const expected = {
43
- subject: "acct:johndoe@example.com",
44
- links: []
45
- };
46
- esm_default.removeRoutes();
47
- esm_default.get("https://example.com/.well-known/webfinger?resource=acct%3Ajohndoe%40example.com", { body: expected });
48
- await t.step("acct", async () => {
49
- assertEquals(await lookupWebFinger("acct:johndoe@example.com"), expected);
50
- });
51
- const expected2 = {
52
- subject: "https://example.com/foo",
53
- links: []
54
- };
55
- esm_default.removeRoutes();
56
- esm_default.get("https://example.com/.well-known/webfinger?resource=https%3A%2F%2Fexample.com%2Ffoo", { body: expected2 });
57
- await t.step("https", async () => {
58
- assertEquals(await lookupWebFinger("https://example.com/foo"), expected2);
59
- });
60
- esm_default.removeRoutes();
61
- esm_default.get("begin:https://example.com/.well-known/webfinger?", { body: "not json" });
62
- await t.step("invalid response", async () => {
63
- assertEquals(await lookupWebFinger("acct:johndoe@example.com"), null);
64
- });
65
- esm_default.removeRoutes();
66
- esm_default.get("begin:https://localhost/.well-known/webfinger?", {
67
- subject: "acct:test@localhost",
68
- links: [{
69
- rel: "self",
70
- type: "application/activity+json",
71
- href: "https://localhost/actor"
72
- }]
73
- });
74
- await t.step("private address", async () => {
75
- assertEquals(await lookupWebFinger("acct:test@localhost"), null);
76
- assertEquals(await lookupWebFinger("acct:test@localhost", { allowPrivateAddress: true }), {
77
- subject: "acct:test@localhost",
78
- links: [{
79
- rel: "self",
80
- type: "application/activity+json",
81
- href: "https://localhost/actor"
82
- }]
83
- });
84
- });
85
- esm_default.removeRoutes();
86
- esm_default.get("begin:https://example.com/.well-known/webfinger?", {
87
- status: 302,
88
- headers: { Location: "/.well-known/webfinger2" }
89
- });
90
- esm_default.get("begin:https://example.com/.well-known/webfinger2", { body: expected });
91
- await t.step("redirection", async () => {
92
- assertEquals(await lookupWebFinger("acct:johndoe@example.com"), expected);
93
- });
94
- esm_default.removeRoutes();
95
- esm_default.get("begin:https://example.com/.well-known/webfinger?", {
96
- status: 302,
97
- headers: { Location: "/.well-known/webfinger" }
98
- });
99
- await t.step("infinite redirection", async () => {
100
- const result = await withTimeout(() => lookupWebFinger("acct:johndoe@example.com"), 2e3);
101
- assertEquals(result, null);
102
- });
103
- esm_default.removeRoutes();
104
- esm_default.get("begin:https://example.com/.well-known/webfinger?", {
105
- status: 302,
106
- headers: { Location: "ftp://example.com/" }
107
- });
108
- await t.step("redirection to different protocol", async () => {
109
- assertEquals(await lookupWebFinger("acct:johndoe@example.com"), null);
110
- });
111
- esm_default.removeRoutes();
112
- esm_default.get("begin:https://example.com/.well-known/webfinger?", {
113
- status: 302,
114
- headers: { Location: "https://localhost/" }
115
- });
116
- await t.step("redirection to private address", async () => {
117
- assertEquals(await lookupWebFinger("acct:johndoe@example.com"), null);
118
- });
119
- esm_default.removeRoutes();
120
- let redirectCount = 0;
121
- esm_default.get("begin:https://example.com/.well-known/webfinger", () => {
122
- redirectCount++;
123
- if (redirectCount < 3) return {
124
- status: 302,
125
- headers: { Location: `/.well-known/webfinger?redirect=${redirectCount}` }
126
- };
127
- return { body: expected };
128
- });
129
- await t.step("custom maxRedirection", async () => {
130
- redirectCount = 0;
131
- assertEquals(await lookupWebFinger("acct:johndoe@example.com", { maxRedirection: 2 }), null);
132
- redirectCount = 0;
133
- assertEquals(await lookupWebFinger("acct:johndoe@example.com", { maxRedirection: 3 }), expected);
134
- redirectCount = 0;
135
- assertEquals(await lookupWebFinger("acct:johndoe@example.com"), expected);
136
- });
137
- esm_default.removeRoutes();
138
- esm_default.get("begin:https://example.com/.well-known/webfinger?", () => new Promise((resolve) => {
139
- const timeoutId = setTimeout(() => {
140
- resolve({ body: expected });
141
- }, 1e3);
142
- return () => clearTimeout(timeoutId);
143
- }));
144
- await t.step("request cancellation", async () => {
145
- const controller = new AbortController();
146
- const promise = lookupWebFinger("acct:johndoe@example.com", { signal: controller.signal });
147
- controller.abort();
148
- assertEquals(await promise, null);
149
- });
150
- esm_default.removeRoutes();
151
- let redirectCount2 = 0;
152
- esm_default.get("begin:https://example.com/.well-known/webfinger", () => {
153
- redirectCount2++;
154
- if (redirectCount2 === 1) return {
155
- status: 302,
156
- headers: { Location: "/.well-known/webfinger2" }
157
- };
158
- return new Promise((resolve) => {
159
- const timeoutId = setTimeout(() => {
160
- resolve({ body: expected });
161
- }, 1e3);
162
- return () => clearTimeout(timeoutId);
163
- });
164
- });
165
- await t.step("cancellation during redirection", async () => {
166
- const controller = new AbortController();
167
- const promise = lookupWebFinger("acct:johndoe@example.com", { signal: controller.signal });
168
- setTimeout(() => controller.abort(), 100);
169
- assertEquals(await promise, null);
170
- });
171
- esm_default.removeRoutes();
172
- esm_default.get("begin:https://example.com/.well-known/webfinger?", () => new Promise((resolve) => {
173
- const timeoutId = setTimeout(() => {
174
- resolve({ body: expected });
175
- }, 500);
176
- return () => clearTimeout(timeoutId);
177
- }));
178
- await t.step("cancellation with immediate abort", async () => {
179
- const controller = new AbortController();
180
- controller.abort();
181
- const result = await lookupWebFinger("acct:johndoe@example.com", { signal: controller.signal });
182
- assertEquals(result, null);
183
- });
184
- esm_default.removeRoutes();
185
- esm_default.get("begin:https://example.com/.well-known/webfinger?", { body: expected });
186
- await t.step("successful request with signal", async () => {
187
- const controller = new AbortController();
188
- const result = await lookupWebFinger("acct:johndoe@example.com", { signal: controller.signal });
189
- assertEquals(result, expected);
190
- });
191
- esm_default.hardReset();
192
- }
193
- });
194
-
195
- //#endregion
@@ -1,9 +0,0 @@
1
-
2
- const { Temporal } = require("@js-temporal/polyfill");
3
- const { URLPattern } = require("urlpattern-polyfill");
4
-
5
- require('../docloader-kae6M-GI.cjs');
6
- const require_lookup = require('../lookup-QHjmy4Og.cjs');
7
- require('../webfinger-BjOEdFPs.cjs');
8
-
9
- exports.lookupWebFinger = require_lookup.lookupWebFinger;
@@ -1,4 +0,0 @@
1
- import "../kv-63Cil1MD.cjs";
2
- import "../docloader-D-MrRyHl.cjs";
3
- import { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger } from "../mod-jQ4OODsl.cjs";
4
- export { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger };
@@ -1,6 +0,0 @@
1
- import { Temporal } from "@js-temporal/polyfill";
2
- import { URLPattern } from "urlpattern-polyfill";
3
- import "../kv-C7sopW2E.js";
4
- import "../docloader-CxWcuWqQ.js";
5
- import { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger } from "../mod-DBzN0aCM.js";
6
- export { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger };
@@ -1,9 +0,0 @@
1
-
2
- import { Temporal } from "@js-temporal/polyfill";
3
- import { URLPattern } from "urlpattern-polyfill";
4
-
5
- import "../docloader-BtqIh1OE.js";
6
- import { lookupWebFinger } from "../lookup-NuT9cCSl.js";
7
- import "../webfinger-De_bU0iE.js";
8
-
9
- export { lookupWebFinger };
@@ -1,4 +0,0 @@
1
-
2
- const { Temporal } = require("@js-temporal/polyfill");
3
- const { URLPattern } = require("urlpattern-polyfill");
4
-
@@ -1,4 +0,0 @@
1
-
2
- import { Temporal } from "@js-temporal/polyfill";
3
- import { URLPattern } from "urlpattern-polyfill";
4
-
@@ -1,100 +0,0 @@
1
-
2
- const { Temporal } = require("@js-temporal/polyfill");
3
- const { URLPattern } = require("urlpattern-polyfill");
4
-
5
- const require_chunk = require('../chunk-DqRYRqnO.cjs');
6
- const __logtape_logtape = require_chunk.__toESM(require("@logtape/logtape"));
7
-
8
- //#region src/x/cfworkers.ts
9
- /**
10
- * Implementation of the {@link KvStore} interface for Cloudflare Workers KV
11
- * binding. This class provides a wrapper around Cloudflare's KV namespace to
12
- * store and retrieve JSON-serializable values using structured keys.
13
- *
14
- * Note that this implementation does not support the {@link KvStore.cas}
15
- * operation, as Cloudflare Workers KV does not support atomic compare-and-swap
16
- * operations. If you need this functionality, consider using a different
17
- * key–value store that supports atomic operations.
18
- *
19
- * @deprecated This class has been moved to `@fedify/cfworkers` package.
20
- * Import `WorkersKvStore` from `@fedify/cfworkers` instead.
21
- * This class will be removed in Fedify v2.0.
22
- * @since 1.6.0
23
- */
24
- var WorkersKvStore = class {
25
- #namespace;
26
- constructor(namespace) {
27
- const logger = (0, __logtape_logtape.getLogger)(["fedify", "cfworkers"]);
28
- logger.warn("The `@fedify/fedify/x/cfworkers` module is deprecated; use `WorkersKvStore` from `@fedify/cfworkers` package instead.");
29
- this.#namespace = namespace;
30
- }
31
- #encodeKey(key) {
32
- return JSON.stringify(key);
33
- }
34
- async get(key) {
35
- const encodedKey = this.#encodeKey(key);
36
- const { value, metadata } = await this.#namespace.getWithMetadata(encodedKey, "json");
37
- return metadata == null || metadata.expires < Date.now() ? void 0 : value;
38
- }
39
- async set(key, value, options) {
40
- const encodedKey = this.#encodeKey(key);
41
- const metadata = options?.ttl == null ? {} : { expires: Date.now() + options.ttl.total("milliseconds") };
42
- await this.#namespace.put(encodedKey, JSON.stringify(value), options?.ttl == null ? { metadata } : {
43
- expirationTtl: Math.max(options.ttl.total("seconds"), 60),
44
- metadata
45
- });
46
- }
47
- delete(key) {
48
- return this.#namespace.delete(this.#encodeKey(key));
49
- }
50
- };
51
- /**
52
- * Implementation of the {@link MessageQueue} interface for Cloudflare
53
- * Workers Queues binding. This class provides a wrapper around Cloudflare's
54
- * Queues to send messages to a queue.
55
- *
56
- * Note that this implementation does not support the `listen()` method,
57
- * as Cloudflare Workers Queues do not support message consumption in the same
58
- * way as other message queue systems. Instead, you should use
59
- * the {@link Federation.processQueuedTask} method to process messages
60
- * passed to the queue.
61
- *
62
- * @deprecated This class has been moved to `@fedify/cfworkers` package.
63
- * Import `WorkersMessageQueue` from `@fedify/cfworkers` instead.
64
- * This class will be removed in Fedify v2.0.
65
- * @since 1.6.0
66
- */
67
- var WorkersMessageQueue = class {
68
- #queue;
69
- /**
70
- * Cloudflare Queues provide automatic retry with exponential backoff
71
- * and Dead Letter Queues.
72
- * @since 1.7.0
73
- */
74
- nativeRetrial = true;
75
- constructor(queue) {
76
- const logger = (0, __logtape_logtape.getLogger)(["fedify", "cfworkers"]);
77
- logger.warn("The `@fedify/fedify/x/cfworkers` module is deprecated; use `WorkersMessageQueue` from `@fedify/cfworkers` package instead.");
78
- this.#queue = queue;
79
- }
80
- enqueue(message, options) {
81
- return this.#queue.send(message, {
82
- contentType: "json",
83
- delaySeconds: options?.delay?.total("seconds") ?? 0
84
- });
85
- }
86
- enqueueMany(messages, options) {
87
- const requests = messages.map((msg) => ({
88
- body: msg,
89
- contentType: "json"
90
- }));
91
- return this.#queue.sendBatch(requests, { delaySeconds: options?.delay?.total("seconds") ?? 0 });
92
- }
93
- listen(_handler, _options) {
94
- throw new TypeError("WorkersMessageQueue does not support listen(). Use Federation.processQueuedTask() method instead.");
95
- }
96
- };
97
-
98
- //#endregion
99
- exports.WorkersKvStore = WorkersKvStore;
100
- exports.WorkersMessageQueue = WorkersMessageQueue;
@@ -1,59 +0,0 @@
1
- import { KvKey, KvStore, KvStoreSetOptions } from "../kv-63Cil1MD.cjs";
2
- import { MessageQueue, MessageQueueEnqueueOptions, MessageQueueListenOptions } from "../mq-B7R1Q-M5.cjs";
3
- import { KVNamespace, Queue } from "@cloudflare/workers-types/experimental";
4
-
5
- //#region src/x/cfworkers.d.ts
6
-
7
- /**
8
- * Implementation of the {@link KvStore} interface for Cloudflare Workers KV
9
- * binding. This class provides a wrapper around Cloudflare's KV namespace to
10
- * store and retrieve JSON-serializable values using structured keys.
11
- *
12
- * Note that this implementation does not support the {@link KvStore.cas}
13
- * operation, as Cloudflare Workers KV does not support atomic compare-and-swap
14
- * operations. If you need this functionality, consider using a different
15
- * key–value store that supports atomic operations.
16
- *
17
- * @deprecated This class has been moved to `@fedify/cfworkers` package.
18
- * Import `WorkersKvStore` from `@fedify/cfworkers` instead.
19
- * This class will be removed in Fedify v2.0.
20
- * @since 1.6.0
21
- */
22
- declare class WorkersKvStore implements KvStore {
23
- #private;
24
- constructor(namespace: KVNamespace<string>);
25
- get<T = unknown>(key: KvKey): Promise<T | undefined>;
26
- set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
27
- delete(key: KvKey): Promise<void>;
28
- }
29
- /**
30
- * Implementation of the {@link MessageQueue} interface for Cloudflare
31
- * Workers Queues binding. This class provides a wrapper around Cloudflare's
32
- * Queues to send messages to a queue.
33
- *
34
- * Note that this implementation does not support the `listen()` method,
35
- * as Cloudflare Workers Queues do not support message consumption in the same
36
- * way as other message queue systems. Instead, you should use
37
- * the {@link Federation.processQueuedTask} method to process messages
38
- * passed to the queue.
39
- *
40
- * @deprecated This class has been moved to `@fedify/cfworkers` package.
41
- * Import `WorkersMessageQueue` from `@fedify/cfworkers` instead.
42
- * This class will be removed in Fedify v2.0.
43
- * @since 1.6.0
44
- */
45
- declare class WorkersMessageQueue implements MessageQueue {
46
- #private;
47
- /**
48
- * Cloudflare Queues provide automatic retry with exponential backoff
49
- * and Dead Letter Queues.
50
- * @since 1.7.0
51
- */
52
- readonly nativeRetrial = true;
53
- constructor(queue: Queue);
54
- enqueue(message: any, options?: MessageQueueEnqueueOptions): Promise<void>;
55
- enqueueMany(messages: any[], options?: MessageQueueEnqueueOptions): Promise<void>;
56
- listen(_handler: (message: any) => Promise<void> | void, _options?: MessageQueueListenOptions): Promise<void>;
57
- }
58
- //#endregion
59
- export { WorkersKvStore, WorkersMessageQueue };