@fedify/fedify 0.10.0-dev.206 → 0.10.0-dev.209

package/CHANGES.md

@@ -119,12 +119,16 @@ To be released.
      -  Ephemeral actors now have the following properties: `summary`,
         `following`, `followers`, `outbox`, `manuallyApprovesFollowers`, and
         `url`.
+     -  Improved the compatibility of the `fedify inbox` command with Misskey
+        and Mitra.
 
  -  Added more log messages using the [LogTape] library.  Currently the below
     logger categories are used:
 
      -  `["fedify", "sig", "proof"]`
      -  `["fedify", "sig", "key"]`
+     -  `["fedify", "vocab", "lookup"]`
+     -  `["fedify", "webfinger", "lookup"]`
 
 [#54]: https://github.com/dahlia/fedify/issues/54
 [#55]: https://github.com/dahlia/fedify/issues/55

package/FEDERATION.md

@@ -0,0 +1,62 @@
+<!-- deno-fmt-ignore-file -->
+
+Federation
+==========
+
+Supported federation protocols and standards
+--------------------------------------------
+
+ -  [ActivityPub] (S2S)
+ -  [WebFinger]
+ -  [HTTP Signatures]
+ -  [NodeInfo]
+
+[ActivityPub]: https://www.w3.org/TR/activitypub/
+[WebFinger]: https://datatracker.ietf.org/doc/html/rfc7033
+[HTTP Signatures]: https://datatracker.ietf.org/doc/html/draft-cavage-http-signatures
+[NodeInfo]: https://nodeinfo.diaspora.software/
+
+
+Supported FEPs
+--------------
+
+ -  [FEP-67ff][]: FEDERATION.md
+ -  [FEP-8fcf][]: Followers collection synchronization across servers
+ -  [FEP-f1d5][]: NodeInfo in Fediverse Software
+ -  [FEP-8b32][]: Object Integrity Proofs
+ -  [FEP-521a][]: Representing actor's public keys
+ -  [FEP-5feb][]: Search indexing consent for actors
+ -  [FEP-c7d3][]: Ownership
+
+[FEP-67ff]: https://codeberg.org/fediverse/fep/src/branch/main/fep/67ff/fep-67ff.md
+[FEP-8fcf]: https://codeberg.org/fediverse/fep/src/branch/main/fep/8fcf/fep-8fcf.md
+[FEP-f1d5]: https://codeberg.org/fediverse/fep/src/branch/main/fep/f1d5/fep-f1d5.md
+[FEP-8b32]: https://codeberg.org/fediverse/fep/src/branch/main/fep/8b32/fep-8b32.md
+[FEP-521a]: https://codeberg.org/fediverse/fep/src/branch/main/fep/521a/fep-521a.md
+[FEP-5feb]: https://codeberg.org/fediverse/fep/src/branch/main/fep/5feb/fep-5feb.md
+[FEP-c7d3]: https://codeberg.org/silverpill/feps/src/branch/main/c7d3/fep-c7d3.md
+
+
+ActivityPub
+-----------
+
+Since Fedify is a framework, what activity types it uses is up to
+the application developers.  However, Fedify provides a set of
+activity types that are commonly used in the Fediverse.  The following
+lists the activity types that Fedify provides:
+
+ -  [`Accept`](https://jsr.io/@fedify/fedify/doc/vocab/~/Accept)
+ -  [`Add`](https://jsr.io/@fedify/fedify/doc/vocab/~/Add)
+ -  [`Announce`](https://jsr.io/@fedify/fedify/doc/vocab/~/Announce)
+ -  [`Block`](https://jsr.io/@fedify/fedify/doc/vocab/~/Block)
+ -  [`Create`](https://jsr.io/@fedify/fedify/doc/vocab/~/Create)
+ -  [`Delete`](https://jsr.io/@fedify/fedify/doc/vocab/~/Delete)
+ -  [`Dislike`](https://jsr.io/@fedify/fedify/doc/vocab/~/Dislike)
+ -  [`Flag`](https://jsr.io/@fedify/fedify/doc/vocab/~/Flag)
+ -  [`Follow`](https://jsr.io/@fedify/fedify/doc/vocab/~/Follow)
+ -  [`Ignore`](https://jsr.io/@fedify/fedify/doc/vocab/~/Ignore)
+ -  [`Like`](https://jsr.io/@fedify/fedify/doc/vocab/~/Like)
+ -  [`Reject`](https://jsr.io/@fedify/fedify/doc/vocab/~/Reject)
+ -  [`Remove`](https://jsr.io/@fedify/fedify/doc/vocab/~/Remove)
+ -  [`Undo`](https://jsr.io/@fedify/fedify/doc/vocab/~/Undo)
+ -  [`Update`](https://jsr.io/@fedify/fedify/doc/vocab/~/Update)

package/esm/vocab/lookup.js

@@ -1,6 +1,8 @@
+import { getLogger } from "@logtape/logtape";
 import { fetchDocumentLoader, } from "../runtime/docloader.js";
 import { lookupWebFinger } from "../webfinger/lookup.js";
 import { Object } from "./vocab.js";
+const logger = getLogger(["fedify", "vocab", "lookup"]);
 const handleRegexp = /^@?((?:[-A-Za-z0-9._~!$&'()*+,;=]|%[A-Fa-f0-9]{2})+)@([^@]+)$/;
 /**
  * Looks up an ActivityStreams object by its URI (including `acct:` URIs)
@@ -48,8 +50,8 @@ export async function lookupObject(identifier, options = {}) {
             const remoteDoc = await documentLoader(identifier.href);
             document = remoteDoc.document;
         }
-        catch (_) {
-            // Silently ignore errors.
+        catch (error) {
+            logger.debug("Failed to fetch remote document:\n{error}", { error });
         }
     }
     if (document == null) {
@@ -65,8 +67,8 @@ export async function lookupObject(identifier, options = {}) {
                 document = remoteDoc.document;
                 break;
             }
-            catch (_) {
-                // Silently ignore errors.
+            catch (error) {
+                logger.debug("Failed to fetch remote document:\n{error}", { error });
                 continue;
             }
         }
@@ -79,9 +81,11 @@ export async function lookupObject(identifier, options = {}) {
             contextLoader: options.contextLoader,
         });
     }
-    catch (e) {
-        if (e instanceof TypeError)
+    catch (error) {
+        if (error instanceof TypeError) {
+            logger.debug("Failed to parse JSON-LD document:\n{error}", { error });
             return null;
-        throw e;
+        }
+        throw error;
     }
 }

package/esm/webfinger/lookup.js

@@ -1,3 +1,5 @@
+import { getLogger } from "@logtape/logtape";
+const logger = getLogger(["fedify", "webfinger", "lookup"]);
 /**
  * Looks up a WebFinger resource.
  * @param resource The resource URL to look up.
@@ -22,6 +24,7 @@ export async function lookupWebFinger(resource) {
     let url = new URL(`https://${server}/.well-known/webfinger`);
     url.searchParams.set("resource", resource.href);
     while (true) {
+        logger.debug("Fetching WebFinger resource descriptor from {url}...", { url: url.href });
         const response = await fetch(url, {
             headers: { Accept: "application/jrd+json" },
             redirect: "manual",
@@ -31,14 +34,22 @@ export async function lookupWebFinger(resource) {
             url = new URL(response.headers.get("Location"));
             continue;
         }
-        if (!response.ok)
+        if (!response.ok) {
+            logger.debug("Failed to fetch WebFinger resource descriptor: {status} {statusText}.", {
+                url: url.href,
+                status: response.status,
+                statusText: response.statusText,
+            });
             return null;
+        }
         try {
             return await response.json();
         }
         catch (e) {
-            if (e instanceof SyntaxError)
+            if (e instanceof SyntaxError) {
+                logger.debug("Failed to parse WebFinger resource descriptor as JSON: {error}", { error: e });
                 return null;
+            }
             throw e;
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "0.10.0-dev.206+b0c76baf",
+  "version": "0.10.0-dev.209+841d94c5",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",

package/types/testing/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/testing/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAC;AASjD,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;AACjE,wBAAgB,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxD,IAAI,CAAC;AACR,wBAAgB,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,MAAM,CAAC,EACzD,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxD,IAAI,CAAC"}

package/types/vocab/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/vocab/lookup.ts"],"names":[],"mappings":";AAAA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GAAG,GAAG,EACxB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8CxB"}
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/vocab/lookup.ts"],"names":[],"mappings":";AACA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIpC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GAAG,GAAG,EACxB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiDxB"}

package/types/webfinger/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/webfinger/lookup.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,GAAG,GAAG,MAAM,GACrB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiCpC"}
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/webfinger/lookup.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,GAAG,GAAG,MAAM,GACrB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAqDpC"}