@fedify/fedify 0.5.0-dev.88

package/esm/httpsig/mod.js

@@ -0,0 +1,193 @@
+/**
+ * The implementation of the [HTTP
+ * Signatures](https://datatracker.ietf.org/doc/html/draft-cavage-http-signatures-12).
+ *
+ * @module
+ */
+import * as dntShim from "../_dnt.shims.js";
+import { Temporal } from "@js-temporal/polyfill";
+import { equals } from "../deps/jsr.io/@std/bytes/0.220.1/mod.js";
+import { decodeBase64, encodeBase64 } from "../deps/jsr.io/@std/encoding/0.220.1/base64.js";
+import { isActor } from "../vocab/actor.js";
+import { CryptographicKey, Object as ASObject, } from "../vocab/vocab.js";
+import { validateCryptoKey } from "./key.js";
+export { exportJwk, generateCryptoKeyPair, importJwk } from "./key.js";
+/**
+ * Signs a request using the given private key.
+ * @param request The request to sign.
+ * @param privateKey The private key to use for signing.
+ * @param keyId The key ID to use for the signature.  It will be used by the
+ *              verifier.
+ * @returns The signed request.
+ * @throws {TypeError} If the private key is invalid or unsupported.
+ */
+export async function sign(request, privateKey, keyId) {
+    validateCryptoKey(privateKey, "private");
+    const url = new URL(request.url);
+    const body = request.method !== "GET" && request.method !== "HEAD"
+        ? await request.arrayBuffer()
+        : null;
+    const headers = new Headers(request.headers);
+    if (!headers.has("Host")) {
+        headers.set("Host", url.host);
+    }
+    if (!headers.has("Digest") && body != null) {
+        const digest = await dntShim.crypto.subtle.digest("SHA-256", body);
+        headers.set("Digest", `sha-256=${encodeBase64(digest)}`);
+    }
+    if (!headers.has("Date")) {
+        headers.set("Date", new Date().toUTCString());
+    }
+    const serialized = [
+        ["(request-target)", `${request.method.toLowerCase()} ${url.pathname}`],
+        ...headers,
+    ];
+    const headerNames = serialized.map(([name]) => name);
+    const message = serialized
+        .map(([name, value]) => `${name}: ${value.trim()}`).join("\n");
+    // TODO: support other than RSASSA-PKCS1-v1_5:
+    const signature = await dntShim.crypto.subtle.sign("RSASSA-PKCS1-v1_5", privateKey, new TextEncoder().encode(message));
+    const sigHeader = `keyId="${keyId.href}",headers="${headerNames.join(" ")}",signature="${encodeBase64(signature)}"`;
+    headers.set("Signature", sigHeader);
+    return new Request(request, {
+        headers,
+        body,
+    });
+}
+const supportedHashAlgorithms = {
+    "sha": "SHA-1",
+    "sha-256": "SHA-256",
+    "sha-512": "SHA-512",
+};
+/**
+ * Verifies the signature of a request.
+ *
+ * Note that this function consumes the request body, so it should not be used
+ * if the request body is already consumed.  Consuming the request body after
+ * calling this function is okay, since this function clones the request
+ * under the hood.
+ * @param request The request to verify.
+ * @param documentLoader The document loader to use for fetching the public key.
+ * @param currentTime The current time.  If not specified, the current time is
+ *                    used.  This is useful for testing.
+ * @returns The public key of the verified signature, or `null` if the signature
+ *          could not be verified.
+ */
+export async function verify(request, documentLoader, currentTime) {
+    request = request.clone();
+    const dateHeader = request.headers.get("Date");
+    if (dateHeader == null)
+        return null;
+    const sigHeader = request.headers.get("Signature");
+    if (sigHeader == null)
+        return null;
+    const digestHeader = request.headers.get("Digest");
+    if (request.method !== "GET" && request.method !== "HEAD" &&
+        digestHeader == null) {
+        return null;
+    }
+    let body = null;
+    if (digestHeader != null) {
+        body = await request.arrayBuffer();
+        const digests = digestHeader.split(",").map((pair) => pair.includes("=") ? pair.split("=", 2) : [pair, ""]);
+        let matched = false;
+        for (let [algo, digestBase64] of digests) {
+            algo = algo.trim().toLowerCase();
+            if (!(algo in supportedHashAlgorithms))
+                continue;
+            const digest = decodeBase64(digestBase64);
+            const expectedDigest = await dntShim.crypto.subtle.digest(supportedHashAlgorithms[algo], body);
+            if (!equals(digest, new Uint8Array(expectedDigest)))
+                return null;
+            matched = true;
+        }
+        if (!matched)
+            return null;
+    }
+    const date = Temporal.Instant.from(new Date(dateHeader).toISOString());
+    const now = currentTime ?? Temporal.Now.instant();
+    if (Temporal.Instant.compare(date, now.add({ seconds: 30 })) > 0) {
+        // Too far in the future
+        return null;
+    }
+    else if (Temporal.Instant.compare(date, now.subtract({ seconds: 30 })) < 0) {
+        // Too far in the past
+        return null;
+    }
+    const sigValues = Object.fromEntries(sigHeader.split(",").map((pair) => pair.match(/^\s*([A-Za-z]+)="([^"]*)"\s*$/)).filter((m) => m != null).map((m) => m.slice(1, 3)));
+    if (!("keyId" in sigValues && "headers" in sigValues &&
+        "signature" in sigValues)) {
+        return null;
+    }
+    const { keyId, headers, signature } = sigValues;
+    const { document } = await documentLoader(keyId);
+    let object;
+    try {
+        object = await ASObject.fromJsonLd(document, { documentLoader });
+    }
+    catch (e) {
+        if (!(e instanceof TypeError))
+            throw e;
+        try {
+            object = await CryptographicKey.fromJsonLd(document, { documentLoader });
+        }
+        catch (e) {
+            if (e instanceof TypeError)
+                return null;
+            throw e;
+        }
+    }
+    let key = null;
+    if (object instanceof CryptographicKey)
+        key = object;
+    else if (isActor(object)) {
+        for await (const k of object.getPublicKeys({ documentLoader })) {
+            if (k.id?.href === keyId) {
+                key = k;
+                break;
+            }
+        }
+        if (key == null)
+            return null;
+    }
+    else
+        return null;
+    if (key.publicKey == null)
+        return null;
+    const headerNames = headers.split(/\s+/g);
+    if (!headerNames.includes("(request-target)") || !headerNames.includes("date")) {
+        return null;
+    }
+    if (body != null && !headerNames.includes("digest"))
+        return null;
+    const message = headerNames.map((name) => `${name}: ` +
+        (name == "(request-target)"
+            ? `${request.method.toLowerCase()} ${new URL(request.url).pathname}`
+            : name == "host"
+                ? request.headers.get("host") ?? new URL(request.url).host
+                : request.headers.get(name))).join("\n");
+    const sig = decodeBase64(signature);
+    // TODO: support other than RSASSA-PKCS1-v1_5:
+    const verified = await dntShim.crypto.subtle.verify("RSASSA-PKCS1-v1_5", key.publicKey, sig, new TextEncoder().encode(message));
+    return verified ? key : null;
+}
+/**
+ * Checks if the actor of the given activity owns the specified key.
+ * @param activity The activity to check.
+ * @param key The public key to check.
+ * @param documentLoader The document loader to use for fetching the actor.
+ * @returns Whether the actor is the owner of the key.
+ */
+export async function doesActorOwnKey(activity, key, documentLoader) {
+    if (key.ownerId != null) {
+        return key.ownerId.href === activity.actorId?.href;
+    }
+    const actor = await activity.getActor({ documentLoader });
+    if (actor == null || !isActor(actor))
+        return false;
+    for (const publicKeyId of actor.publicKeyIds) {
+        if (key.id != null && publicKeyId.href === key.id.href)
+            return true;
+    }
+    return false;
+}

package/esm/httpsig/mod.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.test.d.ts","sourceRoot":"","sources":["../../src/httpsig/mod.test.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

package/esm/mod.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Fedify: a fediverse server framework
+ * ====================================
+ *
+ * Fedify is a [Deno]/TypeScript library for building federated server apps
+ * powered by [ActivityPub] and other standards, which is so-called [fediverse].
+ * It aims to eliminate the complexity and redundant boilerplate code when
+ * building a federated server app, so that you can focus on your business
+ * logic and user experience.
+ *
+ * Currently, Fedify is moving fast and the API is not stable yet.  We do not
+ * recommend using it in production yet, so please use it if you would like to
+ * experiment with it and help us improve it.
+ *
+ * The rough roadmap is to implement the following features out of the box:
+ *
+ * - Type-safe objects for [Activity Vocabulary] (including some vendor-specific
+ *   extensions)
+ * - [WebFinger] client and server
+ * - [HTTP Signatures]
+ * - Middlewares for handling webhooks
+ * - [ActivityPub] client
+ * - [NodeInfo] protocol
+ * - Special touch for interoperability with Mastodon and few other popular
+ *   fediverse software
+ *
+ * If you want to know more about the project, please take a look at the
+ * following resources:
+ *
+ * - [GitHub](https://github.com/dahlia/fedify)
+ * - [Manual](https://fedify.dev/manual/)
+ *   ([Unstable](https://unstable.fedify.dev/manual/))
+ * - [Examples](https://github.com/dahlia/fedify/tree/main/examples)
+ *
+ * [Deno]: https://deno.com/
+ * [ActivityPub]: https://www.w3.org/TR/activitypub/
+ * [fediverse]: https://en.wikipedia.org/wiki/Fediverse
+ * [Activity Vocabulary]: https://www.w3.org/TR/activitystreams-vocabulary/
+ * [WebFinger]: https://datatracker.ietf.org/doc/html/rfc7033
+ * [HTTP Signatures]: https://tools.ietf.org/html/draft-cavage-http-signatures-12
+ * [NodeInfo]: https://nodeinfo.diaspora.software/
+ *
+ * @module
+ */
+export * from "./federation/mod.js";
+export * from "./httpsig/mod.js";
+export * from "./nodeinfo/mod.js";
+export * from "./runtime/mod.js";
+export * from "./vocab/mod.js";
+export { lookupWebFinger, type ResourceDescriptor } from "./webfinger/mod.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/esm/mod.js

@@ -0,0 +1,50 @@
+/**
+ * Fedify: a fediverse server framework
+ * ====================================
+ *
+ * Fedify is a [Deno]/TypeScript library for building federated server apps
+ * powered by [ActivityPub] and other standards, which is so-called [fediverse].
+ * It aims to eliminate the complexity and redundant boilerplate code when
+ * building a federated server app, so that you can focus on your business
+ * logic and user experience.
+ *
+ * Currently, Fedify is moving fast and the API is not stable yet.  We do not
+ * recommend using it in production yet, so please use it if you would like to
+ * experiment with it and help us improve it.
+ *
+ * The rough roadmap is to implement the following features out of the box:
+ *
+ * - Type-safe objects for [Activity Vocabulary] (including some vendor-specific
+ *   extensions)
+ * - [WebFinger] client and server
+ * - [HTTP Signatures]
+ * - Middlewares for handling webhooks
+ * - [ActivityPub] client
+ * - [NodeInfo] protocol
+ * - Special touch for interoperability with Mastodon and few other popular
+ *   fediverse software
+ *
+ * If you want to know more about the project, please take a look at the
+ * following resources:
+ *
+ * - [GitHub](https://github.com/dahlia/fedify)
+ * - [Manual](https://fedify.dev/manual/)
+ *   ([Unstable](https://unstable.fedify.dev/manual/))
+ * - [Examples](https://github.com/dahlia/fedify/tree/main/examples)
+ *
+ * [Deno]: https://deno.com/
+ * [ActivityPub]: https://www.w3.org/TR/activitypub/
+ * [fediverse]: https://en.wikipedia.org/wiki/Fediverse
+ * [Activity Vocabulary]: https://www.w3.org/TR/activitystreams-vocabulary/
+ * [WebFinger]: https://datatracker.ietf.org/doc/html/rfc7033
+ * [HTTP Signatures]: https://tools.ietf.org/html/draft-cavage-http-signatures-12
+ * [NodeInfo]: https://nodeinfo.diaspora.software/
+ *
+ * @module
+ */
+export * from "./federation/mod.js";
+export * from "./httpsig/mod.js";
+export * from "./nodeinfo/mod.js";
+export * from "./runtime/mod.js";
+export * from "./vocab/mod.js";
+export { lookupWebFinger } from "./webfinger/mod.js";

package/esm/nodeinfo/handler.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="node" />
+import type { NodeInfoDispatcher } from "../federation/callback.js";
+import type { RequestContext } from "../federation/context.js";
+/**
+ * Parameters for {@link handleNodeInfo}.
+ */
+export interface NodeInfoHandlerParameters<TContextData> {
+    /**
+     * The request context.
+     */
+    context: RequestContext<TContextData>;
+    /**
+     * The callback for dispatching the NodeInfo.
+     */
+    nodeInfoDispatcher: NodeInfoDispatcher<TContextData>;
+}
+/**
+ * Handles a NodeInfo request.  You would not typically call this function
+ * directly, but instead use {@link Federation.handle} method.
+ * @param request The NodeInfo request to handle.
+ * @param parameters The parameters for handling the request.
+ * @returns The response to the request.
+ */
+export declare function handleNodeInfo<TContextData>(_request: Request, { context, nodeInfoDispatcher }: NodeInfoHandlerParameters<TContextData>): Promise<Response>;
+/**
+ * Handles a request to `/.well-known/nodeinfo`.  You would not typically call
+ * this function directly, but instead use {@link Federation.handle} method.
+ * @param request The request to handle.
+ * @param context The request context.
+ * @returns The response to the request.
+ */
+export declare function handleNodeInfoJrd<TContextData>(_request: Request, context: RequestContext<TContextData>): Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

package/esm/nodeinfo/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/nodeinfo/handler.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,YAAY;IACrD;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAEtC;;OAEG;IACH,kBAAkB,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;CACtD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAC/C,QAAQ,EAAE,OAAO,EACjB,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,yBAAyB,CAAC,YAAY,CAAC,GACvE,OAAO,CAAC,QAAQ,CAAC,CAUnB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAC5C,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,GACpC,OAAO,CAAC,QAAQ,CAAC,CAmBnB"}

package/esm/nodeinfo/handler.js

@@ -0,0 +1,49 @@
+import { RouterError } from "../federation/router.js";
+import { nodeInfoToJson } from "./types.js";
+/**
+ * Handles a NodeInfo request.  You would not typically call this function
+ * directly, but instead use {@link Federation.handle} method.
+ * @param request The NodeInfo request to handle.
+ * @param parameters The parameters for handling the request.
+ * @returns The response to the request.
+ */
+export async function handleNodeInfo(_request, { context, nodeInfoDispatcher }) {
+    const promise = nodeInfoDispatcher(context);
+    const nodeInfo = promise instanceof Promise ? await promise : promise;
+    const json = nodeInfoToJson(nodeInfo);
+    return new Response(JSON.stringify(json), {
+        headers: {
+            "Content-Type": "application/json;" +
+                ' profile="http://nodeinfo.diaspora.software/ns/schema/2.1#"',
+        },
+    });
+}
+/**
+ * Handles a request to `/.well-known/nodeinfo`.  You would not typically call
+ * this function directly, but instead use {@link Federation.handle} method.
+ * @param request The request to handle.
+ * @param context The request context.
+ * @returns The response to the request.
+ */
+export function handleNodeInfoJrd(_request, context) {
+    const links = [];
+    try {
+        links.push({
+            rel: "http://nodeinfo.diaspora.software/ns/schema/2.1",
+            href: context.getNodeInfoUri().href,
+            type: "application/json;" +
+                ' profile="http://nodeinfo.diaspora.software/ns/schema/2.1#"',
+        });
+    }
+    catch (e) {
+        if (!(e instanceof RouterError))
+            throw e;
+    }
+    const jrd = { links };
+    const response = new Response(JSON.stringify(jrd), {
+        headers: {
+            "Content-Type": "application/jrd+json",
+        },
+    });
+    return Promise.resolve(response);
+}

package/esm/nodeinfo/handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.test.d.ts","sourceRoot":"","sources":["../../src/nodeinfo/handler.test.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

package/esm/nodeinfo/mod.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This module implements the [NodeInfo](https://nodeinfo.diaspora.software/)
+ * protocol.
+ *
+ * @module
+ */
+export * from "./types.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/nodeinfo/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/nodeinfo/mod.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC"}

package/esm/nodeinfo/mod.js

@@ -0,0 +1,7 @@
+/**
+ * This module implements the [NodeInfo](https://nodeinfo.diaspora.software/)
+ * protocol.
+ *
+ * @module
+ */
+export * from "./types.js";

package/esm/nodeinfo/types.d.ts

@@ -0,0 +1,133 @@
+/// <reference types="node" />
+import { type SemVer } from "../deps/jsr.io/@std/semver/0.220.1/mod.js";
+/**
+ * The type of the result of parsing JSON.
+ */
+export type JsonValue = {
+    [key: string]: JsonValue | undefined;
+} | JsonValue[] | string | number | boolean | null;
+/**
+ * A NodeInfo object as defined in the NodeInfo 2.1 schema.
+ */
+export 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.
+ */
+export 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: SemVer;
+    /**
+     * 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function nodeInfoToJson(nodeInfo: NodeInfo): JsonValue;
+//# sourceMappingURL=types.d.ts.map

package/esm/nodeinfo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/nodeinfo/types.ts"],"names":[],"mappings":";AAAA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,GACxC,SAAS,EAAE,GACX,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAEhB,aAAa,GACb,YAAY,GACZ,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,GACN,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAEtB,SAAS,GACT,WAAW,GACX,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,MAAM,eAAe,GAEvB,SAAS,GACT,SAAS,GACT,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,GACR,eAAe,GACf,WAAW,GACX,UAAU,GACV,aAAa,GACb,aAAa,GACb,SAAS,GACT,WAAW,GACX,MAAM,GACN,WAAW,GACX,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,GACT,WAAW,GACX,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,KAAK,EAAE;QACL;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CA8D5D"}

package/esm/nodeinfo/types.js

@@ -0,0 +1,60 @@
+import { format } from "../deps/jsr.io/@std/semver/0.220.1/mod.js";
+/**
+ * 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.
+ */
+export function nodeInfoToJson(nodeInfo) {
+    if (!nodeInfo.software.name.match(/^[a-z0-9-]+$/)) {
+        throw new TypeError("Invalid software name.");
+    }
+    if (nodeInfo.protocols.length < 1) {
+        throw new TypeError("At least one protocol must be supported.");
+    }
+    if (nodeInfo.usage.users.total != null &&
+        (nodeInfo.usage.users.total < 0 ||
+            !Number.isInteger(nodeInfo.usage.users.total))) {
+        throw new TypeError("Invalid total users.");
+    }
+    if (nodeInfo.usage.users.activeHalfyear != null &&
+        (nodeInfo.usage.users.activeHalfyear < 0 ||
+            !Number.isInteger(nodeInfo.usage.users.activeHalfyear))) {
+        throw new TypeError("Invalid active halfyear users.");
+    }
+    if (nodeInfo.usage.users.activeMonth != null &&
+        (nodeInfo.usage.users.activeMonth < 0 ||
+            !Number.isInteger(nodeInfo.usage.users.activeMonth))) {
+        throw new TypeError("Invalid active month users.");
+    }
+    if (nodeInfo.usage.localPosts < 0 ||
+        !Number.isInteger(nodeInfo.usage.localPosts)) {
+        throw new TypeError("Invalid local posts.");
+    }
+    if (nodeInfo.usage.localComments < 0 ||
+        !Number.isInteger(nodeInfo.usage.localComments)) {
+        throw new TypeError("Invalid local comments.");
+    }
+    return {
+        "$schema": "http://nodeinfo.diaspora.software/ns/schema/2.1#",
+        version: "2.1",
+        software: {
+            name: nodeInfo.software.name,
+            version: format(nodeInfo.software.version),
+            repository: nodeInfo.software.repository?.href,
+            homepage: nodeInfo.software.homepage?.href,
+        },
+        protocols: nodeInfo.protocols,
+        services: nodeInfo.services == null ? { inbound: [], outbound: [] } : {
+            inbound: nodeInfo.services.inbound ?? [],
+            outbound: nodeInfo.services.outbound ?? [],
+        },
+        openRegistrations: nodeInfo.openRegistrations ?? false,
+        usage: {
+            users: nodeInfo.usage.users,
+            localPosts: nodeInfo.usage.localPosts,
+            localComments: nodeInfo.usage.localComments,
+        },
+        metadata: nodeInfo.metadata ?? {},
+    };
+}

package/esm/nodeinfo/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["../../src/nodeinfo/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}