@fedify/fedify 2.0.0-pr.433.1601 → 2.0.0-pr.434.1659

package/dist/vocab-CJ0jQMQV.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-dZO9fPIT.cjs');
+const require_actor = require('./actor-BODH8--e.cjs');
+const require_lookup = require('./lookup-C3BGNQTz.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;
+  }
+});

package/dist/{vocab-ClXayeh5.js → vocab-C_Pm3NG3.js}

@@ -1,10 +1,10 @@
 
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-    
-import { deno_default, getDocumentLoader } from "./docloader-C5a95do5.js";
-import { Object as Object$1, getTypeId } from "./actor-BYk33gpL.js";
-import { lookupWebFinger } from "./lookup-BnXYO054.js";
+          import { Temporal } from "@js-temporal/polyfill";
+          import { URLPattern } from "urlpattern-polyfill";
+        
+import { deno_default, getDocumentLoader } from "./docloader-DrPHprgh.js";
+import { Object as Object$1, getTypeId } from "./actor-DJS2ne1f.js";
+import { lookupWebFinger } from "./lookup-C3BC8XO-.js";
 import { getLogger } from "@logtape/logtape";
 import { SpanStatusCode, trace } from "@opentelemetry/api";
 import { delay } from "es-toolkit";