@fedify/fedify 0.5.0-dev.88

package/esm/federation/handler.d.ts

@@ -0,0 +1,83 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { DocumentLoader } from "../runtime/docloader.js";
+import { Activity, type Link, type Object } from "../vocab/vocab.js";
+import type { ActorDispatcher, CollectionCounter, CollectionCursor, CollectionDispatcher, InboxErrorHandler, InboxListener } from "./callback.js";
+import type { RequestContext } from "./context.js";
+import type { KvKey, KvStore } from "./kv.js";
+export declare function acceptsJsonLd(request: Request): boolean;
+export interface ActorHandlerParameters<TContextData> {
+    handle: string;
+    context: RequestContext<TContextData>;
+    actorDispatcher?: ActorDispatcher<TContextData>;
+    onNotFound(request: Request): Response | Promise<Response>;
+    onNotAcceptable(request: Request): Response | Promise<Response>;
+}
+export declare function handleActor<TContextData>(request: Request, { handle, context, actorDispatcher, onNotFound, onNotAcceptable, }: ActorHandlerParameters<TContextData>): Promise<Response>;
+/**
+ * Callbacks for handling a collection.
+ */
+export interface CollectionCallbacks<TItem, TContextData> {
+    /**
+     * A callback that dispatches a collection.
+     */
+    dispatcher: CollectionDispatcher<TItem, TContextData>;
+    /**
+     * A callback that counts the number of items in a collection.
+     */
+    counter?: CollectionCounter<TContextData>;
+    /**
+     * A callback that returns the first cursor for a collection.
+     */
+    firstCursor?: CollectionCursor<TContextData>;
+    /**
+     * A callback that returns the last cursor for a collection.
+     */
+    lastCursor?: CollectionCursor<TContextData>;
+}
+export interface CollectionHandlerParameters<TItem, TContextData> {
+    handle: string;
+    context: RequestContext<TContextData>;
+    collectionCallbacks?: CollectionCallbacks<TItem, TContextData>;
+    onNotFound(request: Request): Response | Promise<Response>;
+    onNotAcceptable(request: Request): Response | Promise<Response>;
+}
+export declare function handleCollection<TItem extends URL | Object | Link, TContextData>(request: Request, { handle, context, collectionCallbacks, onNotFound, onNotAcceptable, }: CollectionHandlerParameters<TItem, TContextData>): Promise<Response>;
+export interface InboxHandlerParameters<TContextData> {
+    handle: string | null;
+    context: RequestContext<TContextData>;
+    kv: KvStore;
+    kvPrefix: KvKey;
+    actorDispatcher?: ActorDispatcher<TContextData>;
+    inboxListeners: Map<new (...args: unknown[]) => Activity, InboxListener<TContextData, Activity>>;
+    inboxErrorHandler?: InboxErrorHandler<TContextData>;
+    onNotFound(request: Request): Response | Promise<Response>;
+}
+export declare function handleInbox<TContextData>(request: Request, { handle, context, kv, kvPrefix, actorDispatcher, inboxListeners, inboxErrorHandler, onNotFound, }: InboxHandlerParameters<TContextData>): Promise<Response>;
+/**
+ * Options for the {@link respondWithObject} and
+ * {@link respondWithObjectIfAcceptable} functions.
+ */
+export interface RespondWithObjectOptions {
+    /**
+     * The document loader to use for compacting JSON-LD.
+     */
+    documentLoader: DocumentLoader;
+}
+/**
+ * Responds with the given object in JSON-LD format.
+ *
+ * @param object The object to respond with.
+ * @param options Options.
+ */
+export declare function respondWithObject(object: Object, options?: RespondWithObjectOptions): Promise<Response>;
+/**
+ * Responds with the given object in JSON-LD format if the request accepts
+ * JSON-LD.
+ *
+ * @param object The object to respond with.
+ * @param request The request to check for JSON-LD acceptability.
+ * @param options Options.
+ */
+export declare function respondWithObjectIfAcceptable(object: Object, request: Request, options?: RespondWithObjectOptions): Promise<Response | null>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/federation/handler.ts"],"names":[],"mappings":"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"}

package/esm/federation/handler.js

@@ -0,0 +1,266 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { accepts } from "../deps/jsr.io/@std/http/0.220.1/negotiation.js";
+import { doesActorOwnKey, verify } from "../httpsig/mod.js";
+import { Activity, OrderedCollection, OrderedCollectionPage, } from "../vocab/vocab.js";
+export function acceptsJsonLd(request) {
+    const types = accepts(request);
+    if (types == null)
+        return true;
+    if (types[0] === "text/html" || types[0] === "application/xhtml+xml") {
+        return false;
+    }
+    return types.includes("application/activity+json") ||
+        types.includes("application/ld+json") ||
+        types.includes("application/json");
+}
+export async function handleActor(request, { handle, context, actorDispatcher, onNotFound, onNotAcceptable, }) {
+    if (actorDispatcher == null) {
+        const response = onNotFound(request);
+        return response instanceof Promise ? await response : response;
+    }
+    if (!acceptsJsonLd(request)) {
+        const response = onNotAcceptable(request);
+        return response instanceof Promise ? await response : response;
+    }
+    const key = await context.getActorKey(handle);
+    const actor = await actorDispatcher(context, handle, key);
+    if (actor == null) {
+        const response = onNotFound(request);
+        return response instanceof Promise ? await response : response;
+    }
+    const jsonLd = await actor.toJsonLd(context);
+    return new Response(JSON.stringify(jsonLd), {
+        headers: {
+            "Content-Type": "application/activity+json",
+            Vary: "Accept",
+        },
+    });
+}
+export async function handleCollection(request, { handle, context, collectionCallbacks, onNotFound, onNotAcceptable, }) {
+    if (collectionCallbacks == null) {
+        const response = onNotFound(request);
+        return response instanceof Promise ? await response : response;
+    }
+    if (!acceptsJsonLd(request)) {
+        const response = onNotAcceptable(request);
+        return response instanceof Promise ? await response : response;
+    }
+    const url = new URL(request.url);
+    const cursor = url.searchParams.get("cursor");
+    let collection;
+    if (cursor == null) {
+        const firstCursorPromise = collectionCallbacks.firstCursor?.(context, handle);
+        const firstCursor = firstCursorPromise instanceof Promise
+            ? await firstCursorPromise
+            : firstCursorPromise;
+        const totalItemsPromise = collectionCallbacks.counter?.(context, handle);
+        const totalItems = totalItemsPromise instanceof Promise
+            ? await totalItemsPromise
+            : totalItemsPromise;
+        if (firstCursor == null) {
+            const pagePromise = collectionCallbacks.dispatcher(context, handle, null);
+            const page = pagePromise instanceof Promise
+                ? await pagePromise
+                : pagePromise;
+            if (page == null) {
+                const response = onNotFound(request);
+                return response instanceof Promise ? await response : response;
+            }
+            const { items } = page;
+            collection = new OrderedCollection({
+                totalItems: totalItems == null ? null : Number(totalItems),
+                items,
+            });
+        }
+        else {
+            const lastCursorPromise = collectionCallbacks.lastCursor?.(context, handle);
+            const lastCursor = lastCursorPromise instanceof Promise
+                ? await lastCursorPromise
+                : lastCursorPromise;
+            const first = new URL(context.url);
+            first.searchParams.set("cursor", firstCursor);
+            let last = null;
+            if (lastCursor != null) {
+                last = new URL(context.url);
+                last.searchParams.set("cursor", lastCursor);
+            }
+            collection = new OrderedCollection({
+                totalItems: Number(totalItems),
+                first,
+                last,
+            });
+        }
+    }
+    else {
+        const pagePromise = collectionCallbacks.dispatcher(context, handle, cursor);
+        const page = pagePromise instanceof Promise
+            ? await pagePromise
+            : pagePromise;
+        if (page == null) {
+            const response = onNotFound(request);
+            return response instanceof Promise ? await response : response;
+        }
+        const { items, prevCursor, nextCursor } = page;
+        let prev = null;
+        if (prevCursor != null) {
+            prev = new URL(context.url);
+            prev.searchParams.set("cursor", prevCursor);
+        }
+        let next = null;
+        if (nextCursor != null) {
+            next = new URL(context.url);
+            next.searchParams.set("cursor", nextCursor);
+        }
+        const partOf = new URL(context.url);
+        partOf.searchParams.delete("cursor");
+        collection = new OrderedCollectionPage({ prev, next, items, partOf });
+    }
+    const jsonLd = await collection.toJsonLd(context);
+    return new Response(JSON.stringify(jsonLd), {
+        headers: {
+            "Content-Type": "application/activity+json",
+            Vary: "Accept",
+        },
+    });
+}
+export async function handleInbox(request, { handle, context, kv, kvPrefix, actorDispatcher, inboxListeners, inboxErrorHandler, onNotFound, }) {
+    if (actorDispatcher == null) {
+        const response = onNotFound(request);
+        return response instanceof Promise ? await response : response;
+    }
+    else if (handle != null) {
+        const key = await context.getActorKey(handle);
+        const promise = actorDispatcher(context, handle, key);
+        const actor = promise instanceof Promise ? await promise : promise;
+        if (actor == null) {
+            const response = onNotFound(request);
+            return response instanceof Promise ? await response : response;
+        }
+    }
+    const key = await verify(request, context.documentLoader);
+    if (key == null) {
+        const response = new Response("Failed to verify the request signature.", {
+            status: 401,
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+        return response;
+    }
+    let json;
+    try {
+        json = await request.json();
+    }
+    catch (e) {
+        const promise = inboxErrorHandler?.(context, e);
+        if (promise instanceof Promise)
+            await promise;
+        return new Response("Invalid JSON.", {
+            status: 400,
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+    }
+    let activity;
+    try {
+        activity = await Activity.fromJsonLd(json, context);
+    }
+    catch (e) {
+        const promise = inboxErrorHandler?.(context, e);
+        if (promise instanceof Promise)
+            await promise;
+        return new Response("Invalid activity.", {
+            status: 400,
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+    }
+    const cacheKey = activity.id == null
+        ? null
+        : [...kvPrefix, activity.id.href];
+    if (cacheKey != null) {
+        const cached = await kv.get(cacheKey);
+        if (cached === true) {
+            return new Response(`Activity <${activity.id}> has already been processed.`, {
+                status: 202,
+                headers: { "Content-Type": "text/plain; charset=utf-8" },
+            });
+        }
+    }
+    if (activity.actorId == null) {
+        const response = new Response("Missing actor.", {
+            status: 400,
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+        return response;
+    }
+    if (!await doesActorOwnKey(activity, key, context.documentLoader)) {
+        const response = new Response("The signer and the actor do not match.", {
+            status: 401,
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+        return response;
+    }
+    // deno-lint-ignore no-explicit-any
+    let cls = activity
+        // deno-lint-ignore no-explicit-any
+        .constructor;
+    while (true) {
+        if (inboxListeners.has(cls))
+            break;
+        if (cls === Activity) {
+            return new Response("", {
+                status: 202,
+                headers: { "Content-Type": "text/plain; charset=utf-8" },
+            });
+        }
+        cls = globalThis.Object.getPrototypeOf(cls);
+    }
+    const listener = inboxListeners.get(cls);
+    try {
+        const promise = listener(context, activity);
+        if (promise instanceof Promise)
+            await promise;
+    }
+    catch (e) {
+        const promise = inboxErrorHandler?.(context, e);
+        if (promise instanceof Promise)
+            await promise;
+        return new Response("Internal server error.", {
+            status: 500,
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+    }
+    if (cacheKey != null) {
+        await kv.set(cacheKey, true, { ttl: Temporal.Duration.from({ days: 1 }) });
+    }
+    return new Response("", {
+        status: 202,
+        headers: { "Content-Type": "text/plain; charset=utf-8" },
+    });
+}
+/**
+ * Responds with the given object in JSON-LD format.
+ *
+ * @param object The object to respond with.
+ * @param options Options.
+ */
+export async function respondWithObject(object, options) {
+    const jsonLd = await object.toJsonLd(options);
+    return new Response(JSON.stringify(jsonLd), {
+        headers: {
+            "Content-Type": "application/activity+json",
+        },
+    });
+}
+/**
+ * Responds with the given object in JSON-LD format if the request accepts
+ * JSON-LD.
+ *
+ * @param object The object to respond with.
+ * @param request The request to check for JSON-LD acceptability.
+ * @param options Options.
+ */
+export async function respondWithObjectIfAcceptable(object, request, options) {
+    if (!acceptsJsonLd(request))
+        return null;
+    const response = await respondWithObject(object, options);
+    response.headers.set("Vary", "Accept");
+    return response;
+}

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

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

package/esm/federation/kv.d.ts

@@ -0,0 +1,58 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * A key for a key-value store.  An array of one or more strings.
+ */
+export type KvKey = readonly [string] | readonly [string, ...string[]];
+/**
+ * Additional options for setting a value in a key-value store.
+ */
+export interface KvStoreSetOptions {
+    /**
+     * The time-to-live (TTL) for the value.
+     */
+    ttl?: Temporal.Duration;
+}
+/**
+ * An abstract interface for a key-value store.
+ */
+export interface KvStore {
+    /**
+     * Gets the value for the given key.
+     * @param key The key to get the value for.
+     * @returns The value for the key, or `undefined` if the key does not exist.
+     * @typeParam T The type of the value to get.
+     */
+    get<T = unknown>(key: KvKey): Promise<T | undefined>;
+    /**
+     * Sets the value for the given key.
+     * @param key The key to set the value for.
+     * @param value The value to set.
+     * @param options Additional options for setting the value.
+     */
+    set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
+    /**
+     * Deletes the value for the given key.
+     * @param key The key to delete.
+     */
+    delete(key: KvKey): Promise<void>;
+}
+/**
+ * A key-value store that stores values in memory.
+ * Do not use this in production as it does not persist values.
+ */
+export declare class MemoryKvStore implements KvStore {
+    #private;
+    /**
+     * {@inheritDoc KvStore.get}
+     */
+    get<T = unknown>(key: KvKey): Promise<T | undefined>;
+    /**
+     * {@inheritDoc KvStore.set}
+     */
+    set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
+    /**
+     * {@inheritDoc KvStore.delete}
+     */
+    delete(key: KvKey): Promise<void>;
+}
+//# sourceMappingURL=kv.d.ts.map

package/esm/federation/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/federation/kv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;OAKG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAErD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,OAAO;;IAO3C;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAcpD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3E;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlC"}

package/esm/federation/kv.js

@@ -0,0 +1,45 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * A key-value store that stores values in memory.
+ * Do not use this in production as it does not persist values.
+ */
+export class MemoryKvStore {
+    #values = {};
+    #encodeKey(key) {
+        return JSON.stringify(key);
+    }
+    /**
+     * {@inheritDoc KvStore.get}
+     */
+    get(key) {
+        const encodedKey = this.#encodeKey(key);
+        const entry = this.#values[encodedKey];
+        if (entry == null)
+            return Promise.resolve(undefined);
+        const [value, expiration] = entry;
+        if (expiration != null && Temporal.Now.instant().until(expiration).sign < 0) {
+            delete this.#values[encodedKey];
+            return Promise.resolve(undefined);
+        }
+        return Promise.resolve(value);
+    }
+    /**
+     * {@inheritDoc KvStore.set}
+     */
+    set(key, value, options) {
+        const encodedKey = this.#encodeKey(key);
+        const expiration = options?.ttl == null
+            ? null
+            : Temporal.Now.instant().add(options.ttl.round({ largestUnit: "hour" }));
+        this.#values[encodedKey] = [value, expiration];
+        return Promise.resolve();
+    }
+    /**
+     * {@inheritDoc KvStore.delete}
+     */
+    delete(key) {
+        const encodedKey = this.#encodeKey(key);
+        delete this.#values[encodedKey];
+        return Promise.resolve();
+    }
+}