@fedify/relay 2.0.0-dev.100

package/dist/mod.cjs

@@ -0,0 +1,438 @@
+
+        const { Temporal } = require("@js-temporal/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
+const __fedify_fedify = __toESM(require("@fedify/fedify"));
+const __fedify_fedify_vocab = __toESM(require("@fedify/fedify/vocab"));
+const __logtape_logtape = __toESM(require("@logtape/logtape"));
+
+//#region src/types.ts
+const RELAY_SERVER_ACTOR = "relay";
+/**
+* Type predicate to check if a value is valid RelayFollowerData from KV store.
+* Validates the storage format (JSON-LD), not the deserialized Actor instance.
+*
+* @param value The value to check
+* @returns true if the value is a RelayFollowerData
+* @internal
+*/
+function isRelayFollowerData(value) {
+	if (!value || typeof value !== "object") return false;
+	const obj = value;
+	return "actor" in obj && "state" in obj && typeof obj.state === "string" && (obj.state === "pending" || obj.state === "accepted");
+}
+
+//#endregion
+//#region src/builder.ts
+const relayBuilder = (0, __fedify_fedify.createFederationBuilder)();
+relayBuilder.setActorDispatcher("/users/{identifier}", async (ctx, identifier) => {
+	if (identifier !== RELAY_SERVER_ACTOR) return null;
+	const keys = await ctx.getActorKeyPairs(identifier);
+	return new __fedify_fedify_vocab.Application({
+		id: ctx.getActorUri(identifier),
+		preferredUsername: identifier,
+		name: ctx.data.name ?? "ActivityPub Relay",
+		inbox: ctx.getInboxUri(),
+		followers: ctx.getFollowersUri(identifier),
+		following: ctx.getFollowingUri(identifier),
+		url: ctx.getActorUri(identifier),
+		publicKey: keys[0].cryptographicKey,
+		assertionMethods: keys.map((k) => k.multikey)
+	});
+}).setKeyPairsDispatcher(async (ctx, identifier) => {
+	if (identifier !== RELAY_SERVER_ACTOR) return [];
+	const rsaPairJson = await ctx.data.kv.get([
+		"keypair",
+		"rsa",
+		identifier
+	]);
+	const ed25519PairJson = await ctx.data.kv.get([
+		"keypair",
+		"ed25519",
+		identifier
+	]);
+	if (rsaPairJson == null || ed25519PairJson == null) {
+		const rsaPair$1 = await (0, __fedify_fedify.generateCryptoKeyPair)("RSASSA-PKCS1-v1_5");
+		const ed25519Pair$1 = await (0, __fedify_fedify.generateCryptoKeyPair)("Ed25519");
+		await ctx.data.kv.set([
+			"keypair",
+			"rsa",
+			identifier
+		], {
+			privateKey: await (0, __fedify_fedify.exportJwk)(rsaPair$1.privateKey),
+			publicKey: await (0, __fedify_fedify.exportJwk)(rsaPair$1.publicKey)
+		});
+		await ctx.data.kv.set([
+			"keypair",
+			"ed25519",
+			identifier
+		], {
+			privateKey: await (0, __fedify_fedify.exportJwk)(ed25519Pair$1.privateKey),
+			publicKey: await (0, __fedify_fedify.exportJwk)(ed25519Pair$1.publicKey)
+		});
+		return [rsaPair$1, ed25519Pair$1];
+	}
+	const rsaPair = {
+		privateKey: await (0, __fedify_fedify.importJwk)(rsaPairJson.privateKey, "private"),
+		publicKey: await (0, __fedify_fedify.importJwk)(rsaPairJson.publicKey, "public")
+	};
+	const ed25519Pair = {
+		privateKey: await (0, __fedify_fedify.importJwk)(ed25519PairJson.privateKey, "private"),
+		publicKey: await (0, __fedify_fedify.importJwk)(ed25519PairJson.publicKey, "public")
+	};
+	return [rsaPair, ed25519Pair];
+});
+async function getFollowerActors(ctx) {
+	const actors = [];
+	for await (const { value } of ctx.data.kv.list(["follower"])) {
+		if (!isRelayFollowerData(value)) continue;
+		if (value.state !== "accepted") continue;
+		const actor = await __fedify_fedify_vocab.Object.fromJsonLd(value.actor);
+		if (!(0, __fedify_fedify_vocab.isActor)(actor)) continue;
+		actors.push(actor);
+	}
+	return actors;
+}
+async function dispatchRelayActors(ctx, identifier) {
+	if (identifier !== RELAY_SERVER_ACTOR) return null;
+	const actors = await getFollowerActors(ctx);
+	return { items: actors };
+}
+relayBuilder.setFollowersDispatcher("/users/{identifier}/followers", dispatchRelayActors);
+relayBuilder.setFollowingDispatcher("/users/{identifier}/following", dispatchRelayActors);
+
+//#endregion
+//#region src/base.ts
+/**
+* Abstract base class for relay implementations.
+* Provides common infrastructure for both Mastodon and LitePub relays.
+*
+* @internal
+*/
+var BaseRelay = class {
+	federationBuilder;
+	options;
+	federation;
+	constructor(options, relayBuilder$1) {
+		this.options = options;
+		this.federationBuilder = relayBuilder$1;
+	}
+	async fetch(request) {
+		if (this.federation == null) {
+			this.federation = await this.federationBuilder.build(this.options);
+			this.setupInboxListeners();
+		}
+		return await this.federation.fetch(request, { contextData: this.options });
+	}
+	/**
+	* Helper method to parse and validate follower data from storage.
+	* Deserializes JSON-LD actor data and validates it.
+	*
+	* @param actorId The actor ID of the follower
+	* @param data Raw data from KV store
+	* @returns RelayFollower object if valid, null otherwise
+	* @internal
+	*/
+	async parseFollowerData(actorId, data) {
+		if (!isRelayFollowerData(data)) return null;
+		const actor = await __fedify_fedify_vocab.Object.fromJsonLd(data.actor);
+		if (!(0, __fedify_fedify_vocab.isActor)(actor)) return null;
+		return {
+			actorId,
+			actor,
+			state: data.state
+		};
+	}
+	/**
+	* Lists all followers of the relay.
+	*
+	* @returns An async iterator of follower entries
+	*
+	* @example
+	* ```ts
+	* import { createRelay } from "@fedify/relay";
+	* import { MemoryKvStore } from "@fedify/fedify";
+	*
+	* const relay = createRelay("mastodon", {
+	*   kv: new MemoryKvStore(),
+	*   domain: "relay.example.com",
+	*   subscriptionHandler: async (ctx, actor) => true,
+	* });
+	*
+	* for await (const follower of relay.listFollowers()) {
+	*   console.log(`Follower: ${follower.actorId}`);
+	*   console.log(`State: ${follower.state}`);
+	*   console.log(`Actor: ${follower.actor.name}`);
+	* }
+	* ```
+	*
+	* @since 2.0.0
+	*/
+	async *listFollowers() {
+		for await (const entry of this.options.kv.list(["follower"])) {
+			const actorId = entry.key[1];
+			if (typeof actorId !== "string") continue;
+			const follower = await this.parseFollowerData(actorId, entry.value);
+			if (follower) yield follower;
+		}
+	}
+	/**
+	* Gets a specific follower by actor ID.
+	*
+	* @param actorId The actor ID (URL) of the follower to retrieve
+	* @returns The follower entry if found, null otherwise
+	*
+	* @example
+	* ```ts
+	* import { createRelay } from "@fedify/relay";
+	* import { MemoryKvStore } from "@fedify/fedify";
+	*
+	* const relay = createRelay("mastodon", {
+	*   kv: new MemoryKvStore(),
+	*   domain: "relay.example.com",
+	*   subscriptionHandler: async (ctx, actor) => true,
+	* });
+	*
+	* const follower = await relay.getFollower(
+	*   "https://mastodon.example.com/users/alice"
+	* );
+	* if (follower) {
+	*   console.log(`State: ${follower.state}`);
+	*   console.log(`Actor: ${follower.actor.preferredUsername}`);
+	* }
+	* ```
+	*
+	* @since 2.0.0
+	*/
+	async getFollower(actorId) {
+		const followerData = await this.options.kv.get(["follower", actorId]);
+		return await this.parseFollowerData(actorId, followerData);
+	}
+};
+
+//#endregion
+//#region src/follow.ts
+/**
+* Validate Follow activity and return follower actor if valid.
+* This validation is common to both Mastodon and LitePub relay protocols.
+*
+* @param ctx The federation context
+* @param follow The Follow activity to validate
+* @returns The follower Actor if valid, null otherwise
+*/
+async function validateFollowActivity(ctx, follow) {
+	if (follow.id == null || follow.objectId == null) return null;
+	const parsed = ctx.parseUri(follow.objectId);
+	const isPublicFollow = follow.objectId.href === "https://www.w3.org/ns/activitystreams#Public";
+	if (!isPublicFollow && parsed?.type !== "actor") return null;
+	const follower = await follow.getActor(ctx);
+	if (follower == null || follower.id == null || follower.preferredUsername == null || follower.inboxId == null) return null;
+	return follower;
+}
+/**
+* Send Accept or Reject response for a Follow activity.
+* This is common to both Mastodon and LitePub relay protocols.
+*
+* @param ctx The federation context
+* @param follow The Follow activity being responded to
+* @param follower The actor who sent the Follow
+* @param approved Whether the follow was approved
+*/
+async function sendFollowResponse(ctx, follow, follower, approved) {
+	const relayActorUri = ctx.getActorUri(RELAY_SERVER_ACTOR);
+	const Activity = approved ? __fedify_fedify.Accept : __fedify_fedify.Reject;
+	const action = approved ? "accepts" : "rejects";
+	await ctx.sendActivity({ identifier: RELAY_SERVER_ACTOR }, follower, new Activity({
+		id: new URL(`#${action}`, relayActorUri),
+		actor: relayActorUri,
+		object: follow
+	}));
+}
+/**
+* Handle Undo activity for Follow.
+* This logic is identical for both Mastodon and LitePub relay protocols.
+*
+* @param ctx The federation context
+* @param undo The Undo activity to handle
+* @param logger The logger instance to use for warnings
+*/
+async function handleUndoFollow(ctx, undo, logger$2) {
+	const activity = await undo.getObject({
+		crossOrigin: "trust",
+		...ctx
+	});
+	if (activity instanceof __fedify_fedify.Follow) {
+		if (activity.id == null || activity.actorId == null) return;
+		await ctx.data.kv.delete(["follower", activity.actorId.href]);
+	} else logger$2.warn("Unsupported object type ({type}) for Undo activity: {object}", {
+		type: activity?.constructor.name,
+		object: activity
+	});
+}
+
+//#endregion
+//#region src/litepub.ts
+const logger$1 = (0, __logtape_logtape.getLogger)([
+	"fedify",
+	"relay",
+	"litepub"
+]);
+/**
+* A LitePub-compatible ActivityPub relay implementation.
+* This relay follows LitePub's relay protocol and extensions for
+* enhanced federation capabilities.
+*
+* @since 2.0.0
+*/
+var LitePubRelay = class extends BaseRelay {
+	async #announceToFollowers(ctx, activity) {
+		const sender = await activity.getActor(ctx);
+		const excludeBaseUris = sender?.id ? [new URL(sender.id)] : [];
+		const announce = new __fedify_fedify.Announce({
+			id: new URL(`/announce#${crypto.randomUUID()}`, ctx.origin),
+			actor: ctx.getActorUri(RELAY_SERVER_ACTOR),
+			object: activity.objectId,
+			to: __fedify_fedify.PUBLIC_COLLECTION,
+			published: Temporal.Now.instant()
+		});
+		await ctx.sendActivity({ identifier: RELAY_SERVER_ACTOR }, "followers", announce, {
+			excludeBaseUris,
+			preferSharedInbox: true
+		});
+	}
+	setupInboxListeners() {
+		if (this.federation != null) this.federation.setInboxListeners("/users/{identifier}/inbox", "/inbox").on(__fedify_fedify.Follow, async (ctx, follow) => {
+			const follower = await validateFollowActivity(ctx, follow);
+			if (!follower || !follower.id) return;
+			const existingFollow = await ctx.data.kv.get(["follower", follower.id.href]);
+			if (existingFollow?.state === "pending") return;
+			const approved = await this.options.subscriptionHandler(ctx, follower);
+			if (approved) {
+				await ctx.data.kv.set(["follower", follower.id.href], {
+					actor: await follower.toJsonLd(),
+					state: "pending"
+				});
+				await sendFollowResponse(ctx, follow, follower, approved);
+				const relayActorUri = ctx.getActorUri(RELAY_SERVER_ACTOR);
+				await ctx.sendActivity({ identifier: RELAY_SERVER_ACTOR }, follower, new __fedify_fedify.Follow({
+					actor: relayActorUri,
+					object: follower.id,
+					to: follower.id
+				}));
+			} else await sendFollowResponse(ctx, follow, follower, approved);
+		}).on(__fedify_fedify.Accept, async (ctx, accept) => {
+			const follow = await accept.getObject({
+				crossOrigin: "trust",
+				...ctx
+			});
+			if (!(follow instanceof __fedify_fedify.Follow)) return;
+			const relayActorId = follow.actorId;
+			if (relayActorId == null) return;
+			const followerActor = await accept.getActor();
+			if (!(0, __fedify_fedify.isActor)(followerActor) || !followerActor.id) return;
+			const parsed = ctx.parseUri(relayActorId);
+			if (parsed == null || parsed.type !== "actor") return;
+			const followerData = await ctx.data.kv.get(["follower", followerActor.id.href]);
+			if (followerData == null) return;
+			const updatedFollowerData = {
+				...followerData,
+				state: "accepted"
+			};
+			await ctx.data.kv.set(["follower", followerActor.id.href], updatedFollowerData);
+		}).on(__fedify_fedify.Undo, async (ctx, undo) => await handleUndoFollow(ctx, undo, logger$1)).on(__fedify_fedify.Create, async (ctx, create) => await this.#announceToFollowers(ctx, create)).on(__fedify_fedify.Update, async (ctx, update) => await this.#announceToFollowers(ctx, update)).on(__fedify_fedify.Move, async (ctx, move) => await this.#announceToFollowers(ctx, move)).on(__fedify_fedify.Delete, async (ctx, deleteActivity) => await this.#announceToFollowers(ctx, deleteActivity)).on(__fedify_fedify.Announce, async (ctx, announce) => await this.#announceToFollowers(ctx, announce));
+	}
+};
+
+//#endregion
+//#region src/mastodon.ts
+const logger = (0, __logtape_logtape.getLogger)([
+	"fedify",
+	"relay",
+	"mastodon"
+]);
+/**
+* A Mastodon-compatible ActivityPub relay implementation.
+* This relay follows Mastodon's relay protocol for compatibility
+* with Mastodon instances.
+*
+* @since 2.0.0
+*/
+var MastodonRelay = class extends BaseRelay {
+	async #forwardToFollowers(ctx, activity) {
+		const sender = await activity.getActor(ctx);
+		const excludeBaseUris = sender?.id ? [new URL(sender.id)] : [];
+		await ctx.forwardActivity({ identifier: RELAY_SERVER_ACTOR }, "followers", {
+			skipIfUnsigned: true,
+			excludeBaseUris,
+			preferSharedInbox: true
+		});
+	}
+	setupInboxListeners() {
+		if (this.federation != null) this.federation.setInboxListeners("/users/{identifier}/inbox", "/inbox").on(__fedify_fedify.Follow, async (ctx, follow) => {
+			const follower = await validateFollowActivity(ctx, follow);
+			if (!follower || !follower.id) return;
+			const approved = await this.options.subscriptionHandler(ctx, follower);
+			if (approved) await ctx.data.kv.set(["follower", follower.id.href], {
+				actor: await follower.toJsonLd(),
+				state: "accepted"
+			});
+			await sendFollowResponse(ctx, follow, follower, approved);
+		}).on(__fedify_fedify.Undo, async (ctx, undo) => await handleUndoFollow(ctx, undo, logger)).on(__fedify_fedify.Create, async (ctx, create) => await this.#forwardToFollowers(ctx, create)).on(__fedify_fedify.Delete, async (ctx, deleteActivity) => await this.#forwardToFollowers(ctx, deleteActivity)).on(__fedify_fedify.Move, async (ctx, move) => await this.#forwardToFollowers(ctx, move)).on(__fedify_fedify.Update, async (ctx, update) => await this.#forwardToFollowers(ctx, update)).on(__fedify_fedify.Announce, async (ctx, announce) => await this.#forwardToFollowers(ctx, announce));
+	}
+};
+
+//#endregion
+//#region src/factory.ts
+/**
+* Factory function to create a relay instance.
+*
+* @param type The type of relay to create ("mastodon" or "litepub")
+* @param options Configuration options for the relay
+* @returns A relay instance
+*
+* @example
+* ```ts
+* import { createRelay } from "@fedify/relay";
+* import { MemoryKvStore } from "@fedify/fedify";
+*
+* const relay = createRelay("mastodon", {
+*   kv: new MemoryKvStore(),
+*   domain: "relay.example.com",
+*   subscriptionHandler: async (ctx, actor) => true,
+* });
+* ```
+*
+* @since 2.0.0
+*/
+function createRelay(type, options) {
+	switch (type) {
+		case "mastodon": return new MastodonRelay(options, relayBuilder);
+		case "litepub": return new LitePubRelay(options, relayBuilder);
+	}
+}
+
+//#endregion
+exports.RELAY_SERVER_ACTOR = RELAY_SERVER_ACTOR;
+exports.createRelay = createRelay;

package/dist/mod.d.cts

@@ -0,0 +1,110 @@
+import { Context, KvStore, MessageQueue } from "@fedify/fedify";
+import { Actor } from "@fedify/fedify/vocab";
+import { AuthenticatedDocumentLoaderFactory, DocumentLoaderFactory } from "@fedify/vocab-runtime";
+
+//#region src/types.d.ts
+declare const RELAY_SERVER_ACTOR = "relay";
+/**
+ * Supported relay types.
+ */
+type RelayType = "mastodon" | "litepub";
+/**
+ * Handler for subscription requests (Follow/Undo activities).
+ */
+type SubscriptionRequestHandler = (ctx: Context<RelayOptions>, clientActor: Actor) => Promise<boolean>;
+/**
+ * Configuration options for the ActivityPub relay.
+ */
+interface RelayOptions {
+  kv: KvStore;
+  domain?: string;
+  name?: string;
+  documentLoaderFactory?: DocumentLoaderFactory;
+  authenticatedDocumentLoaderFactory?: AuthenticatedDocumentLoaderFactory;
+  queue?: MessageQueue;
+  subscriptionHandler: SubscriptionRequestHandler;
+}
+/**
+ * Internal storage format for follower data in KV store.
+ * Contains JSON-LD representation of the actor.
+ * Exported for internal package use but not re-exported from mod.ts.
+ *
+ * @internal
+ */
+
+/**
+ * A follower of the relay with validated Actor instance.
+ * This is the public API type returned by follower query methods.
+ *
+ * @since 2.0.0
+ */
+interface RelayFollower {
+  /** The actor ID (URL) of the follower. */
+  readonly actorId: string;
+  /** The validated Actor object. */
+  readonly actor: Actor;
+  /** The follower's state. */
+  readonly state: "pending" | "accepted";
+}
+/**
+ * Public interface for ActivityPub relay implementations.
+ * Use {@link createRelay} to create a relay instance.
+ *
+ * @since 2.0.0
+ */
+interface Relay {
+  /**
+   * Handle incoming HTTP requests.
+   *
+   * @param request The incoming HTTP request
+   * @returns The HTTP response
+   */
+  fetch(request: Request): Promise<Response>;
+  /**
+   * Lists all followers of the relay.
+   *
+   * @returns An async iterator of follower entries
+   */
+  listFollowers(): AsyncIterableIterator<RelayFollower>;
+  /**
+   * Gets a specific follower by actor ID.
+   *
+   * @param actorId The actor ID (URL) of the follower to retrieve
+   * @returns The follower entry if found, null otherwise
+   */
+  getFollower(actorId: string): Promise<RelayFollower | null>;
+}
+/**
+ * Type predicate to check if a value is valid RelayFollowerData from KV store.
+ * Validates the storage format (JSON-LD), not the deserialized Actor instance.
+ *
+ * @param value The value to check
+ * @returns true if the value is a RelayFollowerData
+ * @internal
+ */
+//#endregion
+//#region src/factory.d.ts
+/**
+ * Factory function to create a relay instance.
+ *
+ * @param type The type of relay to create ("mastodon" or "litepub")
+ * @param options Configuration options for the relay
+ * @returns A relay instance
+ *
+ * @example
+ * ```ts
+ * import { createRelay } from "@fedify/relay";
+ * import { MemoryKvStore } from "@fedify/fedify";
+ *
+ * const relay = createRelay("mastodon", {
+ *   kv: new MemoryKvStore(),
+ *   domain: "relay.example.com",
+ *   subscriptionHandler: async (ctx, actor) => true,
+ * });
+ * ```
+ *
+ * @since 2.0.0
+ */
+declare function createRelay(type: RelayType, options: RelayOptions): Relay;
+//#endregion
+export { RELAY_SERVER_ACTOR, Relay, RelayFollower, RelayOptions, RelayType, SubscriptionRequestHandler, createRelay };

package/dist/mod.d.ts

@@ -0,0 +1,111 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { Context, KvStore, MessageQueue } from "@fedify/fedify";
+import { Actor } from "@fedify/fedify/vocab";
+import { AuthenticatedDocumentLoaderFactory, DocumentLoaderFactory } from "@fedify/vocab-runtime";
+
+//#region src/types.d.ts
+declare const RELAY_SERVER_ACTOR = "relay";
+/**
+ * Supported relay types.
+ */
+type RelayType = "mastodon" | "litepub";
+/**
+ * Handler for subscription requests (Follow/Undo activities).
+ */
+type SubscriptionRequestHandler = (ctx: Context<RelayOptions>, clientActor: Actor) => Promise<boolean>;
+/**
+ * Configuration options for the ActivityPub relay.
+ */
+interface RelayOptions {
+  kv: KvStore;
+  domain?: string;
+  name?: string;
+  documentLoaderFactory?: DocumentLoaderFactory;
+  authenticatedDocumentLoaderFactory?: AuthenticatedDocumentLoaderFactory;
+  queue?: MessageQueue;
+  subscriptionHandler: SubscriptionRequestHandler;
+}
+/**
+ * Internal storage format for follower data in KV store.
+ * Contains JSON-LD representation of the actor.
+ * Exported for internal package use but not re-exported from mod.ts.
+ *
+ * @internal
+ */
+
+/**
+ * A follower of the relay with validated Actor instance.
+ * This is the public API type returned by follower query methods.
+ *
+ * @since 2.0.0
+ */
+interface RelayFollower {
+  /** The actor ID (URL) of the follower. */
+  readonly actorId: string;
+  /** The validated Actor object. */
+  readonly actor: Actor;
+  /** The follower's state. */
+  readonly state: "pending" | "accepted";
+}
+/**
+ * Public interface for ActivityPub relay implementations.
+ * Use {@link createRelay} to create a relay instance.
+ *
+ * @since 2.0.0
+ */
+interface Relay {
+  /**
+   * Handle incoming HTTP requests.
+   *
+   * @param request The incoming HTTP request
+   * @returns The HTTP response
+   */
+  fetch(request: Request): Promise<Response>;
+  /**
+   * Lists all followers of the relay.
+   *
+   * @returns An async iterator of follower entries
+   */
+  listFollowers(): AsyncIterableIterator<RelayFollower>;
+  /**
+   * Gets a specific follower by actor ID.
+   *
+   * @param actorId The actor ID (URL) of the follower to retrieve
+   * @returns The follower entry if found, null otherwise
+   */
+  getFollower(actorId: string): Promise<RelayFollower | null>;
+}
+/**
+ * Type predicate to check if a value is valid RelayFollowerData from KV store.
+ * Validates the storage format (JSON-LD), not the deserialized Actor instance.
+ *
+ * @param value The value to check
+ * @returns true if the value is a RelayFollowerData
+ * @internal
+ */
+//#endregion
+//#region src/factory.d.ts
+/**
+ * Factory function to create a relay instance.
+ *
+ * @param type The type of relay to create ("mastodon" or "litepub")
+ * @param options Configuration options for the relay
+ * @returns A relay instance
+ *
+ * @example
+ * ```ts
+ * import { createRelay } from "@fedify/relay";
+ * import { MemoryKvStore } from "@fedify/fedify";
+ *
+ * const relay = createRelay("mastodon", {
+ *   kv: new MemoryKvStore(),
+ *   domain: "relay.example.com",
+ *   subscriptionHandler: async (ctx, actor) => true,
+ * });
+ * ```
+ *
+ * @since 2.0.0
+ */
+declare function createRelay(type: RelayType, options: RelayOptions): Relay;
+//#endregion
+export { RELAY_SERVER_ACTOR, Relay, RelayFollower, RelayOptions, RelayType, SubscriptionRequestHandler, createRelay };