@fedify/fedify 2.4.0-dev.1567 → 2.4.0-dev.1570

package/README.md

@@ -9,6 +9,9 @@
 [![Matrix][Matrix badge]][Matrix]
 [![@fedify@hackers.pub][@fedify@hackers.pub badge]][@fedify@hackers.pub]
 
+> [!NOTE]
+> Looking for a quick demo?  Here it is: [Fedify Demo] on Deno Playground.
+
 Fedify is a TypeScript library for building federated server apps
 powered by [ActivityPub] and other standards, so-called [fediverse].[^1]
 It aims to eliminate the complexity and boilerplate code when
@@ -60,6 +63,7 @@ in the fediverse!
 [Matrix]: https://matrix.to/#/#fedify:matrix.org
 [@fedify@hackers.pub badge]: https://fedi-badge.minhee.org/@fedify@hackers.pub/followers.svg
 [@fedify@hackers.pub]: https://hackers.pub/@fedify
+[Fedify Demo]: https://dash.deno.com/playground/fedify-demo
 [ActivityPub]: https://www.w3.org/TR/activitypub/
 [fediverse]: https://en.wikipedia.org/wiki/Fediverse
 [Activity Vocabulary]: https://www.w3.org/TR/activitystreams-vocabulary/

package/dist/{assert-OguE97r2.mjs → assert-DvVHoIZ0.mjs}

@@ -1,7 +1,7 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { l as AssertionError } from "./assert_equals-C-ZRDbaf.mjs";
+import { l as AssertionError } from "./assert_equals-PBVKNMJd.mjs";
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert.js
 /**
 * Make an assertion, error will be thrown if `expr` does not have truthy value.

package/dist/{assert_instance_of-DBC5X09g.mjs → assert_instance_of-CxoC8bVq.mjs}

@@ -1,7 +1,7 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { l as AssertionError } from "./assert_equals-C-ZRDbaf.mjs";
+import { l as AssertionError } from "./assert_equals-PBVKNMJd.mjs";
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_instance_of.js
 /**
 * Make an assertion that `obj` is an instance of `type`.

package/dist/{assert_not_equals-DkVK8oqV.mjs → assert_not_equals-C8vcTTA3.mjs}

@@ -1,7 +1,7 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { c as equal, l as AssertionError } from "./assert_equals-C-ZRDbaf.mjs";
+import { c as equal, l as AssertionError } from "./assert_equals-PBVKNMJd.mjs";
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_not_equals.js
 /**
 * Make an assertion that `actual` and `expected` are not equal, deeply.

package/dist/{assert_rejects-DN60FHPX.mjs → assert_rejects-DAdaaIWM.mjs}

@@ -1,8 +1,8 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { l as AssertionError, s as format } from "./assert_equals-C-ZRDbaf.mjs";
-import { n as assertIsError } from "./assert_throws-BOkhLGYc.mjs";
+import { l as AssertionError, s as format } from "./assert_equals-PBVKNMJd.mjs";
+import { n as assertIsError } from "./assert_throws-zN79lgIC.mjs";
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_false.js
 /**
 * Make an assertion, error will be thrown if `expr` have truthy value.

package/dist/{assert_strict_equals-XEgZAlrj.mjs → assert_strict_equals-BzqyKuYL.mjs}

@@ -1,7 +1,7 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { a as red, i as buildMessage, l as AssertionError, n as diffStr, r as diff, s as format } from "./assert_equals-C-ZRDbaf.mjs";
+import { a as red, i as buildMessage, l as AssertionError, n as diffStr, r as diff, s as format } from "./assert_equals-PBVKNMJd.mjs";
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_strict_equals.js
 /**
 * Make an assertion that `actual` and `expected` are equal using

package/dist/{assert_throws-BOkhLGYc.mjs → assert_throws-zN79lgIC.mjs}

@@ -1,7 +1,7 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { l as AssertionError, o as stripAnsiCode } from "./assert_equals-C-ZRDbaf.mjs";
+import { l as AssertionError, o as stripAnsiCode } from "./assert_equals-PBVKNMJd.mjs";
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_is_error.js
 /**
 * Make an assertion that `error` is an `Error`.

package/dist/{builder-DGWCUaNQ.mjs → builder-CJnWbgbj.mjs}

@@ -1,8 +1,8 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { n as version, t as name } from "./deno-Dho0TW0X.mjs";
-import { t as ActivityListenerSet } from "./activity-listener-tztVvlNb.mjs";
+import { n as version, t as name } from "./deno-klNxGW7W.mjs";
+import { t as ActivityListenerSet } from "./activity-listener-BeTGV3wc.mjs";
 import { getLogger } from "@logtape/logtape";
 import { Router, RouterError, assertPath } from "@fedify/uri-template";
 import { Tombstone, getTypeId } from "@fedify/vocab";
@@ -61,6 +61,7 @@ var FederationBuilderImpl = class {
 	idempotencyStrategy;
 	collectionTypeIds;
 	collectionCallbacks;
+	taskDefinitions;
 	/**
 	* Symbol registry for unique identification of unnamed symbols.
 	*/
@@ -71,6 +72,7 @@ var FederationBuilderImpl = class {
 		this.objectTypeIds = {};
 		this.collectionCallbacks = {};
 		this.collectionTypeIds = {};
+		this.taskDefinitions = /* @__PURE__ */ new Map();
 	}
 	/**
 	* Builds the federation object.
@@ -80,7 +82,7 @@ var FederationBuilderImpl = class {
 	* specified.
 	*/
 	async build(options) {
-		const { FederationImpl } = await import("./middleware-CIteB8IS.mjs");
+		const { FederationImpl } = await import("./middleware-CdMiavoh.mjs");
 		const f = new FederationImpl(options);
 		const trailingSlashInsensitiveValue = f.router.trailingSlashInsensitive;
 		f.router = this.router.clone();
@@ -109,6 +111,7 @@ var FederationBuilderImpl = class {
 		f.unverifiedActivityHandler = this.unverifiedActivityHandler;
 		f.outboxPermanentFailureHandler = this.outboxPermanentFailureHandler;
 		f.idempotencyStrategy = this.idempotencyStrategy;
+		f.taskDefinitions = new Map(this.taskDefinitions);
 		return f;
 	}
 	_getTracer() {
@@ -241,6 +244,23 @@ var FederationBuilderImpl = class {
 	setWebFingerLinksDispatcher(dispatcher) {
 		this.webFingerLinksDispatcher = dispatcher;
 	}
+	defineTask(name, options) {
+		if (this.taskDefinitions.has(name)) throw new TypeError(`Task ${JSON.stringify(name)} is already defined.`);
+		const handle = {
+			name,
+			schema: options.schema
+		};
+		this.taskDefinitions.set(name, {
+			name,
+			schema: options.schema,
+			handle,
+			handler: options.handler,
+			onError: options.onError,
+			retryPolicy: options.retryPolicy,
+			queue: options.queue
+		});
+		return handle;
+	}
 	/**
 	* The RFC 6570 template-literal `path` overloads were removed for
 	* type-checking efficiency, so the URI variable types can no longer be

package/dist/codec-nfBU4Up4.mjs

@@ -0,0 +1,124 @@
+import "@js-temporal/polyfill";
+import "urlpattern-polyfill";
+globalThis.addEventListener = () => {};
+import { Link, Object as Object$1 } from "@fedify/vocab";
+import { parse, stringifyAsync } from "devalue";
+//#region src/federation/tasks/codec.ts
+/**
+* Serializes and deserializes task payloads for the queue, preserving
+* `@fedify/vocab` objects across the wire by reducing them to JSON-LD and
+* rebuilding them on the worker with the bound {@link TaskCodecLoaders}.
+* @internal
+*/
+var TaskCodec = class TaskCodec {
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	/** Serializes `data`, encoding any vocabulary object as its JSON-LD. */
+	serialize = (data) => stringifyAsync(data, { Vocab: this.#stringifyVocab });
+	deserialize = async (raw) => await this.#revive(/* @__PURE__ */ new Map())(parse(raw, { Vocab: VocabHolder.from }));
+	/** Validates `data` against `schema`, then serializes it. */
+	encode = async (schema, data) => this.serialize(await TaskCodec.validate(schema, data));
+	/** Deserializes `raw`, then validates the result against `schema`. */
+	decode = async (schema, raw) => {
+		let data;
+		try {
+			data = await this.deserialize(raw);
+		} catch (error) {
+			return {
+				ok: false,
+				phase: "deserialization",
+				error
+			};
+		}
+		try {
+			return {
+				ok: true,
+				value: await TaskCodec.validate(schema, data)
+			};
+		} catch (error) {
+			return {
+				ok: false,
+				phase: "validation",
+				error
+			};
+		}
+	};
+	static validate = async (schema, data) => getValueIfSchema(await schema["~standard"].validate(data));
+	#stringifyVocab = (value) => isVocab(value) && this.#toWire(value);
+	#toWire = async (value) => ({
+		kind: value instanceof Link ? "link" : "object",
+		jsonLd: await value.toJsonLd({
+			format: "expand",
+			...this.options
+		})
+	});
+	#revive = (seen) => {
+		const inner = async (node) => {
+			if (node === null || typeof node !== "object") return node;
+			if (seen.has(node)) return seen.get(node);
+			for (const reviver of this.#classRevivers) {
+				const out = reviver(seen, inner, node);
+				if (out !== void 0) return await out;
+			}
+			return node;
+		};
+		return inner;
+	};
+	#classRevivers = [
+		classReviver(isInstanceOf(VocabHolder), ({ kind, jsonLd }) => kind === "link" ? Link.fromJsonLd(jsonLd, this.options) : Object$1.fromJsonLd(jsonLd, this.options), () => {}),
+		classReviver(isInstanceOf(Array), () => [], async (revive, node, arr) => {
+			for (const item of await Array.fromAsync(node, revive)) arr.push(item);
+		}),
+		classReviver(isInstanceOf(Map), () => /* @__PURE__ */ new Map(), async (revive, node, map) => {
+			for (const [k, v] of node) map.set(await revive(k), await revive(v));
+		}),
+		classReviver(isInstanceOf(Set), () => /* @__PURE__ */ new Set(), async (revive, node, set) => {
+			for (const v of await Array.fromAsync(node, revive)) set.add(v);
+		}),
+		classReviver(isPlainObject, () => ({}), async (revive, node, obj) => {
+			for (const [k, v] of globalThis.Object.entries(node)) obj[k] = await revive(v);
+		})
+	];
+};
+const isVocab = (value) => value instanceof Object$1 || value instanceof Link;
+const isPlainObject = (value) => value === null || typeof value !== "object" ? false : isObjectPrototype(globalThis.Object.getPrototypeOf(value));
+const isObjectPrototype = (proto) => proto === null || proto === globalThis.Object.prototype;
+const isInstanceOf = (cls) => (v) => v instanceof cls;
+function getValueIfSchema(result) {
+	assertSchema(result);
+	return result.value;
+}
+function assertSchema(result) {
+	if (result.issues && result.issues.length > 0) throw new TypeError(`Task data failed schema validation: ${JSON.stringify(result.issues)}`);
+}
+/**
+* A vocabulary object parked by the synchronous decode reviver, held until
+* the async revive pass can `fromJsonLd()` it back into an instance.
+*/
+var VocabHolder = class VocabHolder {
+	kind;
+	jsonLd;
+	constructor(kind, jsonLd) {
+		this.kind = kind;
+		this.jsonLd = jsonLd;
+	}
+	static from = ({ kind, jsonLd }) => new VocabHolder(kind, jsonLd);
+};
+/**
+* Ties a container filter to its empty-shell `init` and child-filling `set`
+* through one type parameter—a correlation the heterogeneous reviver list
+* cannot carry, which previously forced `@ts-ignore` at the dispatch site.
+*/
+const classReviver = (filter, init, set) => (seen, revive, node) => {
+	if (!filter(node)) return void 0;
+	return (async () => {
+		const out = await init(node);
+		seen.set(node, out);
+		await set(revive, node, out);
+		return out;
+	})();
+};
+//#endregion
+export { TaskCodec as t };

package/dist/compat/mod.d.cts

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { jt as ActivityTransformer, n as Context } from "../context-BBVLF7lx.cjs";
+import { It as ActivityTransformer, n as Context } from "../context-BLe0NPtZ.cjs";
 import { Activity } from "@fedify/vocab";
 
 //#region src/compat/transformers.d.ts

package/dist/compat/mod.d.ts

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { jt as ActivityTransformer, n as Context } from "../context-BU6jSQdo.js";
+import { It as ActivityTransformer, n as Context } from "../context-GfQA-CqB.js";
 import { Activity } from "@fedify/vocab";
 
 //#region src/compat/transformers.d.ts

package/dist/compat/outgoing-jsonld.test.mjs

@@ -1,9 +1,9 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { t as assertEquals } from "../assert_equals-C-ZRDbaf.mjs";
-import { t as assertStrictEquals } from "../assert_strict_equals-XEgZAlrj.mjs";
-import { n as normalizeAttachmentArrays, r as normalizeOutgoingActivityJsonLd, t as isPreloadedContextAttachmentSafe } from "../outgoing-jsonld-L_DbOaFe.mjs";
+import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
+import { t as assertStrictEquals } from "../assert_strict_equals-BzqyKuYL.mjs";
+import { n as normalizeAttachmentArrays, r as normalizeOutgoingActivityJsonLd, t as isPreloadedContextAttachmentSafe } from "../outgoing-jsonld-BNL8AC14.mjs";
 import { Create, Document, Note, PUBLIC_COLLECTION } from "@fedify/vocab";
 import { mockDocumentLoader, test } from "@fedify/fixture";
 //#region src/compat/outgoing-jsonld.test.ts

package/dist/compat/public-audience.test.mjs

@@ -1,9 +1,9 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { t as assertEquals } from "../assert_equals-C-ZRDbaf.mjs";
-import { t as assertNotEquals } from "../assert_not_equals-DkVK8oqV.mjs";
-import { t as normalizePublicAudience } from "../public-audience-Cvbr2Gzt.mjs";
+import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
+import { t as assertNotEquals } from "../assert_not_equals-C8vcTTA3.mjs";
+import { t as normalizePublicAudience } from "../public-audience-c9zmYKgA.mjs";
 import { Create, Note, PUBLIC_COLLECTION } from "@fedify/vocab";
 import { test } from "@fedify/fixture";
 import { getDocumentLoader, preloadedContexts } from "@fedify/vocab-runtime";

package/dist/compat/transformers.test.mjs

@@ -1,11 +1,11 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { t as assertEquals } from "../assert_equals-C-ZRDbaf.mjs";
-import { t as assertInstanceOf } from "../assert_instance_of-DBC5X09g.mjs";
-import { t as assert } from "../assert-OguE97r2.mjs";
-import { t as MemoryKvStore } from "../kv-rV3vodCc.mjs";
-import { b as autoIdAssigner, n as FederationImpl, y as actorDehydrator } from "../middleware-DfBPuuvp.mjs";
+import { t as MemoryKvStore } from "../kv-CIvR3Non.mjs";
+import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
+import { t as assertInstanceOf } from "../assert_instance_of-CxoC8bVq.mjs";
+import { t as assert } from "../assert-DvVHoIZ0.mjs";
+import { b as autoIdAssigner, n as FederationImpl, y as actorDehydrator } from "../middleware-CjHqy-1i.mjs";
 import { Follow, Person } from "@fedify/vocab";
 import { test } from "@fedify/fixture";
 //#region src/compat/transformers.test.ts

package/dist/{context-DVoTs_wM.mjs → context-BBRTgkrs.mjs}

@@ -66,7 +66,7 @@ const testDefinitions = [];
 //#endregion
 //#region src/testing/context.ts
 function createContext(values) {
-	const { federation, url = new URL("http://example.com/"), canonicalOrigin, data, documentLoader, contextLoader, meterProvider, tracerProvider, clone, getNodeInfoUri, getActorUri, getObjectUri, getCollectionUri, getOutboxUri, getInboxUri, getFollowingUri, getFollowersUri, getLikedUri, getFeaturedUri, getFeaturedTagsUri, parseUri, getActorKeyPairs, getDocumentLoader, lookupObject: lookupObject$1, traverseCollection: traverseCollection$1, lookupNodeInfo, lookupWebFinger: lookupWebFinger$1, sendActivity, routeActivity } = values;
+	const { federation, url = new URL("http://example.com/"), canonicalOrigin, data, documentLoader, contextLoader, meterProvider, tracerProvider, clone, getNodeInfoUri, getActorUri, getObjectUri, getCollectionUri, getOutboxUri, getInboxUri, getFollowingUri, getFollowersUri, getLikedUri, getFeaturedUri, getFeaturedTagsUri, parseUri, getActorKeyPairs, getDocumentLoader, lookupObject: lookupObject$1, traverseCollection: traverseCollection$1, lookupNodeInfo, lookupWebFinger: lookupWebFinger$1, sendActivity, routeActivity, enqueueTask, enqueueTaskMany } = values;
 	function throwRouterError() {
 		throw new RouterError("Not implemented");
 	}
@@ -126,6 +126,12 @@ function createContext(values) {
 		}),
 		routeActivity: routeActivity ?? ((_params) => {
 			throw new Error("Not implemented");
+		}),
+		enqueueTask: enqueueTask ?? ((_task, _data, _options) => {
+			throw new Error("Not implemented");
+		}),
+		enqueueTaskMany: enqueueTaskMany ?? ((_task, _payloads, _options) => {
+			throw new Error("Not implemented");
 		})
 	};
 }
@@ -176,4 +182,4 @@ function createOutboxContext(args) {
 	};
 }
 //#endregion
-export { testDefinitions as i, createOutboxContext as n, createRequestContext as r, createInboxContext as t };
+export { testDefinitions as a, mockDocumentLoader as i, createOutboxContext as n, createRequestContext as r, createInboxContext as t };