@fedify/fedify 0.10.0-dev.207 → 0.10.0-dev.211

package/CHANGES.md

@@ -106,6 +106,8 @@ To be released.
      -  The `Context.sendActivity()` method's first parameter now accepts
         `SenderKeyPair[]` as well.
 
+ -  Added `Question` class to Activity Vocabulary API.
+
  -  Added `context` option to `Object.toJsonLd()` method.  This applies to
     any subclasses of the `Object` class too.
 
@@ -119,12 +121,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,63 @@
+<!-- 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)
+ -  [`Question`](https://jsr.io/@fedify/fedify/doc/vocab/~/Question)
+ -  [`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/vocab/question.yaml

@@ -0,0 +1,43 @@
+$schema: ../codegen/schema.yaml
+name: Question
+uri: "https://www.w3.org/ns/activitystreams#Question"
+extends: "https://www.w3.org/ns/activitystreams#IntransitiveActivity"
+entity: true
+description: |
+  Represents a question being asked.  Question objects are an extension of
+  {@link IntransitiveActivity}.  That is, the Question object is an Activity,
+  but the direct object is the question itself and therefore it would not
+  contain an `object` property.
+
+  Either of the `anyOf` and `oneOf` properties *may* be used to express possible
+  answers, but a Question object *must not* have both properties. 
+defaultContext:
+- "https://www.w3.org/ns/activitystreams"
+- "https://w3id.org/security/data-integrity/v1"
+- toot: "http://joinmastodon.org/ns#"
+  sensitive: "as:sensitive"
+  Emoji: "toot:Emoji"
+  Hashtag: "as:Hashtag"
+
+properties:
+- pluralName: exclusiveOptions
+  singularName: exclusiveOption
+  singularAccessor: false
+  uri: "https://www.w3.org/ns/activitystreams#oneOf"
+  description: |
+    Identifies an exclusive option for a Question.  Use of `exclusiveOptions`
+    implies that the Question can have only a single answer.  To indicate that
+    a Question can have multiple answers, use `inclusiveOptions`. 
+  range:
+  - "https://www.w3.org/ns/activitystreams#Object"
+
+- pluralName: inclusiveOptions
+  singularName: inclusiveOption
+  singularAccessor: false
+  uri: "https://www.w3.org/ns/activitystreams#anyOf"
+  description: |
+    Identifies an inclusive option for a Question.  Use of `inclusiveOptions`
+    implies that the Question can have multiple answers.  To indicate that
+    a Question can have only one answer, use `exclusiveOptions`.
+  range:
+  - "https://www.w3.org/ns/activitystreams#Object"

package/esm/vocab/vocab.js

@@ -2198,6 +2198,10 @@ export class Object {
                 delete values["@type"];
                 return await IntransitiveActivity.fromJsonLd(values, options);
             }
+            if (values["@type"].includes("https://www.w3.org/ns/activitystreams#Question")) {
+                delete values["@type"];
+                return await Question.fromJsonLd(values, options);
+            }
             if (values["@type"].includes("https://www.w3.org/ns/activitystreams#Like")) {
                 delete values["@type"];
                 return await Like.fromJsonLd(values, options);
@@ -2334,6 +2338,7 @@ export class Object {
                     "https://www.w3.org/ns/activitystreams#Ignore",
                     "https://www.w3.org/ns/activitystreams#Block",
                     "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                    "https://www.w3.org/ns/activitystreams#Question",
                     "https://www.w3.org/ns/activitystreams#Like",
                     "https://www.w3.org/ns/activitystreams#Reject",
                     "https://www.w3.org/ns/activitystreams#Remove",
@@ -2471,6 +2476,7 @@ export class Object {
                     "https://www.w3.org/ns/activitystreams#Ignore",
                     "https://www.w3.org/ns/activitystreams#Block",
                     "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                    "https://www.w3.org/ns/activitystreams#Question",
                     "https://www.w3.org/ns/activitystreams#Like",
                     "https://www.w3.org/ns/activitystreams#Reject",
                     "https://www.w3.org/ns/activitystreams#Remove",
@@ -2563,6 +2569,7 @@ export class Object {
                     "https://www.w3.org/ns/activitystreams#Ignore",
                     "https://www.w3.org/ns/activitystreams#Block",
                     "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                    "https://www.w3.org/ns/activitystreams#Question",
                     "https://www.w3.org/ns/activitystreams#Like",
                     "https://www.w3.org/ns/activitystreams#Reject",
                     "https://www.w3.org/ns/activitystreams#Remove",
@@ -2655,6 +2662,7 @@ export class Object {
                     "https://www.w3.org/ns/activitystreams#Ignore",
                     "https://www.w3.org/ns/activitystreams#Block",
                     "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                    "https://www.w3.org/ns/activitystreams#Question",
                     "https://www.w3.org/ns/activitystreams#Like",
                     "https://www.w3.org/ns/activitystreams#Reject",
                     "https://www.w3.org/ns/activitystreams#Remove",
@@ -2723,6 +2731,7 @@ export class Object {
                     "https://www.w3.org/ns/activitystreams#Ignore",
                     "https://www.w3.org/ns/activitystreams#Block",
                     "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                    "https://www.w3.org/ns/activitystreams#Question",
                     "https://www.w3.org/ns/activitystreams#Like",
                     "https://www.w3.org/ns/activitystreams#Reject",
                     "https://www.w3.org/ns/activitystreams#Remove",
@@ -2799,6 +2808,7 @@ export class Object {
                         "https://www.w3.org/ns/activitystreams#Ignore",
                         "https://www.w3.org/ns/activitystreams#Block",
                         "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                        "https://www.w3.org/ns/activitystreams#Question",
                         "https://www.w3.org/ns/activitystreams#Like",
                         "https://www.w3.org/ns/activitystreams#Reject",
                         "https://www.w3.org/ns/activitystreams#Remove",
@@ -2902,6 +2912,7 @@ export class Object {
                     "https://www.w3.org/ns/activitystreams#Ignore",
                     "https://www.w3.org/ns/activitystreams#Block",
                     "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                    "https://www.w3.org/ns/activitystreams#Question",
                     "https://www.w3.org/ns/activitystreams#Like",
                     "https://www.w3.org/ns/activitystreams#Reject",
                     "https://www.w3.org/ns/activitystreams#Remove",
@@ -5195,6 +5206,10 @@ export class Activity extends Object {
                 delete values["@type"];
                 return await IntransitiveActivity.fromJsonLd(values, options);
             }
+            if (values["@type"].includes("https://www.w3.org/ns/activitystreams#Question")) {
+                delete values["@type"];
+                return await Question.fromJsonLd(values, options);
+            }
             if (values["@type"].includes("https://www.w3.org/ns/activitystreams#Like")) {
                 delete values["@type"];
                 return await Like.fromJsonLd(values, options);
@@ -8136,6 +8151,7 @@ export class Collection extends Object {
                     "https://www.w3.org/ns/activitystreams#Ignore",
                     "https://www.w3.org/ns/activitystreams#Block",
                     "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                    "https://www.w3.org/ns/activitystreams#Question",
                     "https://www.w3.org/ns/activitystreams#Like",
                     "https://www.w3.org/ns/activitystreams#Reject",
                     "https://www.w3.org/ns/activitystreams#Remove",
@@ -11532,6 +11548,7 @@ export class Link {
                         "https://www.w3.org/ns/activitystreams#Ignore",
                         "https://www.w3.org/ns/activitystreams#Block",
                         "https://www.w3.org/ns/activitystreams#IntransitiveActivity",
+                        "https://www.w3.org/ns/activitystreams#Question",
                         "https://www.w3.org/ns/activitystreams#Like",
                         "https://www.w3.org/ns/activitystreams#Reject",
                         "https://www.w3.org/ns/activitystreams#Remove",
@@ -11994,6 +12011,10 @@ export class IntransitiveActivity extends Activity {
                 (expanded[0] ?? {});
         }
         if ("@type" in values) {
+            if (values["@type"].includes("https://www.w3.org/ns/activitystreams#Question")) {
+                delete values["@type"];
+                return await Question.fromJsonLd(values, options);
+            }
             if (!values["@type"].includes("https://www.w3.org/ns/activitystreams#IntransitiveActivity")) {
                 throw new TypeError("Invalid type: " + values["@type"]);
             }
@@ -15835,6 +15856,296 @@ export class Profile extends Object {
         return "Profile " + inspect(proxy, options);
     }
 }
+/** Represents a question being asked.  Question objects are an extension of
+ * {@link IntransitiveActivity}.  That is, the Question object is an Activity,
+ * but the direct object is the question itself and therefore it would not
+ * contain an `object` property.
+ *
+ * Either of the `anyOf` and `oneOf` properties *may* be used to express possible
+ * answers, but a Question object *must not* have both properties.
+ */
+export class Question extends IntransitiveActivity {
+    /**
+     * The type URI of {@link Question}: `https://www.w3.org/ns/activitystreams#Question`.
+     */
+    static get typeId() {
+        return new URL("https://www.w3.org/ns/activitystreams#Question");
+    }
+    #_2N5scKaVEcdYHFmfKYYacAwUhUgQ = [];
+    #_2mV6isMTPRKbWdLCjcpiEysq5dAY = [];
+    /**
+     * Constructs a new instance of Question with the given values.
+     * @param values The values to initialize the instance with.
+     * @param options The options to use for initialization.
+     */
+    constructor(values, { documentLoader, contextLoader, } = {}) {
+        super(values, { documentLoader, contextLoader });
+        if ("exclusiveOptions" in values && values.exclusiveOptions != null) {
+            this.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ = values.exclusiveOptions;
+        }
+        if ("inclusiveOptions" in values && values.inclusiveOptions != null) {
+            this.#_2mV6isMTPRKbWdLCjcpiEysq5dAY = values.inclusiveOptions;
+        }
+    }
+    /**
+     * Clones this instance, optionally updating it with the given values.
+     * @param values The values to update the clone with.
+     * @options The options to use for cloning.
+     * @returns The cloned instance.
+     */
+    clone(values = {}, options = {}) {
+        const clone = super.clone(values, options);
+        clone.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ = this.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ;
+        if ("exclusiveOptions" in values && values.exclusiveOptions != null) {
+            clone.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ = values.exclusiveOptions;
+        }
+        clone.#_2mV6isMTPRKbWdLCjcpiEysq5dAY = this.#_2mV6isMTPRKbWdLCjcpiEysq5dAY;
+        if ("inclusiveOptions" in values && values.inclusiveOptions != null) {
+            clone.#_2mV6isMTPRKbWdLCjcpiEysq5dAY = values.inclusiveOptions;
+        }
+        return clone;
+    }
+    async #fetchExclusiveOption(url, options = {}) {
+        const documentLoader = options.documentLoader ?? this._documentLoader ??
+            fetchDocumentLoader;
+        const contextLoader = options.contextLoader ?? this._contextLoader ??
+            fetchDocumentLoader;
+        const { document } = await documentLoader(url.href);
+        try {
+            return await Object.fromJsonLd(document, { documentLoader, contextLoader });
+        }
+        catch (e) {
+            if (!(e instanceof TypeError))
+                throw e;
+        }
+        throw new TypeError("Expected an object of any type of: " +
+            ["https://www.w3.org/ns/activitystreams#Object"].join(", "));
+    }
+    /**
+     * Similar to
+     * {@link Question.getExclusiveOptions},
+     * but returns their `@id`s instead of the objects themselves.
+     */
+    get exclusiveOptionIds() {
+        return this.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ.map((v) => v instanceof URL ? v : v.id).filter((id) => id !== null);
+    }
+    /** Identifies an exclusive option for a Question.  Use of `exclusiveOptions`
+     * implies that the Question can have only a single answer.  To indicate that
+     * a Question can have multiple answers, use `inclusiveOptions`.
+     */
+    async *getExclusiveOptions(options = {}) {
+        const vs = this.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ;
+        for (let i = 0; i < vs.length; i++) {
+            const v = vs[i];
+            if (v instanceof URL) {
+                const fetched = await this.#fetchExclusiveOption(v, options);
+                vs[i] = fetched;
+                yield fetched;
+                continue;
+            }
+            yield v;
+        }
+    }
+    async #fetchInclusiveOption(url, options = {}) {
+        const documentLoader = options.documentLoader ?? this._documentLoader ??
+            fetchDocumentLoader;
+        const contextLoader = options.contextLoader ?? this._contextLoader ??
+            fetchDocumentLoader;
+        const { document } = await documentLoader(url.href);
+        try {
+            return await Object.fromJsonLd(document, { documentLoader, contextLoader });
+        }
+        catch (e) {
+            if (!(e instanceof TypeError))
+                throw e;
+        }
+        throw new TypeError("Expected an object of any type of: " +
+            ["https://www.w3.org/ns/activitystreams#Object"].join(", "));
+    }
+    /**
+     * Similar to
+     * {@link Question.getInclusiveOptions},
+     * but returns their `@id`s instead of the objects themselves.
+     */
+    get inclusiveOptionIds() {
+        return this.#_2mV6isMTPRKbWdLCjcpiEysq5dAY.map((v) => v instanceof URL ? v : v.id).filter((id) => id !== null);
+    }
+    /** Identifies an inclusive option for a Question.  Use of `inclusiveOptions`
+     * implies that the Question can have multiple answers.  To indicate that
+     * a Question can have only one answer, use `exclusiveOptions`.
+     */
+    async *getInclusiveOptions(options = {}) {
+        const vs = this.#_2mV6isMTPRKbWdLCjcpiEysq5dAY;
+        for (let i = 0; i < vs.length; i++) {
+            const v = vs[i];
+            if (v instanceof URL) {
+                const fetched = await this.#fetchInclusiveOption(v, options);
+                vs[i] = fetched;
+                yield fetched;
+                continue;
+            }
+            yield v;
+        }
+    }
+    /**
+     * Converts this object to a JSON-LD structure.
+     * @returns The JSON-LD representation of this object.
+     */
+    async toJsonLd(options = {}) {
+        options = {
+            ...options,
+            contextLoader: options.contextLoader ?? fetchDocumentLoader,
+        };
+        // deno-lint-ignore no-unused-vars prefer-const
+        let array;
+        const baseValues = await super.toJsonLd({
+            ...options,
+            expand: true,
+        });
+        const values = baseValues[0];
+        array = [];
+        for (const v of this.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ) {
+            const element = v instanceof URL
+                ? { "@id": v.href }
+                : await v.toJsonLd(options);
+            array.push(element);
+        }
+        if (array.length > 0) {
+            values["https://www.w3.org/ns/activitystreams#oneOf"] = array;
+        }
+        array = [];
+        for (const v of this.#_2mV6isMTPRKbWdLCjcpiEysq5dAY) {
+            const element = v instanceof URL
+                ? { "@id": v.href }
+                : await v.toJsonLd(options);
+            array.push(element);
+        }
+        if (array.length > 0) {
+            values["https://www.w3.org/ns/activitystreams#anyOf"] = array;
+        }
+        values["@type"] = ["https://www.w3.org/ns/activitystreams#Question"];
+        if (this.id)
+            values["@id"] = this.id.href;
+        if (options.expand) {
+            return await jsonld.expand(values, { documentLoader: options.contextLoader });
+        }
+        return await jsonld.compact(values, options.context ??
+            [
+                "https://www.w3.org/ns/activitystreams",
+                "https://w3id.org/security/data-integrity/v1",
+                {
+                    "toot": "http://joinmastodon.org/ns#",
+                    "sensitive": "as:sensitive",
+                    "Emoji": "toot:Emoji",
+                    "Hashtag": "as:Hashtag",
+                },
+            ], { documentLoader: options.contextLoader });
+    }
+    /**
+     * Converts a JSON-LD structure to an object of this type.
+     * @param json The JSON-LD structure to convert.
+     * @returns The object of this type.
+     * @throws {TypeError} If the given `json` is invalid.
+     */
+    static async fromJsonLd(json, options = {}) {
+        if (typeof json === "undefined") {
+            throw new TypeError("Invalid JSON-LD: undefined.");
+        }
+        else if (json === null)
+            throw new TypeError("Invalid JSON-LD: null.");
+        options = {
+            ...options,
+            documentLoader: options.documentLoader ?? fetchDocumentLoader,
+            contextLoader: options.contextLoader ?? fetchDocumentLoader,
+        };
+        // deno-lint-ignore no-explicit-any
+        let values;
+        if (globalThis.Object.keys(json).length == 0) {
+            values = {};
+        }
+        else {
+            const expanded = await jsonld.expand(json, {
+                documentLoader: options.contextLoader,
+                keepFreeFloatingNodes: true,
+            });
+            values =
+                // deno-lint-ignore no-explicit-any
+                (expanded[0] ?? {});
+        }
+        if ("@type" in values) {
+            if (!values["@type"].includes("https://www.w3.org/ns/activitystreams#Question")) {
+                throw new TypeError("Invalid type: " + values["@type"]);
+            }
+        }
+        const instance = await super.fromJsonLd(values, options);
+        if (!(instance instanceof Question)) {
+            throw new TypeError("Unexpected type: " + instance.constructor.name);
+        }
+        const _2N5scKaVEcdYHFmfKYYacAwUhUgQ = [];
+        for (const v of values["https://www.w3.org/ns/activitystreams#oneOf"] ?? []) {
+            if (v == null)
+                continue;
+            if (typeof v === "object" && "@id" in v && !("@type" in v) &&
+                globalThis.Object.keys(v).length === 1) {
+                _2N5scKaVEcdYHFmfKYYacAwUhUgQ.push(new URL(v["@id"]));
+                continue;
+            }
+            _2N5scKaVEcdYHFmfKYYacAwUhUgQ.push(await Object.fromJsonLd(v, options));
+        }
+        instance.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ = _2N5scKaVEcdYHFmfKYYacAwUhUgQ;
+        const _2mV6isMTPRKbWdLCjcpiEysq5dAY = [];
+        for (const v of values["https://www.w3.org/ns/activitystreams#anyOf"] ?? []) {
+            if (v == null)
+                continue;
+            if (typeof v === "object" && "@id" in v && !("@type" in v) &&
+                globalThis.Object.keys(v).length === 1) {
+                _2mV6isMTPRKbWdLCjcpiEysq5dAY.push(new URL(v["@id"]));
+                continue;
+            }
+            _2mV6isMTPRKbWdLCjcpiEysq5dAY.push(await Object.fromJsonLd(v, options));
+        }
+        instance.#_2mV6isMTPRKbWdLCjcpiEysq5dAY = _2mV6isMTPRKbWdLCjcpiEysq5dAY;
+        return instance;
+    }
+    _getCustomInspectProxy() {
+        const proxy = super._getCustomInspectProxy();
+        const _2N5scKaVEcdYHFmfKYYacAwUhUgQ = this.#_2N5scKaVEcdYHFmfKYYacAwUhUgQ
+            // deno-lint-ignore no-explicit-any
+            .map((v) => v instanceof URL
+            ? {
+                [Symbol.for("Deno.customInspect")]: (inspect, options) => "URL " + inspect(v.href, options),
+                [Symbol.for("nodejs.util.inspect.custom")]: (_depth, options, inspect) => "URL " + inspect(v.href, options),
+            }
+            : v);
+        if (_2N5scKaVEcdYHFmfKYYacAwUhUgQ.length > 1 ||
+            !("exclusiveOption" in proxy) &&
+                _2N5scKaVEcdYHFmfKYYacAwUhUgQ.length > 0) {
+            proxy.exclusiveOptions = _2N5scKaVEcdYHFmfKYYacAwUhUgQ;
+        }
+        const _2mV6isMTPRKbWdLCjcpiEysq5dAY = this.#_2mV6isMTPRKbWdLCjcpiEysq5dAY
+            // deno-lint-ignore no-explicit-any
+            .map((v) => v instanceof URL
+            ? {
+                [Symbol.for("Deno.customInspect")]: (inspect, options) => "URL " + inspect(v.href, options),
+                [Symbol.for("nodejs.util.inspect.custom")]: (_depth, options, inspect) => "URL " + inspect(v.href, options),
+            }
+            : v);
+        if (_2mV6isMTPRKbWdLCjcpiEysq5dAY.length > 1 ||
+            !("inclusiveOption" in proxy) &&
+                _2mV6isMTPRKbWdLCjcpiEysq5dAY.length > 0) {
+            proxy.inclusiveOptions = _2mV6isMTPRKbWdLCjcpiEysq5dAY;
+        }
+        return proxy;
+    }
+    [Symbol.for("Deno.customInspect")](inspect, options) {
+        const proxy = this._getCustomInspectProxy();
+        return "Question " + inspect(proxy, options);
+    }
+    [Symbol.for("nodejs.util.inspect.custom")](_depth, options, inspect) {
+        const proxy = this._getCustomInspectProxy();
+        return "Question " + inspect(proxy, options);
+    }
+}
 /** Indicates that the `actor` is rejecting the `object`.  The `target` and
  * `origin` typically have no defined meaning.
  */

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.207+1573cf43",
+  "version": "0.10.0-dev.211+aaa16745",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",

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"}