@fedify/fedify 2.0.0-dev.1593 → 2.0.0-dev.160

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 (297) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +66 -30
  3. package/dist/{assert_rejects-DiIiJbZn.js → assert_rejects-Ce45JcFg.js} +1 -1
  4. package/dist/{assert_is_error-BPGph1Jx.js → assert_throws-BNXdRGWP.js} +31 -1
  5. package/dist/{builder-BgzJcrpt.js → builder-C9n2ExVv.js} +15 -8
  6. package/dist/chunk-DqRYRqnO.cjs +34 -0
  7. package/dist/client-94iWEfQa.d.cts +222 -0
  8. package/dist/{client-DF8anIB5.d.ts → client-BivSNrEg.d.ts} +3 -75
  9. package/dist/{client-CpxFv8ft.js → client-CgMTXmAD.js} +3 -22
  10. package/dist/compat/mod.cjs +10 -0
  11. package/dist/compat/mod.d.cts +7 -0
  12. package/dist/compat/mod.d.ts +6 -12
  13. package/dist/compat/mod.js +5 -5
  14. package/dist/compat/transformers.test.js +21 -20
  15. package/dist/compat-DmDDELst.cjs +4 -0
  16. package/dist/compat-nxUqe4Z-.js +4 -0
  17. package/dist/context-Bns6uTJq.js +109 -0
  18. package/dist/{context-9gCpIkiz.d.ts → context-CYZ2i00R.d.ts} +321 -129
  19. package/dist/context-D2MrtLch.d.cts +2447 -0
  20. package/dist/deno-B74l3pXN.js +117 -0
  21. package/dist/{testing-D4xRiVJV.js → dist-B5f6a8Tt.js} +90 -111
  22. package/dist/{authdocloader-DJtdyVPc.js → docloader-eucHnjj4.js} +17 -8
  23. package/dist/{esm-5nsZYnVB.js → esm-DGl7uK1r.js} +32 -17
  24. package/dist/federation/builder.test.js +12 -13
  25. package/dist/federation/collection.test.js +6 -9
  26. package/dist/federation/handler.test.js +115 -148
  27. package/dist/federation/idempotency.test.js +202 -0
  28. package/dist/federation/inbox.test.js +5 -6
  29. package/dist/federation/keycache.test.js +4 -5
  30. package/dist/federation/kv.test.js +61 -9
  31. package/dist/federation/middleware.test.js +311 -131
  32. package/dist/federation/mod.cjs +25 -0
  33. package/dist/federation/mod.d.cts +7 -0
  34. package/dist/federation/mod.d.ts +7 -13
  35. package/dist/federation/mod.js +11 -16
  36. package/dist/federation/mq.test.js +9 -10
  37. package/dist/federation/negotiation.test.js +25 -0
  38. package/dist/federation/retry.test.js +2 -4
  39. package/dist/federation/router.test.js +6 -8
  40. package/dist/federation/send.test.js +55 -15
  41. package/dist/{webfinger/handler.test.js → federation/webfinger.test.js} +27 -26
  42. package/dist/federation-B431K2gm.cjs +266 -0
  43. package/dist/{federation-CMX7WzeL.js → federation-BbZwNNWj.js} +31 -9
  44. package/dist/http-ClB3pLcL.d.cts +253 -0
  45. package/dist/{http-CQulyTuw.js → http-CrnYJYhM.js} +3 -2
  46. package/dist/{http-BqklewFY.js → http-DJ7KWfiN.js} +374 -14
  47. package/dist/{http-DqSNLFNY.d.ts → http-DLBDPal9.d.ts} +2 -2
  48. package/dist/http-DtRqZZgP.cjs +1222 -0
  49. package/dist/{inbox-B97Wrppe.js → inbox-6-2rtCJf.js} +25 -7
  50. package/dist/{key-D-s3dQbK.js → key-pYEsD-IB.js} +3 -2
  51. package/dist/{keycache-Br0-hsD5.js → keycache-DRxpZ5r9.js} +1 -1
  52. package/dist/{keys-DSk2aqlj.js → keys-ZbcByPg9.js} +2 -1
  53. package/dist/{kv-C7sopW2E.d.ts → kv-CtOmTRNc.d.ts} +30 -1
  54. package/dist/kv-D8q9fLkA.d.cts +110 -0
  55. package/dist/{kv-CRZrzyXm.js → kv-QzKcOQgP.js} +22 -0
  56. package/dist/kv-cache-BEeqyGER.js +107 -0
  57. package/dist/kv-cache-Cr66Hw1w.js +122 -0
  58. package/dist/kv-cache-jKJ4ZH0U.cjs +134 -0
  59. package/dist/{ld-CYUQO1l4.js → ld-Bmrvt1KE.js} +4 -2
  60. package/dist/middleware-BUywt3CE.cjs +4242 -0
  61. package/dist/middleware-Ba1Pxx8r.js +26 -0
  62. package/dist/{middleware-tfSiCl9w.js → middleware-ByNAm2-S.js} +272 -271
  63. package/dist/middleware-D6QDOyQU.cjs +12 -0
  64. package/dist/{middleware-CovCqg8w.js → middleware-D9L8QWDP.js} +230 -327
  65. package/dist/middleware-jJYYmbt6.js +12 -0
  66. package/dist/mod-BrS8tiad.d.cts +266 -0
  67. package/dist/mod-C81L6_lQ.d.cts +1 -0
  68. package/dist/mod-CJgbdSqb.d.ts +109 -0
  69. package/dist/mod-CNNTHyBC.d.cts +80 -0
  70. package/dist/mod-CS-MS7gZ.d.cts +62 -0
  71. package/dist/{mod-Bqxcp7eN.d.ts → mod-D_cmv2il.d.ts} +4 -4
  72. package/dist/mod-DcPRcifg.d.cts +107 -0
  73. package/dist/mod-DqFSzJA0.d.ts +64 -0
  74. package/dist/{mod-Drmz72EK.d.ts → mod-jOa7W503.d.ts} +3 -3
  75. package/dist/mod.cjs +55 -0
  76. package/dist/mod.d.cts +11 -0
  77. package/dist/mod.d.ts +11 -17
  78. package/dist/mod.js +15 -21
  79. package/dist/negotiation-5NPJL6zp.js +71 -0
  80. package/dist/nodeinfo/client.test.js +29 -111
  81. package/dist/nodeinfo/handler.test.js +26 -26
  82. package/dist/nodeinfo/mod.cjs +10 -0
  83. package/dist/nodeinfo/mod.d.cts +3 -0
  84. package/dist/nodeinfo/mod.d.ts +3 -5
  85. package/dist/nodeinfo/mod.js +6 -7
  86. package/dist/nodeinfo/types.test.js +7 -15
  87. package/dist/nodeinfo-BlLsRSiT.js +4 -0
  88. package/dist/nodeinfo-DuMYTpbZ.cjs +4 -0
  89. package/dist/otel/exporter.test.js +899 -0
  90. package/dist/otel/mod.cjs +262 -0
  91. package/dist/otel/mod.d.cts +230 -0
  92. package/dist/otel/mod.d.ts +232 -0
  93. package/dist/otel/mod.js +261 -0
  94. package/dist/{owner-CQPnQVtf.d.ts → owner-BgI8C-VY.d.ts} +2 -3
  95. package/dist/owner-C-zfmVAD.d.cts +66 -0
  96. package/dist/{owner-CBeUJR68.js → owner-vFiFLWHR.js} +45 -8
  97. package/dist/{proof-CHQnDg0z.js → proof-C-k7brtD.js} +3 -2
  98. package/dist/proof-CLwK-TXL.cjs +709 -0
  99. package/dist/{proof-D436ezTT.js → proof-Dp6V6HEi.js} +50 -14
  100. package/dist/router-D9eI0s4b.js +118 -0
  101. package/dist/{send-Bc0QdRlp.js → send-BVXXc0Cn.js} +9 -4
  102. package/dist/sig/http.test.js +11 -13
  103. package/dist/sig/key.test.js +9 -11
  104. package/dist/sig/ld.test.js +8 -10
  105. package/dist/sig/mod.cjs +26 -0
  106. package/dist/sig/mod.d.cts +4 -0
  107. package/dist/sig/mod.d.ts +3 -7
  108. package/dist/sig/mod.js +6 -10
  109. package/dist/sig/owner.test.js +33 -12
  110. package/dist/sig/proof.test.js +13 -14
  111. package/dist/sig-CwuONEzF.js +4 -0
  112. package/dist/sig-DeXX2xnj.cjs +4 -0
  113. package/dist/testing/mod.d.ts +180 -6946
  114. package/dist/testing/mod.js +4 -4
  115. package/dist/transformers-BjBg6Lag.cjs +116 -0
  116. package/dist/{transformers-Dna8Fg7k.js → transformers-N_ip_y4P.js} +5 -5
  117. package/dist/{types-BIgY6c-l.js → types-BEdCLHqP.js} +1 -3
  118. package/dist/types-Q-qkJXBV.cjs +315 -0
  119. package/dist/{types-RbpvCErq.js → types-hKTi53FO.js} +8 -169
  120. package/dist/{runtime/authdocloader.test.js → utils/docloader.test.js} +13 -15
  121. package/dist/utils/kv-cache.test.js +211 -0
  122. package/dist/utils/mod.cjs +10 -0
  123. package/dist/utils/mod.d.cts +4 -0
  124. package/dist/utils/mod.d.ts +6 -0
  125. package/dist/utils/mod.js +9 -0
  126. package/dist/utils-Db0ZmjcD.cjs +4 -0
  127. package/dist/utils-Wranxuoe.js +4 -0
  128. package/package.json +69 -55
  129. package/dist/actor-Bj1Vq2XG.js +0 -146
  130. package/dist/actor-C22bXuuC.d.ts +0 -130
  131. package/dist/actor-DNwcqwPT.js +0 -37312
  132. package/dist/assert_throws-BOO88avQ.js +0 -39
  133. package/dist/authdocloader-qkvj_KZY.js +0 -52
  134. package/dist/compat-Bb5myD13.js +0 -4
  135. package/dist/denokv-Bv33Xxea.js +0 -57
  136. package/dist/docloader-9_osWaaH.js +0 -4615
  137. package/dist/docloader-CxWcuWqQ.d.ts +0 -221
  138. package/dist/fixtures/activitypub.academy/users/brauca_darradiul.json +0 -83
  139. package/dist/fixtures/example.com/announce.json +0 -6
  140. package/dist/fixtures/example.com/collection.json +0 -19
  141. package/dist/fixtures/example.com/create.json +0 -6
  142. package/dist/fixtures/example.com/cross-origin-actor.json +0 -6
  143. package/dist/fixtures/example.com/hong-gildong.json +0 -11
  144. package/dist/fixtures/example.com/invite.json +0 -7
  145. package/dist/fixtures/example.com/key.json +0 -7
  146. package/dist/fixtures/example.com/key2.json +0 -6
  147. package/dist/fixtures/example.com/object.json +0 -6
  148. package/dist/fixtures/example.com/orderedcollectionpage.json +0 -24
  149. package/dist/fixtures/example.com/paged/a.json +0 -13
  150. package/dist/fixtures/example.com/paged/b.json +0 -16
  151. package/dist/fixtures/example.com/paged-collection.json +0 -6
  152. package/dist/fixtures/example.com/person.json +0 -22
  153. package/dist/fixtures/example.com/person2.json +0 -40
  154. package/dist/fixtures/example.com/test.json +0 -5
  155. package/dist/fixtures/example.com/users/handle.json +0 -16
  156. package/dist/fixtures/example.com/wrong-type.json +0 -3
  157. package/dist/fixtures/oeee.cafe/ap/users/3609fd4e-d51d-4db8-9f04-4189815864dd.json +0 -24
  158. package/dist/fixtures/remote.domain/users/bob.json +0 -20
  159. package/dist/fixtures/server.example/users/alice.json +0 -20
  160. package/dist/fixtures/w3id.org/identity/v1.json +0 -152
  161. package/dist/fixtures/w3id.org/security/data-integrity/v1.json +0 -74
  162. package/dist/fixtures/w3id.org/security/multikey/v1.json +0 -35
  163. package/dist/fixtures/w3id.org/security/v1.json +0 -50
  164. package/dist/fixtures/wizard.casa/users/hongminhee.json +0 -69
  165. package/dist/fixtures/www.w3.org/ns/activitystreams.json +0 -379
  166. package/dist/fixtures/www.w3.org/ns/did/v1.json +0 -58
  167. package/dist/key-3jGPh5To.js +0 -10
  168. package/dist/key-C3CEOTh7.js +0 -10
  169. package/dist/key-CNCeen0u.js +0 -260
  170. package/dist/lookup-BNFlahf3.js +0 -131
  171. package/dist/lookup-CnJK1NUl.js +0 -322
  172. package/dist/middleware-CJbNYdw9.js +0 -17
  173. package/dist/middleware-zDdNBo-m.js +0 -26
  174. package/dist/mod-Cxt4Kpf6.d.ts +0 -291
  175. package/dist/mod-DBzN0aCM.d.ts +0 -115
  176. package/dist/mod-TFoH2Ql8.d.ts +0 -104
  177. package/dist/mod-g0xFzAP9.d.ts +0 -2
  178. package/dist/mq-CRGm1e_F.d.ts +0 -143
  179. package/dist/nodeinfo/semver.test.js +0 -143
  180. package/dist/nodeinfo-CyEbLjHs.js +0 -4
  181. package/dist/runtime/docloader.test.js +0 -522
  182. package/dist/runtime/key.test.js +0 -103
  183. package/dist/runtime/langstr.test.js +0 -39
  184. package/dist/runtime/mod.d.ts +0 -8
  185. package/dist/runtime/mod.js +0 -13
  186. package/dist/runtime/multibase/multibase.test.d.ts +0 -3
  187. package/dist/runtime/multibase/multibase.test.js +0 -358
  188. package/dist/runtime/url.test.d.ts +0 -3
  189. package/dist/runtime/url.test.js +0 -45
  190. package/dist/runtime-BSkOVUWM.js +0 -4
  191. package/dist/semver-dArNLkR9.js +0 -149
  192. package/dist/sig-BXJO--F9.js +0 -4
  193. package/dist/src/vocab/accept.yaml +0 -15
  194. package/dist/src/vocab/activity.yaml +0 -98
  195. package/dist/src/vocab/add.yaml +0 -16
  196. package/dist/src/vocab/announce.yaml +0 -30
  197. package/dist/src/vocab/application.yaml +0 -324
  198. package/dist/src/vocab/arrive.yaml +0 -15
  199. package/dist/src/vocab/article.yaml +0 -46
  200. package/dist/src/vocab/audio.yaml +0 -11
  201. package/dist/src/vocab/block.yaml +0 -16
  202. package/dist/src/vocab/chatmessage.yaml +0 -50
  203. package/dist/src/vocab/collection.yaml +0 -154
  204. package/dist/src/vocab/collectionpage.yaml +0 -55
  205. package/dist/src/vocab/create.yaml +0 -28
  206. package/dist/src/vocab/dataintegrityproof.yaml +0 -56
  207. package/dist/src/vocab/delete.yaml +0 -27
  208. package/dist/src/vocab/didservice.yaml +0 -22
  209. package/dist/src/vocab/dislike.yaml +0 -14
  210. package/dist/src/vocab/document.yaml +0 -31
  211. package/dist/src/vocab/emoji.yaml +0 -12
  212. package/dist/src/vocab/emojireact.yaml +0 -17
  213. package/dist/src/vocab/endpoints.yaml +0 -85
  214. package/dist/src/vocab/event.yaml +0 -11
  215. package/dist/src/vocab/export.yaml +0 -9
  216. package/dist/src/vocab/flag.yaml +0 -15
  217. package/dist/src/vocab/follow.yaml +0 -19
  218. package/dist/src/vocab/group.yaml +0 -324
  219. package/dist/src/vocab/hashtag.yaml +0 -14
  220. package/dist/src/vocab/ignore.yaml +0 -14
  221. package/dist/src/vocab/image.yaml +0 -9
  222. package/dist/src/vocab/intransitiveactivity.yaml +0 -15
  223. package/dist/src/vocab/invite.yaml +0 -14
  224. package/dist/src/vocab/join.yaml +0 -14
  225. package/dist/src/vocab/key.yaml +0 -28
  226. package/dist/src/vocab/leave.yaml +0 -14
  227. package/dist/src/vocab/like.yaml +0 -16
  228. package/dist/src/vocab/link.yaml +0 -101
  229. package/dist/src/vocab/listen.yaml +0 -12
  230. package/dist/src/vocab/mention.yaml +0 -9
  231. package/dist/src/vocab/move.yaml +0 -15
  232. package/dist/src/vocab/multikey.yaml +0 -36
  233. package/dist/src/vocab/note.yaml +0 -48
  234. package/dist/src/vocab/object.yaml +0 -404
  235. package/dist/src/vocab/offer.yaml +0 -15
  236. package/dist/src/vocab/orderedcollection.yaml +0 -39
  237. package/dist/src/vocab/orderedcollectionpage.yaml +0 -50
  238. package/dist/src/vocab/organization.yaml +0 -324
  239. package/dist/src/vocab/page.yaml +0 -11
  240. package/dist/src/vocab/person.yaml +0 -324
  241. package/dist/src/vocab/place.yaml +0 -75
  242. package/dist/src/vocab/profile.yaml +0 -26
  243. package/dist/src/vocab/propertyvalue.yaml +0 -32
  244. package/dist/src/vocab/question.yaml +0 -103
  245. package/dist/src/vocab/read.yaml +0 -13
  246. package/dist/src/vocab/reject.yaml +0 -14
  247. package/dist/src/vocab/relationship.yaml +0 -52
  248. package/dist/src/vocab/remove.yaml +0 -14
  249. package/dist/src/vocab/service.yaml +0 -324
  250. package/dist/src/vocab/source.yaml +0 -26
  251. package/dist/src/vocab/tentativeaccept.yaml +0 -14
  252. package/dist/src/vocab/tentativereject.yaml +0 -14
  253. package/dist/src/vocab/tombstone.yaml +0 -24
  254. package/dist/src/vocab/travel.yaml +0 -16
  255. package/dist/src/vocab/undo.yaml +0 -26
  256. package/dist/src/vocab/update.yaml +0 -58
  257. package/dist/src/vocab/video.yaml +0 -11
  258. package/dist/src/vocab/view.yaml +0 -13
  259. package/dist/testing/docloader.test.js +0 -24
  260. package/dist/type-qs0mWLTm.js +0 -42007
  261. package/dist/vocab/actor.test.d.ts +0 -3
  262. package/dist/vocab/actor.test.js +0 -5965
  263. package/dist/vocab/lookup.test.d.ts +0 -3
  264. package/dist/vocab/lookup.test.js +0 -206
  265. package/dist/vocab/mod.d.ts +0 -8
  266. package/dist/vocab/mod.js +0 -10
  267. package/dist/vocab/schema.yaml +0 -247
  268. package/dist/vocab/type.test.d.ts +0 -3
  269. package/dist/vocab/type.test.js +0 -25
  270. package/dist/vocab/vocab.test.d.ts +0 -3
  271. package/dist/vocab/vocab.test.js +0 -3363
  272. package/dist/vocab-SOE1ifCr.d.ts +0 -14634
  273. package/dist/vocab-r-I1_ZmK.js +0 -246
  274. package/dist/webfinger/handler.test.d.ts +0 -3
  275. package/dist/webfinger/lookup.test.d.ts +0 -3
  276. package/dist/webfinger/lookup.test.js +0 -195
  277. package/dist/webfinger/mod.d.ts +0 -6
  278. package/dist/webfinger/mod.js +0 -9
  279. package/dist/webfinger-C3GIyXIg.js +0 -4
  280. package/dist/x/cfworkers.d.ts +0 -61
  281. package/dist/x/cfworkers.js +0 -98
  282. package/dist/x/cfworkers.test.d.ts +0 -3
  283. package/dist/x/cfworkers.test.js +0 -179
  284. package/dist/x/hono.d.ts +0 -56
  285. package/dist/x/hono.js +0 -60
  286. package/dist/x/sveltekit.d.ts +0 -48
  287. package/dist/x/sveltekit.js +0 -68
  288. /package/dist/{assert_not_equals-f3m3epl3.js → assert_not_equals-C80BG-_5.js} +0 -0
  289. /package/dist/{collection-CSzG2j1P.js → collection-CcnIw1qY.js} +0 -0
  290. /package/dist/{nodeinfo/semver.test.d.ts → federation/idempotency.test.d.ts} +0 -0
  291. /package/dist/{runtime/authdocloader.test.d.ts → federation/negotiation.test.d.ts} +0 -0
  292. /package/dist/{runtime/docloader.test.d.ts → federation/webfinger.test.d.ts} +0 -0
  293. /package/dist/{mod-1pDWKvUL.d.ts → mod-1E3W847c.d.ts} +0 -0
  294. /package/dist/{runtime/key.test.d.ts → otel/exporter.test.d.ts} +0 -0
  295. /package/dist/{std__assert-X-_kMxKM.js → std__assert-DWivtrGR.js} +0 -0
  296. /package/dist/{testing → utils}/docloader.test.d.ts +0 -0
  297. /package/dist/{runtime/langstr.test.d.ts → utils/kv-cache.test.d.ts} +0 -0
@@ -3,8 +3,9 @@
3
3
  import { URLPattern } from "urlpattern-polyfill";
4
4
  globalThis.addEventListener = () => {};
5
5
 
6
- import { Activity, deno_default, getTypeId } from "./type-qs0mWLTm.js";
6
+ import { deno_default } from "./deno-B74l3pXN.js";
7
7
  import { getLogger } from "@logtape/logtape";
8
+ import { Activity, getTypeId } from "@fedify/vocab";
8
9
  import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
9
10
 
10
11
  //#region src/federation/inbox.ts
@@ -41,17 +42,34 @@ var InboxListenerSet = class InboxListenerSet {
41
42
  return this.dispatchWithClass(activity)?.listener ?? null;
42
43
  }
43
44
  };
44
- async function routeActivity({ context: ctx, json, activity, recipient, inboxListeners, inboxContextFactory, inboxErrorHandler, kv, kvPrefixes, queue, span, tracerProvider }) {
45
+ async function routeActivity({ context: ctx, json, activity, recipient, inboxListeners, inboxContextFactory, inboxErrorHandler, kv, kvPrefixes, queue, span, tracerProvider, idempotencyStrategy }) {
45
46
  const logger = getLogger([
46
47
  "fedify",
47
48
  "federation",
48
49
  "inbox"
49
50
  ]);
50
- const cacheKey = activity.id == null ? null : [
51
- ...kvPrefixes.activityIdempotence,
52
- ctx.origin,
53
- activity.id.href
54
- ];
51
+ let cacheKey = null;
52
+ if (activity.id != null) {
53
+ const inboxContext = inboxContextFactory(recipient, json, activity.id?.href, getTypeId(activity).href);
54
+ const strategy = idempotencyStrategy ?? "per-inbox";
55
+ let keyString;
56
+ if (typeof strategy === "function") {
57
+ const result = await strategy(inboxContext, activity);
58
+ keyString = result;
59
+ } else switch (strategy) {
60
+ case "global":
61
+ keyString = activity.id.href;
62
+ break;
63
+ case "per-origin":
64
+ keyString = `${ctx.origin}\n${activity.id.href}`;
65
+ break;
66
+ case "per-inbox":
67
+ keyString = `${ctx.origin}\n${activity.id.href}\n${recipient == null ? "sharedInbox" : `inbox\n${recipient}`}`;
68
+ break;
69
+ default: keyString = `${ctx.origin}\n${activity.id.href}`;
70
+ }
71
+ if (keyString != null) cacheKey = [...kvPrefixes.activityIdempotence, keyString];
72
+ }
55
73
  if (cacheKey != null) {
56
74
  const cached = await kv.get(cacheKey);
57
75
  if (cached === true) {
@@ -3,9 +3,10 @@
3
3
  import { URLPattern } from "urlpattern-polyfill";
4
4
  globalThis.addEventListener = () => {};
5
5
 
6
- import { CryptographicKey, Object as Object$1, deno_default, getDocumentLoader } from "./type-qs0mWLTm.js";
7
- import { isActor } from "./actor-Bj1Vq2XG.js";
6
+ import { deno_default } from "./deno-B74l3pXN.js";
8
7
  import { getLogger } from "@logtape/logtape";
8
+ import { CryptographicKey, Object as Object$1, isActor } from "@fedify/vocab";
9
+ import { getDocumentLoader } from "@fedify/vocab-runtime";
9
10
  import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
10
11
 
11
12
  //#region src/sig/key.ts
@@ -3,7 +3,7 @@
3
3
  import { URLPattern } from "urlpattern-polyfill";
4
4
  globalThis.addEventListener = () => {};
5
5
 
6
- import { CryptographicKey, Multikey } from "./type-qs0mWLTm.js";
6
+ import { CryptographicKey, Multikey } from "@fedify/vocab";
7
7
 
8
8
  //#region src/federation/keycache.ts
9
9
  var KvKeyCache = class {
@@ -3,7 +3,8 @@
3
3
  import { URLPattern } from "urlpattern-polyfill";
4
4
  globalThis.addEventListener = () => {};
5
5
 
6
- import { CryptographicKey, Multikey, importSpki } from "./type-qs0mWLTm.js";
6
+ import { CryptographicKey, Multikey } from "@fedify/vocab";
7
+ import { importSpki } from "@fedify/vocab-runtime";
7
8
 
8
9
  //#region src/testing/keys.ts
9
10
  const rsaPublicKey1 = new CryptographicKey({
@@ -19,6 +19,21 @@ interface KvStoreSetOptions {
19
19
  */
20
20
  ttl?: Temporal.Duration;
21
21
  }
22
+ /**
23
+ * An entry returned by the {@link KvStore.list} method.
24
+ *
25
+ * @since 1.10.0
26
+ */
27
+ interface KvStoreListEntry {
28
+ /**
29
+ * The key of the entry.
30
+ */
31
+ key: KvKey;
32
+ /**
33
+ * The value of the entry.
34
+ */
35
+ value: unknown;
36
+ }
22
37
  /**
23
38
  * An abstract interface for a key–value store.
24
39
  *
@@ -54,6 +69,16 @@ interface KvStore {
54
69
  * @since 1.8.0
55
70
  */
56
71
  cas?: (key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions) => Promise<boolean>;
72
+ /**
73
+ * Lists all entries in the store that match the given prefix.
74
+ * If no prefix is given, all entries are returned.
75
+ * @param prefix The prefix to filter keys by. If not specified, all entries
76
+ * are returned.
77
+ * @returns An async iterable of entries matching the prefix.
78
+ * @since 1.10.0
79
+ * @since 2.0.0 This method is now required instead of optional.
80
+ */
81
+ list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
57
82
  }
58
83
  /**
59
84
  * A key–value store that stores values in memory.
@@ -79,6 +104,10 @@ declare class MemoryKvStore implements KvStore {
79
104
  * {@inheritDoc KvStore.cas}
80
105
  */
81
106
  cas(key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions): Promise<boolean>;
107
+ /**
108
+ * {@inheritDoc KvStore.list}
109
+ */
110
+ list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
82
111
  }
83
112
  //#endregion
84
- export { KvKey, KvStore, KvStoreSetOptions, MemoryKvStore };
113
+ export { KvKey, KvStore, KvStoreListEntry, KvStoreSetOptions, MemoryKvStore };
@@ -0,0 +1,110 @@
1
+ //#region src/federation/kv.d.ts
2
+ /**
3
+ * A key for a key–value store. An array of one or more strings.
4
+ *
5
+ * @since 0.5.0
6
+ */
7
+ type KvKey = readonly [string] | readonly [string, ...string[]];
8
+ /**
9
+ * Additional options for setting a value in a key–value store.
10
+ *
11
+ * @since 0.5.0
12
+ */
13
+ interface KvStoreSetOptions {
14
+ /**
15
+ * The time-to-live (TTL) for the value.
16
+ */
17
+ ttl?: Temporal.Duration;
18
+ }
19
+ /**
20
+ * An entry returned by the {@link KvStore.list} method.
21
+ *
22
+ * @since 1.10.0
23
+ */
24
+ interface KvStoreListEntry {
25
+ /**
26
+ * The key of the entry.
27
+ */
28
+ key: KvKey;
29
+ /**
30
+ * The value of the entry.
31
+ */
32
+ value: unknown;
33
+ }
34
+ /**
35
+ * An abstract interface for a key–value store.
36
+ *
37
+ * @since 0.5.0
38
+ */
39
+ interface KvStore {
40
+ /**
41
+ * Gets the value for the given key.
42
+ * @param key The key to get the value for.
43
+ * @returns The value for the key, or `undefined` if the key does not exist.
44
+ * @template T The type of the value to get.
45
+ */
46
+ get<T = unknown>(key: KvKey): Promise<T | undefined>;
47
+ /**
48
+ * Sets the value for the given key.
49
+ * @param key The key to set the value for.
50
+ * @param value The value to set.
51
+ * @param options Additional options for setting the value.
52
+ */
53
+ set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
54
+ /**
55
+ * Deletes the value for the given key.
56
+ * @param key The key to delete.
57
+ */
58
+ delete(key: KvKey): Promise<void>;
59
+ /**
60
+ * Compare-and-swap (CAS) operation for the key–value store.
61
+ * @param key The key to perform the CAS operation on.
62
+ * @param expectedValue The expected value for the key.
63
+ * @param newValue The new value to set if the expected value matches.
64
+ * @param options Additional options for setting the value.
65
+ * @return `true` if the CAS operation was successful, `false` otherwise.
66
+ * @since 1.8.0
67
+ */
68
+ cas?: (key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions) => Promise<boolean>;
69
+ /**
70
+ * Lists all entries in the store that match the given prefix.
71
+ * If no prefix is given, all entries are returned.
72
+ * @param prefix The prefix to filter keys by. If not specified, all entries
73
+ * are returned.
74
+ * @returns An async iterable of entries matching the prefix.
75
+ * @since 1.10.0
76
+ * @since 2.0.0 This method is now required instead of optional.
77
+ */
78
+ list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
79
+ }
80
+ /**
81
+ * A key–value store that stores values in memory.
82
+ * Do not use this in production as it does not persist values.
83
+ *
84
+ * @since 0.5.0
85
+ */
86
+ declare class MemoryKvStore implements KvStore {
87
+ #private;
88
+ /**
89
+ * {@inheritDoc KvStore.get}
90
+ */
91
+ get<T = unknown>(key: KvKey): Promise<T | undefined>;
92
+ /**
93
+ * {@inheritDoc KvStore.set}
94
+ */
95
+ set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
96
+ /**
97
+ * {@inheritDoc KvStore.delete}
98
+ */
99
+ delete(key: KvKey): Promise<void>;
100
+ /**
101
+ * {@inheritDoc KvStore.cas}
102
+ */
103
+ cas(key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions): Promise<boolean>;
104
+ /**
105
+ * {@inheritDoc KvStore.list}
106
+ */
107
+ list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
108
+ }
109
+ //#endregion
110
+ export { KvKey, KvStore, KvStoreListEntry, KvStoreSetOptions, MemoryKvStore };
@@ -68,6 +68,28 @@ var MemoryKvStore = class {
68
68
  this.#values[encodedKey] = [newValue, expiration];
69
69
  return Promise.resolve(true);
70
70
  }
71
+ /**
72
+ * {@inheritDoc KvStore.list}
73
+ */
74
+ async *list(prefix) {
75
+ const now = Temporal.Now.instant();
76
+ for (const [encodedKey, entry] of Object.entries(this.#values)) {
77
+ const key = JSON.parse(encodedKey);
78
+ if (prefix != null) {
79
+ if (key.length < prefix.length) continue;
80
+ if (!prefix.every((p, i) => key[i] === p)) continue;
81
+ }
82
+ const [value, expiration] = entry;
83
+ if (expiration != null && now.until(expiration).sign < 0) {
84
+ delete this.#values[encodedKey];
85
+ continue;
86
+ }
87
+ yield {
88
+ key,
89
+ value
90
+ };
91
+ }
92
+ }
71
93
  };
72
94
 
73
95
  //#endregion
@@ -0,0 +1,107 @@
1
+
2
+ import { Temporal } from "@js-temporal/polyfill";
3
+ import { URLPattern } from "urlpattern-polyfill";
4
+ globalThis.addEventListener = () => {};
5
+
6
+ import { getLogger } from "@logtape/logtape";
7
+ import { preloadedContexts } from "@fedify/vocab-runtime";
8
+
9
+ //#region src/utils/kv-cache.ts
10
+ const logger = getLogger([
11
+ "fedify",
12
+ "utils",
13
+ "kv-cache"
14
+ ]);
15
+ /**
16
+ * A mock implementation of a key–value store for testing purposes.
17
+ */
18
+ var MockKvStore = class {
19
+ #values = {};
20
+ get(key) {
21
+ return Promise.resolve(this.#values[JSON.stringify(key)]);
22
+ }
23
+ set(key, value, _options) {
24
+ this.#values[JSON.stringify(key)] = value;
25
+ return Promise.resolve();
26
+ }
27
+ async delete(_) {}
28
+ cas(..._) {
29
+ return Promise.resolve(false);
30
+ }
31
+ async *list(prefix) {
32
+ for (const [encodedKey, value] of Object.entries(this.#values)) {
33
+ const key = JSON.parse(encodedKey);
34
+ if (prefix != null) {
35
+ if (key.length < prefix.length) continue;
36
+ if (!prefix.every((p, i) => key[i] === p)) continue;
37
+ }
38
+ yield {
39
+ key,
40
+ value
41
+ };
42
+ }
43
+ }
44
+ };
45
+ /**
46
+ * Decorates a {@link DocumentLoader} with a cache backed by a {@link Deno.Kv}.
47
+ * @param parameters The parameters for the cache.
48
+ * @returns The decorated document loader which is cache-enabled.
49
+ */
50
+ function kvCache({ loader, kv, prefix, rules }) {
51
+ const keyPrefix = prefix ?? ["_fedify", "remoteDocument"];
52
+ rules ??= [[new URLPattern({}), Temporal.Duration.from({ minutes: 5 })]];
53
+ for (const [p, duration] of rules) if (Temporal.Duration.compare(duration, { days: 30 }) > 0) throw new TypeError("The maximum cache duration is 30 days: " + (p instanceof URLPattern ? `${p.protocol}://${p.username}:${p.password}@${p.hostname}:${p.port}/${p.pathname}?${p.search}#${p.hash}` : p.toString()));
54
+ return async (url, options) => {
55
+ if (url in preloadedContexts) {
56
+ logger.debug("Using preloaded context: {url}.", { url });
57
+ return {
58
+ contextUrl: null,
59
+ document: preloadedContexts[url],
60
+ documentUrl: url
61
+ };
62
+ }
63
+ const match = matchRule(url, rules);
64
+ if (match == null) return await loader(url, options);
65
+ const key = [...keyPrefix, url];
66
+ let cache = void 0;
67
+ try {
68
+ cache = await kv.get(key);
69
+ } catch (error) {
70
+ if (error instanceof Error) logger.warn("Failed to get the document of {url} from the KV cache: {error}", {
71
+ url,
72
+ error
73
+ });
74
+ }
75
+ if (cache == null) {
76
+ const remoteDoc = await loader(url, options);
77
+ try {
78
+ await kv.set(key, remoteDoc, { ttl: match });
79
+ } catch (error) {
80
+ logger.warn("Failed to save the document of {url} to the KV cache: {error}", {
81
+ url,
82
+ error
83
+ });
84
+ }
85
+ return remoteDoc;
86
+ }
87
+ return cache;
88
+ };
89
+ }
90
+ function matchRule(url, rules) {
91
+ for (const [pattern, d] of rules) {
92
+ const duration = d instanceof Temporal.Duration ? d : Temporal.Duration.from(d);
93
+ if (typeof pattern === "string") {
94
+ if (url === pattern) return duration;
95
+ continue;
96
+ }
97
+ if (pattern instanceof URL) {
98
+ if (pattern.href == url) return duration;
99
+ continue;
100
+ }
101
+ if (pattern.test(url)) return duration;
102
+ }
103
+ return null;
104
+ }
105
+
106
+ //#endregion
107
+ export { MockKvStore, kvCache };
@@ -0,0 +1,122 @@
1
+
2
+ import { Temporal } from "@js-temporal/polyfill";
3
+ import { URLPattern } from "urlpattern-polyfill";
4
+
5
+ import { doubleKnock, validateCryptoKey } from "./http-DJ7KWfiN.js";
6
+ import { getLogger } from "@logtape/logtape";
7
+ import { curry } from "es-toolkit";
8
+ import { UrlError, createActivityPubRequest, getDocumentLoader, getRemoteDocument, logRequest, preloadedContexts, validatePublicUrl } from "@fedify/vocab-runtime";
9
+
10
+ //#region src/utils/docloader.ts
11
+ const logger$1 = getLogger([
12
+ "fedify",
13
+ "utils",
14
+ "docloader"
15
+ ]);
16
+ /**
17
+ * Gets an authenticated {@link DocumentLoader} for the given identity.
18
+ * Note that an authenticated document loader intentionally does not cache
19
+ * the fetched documents.
20
+ * @param identity The identity to get the document loader for.
21
+ * The actor's key pair.
22
+ * @param options The options for the document loader.
23
+ * @returns The authenticated document loader.
24
+ * @throws {TypeError} If the key is invalid or unsupported.
25
+ * @since 0.4.0
26
+ */
27
+ function getAuthenticatedDocumentLoader(identity, { allowPrivateAddress, userAgent, specDeterminer, tracerProvider } = {}) {
28
+ validateCryptoKey(identity.privateKey);
29
+ async function load(url, options) {
30
+ if (!allowPrivateAddress) try {
31
+ await validatePublicUrl(url);
32
+ } catch (error) {
33
+ if (error instanceof UrlError) logger$1.error("Disallowed private URL: {url}", {
34
+ url,
35
+ error
36
+ });
37
+ throw error;
38
+ }
39
+ const originalRequest = createActivityPubRequest(url, { userAgent });
40
+ const response = await doubleKnock(originalRequest, identity, {
41
+ specDeterminer,
42
+ log: curry(logRequest)(logger$1),
43
+ tracerProvider,
44
+ signal: options?.signal
45
+ });
46
+ return getRemoteDocument(url, response, load);
47
+ }
48
+ return load;
49
+ }
50
+ const _fetchDocumentLoader = getDocumentLoader();
51
+ const _fetchDocumentLoader_allowPrivateAddress = getDocumentLoader({ allowPrivateAddress: true });
52
+
53
+ //#endregion
54
+ //#region src/utils/kv-cache.ts
55
+ const logger = getLogger([
56
+ "fedify",
57
+ "utils",
58
+ "kv-cache"
59
+ ]);
60
+ /**
61
+ * Decorates a {@link DocumentLoader} with a cache backed by a {@link Deno.Kv}.
62
+ * @param parameters The parameters for the cache.
63
+ * @returns The decorated document loader which is cache-enabled.
64
+ */
65
+ function kvCache({ loader, kv, prefix, rules }) {
66
+ const keyPrefix = prefix ?? ["_fedify", "remoteDocument"];
67
+ rules ??= [[new URLPattern({}), Temporal.Duration.from({ minutes: 5 })]];
68
+ for (const [p, duration] of rules) if (Temporal.Duration.compare(duration, { days: 30 }) > 0) throw new TypeError("The maximum cache duration is 30 days: " + (p instanceof URLPattern ? `${p.protocol}://${p.username}:${p.password}@${p.hostname}:${p.port}/${p.pathname}?${p.search}#${p.hash}` : p.toString()));
69
+ return async (url, options) => {
70
+ if (url in preloadedContexts) {
71
+ logger.debug("Using preloaded context: {url}.", { url });
72
+ return {
73
+ contextUrl: null,
74
+ document: preloadedContexts[url],
75
+ documentUrl: url
76
+ };
77
+ }
78
+ const match = matchRule(url, rules);
79
+ if (match == null) return await loader(url, options);
80
+ const key = [...keyPrefix, url];
81
+ let cache = void 0;
82
+ try {
83
+ cache = await kv.get(key);
84
+ } catch (error) {
85
+ if (error instanceof Error) logger.warn("Failed to get the document of {url} from the KV cache: {error}", {
86
+ url,
87
+ error
88
+ });
89
+ }
90
+ if (cache == null) {
91
+ const remoteDoc = await loader(url, options);
92
+ try {
93
+ await kv.set(key, remoteDoc, { ttl: match });
94
+ } catch (error) {
95
+ logger.warn("Failed to save the document of {url} to the KV cache: {error}", {
96
+ url,
97
+ error
98
+ });
99
+ }
100
+ return remoteDoc;
101
+ }
102
+ return cache;
103
+ };
104
+ }
105
+ function matchRule(url, rules) {
106
+ for (const [pattern, d] of rules) {
107
+ const duration = d instanceof Temporal.Duration ? d : Temporal.Duration.from(d);
108
+ if (typeof pattern === "string") {
109
+ if (url === pattern) return duration;
110
+ continue;
111
+ }
112
+ if (pattern instanceof URL) {
113
+ if (pattern.href == url) return duration;
114
+ continue;
115
+ }
116
+ if (pattern.test(url)) return duration;
117
+ }
118
+ return null;
119
+ }
120
+
121
+ //#endregion
122
+ export { getAuthenticatedDocumentLoader, kvCache };
@@ -0,0 +1,134 @@
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 require_http = require('./http-DtRqZZgP.cjs');
7
+ const __logtape_logtape = require_chunk.__toESM(require("@logtape/logtape"));
8
+ const es_toolkit = require_chunk.__toESM(require("es-toolkit"));
9
+ const __fedify_vocab_runtime = require_chunk.__toESM(require("@fedify/vocab-runtime"));
10
+
11
+ //#region src/utils/docloader.ts
12
+ const logger$1 = (0, __logtape_logtape.getLogger)([
13
+ "fedify",
14
+ "utils",
15
+ "docloader"
16
+ ]);
17
+ /**
18
+ * Gets an authenticated {@link DocumentLoader} for the given identity.
19
+ * Note that an authenticated document loader intentionally does not cache
20
+ * the fetched documents.
21
+ * @param identity The identity to get the document loader for.
22
+ * The actor's key pair.
23
+ * @param options The options for the document loader.
24
+ * @returns The authenticated document loader.
25
+ * @throws {TypeError} If the key is invalid or unsupported.
26
+ * @since 0.4.0
27
+ */
28
+ function getAuthenticatedDocumentLoader(identity, { allowPrivateAddress, userAgent, specDeterminer, tracerProvider } = {}) {
29
+ require_http.validateCryptoKey(identity.privateKey);
30
+ async function load(url, options) {
31
+ if (!allowPrivateAddress) try {
32
+ await (0, __fedify_vocab_runtime.validatePublicUrl)(url);
33
+ } catch (error) {
34
+ if (error instanceof __fedify_vocab_runtime.UrlError) logger$1.error("Disallowed private URL: {url}", {
35
+ url,
36
+ error
37
+ });
38
+ throw error;
39
+ }
40
+ const originalRequest = (0, __fedify_vocab_runtime.createActivityPubRequest)(url, { userAgent });
41
+ const response = await require_http.doubleKnock(originalRequest, identity, {
42
+ specDeterminer,
43
+ log: (0, es_toolkit.curry)(__fedify_vocab_runtime.logRequest)(logger$1),
44
+ tracerProvider,
45
+ signal: options?.signal
46
+ });
47
+ return (0, __fedify_vocab_runtime.getRemoteDocument)(url, response, load);
48
+ }
49
+ return load;
50
+ }
51
+ const _fetchDocumentLoader = (0, __fedify_vocab_runtime.getDocumentLoader)();
52
+ const _fetchDocumentLoader_allowPrivateAddress = (0, __fedify_vocab_runtime.getDocumentLoader)({ allowPrivateAddress: true });
53
+
54
+ //#endregion
55
+ //#region src/utils/kv-cache.ts
56
+ const logger = (0, __logtape_logtape.getLogger)([
57
+ "fedify",
58
+ "utils",
59
+ "kv-cache"
60
+ ]);
61
+ /**
62
+ * Decorates a {@link DocumentLoader} with a cache backed by a {@link Deno.Kv}.
63
+ * @param parameters The parameters for the cache.
64
+ * @returns The decorated document loader which is cache-enabled.
65
+ */
66
+ function kvCache({ loader, kv, prefix, rules }) {
67
+ const keyPrefix = prefix ?? ["_fedify", "remoteDocument"];
68
+ rules ??= [[new URLPattern({}), Temporal.Duration.from({ minutes: 5 })]];
69
+ for (const [p, duration] of rules) if (Temporal.Duration.compare(duration, { days: 30 }) > 0) throw new TypeError("The maximum cache duration is 30 days: " + (p instanceof URLPattern ? `${p.protocol}://${p.username}:${p.password}@${p.hostname}:${p.port}/${p.pathname}?${p.search}#${p.hash}` : p.toString()));
70
+ return async (url, options) => {
71
+ if (url in __fedify_vocab_runtime.preloadedContexts) {
72
+ logger.debug("Using preloaded context: {url}.", { url });
73
+ return {
74
+ contextUrl: null,
75
+ document: __fedify_vocab_runtime.preloadedContexts[url],
76
+ documentUrl: url
77
+ };
78
+ }
79
+ const match = matchRule(url, rules);
80
+ if (match == null) return await loader(url, options);
81
+ const key = [...keyPrefix, url];
82
+ let cache = void 0;
83
+ try {
84
+ cache = await kv.get(key);
85
+ } catch (error) {
86
+ if (error instanceof Error) logger.warn("Failed to get the document of {url} from the KV cache: {error}", {
87
+ url,
88
+ error
89
+ });
90
+ }
91
+ if (cache == null) {
92
+ const remoteDoc = await loader(url, options);
93
+ try {
94
+ await kv.set(key, remoteDoc, { ttl: match });
95
+ } catch (error) {
96
+ logger.warn("Failed to save the document of {url} to the KV cache: {error}", {
97
+ url,
98
+ error
99
+ });
100
+ }
101
+ return remoteDoc;
102
+ }
103
+ return cache;
104
+ };
105
+ }
106
+ function matchRule(url, rules) {
107
+ for (const [pattern, d] of rules) {
108
+ const duration = d instanceof Temporal.Duration ? d : Temporal.Duration.from(d);
109
+ if (typeof pattern === "string") {
110
+ if (url === pattern) return duration;
111
+ continue;
112
+ }
113
+ if (pattern instanceof URL) {
114
+ if (pattern.href == url) return duration;
115
+ continue;
116
+ }
117
+ if (pattern.test(url)) return duration;
118
+ }
119
+ return null;
120
+ }
121
+
122
+ //#endregion
123
+ Object.defineProperty(exports, 'getAuthenticatedDocumentLoader', {
124
+ enumerable: true,
125
+ get: function () {
126
+ return getAuthenticatedDocumentLoader;
127
+ }
128
+ });
129
+ Object.defineProperty(exports, 'kvCache', {
130
+ enumerable: true,
131
+ get: function () {
132
+ return kvCache;
133
+ }
134
+ });
@@ -3,9 +3,11 @@
3
3
  import { URLPattern } from "urlpattern-polyfill";
4
4
  globalThis.addEventListener = () => {};
5
5
 
6
- import { Activity, CryptographicKey, Object as Object$1, deno_default, getDocumentLoader, getTypeId } from "./type-qs0mWLTm.js";
7
- import { fetchKey, validateCryptoKey } from "./key-D-s3dQbK.js";
6
+ import { deno_default } from "./deno-B74l3pXN.js";
7
+ import { fetchKey, validateCryptoKey } from "./key-pYEsD-IB.js";
8
8
  import { getLogger } from "@logtape/logtape";
9
+ import { Activity, CryptographicKey, Object as Object$1, getTypeId } from "@fedify/vocab";
10
+ import { getDocumentLoader } from "@fedify/vocab-runtime";
9
11
  import { SpanStatusCode, trace } from "@opentelemetry/api";
10
12
  import { decodeBase64, encodeBase64 } from "byte-encodings/base64";
11
13
  import { encodeHex } from "byte-encodings/hex";