@fedify/vocab 2.3.0-dev.1372 → 2.3.0-dev.1404

package/dist/mod.js

@@ -9,7 +9,7 @@ import { isTemporalDuration, isTemporalInstant } from "@fedify/vocab-runtime/tem
 import { delay } from "es-toolkit";
 //#region deno.json
 var name = "@fedify/vocab";
-var version = "2.3.0-dev.1372+2402d49b";
+var version = "2.3.0-dev.1404+275c2d11";
 //#endregion
 //#region src/type.ts
 function getTypeId(object) {
@@ -5206,6 +5206,7 @@ var Object$1 = class Object$1 {
 			if (values["@type"].includes("https://gotosocial.org/ns#LikeApproval")) return await LikeAuthorization.fromJsonLd(json, options);
 			if (values["@type"].includes("https://gotosocial.org/ns#ReplyAuthorization")) return await ReplyAuthorization.fromJsonLd(json, options);
 			if (values["@type"].includes("https://w3id.org/fep/044f#QuoteAuthorization")) return await QuoteAuthorization.fromJsonLd(json, options);
+			if (values["@type"].includes("https://w3id.org/valueflows/ont/vf#Agreement")) return await Agreement.fromJsonLd(json, options);
 			if (values["@type"].includes("https://w3id.org/valueflows/ont/vf#Proposal")) return await Proposal.fromJsonLd(json, options);
 			if (values["@type"].includes("https://www.w3.org/ns/activitystreams#Activity")) return await Activity.fromJsonLd(json, options);
 			if (values["@type"].includes("http://litepub.social/ns#EmojiReact")) return await EmojiReact.fromJsonLd(json, options);
@@ -5283,6 +5284,7 @@ var Object$1 = class Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -5430,6 +5432,7 @@ var Object$1 = class Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -5537,6 +5540,7 @@ var Object$1 = class Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -5694,6 +5698,7 @@ var Object$1 = class Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -5783,6 +5788,7 @@ var Object$1 = class Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -5879,6 +5885,7 @@ var Object$1 = class Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -6056,6 +6063,7 @@ var Object$1 = class Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -14856,6 +14864,618 @@ Multikey.prototype[Symbol.for("Deno.customInspect")] = function(inspect, options
 Multikey.prototype[Symbol.for("nodejs.util.inspect.custom")] = function(_depth, options, inspect) {
 	return "Multikey " + inspect(this._getCustomInspectProxy(), options);
 };
+/** The agreement reached between parties responding to a {@link Proposal}.
+*
+* An interested party sends an `Agreement` wrapped in an {@link Offer}
+* activity.  The proposing party then either finalizes the agreement by
+* sending an {@link Accept} activity with the finalized `Agreement` as
+* its `result`, or sends a {@link Reject} activity.
+*
+* Note: This type extends ActivityStreams `Object` for practical
+* interoperability within ActivityPub federation, even though FEP-0837
+* defines `Agreement` as a pure ValueFlows type.  Extending `Object`
+* provides useful inherited properties such as `id`, `attributedTo`,
+* `url`, `to`, and `published` without needing to redefine them.
+*/
+var Agreement = class Agreement extends Object$1 {
+	/**
+	* The type URI of {@link Agreement}: `https://w3id.org/valueflows/ont/vf#Agreement`.
+	*/
+	static get typeId() {
+		return new URL("https://w3id.org/valueflows/ont/vf#Agreement");
+	}
+	#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates = [];
+	#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal = [];
+	/**
+	* Constructs a new instance of Agreement with the given values.
+	* @param values The values to initialize the instance with.
+	* @param options The options to use for initialization.
+	*/
+	constructor(values, options = {}) {
+		super(values, options);
+		if ("stipulates" in values && values.stipulates != null) if (values.stipulates instanceof Commitment) this.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates = [values.stipulates];
+		else throw new TypeError("The stipulates must be of type Commitment.");
+		if ("stipulatesReciprocal" in values && values.stipulatesReciprocal != null) if (values.stipulatesReciprocal instanceof Commitment) this.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal = [values.stipulatesReciprocal];
+		else throw new TypeError("The stipulatesReciprocal must be of type Commitment.");
+	}
+	/**
+	* Clones this instance, optionally updating it with the given values.
+	* @param values The values to update the clone with.
+	* @param options The options to use for cloning.
+	* @returns The cloned instance.
+	*/
+	clone(values = {}, options = {}) {
+		if (this._warning != null) {
+			getLogger(this._warning.category).warn(this._warning.message, this._warning.values);
+			options = {
+				...options,
+				$warning: this._warning
+			};
+		}
+		const clone = super.clone(values, options);
+		clone.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates = this.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates;
+		if ("stipulates" in values && values.stipulates != null) if (values.stipulates instanceof Commitment) clone.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates = [values.stipulates];
+		else throw new TypeError("The stipulates must be of type Commitment.");
+		clone.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal = this.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal;
+		if ("stipulatesReciprocal" in values && values.stipulatesReciprocal != null) if (values.stipulatesReciprocal instanceof Commitment) clone.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal = [values.stipulatesReciprocal];
+		else throw new TypeError("The stipulatesReciprocal must be of type Commitment.");
+		return clone;
+	}
+	/** The primary {@link Commitment} associated with the agreement.  This
+	* commitment satisfies the primary {@link Intent} of the corresponding
+	* {@link Proposal}.
+	*/
+	get stipulates() {
+		if (this._warning != null) getLogger(this._warning.category).warn(this._warning.message, this._warning.values);
+		if (this.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates.length < 1) return null;
+		return this.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates[0];
+	}
+	/** The reciprocal {@link Commitment} associated with the agreement.
+	* Required if the corresponding {@link Proposal} has a reciprocal
+	* {@link Intent}.
+	*/
+	get stipulatesReciprocal() {
+		if (this._warning != null) getLogger(this._warning.category).warn(this._warning.message, this._warning.values);
+		if (this.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal.length < 1) return null;
+		return this.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal[0];
+	}
+	/**
+	* Converts this object to a JSON-LD structure.
+	* @param options The options to use.
+	*                - `format`: The format of the output: `compact` or
+	`expand`.
+	*                - `contextLoader`: The loader for remote JSON-LD contexts.
+	*                - `context`: The JSON-LD context to use.  Not applicable
+	when `format` is set to `'expand'`.
+	* @returns The JSON-LD representation of this object.
+	*/
+	async toJsonLd(options = {}) {
+		if (options.format == null && this._cachedJsonLd != null) return this._cachedJsonLd;
+		if (options.format !== "compact" && options.context != null) throw new TypeError("The context option can only be used when the format option is set to 'compact'.");
+		options = {
+			...options,
+			contextLoader: options.contextLoader ?? getDocumentLoader()
+		};
+		if (options.format == null && this.isCompactable()) {
+			const result = await super.toJsonLd({
+				...options,
+				format: void 0,
+				context: void 0
+			});
+			let compactItems = [];
+			for (const v of this.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates) {
+				const item = await v.toJsonLd({
+					...options,
+					format: void 0,
+					context: void 0
+				});
+				compactItems.push(item);
+			}
+			if (compactItems.length > 0) result["stipulates"] = compactItems.length > 1 ? compactItems : compactItems[0];
+			compactItems = [];
+			for (const v of this.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal) {
+				const item = await v.toJsonLd({
+					...options,
+					format: void 0,
+					context: void 0
+				});
+				compactItems.push(item);
+			}
+			if (compactItems.length > 0) result["stipulatesReciprocal"] = compactItems.length > 1 ? compactItems : compactItems[0];
+			result["type"] = "Agreement";
+			if (this.id != null) result["id"] = this.id.href;
+			result["@context"] = [
+				"https://www.w3.org/ns/activitystreams",
+				"https://w3id.org/security/data-integrity/v1",
+				"https://gotosocial.org/ns",
+				{
+					"vf": "https://w3id.org/valueflows/ont/vf#",
+					"om2": "http://www.ontology-of-units-of-measure.org/resource/om-2/",
+					"fedibird": "http://fedibird.com/ns#",
+					"sensitive": "as:sensitive",
+					"emojiReactions": {
+						"@id": "fedibird:emojiReactions",
+						"@type": "@id"
+					},
+					"Agreement": "vf:Agreement",
+					"Commitment": "vf:Commitment",
+					"stipulates": "vf:stipulates",
+					"stipulatesReciprocal": "vf:stipulatesReciprocal",
+					"satisfies": {
+						"@id": "vf:satisfies",
+						"@type": "@id"
+					},
+					"resourceQuantity": "vf:resourceQuantity",
+					"hasUnit": "om2:hasUnit",
+					"hasNumericalValue": "om2:hasNumericalValue"
+				}
+			];
+			return result;
+		}
+		let array;
+		const values = (await super.toJsonLd({
+			...options,
+			format: "expand",
+			context: void 0
+		}))[0];
+		array = [];
+		for (const v of this.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates) {
+			const element = await v.toJsonLd(options);
+			array.push(element);
+		}
+		if (array.length > 0) values["https://w3id.org/valueflows/ont/vf#stipulates"] = array;
+		array = [];
+		for (const v of this.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal) {
+			const element = await v.toJsonLd(options);
+			array.push(element);
+		}
+		if (array.length > 0) values["https://w3id.org/valueflows/ont/vf#stipulatesReciprocal"] = array;
+		values["@type"] = ["https://w3id.org/valueflows/ont/vf#Agreement"];
+		if (this.id != null) values["@id"] = this.id.href;
+		if (options.format === "expand") return await jsonld.expand(values, { documentLoader: options.contextLoader });
+		const docContext = options.context ?? [
+			"https://www.w3.org/ns/activitystreams",
+			"https://w3id.org/security/data-integrity/v1",
+			"https://gotosocial.org/ns",
+			{
+				"vf": "https://w3id.org/valueflows/ont/vf#",
+				"om2": "http://www.ontology-of-units-of-measure.org/resource/om-2/",
+				"fedibird": "http://fedibird.com/ns#",
+				"sensitive": "as:sensitive",
+				"emojiReactions": {
+					"@id": "fedibird:emojiReactions",
+					"@type": "@id"
+				},
+				"Agreement": "vf:Agreement",
+				"Commitment": "vf:Commitment",
+				"stipulates": "vf:stipulates",
+				"stipulatesReciprocal": "vf:stipulatesReciprocal",
+				"satisfies": {
+					"@id": "vf:satisfies",
+					"@type": "@id"
+				},
+				"resourceQuantity": "vf:resourceQuantity",
+				"hasUnit": "om2:hasUnit",
+				"hasNumericalValue": "om2:hasNumericalValue"
+			}
+		];
+		const compacted = await jsonld.compact(values, docContext, { documentLoader: options.contextLoader });
+		if (docContext != null) {
+			if ("proof" in compacted && compacted.proof != null) if (Array.isArray(compacted.proof)) for (const element of compacted.proof) element["@context"] = docContext;
+			else compacted.proof["@context"] = docContext;
+		}
+		return compacted;
+	}
+	isCompactable() {
+		return super.isCompactable();
+	}
+	/**
+	* Converts a JSON-LD structure to an object of this type.
+	* @param json The JSON-LD structure to convert.
+	* @param options The options to use.
+	*                - `documentLoader`: The loader for remote JSON-LD documents.
+	*                - `contextLoader`: The loader for remote JSON-LD contexts.
+	*                - `tracerProvider`: The OpenTelemetry tracer provider to use.
+	*                  If omitted, the global tracer provider is used.
+	* @returns The object of this type.
+	* @throws {TypeError} If the given `json` is invalid.
+	*/
+	static async fromJsonLd(json, options = {}) {
+		return await (options.tracerProvider ?? trace.getTracerProvider()).getTracer("@fedify/vocab-tools", "2.3.0").startActiveSpan("activitypub.parse_object", async (span) => {
+			try {
+				const object = await this.__fromJsonLd__Agreement__(json, span, options);
+				if (object.id != null) span.setAttribute("activitypub.object.id", object.id.href);
+				return object;
+			} catch (error) {
+				span.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: String(error)
+				});
+				throw error;
+			} finally {
+				span.end();
+			}
+		});
+	}
+	static async __fromJsonLd__Agreement__(json, span, 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 ?? getDocumentLoader(),
+			contextLoader: options.contextLoader ?? getDocumentLoader(),
+			tracerProvider: options.tracerProvider ?? trace.getTracerProvider()
+		};
+		let values;
+		if (globalThis.Object.keys(json).length == 0) values = {};
+		else values = (await jsonld.expand(json, {
+			documentLoader: options.contextLoader,
+			keepFreeFloatingNodes: true
+		}))[0] ?? {};
+		if (values["@id"] != null && !values["@id"].startsWith("_:") && !URL.canParse(values["@id"], options.baseUrl)) throw new TypeError("Invalid @id: " + values["@id"]);
+		if (options.baseUrl == null && values["@id"] != null && !values["@id"].startsWith("_:") && URL.canParse(values["@id"])) options = {
+			...options,
+			baseUrl: new URL(values["@id"])
+		};
+		if ("@type" in values) span.setAttribute("activitypub.object.type", values["@type"]);
+		if ("@type" in values && !values["@type"].every((t) => t.startsWith("_:"))) {
+			if (!values["@type"].includes("https://w3id.org/valueflows/ont/vf#Agreement")) throw new TypeError("Invalid type: " + values["@type"]);
+		}
+		delete values["@type"];
+		const instance = await super.fromJsonLd(values, {
+			...options,
+			_fromSubclass: true
+		});
+		if (!(instance instanceof Agreement)) throw new TypeError("Unexpected type: " + instance.constructor.name);
+		const _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates = [];
+		let _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates__array = values["https://w3id.org/valueflows/ont/vf#stipulates"];
+		for (const v of _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates__array == null ? [] : _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates__array.length === 1 && "@list" in _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates__array[0] ? _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates__array[0]["@list"] : _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates__array) {
+			if (v == null) continue;
+			const decoded = await Commitment.fromJsonLd(v, {
+				...options,
+				baseUrl: options.baseUrl
+			});
+			if (typeof decoded === "undefined") continue;
+			_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates.push(decoded);
+		}
+		instance.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates = _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates;
+		const _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal = [];
+		let _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal__array = values["https://w3id.org/valueflows/ont/vf#stipulatesReciprocal"];
+		for (const v of _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal__array == null ? [] : _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal__array.length === 1 && "@list" in _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal__array[0] ? _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal__array[0]["@list"] : _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal__array) {
+			if (v == null) continue;
+			const decoded = await Commitment.fromJsonLd(v, {
+				...options,
+				baseUrl: options.baseUrl
+			});
+			if (typeof decoded === "undefined") continue;
+			_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal.push(decoded);
+		}
+		instance.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal = _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal;
+		if (!("_fromSubclass" in options) || !options._fromSubclass) try {
+			instance._cachedJsonLd = structuredClone(json);
+		} catch {
+			getLogger(["fedify", "vocab"]).warn("Failed to cache JSON-LD: {json}", { json });
+		}
+		return instance;
+	}
+	_getCustomInspectProxy() {
+		const proxy = super._getCustomInspectProxy();
+		const _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates = this.#_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates.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 (_37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates.length == 1) proxy.stipulates = _37zeAJ2NVyecrDdP8os69FGAn9Q6_stipulates[0];
+		const _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal = this.#_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal.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 (_4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal.length == 1) proxy.stipulatesReciprocal = _4Vhx9DcywF65XWUQ4KZ35475FaJm_stipulatesReciprocal[0];
+		return proxy;
+	}
+};
+Agreement.prototype[Symbol.for("Deno.customInspect")] = function(inspect, options) {
+	return "Agreement " + inspect(this._getCustomInspectProxy(), options);
+};
+Agreement.prototype[Symbol.for("nodejs.util.inspect.custom")] = function(_depth, options, inspect) {
+	return "Agreement " + inspect(this._getCustomInspectProxy(), options);
+};
+/** A promised economic transaction, referenced by an {@link Agreement}.
+*
+* A commitment satisfies an {@link Intent} of a {@link Proposal} and
+* specifies the actual amount of the economic resource being committed.
+*/
+var Commitment = class {
+	#documentLoader;
+	#contextLoader;
+	#tracerProvider;
+	#warning;
+	#cachedJsonLd;
+	#_baseUrl;
+	id;
+	get _documentLoader() {
+		return this.#documentLoader;
+	}
+	get _contextLoader() {
+		return this.#contextLoader;
+	}
+	get _tracerProvider() {
+		return this.#tracerProvider;
+	}
+	get _warning() {
+		return this.#warning;
+	}
+	get _cachedJsonLd() {
+		return this.#cachedJsonLd;
+	}
+	set _cachedJsonLd(value) {
+		this.#cachedJsonLd = value;
+	}
+	get _baseUrl() {
+		return this.#_baseUrl;
+	}
+	/**
+	* The type URI of {@link Commitment}: `https://w3id.org/valueflows/ont/vf#Commitment`.
+	*/
+	static get typeId() {
+		return new URL("https://w3id.org/valueflows/ont/vf#Commitment");
+	}
+	#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies = [];
+	#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity = [];
+	/**
+	* Constructs a new instance of Commitment with the given values.
+	* @param values The values to initialize the instance with.
+	* @param options The options to use for initialization.
+	*/
+	constructor(values, options = {}) {
+		this.#documentLoader = options.documentLoader;
+		this.#contextLoader = options.contextLoader;
+		this.#tracerProvider = options.tracerProvider;
+		const baseUrl = options.baseUrl;
+		this.#_baseUrl = baseUrl == null ? void 0 : new URL(baseUrl.href);
+		if ("$warning" in options) this.#warning = options.$warning;
+		if (values.id == null || values.id instanceof URL) this.id = values.id ?? null;
+		else throw new TypeError("The id must be a URL.");
+		if ("satisfies" in values && values.satisfies != null) if (values.satisfies instanceof URL) this.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies = [values.satisfies];
+		else throw new TypeError("The satisfies must be of type URL.");
+		if ("resourceQuantity" in values && values.resourceQuantity != null) if (values.resourceQuantity instanceof Measure) this.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity = [values.resourceQuantity];
+		else throw new TypeError("The resourceQuantity must be of type Measure.");
+	}
+	/**
+	* Clones this instance, optionally updating it with the given values.
+	* @param values The values to update the clone with.
+	* @param options The options to use for cloning.
+	* @returns The cloned instance.
+	*/
+	clone(values = {}, options = {}) {
+		if (this._warning != null) {
+			getLogger(this._warning.category).warn(this._warning.message, this._warning.values);
+			options = {
+				...options,
+				$warning: this._warning
+			};
+		}
+		const clone = new this.constructor({ id: values.id ?? this.id }, options);
+		clone.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies = this.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies;
+		if ("satisfies" in values && values.satisfies != null) if (values.satisfies instanceof URL) clone.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies = [values.satisfies];
+		else throw new TypeError("The satisfies must be of type URL.");
+		clone.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity = this.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity;
+		if ("resourceQuantity" in values && values.resourceQuantity != null) if (values.resourceQuantity instanceof Measure) clone.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity = [values.resourceQuantity];
+		else throw new TypeError("The resourceQuantity must be of type Measure.");
+		return clone;
+	}
+	/** The {@link Intent} of a {@link Proposal} that this commitment
+	* satisfies.  The value is the proposal's URI with a
+	* [fragment](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Fragment)
+	* appended to identify the intent. Recommended fragments are
+	* `primary` and `reciprocal`.
+	*/
+	get satisfies() {
+		if (this._warning != null) getLogger(this._warning.category).warn(this._warning.message, this._warning.values);
+		if (this.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies.length < 1) return null;
+		return this.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies[0];
+	}
+	/** The amount and unit of the economic resource being committed.  The
+	* unit must match the unit specified in the corresponding {@link Intent}
+	* of the proposal.
+	*/
+	get resourceQuantity() {
+		if (this._warning != null) getLogger(this._warning.category).warn(this._warning.message, this._warning.values);
+		if (this.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity.length < 1) return null;
+		return this.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity[0];
+	}
+	/**
+	* Converts this object to a JSON-LD structure.
+	* @param options The options to use.
+	*                - `format`: The format of the output: `compact` or
+	`expand`.
+	*                - `contextLoader`: The loader for remote JSON-LD contexts.
+	*                - `context`: The JSON-LD context to use.  Not applicable
+	when `format` is set to `'expand'`.
+	* @returns The JSON-LD representation of this object.
+	*/
+	async toJsonLd(options = {}) {
+		if (options.format == null && this._cachedJsonLd != null) return this._cachedJsonLd;
+		if (options.format !== "compact" && options.context != null) throw new TypeError("The context option can only be used when the format option is set to 'compact'.");
+		options = {
+			...options,
+			contextLoader: options.contextLoader ?? getDocumentLoader()
+		};
+		if (options.format == null && this.isCompactable()) {
+			const result = {};
+			let compactItems = [];
+			for (const v of this.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies) {
+				const item = v.href;
+				compactItems.push(item);
+			}
+			if (compactItems.length > 0) result["satisfies"] = compactItems.length > 1 ? compactItems : compactItems[0];
+			compactItems = [];
+			for (const v of this.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity) {
+				const item = await v.toJsonLd({
+					...options,
+					format: void 0,
+					context: void 0
+				});
+				compactItems.push(item);
+			}
+			if (compactItems.length > 0) result["resourceQuantity"] = compactItems.length > 1 ? compactItems : compactItems[0];
+			result["type"] = "Commitment";
+			if (this.id != null) result["id"] = this.id.href;
+			result["@context"] = ["https://www.w3.org/ns/activitystreams", {
+				"vf": "https://w3id.org/valueflows/ont/vf#",
+				"om2": "http://www.ontology-of-units-of-measure.org/resource/om-2/",
+				"Commitment": "vf:Commitment",
+				"satisfies": {
+					"@id": "vf:satisfies",
+					"@type": "@id"
+				},
+				"resourceQuantity": "vf:resourceQuantity",
+				"hasUnit": "om2:hasUnit",
+				"hasNumericalValue": "om2:hasNumericalValue"
+			}];
+			return result;
+		}
+		let array;
+		const values = {};
+		array = [];
+		for (const v of this.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies) {
+			const element = { "@id": v.href };
+			array.push(element);
+		}
+		if (array.length > 0) values["https://w3id.org/valueflows/ont/vf#satisfies"] = array;
+		array = [];
+		for (const v of this.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity) {
+			const element = await v.toJsonLd(options);
+			array.push(element);
+		}
+		if (array.length > 0) values["https://w3id.org/valueflows/ont/vf#resourceQuantity"] = array;
+		values["@type"] = ["https://w3id.org/valueflows/ont/vf#Commitment"];
+		if (this.id != null) values["@id"] = this.id.href;
+		if (options.format === "expand") return await jsonld.expand(values, { documentLoader: options.contextLoader });
+		const docContext = options.context ?? ["https://www.w3.org/ns/activitystreams", {
+			"vf": "https://w3id.org/valueflows/ont/vf#",
+			"om2": "http://www.ontology-of-units-of-measure.org/resource/om-2/",
+			"Commitment": "vf:Commitment",
+			"satisfies": {
+				"@id": "vf:satisfies",
+				"@type": "@id"
+			},
+			"resourceQuantity": "vf:resourceQuantity",
+			"hasUnit": "om2:hasUnit",
+			"hasNumericalValue": "om2:hasNumericalValue"
+		}];
+		const compacted = await jsonld.compact(values, docContext, { documentLoader: options.contextLoader });
+		if (docContext != null) {}
+		return compacted;
+	}
+	isCompactable() {
+		return true;
+	}
+	/**
+	* Converts a JSON-LD structure to an object of this type.
+	* @param json The JSON-LD structure to convert.
+	* @param options The options to use.
+	*                - `documentLoader`: The loader for remote JSON-LD documents.
+	*                - `contextLoader`: The loader for remote JSON-LD contexts.
+	*                - `tracerProvider`: The OpenTelemetry tracer provider to use.
+	*                  If omitted, the global tracer provider is used.
+	* @returns The object of this type.
+	* @throws {TypeError} If the given `json` is invalid.
+	*/
+	static async fromJsonLd(json, options = {}) {
+		return await (options.tracerProvider ?? trace.getTracerProvider()).getTracer("@fedify/vocab-tools", "2.3.0").startActiveSpan("activitypub.parse_object", async (span) => {
+			try {
+				const object = await this.__fromJsonLd__Commitment__(json, span, options);
+				if (object.id != null) span.setAttribute("activitypub.object.id", object.id.href);
+				return object;
+			} catch (error) {
+				span.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: String(error)
+				});
+				throw error;
+			} finally {
+				span.end();
+			}
+		});
+	}
+	static async __fromJsonLd__Commitment__(json, span, 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 ?? getDocumentLoader(),
+			contextLoader: options.contextLoader ?? getDocumentLoader(),
+			tracerProvider: options.tracerProvider ?? trace.getTracerProvider()
+		};
+		let values;
+		if (globalThis.Object.keys(json).length == 0) values = {};
+		else values = (await jsonld.expand(json, {
+			documentLoader: options.contextLoader,
+			keepFreeFloatingNodes: true
+		}))[0] ?? {};
+		if (values["@id"] != null && !values["@id"].startsWith("_:") && !URL.canParse(values["@id"], options.baseUrl)) throw new TypeError("Invalid @id: " + values["@id"]);
+		if (options.baseUrl == null && values["@id"] != null && !values["@id"].startsWith("_:") && URL.canParse(values["@id"])) options = {
+			...options,
+			baseUrl: new URL(values["@id"])
+		};
+		if ("@type" in values) span.setAttribute("activitypub.object.type", values["@type"]);
+		if ("@type" in values && !values["@type"].every((t) => t.startsWith("_:"))) {
+			if (!values["@type"].includes("https://w3id.org/valueflows/ont/vf#Commitment")) throw new TypeError("Invalid type: " + values["@type"]);
+		}
+		const instance = new this({ id: values["@id"] != null && !values["@id"].startsWith("_:") && URL.canParse(values["@id"], options.baseUrl) ? new URL(values["@id"], options.baseUrl) : void 0 }, options);
+		const _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies = [];
+		let _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies__array = values["https://w3id.org/valueflows/ont/vf#satisfies"];
+		for (const v of _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies__array == null ? [] : _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies__array.length === 1 && "@list" in _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies__array[0] ? _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies__array[0]["@list"] : _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies__array) {
+			if (v == null) continue;
+			const decoded = v["@id"].startsWith("at://") ? new URL("at://" + encodeURIComponent(v["@id"].includes("/", 5) ? v["@id"].slice(5, v["@id"].indexOf("/", 5)) : v["@id"].slice(5)) + (v["@id"].includes("/", 5) ? v["@id"].slice(v["@id"].indexOf("/", 5)) : "")) : URL.canParse(v["@id"]) && options.baseUrl ? new URL(v["@id"]) : new URL(v["@id"], options.baseUrl);
+			if (typeof decoded === "undefined") continue;
+			_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies.push(decoded);
+		}
+		instance.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies = _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies;
+		const _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity = [];
+		let _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity__array = values["https://w3id.org/valueflows/ont/vf#resourceQuantity"];
+		for (const v of _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity__array == null ? [] : _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity__array.length === 1 && "@list" in _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity__array[0] ? _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity__array[0]["@list"] : _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity__array) {
+			if (v == null) continue;
+			const decoded = await Measure.fromJsonLd(v, {
+				...options,
+				baseUrl: options.baseUrl
+			});
+			if (typeof decoded === "undefined") continue;
+			_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity.push(decoded);
+		}
+		instance.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity = _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity;
+		if (!("_fromSubclass" in options) || !options._fromSubclass) try {
+			instance._cachedJsonLd = structuredClone(json);
+		} catch {
+			getLogger(["fedify", "vocab"]).warn("Failed to cache JSON-LD: {json}", { json });
+		}
+		return instance;
+	}
+	_getCustomInspectProxy() {
+		const proxy = {};
+		if (this.id != null) proxy.id = {
+			[Symbol.for("Deno.customInspect")]: (inspect, options) => "URL " + inspect(this.id.href, options),
+			[Symbol.for("nodejs.util.inspect.custom")]: (_depth, options, inspect) => "URL " + inspect(this.id.href, options)
+		};
+		const _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies = this.#_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies.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 (_aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies.length == 1) proxy.satisfies = _aCyzDK9TkXtLxrZs7JC8emuYisv_satisfies[0];
+		const _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity = this.#_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity.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 (_2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity.length == 1) proxy.resourceQuantity = _2dLfqTbbRiggEcMQWbHpxkQrtmrc_resourceQuantity[0];
+		return proxy;
+	}
+};
+Commitment.prototype[Symbol.for("Deno.customInspect")] = function(inspect, options) {
+	return "Commitment " + inspect(this._getCustomInspectProxy(), options);
+};
+Commitment.prototype[Symbol.for("nodejs.util.inspect.custom")] = function(_depth, options, inspect) {
+	return "Commitment " + inspect(this._getCustomInspectProxy(), options);
+};
 /** A proposed economic transaction describing what is being offered or requested
 * in a {@link Proposal}.
 */
@@ -23335,6 +23955,7 @@ var Collection = class Collection extends Object$1 {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -29809,6 +30430,7 @@ var Link = class Link {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -32474,6 +33096,7 @@ var OrderedCollection = class OrderedCollection extends Collection {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -32987,6 +33610,7 @@ var OrderedCollectionPage = class OrderedCollectionPage extends CollectionPage {
 				"https://gotosocial.org/ns#LikeApproval",
 				"https://gotosocial.org/ns#ReplyAuthorization",
 				"https://w3id.org/fep/044f#QuoteAuthorization",
+				"https://w3id.org/valueflows/ont/vf#Agreement",
 				"https://w3id.org/valueflows/ont/vf#Proposal",
 				"https://www.w3.org/ns/activitystreams#Activity",
 				"http://litepub.social/ns#EmojiReact",
@@ -48092,6 +48716,7 @@ const entityTypeSet = new Set([
 	DataIntegrityProof,
 	CryptographicKey,
 	Multikey,
+	Agreement,
 	Proposal,
 	Accept,
 	Add,
@@ -48163,6 +48788,7 @@ const entityTypeIds = new Map([
 	["https://w3id.org/security#DataIntegrityProof", DataIntegrityProof],
 	["https://w3id.org/security#Key", CryptographicKey],
 	["https://w3id.org/security#Multikey", Multikey],
+	["https://w3id.org/valueflows/ont/vf#Agreement", Agreement],
 	["https://w3id.org/valueflows/ont/vf#Proposal", Proposal],
 	["https://www.w3.org/ns/activitystreams#Accept", Accept],
 	["https://www.w3.org/ns/activitystreams#Add", Add],
@@ -48706,4 +49332,4 @@ async function* traverseCollection(collection, options = {}) {
 	}
 }
 //#endregion
-export { Accept, Activity, Add, Announce, AnnounceAuthorization, AnnounceRequest, Application, Arrive, Article, Audio, Block, ChatMessage, Collection, CollectionPage, Create, CryptographicKey, DataIntegrityProof, Delete, DidService, Dislike, Document, Emoji, EmojiReact, Endpoints, Event, Export, Flag, Follow, Group, Hashtag, Ignore, Image, Intent, InteractionPolicy, InteractionRule, IntransitiveActivity, Invite, Join, LanguageString, Leave, Like, LikeAuthorization, LikeRequest, Link, Listen, Measure, Mention, Move, Multikey, Note, Object$1 as Object, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Proposal, Question, QuoteAuthorization, QuoteRequest, Read, Reject, Relationship, Remove, ReplyAuthorization, ReplyRequest, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getEntityTypeById, getTypeId, isActor, isEntityType, isFediverseHandle, lookupObject, normalizeActorHandle, normalizeLinkToImage, parseFediverseHandle, toAcctUrl, traverseCollection };
+export { Accept, Activity, Add, Agreement, Announce, AnnounceAuthorization, AnnounceRequest, Application, Arrive, Article, Audio, Block, ChatMessage, Collection, CollectionPage, Commitment, Create, CryptographicKey, DataIntegrityProof, Delete, DidService, Dislike, Document, Emoji, EmojiReact, Endpoints, Event, Export, Flag, Follow, Group, Hashtag, Ignore, Image, Intent, InteractionPolicy, InteractionRule, IntransitiveActivity, Invite, Join, LanguageString, Leave, Like, LikeAuthorization, LikeRequest, Link, Listen, Measure, Mention, Move, Multikey, Note, Object$1 as Object, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Proposal, Question, QuoteAuthorization, QuoteRequest, Read, Reject, Relationship, Remove, ReplyAuthorization, ReplyRequest, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getEntityTypeById, getTypeId, isActor, isEntityType, isFediverseHandle, lookupObject, normalizeActorHandle, normalizeLinkToImage, parseFediverseHandle, toAcctUrl, traverseCollection };