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

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright 2024–2025 Hong Minhee
+Copyright 2024–2026 Hong Minhee
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

package/README.md

@@ -1,8 +1,7 @@
 <!-- deno-fmt-ignore-file -->
 
-![](./logo.svg)
-Fedify: an ActivityPub server framework
-=======================================
+![](./logo.svg) Fedify: an ActivityPub server framework
+=======================================================
 
 [![JSR][JSR badge]][JSR]
 [![npm][npm badge]][npm]
@@ -37,12 +36,12 @@ Currently, Fedify provides the following features out of the box:
 If you want to know more about the project, please take a look at the following
 resources:
 
- -  [Installation](https://fedify.dev/install)
+ -  [Installation]
  -  Tutorials:
-    [Learning the basics](https://fedify.dev/tutorial/basics) &
-    [Creating a microblog](https://fedify.dev/tutorial/microblog)
+    [Learning the basics] &
+    [Creating a microblog]
  -  [API reference][JSR]
- -  [Examples](https://github.com/fedify-dev/fedify/tree/main/examples)
+ -  [Examples]
 
 If you have any questions, suggestions, or feedback, please feel free to
 join our [Matrix chat space][Matrix] or [Discord server][Discord] or
@@ -51,16 +50,16 @@ join our [Matrix chat space][Matrix] or [Discord server][Discord] or
 [^1]: You may already know some of the networks in the fediverse, such as
       [Mastodon], [Lemmy], [Pixelfed], [PeerTube], and so on.
 
-[JSR]: https://jsr.io/@fedify/fedify
 [JSR badge]: https://jsr.io/badges/@fedify/fedify
-[npm]: https://www.npmjs.com/package/@fedify/fedify
+[JSR]: https://jsr.io/@fedify/fedify
 [npm badge]: https://img.shields.io/npm/v/@fedify/fedify?logo=npm
-[GitHub Actions]: https://github.com/fedify-dev/fedify/actions/workflows/build.yaml
+[npm]: https://www.npmjs.com/package/@fedify/fedify
 [GitHub Actions badge]: https://github.com/fedify-dev/fedify/actions/workflows/build.yaml/badge.svg
-[Matrix]: https://matrix.to/#/#fedify:matrix.org
+[GitHub Actions]: https://github.com/fedify-dev/fedify/actions/workflows/build.yaml
 [Matrix badge]: https://img.shields.io/matrix/fedify%3Amatrix.org?logo=matrix
-[Discord]: https://discord.gg/bhtwpzURwd
+[Matrix]: https://matrix.to/#/#fedify:matrix.org
 [Discord badge]: https://img.shields.io/discord/1295652627505217647?logo=discord&cacheSeconds=60
+[Discord]: https://discord.gg/bhtwpzURwd
 [@fedify@hollo.social badge]: https://fedi-badge.deno.dev/@fedify@hollo.social/followers.svg
 [@fedify@hollo.social]: https://hollo.social/@fedify
 [Fedify Demo]: https://dash.deno.com/playground/fedify-demo
@@ -73,8 +72,13 @@ join our [Matrix chat space][Matrix] or [Discord server][Discord] or
 [FEP-8b32]: https://w3id.org/fep/8b32
 [Linked Data Signatures]: https://web.archive.org/web/20170923124140/https://w3c-dvcg.github.io/ld-signatures/
 [NodeInfo]: https://nodeinfo.diaspora.software/
+[Installation]: https://fedify.dev/install
+[Learning the basics]: https://fedify.dev/tutorial/basics
+[Creating a microblog]: https://fedify.dev/tutorial/microblog
+[Examples]: https://github.com/fedify-dev/fedify/tree/main/examples
 [GitHub Discussions]: https://github.com/fedify-dev/fedify/discussions
 [#Fedify]: https://mastodon.social/tags/fedify
+
 [Mastodon]: https://joinmastodon.org/
 [Lemmy]: https://join-lemmy.org/
 [Pixelfed]: https://pixelfed.org/
@@ -90,24 +94,33 @@ which provides the core functionality of the framework.  Other packages provide
 integrations with various web frameworks, database drivers, and other features.
 Here is the list of packages:
 
-| Package                                   | JSR                          | npm                          | Description                             |
-| ---------------------------------------   | ---------------------------- | ---------------------------- | --------------------------------------- |
-| [@fedify/fedify](/packages/fedify/)       | [JSR]                        | [npm]                        | The core framework of Fedify            |
-| [@fedify/cli](/packages/cli/)             | [JSR][jsr:@fedify/cli]       | [npm][npm:@fedify/cli]       | CLI toolchain for testing and debugging |
-| [@fedify/amqp](/packages/amqp/)           | [JSR][jsr:@fedify/amqp]      | [npm][npm:@fedify/amqp]      | AMQP/RabbitMQ driver                    |
-| [@fedify/cfworkers](/packages/cfworkers/) | [JSR][jsr:@fedify/cfworkers] | [npm][npm:@fedify/cfworkers] | Cloudflare Workers integration          |
-| [@fedify/denokv](/packages/denokv/)       | [JSR][jsr:@fedify/denokv]    |                              | Deno KV integration                     |
-| [@fedify/elysia](/packages/elysia/)       |                              | [npm][npm:@fedify/elysia]    | Elysia integration                      |
-| [@fedify/express](/packages/express/)     | [JSR][jsr:@fedify/express]   | [npm][npm:@fedify/express]   | Express integration                     |
-| [@fedify/h3](/packages/h3/)               | [JSR][jsr:@fedify/h3]        | [npm][npm:@fedify/h3]        | H3 integration                          |
-| [@fedify/hono](/packages/hono/)           | [JSR][jsr:@fedify/hono]      | [npm][npm:@fedify/hono]      | Hono integration                        |
-| [@fedify/nestjs](/packages/nestjs/)       |                              | [npm][npm:@fedify/nestjs]    | NestJS integration                      |
-| [@fedify/next](/packages/next/)           |                              | [npm][npm:@fedify/next]      | Next.js integration                     |
-| [@fedify/postgres](/packages/postgres/)   | [JSR][jsr:@fedify/postgres]  | [npm][npm:@fedify/postgres]  | PostgreSQL driver                       |
-| [@fedify/redis](/packages/redis/)         | [JSR][jsr:@fedify/redis]     | [npm][npm:@fedify/redis]     | Redis driver                            |
-| [@fedify/sqlite](/packages/sqlite/)       | [JSR][jsr:@fedify/sqlite]    | [npm][npm:@fedify/sqlite]    | SQLite driver                           |
-| [@fedify/sveltekit](/packages/sveltekit/) | [JSR][jsr:@fedify/sveltekit] | [npm][npm:@fedify/sveltekit] | SvelteKit integration                   |
-| [@fedify/testing](/packages/testing/)     | [JSR][jsr:@fedify/testing]   | [npm][npm:@fedify/testing]   | Testing utilities                       |
+| Package                                           | JSR                              | npm                              | Description                              |
+| ------------------------------------------------- | -------------------------------- | -------------------------------- | ---------------------------------------- |
+| [@fedify/fedify](/packages/fedify/)               | [JSR]                            | [npm]                            | The core framework of Fedify             |
+| [@fedify/cli](/packages/cli/)                     | [JSR][jsr:@fedify/cli]           | [npm][npm:@fedify/cli]           | CLI toolchain for testing and debugging  |
+| [@fedify/amqp](/packages/amqp/)                   | [JSR][jsr:@fedify/amqp]          | [npm][npm:@fedify/amqp]          | AMQP/RabbitMQ driver                     |
+| [@fedify/cfworkers](/packages/cfworkers/)         | [JSR][jsr:@fedify/cfworkers]     | [npm][npm:@fedify/cfworkers]     | Cloudflare Workers integration           |
+| [@fedify/denokv](/packages/denokv/)               | [JSR][jsr:@fedify/denokv]        |                                  | Deno KV integration                      |
+| [@fedify/elysia](/packages/elysia/)               |                                  | [npm][npm:@fedify/elysia]        | Elysia integration                       |
+| [@fedify/express](/packages/express/)             | [JSR][jsr:@fedify/express]       | [npm][npm:@fedify/express]       | Express integration                      |
+| [@fedify/fastify](/packages/fastify/)             | [JSR][jsr:@fedify/fastify]       | [npm][npm:@fedify/fastify]       | Fastify integration                      |
+| [@fedify/fresh](/packages/fresh/)                 | [JSR][jsr:@fedify/fresh]         |                                  | Fresh integration                        |
+| [@fedify/h3](/packages/h3/)                       | [JSR][jsr:@fedify/h3]            | [npm][npm:@fedify/h3]            | H3 integration                           |
+| [@fedify/hono](/packages/hono/)                   | [JSR][jsr:@fedify/hono]          | [npm][npm:@fedify/hono]          | Hono integration                         |
+| [@fedify/koa](/packages/koa/)                     | [JSR][jsr:@fedify/koa]           | [npm][npm:@fedify/koa]           | Koa integration                          |
+| [@fedify/lint](/packages/lint/)                   | [JSR][jsr:@fedify/lint]          | [npm][npm:@fedify/lint]          | Linting utilities                        |
+| [@fedify/nestjs](/packages/nestjs/)               |                                  | [npm][npm:@fedify/nestjs]        | NestJS integration                       |
+| [@fedify/next](/packages/next/)                   |                                  | [npm][npm:@fedify/next]          | Next.js integration                      |
+| [@fedify/postgres](/packages/postgres/)           | [JSR][jsr:@fedify/postgres]      | [npm][npm:@fedify/postgres]      | PostgreSQL driver                        |
+| [@fedify/redis](/packages/redis/)                 | [JSR][jsr:@fedify/redis]         | [npm][npm:@fedify/redis]         | Redis driver                             |
+| [@fedify/relay](/packages/relay/)                 | [JSR][jsr:@fedify/relay]         | [npm][npm:@fedify/relay]         | ActivityPub relay support                |
+| [@fedify/sqlite](/packages/sqlite/)               | [JSR][jsr:@fedify/sqlite]        | [npm][npm:@fedify/sqlite]        | SQLite driver                            |
+| [@fedify/sveltekit](/packages/sveltekit/)         | [JSR][jsr:@fedify/sveltekit]     | [npm][npm:@fedify/sveltekit]     | SvelteKit integration                    |
+| [@fedify/testing](/packages/testing/)             | [JSR][jsr:@fedify/testing]       | [npm][npm:@fedify/testing]       | Testing utilities                        |
+| [@fedify/vocab](/packages/vocab/)                 | [JSR][jsr:@fedify/vocab]         | [npm][npm:@fedify/vocab]         | Activity Vocabulary library              |
+| [@fedify/vocab-runtime](/packages/vocab-runtime/) | [JSR][jsr:@fedify/vocab-runtime] | [npm][npm:@fedify/vocab-runtime] | Runtime library for code-generated vocab |
+| [@fedify/vocab-tools](/packages/vocab-tools/)     | [JSR][jsr:@fedify/vocab-tools]   | [npm][npm:@fedify/vocab-tools]   | Code generation tools for Activity Vocab |
+| [@fedify/webfinger](/packages/webfinger/)         | [JSR][jsr:@fedify/webfinger]     | [npm][npm:@fedify/webfinger]     | WebFinger client library for ActivityPub |
 
 [jsr:@fedify/cli]: https://jsr.io/@fedify/cli
 [npm:@fedify/cli]: https://www.npmjs.com/package/@fedify/cli
@@ -119,22 +132,39 @@ Here is the list of packages:
 [npm:@fedify/elysia]: https://www.npmjs.com/package/@fedify/elysia
 [jsr:@fedify/express]: https://jsr.io/@fedify/express
 [npm:@fedify/express]: https://www.npmjs.com/package/@fedify/express
+[jsr:@fedify/fastify]: https://jsr.io/@fedify/fastify
+[npm:@fedify/fastify]: https://www.npmjs.com/package/@fedify/fastify
+[jsr:@fedify/fresh]: https://jsr.io/@fedify/fresh
 [jsr:@fedify/h3]: https://jsr.io/@fedify/h3
 [npm:@fedify/h3]: https://www.npmjs.com/package/@fedify/h3
 [jsr:@fedify/hono]: https://jsr.io/@fedify/hono
 [npm:@fedify/hono]: https://www.npmjs.com/package/@fedify/hono
+[jsr:@fedify/koa]: https://jsr.io/@fedify/koa
+[npm:@fedify/koa]: https://www.npmjs.com/package/@fedify/koa
+[jsr:@fedify/lint]: https://jsr.io/@fedify/lint
+[npm:@fedify/lint]: https://www.npmjs.com/package/@fedify/lint
 [npm:@fedify/nestjs]: https://www.npmjs.com/package/@fedify/nestjs
 [npm:@fedify/next]: https://www.npmjs.com/package/@fedify/next
 [jsr:@fedify/postgres]: https://jsr.io/@fedify/postgres
 [npm:@fedify/postgres]: https://www.npmjs.com/package/@fedify/postgres
 [jsr:@fedify/redis]: https://jsr.io/@fedify/redis
 [npm:@fedify/redis]: https://www.npmjs.com/package/@fedify/redis
+[jsr:@fedify/relay]: https://jsr.io/@fedify/relay
+[npm:@fedify/relay]: https://www.npmjs.com/package/@fedify/relay
 [jsr:@fedify/sqlite]: https://jsr.io/@fedify/sqlite
 [npm:@fedify/sqlite]: https://www.npmjs.com/package/@fedify/sqlite
 [jsr:@fedify/sveltekit]: https://jsr.io/@fedify/sveltekit
 [npm:@fedify/sveltekit]: https://www.npmjs.com/package/@fedify/sveltekit
 [jsr:@fedify/testing]: https://jsr.io/@fedify/testing
 [npm:@fedify/testing]: https://www.npmjs.com/package/@fedify/testing
+[jsr:@fedify/vocab]: https://jsr.io/@fedify/vocab
+[npm:@fedify/vocab]: https://www.npmjs.com/package/@fedify/vocab
+[jsr:@fedify/vocab-runtime]: https://jsr.io/@fedify/vocab-runtime
+[npm:@fedify/vocab-runtime]: https://www.npmjs.com/package/@fedify/vocab-runtime
+[jsr:@fedify/vocab-tools]: https://jsr.io/@fedify/vocab-tools
+[npm:@fedify/vocab-tools]: https://www.npmjs.com/package/@fedify/vocab-tools
+[jsr:@fedify/webfinger]: https://jsr.io/@fedify/webfinger
+[npm:@fedify/webfinger]: https://www.npmjs.com/package/@fedify/webfinger
 
 
 Sponsors
@@ -146,7 +176,10 @@ financial contributors:[^2]
 
 [^2]: Those lists are automatically updated every hour.
 
+<!-- hongdown-disable -->
+
 <!-- cSpell: disable -->
+
 <!-- DO NOT EDIT(h3): this section is automatically generated by the script -->
 
 ### Corporate sponsors
@@ -169,8 +202,11 @@ Robin Riley, yamanoku, Encyclia, taye, okin, Andy Piper, box464, Evan Prodromou,
 Robin Riley, Markus P, Nils Bergmann, Rameez
 
 <!-- /DO NOT EDIT -->
+
 <!-- cSpell: enable -->
 
+<!-- hongdown-enable -->
+
 ### Become a sponsor
 
 We welcome financial contributions to help us maintain and improve this project.

package/dist/{assert_rejects-DiIiJbZn.js → assert_rejects-Ce45JcFg.js}

@@ -4,7 +4,7 @@
       globalThis.addEventListener = () => {};
     
 import { AssertionError } from "./assert_equals-DSbWqCm3.js";
-import { assertIsError } from "./assert_is_error-BPGph1Jx.js";
+import { assertIsError } from "./assert_throws-BNXdRGWP.js";
 
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_false.js
 /**

package/dist/{assert_is_error-BPGph1Jx.js → assert_throws-BNXdRGWP.js}

@@ -45,4 +45,34 @@ import { AssertionError, stripAnsiCode } from "./assert_equals-DSbWqCm3.js";
 }
 
 //#endregion
-export { assertIsError };
+//#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 { assertIsError, assertThrows };

package/dist/{builder-BgzJcrpt.js → builder-C9n2ExVv.js}

@@ -3,10 +3,11 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { deno_default, getTypeId } from "./type-qs0mWLTm.js";
-import { Router, RouterError } from "./lookup-CnJK1NUl.js";
-import { InboxListenerSet } from "./inbox-B97Wrppe.js";
+import { deno_default } from "./deno-B74l3pXN.js";
+import { Router, RouterError } from "./router-D9eI0s4b.js";
+import { InboxListenerSet } from "./inbox-6-2rtCJf.js";
 import { getLogger } from "@logtape/logtape";
+import { getTypeId } from "@fedify/vocab";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 
 //#region src/federation/builder.ts
@@ -28,6 +29,7 @@ var FederationBuilderImpl = class {
 	inboxListeners;
 	inboxErrorHandler;
 	sharedInboxKeyDispatcher;
+	idempotencyStrategy;
 	collectionTypeIds;
 	collectionCallbacks;
 	/**
@@ -42,7 +44,7 @@ var FederationBuilderImpl = class {
 		this.collectionTypeIds = {};
 	}
 	async build(options) {
-		const { FederationImpl } = await import("./middleware-zDdNBo-m.js");
+		const { FederationImpl } = await import("./middleware-Ba1Pxx8r.js");
 		const f = new FederationImpl(options);
 		const trailingSlashInsensitiveValue = f.router.trailingSlashInsensitive;
 		f.router = this.router.clone();
@@ -64,6 +66,7 @@ var FederationBuilderImpl = class {
 		f.inboxListeners = this.inboxListeners?.clone();
 		f.inboxErrorHandler = this.inboxErrorHandler;
 		f.sharedInboxKeyDispatcher = this.sharedInboxKeyDispatcher;
+		f.idempotencyStrategy = this.idempotencyStrategy;
 		return f;
 	}
 	_getTracer() {
@@ -486,15 +489,19 @@ var FederationBuilderImpl = class {
 			setSharedKeyDispatcher: (dispatcher) => {
 				this.sharedInboxKeyDispatcher = dispatcher;
 				return setters;
+			},
+			withIdempotency: (strategy) => {
+				this.idempotencyStrategy = strategy;
+				return setters;
 			}
 		};
 		return setters;
 	}
-	setCollectionDispatcher(name, ...args) {
-		return this.#setCustomCollectionDispatcher(name, "collection", ...args);
+	setCollectionDispatcher(name, itemType, path, dispatcher) {
+		return this.#setCustomCollectionDispatcher(name, "collection", itemType, path, dispatcher);
 	}
-	setOrderedCollectionDispatcher(name, ...args) {
-		return this.#setCustomCollectionDispatcher(name, "orderedCollection", ...args);
+	setOrderedCollectionDispatcher(name, itemType, path, dispatcher) {
+		return this.#setCustomCollectionDispatcher(name, "orderedCollection", itemType, path, dispatcher);
 	}
 	#setCustomCollectionDispatcher(name, collectionType, itemType, path, dispatcher) {
 		const strName = String(name);

package/dist/chunk-DqRYRqnO.cjs

@@ -0,0 +1,34 @@
+
+          const { Temporal } = require("@js-temporal/polyfill");
+          const { URLPattern } = require("urlpattern-polyfill");
+        
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/client-94iWEfQa.d.cts

@@ -0,0 +1,222 @@
+import { GetUserAgentOptions } from "@fedify/vocab-runtime";
+
+//#region src/nodeinfo/types.d.ts
+/**
+ * The type of the result of parsing JSON.
+ */
+type JsonValue = {
+  [key: string]: JsonValue | undefined;
+} | JsonValue[] | string | number | boolean | null;
+/**
+ * A NodeInfo object as defined in the NodeInfo 2.1 schema.
+ */
+interface NodeInfo {
+  /**
+   * Metadata about server software in use.
+   */
+  software: Software;
+  /**
+   * The protocols supported on this server.  At least one protocol must be
+   * supported.
+   */
+  protocols: Protocol[];
+  /**
+   * The third party sites this server can connect to via their application API.
+   */
+  services?: Services;
+  /**
+   * Whether this server allows open self-registration.  Defaults to `false`.
+   */
+  openRegistrations?: boolean;
+  /**
+   * Usage statistics for this server.
+   */
+  usage: Usage;
+  /**
+   * Free form key value pairs for software specific values.
+   * Clients should not rely on any specific key present.
+   */
+  metadata?: Record<string, JsonValue>;
+}
+/**
+ * Metadata about server software in use.
+ */
+interface Software {
+  /**
+   * The canonical name of this server software.  This must comply with
+   * pattern `/^[a-z0-9-]+$/`.
+   */
+  name: string;
+  /**
+   * The version of this server software.
+   */
+  version: string;
+  /**
+   * The URL of the source code repository of this server software.
+   */
+  repository?: URL;
+  /**
+   * The URL of the homepage of this server software.
+   */
+  homepage?: URL;
+}
+/**
+ * The protocols supported on this server.
+ */
+type Protocol = "activitypub" | "buddycloud" | "dfrn" | "diaspora" | "libertree" | "ostatus" | "pumpio" | "tent" | "xmpp" | "zot";
+/**
+ * The third party sites this server can connect to via their application API.
+ */
+interface Services {
+  /**
+   * The third party sites this server can retrieve messages from for combined
+   * display with regular traffic.
+   */
+  inbound?: InboundService[];
+  /**
+   * The third party sites this server can publish messages to on the behalf
+   * of a user.
+   */
+  outbound?: OutboundService[];
+}
+/**
+ * The third party sites this server can retrieve messages from for combined
+ * display with regular traffic.
+ */
+type InboundService = "atom1.0" | "gnusocial" | "imap" | "pnut" | "pop3" | "pumpio" | "rss2.0" | "twitter";
+/**
+ * The third party sites this server can publish messages to on the behalf
+ * of a user.
+ */
+type OutboundService = "atom1.0" | "blogger" | "buddycloud" | "diaspora" | "dreamwidth" | "drupal" | "facebook" | "friendica" | "gnusocial" | "google" | "insanejournal" | "libertree" | "linkedin" | "livejournal" | "mediagoblin" | "myspace" | "pinterest" | "pnut" | "posterous" | "pumpio" | "redmatrix" | "rss2.0" | "smtp" | "tent" | "tumblr" | "twitter" | "wordpress" | "xmpp";
+/**
+ * Usage statistics for this server.
+ */
+interface Usage {
+  /**
+   * Statistics about the users of this server.
+   */
+  users: {
+    /**
+     * The total amount of on this server registered users.  This number
+     * has to be an integer greater than or equal to zero.
+     */
+    total?: number;
+    /**
+     * The amount of users that signed in at least once in the last 180 days.
+     * This number has to be an integer greater than or equal to zero.
+     */
+    activeHalfyear?: number;
+    /**
+     * The amount of users that signed in at least once in the last 30 days.
+     * This number has to be an integer greater than or equal to zero.
+     */
+    activeMonth?: number;
+  };
+  /**
+   * The amount of posts that were made by users that are registered on this
+   * server.  This number has to be an integer greater than or equal to zero.
+   */
+  localPosts: number;
+  /**
+   * The amount of comments that were made by users that are registered on this
+   * server.  This number has to be an integer greater than or equal to zero.
+   */
+  localComments: number;
+}
+/**
+ * Converts a {@link NodeInfo} object to a JSON value.
+ * @param nodeInfo The {@link NodeInfo} object to convert.
+ * @returns The JSON value that complies with the NodeInfo schema.
+ * @throws {TypeError} If the {@link NodeInfo} object is invalid.
+ */
+declare function nodeInfoToJson(nodeInfo: NodeInfo): JsonValue;
+//#endregion
+//#region src/nodeinfo/client.d.ts
+/**
+ * Options for {@link getNodeInfo} function.
+ * @since 1.2.0
+ */
+interface GetNodeInfoOptions {
+  /**
+   * Whether to directly fetch the NodeInfo document from the given URL.
+   * Otherwise, the NodeInfo document will be fetched from the `.well-known`
+   * location of the given URL.
+   *
+   * Turned off by default.
+   */
+  direct?: boolean;
+  /**
+   * How strictly to parse the NodeInfo document.
+   *
+   *  -  `"strict"`: Parse the NodeInfo document strictly.  If the document is
+   *     invalid, `undefined` is returned.  This is the default.
+   *  -  `"best-effort"`: Try to parse the NodeInfo document even if it is
+   *     invalid.
+   *  -  `"none"`: Do not parse the NodeInfo document.  The function will return
+   *     the raw JSON value.
+   */
+  parse?: "strict" | "best-effort" | "none";
+  /**
+   * 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;
+}
+/**
+ * Fetches a NodeInfo document from the given URL.
+ * @param url The base URL of the server.  If `options.direct` is turned off
+ *            (default), the NodeInfo document will be fetched from
+ *            the `.well-known` location of this URL (hence the only origin
+ *            of the URL is used).  If `options.direct` is turned on,
+ *            the NodeInfo document will be fetched from the given URL.
+ * @param options Options for fetching the NodeInfo document.
+ * @returns The NodeInfo document if it could be fetched successfully.
+ *          Otherwise, `undefined` is returned.
+ * @since 1.2.0
+ */
+declare function getNodeInfo(url: URL | string, options?: GetNodeInfoOptions & {
+  parse?: "strict" | "best-effort";
+}): Promise<NodeInfo | undefined>;
+/**
+ * Fetches a NodeInfo document from the given URL.
+ * @param url The base URL of the server.  If `options.direct` is turned off
+ *            (default), the NodeInfo document will be fetched from
+ *            the `.well-known` location of this URL (hence the only origin
+ *            of the URL is used).  If `options.direct` is turned on,
+ *            the NodeInfo document will be fetched from the given URL.
+ * @param options Options for fetching the NodeInfo document.
+ * @returns The NodeInfo document if it could be fetched successfully.
+ *          Otherwise, `undefined` is returned.
+ * @since 1.2.0
+ */
+declare function getNodeInfo(url: URL | string, options: GetNodeInfoOptions & {
+  parse: "none";
+}): Promise<JsonValue | undefined>;
+/**
+ * Options for {@link parseNodeInfo} function.
+ * @since 1.2.0
+ */
+interface ParseNodeInfoOptions {
+  /**
+   * Whether to try to parse the NodeInfo document even if it is invalid.
+   * If turned on, the function will return a best-effort result.
+   *
+   * Turned off by default.
+   */
+  tryBestEffort?: boolean;
+}
+/**
+ * Parses a NodeInfo document.
+ * @param data A JSON value that complies with the NodeInfo schema.
+ * @param options Options for parsing the NodeInfo document.
+ * @returns The parsed NodeInfo document if it is valid.  Otherwise, `null`
+ *          is returned.
+ * @since 1.2.0
+ */
+declare function parseNodeInfo(data: unknown, options?: ParseNodeInfoOptions): NodeInfo | null;
+//#endregion
+export { GetNodeInfoOptions, InboundService, JsonValue, NodeInfo, OutboundService, ParseNodeInfoOptions, Protocol, Services, Software, Usage, getNodeInfo, nodeInfoToJson, parseNodeInfo };

package/dist/{client-DF8anIB5.d.ts → client-BivSNrEg.d.ts}

@@ -1,78 +1,7 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { GetUserAgentOptions } from "./docloader-CxWcuWqQ.js";
+import { GetUserAgentOptions } from "@fedify/vocab-runtime";
 
-//#region src/nodeinfo/semver.d.ts
-/**
- * A SemVer object parsed into its constituent parts.
- * @since 1.2.0
- */
-interface SemVer {
-  /** The major version */
-  major: number;
-  /** The minor version */
-  minor: number;
-  /** The patch version */
-  patch: number;
-  /**
-   * The prerelease version
-   *
-   * @default {[]}
-   */
-  prerelease?: (string | number)[];
-  /**
-   * The build metadata
-   *
-   * @default {[]}
-   */
-  build?: string[];
-}
-/**
- * Attempt to parse a string as a semantic version, returning a SemVer object.
- *
- * @example Usage
- * ```ts
- * import { parseSemVer } from "@fedify/fedify/nodeinfo";
- * import { assertEquals } from "@std/assert";
- *
- * const version = parseSemVer("1.2.3");
- * assertEquals(version, {
- *   major: 1,
- *   minor: 2,
- *   patch: 3,
- *   prerelease: [],
- *   build: [],
- * });
- * ```
- *
- * @throws {TypeError} If the input string is invalid.
- * @param value The version string to parse
- * @returns A valid SemVer
- * @since 1.2.0
- */
-declare function parseSemVer(value: string): SemVer;
-/**
- * Format a SemVer object into a string.
- *
- * @example Usage
- * ```ts
- * import { formatSemVer } from "@fedify/fedify/nodeinfo";
- * import { assertEquals } from "@std/assert";
- *
- * const semver = {
- *   major: 1,
- *   minor: 2,
- *   patch: 3,
- * };
- * assertEquals(formatSemVer(semver), "1.2.3");
- * ```
- *
- * @param version The SemVer to format
- * @returns The string representation of a semantic version.
- * @since 1.2.0
- */
-declare function formatSemVer(version: SemVer): string;
-//#endregion
 //#region src/nodeinfo/types.d.ts
 /**
  * The type of the result of parsing JSON.
@@ -122,9 +51,8 @@ interface Software {
   name: string;
   /**
    * The version of this server software.
-   * @see {@link parseSemVer}
    */
-  version: SemVer;
+  version: string;
   /**
    * The URL of the source code repository of this server software.
    */
@@ -293,4 +221,4 @@ interface ParseNodeInfoOptions {
  */
 declare function parseNodeInfo(data: unknown, options?: ParseNodeInfoOptions): NodeInfo | null;
 //#endregion
-export { GetNodeInfoOptions, InboundService, JsonValue, NodeInfo, OutboundService, ParseNodeInfoOptions, Protocol, SemVer, Services, Software, Usage, formatSemVer, getNodeInfo, nodeInfoToJson, parseNodeInfo, parseSemVer };
+export { GetNodeInfoOptions, InboundService, JsonValue, NodeInfo, OutboundService, ParseNodeInfoOptions, Protocol, Services, Software, Usage, getNodeInfo, nodeInfoToJson, parseNodeInfo };