@fedify/fedify 2.0.0-pr.445.1694 → 2.0.0-pr.451.1730

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 (193) hide show
  1. package/dist/{actor-T6RyhRgk.d.ts → actor-Cd2CREO0.d.ts} +2 -2
  2. package/dist/{actor-D8gCwLzv.js → actor-Cg8ZhoVF.js} +1 -1
  3. package/dist/{actor-CwZ2m5rG.cjs → actor-D020hlx3.cjs} +922 -1451
  4. package/dist/{actor-D6K058Tb.d.cts → actor-DDhZuMGl.d.cts} +2 -2
  5. package/dist/{actor-DoMcqXsW.js → actor-DPD6Gbdn.js} +190 -677
  6. package/dist/{assert_rejects-DiIiJbZn.js → assert_rejects-Ce45JcFg.js} +1 -1
  7. package/dist/{assert_is_error-BPGph1Jx.js → assert_throws-BNXdRGWP.js} +31 -1
  8. package/dist/{builder-1_skw-d2.js → builder-Dn87hy75.js} +7 -8
  9. package/dist/{client-bgSdkFa2.d.ts → client-Bkaw0_PR.d.ts} +1 -1
  10. package/dist/{client-CegPX0Rn.d.cts → client-Cle5j1T1.d.cts} +1 -1
  11. package/dist/{client-D5CBsPrc.js → client-D6-5okV1.js} +1 -1
  12. package/dist/compat/mod.d.cts +11 -11
  13. package/dist/compat/mod.d.ts +12 -12
  14. package/dist/compat/transformers.test.js +20 -20
  15. package/dist/{context-DiqjMRef.d.cts → context-BOYzcFSe.d.cts} +130 -97
  16. package/dist/{context-DBKpNBnc.d.ts → context-DqFifMwj.d.ts} +131 -98
  17. package/dist/{authdocloader-DYTNpaMA.js → docloader-B2BFBGqv.js} +18 -8
  18. package/dist/{esm-Dl5T1RNE.js → esm-CU0Dnk7T.js} +11 -11
  19. package/dist/federation/builder.test.js +8 -10
  20. package/dist/federation/collection.test.js +7 -9
  21. package/dist/federation/handler.test.js +25 -26
  22. package/dist/federation/idempotency.test.js +25 -26
  23. package/dist/federation/inbox.test.js +4 -6
  24. package/dist/federation/keycache.test.js +3 -4
  25. package/dist/federation/kv.test.js +6 -8
  26. package/dist/federation/middleware.test.js +26 -27
  27. package/dist/federation/mod.cjs +10 -11
  28. package/dist/federation/mod.d.cts +11 -11
  29. package/dist/federation/mod.d.ts +13 -13
  30. package/dist/federation/mod.js +10 -11
  31. package/dist/federation/mq.test.js +8 -10
  32. package/dist/federation/negotiation.test.js +7 -9
  33. package/dist/federation/retry.test.js +4 -5
  34. package/dist/federation/router.test.js +6 -8
  35. package/dist/federation/send.test.js +13 -15
  36. package/dist/{http-D-e6AFwR.d.cts → http-B6SKO6NJ.d.cts} +2 -2
  37. package/dist/{http-D6Uj2x2y.d.ts → http-BE7aFuqn.d.ts} +2 -2
  38. package/dist/{http-CAusBl_3.cjs → http-DMsjudj8.cjs} +289 -9
  39. package/dist/{http-CuS-d4U0.js → http-DN0v2zoF.js} +2 -2
  40. package/dist/{http-C_Qc2neP.js → http-DcDb8r1W.js} +256 -6
  41. package/dist/{inbox-IETv_Qez.js → inbox-CgGy7Hzc.js} +1 -1
  42. package/dist/{key-DnqhSgAv.js → key-jSvnymAk.js} +3 -2
  43. package/dist/{keycache-CSBkusP8.js → keycache-IVLjlAK9.js} +1 -1
  44. package/dist/{keys-D3_MDK7n.js → keys-BKM2Mqu2.js} +2 -1
  45. package/dist/{docloader-CYnQRIXv.cjs → kv-cache-BHIupktM.cjs} +69 -651
  46. package/dist/kv-cache-DNvS-egZ.js +4236 -0
  47. package/dist/{docloader-Czl3xV10.js → kv-cache-ydIs4Ul6.js} +68 -596
  48. package/dist/{ld-Isot0tiW.js → ld-CcsryBo0.js} +3 -2
  49. package/dist/{lookup-Dhm78GlK.js → lookup-BV3A9Zbc.js} +63 -2
  50. package/dist/{type-DaUr3Il7.js → lookup-BbEekiru.js} +588 -5303
  51. package/dist/{lookup-D6dro5Au.cjs → lookup-CMAGfQ1Q.cjs} +78 -5
  52. package/dist/{middleware-BuHr2fzh.js → middleware-D-vPitR-.js} +37 -38
  53. package/dist/{middleware-DQYscW90.js → middleware-Dm8sXYUr.js} +40 -40
  54. package/dist/middleware-DzA970CF.js +16 -0
  55. package/dist/middleware-VpoC5jyA.js +26 -0
  56. package/dist/middleware-W_-inBoE.cjs +16 -0
  57. package/dist/{middleware-Dgmdgrvb.cjs → middleware-ekn2KaOw.cjs} +57 -58
  58. package/dist/{mod-CxkWO3Mg.d.cts → mod--K7l84wp.d.cts} +3 -2
  59. package/dist/{mod-DBzN0aCM.d.ts → mod-CB80AlIA.d.ts} +1 -1
  60. package/dist/mod-CLKu6Uo_.d.cts +107 -0
  61. package/dist/{mod-Djzcw2ry.d.cts → mod-COlOrmr9.d.cts} +3 -3
  62. package/dist/{mod-DlU8ISoa.d.ts → mod-CRENK2dd.d.ts} +3 -2
  63. package/dist/{mod-D_y2y32N.d.ts → mod-CaWbCg0N.d.ts} +2 -2
  64. package/dist/mod-Cm97bAiT.d.ts +109 -0
  65. package/dist/{mod-Bpb5QLaZ.d.cts → mod-D9XZsft2.d.cts} +2 -2
  66. package/dist/{mod-BhUKmBJD.d.ts → mod-DLIidI_j.d.ts} +3 -3
  67. package/dist/{mod-jQ4OODsl.d.cts → mod-DuclhZjh.d.cts} +1 -1
  68. package/dist/mod.cjs +21 -32
  69. package/dist/mod.d.cts +14 -14
  70. package/dist/mod.d.ts +17 -17
  71. package/dist/mod.js +15 -16
  72. package/dist/nodeinfo/client.test.js +8 -10
  73. package/dist/nodeinfo/handler.test.js +24 -25
  74. package/dist/nodeinfo/mod.cjs +3 -3
  75. package/dist/nodeinfo/mod.d.cts +2 -3
  76. package/dist/nodeinfo/mod.d.ts +3 -4
  77. package/dist/nodeinfo/mod.js +3 -3
  78. package/dist/nodeinfo/types.test.js +7 -9
  79. package/dist/{owner-hd9lvQcP.d.ts → owner-CktUdA0h.d.ts} +3 -3
  80. package/dist/{owner-BN_tO3cY.d.cts → owner-dkg5OpSC.d.cts} +3 -3
  81. package/dist/{owner-ChSL4aJ7.js → owner-n5c_oZ_M.js} +3 -2
  82. package/dist/{proof-BiSCuwyA.js → proof-CLwByIT1.js} +5 -4
  83. package/dist/{proof-ONNmhInb.cjs → proof-CZfrp13P.cjs} +17 -16
  84. package/dist/{proof-x3IBewan.js → proof-CsFR7fiS.js} +2 -2
  85. package/dist/request-BbHkedIU.d.cts +35 -0
  86. package/dist/request-DKGQaofB.js +184 -0
  87. package/dist/request-U1t6zZtk.d.ts +39 -0
  88. package/dist/request-XHWUW2bi.cjs +208 -0
  89. package/dist/{send-D5fjmUEj.js → send-eW9JIzQV.js} +2 -2
  90. package/dist/sig/http.test.js +12 -13
  91. package/dist/sig/key.test.js +9 -11
  92. package/dist/sig/ld.test.js +8 -10
  93. package/dist/sig/mod.cjs +10 -11
  94. package/dist/sig/mod.d.cts +6 -7
  95. package/dist/sig/mod.d.ts +6 -7
  96. package/dist/sig/mod.js +6 -7
  97. package/dist/sig/owner.test.js +10 -12
  98. package/dist/sig/proof.test.js +13 -14
  99. package/dist/testing/docloader.test.js +6 -8
  100. package/dist/testing/mod.d.ts +122 -148
  101. package/dist/testing/mod.js +2 -3
  102. package/dist/{testing-tWr1VQxx.js → testing-ClYSmXdi.js} +1 -2
  103. package/dist/{types-D2Nyz0tR.cjs → types-BT0xc4-R.cjs} +3 -3
  104. package/dist/{types-DQuSDtDg.js → types-DaPoJTSc.js} +1 -1
  105. package/dist/{runtime/authdocloader.test.js → utils/docloader.test.js} +13 -15
  106. package/dist/utils/kv-cache.test.js +208 -0
  107. package/dist/utils/mod.cjs +14 -0
  108. package/dist/utils/mod.d.cts +6 -0
  109. package/dist/utils/mod.d.ts +8 -0
  110. package/dist/utils/mod.js +12 -0
  111. package/dist/utils/request.test.js +48 -0
  112. package/dist/utils/url.test.js +41 -0
  113. package/dist/vocab/actor.test.js +8 -10
  114. package/dist/vocab/lookup.test.js +7 -9
  115. package/dist/vocab/mod.cjs +4 -4
  116. package/dist/vocab/mod.d.cts +4 -5
  117. package/dist/vocab/mod.d.ts +4 -5
  118. package/dist/vocab/mod.js +4 -4
  119. package/dist/vocab/type.test.js +2 -3
  120. package/dist/vocab/vocab.test.js +9 -10
  121. package/dist/{vocab-Dd4VMrr0.cjs → vocab-CxTuoEVd.cjs} +6 -5
  122. package/dist/{vocab-Dw1-yVGg.d.cts → vocab-DCBw44JZ.d.cts} +2 -21
  123. package/dist/{vocab-BI0Ak5lL.d.ts → vocab-ivDKb439.d.ts} +2 -21
  124. package/dist/{vocab-w--qk7HF.js → vocab-yFT-fQBj.js} +4 -3
  125. package/dist/webfinger/handler.test.js +24 -25
  126. package/dist/webfinger/lookup.test.js +7 -9
  127. package/dist/webfinger/mod.cjs +3 -3
  128. package/dist/webfinger/mod.d.cts +2 -3
  129. package/dist/webfinger/mod.d.ts +2 -3
  130. package/dist/webfinger/mod.js +3 -3
  131. package/dist/x/cfworkers.d.cts +1 -1
  132. package/dist/x/cfworkers.d.ts +2 -2
  133. package/dist/x/cfworkers.test.js +6 -8
  134. package/dist/x/hono.d.cts +10 -10
  135. package/dist/x/hono.d.ts +11 -11
  136. package/dist/x/sveltekit.d.cts +10 -10
  137. package/dist/x/sveltekit.d.ts +11 -11
  138. package/package.json +16 -14
  139. package/dist/assert_throws-BOO88avQ.js +0 -39
  140. package/dist/authdocloader-Cv_qEn1G.js +0 -52
  141. package/dist/authdocloader-bsmVF6eO.cjs +0 -58
  142. package/dist/docloader-CxWcuWqQ.d.ts +0 -221
  143. package/dist/docloader-D-MrRyHl.d.cts +0 -219
  144. package/dist/key-BNJQQm3h.js +0 -260
  145. package/dist/key-C_ruQbbl.js +0 -10
  146. package/dist/key-DIMJMxf4.cjs +0 -10
  147. package/dist/key-DpFjiItf.js +0 -10
  148. package/dist/key-DuXv64tg.cjs +0 -290
  149. package/dist/lookup-CbtuFbtg.js +0 -331
  150. package/dist/middleware-BpR6186a.js +0 -26
  151. package/dist/middleware-DDMxdtWM.cjs +0 -17
  152. package/dist/middleware-T-knSMwl.js +0 -17
  153. package/dist/mod-CerN_Sza.d.ts +0 -104
  154. package/dist/mod-Cj1tHXBR.d.cts +0 -102
  155. package/dist/runtime/docloader.test.js +0 -522
  156. package/dist/runtime/key.test.js +0 -103
  157. package/dist/runtime/langstr.test.d.ts +0 -3
  158. package/dist/runtime/langstr.test.js +0 -39
  159. package/dist/runtime/link.test.d.ts +0 -3
  160. package/dist/runtime/link.test.js +0 -61
  161. package/dist/runtime/mod.cjs +0 -25
  162. package/dist/runtime/mod.d.cts +0 -6
  163. package/dist/runtime/mod.d.ts +0 -8
  164. package/dist/runtime/mod.js +0 -13
  165. package/dist/runtime/multibase/multibase.test.d.ts +0 -3
  166. package/dist/runtime/multibase/multibase.test.js +0 -358
  167. package/dist/runtime/url.test.js +0 -45
  168. /package/dist/{assert_not_equals-f3m3epl3.js → assert_not_equals-C80BG-_5.js} +0 -0
  169. /package/dist/{collection-CcnIw1qY.js → collection-BzWsN9pB.js} +0 -0
  170. /package/dist/{denokv-Bv33Xxea.js → denokv-CCssOzMJ.js} +0 -0
  171. /package/dist/{federation-H2_En3j5.cjs → federation-DOuZpcAw.cjs} +0 -0
  172. /package/dist/{federation-D1U8YY9t.js → federation-pZJsapBn.js} +0 -0
  173. /package/dist/{kv-63Cil1MD.d.cts → kv-BMKIFXNW.d.cts} +0 -0
  174. /package/dist/{kv-C7sopW2E.d.ts → kv-Dt06smFt.d.ts} +0 -0
  175. /package/dist/{mod-1pDWKvUL.d.ts → mod-B-ZQqbGe.d.ts} +0 -0
  176. /package/dist/{mod-g0xFzAP9.d.ts → mod-CjsiSl7_.d.ts} +0 -0
  177. /package/dist/{mq-CRGm1e_F.d.ts → mq-CPRJk4mZ.d.ts} +0 -0
  178. /package/dist/{negotiation-5NPJL6zp.js → negotiation-C4nFufNk.js} +0 -0
  179. /package/dist/{nodeinfo-DfycQ8Wf.js → nodeinfo-B0UefMXO.js} +0 -0
  180. /package/dist/{nodeinfo-Co9lJrWl.cjs → nodeinfo-ByTd7HpT.cjs} +0 -0
  181. /package/dist/{retry-D4GJ670a.js → retry-CfF8Gn4d.js} +0 -0
  182. /package/dist/{runtime-C58AJWSv.cjs → sig-DE_NC_VQ.cjs} +0 -0
  183. /package/dist/{runtime-DPYEDf-o.js → sig-Dx59zAgn.js} +0 -0
  184. /package/dist/{std__assert-X-_kMxKM.js → std__assert-DWivtrGR.js} +0 -0
  185. /package/dist/{types-BSuWJsOm.js → types-C2XVl6gj.js} +0 -0
  186. /package/dist/{runtime → utils}/docloader.test.d.ts +0 -0
  187. /package/dist/{runtime/authdocloader.test.d.ts → utils/kv-cache.test.d.ts} +0 -0
  188. /package/dist/{runtime/key.test.d.ts → utils/request.test.d.ts} +0 -0
  189. /package/dist/{runtime → utils}/url.test.d.ts +0 -0
  190. /package/dist/{sig-ByHXzqUi.cjs → utils-B6yXfxAQ.cjs} +0 -0
  191. /package/dist/{sig-Cj3tk-ig.js → utils-BXMGcmqK.js} +0 -0
  192. /package/dist/{webfinger-BjOEdFPs.cjs → webfinger-C949bxcD.cjs} +0 -0
  193. /package/dist/{webfinger-De_bU0iE.js → webfinger-qG8R5jc3.js} +0 -0
@@ -1,221 +0,0 @@
1
- import { Temporal } from "@js-temporal/polyfill";
2
- import { URLPattern } from "urlpattern-polyfill";
3
- import { KvKey, KvStore } from "./kv-C7sopW2E.js";
4
-
5
- //#region src/runtime/docloader.d.ts
6
- /**
7
- * A remote JSON-LD document and its context fetched by
8
- * a {@link DocumentLoader}.
9
- */
10
- interface RemoteDocument {
11
- /**
12
- * The URL of the context document.
13
- */
14
- contextUrl: string | null;
15
- /**
16
- * The fetched JSON-LD document.
17
- */
18
- document: unknown;
19
- /**
20
- * The URL of the fetched document.
21
- */
22
- documentUrl: string;
23
- }
24
- /**
25
- * Options for {@link DocumentLoader}.
26
- * @since 1.8.0
27
- */
28
- interface DocumentLoaderOptions {
29
- /**
30
- * An `AbortSignal` for cancellation.
31
- * @since 1.8.0
32
- */
33
- signal?: AbortSignal;
34
- }
35
- /**
36
- * A JSON-LD document loader that fetches documents from the Web.
37
- * @param url The URL of the document to load.
38
- * @param options The options for the document loader.
39
- * @returns The loaded remote document.
40
- */
41
- type DocumentLoader = (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>;
42
- /**
43
- * A factory function that creates a {@link DocumentLoader} with options.
44
- * @param options The options for the document loader.
45
- * @returns The document loader.
46
- * @since 1.4.0
47
- */
48
- type DocumentLoaderFactory = (options?: DocumentLoaderFactoryOptions) => DocumentLoader;
49
- /**
50
- * Options for {@link DocumentLoaderFactory}.
51
- * @see {@link DocumentLoaderFactory}
52
- * @see {@link AuthenticatedDocumentLoaderFactory}
53
- * @since 1.4.0
54
- */
55
- interface DocumentLoaderFactoryOptions {
56
- /**
57
- * Whether to allow fetching private network addresses.
58
- * Turned off by default.
59
- * @default `false``
60
- */
61
- allowPrivateAddress?: boolean;
62
- /**
63
- * Options for making `User-Agent` string.
64
- * If a string is given, it is used as the `User-Agent` header value.
65
- * If an object is given, it is passed to {@link getUserAgent} function.
66
- */
67
- userAgent?: GetUserAgentOptions | string;
68
- }
69
- /**
70
- * A factory function that creates an authenticated {@link DocumentLoader} for
71
- * a given identity. This is used for fetching documents that require
72
- * authentication.
73
- * @param identity The identity to create the document loader for.
74
- * The actor's key pair.
75
- * @param options The options for the document loader.
76
- * @returns The authenticated document loader.
77
- * @since 0.4.0
78
- */
79
- type AuthenticatedDocumentLoaderFactory = (identity: {
80
- keyId: URL;
81
- privateKey: CryptoKey;
82
- }, options?: DocumentLoaderFactoryOptions) => DocumentLoader;
83
- /**
84
- * Error thrown when fetching a JSON-LD document failed.
85
- */
86
- declare class FetchError extends Error {
87
- /**
88
- * The URL that failed to fetch.
89
- */
90
- url: URL;
91
- /**
92
- * Constructs a new `FetchError`.
93
- *
94
- * @param url The URL that failed to fetch.
95
- * @param message Error message.
96
- */
97
- constructor(url: URL | string, message?: string);
98
- }
99
- /**
100
- * Options for creating a request.
101
- * @internal
102
- */
103
-
104
- /**
105
- * Options for {@link getDocumentLoader}.
106
- * @since 1.3.0
107
- */
108
- interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
109
- /**
110
- * Whether to preload the frequently used contexts.
111
- */
112
- skipPreloadedContexts?: boolean;
113
- }
114
- /**
115
- * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
116
- *
117
- * The created loader preloads the below frequently used contexts by default
118
- * (unless `options.ignorePreloadedContexts` is set to `true`):
119
- *
120
- * - <https://www.w3.org/ns/activitystreams>
121
- * - <https://w3id.org/security/v1>
122
- * - <https://w3id.org/security/data-integrity/v1>
123
- * - <https://www.w3.org/ns/did/v1>
124
- * - <https://w3id.org/security/multikey/v1>
125
- * - <https://purl.archive.org/socialweb/webfinger>
126
- * - <http://schema.org/>
127
- * @param options Options for the document loader.
128
- * @returns The document loader.
129
- * @since 1.3.0
130
- */
131
- declare function getDocumentLoader({
132
- allowPrivateAddress,
133
- skipPreloadedContexts,
134
- userAgent
135
- }?: GetDocumentLoaderOptions): DocumentLoader;
136
- /**
137
- * A JSON-LD document loader that utilizes the browser's `fetch` API.
138
- *
139
- * This loader preloads the below frequently used contexts:
140
- *
141
- * - <https://www.w3.org/ns/activitystreams>
142
- * - <https://w3id.org/security/v1>
143
- * - <https://w3id.org/security/data-integrity/v1>
144
- * - <https://www.w3.org/ns/did/v1>
145
- * - <https://w3id.org/security/multikey/v1>
146
- * - <https://purl.archive.org/socialweb/webfinger>
147
- * - <http://schema.org/>
148
- * @param url The URL of the document to load.
149
- * @param allowPrivateAddress Whether to allow fetching private network
150
- * addresses. Turned off by default.
151
- * @returns The remote document.
152
- * @deprecated Use {@link getDocumentLoader} instead.
153
- */
154
- declare function fetchDocumentLoader(url: string, allowPrivateAddress?: boolean): Promise<RemoteDocument>;
155
- declare function fetchDocumentLoader(url: string, options?: DocumentLoaderOptions): Promise<RemoteDocument>;
156
- /**
157
- * The parameters for {@link kvCache} function.
158
- */
159
- interface KvCacheParameters {
160
- /**
161
- * The document loader to decorate with a cache.
162
- */
163
- loader: DocumentLoader;
164
- /**
165
- * The key–value store to use for backing the cache.
166
- */
167
- kv: KvStore;
168
- /**
169
- * The key prefix to use for namespacing the cache.
170
- * `["_fedify", "remoteDocument"]` by default.
171
- */
172
- prefix?: KvKey;
173
- /**
174
- * The per-URL cache rules in the array of `[urlPattern, duration]` pairs
175
- * where `urlPattern` is either a string, a {@link URL}, or
176
- * a {@link URLPattern} and `duration` is a {@link Temporal.Duration}.
177
- * The `duration` is allowed to be at most 30 days.
178
- *
179
- * By default, 5 minutes for all URLs.
180
- */
181
- rules?: [string | URL | URLPattern, Temporal.Duration][];
182
- }
183
- /**
184
- * Decorates a {@link DocumentLoader} with a cache backed by a {@link Deno.Kv}.
185
- * @param parameters The parameters for the cache.
186
- * @returns The decorated document loader which is cache-enabled.
187
- */
188
- declare function kvCache({
189
- loader,
190
- kv,
191
- prefix,
192
- rules
193
- }: KvCacheParameters): DocumentLoader;
194
- /**
195
- * Options for making `User-Agent` string.
196
- * @see {@link getUserAgent}
197
- * @since 1.3.0
198
- */
199
- interface GetUserAgentOptions {
200
- /**
201
- * An optional software name and version, e.g., `"Hollo/1.0.0"`.
202
- */
203
- software?: string | null;
204
- /**
205
- * An optional URL to append to the user agent string.
206
- * Usually the URL of the ActivityPub instance.
207
- */
208
- url?: string | URL | null;
209
- }
210
- /**
211
- * Gets the user agent string for the given application and URL.
212
- * @param options The options for making the user agent string.
213
- * @returns The user agent string.
214
- * @since 1.3.0
215
- */
216
- declare function getUserAgent({
217
- software,
218
- url
219
- }?: GetUserAgentOptions): string;
220
- //#endregion
221
- export { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, DocumentLoaderFactoryOptions, FetchError, GetDocumentLoaderOptions, GetUserAgentOptions, KvCacheParameters, RemoteDocument, fetchDocumentLoader, getDocumentLoader, getUserAgent, kvCache };
@@ -1,219 +0,0 @@
1
- import { KvKey, KvStore } from "./kv-63Cil1MD.cjs";
2
-
3
- //#region src/runtime/docloader.d.ts
4
- /**
5
- * A remote JSON-LD document and its context fetched by
6
- * a {@link DocumentLoader}.
7
- */
8
- interface RemoteDocument {
9
- /**
10
- * The URL of the context document.
11
- */
12
- contextUrl: string | null;
13
- /**
14
- * The fetched JSON-LD document.
15
- */
16
- document: unknown;
17
- /**
18
- * The URL of the fetched document.
19
- */
20
- documentUrl: string;
21
- }
22
- /**
23
- * Options for {@link DocumentLoader}.
24
- * @since 1.8.0
25
- */
26
- interface DocumentLoaderOptions {
27
- /**
28
- * An `AbortSignal` for cancellation.
29
- * @since 1.8.0
30
- */
31
- signal?: AbortSignal;
32
- }
33
- /**
34
- * A JSON-LD document loader that fetches documents from the Web.
35
- * @param url The URL of the document to load.
36
- * @param options The options for the document loader.
37
- * @returns The loaded remote document.
38
- */
39
- type DocumentLoader = (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>;
40
- /**
41
- * A factory function that creates a {@link DocumentLoader} with options.
42
- * @param options The options for the document loader.
43
- * @returns The document loader.
44
- * @since 1.4.0
45
- */
46
- type DocumentLoaderFactory = (options?: DocumentLoaderFactoryOptions) => DocumentLoader;
47
- /**
48
- * Options for {@link DocumentLoaderFactory}.
49
- * @see {@link DocumentLoaderFactory}
50
- * @see {@link AuthenticatedDocumentLoaderFactory}
51
- * @since 1.4.0
52
- */
53
- interface DocumentLoaderFactoryOptions {
54
- /**
55
- * Whether to allow fetching private network addresses.
56
- * Turned off by default.
57
- * @default `false``
58
- */
59
- allowPrivateAddress?: boolean;
60
- /**
61
- * Options for making `User-Agent` string.
62
- * If a string is given, it is used as the `User-Agent` header value.
63
- * If an object is given, it is passed to {@link getUserAgent} function.
64
- */
65
- userAgent?: GetUserAgentOptions | string;
66
- }
67
- /**
68
- * A factory function that creates an authenticated {@link DocumentLoader} for
69
- * a given identity. This is used for fetching documents that require
70
- * authentication.
71
- * @param identity The identity to create the document loader for.
72
- * The actor's key pair.
73
- * @param options The options for the document loader.
74
- * @returns The authenticated document loader.
75
- * @since 0.4.0
76
- */
77
- type AuthenticatedDocumentLoaderFactory = (identity: {
78
- keyId: URL;
79
- privateKey: CryptoKey;
80
- }, options?: DocumentLoaderFactoryOptions) => DocumentLoader;
81
- /**
82
- * Error thrown when fetching a JSON-LD document failed.
83
- */
84
- declare class FetchError extends Error {
85
- /**
86
- * The URL that failed to fetch.
87
- */
88
- url: URL;
89
- /**
90
- * Constructs a new `FetchError`.
91
- *
92
- * @param url The URL that failed to fetch.
93
- * @param message Error message.
94
- */
95
- constructor(url: URL | string, message?: string);
96
- }
97
- /**
98
- * Options for creating a request.
99
- * @internal
100
- */
101
-
102
- /**
103
- * Options for {@link getDocumentLoader}.
104
- * @since 1.3.0
105
- */
106
- interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
107
- /**
108
- * Whether to preload the frequently used contexts.
109
- */
110
- skipPreloadedContexts?: boolean;
111
- }
112
- /**
113
- * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
114
- *
115
- * The created loader preloads the below frequently used contexts by default
116
- * (unless `options.ignorePreloadedContexts` is set to `true`):
117
- *
118
- * - <https://www.w3.org/ns/activitystreams>
119
- * - <https://w3id.org/security/v1>
120
- * - <https://w3id.org/security/data-integrity/v1>
121
- * - <https://www.w3.org/ns/did/v1>
122
- * - <https://w3id.org/security/multikey/v1>
123
- * - <https://purl.archive.org/socialweb/webfinger>
124
- * - <http://schema.org/>
125
- * @param options Options for the document loader.
126
- * @returns The document loader.
127
- * @since 1.3.0
128
- */
129
- declare function getDocumentLoader({
130
- allowPrivateAddress,
131
- skipPreloadedContexts,
132
- userAgent
133
- }?: GetDocumentLoaderOptions): DocumentLoader;
134
- /**
135
- * A JSON-LD document loader that utilizes the browser's `fetch` API.
136
- *
137
- * This loader preloads the below frequently used contexts:
138
- *
139
- * - <https://www.w3.org/ns/activitystreams>
140
- * - <https://w3id.org/security/v1>
141
- * - <https://w3id.org/security/data-integrity/v1>
142
- * - <https://www.w3.org/ns/did/v1>
143
- * - <https://w3id.org/security/multikey/v1>
144
- * - <https://purl.archive.org/socialweb/webfinger>
145
- * - <http://schema.org/>
146
- * @param url The URL of the document to load.
147
- * @param allowPrivateAddress Whether to allow fetching private network
148
- * addresses. Turned off by default.
149
- * @returns The remote document.
150
- * @deprecated Use {@link getDocumentLoader} instead.
151
- */
152
- declare function fetchDocumentLoader(url: string, allowPrivateAddress?: boolean): Promise<RemoteDocument>;
153
- declare function fetchDocumentLoader(url: string, options?: DocumentLoaderOptions): Promise<RemoteDocument>;
154
- /**
155
- * The parameters for {@link kvCache} function.
156
- */
157
- interface KvCacheParameters {
158
- /**
159
- * The document loader to decorate with a cache.
160
- */
161
- loader: DocumentLoader;
162
- /**
163
- * The key–value store to use for backing the cache.
164
- */
165
- kv: KvStore;
166
- /**
167
- * The key prefix to use for namespacing the cache.
168
- * `["_fedify", "remoteDocument"]` by default.
169
- */
170
- prefix?: KvKey;
171
- /**
172
- * The per-URL cache rules in the array of `[urlPattern, duration]` pairs
173
- * where `urlPattern` is either a string, a {@link URL}, or
174
- * a {@link URLPattern} and `duration` is a {@link Temporal.Duration}.
175
- * The `duration` is allowed to be at most 30 days.
176
- *
177
- * By default, 5 minutes for all URLs.
178
- */
179
- rules?: [string | URL | URLPattern, Temporal.Duration][];
180
- }
181
- /**
182
- * Decorates a {@link DocumentLoader} with a cache backed by a {@link Deno.Kv}.
183
- * @param parameters The parameters for the cache.
184
- * @returns The decorated document loader which is cache-enabled.
185
- */
186
- declare function kvCache({
187
- loader,
188
- kv,
189
- prefix,
190
- rules
191
- }: KvCacheParameters): DocumentLoader;
192
- /**
193
- * Options for making `User-Agent` string.
194
- * @see {@link getUserAgent}
195
- * @since 1.3.0
196
- */
197
- interface GetUserAgentOptions {
198
- /**
199
- * An optional software name and version, e.g., `"Hollo/1.0.0"`.
200
- */
201
- software?: string | null;
202
- /**
203
- * An optional URL to append to the user agent string.
204
- * Usually the URL of the ActivityPub instance.
205
- */
206
- url?: string | URL | null;
207
- }
208
- /**
209
- * Gets the user agent string for the given application and URL.
210
- * @param options The options for making the user agent string.
211
- * @returns The user agent string.
212
- * @since 1.3.0
213
- */
214
- declare function getUserAgent({
215
- software,
216
- url
217
- }?: GetUserAgentOptions): string;
218
- //#endregion
219
- export { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, DocumentLoaderFactoryOptions, FetchError, GetDocumentLoaderOptions, GetUserAgentOptions, KvCacheParameters, RemoteDocument, fetchDocumentLoader, getDocumentLoader, getUserAgent, kvCache };
@@ -1,260 +0,0 @@
1
-
2
- import { Temporal } from "@js-temporal/polyfill";
3
- import { URLPattern } from "urlpattern-polyfill";
4
-
5
- import { deno_default, getDocumentLoader } from "./docloader-Czl3xV10.js";
6
- import { CryptographicKey, Object as Object$1, isActor } from "./actor-DoMcqXsW.js";
7
- import { getLogger } from "@logtape/logtape";
8
- import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
9
-
10
- //#region src/sig/key.ts
11
- /**
12
- * Checks if the given key is valid and supported. No-op if the key is valid,
13
- * otherwise throws an error.
14
- * @param key The key to check.
15
- * @param type Which type of key to check. If not specified, the key can be
16
- * either public or private.
17
- * @throws {TypeError} If the key is invalid or unsupported.
18
- */
19
- function validateCryptoKey(key, type) {
20
- if (type != null && key.type !== type) throw new TypeError(`The key is not a ${type} key.`);
21
- if (!key.extractable) throw new TypeError("The key is not extractable.");
22
- if (key.algorithm.name !== "RSASSA-PKCS1-v1_5" && key.algorithm.name !== "Ed25519") throw new TypeError("Currently only RSASSA-PKCS1-v1_5 and Ed25519 keys are supported. More algorithms will be added in the future!");
23
- if (key.algorithm.name === "RSASSA-PKCS1-v1_5") {
24
- const algorithm = key.algorithm;
25
- if (algorithm.hash.name !== "SHA-256") throw new TypeError("For compatibility with the existing Fediverse software (e.g., Mastodon), hash algorithm for RSASSA-PKCS1-v1_5 keys must be SHA-256.");
26
- }
27
- }
28
- /**
29
- * Generates a key pair which is appropriate for Fedify.
30
- * @param algorithm The algorithm to use. Currently only RSASSA-PKCS1-v1_5 and
31
- * Ed25519 are supported.
32
- * @returns The generated key pair.
33
- * @throws {TypeError} If the algorithm is unsupported.
34
- */
35
- function generateCryptoKeyPair(algorithm) {
36
- if (algorithm == null) getLogger([
37
- "fedify",
38
- "sig",
39
- "key"
40
- ]).warn("No algorithm specified. Using RSASSA-PKCS1-v1_5 by default, but it is recommended to specify the algorithm explicitly as the parameter will be required in the future.");
41
- if (algorithm == null || algorithm === "RSASSA-PKCS1-v1_5") return crypto.subtle.generateKey({
42
- name: "RSASSA-PKCS1-v1_5",
43
- modulusLength: 4096,
44
- publicExponent: new Uint8Array([
45
- 1,
46
- 0,
47
- 1
48
- ]),
49
- hash: "SHA-256"
50
- }, true, ["sign", "verify"]);
51
- else if (algorithm === "Ed25519") return crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"]);
52
- throw new TypeError("Unsupported algorithm: " + algorithm);
53
- }
54
- /**
55
- * Exports a key in JWK format.
56
- * @param key The key to export. Either public or private key.
57
- * @returns The exported key in JWK format. The key is suitable for
58
- * serialization and storage.
59
- * @throws {TypeError} If the key is invalid or unsupported.
60
- */
61
- async function exportJwk(key) {
62
- validateCryptoKey(key);
63
- const jwk = await crypto.subtle.exportKey("jwk", key);
64
- if (jwk.crv === "Ed25519") jwk.alg = "Ed25519";
65
- return jwk;
66
- }
67
- /**
68
- * Imports a key from JWK format.
69
- * @param jwk The key in JWK format.
70
- * @param type Which type of key to import, either `"public"` or `"private"`.
71
- * @returns The imported key.
72
- * @throws {TypeError} If the key is invalid or unsupported.
73
- */
74
- async function importJwk(jwk, type) {
75
- let key;
76
- if (jwk.kty === "RSA" && jwk.alg === "RS256") key = await crypto.subtle.importKey("jwk", jwk, {
77
- name: "RSASSA-PKCS1-v1_5",
78
- hash: "SHA-256"
79
- }, true, type === "public" ? ["verify"] : ["sign"]);
80
- else if (jwk.kty === "OKP" && jwk.crv === "Ed25519") {
81
- if (navigator?.userAgent === "Cloudflare-Workers") {
82
- jwk = { ...jwk };
83
- delete jwk.alg;
84
- }
85
- key = await crypto.subtle.importKey("jwk", jwk, "Ed25519", true, type === "public" ? ["verify"] : ["sign"]);
86
- } else throw new TypeError("Unsupported JWK format.");
87
- validateCryptoKey(key, type);
88
- return key;
89
- }
90
- /**
91
- * Fetches a {@link CryptographicKey} or {@link Multikey} from the given URL.
92
- * If the given URL contains an {@link Actor} object, it tries to find
93
- * the corresponding key in the `publicKey` or `assertionMethod` property.
94
- * @template T The type of the key to fetch. Either {@link CryptographicKey}
95
- * or {@link Multikey}.
96
- * @param keyId The URL of the key.
97
- * @param cls The class of the key to fetch. Either {@link CryptographicKey}
98
- * or {@link Multikey}.
99
- * @param options Options for fetching the key. See {@link FetchKeyOptions}.
100
- * @returns The fetched key or `null` if the key is not found.
101
- * @since 1.3.0
102
- */
103
- function fetchKey(keyId, cls, options = {}) {
104
- const tracerProvider = options.tracerProvider ?? trace.getTracerProvider();
105
- const tracer = tracerProvider.getTracer(deno_default.name, deno_default.version);
106
- keyId = typeof keyId === "string" ? new URL(keyId) : keyId;
107
- return tracer.startActiveSpan("activitypub.fetch_key", {
108
- kind: SpanKind.CLIENT,
109
- attributes: {
110
- "http.method": "GET",
111
- "url.full": keyId.href,
112
- "url.scheme": keyId.protocol.replace(/:$/, ""),
113
- "url.domain": keyId.hostname,
114
- "url.path": keyId.pathname,
115
- "url.query": keyId.search.replace(/^\?/, ""),
116
- "url.fragment": keyId.hash.replace(/^#/, "")
117
- }
118
- }, async (span) => {
119
- try {
120
- const result = await fetchKeyInternal(keyId, cls, options);
121
- span.setAttribute("activitypub.actor.key.cached", result.cached);
122
- return result;
123
- } catch (e) {
124
- span.setStatus({
125
- code: SpanStatusCode.ERROR,
126
- message: String(e)
127
- });
128
- throw e;
129
- } finally {
130
- span.end();
131
- }
132
- });
133
- }
134
- async function fetchKeyInternal(keyId, cls, { documentLoader, contextLoader, keyCache, tracerProvider } = {}) {
135
- const logger = getLogger([
136
- "fedify",
137
- "sig",
138
- "key"
139
- ]);
140
- const cacheKey = typeof keyId === "string" ? new URL(keyId) : keyId;
141
- keyId = typeof keyId === "string" ? keyId : keyId.href;
142
- if (keyCache != null) {
143
- const cachedKey = await keyCache.get(cacheKey);
144
- if (cachedKey instanceof cls && cachedKey.publicKey != null) {
145
- logger.debug("Key {keyId} found in cache.", { keyId });
146
- return {
147
- key: cachedKey,
148
- cached: true
149
- };
150
- } else if (cachedKey === null) {
151
- logger.debug("Entry {keyId} found in cache, but it is unavailable.", { keyId });
152
- return {
153
- key: null,
154
- cached: true
155
- };
156
- }
157
- }
158
- logger.debug("Fetching key {keyId} to verify signature...", { keyId });
159
- let document;
160
- try {
161
- const remoteDocument = await (documentLoader ?? getDocumentLoader())(keyId);
162
- document = remoteDocument.document;
163
- } catch (_) {
164
- logger.debug("Failed to fetch key {keyId}.", { keyId });
165
- await keyCache?.set(cacheKey, null);
166
- return {
167
- key: null,
168
- cached: false
169
- };
170
- }
171
- let object;
172
- try {
173
- object = await Object$1.fromJsonLd(document, {
174
- documentLoader,
175
- contextLoader,
176
- tracerProvider
177
- });
178
- } catch (e) {
179
- if (!(e instanceof TypeError)) throw e;
180
- try {
181
- object = await cls.fromJsonLd(document, {
182
- documentLoader,
183
- contextLoader,
184
- tracerProvider
185
- });
186
- } catch (e$1) {
187
- if (e$1 instanceof TypeError) {
188
- logger.debug("Failed to verify; key {keyId} returned an invalid object.", { keyId });
189
- await keyCache?.set(cacheKey, null);
190
- return {
191
- key: null,
192
- cached: false
193
- };
194
- }
195
- throw e$1;
196
- }
197
- }
198
- let key = null;
199
- if (object instanceof cls) key = object;
200
- else if (isActor(object)) {
201
- const keys = cls === CryptographicKey ? object.getPublicKeys({
202
- documentLoader,
203
- contextLoader,
204
- tracerProvider
205
- }) : object.getAssertionMethods({
206
- documentLoader,
207
- contextLoader,
208
- tracerProvider
209
- });
210
- let length = 0;
211
- let lastKey = null;
212
- for await (const k of keys) {
213
- length++;
214
- lastKey = k;
215
- if (k.id?.href === keyId) {
216
- key = k;
217
- break;
218
- }
219
- }
220
- const keyIdUrl = new URL(keyId);
221
- if (key == null && keyIdUrl.hash === "" && length === 1) key = lastKey;
222
- if (key == null) {
223
- logger.debug("Failed to verify; object {keyId} returned an {actorType}, but has no key matching {keyId}.", {
224
- keyId,
225
- actorType: object.constructor.name
226
- });
227
- await keyCache?.set(cacheKey, null);
228
- return {
229
- key: null,
230
- cached: false
231
- };
232
- }
233
- } else {
234
- logger.debug("Failed to verify; key {keyId} returned an invalid object.", { keyId });
235
- await keyCache?.set(cacheKey, null);
236
- return {
237
- key: null,
238
- cached: false
239
- };
240
- }
241
- if (key.publicKey == null) {
242
- logger.debug("Failed to verify; key {keyId} has no publicKeyPem field.", { keyId });
243
- await keyCache?.set(cacheKey, null);
244
- return {
245
- key: null,
246
- cached: false
247
- };
248
- }
249
- if (keyCache != null) {
250
- await keyCache.set(cacheKey, key);
251
- logger.debug("Key {keyId} cached.", { keyId });
252
- }
253
- return {
254
- key,
255
- cached: false
256
- };
257
- }
258
-
259
- //#endregion
260
- export { exportJwk, fetchKey, generateCryptoKeyPair, importJwk, validateCryptoKey };
@@ -1,10 +0,0 @@
1
-
2
- import { Temporal } from "@js-temporal/polyfill";
3
- import { URLPattern } from "urlpattern-polyfill";
4
-
5
- import "./docloader-Czl3xV10.js";
6
- import "./actor-DoMcqXsW.js";
7
- import "./lookup-Dhm78GlK.js";
8
- import { exportJwk, fetchKey, generateCryptoKeyPair, importJwk, validateCryptoKey } from "./key-BNJQQm3h.js";
9
-
10
- export { validateCryptoKey };