@fedify/botkit 0.5.0-dev.210 → 0.5.0-dev.225

package/dist/bot-impl.js

@@ -2,21 +2,37 @@
       import { Temporal, toTemporalInstant } from "@js-temporal/polyfill";
       Date.prototype.toTemporalInstant = toTemporalInstant;
     
-import deno_default from "./deno.js";
 import { isEmoji } from "./emoji.js";
 import { FollowRequestImpl } from "./follow-impl.js";
+import { parseLocalUri } from "./uri.js";
 import { createMessage, getMessageVisibility, isMessageObject, isQuoteLink, messageClasses } from "./message-impl.js";
-import { app } from "./pages.js";
-import { KvRepository } from "./repository.js";
+import { ActorScopedRepository, KvRepository } from "./repository.js";
 import { SessionImpl } from "./session-impl.js";
-import { Accept, Announce, Article, ChatMessage, Create, Delete, Emoji, EmojiReact, Endpoints, Follow, Image, Like, Link, Mention, Note, Object as Object$1, PUBLIC_COLLECTION, PropertyValue, Question, Reject, Service, Undo, Update, isActor } from "@fedify/vocab";
-import { createFederation, generateCryptoKeyPair } from "@fedify/fedify";
-import { getLogger } from "@logtape/logtape";
-import mimeDb from "mime-db";
-import fs from "node:fs/promises";
-import { getXForwardedRequest } from "x-forwarded-fetch";
+import { InstanceImpl } from "./instance-impl.js";
+import { Announce, Article, ChatMessage, Create, Emoji, EmojiReact, Endpoints, Follow, Image, Like, Link, Mention, Note, Object as Object$1, PUBLIC_COLLECTION, PropertyValue, Question, Service, Update, isActor } from "@fedify/vocab";
+import { generateCryptoKeyPair } from "@fedify/fedify";
 
 //#region src/bot-impl.ts
+/**
+* The names of the event handler properties of {@link BotEventHandlers}.
+* @internal
+*/
+const botEventHandlerNames = [
+	"onFollow",
+	"onUnfollow",
+	"onAcceptFollow",
+	"onRejectFollow",
+	"onMention",
+	"onReply",
+	"onQuote",
+	"onMessage",
+	"onSharedMessage",
+	"onLike",
+	"onUnlike",
+	"onReact",
+	"onUnreact",
+	"onVote"
+];
 var BotImpl = class {
 	identifier;
 	class;
@@ -29,13 +45,40 @@ var BotImpl = class {
 	properties;
 	#properties;
 	followerPolicy;
-	customEmojis;
 	repository;
-	software;
-	behindProxy;
-	pages;
-	collectionWindow;
-	federation;
+	/**
+	* The instance hosting the bot.  It owns the shared infrastructure:
+	* the Fedify federation, the key–value store, the message queue,
+	* the root repository, and HTTP handling.
+	*/
+	instance;
+	get customEmojis() {
+		return this.instance.customEmojis;
+	}
+	get software() {
+		return this.instance.software;
+	}
+	get behindProxy() {
+		return this.instance.behindProxy;
+	}
+	get pages() {
+		return this.instance.pages;
+	}
+	get collectionWindow() {
+		return this.instance.collectionWindow;
+	}
+	get federation() {
+		return this.instance.federation;
+	}
+	/**
+	* The identifier of the bot actor that owns local objects whose URIs are
+	* in the legacy (pre-0.5) format, which did not carry the identifier.
+	* Legacy URIs can only occur in deployments that hosted a single bot
+	* before the upgrade, so they are attributed to that bot.
+	*/
+	get legacyObjectUrisIdentifier() {
+		return this.instance.legacyObjectUrisIdentifier;
+	}
 	onFollow;
 	onUnfollow;
 	onAcceptFollow;
@@ -62,52 +105,19 @@ var BotImpl = class {
 		this.properties = options.properties ?? {};
 		this.#properties = null;
 		this.followerPolicy = options.followerPolicy ?? "accept";
-		this.customEmojis = {};
-		this.repository = options.repository ?? new KvRepository(options.kv);
-		this.software = options.software;
-		this.pages = {
-			color: "green",
-			css: "",
-			...options.pages ?? {}
-		};
-		this.federation = createFederation({
+		this.instance = options.instance ?? new InstanceImpl({
 			kv: options.kv,
+			repository: new MigrationGatedRepository(options.repository ?? new KvRepository(options.kv), this.identifier),
 			queue: options.queue,
-			userAgent: { software: `BotKit/${deno_default.version}` }
+			software: options.software,
+			behindProxy: options.behindProxy,
+			pages: options.pages,
+			collectionWindow: options.collectionWindow,
+			legacyObjectUris: { identifier: this.identifier },
+			compatMode: true
 		});
-		this.behindProxy = options.behindProxy ?? false;
-		this.collectionWindow = options.collectionWindow ?? 50;
-		this.initialize();
-	}
-	initialize() {
-		this.federation.setActorDispatcher("/ap/actor/{identifier}", this.dispatchActor.bind(this)).mapHandle(this.mapHandle.bind(this)).setKeyPairsDispatcher(this.dispatchActorKeyPairs.bind(this));
-		this.federation.setFollowersDispatcher("/ap/actor/{identifier}/followers", this.dispatchFollowers.bind(this)).setFirstCursor(this.getFollowersFirstCursor.bind(this)).setCounter(this.countFollowers.bind(this));
-		this.federation.setOutboxDispatcher("/ap/actor/{identifier}/outbox", this.dispatchOutbox.bind(this)).setFirstCursor(this.getOutboxFirstCursor.bind(this)).setCounter(this.countOutbox.bind(this));
-		this.federation.setObjectDispatcher(Follow, "/ap/follow/{id}", this.dispatchFollow.bind(this)).authorize(this.authorizeFollow.bind(this));
-		this.federation.setObjectDispatcher(Create, "/ap/create/{id}", this.dispatchCreate.bind(this));
-		this.federation.setObjectDispatcher(Article, "/ap/article/{id}", (ctx, values) => this.dispatchMessage(Article, ctx, values.id));
-		this.federation.setObjectDispatcher(ChatMessage, "/ap/chat-message/{id}", (ctx, values) => this.dispatchMessage(ChatMessage, ctx, values.id));
-		this.federation.setObjectDispatcher(Note, "/ap/note/{id}", (ctx, values) => this.dispatchMessage(Note, ctx, values.id));
-		this.federation.setObjectDispatcher(Question, "/ap/question/{id}", (ctx, values) => this.dispatchMessage(Question, ctx, values.id));
-		this.federation.setObjectDispatcher(Announce, "/ap/announce/{id}", this.dispatchAnnounce.bind(this));
-		this.federation.setObjectDispatcher(Emoji, "/ap/emoji/{name}", this.dispatchEmoji.bind(this));
-		this.federation.setInboxListeners("/ap/actor/{identifier}/inbox", "/ap/inbox").onUnverifiedActivity(this.onUnverifiedActivity.bind(this)).on(Follow, this.onFollowed.bind(this)).on(Undo, async (ctx, undo) => {
-			const object = await undo.getObject(ctx);
-			if (object instanceof Follow) await this.onUnfollowed(ctx, undo);
-			else if (object instanceof Like) await this.onUnliked(ctx, undo);
-			else {
-				const logger = getLogger([
-					"botkit",
-					"bot",
-					"inbox"
-				]);
-				logger.warn("The Undo object {undoId} is not about Follow or Like: {object}.", {
-					undoId: undo.id?.href,
-					object
-				});
-			}
-		}).on(Accept, this.onFollowAccepted.bind(this)).on(Reject, this.onFollowRejected.bind(this)).on(Create, this.onCreated.bind(this)).on(Announce, this.onAnnounced.bind(this)).on(Like, this.onLiked.bind(this)).setSharedKeyDispatcher(this.dispatchSharedKey.bind(this));
-		if (this.software != null) this.federation.setNodeInfoDispatcher("/nodeinfo/2.1", this.dispatchNodeInfo.bind(this));
+		this.repository = this.instance.repository.forIdentifier(this.identifier);
+		if (!options.transient) this.instance.addBot(this);
 	}
 	async getActorSummary(session) {
 		if (this.summary == null) return null;
@@ -163,7 +173,7 @@ var BotImpl = class {
 			outbox: ctx.getOutboxUri(identifier),
 			publicKey: keyPairs[0].cryptographicKey,
 			assertionMethods: keyPairs.map((pair) => pair.multikey),
-			url: new URL("/", ctx.origin)
+			url: this.instance.getBotWebUrl(this, ctx.origin)
 		});
 	}
 	mapHandle(_ctx, username) {
@@ -266,11 +276,13 @@ var BotImpl = class {
 		return await this.repository.countMessages();
 	}
 	async dispatchFollow(_ctx, values) {
+		if (values.identifier !== this.identifier) return null;
 		const id = values.id;
 		const follow = await this.repository.getSentFollow(id);
 		return follow ?? null;
 	}
 	async authorizeFollow(ctx, values) {
+		if (values.identifier !== this.identifier) return false;
 		const signedKeyOwner = await ctx.getSignedKeyOwner();
 		if (signedKeyOwner == null || signedKeyOwner.id == null) return false;
 		const id = values.id;
@@ -279,6 +291,7 @@ var BotImpl = class {
 		return signedKeyOwner.id.href === follow.objectId?.href || signedKeyOwner.id.href === follow.actorId?.href;
 	}
 	async dispatchCreate(ctx, values) {
+		if (values.identifier !== this.identifier) return null;
 		const activity = await this.repository.getMessage(values.id);
 		if (!(activity instanceof Create)) return null;
 		const isVisible = await this.getPermissionChecker(ctx);
@@ -296,21 +309,20 @@ var BotImpl = class {
 		return object;
 	}
 	async dispatchAnnounce(ctx, values) {
+		if (values.identifier !== this.identifier) return null;
 		const activity = await this.repository.getMessage(values.id);
 		if (!(activity instanceof Announce)) return null;
 		const isVisible = await this.getPermissionChecker(ctx);
 		return isVisible(activity) ? activity : null;
 	}
 	dispatchEmoji(ctx, values) {
-		const customEmoji = this.customEmojis[values.name];
-		if (customEmoji == null) return null;
-		return this.getEmoji(ctx, values.name, customEmoji);
+		return this.instance.dispatchEmoji(ctx, values);
 	}
-	dispatchSharedKey(_ctx) {
-		return { identifier: this.identifier };
+	dispatchSharedKey(ctx) {
+		return this.instance.dispatchSharedKey(ctx);
 	}
-	onUnverifiedActivity(_ctx, activity, reason) {
-		if (activity instanceof Delete && reason.type === "keyFetchError" && "status" in reason.result && reason.result.status === 410) return new Response(null, { status: 202 });
+	onUnverifiedActivity(ctx, activity, reason) {
+		return this.instance.onUnverifiedActivity(ctx, activity, reason);
 	}
 	async onFollowed(ctx, follow) {
 		const botUri = ctx.getActorUri(this.identifier);
@@ -339,8 +351,8 @@ var BotImpl = class {
 		}
 	}
 	async onFollowAccepted(ctx, accept) {
-		const parsedObj = ctx.parseUri(accept.objectId);
-		if (parsedObj?.type !== "object" || parsedObj.class !== Follow) return;
+		const parsedObj = parseLocalUri(ctx, accept.objectId, this.legacyObjectUrisIdentifier);
+		if (parsedObj?.type !== "object" || parsedObj.class !== Follow || parsedObj.values.identifier !== this.identifier) return;
 		const follow = await this.repository.getSentFollow(parsedObj.values.id);
 		if (follow == null) return;
 		const followee = await follow.getObject(ctx);
@@ -352,8 +364,8 @@ var BotImpl = class {
 		}
 	}
 	async onFollowRejected(ctx, reject) {
-		const parsedObj = ctx.parseUri(reject.objectId);
-		if (parsedObj?.type !== "object" || parsedObj.class !== Follow) return;
+		const parsedObj = parseLocalUri(ctx, reject.objectId, this.legacyObjectUrisIdentifier);
+		if (parsedObj?.type !== "object" || parsedObj.class !== Follow || parsedObj.values.identifier !== this.identifier) return;
 		const id = parsedObj.values.id;
 		const follow = await this.repository.getSentFollow(id);
 		if (follow == null) return;
@@ -374,8 +386,8 @@ var BotImpl = class {
 			if (messageCache != null) return messageCache;
 			return messageCache = await createMessage(object, session, {});
 		};
-		const replyTarget = ctx.parseUri(object.replyTargetId);
-		if (this.onVote != null && object instanceof Note && replyTarget?.type === "object" && messageClasses.includes(replyTarget.class) && object.name != null) {
+		const replyTarget = parseLocalUri(ctx, object.replyTargetId, this.legacyObjectUrisIdentifier);
+		if (this.onVote != null && object instanceof Note && replyTarget?.type === "object" && messageClasses.includes(replyTarget.class) && replyTarget.values.identifier === this.identifier && object.name != null) {
 			if (create.actorId == null || create.actorId.href === session.actorId.href) return;
 			const actorId = create.actorId;
 			const actor = await create.getActor(ctx);
@@ -460,7 +472,7 @@ var BotImpl = class {
 			}
 			return;
 		}
-		if (this.onReply != null && replyTarget?.type === "object" && messageClasses.includes(replyTarget.class)) {
+		if (this.onReply != null && replyTarget?.type === "object" && messageClasses.includes(replyTarget.class) && replyTarget.values.identifier === this.identifier) {
 			const message = await getMessage();
 			if (message.visibility === "public" || message.visibility === "unlisted") await ctx.forwardActivity(this, "followers", {
 				skipIfUnsigned: true,
@@ -475,8 +487,8 @@ var BotImpl = class {
 			break;
 		}
 		if (quoteUrl == null) quoteUrl = object.quoteUrl;
-		const quoteTarget = ctx.parseUri(quoteUrl);
-		if (this.onQuote != null && quoteTarget?.type === "object" && messageClasses.includes(quoteTarget.class)) {
+		const quoteTarget = parseLocalUri(ctx, quoteUrl, this.legacyObjectUrisIdentifier);
+		if (this.onQuote != null && quoteTarget?.type === "object" && messageClasses.includes(quoteTarget.class) && quoteTarget.values.identifier === this.identifier) {
 			const message = await getMessage();
 			if (message.visibility === "public" || message.visibility === "unlisted") await ctx.forwardActivity(this, "followers", {
 				skipIfUnsigned: true,
@@ -496,9 +508,9 @@ var BotImpl = class {
 	}
 	async onAnnounced(ctx, announce) {
 		if (this.onSharedMessage == null || announce.id == null || announce.actorId == null) return;
-		const objectUri = ctx.parseUri(announce.objectId);
+		const objectUri = parseLocalUri(ctx, announce.objectId, this.legacyObjectUrisIdentifier);
 		let object = null;
-		if (objectUri?.type === "object" && messageClasses.includes(objectUri.class)) {
+		if (objectUri?.type === "object" && messageClasses.includes(objectUri.class) && objectUri.values.identifier === this.identifier) {
 			const msg = await this.repository.getMessage(objectUri.values.id);
 			if (msg instanceof Create) object = await msg.getObject(ctx);
 		} else object = await announce.getObject(ctx);
@@ -518,9 +530,10 @@ var BotImpl = class {
 	}
 	async #parseLike(ctx, like) {
 		if (like.id == null || like.actorId == null) return void 0;
-		const objectUri = ctx.parseUri(like.objectId);
+		const objectUri = parseLocalUri(ctx, like.objectId, this.legacyObjectUrisIdentifier);
 		let object = null;
 		if (objectUri?.type === "object" && messageClasses.includes(objectUri.class)) {
+			if (objectUri.values.identifier !== this.identifier) return void 0;
 			const msg = await this.repository.getMessage(objectUri.values.id);
 			if (msg instanceof Create) object = await msg.getObject(ctx);
 		} else object = await like.getObject(ctx);
@@ -569,9 +582,10 @@ var BotImpl = class {
 			}
 		}
 		if (emoji == null) return void 0;
-		const objectUri = ctx.parseUri(react.objectId);
+		const objectUri = parseLocalUri(ctx, react.objectId, this.legacyObjectUrisIdentifier);
 		let object = null;
 		if (objectUri?.type === "object" && messageClasses.includes(objectUri.class)) {
+			if (objectUri.values.identifier !== this.identifier) return void 0;
 			const msg = await this.repository.getMessage(objectUri.values.id);
 			if (msg instanceof Create) object = await msg.getObject(ctx);
 		} else object = await react.getObject(ctx);
@@ -608,119 +622,327 @@ var BotImpl = class {
 		const { session, reaction } = sessionAndReaction;
 		await this.onUnreact(session, reaction);
 	}
-	dispatchNodeInfo(_ctx) {
-		return {
-			software: this.software,
-			protocols: ["activitypub"],
-			services: { outbound: ["atom1.0"] },
-			usage: {
-				users: {
-					total: 1,
-					activeMonth: 1,
-					activeHalfyear: 1
-				},
-				localPosts: 0,
-				localComments: 0
-			}
-		};
+	dispatchNodeInfo(ctx) {
+		return this.instance.dispatchNodeInfo(ctx);
 	}
 	getSession(origin, contextData) {
 		const ctx = typeof origin === "string" || origin instanceof URL ? this.federation.createContext(new URL(origin), contextData) : origin;
 		return new SessionImpl(this, ctx);
 	}
-	async addCollectionInverseProperty(request, contextData, response) {
-		if (!response.ok) return response;
-		const ctx = this.federation.createContext(request, contextData);
-		const parsed = ctx.parseUri(new URL(request.url));
-		if (parsed == null || parsed.type !== "outbox" && parsed.type !== "followers" || parsed.identifier == null) return response;
-		const contentType = response.headers.get("Content-Type");
-		if (contentType == null || !contentType.startsWith("application/activity+json") && !contentType.startsWith("application/ld+json")) return response;
-		const body = await response.json();
-		if (typeof body !== "object" || body == null || Array.isArray(body)) return new Response(JSON.stringify(body), {
-			headers: response.headers,
-			status: response.status,
-			statusText: response.statusText
-		});
-		const property = parsed.type === "outbox" ? "outboxOf" : "followersOf";
-		const actorUri = ctx.getActorUri(parsed.identifier).href;
-		if (body[property] === actorUri) return new Response(JSON.stringify(body), {
-			headers: response.headers,
-			status: response.status,
-			statusText: response.statusText
-		});
-		const headers = new Headers(response.headers);
-		headers.delete("Content-Length");
-		return new Response(JSON.stringify({
-			...body,
-			[property]: actorUri
-		}), {
-			headers,
-			status: response.status,
-			statusText: response.statusText
-		});
+	addCollectionInverseProperty(request, contextData, response) {
+		return this.instance.addCollectionInverseProperty(request, contextData, response);
 	}
-	async fetch(request, contextData) {
-		if (this.behindProxy) request = await getXForwardedRequest(request);
-		const url = new URL(request.url);
-		if (url.pathname.startsWith("/.well-known/") || url.pathname.startsWith("/ap/") || url.pathname.startsWith("/nodeinfo/")) {
-			const response = await this.federation.fetch(request, { contextData });
-			return await this.addCollectionInverseProperty(request, contextData, response);
-		}
-		const match = /^\/emojis\/([a-z0-9-_]+)(?:$|\.)/.exec(url.pathname);
-		if (match != null) {
-			const customEmoji = this.customEmojis[match[1]];
-			if (customEmoji == null || !("file" in customEmoji)) return new Response("Not Found", { status: 404 });
-			let file;
-			try {
-				file = await fs.open(customEmoji.file, "r");
-			} catch (error) {
-				if (typeof error === "object" && error != null && "code" in error && error.code === "ENOENT") return new Response("Not Found", { status: 404 });
-				throw error;
-			}
-			const fileInfo = await file.stat();
-			return new Response(file.readableWebStream(), { headers: {
-				"Content-Type": customEmoji.type,
-				"Content-Length": fileInfo.size.toString(),
-				"Cache-Control": "public, max-age=31536000, immutable",
-				"Last-Modified": (fileInfo.mtime ?? /* @__PURE__ */ new Date()).toUTCString(),
-				"ETag": `"${fileInfo.mtime?.getTime().toString(36)}${fileInfo.size.toString(36)}"`
-			} });
-		}
-		return await app.fetch(request, {
-			bot: this,
-			contextData
-		});
+	fetch(request, contextData) {
+		return this.instance.fetch(request, contextData);
 	}
 	getEmoji(ctx, name, data) {
-		let url;
-		if ("url" in data) url = new URL(data.url);
-		else {
-			const t = mimeDb[data.type];
-			url = new URL(`/emojis/${name}${t == null || t.extensions == null || t.extensions.length < 1 ? "" : `.${t.extensions[0]}`}`, ctx.origin);
-		}
-		return new Emoji({
-			id: ctx.getObjectUri(Emoji, { name }),
-			name: `:${name}:`,
-			icon: new Image({
-				mediaType: data.type,
-				url
-			})
-		});
+		return this.instance.getEmoji(ctx, name, data);
 	}
 	addCustomEmoji(name, data) {
-		if (!name.match(/^[a-z0-9-_]+$/i)) throw new TypeError(`Invalid custom emoji name: ${name}. It must match /^[a-z0-9-_]+$/i.`);
-		else if (name in this.customEmojis) throw new TypeError(`Duplicate custom emoji name: ${name}`);
-		else if (!data.type.startsWith("image/")) throw new TypeError(`Unsupported media type: ${data.type}`);
-		this.customEmojis[name] = data;
-		return (session) => this.getEmoji(session.context, name, data);
+		return this.instance.addCustomEmoji(name, data);
 	}
 	addCustomEmojis(emojis) {
-		const emojiMap = {};
-		for (const name in emojis) emojiMap[name] = this.addCustomEmoji(name, emojis[name]);
-		return emojiMap;
+		return this.instance.addCustomEmojis(emojis);
+	}
+};
+/**
+* Wraps a {@link BotImpl} instance with a plain object implementing
+* the {@link Bot} interface.  Since `deno serve` does not recognize a class
+* instance having fetch(), we wrap a BotImpl instance with a plain object.
+* See also https://github.com/denoland/deno/issues/24062
+* @param bot The bot implementation to wrap.
+* @returns The wrapped bot.
+* @internal
+*/
+function wrapBotImpl(bot) {
+	const wrapper = {
+		impl: bot,
+		get federation() {
+			return bot.federation;
+		},
+		get identifier() {
+			return bot.identifier;
+		},
+		getSession(a, b) {
+			return bot.getSession(a, b);
+		},
+		fetch(request, contextData) {
+			return bot.fetch(request, contextData);
+		},
+		addCustomEmojis(emojis) {
+			return bot.addCustomEmojis(emojis);
+		},
+		get onFollow() {
+			return bot.onFollow;
+		},
+		set onFollow(value) {
+			bot.onFollow = value;
+		},
+		get onUnfollow() {
+			return bot.onUnfollow;
+		},
+		set onUnfollow(value) {
+			bot.onUnfollow = value;
+		},
+		get onAcceptFollow() {
+			return bot.onAcceptFollow;
+		},
+		set onAcceptFollow(value) {
+			bot.onAcceptFollow = value;
+		},
+		get onRejectFollow() {
+			return bot.onRejectFollow;
+		},
+		set onRejectFollow(value) {
+			bot.onRejectFollow = value;
+		},
+		get onMention() {
+			return bot.onMention;
+		},
+		set onMention(value) {
+			bot.onMention = value;
+		},
+		get onReply() {
+			return bot.onReply;
+		},
+		set onReply(value) {
+			bot.onReply = value;
+		},
+		get onQuote() {
+			return bot.onQuote;
+		},
+		set onQuote(value) {
+			bot.onQuote = value;
+		},
+		get onMessage() {
+			return bot.onMessage;
+		},
+		set onMessage(value) {
+			bot.onMessage = value;
+		},
+		get onSharedMessage() {
+			return bot.onSharedMessage;
+		},
+		set onSharedMessage(value) {
+			bot.onSharedMessage = value;
+		},
+		get onLike() {
+			return bot.onLike;
+		},
+		set onLike(value) {
+			bot.onLike = value;
+		},
+		get onUnlike() {
+			return bot.onUnlike;
+		},
+		set onUnlike(value) {
+			bot.onUnlike = value;
+		},
+		get onReact() {
+			return bot.onReact;
+		},
+		set onReact(value) {
+			bot.onReact = value;
+		},
+		get onUnreact() {
+			return bot.onUnreact;
+		},
+		set onUnreact(value) {
+			bot.onUnreact = value;
+		},
+		get onVote() {
+			return bot.onVote;
+		},
+		set onVote(value) {
+			bot.onVote = value;
+		}
+	};
+	return wrapper;
+}
+/**
+* A repository decorator that adopts legacy (pre-0.5) data for a bot actor
+* before the first repository operation.  The migration is kicked off at
+* construction time and every operation awaits its completion, so data
+* stored by BotKit 0.4 or earlier is visible from the start.
+* @internal
+*/
+var MigrationGatedRepository = class {
+	#repository;
+	#migration;
+	constructor(repository, identifier) {
+		this.#repository = repository;
+		this.#migration = repository.migrate?.(identifier) ?? Promise.resolve();
+		this.#migration.catch(() => {});
+	}
+	async setKeyPairs(identifier, keyPairs) {
+		await this.#migration;
+		return await this.#repository.setKeyPairs(identifier, keyPairs);
+	}
+	async getKeyPairs(identifier) {
+		await this.#migration;
+		return await this.#repository.getKeyPairs(identifier);
+	}
+	async addMessage(identifier, id, activity) {
+		await this.#migration;
+		return await this.#repository.addMessage(identifier, id, activity);
+	}
+	async updateMessage(identifier, id, updater) {
+		await this.#migration;
+		return await this.#repository.updateMessage(identifier, id, updater);
+	}
+	async removeMessage(identifier, id) {
+		await this.#migration;
+		return await this.#repository.removeMessage(identifier, id);
+	}
+	async *getMessages(identifier, options) {
+		await this.#migration;
+		yield* this.#repository.getMessages(identifier, options);
+	}
+	async getMessage(identifier, id) {
+		await this.#migration;
+		return await this.#repository.getMessage(identifier, id);
+	}
+	async countMessages(identifier) {
+		await this.#migration;
+		return await this.#repository.countMessages(identifier);
+	}
+	async addFollower(identifier, followId, follower) {
+		await this.#migration;
+		return await this.#repository.addFollower(identifier, followId, follower);
+	}
+	async removeFollower(identifier, followId, followerId) {
+		await this.#migration;
+		return await this.#repository.removeFollower(identifier, followId, followerId);
+	}
+	async hasFollower(identifier, followerId) {
+		await this.#migration;
+		return await this.#repository.hasFollower(identifier, followerId);
+	}
+	async *getFollowers(identifier, options) {
+		await this.#migration;
+		yield* this.#repository.getFollowers(identifier, options);
+	}
+	async countFollowers(identifier) {
+		await this.#migration;
+		return await this.#repository.countFollowers(identifier);
+	}
+	async addSentFollow(identifier, id, follow) {
+		await this.#migration;
+		return await this.#repository.addSentFollow(identifier, id, follow);
+	}
+	async removeSentFollow(identifier, id) {
+		await this.#migration;
+		return await this.#repository.removeSentFollow(identifier, id);
+	}
+	async getSentFollow(identifier, id) {
+		await this.#migration;
+		return await this.#repository.getSentFollow(identifier, id);
+	}
+	async addFollowee(identifier, followeeId, follow) {
+		await this.#migration;
+		return await this.#repository.addFollowee(identifier, followeeId, follow);
+	}
+	async removeFollowee(identifier, followeeId) {
+		await this.#migration;
+		return await this.#repository.removeFollowee(identifier, followeeId);
+	}
+	async getFollowee(identifier, followeeId) {
+		await this.#migration;
+		return await this.#repository.getFollowee(identifier, followeeId);
+	}
+	async *findFollowedBots(followeeId) {
+		await this.#migration;
+		yield* this.#repository.findFollowedBots(followeeId);
+	}
+	async vote(identifier, messageId, voterId, option) {
+		await this.#migration;
+		return await this.#repository.vote(identifier, messageId, voterId, option);
+	}
+	async countVoters(identifier, messageId) {
+		await this.#migration;
+		return await this.#repository.countVoters(identifier, messageId);
+	}
+	async countVotes(identifier, messageId) {
+		await this.#migration;
+		return await this.#repository.countVotes(identifier, messageId);
+	}
+	forIdentifier(identifier) {
+		return new ActorScopedRepository(this, identifier);
+	}
+	async migrate(identifier) {
+		await this.#migration;
+		await this.#repository.migrate?.(identifier);
+	}
+};
+/**
+* The internal implementation of a {@link BotGroup}: a registry of event
+* handlers shared by every bot its dispatcher resolves.
+* @internal
+*/
+var BotGroupImpl = class {
+	instance;
+	dispatcher;
+	mapUsername;
+	onFollow;
+	onUnfollow;
+	onAcceptFollow;
+	onRejectFollow;
+	onMention;
+	onReply;
+	onQuote;
+	onMessage;
+	onSharedMessage;
+	onLike;
+	onUnlike;
+	onReact;
+	onUnreact;
+	onVote;
+	constructor(instance, dispatcher, options = {}) {
+		this.instance = instance;
+		this.dispatcher = dispatcher;
+		this.mapUsername = options.mapUsername;
+	}
+	async getSession(origin, identifier, contextData) {
+		const ctx = this.instance.federation.createContext(new URL(origin), contextData);
+		const bot = await this.instance.resolveBot(ctx, identifier);
+		if (bot == null || !(bot instanceof GroupBotImpl) || bot.group !== this) throw new TypeError(`The group's dispatcher does not resolve the identifier: ${identifier}`);
+		return bot.getSession(ctx);
+	}
+};
+/**
+* A transient per-bot view of a dynamically resolved bot.  It behaves like
+* a regular {@link BotImpl}, except that its event handlers are read live
+* from the owning {@link BotGroupImpl} at dispatch time, so handlers
+* registered on the group after a bot was resolved still fire.  Views are
+* not registered on the instance and live only as long as the resolution
+* cache of the request that produced them.
+* @internal
+*/
+var GroupBotImpl = class extends BotImpl {
+	group;
+	constructor(group, identifier, profile) {
+		super({
+			instance: group.instance,
+			transient: true,
+			identifier,
+			kv: group.instance.kv,
+			class: profile.class,
+			username: profile.username,
+			name: profile.name,
+			summary: profile.summary,
+			icon: profile.icon,
+			image: profile.image,
+			properties: profile.properties,
+			followerPolicy: profile.followerPolicy
+		});
+		this.group = group;
+		for (const name of botEventHandlerNames) globalThis.Object.defineProperty(this, name, {
+			get: () => group[name],
+			configurable: true
+		});
 	}
 };
 
 //#endregion
-export { BotImpl };
+export { BotGroupImpl, BotImpl, GroupBotImpl, MigrationGatedRepository, botEventHandlerNames, wrapBotImpl };
 //# sourceMappingURL=bot-impl.js.map