@fedify/fedify 1.6.1-pr.242.867 → 1.6.1-pr.242.870

package/dist/vocab-7-nYuxr4.js

@@ -0,0 +1,172 @@
+
+      import { Temporal } from "@js-temporal/polyfill";
+      import { URLPattern } from "urlpattern-polyfill";
+    
+import { deno_default, getDocumentLoader } from "./docloader-BnNphEMr.js";
+import { Object as Object$1, getTypeId$1 as getTypeId } from "./actor-BZSxF3np.js";
+import { lookupWebFinger } from "./lookup-C1iODRax.js";
+import { getLogger } from "@logtape/logtape";
+import { SpanStatusCode, trace } from "@opentelemetry/api";
+import { delay } from "@es-toolkit/es-toolkit";
+
+//#region vocab/lookup.ts
+const logger = getLogger([
+	"fedify",
+	"vocab",
+	"lookup"
+]);
+const handleRegexp = /^@?((?:[-A-Za-z0-9._~!$&'()*+,;=]|%[A-Fa-f0-9]{2})+)@([^@]+)$/;
+/**
+* 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 ?? trace.getTracerProvider();
+	const tracer = tracerProvider.getTracer(deno_default.name, 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: SpanStatusCode.ERROR });
+			else {
+				if (result.id != null) span.setAttribute("activitypub.object.id", result.id.href);
+				span.setAttribute("activitypub.object.type", 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: SpanStatusCode.ERROR,
+				message: String(error)
+			});
+			throw error;
+		} finally {
+			span.end();
+		}
+	});
+}
+async function lookupObjectInternal(identifier, options = {}) {
+	const documentLoader = options.documentLoader ?? getDocumentLoader({ userAgent: options.userAgent });
+	if (typeof identifier === "string") {
+		const match = handleRegexp.exec(identifier);
+		if (match) identifier = `acct:${match[1]}@${match[2]}`;
+		identifier = new URL(identifier);
+	}
+	let document = null;
+	if (identifier.protocol === "http:" || identifier.protocol === "https:") try {
+		const remoteDoc = await documentLoader(identifier.href);
+		document = remoteDoc.document;
+	} catch (error) {
+		logger.debug("Failed to fetch remote document:\n{error}", { error });
+	}
+	if (document == null) {
+		const jrd = await lookupWebFinger(identifier, {
+			userAgent: options.userAgent,
+			tracerProvider: options.tracerProvider,
+			allowPrivateAddress: "allowPrivateAddress" in options && options.allowPrivateAddress === true
+		});
+		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") continue;
+			try {
+				const remoteDoc = await documentLoader(l.href);
+				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 Object$1.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 delay(interval);
+			page = await page.getNext(options);
+		}
+	}
+}
+
+//#endregion
+//#region 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
+export { PUBLIC_COLLECTION, lookupObject, traverseCollection };

package/dist/{vocab/vocab.d.ts → vocab-C4bpdeio.d.ts}

@@ -1,17 +1,29 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { DocumentLoader } from "../runtime/docloader.js";
-import { LanguageString$1 as LanguageString } from "../runtime/langstr.js";
+import { DocumentLoader } from "./docloader-DTRsVZPo.js";
 import { Span, TracerProvider } from "@opentelemetry/api";
 import { LanguageTag } from "@phensley/language-tag";
 
-//#region vocab/vocab.d.ts
-/** Describes an object of any kind. The Object type serves as the base type for
-* most of the other kinds of objects defined in the Activity Vocabulary,
-* including other Core types such as {@link Activity},
-* {@link IntransitiveActivity}, {@link Collection} and
-* {@link OrderedCollection}.
+//#region runtime/langstr.d.ts
+/**
+* A language-tagged string which corresponds to the `rdf:langString` type.
 */
+/**
+ * A language-tagged string which corresponds to the `rdf:langString` type.
+ */
+declare class LanguageString extends String {
+  readonly language: LanguageTag;
+  /**
+   * Constructs a new `LanguageString`.
+   * @param value A string value written in the given language.
+   * @param language The language of the string.  If a string is given, it will
+   *                 be parsed as a `LanguageTag`.
+   */
+  constructor(value: string, language: LanguageTag | string);
+}
+
+//#endregion
+//#region vocab/vocab.d.ts
 /** Describes an object of any kind. The Object type serves as the base type for
  * most of the other kinds of objects defined in the Activity Vocabulary,
  * including other Core types such as {@link Activity},
@@ -14445,4 +14457,4 @@ declare class View extends Activity {
 }
 
 //#endregion
-export { Accept as Accept$1, Activity as Activity$1, Add as Add$1, Announce as Announce$1, Application as Application$1, Arrive as Arrive$1, Article as Article$1, Audio as Audio$1, Block as Block$1, ChatMessage as ChatMessage$1, Collection as Collection$1, CollectionPage as CollectionPage$1, Create as Create$1, CryptographicKey as CryptographicKey$1, DataIntegrityProof as DataIntegrityProof$1, Delete as Delete$1, DidService as DidService$1, Dislike as Dislike$1, Document as Document$1, Emoji as Emoji$1, EmojiReact as EmojiReact$1, Endpoints as Endpoints$1, Event as Event$1, Export as Export$1, Flag as Flag$1, Follow as Follow$1, Group as Group$1, Hashtag as Hashtag$1, Ignore as Ignore$1, Image as Image$1, IntransitiveActivity as IntransitiveActivity$1, Invite as Invite$1, Join as Join$1, Leave as Leave$1, Like as Like$1, Link as Link$2, Listen as Listen$1, Mention as Mention$1, Move as Move$1, Multikey as Multikey$1, Note as Note$1, Object$1, Offer as Offer$1, OrderedCollection as OrderedCollection$1, OrderedCollectionPage as OrderedCollectionPage$1, Organization as Organization$1, Page as Page$1, Person as Person$1, Place as Place$1, Profile as Profile$1, PropertyValue as PropertyValue$1, Question as Question$1, Read as Read$1, Reject as Reject$1, Relationship as Relationship$1, Remove as Remove$1, Service as Service$1, Source as Source$1, TentativeAccept as TentativeAccept$1, TentativeReject as TentativeReject$1, Tombstone as Tombstone$1, Travel as Travel$1, Undo as Undo$1, Update as Update$1, Video as Video$1, View as View$1 };
+export { Accept as Accept$1, Activity as Activity$1, Add as Add$1, Announce as Announce$1, Application as Application$1, Arrive as Arrive$1, Article as Article$1, Audio as Audio$1, Block as Block$1, ChatMessage as ChatMessage$1, Collection as Collection$1, CollectionPage as CollectionPage$1, Create as Create$1, CryptographicKey as CryptographicKey$1, DataIntegrityProof as DataIntegrityProof$1, Delete as Delete$1, DidService as DidService$1, Dislike as Dislike$1, Document as Document$1, Emoji as Emoji$1, EmojiReact as EmojiReact$1, Endpoints as Endpoints$1, Event as Event$1, Export as Export$1, Flag as Flag$1, Follow as Follow$1, Group as Group$1, Hashtag as Hashtag$1, Ignore as Ignore$1, Image as Image$1, IntransitiveActivity as IntransitiveActivity$1, Invite as Invite$1, Join as Join$1, LanguageString as LanguageString$1, Leave as Leave$1, Like as Like$1, Link as Link$2, Listen as Listen$1, Mention as Mention$1, Move as Move$1, Multikey as Multikey$1, Note as Note$1, Object$1, Offer as Offer$1, OrderedCollection as OrderedCollection$1, OrderedCollectionPage as OrderedCollectionPage$1, Organization as Organization$1, Page as Page$1, Person as Person$1, Place as Place$1, Profile as Profile$1, PropertyValue as PropertyValue$1, Question as Question$1, Read as Read$1, Reject as Reject$1, Relationship as Relationship$1, Remove as Remove$1, Service as Service$1, Source as Source$1, TentativeAccept as TentativeAccept$1, TentativeReject as TentativeReject$1, Tombstone as Tombstone$1, Travel as Travel$1, Undo as Undo$1, Update as Update$1, Video as Video$1, View as View$1 };