@fedify/fedify 2.0.0-dev.1561 → 2.0.0-dev.158

package/dist/lookup-IyAhz9I6.js

@@ -1,322 +0,0 @@
-
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-      globalThis.addEventListener = () => {};
-    
-import { Object as Object$1, deno_default, getDocumentLoader, getTypeId, lookupWebFinger } from "./type-BMGxK0zE.js";
-import { cloneDeep, delay } from "es-toolkit";
-import { getLogger } from "@logtape/logtape";
-import { SpanStatusCode, trace } from "@opentelemetry/api";
-import { Router } from "uri-template-router";
-import { parseTemplate } from "url-template";
-
-//#region src/federation/router.ts
-function cloneInnerRouter(router) {
-	const clone = new Router();
-	clone.nid = router.nid;
-	clone.fsm = cloneDeep(router.fsm);
-	clone.routeSet = new Set(router.routeSet);
-	clone.templateRouteMap = new Map(router.templateRouteMap);
-	clone.valueRouteMap = new Map(router.valueRouteMap);
-	clone.hierarchy = cloneDeep(router.hierarchy);
-	return clone;
-}
-/**
-* URL router and constructor based on URI Template
-* ([RFC 6570](https://tools.ietf.org/html/rfc6570)).
-*/
-var Router$1 = class Router$1 {
-	#router;
-	#templates;
-	#templateStrings;
-	/**
-	* Whether to ignore trailing slashes when matching paths.
-	* @since 1.6.0
-	*/
-	trailingSlashInsensitive;
-	/**
-	* Create a new {@link Router}.
-	* @param options Options for the router.
-	*/
-	constructor(options = {}) {
-		this.#router = new Router();
-		this.#templates = {};
-		this.#templateStrings = {};
-		this.trailingSlashInsensitive = options.trailingSlashInsensitive ?? false;
-	}
-	clone() {
-		const clone = new Router$1({ trailingSlashInsensitive: this.trailingSlashInsensitive });
-		clone.#router = cloneInnerRouter(this.#router);
-		clone.#templates = { ...this.#templates };
-		clone.#templateStrings = { ...this.#templateStrings };
-		return clone;
-	}
-	/**
-	* Checks if a path name exists in the router.
-	* @param name The name of the path.
-	* @returns `true` if the path name exists, otherwise `false`.
-	*/
-	has(name) {
-		return name in this.#templates;
-	}
-	/**
-	* Adds a new path rule to the router.
-	* @param template The path pattern.
-	* @param name The name of the path.
-	* @returns The names of the variables in the path pattern.
-	*/
-	add(template, name) {
-		if (!template.startsWith("/")) throw new RouterError("Path must start with a slash.");
-		const rule = this.#router.addTemplate(template, {}, name);
-		this.#templates[name] = parseTemplate(template);
-		this.#templateStrings[name] = template;
-		return new Set(rule.variables.map((v) => v.varname));
-	}
-	/**
-	* Resolves a path name and values from a URL, if any match.
-	* @param url The URL to resolve.
-	* @returns The name of the path and its values, if any match.  Otherwise,
-	*          `null`.
-	*/
-	route(url) {
-		let match = this.#router.resolveURI(url);
-		if (match == null) {
-			if (!this.trailingSlashInsensitive) return null;
-			url = url.endsWith("/") ? url.replace(/\/+$/, "") : `${url}/`;
-			match = this.#router.resolveURI(url);
-			if (match == null) return null;
-		}
-		return {
-			name: match.matchValue,
-			template: this.#templateStrings[match.matchValue],
-			values: match.params
-		};
-	}
-	/**
-	* Constructs a URL/path from a path name and values.
-	* @param name The name of the path.
-	* @param values The values to expand the path with.
-	* @returns The URL/path, if the name exists.  Otherwise, `null`.
-	*/
-	build(name, values) {
-		if (name in this.#templates) return this.#templates[name].expand(values);
-		return null;
-	}
-};
-/**
-* An error thrown by the {@link Router}.
-*/
-var RouterError = class extends Error {
-	/**
-	* Create a new {@link RouterError}.
-	* @param message The error message.
-	*/
-	constructor(message) {
-		super(message);
-		this.name = "RouterError";
-	}
-};
-
-//#endregion
-//#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;
-}
-/**
-* 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 = 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 ?? 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") 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 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 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
-export { Router$1 as Router, RouterError, lookupObject, traverseCollection };

package/dist/middleware-Bx6Sgkth.js

@@ -1,26 +0,0 @@
-
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-      globalThis.addEventListener = () => {};
-    
-import "./type-BMGxK0zE.js";
-import { ContextImpl, FederationImpl, InboxContextImpl, KvSpecDeterminer, createFederation } from "./middleware-CUw3Ys9y.js";
-import "./semver-dArNLkR9.js";
-import "./client-DI0GS_3p.js";
-import "./lookup-IyAhz9I6.js";
-import "./types-BIgY6c-l.js";
-import "./actor-mhluotIb.js";
-import "./key-olV6hEgm.js";
-import "./http-DTJgsmYR.js";
-import "./authdocloader-CN-tWO4K.js";
-import "./ld-DR6b11xZ.js";
-import "./owner-BtFz-dZ-.js";
-import "./proof-DsZjVJ0G.js";
-import "./inbox-Dx8EjUbq.js";
-import "./builder-C8mpxJD3.js";
-import "./collection-CSzG2j1P.js";
-import "./keycache-CExtp4Yl.js";
-import "./retry-D4GJ670a.js";
-import "./send-s0_EjVhZ.js";
-
-export { FederationImpl };

package/dist/middleware-DdRB1d4s.js

@@ -1,17 +0,0 @@
-
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-    
-import "./transformers-Dna8Fg7k.js";
-import "./docloader-DIjo5mkd.js";
-import "./actor-Qc3Ee6k1.js";
-import { ContextImpl, FederationImpl, InboxContextImpl, KvSpecDeterminer, createFederation } from "./middleware-GT7W03qw.js";
-import "./lookup-B8Ld9P9G.js";
-import "./key-CGjkGPkw.js";
-import "./http-B_tXwHIe.js";
-import "./proof-DKDM7T5F.js";
-import "./types-CGB4mJU6.js";
-import "./authdocloader-Dp9WS-1G.js";
-import "./vocab-CXuKLJjd.js";
-
-export { FederationImpl };

package/dist/mod-Cxt4Kpf6.d.ts

@@ -1,291 +0,0 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { URLPattern } from "urlpattern-polyfill";
-import { DocumentLoader, GetUserAgentOptions } from "./docloader-CxWcuWqQ.js";
-import { Collection, Link, Object as Object$1 } from "./vocab-SOE1ifCr.js";
-import { TracerProvider } from "@opentelemetry/api";
-
-//#region src/vocab/lookup.d.ts
-/**
- * Options for the {@link lookupObject} function.
- *
- * @since 0.2.0
- */
-interface LookupObjectOptions {
-  /**
-   * The document loader for loading remote JSON-LD documents.
-   */
-  documentLoader?: DocumentLoader;
-  /**
-   * The context loader for loading remote JSON-LD contexts.
-   * @since 0.8.0
-   */
-  contextLoader?: DocumentLoader;
-  /**
-   * The options for making `User-Agent` header.
-   * If a string is given, it is used as the `User-Agent` header value.
-   * If an object is given, it is passed to {@link getUserAgent} to generate
-   * the `User-Agent` header value.
-   * @since 1.3.0
-   */
-  userAgent?: GetUserAgentOptions | string;
-  /**
-   * The OpenTelemetry tracer provider.  If omitted, the global tracer provider
-   * is used.
-   * @since 1.3.0
-   */
-  tracerProvider?: TracerProvider;
-  /**
-   * AbortSignal for cancelling the request.
-   * @since 1.8.0
-   */
-  signal?: AbortSignal;
-}
-/**
- * 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
- */
-declare function lookupObject(identifier: string | URL, options?: LookupObjectOptions): Promise<Object$1 | null>;
-/**
- * Options for the {@link traverseCollection} function.
- * @since 1.1.0
- */
-interface TraverseCollectionOptions {
-  /**
-   * The document loader for loading remote JSON-LD documents.
-   */
-  documentLoader?: DocumentLoader;
-  /**
-   * The context loader for loading remote JSON-LD contexts.
-   */
-  contextLoader?: DocumentLoader;
-  /**
-   * Whether to suppress errors when fetching pages.  If `true`,
-   * errors will be logged but not thrown.  Defaults to `false`.
-   */
-  suppressError?: boolean;
-  /**
-   * The interval to wait between fetching pages.  Zero or negative
-   * values will disable the interval.  Disabled by default.
-   *
-   * @default `{ seconds: 0 }`
-   */
-  interval?: Temporal.Duration | Temporal.DurationLike;
-}
-/**
- * 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
- */
-declare function traverseCollection(collection: Collection, options?: TraverseCollectionOptions): AsyncIterable<Object$1 | Link>;
-//#endregion
-//#region src/vocab/constants.d.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
- */
-declare const PUBLIC_COLLECTION: URL;
-//#endregion
-//#region src/vocab/handle.d.ts
-/**
- * Represents a fediverse handle, which consists of a username and a host.
- * The username can be alphanumeric and may include special characters,
- * while the host is typically a domain name.
- * @since 1.8.0
- */
-interface FediverseHandle {
-  /**
-   * The username part of the fediverse handle.
-   * It can include alphanumeric characters and some special characters.
-   */
-  readonly username: string;
-  /**
-   * The host part of the fediverse handle, typically a domain name.
-   * It is the part after the `@` symbol in the handle.
-   */
-  readonly host: string;
-}
-/**
- * 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
- */
-declare function parseFediverseHandle(handle: string): FediverseHandle | 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
- */
-declare function isFediverseHandle(handle: string): handle is `${string}@${string}`;
-/**
- * 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
- */
-declare function toAcctUrl(handle: string): URL | null;
-//#endregion
-//#region src/vocab/type.d.ts
-/**
- * Returns the type URI of the given object.
- *
- * @example
- * ``` typescript
- * import { getTypeId, Person } from "@fedify/fedify";
- *
- * const obj = new Person({});
- * console.log(getTypeId(obj));
- * // => new URL("https://www.w3.org/ns/activitystreams#Person")
- * ```
- *
- * @param object The Activity Vocabulary object.
- * @returns The type URI of the object, e.g.,
- *          `new URL("https://www.w3.org/ns/activitystreams#Person")`.
- *          If the given `object` is `null` or `undefined`, returns `null` or
- *          `undefined`, respectively.
- * @since 1.3.0
- */
-declare function getTypeId(object: Object$1 | Link): URL;
-/**
- * Returns the type URI of the given object.
- *
- * @example
- * ``` typescript
- * import { getTypeId, Person } from "@fedify/fedify";
- *
- * const obj = new Person({});
- * console.log(getTypeId(obj));
- * // => new URL("https://www.w3.org/ns/activitystreams#Person")
- * ```
- *
- * @param object The Activity Vocabulary object.
- * @returns The type URI of the object, e.g.,
- *          `new URL("https://www.w3.org/ns/activitystreams#Person")`.
- *          If the given `object` is `null` or `undefined`, returns `null` or
- *          `undefined`, respectively.
- * @since 1.3.0
- */
-declare function getTypeId(object: Object$1 | Link | undefined): URL | undefined;
-/**
- * Returns the type URI of the given object.
- *
- * @example
- * ``` typescript
- * import { getTypeId, Person } from "@fedify/fedify";
- *
- * const obj = new Person({});
- * console.log(getTypeId(obj));
- * // => new URL("https://www.w3.org/ns/activitystreams#Person")
- * ```
- *
- * @param object The Activity Vocabulary object.
- * @returns The type URI of the object, e.g.,
- *          `new URL("https://www.w3.org/ns/activitystreams#Person")`.
- *          If the given `object` is `null` or `undefined`, returns `null` or
- *          `undefined`, respectively.
- * @since 1.3.0
- */
-declare function getTypeId(object: Object$1 | Link | null): URL | null;
-/**
- * Returns the type URI of the given object.
- *
- * @example
- * ``` typescript
- * import { getTypeId, Person } from "@fedify/fedify";
- *
- * const obj = new Person({});
- * console.log(getTypeId(obj));
- * // => new URL("https://www.w3.org/ns/activitystreams#Person")
- * ```
- *
- * @param object The Activity Vocabulary object.
- * @returns The type URI of the object, e.g.,
- *          `new URL("https://www.w3.org/ns/activitystreams#Person")`.
- *          If the given `object` is `null` or `undefined`, returns `null` or
- *          `undefined`, respectively.
- * @since 1.3.0
- */
-declare function getTypeId(object: Object$1 | Link | null | undefined): URL | null | undefined;
-//#endregion
-export { FediverseHandle, LookupObjectOptions, PUBLIC_COLLECTION, TraverseCollectionOptions, getTypeId, isFediverseHandle, lookupObject, parseFediverseHandle, toAcctUrl, traverseCollection };