@fedify/fedify 2.0.0-dev.1485 → 2.0.0-dev.149

package/dist/actor-f2NtjyCg.d.cts

@@ -0,0 +1,128 @@
+import { Application, Group, Organization, Person, Service } from "./vocab-CeDBzu-f.cjs";
+import { GetUserAgentOptions } from "@fedify/vocab-runtime";
+import { TracerProvider } from "@opentelemetry/api";
+
+//#region src/vocab/actor.d.ts
+/**
+ * Actor types are {@link Object} types that are capable of performing
+ * activities.
+ */
+type Actor = Application | Group | Organization | Person | Service;
+/**
+ * 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}.
+ */
+declare function isActor(object: unknown): object is Actor;
+/**
+ * A string representation of an actor type name.
+ */
+type ActorTypeName = "Application" | "Group" | "Organization" | "Person" | "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.
+ */
+declare function getActorTypeName(actor: Actor): ActorTypeName;
+/**
+ * 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.
+ */
+declare function getActorClassByTypeName(typeName: ActorTypeName): typeof Application | typeof Group | typeof Organization | typeof Person | typeof Service;
+/**
+ * Options for {@link getActorHandle}.
+ * @since 1.3.0
+ */
+interface GetActorHandleOptions extends NormalizeActorHandleOptions {
+  /**
+   * 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;
+}
+/**
+ * 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
+ */
+declare function getActorHandle(actor: Actor | URL, options?: GetActorHandleOptions): Promise<`@${string}@${string}` | `${string}@${string}`>;
+/**
+ * Options for {@link normalizeActorHandle}.
+ * @since 0.9.0
+ */
+interface NormalizeActorHandleOptions {
+  /**
+   * Whether to trim the leading `@` from the actor handle.  Turned off by
+   * default.
+   */
+  trimLeadingAt?: boolean;
+  /**
+   * Whether to convert the domain part of the actor handle to punycode, if it
+   * is an internationalized domain name.  Turned off by default.
+   */
+  punycode?: boolean;
+}
+/**
+ * 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
+ */
+declare function normalizeActorHandle(handle: string, options?: NormalizeActorHandleOptions): `@${string}@${string}` | `${string}@${string}`;
+/**
+ * The object that can be a recipient of an activity.
+ *
+ * Note that every {@link Actor} is also a {@link Recipient}.
+ */
+interface Recipient {
+  /**
+   * The URI of the actor.
+   */
+  readonly id: URL | null;
+  /**
+   * The URI of the actor's inbox.
+   */
+  readonly inboxId: URL | null;
+  /**
+   * The endpoints of the actor.
+   */
+  readonly endpoints?: {
+    /**
+     * The URI of the actor's shared inbox.
+     */
+    sharedInbox: URL | null;
+  } | null;
+}
+//#endregion
+export { Actor, ActorTypeName, GetActorHandleOptions, NormalizeActorHandleOptions, Recipient, getActorClassByTypeName, getActorHandle, getActorTypeName, isActor, normalizeActorHandle };

package/dist/{assert-MZs1qjMx.js → assert-Dp5_aoAs.js}

@@ -3,7 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { AssertionError } from "./assert_equals-DSbWqCm3.js";
+import { AssertionError } from "./assert_equals-Gbplq4lg.js";
 
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert.js
 /**

package/dist/{assert_instance_of-DHz7EHNU.js → assert_instance_of-D1m8F7x0.js}

@@ -3,7 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { AssertionError } from "./assert_equals-DSbWqCm3.js";
+import { AssertionError } from "./assert_equals-Gbplq4lg.js";
 
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_instance_of.js
 /**

package/dist/{assert_not_equals-f3m3epl3.js → assert_not_equals-B2R_8p36.js}

@@ -3,7 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { AssertionError, equal } from "./assert_equals-DSbWqCm3.js";
+import { AssertionError, equal } from "./assert_equals-Gbplq4lg.js";
 
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_not_equals.js
 /**

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

@@ -3,8 +3,8 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { AssertionError } from "./assert_equals-DSbWqCm3.js";
-import { assertIsError } from "./assert_is_error-BPGph1Jx.js";
+import { AssertionError } from "./assert_equals-Gbplq4lg.js";
+import { assertIsError } from "./assert_throws-DjkXin1a.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-DjkXin1a.js}

@@ -3,7 +3,7 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { AssertionError, stripAnsiCode } from "./assert_equals-DSbWqCm3.js";
+import { AssertionError, stripAnsiCode } from "./assert_equals-Gbplq4lg.js";
 
 //#region ../../node_modules/.pnpm/@jsr+std__assert@0.226.0/node_modules/@jsr/std__assert/assert_is_error.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-BPGqEvtB.js → builder-CYR2yKqn.js}

@@ -3,9 +3,10 @@
       import { URLPattern } from "urlpattern-polyfill";
       globalThis.addEventListener = () => {};
     
-import { deno_default, getTypeId } from "./type-I68qwqmo.js";
-import { Router, RouterError } from "./lookup-DNQyH8UQ.js";
-import { InboxListenerSet } from "./inbox-eK2W2MF3.js";
+import { deno_default } from "./deno-BTeveqhY.js";
+import { Router, RouterError } from "./router-CVRQXlZi.js";
+import { getTypeId } from "./type-BSNcIxTd.js";
+import { InboxListenerSet } from "./inbox-DNjplQSR.js";
 import { getLogger } from "@logtape/logtape";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 
@@ -14,6 +15,7 @@ var FederationBuilderImpl = class {
 	router;
 	actorCallbacks;
 	nodeInfoDispatcher;
+	webFingerLinksDispatcher;
 	objectCallbacks;
 	objectTypeIds;
 	inboxPath;
@@ -27,6 +29,7 @@ var FederationBuilderImpl = class {
 	inboxListeners;
 	inboxErrorHandler;
 	sharedInboxKeyDispatcher;
+	idempotencyStrategy;
 	collectionTypeIds;
 	collectionCallbacks;
 	/**
@@ -41,7 +44,7 @@ var FederationBuilderImpl = class {
 		this.collectionTypeIds = {};
 	}
 	async build(options) {
-		const { FederationImpl } = await import("./middleware-CWbGhXnl.js");
+		const { FederationImpl } = await import("./middleware-7Yg2p_nl.js");
 		const f = new FederationImpl(options);
 		const trailingSlashInsensitiveValue = f.router.trailingSlashInsensitive;
 		f.router = this.router.clone();
@@ -49,6 +52,7 @@ var FederationBuilderImpl = class {
 		f._initializeRouter();
 		f.actorCallbacks = this.actorCallbacks == null ? void 0 : { ...this.actorCallbacks };
 		f.nodeInfoDispatcher = this.nodeInfoDispatcher;
+		f.webFingerLinksDispatcher = this.webFingerLinksDispatcher;
 		f.objectCallbacks = { ...this.objectCallbacks };
 		f.objectTypeIds = { ...this.objectTypeIds };
 		f.inboxPath = this.inboxPath;
@@ -62,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() {
@@ -186,6 +191,9 @@ var FederationBuilderImpl = class {
 		if (variables.size !== 0) throw new RouterError("Path for NodeInfo dispatcher must have no variables.");
 		this.nodeInfoDispatcher = dispatcher;
 	}
+	setWebFingerLinksDispatcher(dispatcher) {
+		this.webFingerLinksDispatcher = dispatcher;
+	}
 	setObjectDispatcher(cls, path, dispatcher) {
 		const routeName = `object:${cls.typeId.href}`;
 		if (this.router.has(routeName)) throw new RouterError(`Object dispatcher for ${cls.name} already set.`);
@@ -481,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/chunk-HsBuZ-b2.js

@@ -0,0 +1,41 @@
+
+      import { Temporal } from "@js-temporal/polyfill";
+      import { URLPattern } from "urlpattern-polyfill";
+      globalThis.addEventListener = () => {};
+    
+import { createRequire } from "node:module";
+
+//#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 __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+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));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __commonJS, __export, __require, __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 };