@fedify/fedify 0.10.0-dev.209 → 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.
 

package/FEDERATION.md

@@ -56,6 +56,7 @@ lists the activity types that Fedify provides:
  -  [`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)

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/package.json

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

package/types/vocab/vocab.d.ts

@@ -7013,6 +7013,192 @@ export declare class Profile extends Object {
     }): Promise<Profile>;
     protected _getCustomInspectProxy(): Record<string, unknown>;
 }
+/** 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 declare class Question extends IntransitiveActivity {
+    #private;
+    /**
+     * The type URI of {@link Question}: `https://www.w3.org/ns/activitystreams#Question`.
+     */
+    static get typeId(): URL;
+    /**
+     * 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: {
+        id?: URL | null;
+        attachments?: (Object | Link | PropertyValue | URL)[];
+        attribution?: Application | Group | Organization | Person | Service | URL | null;
+        attributions?: (Application | Group | Organization | Person | Service | URL)[];
+        audience?: Object | URL | null;
+        audiences?: (Object | URL)[];
+        content?: string | LanguageString | null;
+        contents?: (string | LanguageString)[];
+        contexts?: (Object | Link | URL)[];
+        name?: string | LanguageString | null;
+        names?: (string | LanguageString)[];
+        endTime?: dntShim.Temporal.Instant | null;
+        generators?: (Object | Link | URL)[];
+        icon?: Image | URL | null;
+        icons?: (Image | URL)[];
+        image?: Image | URL | null;
+        images?: (Image | URL)[];
+        replyTarget?: Object | Link | URL | null;
+        replyTargets?: (Object | Link | URL)[];
+        location?: Object | Link | URL | null;
+        locations?: (Object | Link | URL)[];
+        preview?: Link | Object | URL | null;
+        previews?: (Link | Object | URL)[];
+        published?: dntShim.Temporal.Instant | null;
+        replies?: Collection | URL | null;
+        startTime?: dntShim.Temporal.Instant | null;
+        summary?: string | LanguageString | null;
+        summaries?: (string | LanguageString)[];
+        tags?: (Object | Link | URL)[];
+        updated?: dntShim.Temporal.Instant | null;
+        url?: URL | Link | null;
+        urls?: (URL | Link)[];
+        to?: Object | URL | null;
+        tos?: (Object | URL)[];
+        bto?: Object | URL | null;
+        btos?: (Object | URL)[];
+        cc?: Object | URL | null;
+        ccs?: (Object | URL)[];
+        bcc?: Object | URL | null;
+        bccs?: (Object | URL)[];
+        mediaType?: string | null;
+        duration?: dntShim.Temporal.Duration | null;
+        sensitive?: boolean | null;
+        proof?: DataIntegrityProof | URL | null;
+        proofs?: (DataIntegrityProof | URL)[];
+        actor?: Application | Group | Organization | Person | Service | URL | null;
+        actors?: (Application | Group | Organization | Person | Service | URL)[];
+        object?: Object | URL | null;
+        objects?: (Object | URL)[];
+        exclusiveOptions?: (Object | URL)[];
+        inclusiveOptions?: (Object | URL)[];
+    }, { documentLoader, contextLoader, }?: {
+        documentLoader?: DocumentLoader;
+        contextLoader?: DocumentLoader;
+    });
+    /**
+     * 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?: {
+        id?: URL | null;
+        attachments?: (Object | Link | PropertyValue | URL)[];
+        attribution?: Application | Group | Organization | Person | Service | URL | null;
+        attributions?: (Application | Group | Organization | Person | Service | URL)[];
+        audience?: Object | URL | null;
+        audiences?: (Object | URL)[];
+        content?: string | LanguageString | null;
+        contents?: (string | LanguageString)[];
+        contexts?: (Object | Link | URL)[];
+        name?: string | LanguageString | null;
+        names?: (string | LanguageString)[];
+        endTime?: dntShim.Temporal.Instant | null;
+        generators?: (Object | Link | URL)[];
+        icon?: Image | URL | null;
+        icons?: (Image | URL)[];
+        image?: Image | URL | null;
+        images?: (Image | URL)[];
+        replyTarget?: Object | Link | URL | null;
+        replyTargets?: (Object | Link | URL)[];
+        location?: Object | Link | URL | null;
+        locations?: (Object | Link | URL)[];
+        preview?: Link | Object | URL | null;
+        previews?: (Link | Object | URL)[];
+        published?: dntShim.Temporal.Instant | null;
+        replies?: Collection | URL | null;
+        startTime?: dntShim.Temporal.Instant | null;
+        summary?: string | LanguageString | null;
+        summaries?: (string | LanguageString)[];
+        tags?: (Object | Link | URL)[];
+        updated?: dntShim.Temporal.Instant | null;
+        url?: URL | Link | null;
+        urls?: (URL | Link)[];
+        to?: Object | URL | null;
+        tos?: (Object | URL)[];
+        bto?: Object | URL | null;
+        btos?: (Object | URL)[];
+        cc?: Object | URL | null;
+        ccs?: (Object | URL)[];
+        bcc?: Object | URL | null;
+        bccs?: (Object | URL)[];
+        mediaType?: string | null;
+        duration?: dntShim.Temporal.Duration | null;
+        sensitive?: boolean | null;
+        proof?: DataIntegrityProof | URL | null;
+        proofs?: (DataIntegrityProof | URL)[];
+        actor?: Application | Group | Organization | Person | Service | URL | null;
+        actors?: (Application | Group | Organization | Person | Service | URL)[];
+        object?: Object | URL | null;
+        objects?: (Object | URL)[];
+        exclusiveOptions?: (Object | URL)[];
+        inclusiveOptions?: (Object | URL)[];
+    }, options?: {
+        documentLoader?: DocumentLoader;
+        contextLoader?: DocumentLoader;
+    }): Question;
+    /**
+     * Similar to
+     * {@link Question.getExclusiveOptions},
+     * but returns their `@id`s instead of the objects themselves.
+     */
+    get exclusiveOptionIds(): URL[];
+    /** 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`.
+     */
+    getExclusiveOptions(options?: {
+        documentLoader?: DocumentLoader;
+        contextLoader?: DocumentLoader;
+    }): AsyncIterable<Object>;
+    /**
+     * Similar to
+     * {@link Question.getInclusiveOptions},
+     * but returns their `@id`s instead of the objects themselves.
+     */
+    get inclusiveOptionIds(): URL[];
+    /** 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`.
+     */
+    getInclusiveOptions(options?: {
+        documentLoader?: DocumentLoader;
+        contextLoader?: DocumentLoader;
+    }): AsyncIterable<Object>;
+    /**
+     * Converts this object to a JSON-LD structure.
+     * @returns The JSON-LD representation of this object.
+     */
+    toJsonLd(options?: {
+        expand?: boolean;
+        contextLoader?: DocumentLoader;
+        context?: string | Record<string, string> | (string | Record<string, string>)[];
+    }): Promise<unknown>;
+    /**
+     * 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 fromJsonLd(json: unknown, options?: {
+        documentLoader?: DocumentLoader;
+        contextLoader?: DocumentLoader;
+    }): Promise<Question>;
+    protected _getCustomInspectProxy(): Record<string, unknown>;
+}
 /** Indicates that the `actor` is rejecting the `object`.  The `target` and
  * `origin` typically have no defined meaning.
  */