@fedify/fedify 2.0.0-dev.1593 → 2.0.0-dev.1641

package/dist/vocab/mod.d.cts

@@ -0,0 +1,6 @@
+import "../kv-63Cil1MD.cjs";
+import "../docloader-D-MrRyHl.cjs";
+import { Accept, Activity, Add, Announce, 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, IntransitiveActivity, Invite, Join, Leave, Like, Link, Listen, Mention, Move, Multikey, Note, Object as Object$1, Offer, OrderedCollection, OrderedCollectionPage, Organization, Page, Person, Place, Profile, PropertyValue, Question, Read, Reject, Relationship, Remove, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, Undo, Update, Video, View } from "../vocab-DJTYMqyU.cjs";
+import { Actor, ActorTypeName, GetActorHandleOptions, NormalizeActorHandleOptions, Recipient, getActorClassByTypeName, getActorHandle, getActorTypeName, isActor, normalizeActorHandle } from "../actor-DMgu-ZjT.cjs";
+import { FediverseHandle, LookupObjectOptions, PUBLIC_COLLECTION, TraverseCollectionOptions, getTypeId, isFediverseHandle, lookupObject, parseFediverseHandle, toAcctUrl, traverseCollection } from "../mod-evzlRVZq.cjs";
+export { Accept, Activity, Actor, ActorTypeName, Add, Announce, Application, Arrive, Article, Audio, Block, ChatMessage, Collection, CollectionPage, Create, CryptographicKey, DataIntegrityProof, Delete, DidService, Dislike, Document, Emoji, EmojiReact, Endpoints, Event, Export, FediverseHandle, Flag, Follow, GetActorHandleOptions, Group, Hashtag, Ignore, Image, IntransitiveActivity, Invite, Join, Leave, Like, Link, Listen, LookupObjectOptions, Mention, Move, Multikey, NormalizeActorHandleOptions, Note, Object$1 as Object, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Question, Read, Recipient, Reject, Relationship, Remove, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, TraverseCollectionOptions, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getTypeId, isActor, isFediverseHandle, lookupObject, normalizeActorHandle, parseFediverseHandle, toAcctUrl, traverseCollection };

package/dist/vocab/mod.js

@@ -1,10 +1,10 @@
 
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-    
-import "../docloader-9_osWaaH.js";
-import { Accept, Activity, Add, Announce, 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, IntransitiveActivity, Invite, Join, Leave, Like, Link, Listen, Mention, Move, Multikey, Note, Object as Object$1, Offer, OrderedCollection, OrderedCollectionPage, Organization, Page, Person, Place, Profile, PropertyValue, Question, Read, Reject, Relationship, Remove, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getTypeId, isActor, normalizeActorHandle } from "../actor-DNwcqwPT.js";
-import "../lookup-BNFlahf3.js";
-import { PUBLIC_COLLECTION, isFediverseHandle, lookupObject, parseFediverseHandle, toAcctUrl, traverseCollection } from "../vocab-r-I1_ZmK.js";
+          import { Temporal } from "@js-temporal/polyfill";
+          import { URLPattern } from "urlpattern-polyfill";
+        
+import "../docloader-BtqIh1OE.js";
+import { Accept, Activity, Add, Announce, 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, IntransitiveActivity, Invite, Join, Leave, Like, Link, Listen, Mention, Move, Multikey, Note, Object as Object$1, Offer, OrderedCollection, OrderedCollectionPage, Organization, Page, Person, Place, Profile, PropertyValue, Question, Read, Reject, Relationship, Remove, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getTypeId, isActor, normalizeActorHandle } from "../actor-DU511yTk.js";
+import "../lookup-NuT9cCSl.js";
+import { PUBLIC_COLLECTION, isFediverseHandle, lookupObject, parseFediverseHandle, toAcctUrl, traverseCollection } from "../vocab-lBFcVxVF.js";
 
 export { Accept, Activity, Add, Announce, 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, IntransitiveActivity, Invite, Join, Leave, Like, Link, Listen, Mention, Move, Multikey, Note, Object$1 as Object, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Question, Read, Reject, Relationship, Remove, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getTypeId, isActor, isFediverseHandle, lookupObject, normalizeActorHandle, parseFediverseHandle, toAcctUrl, traverseCollection };

package/dist/vocab/type.test.js

@@ -3,10 +3,10 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Person, getTypeId } from "../type-qs0mWLTm.js";
+import { Person, getTypeId } from "../type-B4NJkfVg.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
-import "../lookup-CnJK1NUl.js";
-import { test } from "../testing-D4xRiVJV.js";
+import "../lookup-CiU3QxQz.js";
+import { test } from "../testing-ByQmUvf-.js";
 
 //#region src/vocab/type.test.ts
 test("getTypeId()", () => {

package/dist/vocab/vocab.test.js

@@ -3,18 +3,18 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { Activity, Announce, Collection, Create, CryptographicKey, Follow, Hashtag, LanguageString, Note, Object as Object$1, OrderedCollectionPage, Person, Place, Question, Source, decode, vocab_exports } from "../type-qs0mWLTm.js";
+import { Activity, Announce, Collection, Create, CryptographicKey, Follow, Hashtag, LanguageString, Link, Note, Object as Object$1, OrderedCollectionPage, Person, Place, Question, Source, decode, vocab_exports } from "../type-B4NJkfVg.js";
 import { assertEquals } from "../assert_equals-DSbWqCm3.js";
 import { assert } from "../assert-MZs1qjMx.js";
 import { assertInstanceOf } from "../assert_instance_of-DHz7EHNU.js";
-import "../lookup-CnJK1NUl.js";
-import { mockDocumentLoader, test } from "../testing-D4xRiVJV.js";
-import "../std__assert-X-_kMxKM.js";
-import { assertFalse, assertRejects } from "../assert_rejects-DiIiJbZn.js";
-import "../assert_is_error-BPGph1Jx.js";
-import { assertNotEquals } from "../assert_not_equals-f3m3epl3.js";
-import { assertThrows } from "../assert_throws-BOO88avQ.js";
-import { ed25519PublicKey, rsaPublicKey1 } from "../keys-DSk2aqlj.js";
+import "../lookup-CiU3QxQz.js";
+import { mockDocumentLoader, test } from "../testing-ByQmUvf-.js";
+import "../std__assert-DWivtrGR.js";
+import { assertFalse, assertRejects } from "../assert_rejects-7UF4R_Qs.js";
+import "../assert_is_error-B035L3om.js";
+import { assertNotEquals } from "../assert_not_equals-C80BG-_5.js";
+import { assertThrows } from "../assert_throws-53_pKeP3.js";
+import { ed25519PublicKey, rsaPublicKey1 } from "../keys-CBKbYaJA.js";
 import { pascalCase } from "es-toolkit";
 import { Validator } from "@cfworker/json-schema";
 import { readFile, readdir } from "node:fs/promises";
@@ -2241,7 +2241,20 @@ const scalarTypes = {
         && ${v}["@id"] !== "" && ${v}["@id"] !== "/"`;
 		},
 		decoder(v) {
-			return `new URL(${v}["@id"])`;
+			return `${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))
+              : ""
+          )
+        )
+        : new URL(${v}["@id"])`;
 		}
 	},
 	"http://www.w3.org/1999/02/22-rdf-syntax-ns#langString": {
@@ -3059,6 +3072,28 @@ test("Actor.getOutbox()", async () => {
 	assertInstanceOf(outbox, OrderedCollectionPage);
 	assertEquals(outbox.totalItems, 1);
 });
+test("Link.fromJsonLd()", async () => {
+	const link = await Link.fromJsonLd({
+		"@context": "https://www.w3.org/ns/activitystreams",
+		"type": "Link",
+		"rel": "canonical",
+		"href": "at://did:plc:ia76kvnndjutgedggx2ibrem/app.bsky.feed.post/3lyxjjs27jkqg"
+	});
+	assertEquals(link.rel, "canonical");
+	assertEquals(link.href, new URL("at://did%3Aplc%3Aia76kvnndjutgedggx2ibrem/app.bsky.feed.post/3lyxjjs27jkqg"));
+	const link2 = await Link.fromJsonLd({
+		"@context": "https://www.w3.org/ns/activitystreams",
+		"type": "Link",
+		"href": "at://bnewbold.bsky.team/app.bsky.feed.post/3jwdwj2ctlk26"
+	});
+	assertEquals(link2.href, new URL("at://bnewbold.bsky.team/app.bsky.feed.post/3jwdwj2ctlk26"));
+	const link3 = await Link.fromJsonLd({
+		"@context": "https://www.w3.org/ns/activitystreams",
+		"type": "Link",
+		"href": "at://did:plc:ia76kvnndjutgedggx2ibrem"
+	});
+	assertEquals(link3.href, new URL("at://did%3Aplc%3Aia76kvnndjutgedggx2ibrem"));
+});
 function getAllProperties(type, types$1) {
 	const props = type.properties;
 	if (type.extends != null) props.push(...getAllProperties(types$1[type.extends], types$1));

package/dist/vocab-B0-5a8pw.cjs

@@ -0,0 +1,282 @@
+
+          const { Temporal } = require("@js-temporal/polyfill");
+          const { URLPattern } = require("urlpattern-polyfill");
+        
+const require_chunk = require('./chunk-DqRYRqnO.cjs');
+const require_docloader = require('./docloader-kae6M-GI.cjs');
+const require_actor = require('./actor-CP03csrm.cjs');
+const require_lookup = require('./lookup-QHjmy4Og.cjs');
+const __logtape_logtape = require_chunk.__toESM(require("@logtape/logtape"));
+const __opentelemetry_api = require_chunk.__toESM(require("@opentelemetry/api"));
+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_docloader.deno_default.name, require_docloader.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));
+			}
+			return result;
+		} catch (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 ?? require_docloader.getDocumentLoader({ userAgent: options.userAgent });
+	if (typeof identifier === "string") identifier = toAcctUrl(identifier) ?? new URL(identifier);
+	let document = null;
+	if (identifier.protocol === "http:" || identifier.protocol === "https:") try {
+		const remoteDoc = await documentLoader(identifier.href, { signal: options.signal });
+		document = remoteDoc.document;
+	} catch (error) {
+		logger.debug("Failed to fetch remote document:\n{error}", { error });
+	}
+	if (document == 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 {
+				const remoteDoc = await documentLoader(l.href, { signal: options.signal });
+				document = remoteDoc.document;
+				break;
+			} catch (error) {
+				logger.debug("Failed to fetch remote document:\n{error}", { error });
+				continue;
+			}
+		}
+	}
+	if (document == null) return null;
+	try {
+		return await require_actor.Object.fromJsonLd(document, {
+			documentLoader,
+			contextLoader: options.contextLoader,
+			tracerProvider: options.tracerProvider
+		});
+	} catch (error) {
+		if (error instanceof TypeError) {
+			logger.debug("Failed to parse JSON-LD document: {error}\n{document}", {
+				error,
+				document
+			});
+			return null;
+		}
+		throw error;
+	}
+}
+/**
+* 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;
+  }
+});