@fedify/fedify 2.0.0-dev.1485 → 2.0.0-dev.149

package/dist/vocab-DFMYh9aV.cjs

@@ -0,0 +1,296 @@
+
+          const { Temporal } = require("@js-temporal/polyfill");
+          const { URLPattern } = require("urlpattern-polyfill");
+        
+const require_chunk = require('./chunk-DqRYRqnO.cjs');
+const require_lookup = require('./lookup-BORWbouU.cjs');
+const require_actor = require('./actor-CCAL5-E_.cjs');
+const __logtape_logtape = require_chunk.__toESM(require("@logtape/logtape"));
+const __opentelemetry_api = require_chunk.__toESM(require("@opentelemetry/api"));
+const __fedify_vocab_runtime = require_chunk.__toESM(require("@fedify/vocab-runtime"));
+const es_toolkit = require_chunk.__toESM(require("es-toolkit"));
+
+//#region src/vocab/handle.ts
+/**
+* Regular expression to match a fediverse handle in the format `@user@server`
+* or `user@server`.  The `user` part can contain alphanumeric characters and
+* some special characters except `@`.  The `server` part is all characters
+* after the `@` symbol in the middle.
+*/
+const handleRegexp = /^@?((?:[-A-Za-z0-9._~!$&'()*+,;=]|%[A-Fa-f0-9]{2})+)@([^@]+)$/;
+/**
+* Parses a fediverse handle in the format `@user@server` or `user@server`.
+* The `user` part can contain alphanumeric characters and some special
+* characters except `@`.  The `server` part is all characters after the `@`
+* symbol in the middle.
+*
+* @example
+* ```typescript
+* const handle = parseFediverseHandle("@username@example.com");
+* console.log(handle?.username); // "username"
+* console.log(handle?.host);     // "example.com"
+* ```
+*
+* @param handle - The fediverse handle string to parse.
+* @returns A {@link FediverseHandle} object with `username` and `host`
+*          if the input is valid; otherwise `null`.
+* @since 1.8.0
+*/
+function parseFediverseHandle(handle) {
+	const match = handleRegexp.exec(handle);
+	if (match) return {
+		username: match[1],
+		host: match[2]
+	};
+	return null;
+}
+/**
+* Checks if a string is a valid fediverse handle in the format `@user@server`
+* or `user@server`.  The `user` part can contain alphanumeric characters and
+* some special characters except `@`.  The `server` part is all characters
+* after the `@` symbol in the middle.
+*
+* @example
+* ```typescript
+* console.log(isFediverseHandle("@username@example.com")); // true
+* console.log(isFediverseHandle("username@example.com"));  // true
+* console.log(isFediverseHandle("@username@"));            // false
+* ```
+*
+* @param handle - The string to test as a fediverse handle.
+* @returns `true` if the string matches the fediverse handle pattern;
+*          otherwise `false`.
+* @since 1.8.0
+*/
+function isFediverseHandle(handle) {
+	return handleRegexp.test(handle);
+}
+/**
+* Converts a fediverse handle in the format `@user@server` or `user@server`
+* to an `acct:` URI, which is a URL-like identifier for ActivityPub actors.
+*
+* @example
+* ```typescript
+* const identifier = toAcctUrl("@username@example.com");
+* console.log(identifier?.href); // "acct:username@example.com"
+* ```
+*
+* @param handle - The fediverse handle string to convert.
+* @returns A `URL` object representing the `acct:` URI if conversion succeeds;
+*          otherwise `null`.
+* @since 1.8.0
+*/
+function toAcctUrl(handle) {
+	const parsed = parseFediverseHandle(handle);
+	if (!parsed) return null;
+	const identifier = new URL(`acct:${parsed.username}@${parsed.host}`);
+	return identifier;
+}
+
+//#endregion
+//#region src/vocab/lookup.ts
+const logger = (0, __logtape_logtape.getLogger)([
+	"fedify",
+	"vocab",
+	"lookup"
+]);
+/**
+* Looks up an ActivityStreams object by its URI (including `acct:` URIs)
+* or a fediverse handle (e.g., `@user@server` or `user@server`).
+*
+* @example
+* ``` typescript
+* // Look up an actor by its fediverse handle:
+* await lookupObject("@hongminhee@fosstodon.org");
+* // returning a `Person` object.
+*
+* // A fediverse handle can omit the leading '@':
+* await lookupObject("hongminhee@fosstodon.org");
+* // returning a `Person` object.
+*
+* // A `acct:` URI can be used as well:
+* await lookupObject("acct:hongminhee@fosstodon.org");
+* // returning a `Person` object.
+*
+* // Look up an object by its URI:
+* await lookupObject("https://todon.eu/@hongminhee/112060633798771581");
+* // returning a `Note` object.
+*
+* // It can be a `URL` object as well:
+* await lookupObject(new URL("https://todon.eu/@hongminhee/112060633798771581"));
+* // returning a `Note` object.
+* ```
+*
+* @param identifier The URI or fediverse handle to look up.
+* @param options Lookup options.
+* @returns The object, or `null` if not found.
+* @since 0.2.0
+*/
+async function lookupObject(identifier, options = {}) {
+	const tracerProvider = options.tracerProvider ?? __opentelemetry_api.trace.getTracerProvider();
+	const tracer = tracerProvider.getTracer(require_lookup.deno_default.name, require_lookup.deno_default.version);
+	return await tracer.startActiveSpan("activitypub.lookup_object", async (span) => {
+		try {
+			const result = await lookupObjectInternal(identifier, options);
+			if (result == null) span.setStatus({ code: __opentelemetry_api.SpanStatusCode.ERROR });
+			else {
+				if (result.id != null) span.setAttribute("activitypub.object.id", result.id.href);
+				span.setAttribute("activitypub.object.type", require_actor.getTypeId(result).href);
+				if (result.replyTargetIds.length > 0) span.setAttribute("activitypub.object.in_reply_to", result.replyTargetIds.map((id) => id.href));
+				span.addEvent("activitypub.object.fetched", {
+					"activitypub.object.type": require_actor.getTypeId(result).href,
+					"activitypub.object.json": JSON.stringify(await result.toJsonLd(options))
+				});
+			}
+			return result;
+		} catch (error) {
+			span.recordException(error);
+			span.setStatus({
+				code: __opentelemetry_api.SpanStatusCode.ERROR,
+				message: String(error)
+			});
+			throw error;
+		} finally {
+			span.end();
+		}
+	});
+}
+async function lookupObjectInternal(identifier, options = {}) {
+	const documentLoader = options.documentLoader ?? (0, __fedify_vocab_runtime.getDocumentLoader)({ userAgent: options.userAgent });
+	if (typeof identifier === "string") identifier = toAcctUrl(identifier) ?? new URL(identifier);
+	let remoteDoc = null;
+	if (identifier.protocol === "http:" || identifier.protocol === "https:") try {
+		remoteDoc = await documentLoader(identifier.href, { signal: options.signal });
+	} catch (error) {
+		logger.debug("Failed to fetch remote document:\n{error}", { error });
+	}
+	if (remoteDoc == null) {
+		const jrd = await require_lookup.lookupWebFinger(identifier, {
+			userAgent: options.userAgent,
+			tracerProvider: options.tracerProvider,
+			allowPrivateAddress: "allowPrivateAddress" in options && options.allowPrivateAddress === true,
+			signal: options.signal
+		});
+		if (jrd?.links == null) return null;
+		for (const l of jrd.links) {
+			if (l.type !== "application/activity+json" && !l.type?.match(/application\/ld\+json;\s*profile="https:\/\/www.w3.org\/ns\/activitystreams"/) || l.rel !== "self" || l.href == null) continue;
+			try {
+				remoteDoc = await documentLoader(l.href, { signal: options.signal });
+				break;
+			} catch (error) {
+				logger.debug("Failed to fetch remote document:\n{error}", { error });
+				continue;
+			}
+		}
+	}
+	if (remoteDoc == null) return null;
+	let object;
+	try {
+		object = await require_actor.Object.fromJsonLd(remoteDoc.document, {
+			documentLoader,
+			contextLoader: options.contextLoader,
+			tracerProvider: options.tracerProvider,
+			baseUrl: new URL(remoteDoc.documentUrl)
+		});
+	} catch (error) {
+		if (error instanceof TypeError) {
+			logger.debug("Failed to parse JSON-LD document: {error}\n{document}", {
+				...remoteDoc,
+				error
+			});
+			return null;
+		}
+		throw error;
+	}
+	if (options.crossOrigin !== "trust" && object.id != null && object.id.origin !== new URL(remoteDoc.documentUrl).origin) {
+		if (options.crossOrigin === "throw") throw new Error(`The object's @id (${object.id.href}) has a different origin than the document URL (${remoteDoc.documentUrl}); refusing to return the object.  If you want to bypass this check and are aware of the security implications, set the crossOrigin option to "trust".`);
+		logger.warn("The object's @id ({objectId}) has a different origin than the document URL ({documentUrl}); refusing to return the object.  If you want to bypass this check and are aware of the security implications, set the crossOrigin option to \"trust\".", {
+			...remoteDoc,
+			objectId: object.id.href
+		});
+		return null;
+	}
+	return object;
+}
+/**
+* Traverses a collection, yielding each item in the collection.
+* If the collection is paginated, it will fetch the next page
+* automatically.
+*
+* @example
+* ``` typescript
+* const collection = await lookupObject(collectionUrl);
+* if (collection instanceof Collection) {
+*   for await (const item of traverseCollection(collection)) {
+*     console.log(item.id?.href);
+*   }
+* }
+* ```
+*
+* @param collection The collection to traverse.
+* @param options Options for traversing the collection.
+* @returns An async iterable of each item in the collection.
+* @since 1.1.0
+*/
+async function* traverseCollection(collection, options = {}) {
+	if (collection.firstId == null) for await (const item of collection.getItems(options)) yield item;
+	else {
+		const interval = Temporal.Duration.from(options.interval ?? { seconds: 0 }).total("millisecond");
+		let page = await collection.getFirst(options);
+		while (page != null) {
+			for await (const item of page.getItems(options)) yield item;
+			if (interval > 0) await (0, es_toolkit.delay)(interval);
+			page = await page.getNext(options);
+		}
+	}
+}
+
+//#endregion
+//#region src/vocab/constants.ts
+/**
+* The special public collection for [public addressing].  *Do not mutate this
+* object.*
+*
+* [public addressing]: https://www.w3.org/TR/activitypub/#public-addressing
+*
+* @since 0.7.0
+*/
+const PUBLIC_COLLECTION = new URL("https://www.w3.org/ns/activitystreams#Public");
+
+//#endregion
+Object.defineProperty(exports, 'PUBLIC_COLLECTION', {
+  enumerable: true,
+  get: function () {
+    return PUBLIC_COLLECTION;
+  }
+});
+Object.defineProperty(exports, 'isFediverseHandle', {
+  enumerable: true,
+  get: function () {
+    return isFediverseHandle;
+  }
+});
+Object.defineProperty(exports, 'lookupObject', {
+  enumerable: true,
+  get: function () {
+    return lookupObject;
+  }
+});
+Object.defineProperty(exports, 'parseFediverseHandle', {
+  enumerable: true,
+  get: function () {
+    return parseFediverseHandle;
+  }
+});
+Object.defineProperty(exports, 'toAcctUrl', {
+  enumerable: true,
+  get: function () {
+    return toAcctUrl;
+  }
+});
+Object.defineProperty(exports, 'traverseCollection', {
+  enumerable: true,
+  get: function () {
+    return traverseCollection;
+  }
+});

package/dist/webfinger/handler.test.js

@@ -3,35 +3,40 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Image, Link, Person } from "../type-I68qwqmo.js";
-import { assertEquals } from "../assert_equals-DSbWqCm3.js";
-import "../assert-MZs1qjMx.js";
-import "../assert_instance_of-DHz7EHNU.js";
-import { MemoryKvStore } from "../kv-CRZrzyXm.js";
-import { createFederation, handleWebFinger } from "../middleware-DakCaqXu.js";
-import "../semver-dArNLkR9.js";
-import "../client-g2FDBoeY.js";
-import "../lookup-DNQyH8UQ.js";
-import "../types-BIgY6c-l.js";
-import "../actor-7ivEf1H3.js";
-import "../key-CYOcZ9G5.js";
-import "../http-C7rxW7Kh.js";
-import "../authdocloader-D_IvQE4z.js";
-import "../ld-DWwLYT4e.js";
-import "../owner-smArESGi.js";
-import "../proof-C6z-uqeO.js";
-import "../inbox-eK2W2MF3.js";
-import "../builder-BPGqEvtB.js";
-import "../collection-CSzG2j1P.js";
-import "../keycache-BLq6GT4_.js";
-import "../retry-D4GJ670a.js";
-import "../send-1zdmNlUo.js";
-import { createRequestContext, test } from "../testing-BG_8Fyas.js";
-import "../std__assert-X-_kMxKM.js";
-import "../assert_rejects-DiIiJbZn.js";
-import "../assert_is_error-BPGph1Jx.js";
-import "../assert_not_equals-f3m3epl3.js";
-import "../assert_throws-BOO88avQ.js";
+import { test } from "../dist-lStjlyET.js";
+import { assertEquals } from "../assert_equals-Gbplq4lg.js";
+import "../assert-Dp5_aoAs.js";
+import "../assert_instance_of-D1m8F7x0.js";
+import { MemoryKvStore } from "../kv-DaWUKuhD.js";
+import "../deno-BTeveqhY.js";
+import { createFederation, handleWebFinger } from "../middleware-8Oymc6Na.js";
+import "../client-CD87uCL_.js";
+import "../router-CVRQXlZi.js";
+import "../types-D2jhK2VG.js";
+import { Image, Link, Person } from "../vocab-C3nSleOZ.js";
+import "../lookup-yv_aH7K7.js";
+import "../type-BSNcIxTd.js";
+import "../actor-DYdPViDz.js";
+import "../key-dws2_YsP.js";
+import "../http-BIDOYI9f.js";
+import "../ld-C6UrncJk.js";
+import "../owner-DQuVKHuY.js";
+import "../proof-GrivUN5L.js";
+import "../docloader-BSGGKhrl.js";
+import "../kv-cache-C6NrTtII.js";
+import "../lookup-BoiLMtAx.js";
+import "../inbox-DNjplQSR.js";
+import "../builder-CYR2yKqn.js";
+import "../collection-CrkRM5Ep.js";
+import "../keycache-BbbXRjc-.js";
+import "../negotiation-B4NJHk1f.js";
+import "../retry-Bz5pP75o.js";
+import "../send-B_dTZyUD.js";
+import "../std__assert-Cm-MfI66.js";
+import "../assert_rejects-BoKYY0g1.js";
+import "../assert_throws-DjkXin1a.js";
+import "../assert_not_equals-B2R_8p36.js";
+import { createRequestContext } from "../context-DH7LHJdw.js";
 
 //#region src/webfinger/handler.test.ts
 test("handleWebFinger()", async (t) => {
@@ -505,6 +510,34 @@ test("handleWebFinger()", async (t) => {
 		assertEquals(response.headers.get("Access-Control-Allow-Origin"), "*");
 		assertEquals(await response.json(), expectedForHostnameWithPort);
 	});
+	await t.step("webFingerLinksDispatcher", async () => {
+		const webFingerLinksDispatcher = (_ctx) => {
+			return [{
+				rel: "http://ostatus.org/schema/1.0/subscribe",
+				template: "https://example.com/follow?acct={uri}"
+			}];
+		};
+		const u = new URL(url);
+		u.searchParams.set("resource", "acct:someone@example.com");
+		const context = createContext(u);
+		const request = context.request;
+		const response = await handleWebFinger(request, {
+			context,
+			actorDispatcher,
+			webFingerLinksDispatcher,
+			onNotFound
+		});
+		assertEquals(response.status, 200);
+		const result = await response.json();
+		const expectedWithCustomLinks = {
+			...expected,
+			links: [...expected.links, {
+				rel: "http://ostatus.org/schema/1.0/subscribe",
+				template: "https://example.com/follow?acct={uri}"
+			}]
+		};
+		assertEquals(result, expectedWithCustomLinks);
+	});
 });
 
 //#endregion

package/dist/webfinger/lookup.test.js

@@ -3,18 +3,17 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { lookupWebFinger } from "../type-I68qwqmo.js";
-import { assertEquals } from "../assert_equals-DSbWqCm3.js";
-import "../assert-MZs1qjMx.js";
-import "../assert_instance_of-DHz7EHNU.js";
-import "../lookup-DNQyH8UQ.js";
-import { test } from "../testing-BG_8Fyas.js";
-import "../std__assert-X-_kMxKM.js";
-import "../assert_rejects-DiIiJbZn.js";
-import "../assert_is_error-BPGph1Jx.js";
-import "../assert_not_equals-f3m3epl3.js";
-import "../assert_throws-BOO88avQ.js";
-import { esm_default } from "../esm-CPZhxxGc.js";
+import { test } from "../dist-lStjlyET.js";
+import { assertEquals } from "../assert_equals-Gbplq4lg.js";
+import "../assert-Dp5_aoAs.js";
+import "../assert_instance_of-D1m8F7x0.js";
+import "../deno-BTeveqhY.js";
+import { lookupWebFinger } from "../lookup-yv_aH7K7.js";
+import "../std__assert-Cm-MfI66.js";
+import "../assert_rejects-BoKYY0g1.js";
+import "../assert_throws-DjkXin1a.js";
+import "../assert_not_equals-B2R_8p36.js";
+import { esm_default } from "../esm-B52TuumP.js";
 import { withTimeout } from "es-toolkit";
 
 //#region src/webfinger/lookup.test.ts

package/dist/webfinger/mod.cjs

@@ -0,0 +1,8 @@
+
+          const { Temporal } = require("@js-temporal/polyfill");
+          const { URLPattern } = require("urlpattern-polyfill");
+        
+const require_lookup = require('../lookup-BORWbouU.cjs');
+require('../webfinger-vAtLmxOF.cjs');
+
+exports.lookupWebFinger = require_lookup.lookupWebFinger;

package/dist/webfinger/mod.d.cts

@@ -0,0 +1,2 @@
+import { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger } from "../mod-C58MZ7Wx.cjs";
+export { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger };

package/dist/webfinger/mod.d.ts

@@ -1,7 +1,4 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import "../kv-C7sopW2E.js";
-import "../docloader-CxWcuWqQ.js";
-import { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger } from "../lookup-3czM5mmU.js";
-import "../mod-GIh5OYxW.js";
+import { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger } from "../mod-Ds0mpFZU.js";
 export { Link, LookupWebFingerOptions, ResourceDescriptor, lookupWebFinger };

package/dist/webfinger/mod.js

@@ -1,9 +1,8 @@
 
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-    
-import "../docloader-BlVueewg.js";
-import { lookupWebFinger } from "../lookup-BHYMosdS.js";
-import "../webfinger-C3GIyXIg.js";
+          import { Temporal } from "@js-temporal/polyfill";
+          import { URLPattern } from "urlpattern-polyfill";
+        
+import { lookupWebFinger } from "../lookup-BV72lfsA.js";
+import "../webfinger-C72Y8lrh.js";
 
 export { lookupWebFinger };

package/dist/webfinger-C72Y8lrh.js

@@ -0,0 +1,4 @@
+
+          import { Temporal } from "@js-temporal/polyfill";
+          import { URLPattern } from "urlpattern-polyfill";
+        

package/dist/webfinger-vAtLmxOF.cjs

@@ -0,0 +1,4 @@
+
+          const { Temporal } = require("@js-temporal/polyfill");
+          const { URLPattern } = require("urlpattern-polyfill");
+