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

package/dist/actor-mhluotIb.js

@@ -1,146 +0,0 @@
-
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-      globalThis.addEventListener = () => {};
-    
-import { Application, Group, Organization, Person, Service, deno_default, getTypeId, lookupWebFinger } from "./type-BMGxK0zE.js";
-import { SpanStatusCode, trace } from "@opentelemetry/api";
-import { domainToASCII, domainToUnicode } from "node:url";
-
-//#region src/vocab/actor.ts
-/**
-* Checks if the given object is an {@link Actor}.
-* @param object The object to check.
-* @returns `true` if the given object is an {@link Actor}.
-*/
-function isActor(object) {
-	return object instanceof Application || object instanceof Group || object instanceof Organization || object instanceof Person || object instanceof Service;
-}
-/**
-* Gets the type name of the given actor.
-* @param actor The actor to get the type name of.
-* @returns The type name of the given actor.
-*/
-function getActorTypeName(actor) {
-	if (actor instanceof Application) return "Application";
-	else if (actor instanceof Group) return "Group";
-	else if (actor instanceof Organization) return "Organization";
-	else if (actor instanceof Person) return "Person";
-	else if (actor instanceof Service) return "Service";
-	throw new Error("Unknown actor type.");
-}
-/**
-* Gets the actor class by the given type name.
-* @param typeName The type name to get the actor class by.
-* @returns The actor class by the given type name.
-*/
-function getActorClassByTypeName(typeName) {
-	switch (typeName) {
-		case "Application": return Application;
-		case "Group": return Group;
-		case "Organization": return Organization;
-		case "Person": return Person;
-		case "Service": return Service;
-	}
-	throw new Error("Unknown actor type name.");
-}
-/**
-* Gets the actor handle, of the form `@username@domain`, from the given actor
-* or an actor URI.
-*
-* @example
-* ``` typescript
-* // Get the handle of an actor object:
-* await getActorHandle(
-*   new Person({ id: new URL("https://fosstodon.org/users/hongminhee") })
-* );
-*
-* // Get the handle of an actor URI:
-* await getActorHandle(new URL("https://fosstodon.org/users/hongminhee"));
-* ```
-*
-* @param actor The actor or actor URI to get the handle from.
-* @param options The extra options for getting the actor handle.
-* @returns The actor handle.  It starts with `@` and is followed by the
-*          username and domain, separated by `@` by default (it can be
-*          customized with the options).
-* @throws {TypeError} If the actor does not have enough information to get the
-*                     handle.
-* @since 0.4.0
-*/
-async function getActorHandle(actor, options = {}) {
-	const tracerProvider = options.tracerProvider ?? trace.getTracerProvider();
-	const tracer = tracerProvider.getTracer(deno_default.name, deno_default.version);
-	return await tracer.startActiveSpan("activitypub.get_actor_handle", async (span) => {
-		if (isActor(actor)) {
-			if (actor.id != null) span.setAttribute("activitypub.actor.id", actor.id.href);
-			span.setAttribute("activitypub.actor.type", getTypeId(actor).href);
-		}
-		try {
-			return await getActorHandleInternal(actor, options);
-		} catch (error) {
-			span.setStatus({
-				code: SpanStatusCode.ERROR,
-				message: String(error)
-			});
-			throw error;
-		} finally {
-			span.end();
-		}
-	});
-}
-async function getActorHandleInternal(actor, options = {}) {
-	const actorId = actor instanceof URL ? actor : actor.id;
-	if (actorId != null) {
-		const result = await lookupWebFinger(actorId, {
-			userAgent: options.userAgent,
-			tracerProvider: options.tracerProvider
-		});
-		if (result != null) {
-			const aliases = [...result.aliases ?? []];
-			if (result.subject != null) aliases.unshift(result.subject);
-			for (const alias of aliases) {
-				const match = alias.match(/^acct:([^@]+)@([^@]+)$/);
-				if (match != null) {
-					const hostname = new URL(`https://${match[2]}/`).hostname;
-					if (hostname !== actorId.hostname && !await verifyCrossOriginActorHandle(actorId.href, alias, options.userAgent, options.tracerProvider)) continue;
-					return normalizeActorHandle(`@${match[1]}@${match[2]}`, options);
-				}
-			}
-		}
-	}
-	if (!(actor instanceof URL) && actor.preferredUsername != null && actor.id != null) return normalizeActorHandle(`@${actor.preferredUsername}@${actor.id.host}`, options);
-	throw new TypeError("Actor does not have enough information to get the handle.");
-}
-async function verifyCrossOriginActorHandle(actorId, alias, userAgent, tracerProvider) {
-	const response = await lookupWebFinger(alias, {
-		userAgent,
-		tracerProvider
-	});
-	if (response == null) return false;
-	for (const alias$1 of response.aliases ?? []) if (new URL(alias$1).href === actorId) return true;
-	return false;
-}
-/**
-* Normalizes the given actor handle.
-* @param handle The full handle of the actor to normalize.
-* @param options The options for normalizing the actor handle.
-* @returns The normalized actor handle.
-* @throws {TypeError} If the actor handle is invalid.
-* @since 0.9.0
-*/
-function normalizeActorHandle(handle, options = {}) {
-	handle = handle.replace(/^@/, "");
-	const atPos = handle.indexOf("@");
-	if (atPos < 1) throw new TypeError("Invalid actor handle.");
-	let domain = handle.substring(atPos + 1);
-	if (domain.length < 1 || domain.includes("@")) throw new TypeError("Invalid actor handle.");
-	domain = domain.toLowerCase();
-	domain = options.punycode ? domainToASCII(domain) : domainToUnicode(domain);
-	domain = domain.toLowerCase();
-	const user = handle.substring(0, atPos);
-	return options.trimLeadingAt ? `${user}@${domain}` : `@${user}@${domain}`;
-}
-
-//#endregion
-export { getActorClassByTypeName, getActorHandle, getActorTypeName, isActor, normalizeActorHandle };

package/dist/assert_throws-BOO88avQ.js

@@ -1,39 +0,0 @@
-
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-      globalThis.addEventListener = () => {};
-    
-import { AssertionError } from "./assert_equals-DSbWqCm3.js";
-import { assertIsError } from "./assert_is_error-BPGph1Jx.js";
-
-//#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_throws.js
-function assertThrows(fn, errorClassOrMsg, msgIncludesOrMsg, msg) {
-	let ErrorClass = void 0;
-	let msgIncludes = void 0;
-	let err;
-	if (typeof errorClassOrMsg !== "string") if (errorClassOrMsg === void 0 || errorClassOrMsg?.prototype instanceof Error || errorClassOrMsg?.prototype === Error.prototype) {
-		ErrorClass = errorClassOrMsg;
-		msgIncludes = msgIncludesOrMsg;
-	} else msg = msgIncludesOrMsg;
-	else msg = errorClassOrMsg;
-	let doesThrow = false;
-	const msgSuffix = msg ? `: ${msg}` : ".";
-	try {
-		fn();
-	} catch (error) {
-		if (ErrorClass) {
-			if (error instanceof Error === false) throw new AssertionError(`A non-Error object was thrown${msgSuffix}`);
-			assertIsError(error, ErrorClass, msgIncludes, msg);
-		}
-		err = error;
-		doesThrow = true;
-	}
-	if (!doesThrow) {
-		msg = `Expected function to throw${msgSuffix}`;
-		throw new AssertionError(msg);
-	}
-	return err;
-}
-
-//#endregion
-export { assertThrows };

package/dist/authdocloader-Dp9WS-1G.js

@@ -1,52 +0,0 @@
-
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-    
-import { UrlError, createRequest, getRemoteDocument, logRequest, validatePublicUrl } from "./docloader-DIjo5mkd.js";
-import { validateCryptoKey } from "./key-CGjkGPkw.js";
-import { doubleKnock } from "./http-B_tXwHIe.js";
-import { getLogger } from "@logtape/logtape";
-
-//#region src/runtime/authdocloader.ts
-const logger = getLogger([
-	"fedify",
-	"runtime",
-	"docloader"
-]);
-/**
-* Gets an authenticated {@link DocumentLoader} for the given identity.
-* Note that an authenticated document loader intentionally does not cache
-* the fetched documents.
-* @param identity The identity to get the document loader for.
-*                 The actor's key pair.
-* @param options The options for the document loader.
-* @returns The authenticated document loader.
-* @throws {TypeError} If the key is invalid or unsupported.
-* @since 0.4.0
-*/
-function getAuthenticatedDocumentLoader(identity, { allowPrivateAddress, userAgent, specDeterminer, tracerProvider } = {}) {
-	validateCryptoKey(identity.privateKey);
-	async function load(url, options) {
-		if (!allowPrivateAddress) try {
-			await validatePublicUrl(url);
-		} catch (error) {
-			if (error instanceof UrlError) logger.error("Disallowed private URL: {url}", {
-				url,
-				error
-			});
-			throw error;
-		}
-		const originalRequest = createRequest(url, { userAgent });
-		const response = await doubleKnock(originalRequest, identity, {
-			specDeterminer,
-			log: logRequest,
-			tracerProvider,
-			signal: options?.signal
-		});
-		return getRemoteDocument(url, response, load);
-	}
-	return load;
-}
-
-//#endregion
-export { getAuthenticatedDocumentLoader };

package/dist/compat-Bb5myD13.js

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

package/dist/denokv-Bv33Xxea.js

@@ -1,57 +0,0 @@
-
-      import { Temporal } from "@js-temporal/polyfill";
-      import { URLPattern } from "urlpattern-polyfill";
-      globalThis.addEventListener = () => {};
-    
-import { isEqual } from "es-toolkit";
-import { getLogger } from "@logtape/logtape";
-
-//#region src/x/denokv.ts
-/**
-* Represents a message queue adapter that uses Deno KV store.
-*
-* @deprecated This class has been moved to `@fedify/denokv` package.
-*             Import `DenoKvMessageQueue` from `@fedify/denokv` instead.
-*             This class will be removed in Fedify v2.0.
-*/
-var DenoKvMessageQueue = class {
-	#kv;
-	/**
-	* Deno KV queues provide automatic retry with exponential backoff.
-	* @since 1.7.0
-	*/
-	nativeRetrial = true;
-	/**
-	* Constructs a new {@link DenoKvMessageQueue} adapter with the given Deno KV
-	* store.
-	* @param kv The Deno KV store to use.
-	*/
-	constructor(kv) {
-		const logger = getLogger(["fedify", "denokv"]);
-		logger.warn("The `@fedify/fedify/x/denokv` module is deprecated; use `DenoKvMessageQueue` from `@fedify/denokv` package instead.");
-		this.#kv = kv;
-	}
-	async enqueue(message, options) {
-		await this.#kv.enqueue(message, options?.delay == null ? void 0 : { delay: Math.max(options.delay.total("millisecond"), 0) });
-	}
-	listen(handler, options = {}) {
-		options.signal?.addEventListener("abort", () => {
-			try {
-				this.#kv.close();
-			} catch (e) {
-				if (!(e instanceof Deno.errors.BadResource)) throw e;
-			}
-		}, { once: true });
-		return this.#kv.listenQueue(handler);
-	}
-	[Symbol.dispose]() {
-		try {
-			this.#kv.close();
-		} catch (e) {
-			if (!(e instanceof Deno.errors.BadResource)) throw e;
-		}
-	}
-};
-
-//#endregion
-export { DenoKvMessageQueue };

package/dist/docloader-CxWcuWqQ.d.ts

@@ -1,221 +0,0 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { URLPattern } from "urlpattern-polyfill";
-import { KvKey, KvStore } from "./kv-C7sopW2E.js";
-
-//#region src/runtime/docloader.d.ts
-/**
- * A remote JSON-LD document and its context fetched by
- * a {@link DocumentLoader}.
- */
-interface RemoteDocument {
-  /**
-   * The URL of the context document.
-   */
-  contextUrl: string | null;
-  /**
-   * The fetched JSON-LD document.
-   */
-  document: unknown;
-  /**
-   * The URL of the fetched document.
-   */
-  documentUrl: string;
-}
-/**
- * Options for {@link DocumentLoader}.
- * @since 1.8.0
- */
-interface DocumentLoaderOptions {
-  /**
-   * An `AbortSignal` for cancellation.
-   * @since 1.8.0
-   */
-  signal?: AbortSignal;
-}
-/**
- * A JSON-LD document loader that fetches documents from the Web.
- * @param url The URL of the document to load.
- * @param options The options for the document loader.
- * @returns The loaded remote document.
- */
-type DocumentLoader = (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>;
-/**
- * A factory function that creates a {@link DocumentLoader} with options.
- * @param options The options for the document loader.
- * @returns The document loader.
- * @since 1.4.0
- */
-type DocumentLoaderFactory = (options?: DocumentLoaderFactoryOptions) => DocumentLoader;
-/**
- * Options for {@link DocumentLoaderFactory}.
- * @see {@link DocumentLoaderFactory}
- * @see {@link AuthenticatedDocumentLoaderFactory}
- * @since 1.4.0
- */
-interface DocumentLoaderFactoryOptions {
-  /**
-   * Whether to allow fetching private network addresses.
-   * Turned off by default.
-   * @default `false``
-   */
-  allowPrivateAddress?: boolean;
-  /**
-   * Options for making `User-Agent` string.
-   * 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} function.
-   */
-  userAgent?: GetUserAgentOptions | string;
-}
-/**
- * A factory function that creates an authenticated {@link DocumentLoader} for
- * a given identity.  This is used for fetching documents that require
- * authentication.
- * @param identity The identity to create the document loader for.
- *                 The actor's key pair.
- * @param options The options for the document loader.
- * @returns The authenticated document loader.
- * @since 0.4.0
- */
-type AuthenticatedDocumentLoaderFactory = (identity: {
-  keyId: URL;
-  privateKey: CryptoKey;
-}, options?: DocumentLoaderFactoryOptions) => DocumentLoader;
-/**
- * Error thrown when fetching a JSON-LD document failed.
- */
-declare class FetchError extends Error {
-  /**
-   * The URL that failed to fetch.
-   */
-  url: URL;
-  /**
-   * Constructs a new `FetchError`.
-   *
-   * @param url The URL that failed to fetch.
-   * @param message Error message.
-   */
-  constructor(url: URL | string, message?: string);
-}
-/**
- * Options for creating a request.
- * @internal
- */
-
-/**
- * Options for {@link getDocumentLoader}.
- * @since 1.3.0
- */
-interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
-  /**
-   * Whether to preload the frequently used contexts.
-   */
-  skipPreloadedContexts?: boolean;
-}
-/**
- * Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
- *
- * The created loader preloads the below frequently used contexts by default
- * (unless `options.ignorePreloadedContexts` is set to `true`):
- *
- * - <https://www.w3.org/ns/activitystreams>
- * - <https://w3id.org/security/v1>
- * - <https://w3id.org/security/data-integrity/v1>
- * - <https://www.w3.org/ns/did/v1>
- * - <https://w3id.org/security/multikey/v1>
- * - <https://purl.archive.org/socialweb/webfinger>
- * - <http://schema.org/>
- * @param options Options for the document loader.
- * @returns The document loader.
- * @since 1.3.0
- */
-declare function getDocumentLoader({
-  allowPrivateAddress,
-  skipPreloadedContexts,
-  userAgent
-}?: GetDocumentLoaderOptions): DocumentLoader;
-/**
- * A JSON-LD document loader that utilizes the browser's `fetch` API.
- *
- * This loader preloads the below frequently used contexts:
- *
- * - <https://www.w3.org/ns/activitystreams>
- * - <https://w3id.org/security/v1>
- * - <https://w3id.org/security/data-integrity/v1>
- * - <https://www.w3.org/ns/did/v1>
- * - <https://w3id.org/security/multikey/v1>
- * - <https://purl.archive.org/socialweb/webfinger>
- * - <http://schema.org/>
- * @param url The URL of the document to load.
- * @param allowPrivateAddress Whether to allow fetching private network
- *                            addresses.  Turned off by default.
- * @returns The remote document.
- * @deprecated Use {@link getDocumentLoader} instead.
- */
-declare function fetchDocumentLoader(url: string, allowPrivateAddress?: boolean): Promise<RemoteDocument>;
-declare function fetchDocumentLoader(url: string, options?: DocumentLoaderOptions): Promise<RemoteDocument>;
-/**
- * The parameters for {@link kvCache} function.
- */
-interface KvCacheParameters {
-  /**
-   * The document loader to decorate with a cache.
-   */
-  loader: DocumentLoader;
-  /**
-   * The key–value store to use for backing the cache.
-   */
-  kv: KvStore;
-  /**
-   * The key prefix to use for namespacing the cache.
-   * `["_fedify", "remoteDocument"]` by default.
-   */
-  prefix?: KvKey;
-  /**
-   * The per-URL cache rules in the array of `[urlPattern, duration]` pairs
-   * where `urlPattern` is either a string, a {@link URL}, or
-   * a {@link URLPattern} and `duration` is a {@link Temporal.Duration}.
-   * The `duration` is allowed to be at most 30 days.
-   *
-   * By default, 5 minutes for all URLs.
-   */
-  rules?: [string | URL | URLPattern, Temporal.Duration][];
-}
-/**
- * Decorates a {@link DocumentLoader} with a cache backed by a {@link Deno.Kv}.
- * @param parameters The parameters for the cache.
- * @returns The decorated document loader which is cache-enabled.
- */
-declare function kvCache({
-  loader,
-  kv,
-  prefix,
-  rules
-}: KvCacheParameters): DocumentLoader;
-/**
- * Options for making `User-Agent` string.
- * @see {@link getUserAgent}
- * @since 1.3.0
- */
-interface GetUserAgentOptions {
-  /**
-   * An optional software name and version, e.g., `"Hollo/1.0.0"`.
-   */
-  software?: string | null;
-  /**
-   * An optional URL to append to the user agent string.
-   * Usually the URL of the ActivityPub instance.
-   */
-  url?: string | URL | null;
-}
-/**
- * Gets the user agent string for the given application and URL.
- * @param options The options for making the user agent string.
- * @returns The user agent string.
- * @since 1.3.0
- */
-declare function getUserAgent({
-  software,
-  url
-}?: GetUserAgentOptions): string;
-//#endregion
-export { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, DocumentLoaderFactoryOptions, FetchError, GetDocumentLoaderOptions, GetUserAgentOptions, KvCacheParameters, RemoteDocument, fetchDocumentLoader, getDocumentLoader, getUserAgent, kvCache };