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

package/dist/bot.d.ts

@@ -10,55 +10,14 @@ import { Application, Application as Application$1, Image, Image as Image$1, Ser
 import { Software, Software as Software$1 } from "@fedify/fedify/nodeinfo";
 
 //#region src/bot.d.ts
+
 /**
- * A bot that can interact with the ActivityPub network.
+ * The event handlers a bot can register.  Assigning a handler to one of
+ * these properties makes the bot react to the corresponding ActivityPub
+ * activity.
+ * @since 0.5.0
  */
-interface Bot<TContextData> {
-  /**
-   * An internal Fedify federation instance.  Normally you don't need to access
-   * this directly.
-   */
-  readonly federation: Federation<TContextData>;
-  /**
-   * The internal identifier for the bot actor.  It is used for the actor URI.
-   */
-  readonly identifier: string;
-  /**
-   * Gets a new session to control the bot for a specific origin and context
-   * data.
-   * @param origin The origin of the session.  Even if a URL with some path or
-   *               query is passed, only the origin part will be used.
-   * @param contextData The context data to pass to the federation.
-   * @returns The session for the origin and context data.
-   */
-  getSession(origin: string | URL, contextData: TContextData): Session<TContextData>;
-  /**
-   * Gets a new session to control bot for a specific Fedify context.
-   * @param context The Fedify context of the session.
-   * @returns The session for the Fedify context.
-   */
-  getSession(context: Context<TContextData>): Session<TContextData>;
-  /**
-   * The fetch API for handling HTTP requests.  You can pass this to an HTTP
-   * server (e.g., `Deno.serve()`, `Bun.serve()`) to handle incoming requests.
-   * @param request The request to handle.
-   * @param contextData The context data to pass to the federation.
-   * @returns The response to the request.
-   */
-  fetch(request: Request, contextData: TContextData): Promise<Response>;
-  /**
-   * Defines custom emojis for the bot.  The custom emojis are used for
-   * rendering the bot's profile and posts.  The custom emojis are defined
-   * by their names, and the names are used as the keys of the emojis.
-   * @param emojis The custom emojis to define.  The keys are the names of
-   *               the emojis, and the values are the custom emoji definitions.
-   * @returns The defined emojis.  The keys are the names of the emojis, and
-   *          the values are the emoji objects, which are used for passing
-   *          to the {@link customEmoji} function.
-   * @throws {TypeError} If any emoji name is invalid or duplicate.
-   * @since 0.2.0
-   */
-  addCustomEmojis<TEmojiName extends string>(emojis: Readonly<Record<TEmojiName, CustomEmoji>>): Readonly<Record<TEmojiName, DeferredCustomEmoji<TContextData>>>;
+interface BotEventHandlers<TContextData> {
   /**
    * An event handler for a follow request to the bot.
    */
@@ -131,6 +90,93 @@ interface Bot<TContextData> {
    */
   onVote?: VoteEventHandler<TContextData>;
 }
+/**
+ * A read-only view of a bot actor's identity and profile.  It is exposed
+ * through {@link Session.bot} so that event handlers can tell which bot they
+ * are running as without being able to mutate the bot (e.g. reassign its
+ * event handlers).
+ * @since 0.5.0
+ */
+interface ReadonlyBot {
+  /**
+   * The internal identifier for the bot actor.  It is used for the actor URI.
+   */
+  readonly identifier: string;
+  /**
+   * The username of the bot.  It is a part of the fediverse handle.
+   */
+  readonly username: string;
+  /**
+   * The display name of the bot.
+   */
+  readonly name?: string;
+  /**
+   * The type of the bot actor.  It is either `Service` or `Application`.
+   */
+  readonly class: typeof Service$1 | typeof Application$1;
+  /**
+   * The avatar URL of the bot.
+   */
+  readonly icon?: URL | Image$1;
+  /**
+   * The header image URL of the bot.
+   */
+  readonly image?: URL | Image$1;
+  /**
+   * How the bot handles incoming follow requests.
+   */
+  readonly followerPolicy: "accept" | "reject" | "manual";
+}
+/**
+ * A bot that can interact with the ActivityPub network.
+ */
+interface Bot<TContextData> extends BotEventHandlers<TContextData> {
+  /**
+   * An internal Fedify federation instance.  Normally you don't need to access
+   * this directly.
+   */
+  readonly federation: Federation<TContextData>;
+  /**
+   * The internal identifier for the bot actor.  It is used for the actor URI.
+   */
+  readonly identifier: string;
+  /**
+   * Gets a new session to control the bot for a specific origin and context
+   * data.
+   * @param origin The origin of the session.  Even if a URL with some path or
+   *               query is passed, only the origin part will be used.
+   * @param contextData The context data to pass to the federation.
+   * @returns The session for the origin and context data.
+   */
+  getSession(origin: string | URL, contextData: TContextData): Session<TContextData>;
+  /**
+   * Gets a new session to control bot for a specific Fedify context.
+   * @param context The Fedify context of the session.
+   * @returns The session for the Fedify context.
+   */
+  getSession(context: Context<TContextData>): Session<TContextData>;
+  /**
+   * The fetch API for handling HTTP requests.  You can pass this to an HTTP
+   * server (e.g., `Deno.serve()`, `Bun.serve()`) to handle incoming requests.
+   * @param request The request to handle.
+   * @param contextData The context data to pass to the federation.
+   * @returns The response to the request.
+   */
+  fetch(request: Request, contextData: TContextData): Promise<Response>;
+  /**
+   * Defines custom emojis for the bot.  The custom emojis are used for
+   * rendering the bot's profile and posts.  The custom emojis are defined
+   * by their names, and the names are used as the keys of the emojis.
+   * @param emojis The custom emojis to define.  The keys are the names of
+   *               the emojis, and the values are the custom emoji definitions.
+   * @returns The defined emojis.  The keys are the names of the emojis, and
+   *          the values are the emoji objects, which are used for passing
+   *          to the {@link customEmoji} function.
+   * @throws {TypeError} If any emoji name is invalid or duplicate.
+   * @since 0.2.0
+   */
+  addCustomEmojis<TEmojiName extends string>(emojis: Readonly<Record<TEmojiName, CustomEmoji>>): Readonly<Record<TEmojiName, DeferredCustomEmoji<TContextData>>>;
+}
 /**
  * A specialized {@link Bot} tpe that doesn't require context data.
  */
@@ -280,5 +326,5 @@ interface PagesOptions {
 declare function createBot<TContextData = void>(options: CreateBotOptions<TContextData>): TContextData extends void ? BotWithVoidContextData : Bot<TContextData>;
 //# sourceMappingURL=bot.d.ts.map
 //#endregion
-export { Application, Bot, BotWithVoidContextData, CreateBotOptions, Image, PagesOptions, Service, Software, createBot };
+export { Application, Bot, BotEventHandlers, BotWithVoidContextData, CreateBotOptions, Image, PagesOptions, ReadonlyBot, Service, Software, createBot };
 //# sourceMappingURL=bot.d.ts.map

package/dist/bot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","names":[],"sources":["../src/bot.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;UAkDiB;EAAA;;;;EAKgB,SAgBZ,UAAA,EAhBE,UAgBF,CAhBa,YAgBb,CAAA;EAAG;;;EAEZ,SAOkB,UAAA,EAAA,MAAA;EAAY;;;;;;;;EAwBJ,UAAE,CAAA,MAAA,EAAA,MAAA,GAjCnB,GAiCmB,EAAA,WAAA,EAhCvB,YAgCuB,CAAA,EA/BnC,OA+BmC,CA/B3B,YA+B2B,CAAA;EAAW;;;;;EACC,UAAtC,CAAA,OAAA,EAzBQ,OAyBR,CAzBgB,YAyBhB,CAAA,CAAA,EAzBgC,OAyBhC,CAzBwC,YAyBxC,CAAA;EAAM;;;;;;;EAeiB,KAKC,CAAA,OAAA,EApCrB,OAoCqB,EAAA,WAAA,EApCC,YAoCD,CAAA,EApCgB,OAoChB,CApCwB,QAoCxB,CAAA;EAAY;;;;;;;;;;;;EAiCV,eAA7B,CAAA,mBAAA,MAAA,CAAA,CAAA,MAAA,EAtDC,QAsDD,CAtDU,MAsDV,CAtDiB,UAsDjB,EAtD6B,WAsD7B,CAAA,CAAA,CAAA,EArDN,QAqDM,CArDG,MAqDH,CArDU,UAqDV,EArDsB,mBAqDtB,CArD0C,YAqD1C,CAAA,CAAA,CAAA;EAAgB;;;EAWkB,QAAjC,CAAA,EA3DC,kBA2DD,CA3DoB,YA2DpB,CAAA;EAAoB;;;EAqBQ,UAA7B,CAAA,EA3EI,oBA2EJ,CA3EyB,YA2EzB,CAAA;EAAgB;AAM3B;;EAAwC,cAUnB,CAAA,EAtFF,kBAsFE,CAtFiB,YAsFjB,CAAA;EAAG;;;EASqB,cAQf,CAAA,EAlGX,kBAkGW,CAlGQ,YAkGR,CAAA;EAAG;;;EAQU,SAAhB,CAAA,EArGb,mBAqGa,CArGO,YAqGP,CAAA;EAAO;AAnCiB;AAyCnD;EAAiC,OAAA,CAAA,EAtGrB,iBAsGqB,CAtGH,YAsGG,CAAA;EAAA;;;;EAgCR,OAKP,CAAA,EArIN,iBAqIM,CArIY,YAqIZ,CAAA;EAAG;;;;EAYuD,SAArC,CAAA,EA3IzB,mBA2IyB,CA3IL,YA2IK,CAAA;EAAI;;;;EA8BZ,eAMT,CAAA,EAzKF,yBAyKE,CAzKwB,YAyKxB,CAAA;EAAQ;AAeC;AAM/B;EAwCgB,MAAA,CAAA,EAjOL,gBAiOc,CAjOG,YAiOH,CAAA;EAAA;;;EACE,QACxB,CAAA,EA9NU,kBA8NV,CA9N6B,YA8N7B,CAAA;EAAY;;;AAA4C;YAxN/C,qBAAqB;;;;;cAMnB,2BAA2B;;;;;;;;;;;;;;WAe9B,iBAAiB;;;;;UAMX,sBAAA,SAA+B;;;;;;;;;8BAU3B,yBAEhB;;;;;;sBAOiB,gBAAgB;;;;;;;8BAQR,MAAM;;;;;;;iBAQnB,UAAU,QAAQ;;;;;UAMlB;;;;;;;;;;;;;;;0BAgBS,mBAAiB;;;;;;;;;;;;;qBAgBtB,cAAc;;;;kBAKjB,MAAM;;;;;mBAML,MAAM;;;;;wBAMD,eAAe,yBAAyB;;;;;;;;;;;;;;;eAiBjD;;;;;wBAMS;;;;;;mBAOL;;;;;sBAMG;;;;;;;;;;;;;mBAeH;;;;;UAMF,YAAA;;;;;;;;;;;;;;;;;;iBAwCD,wCACL,iBAAiB,gBACzB,4BAA4B,yBAAyB,IAAI"}
+{"version":3,"file":"bot.d.ts","names":[],"sources":["../src/bot.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AAqDA;;AAIgC,UAJf,gBAIe,CAAA,YAAA,CAAA,CAAA;EAAY;;;EAKT,QAKG,CAAA,EAVzB,kBAUyB,CAVN,YAUM,CAAA;EAAY;;;EAKb,UAKH,CAAA,EAfnB,oBAemB,CAfE,YAeF,CAAA;EAAY;;;EAKjB,cAMC,CAAA,EArBX,kBAqBW,CArBQ,YAqBR,CAAA;EAAY;;;EAMT,cAMa,CAAA,EA5B3B,kBA4B2B,CA5BR,YA4BQ,CAAA;EAAY;;;EAK/B,SAKK,CAAA,EAjClB,mBAiCkB,CAjCE,YAiCF,CAAA;EAAY;;;EAMZ,OAMS,CAAA,EAxC7B,iBAwC6B,CAxCX,YAwCW,CAAA;EAAY;;;AAe1B;EAUV,OAAA,CAAA,EA3DL,iBA2DgB,CA3DE,YA2DF,CAAA;EAAA;;;;EAwBP,SAAG,CAAA,EA7EV,mBA6EU,CA7EU,YA6EV,CAAA;EAAK;;AAKC;AAW9B;EAAoB,eAAA,CAAA,EAvFA,yBAuFA,CAvF0B,YAuF1B,CAAA;EAAA;;;EAKa,MAgBZ,CAAA,EAvGV,gBAuGU,CAvGO,YAuGP,CAAA;EAAG;;;EAEZ,QAOkB,CAAA,EA3GjB,kBA2GiB,CA3GE,YA2GF,CAAA;EAAY;;;;EASlB,OAAe,CAAA,EA9G3B,oBA8G2B,CA9GN,YA8GM,CAAA;EAAY;;;;EAeA,SAA9B,CAAA,EAvHP,0BAuHO,CAvHoB,YAuHpB,CAAA;EAAM;;;;;;;AAtDgC;AA6D3D;;;;;EAmB6B,MAAS,CAAA,EAlI3B,gBAkI2B,CAlIV,YAkIU,CAAA;;;;;;;AAnBa;AAyCnD;AAAiC,UA9IhB,WAAA,CA8IgB;EAAA;;;EAgCc,SAA1B,UAAA,EAAA,MAAA;EAAI;;;EAWH,SAAG,QAAA,EAAA,MAAA;EAAK;;;EAMA,SAiBf,IAAA,CAAA,EAAA,MAAA;EAAO;;;EAmBQ,SAeX,KAAA,EAAA,OA/NM,SA+NN,GAAA,OA/NuB,aA+NvB;EAAY;AAM/B;AAwCA;EAAyB,SAAA,IAAA,CAAA,EAxQP,GAwQO,GAxQD,OAwQC;EAAA;;;EAEV,SAAgB,KAAA,CAAA,EArQZ,GAqQY,GArQN,OAqQM;EAAsB;;AAAM;;;;;;UA1P1C,0BAA0B,iBAAiB;;;;;uBAKrC,WAAW;;;;;;;;;;;;;8BAgBb,kBACJ,eACZ,QAAQ;;;;;;sBAOS,QAAQ,gBAAgB,QAAQ;;;;;;;;iBASrC,sBAAsB,eAAe,QAAQ;;;;;;;;;;;;;qDAelD,SAAS,OAAO,YAAY,gBACnC,SAAS,OAAO,YAAY,oBAAoB;;;;;UAMpC,sBAAA,SAA+B;;;;;;;;;8BAU3B,yBAEhB;;;;;;sBAOiB,gBAAgB;;;;;;;8BAQR,MAAM;;;;;;;iBAQnB,UAAU,QAAQ;;;;;UAMlB;;;;;;;;;;;;;;;0BAgBS,mBAAiB;;;;;;;;;;;;;qBAgBtB,cAAc;;;;kBAKjB,MAAM;;;;;mBAML,MAAM;;;;;wBAMD,eAAe,yBAAyB;;;;;;;;;;;;;;;eAiBjD;;;;;wBAMS;;;;;;mBAOL;;;;;sBAMG;;;;;;;;;;;;;mBAeH;;;;;UAMF,YAAA;;;;;;;;;;;;;;;;;;iBAwCD,wCACL,iBAAiB,gBACzB,4BAA4B,yBAAyB,IAAI"}

package/dist/bot.js

@@ -2,7 +2,7 @@
       import { Temporal, toTemporalInstant } from "@js-temporal/polyfill";
       Date.prototype.toTemporalInstant = toTemporalInstant;
     
-import { BotImpl } from "./bot-impl.js";
+import { BotImpl, wrapBotImpl } from "./bot-impl.js";
 import { Application, Image, Service } from "@fedify/vocab";
 
 //#region src/bot.ts
@@ -13,109 +13,7 @@ import { Application, Image, Service } from "@fedify/vocab";
 */
 function createBot(options) {
 	const bot = new BotImpl(options);
-	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;
+	return wrapBotImpl(bot);
 }
 
 //#endregion

package/dist/bot.js.map

@@ -1 +1 @@
-{"version":3,"file":"bot.js","names":["options: CreateBotOptions<TContextData>","b?","emojis: Readonly<Record<TEmojiName, CustomEmoji>>"],"sources":["../src/bot.ts"],"sourcesContent":["// BotKit by Fedify: A framework for creating ActivityPub bots\n// Copyright (C) 2025–2026 Hong Minhee <https://hongminhee.org/>\n//\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU Affero General Public License as\n// published by the Free Software Foundation, either version 3 of the\n// License, or (at your option) any later version.\n//\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n// GNU Affero General Public License for more details.\n//\n// You should have received a copy of the GNU Affero General Public License\n// along with this program.  If not, see <https://www.gnu.org/licenses/>.\nimport type {\n  Context,\n  Federation,\n  KvStore,\n  MessageQueue,\n} from \"@fedify/fedify/federation\";\nimport type { Software } from \"@fedify/fedify/nodeinfo\";\nimport type { Application, Image, Service } from \"@fedify/vocab\";\nimport { BotImpl } from \"./bot-impl.ts\";\nimport type { CustomEmoji, DeferredCustomEmoji } from \"./emoji.ts\";\nimport type {\n  AcceptEventHandler,\n  FollowEventHandler,\n  LikeEventHandler,\n  MentionEventHandler,\n  MessageEventHandler,\n  QuoteEventHandler,\n  ReactionEventHandler,\n  RejectEventHandler,\n  ReplyEventHandler,\n  SharedMessageEventHandler,\n  UndoneReactionEventHandler,\n  UnfollowEventHandler,\n  UnlikeEventHandler,\n  VoteEventHandler,\n} from \"./events.ts\";\nimport type { Repository } from \"./repository.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { Text } from \"./text.ts\";\nexport { type Software } from \"@fedify/fedify/nodeinfo\";\nexport { Application, Image, Service } from \"@fedify/vocab\";\n\n/**\n * A bot that can interact with the ActivityPub network.\n */\nexport interface Bot<TContextData> {\n  /**\n   * An internal Fedify federation instance.  Normally you don't need to access\n   * this directly.\n   */\n  readonly federation: Federation<TContextData>;\n\n  /**\n   * The internal identifier for the bot actor.  It is used for the actor URI.\n   */\n  readonly identifier: string;\n\n  /**\n   * Gets a new session to control the bot for a specific origin and context\n   * data.\n   * @param origin The origin of the session.  Even if a URL with some path or\n   *               query is passed, only the origin part will be used.\n   * @param contextData The context data to pass to the federation.\n   * @returns The session for the origin and context data.\n   */\n  getSession(\n    origin: string | URL,\n    contextData: TContextData,\n  ): Session<TContextData>;\n\n  /**\n   * Gets a new session to control bot for a specific Fedify context.\n   * @param context The Fedify context of the session.\n   * @returns The session for the Fedify context.\n   */\n  getSession(context: Context<TContextData>): Session<TContextData>;\n\n  /**\n   * The fetch API for handling HTTP requests.  You can pass this to an HTTP\n   * server (e.g., `Deno.serve()`, `Bun.serve()`) to handle incoming requests.\n   * @param request The request to handle.\n   * @param contextData The context data to pass to the federation.\n   * @returns The response to the request.\n   */\n  fetch(request: Request, contextData: TContextData): Promise<Response>;\n\n  /**\n   * Defines custom emojis for the bot.  The custom emojis are used for\n   * rendering the bot's profile and posts.  The custom emojis are defined\n   * by their names, and the names are used as the keys of the emojis.\n   * @param emojis The custom emojis to define.  The keys are the names of\n   *               the emojis, and the values are the custom emoji definitions.\n   * @returns The defined emojis.  The keys are the names of the emojis, and\n   *          the values are the emoji objects, which are used for passing\n   *          to the {@link customEmoji} function.\n   * @throws {TypeError} If any emoji name is invalid or duplicate.\n   * @since 0.2.0\n   */\n  addCustomEmojis<TEmojiName extends string>(\n    emojis: Readonly<Record<TEmojiName, CustomEmoji>>,\n  ): Readonly<Record<TEmojiName, DeferredCustomEmoji<TContextData>>>;\n\n  /**\n   * An event handler for a follow request to the bot.\n   */\n  onFollow?: FollowEventHandler<TContextData>;\n\n  /**\n   * An event handler for an unfollow event from the bot.\n   */\n  onUnfollow?: UnfollowEventHandler<TContextData>;\n\n  /**\n   * An event handler invoked when a follow request the bot sent is accepted.\n   */\n  onAcceptFollow?: AcceptEventHandler<TContextData>;\n\n  /**\n   * An event handler invoked when a follow request the bot sent is rejected.\n   */\n  onRejectFollow?: RejectEventHandler<TContextData>;\n\n  /**\n   * An event handler for a message mentioned to the bot.\n   */\n  onMention?: MentionEventHandler<TContextData>;\n\n  /**\n   * An event handler for a reply to the bot.\n   */\n  onReply?: ReplyEventHandler<TContextData>;\n\n  /**\n   * An event handler for a quote of the bot's message.\n   * @since 0.2.0\n   */\n  onQuote?: QuoteEventHandler<TContextData>;\n\n  /**\n   * An event handler for a message shown to the bot's timeline.  To listen\n   * to this event, your bot needs to follow others first.\n   */\n  onMessage?: MessageEventHandler<TContextData>;\n\n  /**\n   * An event handler for a message shared to the bot.  To listen to this event,\n   * your bot needs to follow others first.\n   */\n  onSharedMessage?: SharedMessageEventHandler<TContextData>;\n\n  /**\n   * An event handler for a like of a message.\n   */\n  onLike?: LikeEventHandler<TContextData>;\n\n  /**\n   * An event handler for an undoing of a like of a message.\n   */\n  onUnlike?: UnlikeEventHandler<TContextData>;\n\n  /**\n   * An event handler for an emoji reaction to a message.\n   * @since 0.2.0\n   */\n  onReact?: ReactionEventHandler<TContextData>;\n\n  /**\n   * An event handler for an undoing of an emoji reaction to a message.\n   * @since 0.2.0\n   */\n  onUnreact?: UndoneReactionEventHandler<TContextData>;\n\n  /**\n   * An event handler for a vote in a poll.  This event is only triggered when\n   * the bot is the author of the poll, and the vote is made by another actor.\n   * If the poll allows multiple selections, this event is triggered multiple\n   * times, once for each option selected by the actor.\n   *\n   * Note that this event can be triggered even if the voter vote an option\n   * multiple times or multiple options for a poll that disallows multiple\n   * selections.  You should validate the vote in the event handler by storing\n   * the votes in a persistent store, and checking if the vote is valid.\n   * (This behavior can subject to change in the future.)\n   * @since 0.3.0\n   */\n  onVote?: VoteEventHandler<TContextData>;\n}\n\n/**\n * A specialized {@link Bot} tpe that doesn't require context data.\n */\nexport interface BotWithVoidContextData extends Bot<void> {\n  /**\n   * Gets a new session to control the bot for a specific origin and context\n   * data.\n   * @param origin The origin of the session.  Even if a URL with some path or\n   *               query is passed, only the origin part will be used.\n   * @param contextData The context data to pass to the federation.\n   * @returns The session for the origin and context data.\n   */\n  getSession(\n    origin: string | URL,\n    contextData: void,\n  ): Session<void>;\n\n  /**\n   * Gets a new session to control bot for a specific Fedify context.\n   * @param context The Fedify context of the session.\n   * @returns The session for the Fedify context.\n   */\n  getSession(context: Context<void>): Session<void>;\n\n  /**\n   * Gets a new session to control the bot for a specific origin and context\n   * data.\n   * @param origin The origin of the session.  Even if a URL with some path or\n   *               query is passed, only the origin part will be used.\n   */\n  getSession(origin: string | URL): Session<void>;\n\n  /**\n   * The fetch API for handling HTTP requests.  You can pass this to an HTTP\n   * server (e.g., `Deno.serve()`, `Bun.serve()`) to handle incoming requests.\n   * @param request The request to handle.\n   * @returns The response to the request.\n   */\n  fetch(request: Request): Promise<Response>;\n}\n\n/**\n * Options for creating a bot.\n */\nexport interface CreateBotOptions<TContextData> {\n  /**\n   * The internal identifier of the bot.  Since it is used for the actor URI,\n   * it *should not* be changed after the bot is federated.\n   *\n   * If omitted, `\"bot\"` will be used.\n   * @default `\"bot\"`\n   */\n  readonly identifier?: string;\n\n  /**\n   * The type of the bot actor.  It should be either `Service` or `Application`.\n   *\n   * If omitted, `Service` will be used.\n   * @default `Service`\n   */\n  readonly class?: typeof Service | typeof Application;\n\n  /**\n   * The username of the bot.  It will be a part of the fediverse handle.\n   * It can be changed after the bot is federated.\n   */\n  readonly username: string;\n\n  /**\n   * The display name of the bot.  It can be changed after the bot is federated.\n   */\n  readonly name?: string;\n\n  /**\n   * The description of the bot.  It can be changed after the bot is federated.\n   */\n  readonly summary?: Text<\"block\", TContextData>;\n\n  /**\n   * The avatar URL of the bot.  It can be changed after the bot is federated.\n   */\n  readonly icon?: URL | Image;\n\n  /**\n   * The header image URL of the bot.  It can be changed after the bot is\n   * federated.\n   */\n  readonly image?: URL | Image;\n\n  /**\n   * The custom properties of the bot.  It can be changed after the bot is\n   * federated.\n   */\n  readonly properties?: Record<string, Text<\"block\" | \"inline\", TContextData>>;\n\n  /**\n   * How to handle incoming follow requests.  Note that this behavior can be\n   * overridden by manually invoking {@link FollowRequest.accept} or\n   * {@link FollowRequest.reject} in the {@link Bot.onFollow} event handler.\n   *\n   * - `\"accept\"` (default): Automatically accept all incoming follow requests.\n   * - `\"reject\"`: Automatically reject all incoming follow requests.\n   * - `\"manual\"`: Require manual handling of incoming follow requests.\n   * @default `\"accept\"`\n   */\n  readonly followerPolicy?: \"accept\" | \"reject\" | \"manual\";\n\n  /**\n   * The underlying key-value store to use for storing data.\n   */\n  readonly kv: KvStore;\n\n  /**\n   * The underlying repository to use for storing data.  If omitted,\n   * {@link KvRepository} will be used.\n   */\n  readonly repository?: Repository;\n\n  /**\n   * The underlying message queue to use for handling incoming and outgoing\n   * activities.  If omitted, incoming activities are processed immediately,\n   * and outgoing activities are sent immediately.\n   */\n  readonly queue?: MessageQueue;\n\n  /**\n   * The software information of the bot.  If omitted, the NodeInfo protocol\n   * will be unimplemented.\n   */\n  readonly software?: Software;\n\n  /**\n   * Whether to trust `X-Forwarded-*` headers.  If your bot application is\n   * behind an L7 reverse proxy, turn it on.\n   *\n   * Turned off by default.\n   * @default `false`\n   */\n  readonly behindProxy?: boolean;\n\n  /**\n   * The options for the web pages of the bot.  If omitted, the default options\n   * will be used.\n   */\n  readonly pages?: PagesOptions;\n}\n\n/**\n * Options for the web pages of the bot.\n */\nexport interface PagesOptions {\n  /**\n   * The color of the theme.  It will be used for the theme color of the web\n   * pages.  The default color is `\"green\"`.\n   * @default `\"green\"`\n   */\n  readonly color?:\n    | \"amber\"\n    | \"azure\"\n    | \"blue\"\n    | \"cyan\"\n    | \"fuchsia\"\n    | \"green\"\n    | \"grey\"\n    | \"indigo\"\n    | \"jade\"\n    | \"lime\"\n    | \"orange\"\n    | \"pink\"\n    | \"pumpkin\"\n    | \"purple\"\n    | \"red\"\n    | \"sand\"\n    | \"slate\"\n    | \"violet\"\n    | \"yellow\"\n    | \"zinc\";\n\n  /**\n   * The CSS code for the bot.  It will be used for the custom CSS of the web\n   * pages.\n   */\n  readonly css?: string;\n}\n\n/**\n * Creates a {@link Bot} instance.\n * @param options The options for creating the bot.\n * @returns The created bot instance.\n */\nexport function createBot<TContextData = void>(\n  options: CreateBotOptions<TContextData>,\n): TContextData extends void ? BotWithVoidContextData : Bot<TContextData> {\n  const bot = new BotImpl<TContextData>(options);\n  // Since `deno serve` does not recognize a class instance having fetch(),\n  // we wrap a BotImpl instance with a plain object.\n  // See also https://github.com/denoland/deno/issues/24062\n  const wrapper = {\n    impl: bot,\n    get federation() {\n      return bot.federation;\n    },\n    get identifier() {\n      return bot.identifier;\n    },\n    getSession(a, b?) {\n      // @ts-ignore: BotImpl.getSession() implements Bot.getSession()\n      return bot.getSession(a, b);\n    },\n    fetch(request, contextData) {\n      return bot.fetch(request, contextData);\n    },\n    addCustomEmojis<TEmojiName extends string>(\n      emojis: Readonly<Record<TEmojiName, CustomEmoji>>,\n    ): Readonly<Record<TEmojiName, DeferredCustomEmoji<TContextData>>> {\n      return bot.addCustomEmojis(emojis);\n    },\n    get onFollow() {\n      return bot.onFollow;\n    },\n    set onFollow(value) {\n      bot.onFollow = value;\n    },\n    get onUnfollow() {\n      return bot.onUnfollow;\n    },\n    set onUnfollow(value) {\n      bot.onUnfollow = value;\n    },\n    get onAcceptFollow() {\n      return bot.onAcceptFollow;\n    },\n    set onAcceptFollow(value) {\n      bot.onAcceptFollow = value;\n    },\n    get onRejectFollow() {\n      return bot.onRejectFollow;\n    },\n    set onRejectFollow(value) {\n      bot.onRejectFollow = value;\n    },\n    get onMention() {\n      return bot.onMention;\n    },\n    set onMention(value) {\n      bot.onMention = value;\n    },\n    get onReply() {\n      return bot.onReply;\n    },\n    set onReply(value) {\n      bot.onReply = value;\n    },\n    get onQuote() {\n      return bot.onQuote;\n    },\n    set onQuote(value) {\n      bot.onQuote = value;\n    },\n    get onMessage() {\n      return bot.onMessage;\n    },\n    set onMessage(value) {\n      bot.onMessage = value;\n    },\n    get onSharedMessage() {\n      return bot.onSharedMessage;\n    },\n    set onSharedMessage(value) {\n      bot.onSharedMessage = value;\n    },\n    get onLike() {\n      return bot.onLike;\n    },\n    set onLike(value) {\n      bot.onLike = value;\n    },\n    get onUnlike() {\n      return bot.onUnlike;\n    },\n    set onUnlike(value) {\n      bot.onUnlike = value;\n    },\n    get onReact() {\n      return bot.onReact;\n    },\n    set onReact(value) {\n      bot.onReact = value;\n    },\n    get onUnreact() {\n      return bot.onUnreact;\n    },\n    set onUnreact(value) {\n      bot.onUnreact = value;\n    },\n    get onVote() {\n      return bot.onVote;\n    },\n    set onVote(value) {\n      bot.onVote = value;\n    },\n  } satisfies Bot<TContextData> & { impl: BotImpl<TContextData> };\n  // @ts-ignore: the wrapper implements BotWithVoidContextData\n  return wrapper;\n}\n"],"mappings":";;;;;;;;;;;;;AA+XA,SAAgB,UACdA,SACwE;CACxE,MAAM,MAAM,IAAI,QAAsB;CAItC,MAAM,UAAU;EACd,MAAM;EACN,IAAI,aAAa;AACf,UAAO,IAAI;EACZ;EACD,IAAI,aAAa;AACf,UAAO,IAAI;EACZ;EACD,WAAW,GAAGC,GAAI;AAEhB,UAAO,IAAI,WAAW,GAAG,EAAE;EAC5B;EACD,MAAM,SAAS,aAAa;AAC1B,UAAO,IAAI,MAAM,SAAS,YAAY;EACvC;EACD,gBACEC,QACiE;AACjE,UAAO,IAAI,gBAAgB,OAAO;EACnC;EACD,IAAI,WAAW;AACb,UAAO,IAAI;EACZ;EACD,IAAI,SAAS,OAAO;AAClB,OAAI,WAAW;EAChB;EACD,IAAI,aAAa;AACf,UAAO,IAAI;EACZ;EACD,IAAI,WAAW,OAAO;AACpB,OAAI,aAAa;EAClB;EACD,IAAI,iBAAiB;AACnB,UAAO,IAAI;EACZ;EACD,IAAI,eAAe,OAAO;AACxB,OAAI,iBAAiB;EACtB;EACD,IAAI,iBAAiB;AACnB,UAAO,IAAI;EACZ;EACD,IAAI,eAAe,OAAO;AACxB,OAAI,iBAAiB;EACtB;EACD,IAAI,YAAY;AACd,UAAO,IAAI;EACZ;EACD,IAAI,UAAU,OAAO;AACnB,OAAI,YAAY;EACjB;EACD,IAAI,UAAU;AACZ,UAAO,IAAI;EACZ;EACD,IAAI,QAAQ,OAAO;AACjB,OAAI,UAAU;EACf;EACD,IAAI,UAAU;AACZ,UAAO,IAAI;EACZ;EACD,IAAI,QAAQ,OAAO;AACjB,OAAI,UAAU;EACf;EACD,IAAI,YAAY;AACd,UAAO,IAAI;EACZ;EACD,IAAI,UAAU,OAAO;AACnB,OAAI,YAAY;EACjB;EACD,IAAI,kBAAkB;AACpB,UAAO,IAAI;EACZ;EACD,IAAI,gBAAgB,OAAO;AACzB,OAAI,kBAAkB;EACvB;EACD,IAAI,SAAS;AACX,UAAO,IAAI;EACZ;EACD,IAAI,OAAO,OAAO;AAChB,OAAI,SAAS;EACd;EACD,IAAI,WAAW;AACb,UAAO,IAAI;EACZ;EACD,IAAI,SAAS,OAAO;AAClB,OAAI,WAAW;EAChB;EACD,IAAI,UAAU;AACZ,UAAO,IAAI;EACZ;EACD,IAAI,QAAQ,OAAO;AACjB,OAAI,UAAU;EACf;EACD,IAAI,YAAY;AACd,UAAO,IAAI;EACZ;EACD,IAAI,UAAU,OAAO;AACnB,OAAI,YAAY;EACjB;EACD,IAAI,SAAS;AACX,UAAO,IAAI;EACZ;EACD,IAAI,OAAO,OAAO;AAChB,OAAI,SAAS;EACd;CACF;AAED,QAAO;AACR"}
+{"version":3,"file":"bot.js","names":["options: CreateBotOptions<TContextData>"],"sources":["../src/bot.ts"],"sourcesContent":["// BotKit by Fedify: A framework for creating ActivityPub bots\n// Copyright (C) 2025–2026 Hong Minhee <https://hongminhee.org/>\n//\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU Affero General Public License as\n// published by the Free Software Foundation, either version 3 of the\n// License, or (at your option) any later version.\n//\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n// GNU Affero General Public License for more details.\n//\n// You should have received a copy of the GNU Affero General Public License\n// along with this program.  If not, see <https://www.gnu.org/licenses/>.\nimport type {\n  Context,\n  Federation,\n  KvStore,\n  MessageQueue,\n} from \"@fedify/fedify/federation\";\nimport type { Software } from \"@fedify/fedify/nodeinfo\";\nimport type { Application, Image, Service } from \"@fedify/vocab\";\nimport { BotImpl, wrapBotImpl } from \"./bot-impl.ts\";\nimport type { CustomEmoji, DeferredCustomEmoji } from \"./emoji.ts\";\nimport type {\n  AcceptEventHandler,\n  FollowEventHandler,\n  LikeEventHandler,\n  MentionEventHandler,\n  MessageEventHandler,\n  QuoteEventHandler,\n  ReactionEventHandler,\n  RejectEventHandler,\n  ReplyEventHandler,\n  SharedMessageEventHandler,\n  UndoneReactionEventHandler,\n  UnfollowEventHandler,\n  UnlikeEventHandler,\n  VoteEventHandler,\n} from \"./events.ts\";\nimport type { Repository } from \"./repository.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { Text } from \"./text.ts\";\nexport { type Software } from \"@fedify/fedify/nodeinfo\";\nexport { Application, Image, Service } from \"@fedify/vocab\";\n\n/**\n * The event handlers a bot can register.  Assigning a handler to one of\n * these properties makes the bot react to the corresponding ActivityPub\n * activity.\n * @since 0.5.0\n */\nexport interface BotEventHandlers<TContextData> {\n  /**\n   * An event handler for a follow request to the bot.\n   */\n  onFollow?: FollowEventHandler<TContextData>;\n\n  /**\n   * An event handler for an unfollow event from the bot.\n   */\n  onUnfollow?: UnfollowEventHandler<TContextData>;\n\n  /**\n   * An event handler invoked when a follow request the bot sent is accepted.\n   */\n  onAcceptFollow?: AcceptEventHandler<TContextData>;\n\n  /**\n   * An event handler invoked when a follow request the bot sent is rejected.\n   */\n  onRejectFollow?: RejectEventHandler<TContextData>;\n\n  /**\n   * An event handler for a message mentioned to the bot.\n   */\n  onMention?: MentionEventHandler<TContextData>;\n\n  /**\n   * An event handler for a reply to the bot.\n   */\n  onReply?: ReplyEventHandler<TContextData>;\n\n  /**\n   * An event handler for a quote of the bot's message.\n   * @since 0.2.0\n   */\n  onQuote?: QuoteEventHandler<TContextData>;\n\n  /**\n   * An event handler for a message shown to the bot's timeline.  To listen\n   * to this event, your bot needs to follow others first.\n   */\n  onMessage?: MessageEventHandler<TContextData>;\n\n  /**\n   * An event handler for a message shared to the bot.  To listen to this event,\n   * your bot needs to follow others first.\n   */\n  onSharedMessage?: SharedMessageEventHandler<TContextData>;\n\n  /**\n   * An event handler for a like of a message.\n   */\n  onLike?: LikeEventHandler<TContextData>;\n\n  /**\n   * An event handler for an undoing of a like of a message.\n   */\n  onUnlike?: UnlikeEventHandler<TContextData>;\n\n  /**\n   * An event handler for an emoji reaction to a message.\n   * @since 0.2.0\n   */\n  onReact?: ReactionEventHandler<TContextData>;\n\n  /**\n   * An event handler for an undoing of an emoji reaction to a message.\n   * @since 0.2.0\n   */\n  onUnreact?: UndoneReactionEventHandler<TContextData>;\n\n  /**\n   * An event handler for a vote in a poll.  This event is only triggered when\n   * the bot is the author of the poll, and the vote is made by another actor.\n   * If the poll allows multiple selections, this event is triggered multiple\n   * times, once for each option selected by the actor.\n   *\n   * Note that this event can be triggered even if the voter vote an option\n   * multiple times or multiple options for a poll that disallows multiple\n   * selections.  You should validate the vote in the event handler by storing\n   * the votes in a persistent store, and checking if the vote is valid.\n   * (This behavior can subject to change in the future.)\n   * @since 0.3.0\n   */\n  onVote?: VoteEventHandler<TContextData>;\n}\n\n/**\n * A read-only view of a bot actor's identity and profile.  It is exposed\n * through {@link Session.bot} so that event handlers can tell which bot they\n * are running as without being able to mutate the bot (e.g. reassign its\n * event handlers).\n * @since 0.5.0\n */\nexport interface ReadonlyBot {\n  /**\n   * The internal identifier for the bot actor.  It is used for the actor URI.\n   */\n  readonly identifier: string;\n\n  /**\n   * The username of the bot.  It is a part of the fediverse handle.\n   */\n  readonly username: string;\n\n  /**\n   * The display name of the bot.\n   */\n  readonly name?: string;\n\n  /**\n   * The type of the bot actor.  It is either `Service` or `Application`.\n   */\n  readonly class: typeof Service | typeof Application;\n\n  /**\n   * The avatar URL of the bot.\n   */\n  readonly icon?: URL | Image;\n\n  /**\n   * The header image URL of the bot.\n   */\n  readonly image?: URL | Image;\n\n  /**\n   * How the bot handles incoming follow requests.\n   */\n  readonly followerPolicy: \"accept\" | \"reject\" | \"manual\";\n}\n\n/**\n * A bot that can interact with the ActivityPub network.\n */\nexport interface Bot<TContextData> extends BotEventHandlers<TContextData> {\n  /**\n   * An internal Fedify federation instance.  Normally you don't need to access\n   * this directly.\n   */\n  readonly federation: Federation<TContextData>;\n\n  /**\n   * The internal identifier for the bot actor.  It is used for the actor URI.\n   */\n  readonly identifier: string;\n\n  /**\n   * Gets a new session to control the bot for a specific origin and context\n   * data.\n   * @param origin The origin of the session.  Even if a URL with some path or\n   *               query is passed, only the origin part will be used.\n   * @param contextData The context data to pass to the federation.\n   * @returns The session for the origin and context data.\n   */\n  getSession(\n    origin: string | URL,\n    contextData: TContextData,\n  ): Session<TContextData>;\n\n  /**\n   * Gets a new session to control bot for a specific Fedify context.\n   * @param context The Fedify context of the session.\n   * @returns The session for the Fedify context.\n   */\n  getSession(context: Context<TContextData>): Session<TContextData>;\n\n  /**\n   * The fetch API for handling HTTP requests.  You can pass this to an HTTP\n   * server (e.g., `Deno.serve()`, `Bun.serve()`) to handle incoming requests.\n   * @param request The request to handle.\n   * @param contextData The context data to pass to the federation.\n   * @returns The response to the request.\n   */\n  fetch(request: Request, contextData: TContextData): Promise<Response>;\n\n  /**\n   * Defines custom emojis for the bot.  The custom emojis are used for\n   * rendering the bot's profile and posts.  The custom emojis are defined\n   * by their names, and the names are used as the keys of the emojis.\n   * @param emojis The custom emojis to define.  The keys are the names of\n   *               the emojis, and the values are the custom emoji definitions.\n   * @returns The defined emojis.  The keys are the names of the emojis, and\n   *          the values are the emoji objects, which are used for passing\n   *          to the {@link customEmoji} function.\n   * @throws {TypeError} If any emoji name is invalid or duplicate.\n   * @since 0.2.0\n   */\n  addCustomEmojis<TEmojiName extends string>(\n    emojis: Readonly<Record<TEmojiName, CustomEmoji>>,\n  ): Readonly<Record<TEmojiName, DeferredCustomEmoji<TContextData>>>;\n}\n\n/**\n * A specialized {@link Bot} tpe that doesn't require context data.\n */\nexport interface BotWithVoidContextData extends Bot<void> {\n  /**\n   * Gets a new session to control the bot for a specific origin and context\n   * data.\n   * @param origin The origin of the session.  Even if a URL with some path or\n   *               query is passed, only the origin part will be used.\n   * @param contextData The context data to pass to the federation.\n   * @returns The session for the origin and context data.\n   */\n  getSession(\n    origin: string | URL,\n    contextData: void,\n  ): Session<void>;\n\n  /**\n   * Gets a new session to control bot for a specific Fedify context.\n   * @param context The Fedify context of the session.\n   * @returns The session for the Fedify context.\n   */\n  getSession(context: Context<void>): Session<void>;\n\n  /**\n   * Gets a new session to control the bot for a specific origin and context\n   * data.\n   * @param origin The origin of the session.  Even if a URL with some path or\n   *               query is passed, only the origin part will be used.\n   */\n  getSession(origin: string | URL): Session<void>;\n\n  /**\n   * The fetch API for handling HTTP requests.  You can pass this to an HTTP\n   * server (e.g., `Deno.serve()`, `Bun.serve()`) to handle incoming requests.\n   * @param request The request to handle.\n   * @returns The response to the request.\n   */\n  fetch(request: Request): Promise<Response>;\n}\n\n/**\n * Options for creating a bot.\n */\nexport interface CreateBotOptions<TContextData> {\n  /**\n   * The internal identifier of the bot.  Since it is used for the actor URI,\n   * it *should not* be changed after the bot is federated.\n   *\n   * If omitted, `\"bot\"` will be used.\n   * @default `\"bot\"`\n   */\n  readonly identifier?: string;\n\n  /**\n   * The type of the bot actor.  It should be either `Service` or `Application`.\n   *\n   * If omitted, `Service` will be used.\n   * @default `Service`\n   */\n  readonly class?: typeof Service | typeof Application;\n\n  /**\n   * The username of the bot.  It will be a part of the fediverse handle.\n   * It can be changed after the bot is federated.\n   */\n  readonly username: string;\n\n  /**\n   * The display name of the bot.  It can be changed after the bot is federated.\n   */\n  readonly name?: string;\n\n  /**\n   * The description of the bot.  It can be changed after the bot is federated.\n   */\n  readonly summary?: Text<\"block\", TContextData>;\n\n  /**\n   * The avatar URL of the bot.  It can be changed after the bot is federated.\n   */\n  readonly icon?: URL | Image;\n\n  /**\n   * The header image URL of the bot.  It can be changed after the bot is\n   * federated.\n   */\n  readonly image?: URL | Image;\n\n  /**\n   * The custom properties of the bot.  It can be changed after the bot is\n   * federated.\n   */\n  readonly properties?: Record<string, Text<\"block\" | \"inline\", TContextData>>;\n\n  /**\n   * How to handle incoming follow requests.  Note that this behavior can be\n   * overridden by manually invoking {@link FollowRequest.accept} or\n   * {@link FollowRequest.reject} in the {@link Bot.onFollow} event handler.\n   *\n   * - `\"accept\"` (default): Automatically accept all incoming follow requests.\n   * - `\"reject\"`: Automatically reject all incoming follow requests.\n   * - `\"manual\"`: Require manual handling of incoming follow requests.\n   * @default `\"accept\"`\n   */\n  readonly followerPolicy?: \"accept\" | \"reject\" | \"manual\";\n\n  /**\n   * The underlying key-value store to use for storing data.\n   */\n  readonly kv: KvStore;\n\n  /**\n   * The underlying repository to use for storing data.  If omitted,\n   * {@link KvRepository} will be used.\n   */\n  readonly repository?: Repository;\n\n  /**\n   * The underlying message queue to use for handling incoming and outgoing\n   * activities.  If omitted, incoming activities are processed immediately,\n   * and outgoing activities are sent immediately.\n   */\n  readonly queue?: MessageQueue;\n\n  /**\n   * The software information of the bot.  If omitted, the NodeInfo protocol\n   * will be unimplemented.\n   */\n  readonly software?: Software;\n\n  /**\n   * Whether to trust `X-Forwarded-*` headers.  If your bot application is\n   * behind an L7 reverse proxy, turn it on.\n   *\n   * Turned off by default.\n   * @default `false`\n   */\n  readonly behindProxy?: boolean;\n\n  /**\n   * The options for the web pages of the bot.  If omitted, the default options\n   * will be used.\n   */\n  readonly pages?: PagesOptions;\n}\n\n/**\n * Options for the web pages of the bot.\n */\nexport interface PagesOptions {\n  /**\n   * The color of the theme.  It will be used for the theme color of the web\n   * pages.  The default color is `\"green\"`.\n   * @default `\"green\"`\n   */\n  readonly color?:\n    | \"amber\"\n    | \"azure\"\n    | \"blue\"\n    | \"cyan\"\n    | \"fuchsia\"\n    | \"green\"\n    | \"grey\"\n    | \"indigo\"\n    | \"jade\"\n    | \"lime\"\n    | \"orange\"\n    | \"pink\"\n    | \"pumpkin\"\n    | \"purple\"\n    | \"red\"\n    | \"sand\"\n    | \"slate\"\n    | \"violet\"\n    | \"yellow\"\n    | \"zinc\";\n\n  /**\n   * The CSS code for the bot.  It will be used for the custom CSS of the web\n   * pages.\n   */\n  readonly css?: string;\n}\n\n/**\n * Creates a {@link Bot} instance.\n * @param options The options for creating the bot.\n * @returns The created bot instance.\n */\nexport function createBot<TContextData = void>(\n  options: CreateBotOptions<TContextData>,\n): TContextData extends void ? BotWithVoidContextData : Bot<TContextData> {\n  const bot = new BotImpl<TContextData>(options);\n  // @ts-ignore: the wrapper implements BotWithVoidContextData\n  return wrapBotImpl(bot);\n}\n"],"mappings":";;;;;;;;;;;;;AAmbA,SAAgB,UACdA,SACwE;CACxE,MAAM,MAAM,IAAI,QAAsB;AAEtC,QAAO,YAAY,IAAI;AACxB"}

package/dist/bot.test.js

@@ -2,6 +2,7 @@
       import { Temporal, toTemporalInstant } from "@js-temporal/polyfill";
       Date.prototype.toTemporalInstant = toTemporalInstant;
     
+import { MemoryRepository } from "./repository.js";
 import { createBot } from "./bot.js";
 import { MemoryKvStore } from "@fedify/fedify/federation";
 import assert from "node:assert";
@@ -75,6 +76,64 @@ test("createBot()", async () => {
 		subject: "acct:bot@example.com"
 	});
 });
+test("Session.bot is a ReadonlyBot", () => {
+	const bot = createBot({
+		kv: new MemoryKvStore(),
+		username: "readonlybot"
+	});
+	const session = bot.getSession("https://example.com");
+	const view = session.bot;
+	assert.deepStrictEqual(view.identifier, "bot");
+	assert.deepStrictEqual(view.username, "readonlybot");
+	assert.deepStrictEqual(view.followerPolicy, "accept");
+	session.bot.onMention = void 0;
+	session.bot.repository;
+});
+test("createBot() adopts legacy repository data", async () => {
+	const kv = new MemoryKvStore();
+	const messageId = "01941f29-7c00-7fe8-ab0a-7b593990a3c0";
+	await kv.set(["_botkit", "messages"], [messageId]);
+	await kv.set([
+		"_botkit",
+		"messages",
+		messageId
+	], {
+		"@context": "https://www.w3.org/ns/activitystreams",
+		type: "Create",
+		id: `https://example.com/ap/create/${messageId}`,
+		actor: "https://example.com/ap/actor/bot",
+		object: {
+			type: "Note",
+			id: `https://example.com/ap/note/${messageId}`,
+			content: "Hello, world!"
+		}
+	});
+	const bot = createBot({
+		kv,
+		username: "bot"
+	});
+	const { impl } = bot;
+	assert.deepStrictEqual(await impl.repository.countMessages(), 1);
+});
+test("createBot() runs Repository.migrate() once", async () => {
+	class MigratingMemoryRepository extends MemoryRepository {
+		migrated = [];
+		migrate(identifier) {
+			this.migrated.push(identifier);
+			return Promise.resolve();
+		}
+	}
+	const repository = new MigratingMemoryRepository();
+	const bot = createBot({
+		kv: new MemoryKvStore(),
+		repository,
+		username: "bot"
+	});
+	const { impl } = bot;
+	await impl.repository.countMessages();
+	await impl.repository.countFollowers();
+	assert.deepStrictEqual(repository.migrated, ["bot"]);
+});
 
 //#endregion
 //# sourceMappingURL=bot.test.js.map

package/dist/bot.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"bot.test.js","names":["_session: Session<void>","_followRequest: FollowRequest","_follower: Actor","_accepter: Actor","_rejecter: Actor","_message: Message<MessageClass, void>","_message: SharedMessage<MessageClass, void>","_like: Like<void>"],"sources":["../src/bot.test.ts"],"sourcesContent":["// BotKit by Fedify: A framework for creating ActivityPub bots\n// Copyright (C) 2025–2026 Hong Minhee <https://hongminhee.org/>\n//\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU Affero General Public License as\n// published by the Free Software Foundation, either version 3 of the\n// License, or (at your option) any later version.\n//\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n// GNU Affero General Public License for more details.\n//\n// You should have received a copy of the GNU Affero General Public License\n// along with this program.  If not, see <https://www.gnu.org/licenses/>.\nimport { MemoryKvStore } from \"@fedify/fedify/federation\";\nimport type { Actor } from \"@fedify/vocab\";\nimport assert from \"node:assert\";\nimport { test } from \"node:test\";\nimport type { BotImpl } from \"./bot-impl.ts\";\nimport { createBot } from \"./bot.ts\";\nimport type { FollowRequest } from \"./follow.ts\";\nimport type { Message, MessageClass, SharedMessage } from \"./message.ts\";\nimport type { Like } from \"./reaction.ts\";\nimport type { Session } from \"./session.ts\";\n\ntest(\"createBot()\", async () => {\n  const kv = new MemoryKvStore();\n  const bot = createBot<void>({ kv, identifier: \"bot-id\", username: \"bot\" });\n  const { impl } = bot as unknown as { impl: BotImpl<void> };\n  const _federation = bot.federation;\n  assert.strictEqual(bot.identifier, \"bot-id\");\n  const session = bot.getSession(\"https://example.com\");\n  assert.strictEqual(session.actorHandle, \"@bot@example.com\");\n\n  function onFollow(_session: Session<void>, _followRequest: FollowRequest) {}\n  bot.onFollow = onFollow;\n  assert.strictEqual(bot.onFollow, onFollow);\n  assert.strictEqual(impl.onFollow, onFollow);\n\n  function onUnfollow(_session: Session<void>, _follower: Actor) {}\n  bot.onUnfollow = onUnfollow;\n  assert.strictEqual(bot.onUnfollow, onUnfollow);\n  assert.strictEqual(impl.onUnfollow, onUnfollow);\n\n  function onAcceptFollow(_session: Session<void>, _accepter: Actor) {}\n  bot.onAcceptFollow = onAcceptFollow;\n  assert.strictEqual(bot.onAcceptFollow, onAcceptFollow);\n  assert.strictEqual(impl.onAcceptFollow, onAcceptFollow);\n\n  function onRejectFollow(_session: Session<void>, _rejecter: Actor) {}\n  bot.onRejectFollow = onRejectFollow;\n  assert.strictEqual(bot.onRejectFollow, onRejectFollow);\n  assert.strictEqual(impl.onRejectFollow, onRejectFollow);\n\n  function onMention(\n    _session: Session<void>,\n    _message: Message<MessageClass, void>,\n  ) {}\n  bot.onMention = onMention;\n  assert.strictEqual(bot.onMention, onMention);\n  assert.strictEqual(impl.onMention, onMention);\n\n  function onReply(\n    _session: Session<void>,\n    _message: Message<MessageClass, void>,\n  ) {}\n  bot.onReply = onReply;\n  assert.strictEqual(bot.onReply, onReply);\n  assert.strictEqual(impl.onReply, onReply);\n\n  function onMessage(\n    _session: Session<void>,\n    _message: Message<MessageClass, void>,\n  ) {}\n  bot.onMessage = onMessage;\n  assert.strictEqual(bot.onMessage, onMessage);\n  assert.strictEqual(impl.onMessage, onMessage);\n\n  function onSharedMessage(\n    _session: Session<void>,\n    _message: SharedMessage<MessageClass, void>,\n  ) {}\n  bot.onSharedMessage = onSharedMessage;\n  assert.strictEqual(bot.onSharedMessage, onSharedMessage);\n  assert.strictEqual(impl.onSharedMessage, onSharedMessage);\n\n  function onLike(_session: Session<void>, _like: Like<void>) {}\n  bot.onLike = onLike;\n  assert.strictEqual(bot.onLike, onLike);\n  assert.strictEqual(impl.onLike, onLike);\n\n  function onUnlike(_session: Session<void>, _like: Like<void>) {}\n  bot.onUnlike = onUnlike;\n  assert.strictEqual(bot.onUnlike, onUnlike);\n  assert.strictEqual(impl.onUnlike, onUnlike);\n\n  const response = await bot.fetch(\n    new Request(\n      \"https://example.com/.well-known/webfinger?resource=acct:bot@example.com\",\n    ),\n  );\n  assert.strictEqual(response.status, 200);\n  assert.deepStrictEqual(await response.json(), {\n    aliases: [\n      \"https://example.com/ap/actor/bot-id\",\n    ],\n    links: [\n      {\n        href: \"https://example.com/ap/actor/bot-id\",\n        rel: \"self\",\n        type: \"application/activity+json\",\n      },\n      {\n        href: \"https://example.com/\",\n        rel: \"http://webfinger.net/rel/profile-page\",\n      },\n    ],\n    subject: \"acct:bot@example.com\",\n  });\n});\n"],"mappings":";;;;;;;;;;AA0BA,KAAK,eAAe,YAAY;CAC9B,MAAM,KAAK,IAAI;CACf,MAAM,MAAM,UAAgB;EAAE;EAAI,YAAY;EAAU,UAAU;CAAO,EAAC;CAC1E,MAAM,EAAE,MAAM,GAAG;CACjB,MAAM,cAAc,IAAI;AACxB,QAAO,YAAY,IAAI,YAAY,SAAS;CAC5C,MAAM,UAAU,IAAI,WAAW,sBAAsB;AACrD,QAAO,YAAY,QAAQ,aAAa,mBAAmB;CAE3D,SAAS,SAASA,UAAyBC,gBAA+B,CAAE;AAC5E,KAAI,WAAW;AACf,QAAO,YAAY,IAAI,UAAU,SAAS;AAC1C,QAAO,YAAY,KAAK,UAAU,SAAS;CAE3C,SAAS,WAAWD,UAAyBE,WAAkB,CAAE;AACjE,KAAI,aAAa;AACjB,QAAO,YAAY,IAAI,YAAY,WAAW;AAC9C,QAAO,YAAY,KAAK,YAAY,WAAW;CAE/C,SAAS,eAAeF,UAAyBG,WAAkB,CAAE;AACrE,KAAI,iBAAiB;AACrB,QAAO,YAAY,IAAI,gBAAgB,eAAe;AACtD,QAAO,YAAY,KAAK,gBAAgB,eAAe;CAEvD,SAAS,eAAeH,UAAyBI,WAAkB,CAAE;AACrE,KAAI,iBAAiB;AACrB,QAAO,YAAY,IAAI,gBAAgB,eAAe;AACtD,QAAO,YAAY,KAAK,gBAAgB,eAAe;CAEvD,SAAS,UACPJ,UACAK,UACA,CAAE;AACJ,KAAI,YAAY;AAChB,QAAO,YAAY,IAAI,WAAW,UAAU;AAC5C,QAAO,YAAY,KAAK,WAAW,UAAU;CAE7C,SAAS,QACPL,UACAK,UACA,CAAE;AACJ,KAAI,UAAU;AACd,QAAO,YAAY,IAAI,SAAS,QAAQ;AACxC,QAAO,YAAY,KAAK,SAAS,QAAQ;CAEzC,SAAS,UACPL,UACAK,UACA,CAAE;AACJ,KAAI,YAAY;AAChB,QAAO,YAAY,IAAI,WAAW,UAAU;AAC5C,QAAO,YAAY,KAAK,WAAW,UAAU;CAE7C,SAAS,gBACPL,UACAM,UACA,CAAE;AACJ,KAAI,kBAAkB;AACtB,QAAO,YAAY,IAAI,iBAAiB,gBAAgB;AACxD,QAAO,YAAY,KAAK,iBAAiB,gBAAgB;CAEzD,SAAS,OAAON,UAAyBO,OAAmB,CAAE;AAC9D,KAAI,SAAS;AACb,QAAO,YAAY,IAAI,QAAQ,OAAO;AACtC,QAAO,YAAY,KAAK,QAAQ,OAAO;CAEvC,SAAS,SAASP,UAAyBO,OAAmB,CAAE;AAChE,KAAI,WAAW;AACf,QAAO,YAAY,IAAI,UAAU,SAAS;AAC1C,QAAO,YAAY,KAAK,UAAU,SAAS;CAE3C,MAAM,WAAW,MAAM,IAAI,MACzB,IAAI,QACF,2EAEH;AACD,QAAO,YAAY,SAAS,QAAQ,IAAI;AACxC,QAAO,gBAAgB,MAAM,SAAS,MAAM,EAAE;EAC5C,SAAS,CACP,qCACD;EACD,OAAO,CACL;GACE,MAAM;GACN,KAAK;GACL,MAAM;EACP,GACD;GACE,MAAM;GACN,KAAK;EACN,CACF;EACD,SAAS;CACV,EAAC;AACH,EAAC"}
+{"version":3,"file":"bot.test.js","names":["_session: Session<void>","_followRequest: FollowRequest","_follower: Actor","_accepter: Actor","_rejecter: Actor","_message: Message<MessageClass, void>","_message: SharedMessage<MessageClass, void>","_like: Like<void>","view: ReadonlyBot","identifier: string"],"sources":["../src/bot.test.ts"],"sourcesContent":["// BotKit by Fedify: A framework for creating ActivityPub bots\n// Copyright (C) 2025–2026 Hong Minhee <https://hongminhee.org/>\n//\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU Affero General Public License as\n// published by the Free Software Foundation, either version 3 of the\n// License, or (at your option) any later version.\n//\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n// GNU Affero General Public License for more details.\n//\n// You should have received a copy of the GNU Affero General Public License\n// along with this program.  If not, see <https://www.gnu.org/licenses/>.\nimport { MemoryKvStore } from \"@fedify/fedify/federation\";\nimport type { Actor } from \"@fedify/vocab\";\nimport assert from \"node:assert\";\nimport { test } from \"node:test\";\nimport type { BotImpl } from \"./bot-impl.ts\";\nimport { MemoryRepository } from \"./repository.ts\";\nimport { createBot, type ReadonlyBot } from \"./bot.ts\";\nimport type { FollowRequest } from \"./follow.ts\";\nimport type { Message, MessageClass, SharedMessage } from \"./message.ts\";\nimport type { Like } from \"./reaction.ts\";\nimport type { Session } from \"./session.ts\";\n\ntest(\"createBot()\", async () => {\n  const kv = new MemoryKvStore();\n  const bot = createBot<void>({ kv, identifier: \"bot-id\", username: \"bot\" });\n  const { impl } = bot as unknown as { impl: BotImpl<void> };\n  const _federation = bot.federation;\n  assert.strictEqual(bot.identifier, \"bot-id\");\n  const session = bot.getSession(\"https://example.com\");\n  assert.strictEqual(session.actorHandle, \"@bot@example.com\");\n\n  function onFollow(_session: Session<void>, _followRequest: FollowRequest) {}\n  bot.onFollow = onFollow;\n  assert.strictEqual(bot.onFollow, onFollow);\n  assert.strictEqual(impl.onFollow, onFollow);\n\n  function onUnfollow(_session: Session<void>, _follower: Actor) {}\n  bot.onUnfollow = onUnfollow;\n  assert.strictEqual(bot.onUnfollow, onUnfollow);\n  assert.strictEqual(impl.onUnfollow, onUnfollow);\n\n  function onAcceptFollow(_session: Session<void>, _accepter: Actor) {}\n  bot.onAcceptFollow = onAcceptFollow;\n  assert.strictEqual(bot.onAcceptFollow, onAcceptFollow);\n  assert.strictEqual(impl.onAcceptFollow, onAcceptFollow);\n\n  function onRejectFollow(_session: Session<void>, _rejecter: Actor) {}\n  bot.onRejectFollow = onRejectFollow;\n  assert.strictEqual(bot.onRejectFollow, onRejectFollow);\n  assert.strictEqual(impl.onRejectFollow, onRejectFollow);\n\n  function onMention(\n    _session: Session<void>,\n    _message: Message<MessageClass, void>,\n  ) {}\n  bot.onMention = onMention;\n  assert.strictEqual(bot.onMention, onMention);\n  assert.strictEqual(impl.onMention, onMention);\n\n  function onReply(\n    _session: Session<void>,\n    _message: Message<MessageClass, void>,\n  ) {}\n  bot.onReply = onReply;\n  assert.strictEqual(bot.onReply, onReply);\n  assert.strictEqual(impl.onReply, onReply);\n\n  function onMessage(\n    _session: Session<void>,\n    _message: Message<MessageClass, void>,\n  ) {}\n  bot.onMessage = onMessage;\n  assert.strictEqual(bot.onMessage, onMessage);\n  assert.strictEqual(impl.onMessage, onMessage);\n\n  function onSharedMessage(\n    _session: Session<void>,\n    _message: SharedMessage<MessageClass, void>,\n  ) {}\n  bot.onSharedMessage = onSharedMessage;\n  assert.strictEqual(bot.onSharedMessage, onSharedMessage);\n  assert.strictEqual(impl.onSharedMessage, onSharedMessage);\n\n  function onLike(_session: Session<void>, _like: Like<void>) {}\n  bot.onLike = onLike;\n  assert.strictEqual(bot.onLike, onLike);\n  assert.strictEqual(impl.onLike, onLike);\n\n  function onUnlike(_session: Session<void>, _like: Like<void>) {}\n  bot.onUnlike = onUnlike;\n  assert.strictEqual(bot.onUnlike, onUnlike);\n  assert.strictEqual(impl.onUnlike, onUnlike);\n\n  const response = await bot.fetch(\n    new Request(\n      \"https://example.com/.well-known/webfinger?resource=acct:bot@example.com\",\n    ),\n  );\n  assert.strictEqual(response.status, 200);\n  assert.deepStrictEqual(await response.json(), {\n    aliases: [\n      \"https://example.com/ap/actor/bot-id\",\n    ],\n    links: [\n      {\n        href: \"https://example.com/ap/actor/bot-id\",\n        rel: \"self\",\n        type: \"application/activity+json\",\n      },\n      {\n        href: \"https://example.com/\",\n        rel: \"http://webfinger.net/rel/profile-page\",\n      },\n    ],\n    subject: \"acct:bot@example.com\",\n  });\n});\n\ntest(\"Session.bot is a ReadonlyBot\", () => {\n  const bot = createBot<void>({\n    kv: new MemoryKvStore(),\n    username: \"readonlybot\",\n  });\n  const session = bot.getSession(\"https://example.com\");\n  const view: ReadonlyBot = session.bot;\n  assert.deepStrictEqual(view.identifier, \"bot\");\n  assert.deepStrictEqual(view.username, \"readonlybot\");\n  assert.deepStrictEqual(view.followerPolicy, \"accept\");\n\n  // Event handlers must not be reachable through the session's bot view:\n  // @ts-expect-error: ReadonlyBot does not expose event handlers.\n  session.bot.onMention = undefined;\n  // @ts-expect-error: ReadonlyBot does not expose the repository.\n  session.bot.repository;\n});\n\ntest(\"createBot() adopts legacy repository data\", async () => {\n  const kv = new MemoryKvStore();\n  // Simulates the unscoped key layout of BotKit 0.4 and earlier:\n  const messageId = \"01941f29-7c00-7fe8-ab0a-7b593990a3c0\";\n  await kv.set([\"_botkit\", \"messages\"], [messageId]);\n  await kv.set([\"_botkit\", \"messages\", messageId], {\n    \"@context\": \"https://www.w3.org/ns/activitystreams\",\n    type: \"Create\",\n    id: `https://example.com/ap/create/${messageId}`,\n    actor: \"https://example.com/ap/actor/bot\",\n    object: {\n      type: \"Note\",\n      id: `https://example.com/ap/note/${messageId}`,\n      content: \"Hello, world!\",\n    },\n  });\n  const bot = createBot<void>({ kv, username: \"bot\" });\n  const { impl } = bot as unknown as { impl: BotImpl<void> };\n  // The legacy message is adopted before the first repository operation:\n  assert.deepStrictEqual(await impl.repository.countMessages(), 1);\n});\n\ntest(\"createBot() runs Repository.migrate() once\", async () => {\n  class MigratingMemoryRepository extends MemoryRepository {\n    migrated: string[] = [];\n    migrate(identifier: string): Promise<void> {\n      this.migrated.push(identifier);\n      return Promise.resolve();\n    }\n  }\n  const repository = new MigratingMemoryRepository();\n  const bot = createBot<void>({\n    kv: new MemoryKvStore(),\n    repository,\n    username: \"bot\",\n  });\n  const { impl } = bot as unknown as { impl: BotImpl<void> };\n  await impl.repository.countMessages();\n  await impl.repository.countFollowers();\n  assert.deepStrictEqual(repository.migrated, [\"bot\"]);\n});\n"],"mappings":";;;;;;;;;;;AA2BA,KAAK,eAAe,YAAY;CAC9B,MAAM,KAAK,IAAI;CACf,MAAM,MAAM,UAAgB;EAAE;EAAI,YAAY;EAAU,UAAU;CAAO,EAAC;CAC1E,MAAM,EAAE,MAAM,GAAG;CACjB,MAAM,cAAc,IAAI;AACxB,QAAO,YAAY,IAAI,YAAY,SAAS;CAC5C,MAAM,UAAU,IAAI,WAAW,sBAAsB;AACrD,QAAO,YAAY,QAAQ,aAAa,mBAAmB;CAE3D,SAAS,SAASA,UAAyBC,gBAA+B,CAAE;AAC5E,KAAI,WAAW;AACf,QAAO,YAAY,IAAI,UAAU,SAAS;AAC1C,QAAO,YAAY,KAAK,UAAU,SAAS;CAE3C,SAAS,WAAWD,UAAyBE,WAAkB,CAAE;AACjE,KAAI,aAAa;AACjB,QAAO,YAAY,IAAI,YAAY,WAAW;AAC9C,QAAO,YAAY,KAAK,YAAY,WAAW;CAE/C,SAAS,eAAeF,UAAyBG,WAAkB,CAAE;AACrE,KAAI,iBAAiB;AACrB,QAAO,YAAY,IAAI,gBAAgB,eAAe;AACtD,QAAO,YAAY,KAAK,gBAAgB,eAAe;CAEvD,SAAS,eAAeH,UAAyBI,WAAkB,CAAE;AACrE,KAAI,iBAAiB;AACrB,QAAO,YAAY,IAAI,gBAAgB,eAAe;AACtD,QAAO,YAAY,KAAK,gBAAgB,eAAe;CAEvD,SAAS,UACPJ,UACAK,UACA,CAAE;AACJ,KAAI,YAAY;AAChB,QAAO,YAAY,IAAI,WAAW,UAAU;AAC5C,QAAO,YAAY,KAAK,WAAW,UAAU;CAE7C,SAAS,QACPL,UACAK,UACA,CAAE;AACJ,KAAI,UAAU;AACd,QAAO,YAAY,IAAI,SAAS,QAAQ;AACxC,QAAO,YAAY,KAAK,SAAS,QAAQ;CAEzC,SAAS,UACPL,UACAK,UACA,CAAE;AACJ,KAAI,YAAY;AAChB,QAAO,YAAY,IAAI,WAAW,UAAU;AAC5C,QAAO,YAAY,KAAK,WAAW,UAAU;CAE7C,SAAS,gBACPL,UACAM,UACA,CAAE;AACJ,KAAI,kBAAkB;AACtB,QAAO,YAAY,IAAI,iBAAiB,gBAAgB;AACxD,QAAO,YAAY,KAAK,iBAAiB,gBAAgB;CAEzD,SAAS,OAAON,UAAyBO,OAAmB,CAAE;AAC9D,KAAI,SAAS;AACb,QAAO,YAAY,IAAI,QAAQ,OAAO;AACtC,QAAO,YAAY,KAAK,QAAQ,OAAO;CAEvC,SAAS,SAASP,UAAyBO,OAAmB,CAAE;AAChE,KAAI,WAAW;AACf,QAAO,YAAY,IAAI,UAAU,SAAS;AAC1C,QAAO,YAAY,KAAK,UAAU,SAAS;CAE3C,MAAM,WAAW,MAAM,IAAI,MACzB,IAAI,QACF,2EAEH;AACD,QAAO,YAAY,SAAS,QAAQ,IAAI;AACxC,QAAO,gBAAgB,MAAM,SAAS,MAAM,EAAE;EAC5C,SAAS,CACP,qCACD;EACD,OAAO,CACL;GACE,MAAM;GACN,KAAK;GACL,MAAM;EACP,GACD;GACE,MAAM;GACN,KAAK;EACN,CACF;EACD,SAAS;CACV,EAAC;AACH,EAAC;AAEF,KAAK,gCAAgC,MAAM;CACzC,MAAM,MAAM,UAAgB;EAC1B,IAAI,IAAI;EACR,UAAU;CACX,EAAC;CACF,MAAM,UAAU,IAAI,WAAW,sBAAsB;CACrD,MAAMC,OAAoB,QAAQ;AAClC,QAAO,gBAAgB,KAAK,YAAY,MAAM;AAC9C,QAAO,gBAAgB,KAAK,UAAU,cAAc;AACpD,QAAO,gBAAgB,KAAK,gBAAgB,SAAS;AAIrD,SAAQ,IAAI;AAEZ,SAAQ,IAAI;AACb,EAAC;AAEF,KAAK,6CAA6C,YAAY;CAC5D,MAAM,KAAK,IAAI;CAEf,MAAM,YAAY;AAClB,OAAM,GAAG,IAAI,CAAC,WAAW,UAAW,GAAE,CAAC,SAAU,EAAC;AAClD,OAAM,GAAG,IAAI;EAAC;EAAW;EAAY;CAAU,GAAE;EAC/C,YAAY;EACZ,MAAM;EACN,KAAK,gCAAgC,UAAU;EAC/C,OAAO;EACP,QAAQ;GACN,MAAM;GACN,KAAK,8BAA8B,UAAU;GAC7C,SAAS;EACV;CACF,EAAC;CACF,MAAM,MAAM,UAAgB;EAAE;EAAI,UAAU;CAAO,EAAC;CACpD,MAAM,EAAE,MAAM,GAAG;AAEjB,QAAO,gBAAgB,MAAM,KAAK,WAAW,eAAe,EAAE,EAAE;AACjE,EAAC;AAEF,KAAK,8CAA8C,YAAY;CAC7D,MAAM,kCAAkC,iBAAiB;EACvD,WAAqB,CAAE;EACvB,QAAQC,YAAmC;AACzC,QAAK,SAAS,KAAK,WAAW;AAC9B,UAAO,QAAQ,SAAS;EACzB;CACF;CACD,MAAM,aAAa,IAAI;CACvB,MAAM,MAAM,UAAgB;EAC1B,IAAI,IAAI;EACR;EACA,UAAU;CACX,EAAC;CACF,MAAM,EAAE,MAAM,GAAG;AACjB,OAAM,KAAK,WAAW,eAAe;AACrC,OAAM,KAAK,WAAW,gBAAgB;AACtC,QAAO,gBAAgB,WAAW,UAAU,CAAC,KAAM,EAAC;AACrD,EAAC"}

package/dist/components/FollowButton.d.ts

@@ -6,9 +6,11 @@ import * as hono_jsx_jsx_dev_runtime0 from "hono/jsx/jsx-dev-runtime";
 //#region src/components/FollowButton.d.ts
 interface FollowButtonProps {
   readonly bot: BotImpl<unknown>;
+  readonly action?: string;
 }
 declare function FollowButton({
-  bot
+  bot,
+  action
 }: FollowButtonProps): hono_jsx_jsx_dev_runtime0.JSX.Element;
 //# sourceMappingURL=FollowButton.d.ts.map
 

package/dist/components/FollowButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FollowButton.d.ts","names":[],"sources":["../../src/components/FollowButton.tsx"],"sourcesContent":[],"mappings":";;;;;;UAGiB,iBAAA;gBACD;;iBAGA,YAAA;;GAAsB,oBAAiB,yBAAA,CAAA,GAAA,CAAA"}
+{"version":3,"file":"FollowButton.d.ts","names":[],"sources":["../../src/components/FollowButton.tsx"],"sourcesContent":[],"mappings":";;;;;;UAGiB,iBAAA;gBACD;;;iBAIA,YAAA;;;GAA8B,oBAAiB,yBAAA,CAAA,GAAA,CAAA"}

package/dist/components/FollowButton.js

@@ -5,7 +5,7 @@
 import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
 
 //#region src/components/FollowButton.tsx
-function FollowButton({ bot }) {
+function FollowButton({ bot, action }) {
 	return /* @__PURE__ */ jsxs(Fragment, { children: [
 		/* @__PURE__ */ jsx("button", {
 			id: "follow-btn",
@@ -27,7 +27,7 @@ function FollowButton({ bot }) {
 						onclick: "closeFollowModal()"
 					})]
 				}), /* @__PURE__ */ jsxs("main", { children: [/* @__PURE__ */ jsx("p", { children: "Enter your fediverse handle to follow this account:" }), /* @__PURE__ */ jsxs("form", {
-					action: "/follow",
+					action: action ?? "/follow",
 					method: "post",
 					children: [/* @__PURE__ */ jsx("input", {
 						type: "text",

package/dist/components/FollowButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"FollowButton.js","names":[],"sources":["../../src/components/FollowButton.tsx"],"sourcesContent":["/** @jsxImportSource hono/jsx */\nimport type { BotImpl } from \"../bot-impl.ts\";\n\nexport interface FollowButtonProps {\n  readonly bot: BotImpl<unknown>;\n}\n\nexport function FollowButton({ bot }: FollowButtonProps) {\n  return (\n    <>\n      <button\n        id=\"follow-btn\"\n        type=\"button\"\n        style=\"padding: 0.5rem 1rem; background: var(--pico-primary); color: var(--pico-primary-inverse); border: none; border-radius: 0.25rem; cursor: pointer;\"\n        onclick=\"showFollowModal()\"\n      >\n        Follow\n      </button>\n      <dialog id=\"follow-modal\">\n        <article style=\"width: 400px;\">\n          <header style=\"display: flex; align-items: center; justify-content:space-between\">\n            <h3>Follow {bot.name ?? bot.username}</h3>\n            <button\n              aria-label=\"Close\"\n              rel=\"prev\"\n              type=\"button\"\n              onclick=\"closeFollowModal()\"\n            />\n          </header>\n          <main>\n            <p>Enter your fediverse handle to follow this account:</p>\n            <form action=\"/follow\" method=\"post\">\n              <input\n                type=\"text\"\n                id=\"fediverse-handle\"\n                name=\"handle\"\n                placeholder=\"@username@instance.com\"\n                required\n                style=\"width: 100%; margin-bottom: 1rem;\"\n              />\n              <button type=\"submit\" style=\"width: 100%;\">\n                Follow\n              </button>\n            </form>\n          </main>\n        </article>\n      </dialog>\n      <script\n        dangerouslySetInnerHTML={{\n          __html: `\n          function showFollowModal() {\n            document.getElementById('follow-modal').showModal();\n          }\n          \n          function closeFollowModal() {\n            document.getElementById('follow-modal').close();\n          }\n        `,\n        }}\n      />\n    </>\n  );\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,aAAa,EAAE,KAAwB,EAAE;AACvD,wBACE;kBACE,IAAC;GACC,IAAG;GACH,MAAK;GACL,OAAM;GACN,SAAQ;aACT;IAEQ;kBACT,IAAC;GAAO,IAAG;6BACT,KAAC;IAAQ,OAAM;+BACb,KAAC;KAAO,OAAM;gCACZ,KAAC,mBAAG,WAAQ,IAAI,QAAQ,IAAI,YAAc,kBAC1C,IAAC;MACC,cAAW;MACX,KAAI;MACJ,MAAK;MACL,SAAQ;OACR;MACK,kBACT,KAAC,qCACC,IAAC,iBAAE,wDAAuD,kBAC1D,KAAC;KAAK,QAAO;KAAU,QAAO;gCAC5B,IAAC;MACC,MAAK;MACL,IAAG;MACH,MAAK;MACL,aAAY;MACZ;MACA,OAAM;OACN,kBACF,IAAC;MAAO,MAAK;MAAS,OAAM;gBAAe;OAElC;MACJ,IACF;KACC;IACH;kBACT,IAAC,YACC,yBAAyB,EACvB,SAAS;;;;;;;;UASV,IACD;KACD;AAEN"}
+{"version":3,"file":"FollowButton.js","names":[],"sources":["../../src/components/FollowButton.tsx"],"sourcesContent":["/** @jsxImportSource hono/jsx */\nimport type { BotImpl } from \"../bot-impl.ts\";\n\nexport interface FollowButtonProps {\n  readonly bot: BotImpl<unknown>;\n  readonly action?: string;\n}\n\nexport function FollowButton({ bot, action }: FollowButtonProps) {\n  return (\n    <>\n      <button\n        id=\"follow-btn\"\n        type=\"button\"\n        style=\"padding: 0.5rem 1rem; background: var(--pico-primary); color: var(--pico-primary-inverse); border: none; border-radius: 0.25rem; cursor: pointer;\"\n        onclick=\"showFollowModal()\"\n      >\n        Follow\n      </button>\n      <dialog id=\"follow-modal\">\n        <article style=\"width: 400px;\">\n          <header style=\"display: flex; align-items: center; justify-content:space-between\">\n            <h3>Follow {bot.name ?? bot.username}</h3>\n            <button\n              aria-label=\"Close\"\n              rel=\"prev\"\n              type=\"button\"\n              onclick=\"closeFollowModal()\"\n            />\n          </header>\n          <main>\n            <p>Enter your fediverse handle to follow this account:</p>\n            <form action={action ?? \"/follow\"} method=\"post\">\n              <input\n                type=\"text\"\n                id=\"fediverse-handle\"\n                name=\"handle\"\n                placeholder=\"@username@instance.com\"\n                required\n                style=\"width: 100%; margin-bottom: 1rem;\"\n              />\n              <button type=\"submit\" style=\"width: 100%;\">\n                Follow\n              </button>\n            </form>\n          </main>\n        </article>\n      </dialog>\n      <script\n        dangerouslySetInnerHTML={{\n          __html: `\n          function showFollowModal() {\n            document.getElementById('follow-modal').showModal();\n          }\n          \n          function closeFollowModal() {\n            document.getElementById('follow-modal').close();\n          }\n        `,\n        }}\n      />\n    </>\n  );\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,aAAa,EAAE,KAAK,QAA2B,EAAE;AAC/D,wBACE;kBACE,IAAC;GACC,IAAG;GACH,MAAK;GACL,OAAM;GACN,SAAQ;aACT;IAEQ;kBACT,IAAC;GAAO,IAAG;6BACT,KAAC;IAAQ,OAAM;+BACb,KAAC;KAAO,OAAM;gCACZ,KAAC,mBAAG,WAAQ,IAAI,QAAQ,IAAI,YAAc,kBAC1C,IAAC;MACC,cAAW;MACX,KAAI;MACJ,MAAK;MACL,SAAQ;OACR;MACK,kBACT,KAAC,qCACC,IAAC,iBAAE,wDAAuD,kBAC1D,KAAC;KAAK,QAAQ,UAAU;KAAW,QAAO;gCACxC,IAAC;MACC,MAAK;MACL,IAAG;MACH,MAAK;MACL,aAAY;MACZ;MACA,OAAM;OACN,kBACF,IAAC;MAAO,MAAK;MAAS,OAAM;gBAAe;OAElC;MACJ,IACF;KACC;IACH;kBACT,IAAC,YACC,yBAAyB,EACvB,SAAS;;;;;;;;UASV,IACD;KACD;AAEN"}

package/dist/components/Layout.js

@@ -27,7 +27,7 @@ function Layout({ bot, host, title, activityLink, feedLink, children }) {
 			rel: "stylesheet",
 			href: `https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/${cssFilename}`
 		}),
-		/* @__PURE__ */ jsx("style", { children: bot.pages.css })
+		/* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: bot.pages.css } })
 	] }), /* @__PURE__ */ jsx("body", { children })] });
 }
 

package/dist/components/Layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"Layout.js","names":[],"sources":["../../src/components/Layout.tsx"],"sourcesContent":["// BotKit by Fedify: A framework for creating ActivityPub bots\n// Copyright (C) 2025–2026 Hong Minhee <https://hongminhee.org/>\n//\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU Affero General Public License as\n// published by the Free Software Foundation, either version 3 of the\n// License, or (at your option) any later version.\n//\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n// GNU Affero General Public License for more details.\n//\n// You should have received a copy of the GNU Affero General Public License\n// along with this program.  If not, see <https://www.gnu.org/licenses/>.\n/** @jsx react-jsx */\n/** @jsxImportSource hono/jsx */\nimport type { JSX } from \"hono/jsx/jsx-runtime\";\nimport type { BotImpl } from \"../bot-impl.ts\";\n\nexport interface LayoutProps extends JSX.ElementChildrenAttribute {\n  readonly bot: BotImpl<unknown>;\n  readonly host: string;\n  readonly title?: string;\n  readonly activityLink?: string | URL;\n  readonly feedLink?: string | URL;\n}\n\nexport function Layout(\n  { bot, host, title, activityLink, feedLink, children }: LayoutProps,\n) {\n  const handle = `@${bot.username}@${host}`;\n  const cssFilename = bot.pages.color === \"azure\"\n    ? `pico.min.css`\n    : `pico.${bot.pages.color}.min.css`;\n  return (\n    <html>\n      <head>\n        <meta charset=\"utf-8\" />\n        <title>\n          {title != null && `${title} — `}\n          {bot.name == null ? handle : `${bot.name} (${handle})`}\n        </title>\n        {activityLink &&\n          (\n            <link\n              rel=\"alternate\"\n              type=\"application/activity+json\"\n              href={activityLink.toString()}\n              title=\"ActivityPub\"\n            />\n          )}\n        {feedLink && (\n          <link\n            rel=\"alternate\"\n            type=\"application/atom+xml\"\n            href={feedLink.toString()}\n            title=\"Atom feed\"\n          />\n        )}\n        <link\n          rel=\"stylesheet\"\n          href={`https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/${cssFilename}`}\n        />\n        <style>{bot.pages.css}</style>\n      </head>\n      <body>\n        {children}\n      </body>\n    </html>\n  );\n}\n"],"mappings":";;;;;;;AA4BA,SAAgB,OACd,EAAE,KAAK,MAAM,OAAO,cAAc,UAAU,UAAuB,EACnE;CACA,MAAM,UAAU,GAAG,IAAI,SAAS,GAAG,KAAK;CACxC,MAAM,cAAc,IAAI,MAAM,UAAU,WACnC,iBACA,OAAO,IAAI,MAAM,MAAM;AAC5B,wBACE,KAAC,qCACC,KAAC;kBACC,IAAC,UAAK,SAAQ,UAAU;kBACxB,KAAC,sBACE,SAAS,SAAS,EAAE,MAAM,MAC1B,IAAI,QAAQ,OAAO,UAAU,EAAE,IAAI,KAAK,IAAI,OAAO,MAC9C;EACP,gCAEG,IAAC;GACC,KAAI;GACJ,MAAK;GACL,MAAM,aAAa,UAAU;GAC7B,OAAM;IACN;EAEL,4BACC,IAAC;GACC,KAAI;GACJ,MAAK;GACL,MAAM,SAAS,UAAU;GACzB,OAAM;IACN;kBAEJ,IAAC;GACC,KAAI;GACJ,OAAO,mDAAmD,YAAY;IACtE;kBACF,IAAC,qBAAO,IAAI,MAAM,MAAY;KACzB,kBACP,IAAC,UACE,WACI,IACF;AAEV"}
+{"version":3,"file":"Layout.js","names":[],"sources":["../../src/components/Layout.tsx"],"sourcesContent":["// BotKit by Fedify: A framework for creating ActivityPub bots\n// Copyright (C) 2025–2026 Hong Minhee <https://hongminhee.org/>\n//\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU Affero General Public License as\n// published by the Free Software Foundation, either version 3 of the\n// License, or (at your option) any later version.\n//\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n// GNU Affero General Public License for more details.\n//\n// You should have received a copy of the GNU Affero General Public License\n// along with this program.  If not, see <https://www.gnu.org/licenses/>.\n/** @jsx react-jsx */\n/** @jsxImportSource hono/jsx */\nimport type { JSX } from \"hono/jsx/jsx-runtime\";\nimport type { BotImpl } from \"../bot-impl.ts\";\n\nexport interface LayoutProps extends JSX.ElementChildrenAttribute {\n  readonly bot: BotImpl<unknown>;\n  readonly host: string;\n  readonly title?: string;\n  readonly activityLink?: string | URL;\n  readonly feedLink?: string | URL;\n}\n\nexport function Layout(\n  { bot, host, title, activityLink, feedLink, children }: LayoutProps,\n) {\n  const handle = `@${bot.username}@${host}`;\n  const cssFilename = bot.pages.color === \"azure\"\n    ? `pico.min.css`\n    : `pico.${bot.pages.color}.min.css`;\n  return (\n    <html>\n      <head>\n        <meta charset=\"utf-8\" />\n        <title>\n          {title != null && `${title} — `}\n          {bot.name == null ? handle : `${bot.name} (${handle})`}\n        </title>\n        {activityLink &&\n          (\n            <link\n              rel=\"alternate\"\n              type=\"application/activity+json\"\n              href={activityLink.toString()}\n              title=\"ActivityPub\"\n            />\n          )}\n        {feedLink && (\n          <link\n            rel=\"alternate\"\n            type=\"application/atom+xml\"\n            href={feedLink.toString()}\n            title=\"Atom feed\"\n          />\n        )}\n        <link\n          rel=\"stylesheet\"\n          href={`https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/${cssFilename}`}\n        />\n        <style dangerouslySetInnerHTML={{ __html: bot.pages.css }} />\n      </head>\n      <body>\n        {children}\n      </body>\n    </html>\n  );\n}\n"],"mappings":";;;;;;;AA4BA,SAAgB,OACd,EAAE,KAAK,MAAM,OAAO,cAAc,UAAU,UAAuB,EACnE;CACA,MAAM,UAAU,GAAG,IAAI,SAAS,GAAG,KAAK;CACxC,MAAM,cAAc,IAAI,MAAM,UAAU,WACnC,iBACA,OAAO,IAAI,MAAM,MAAM;AAC5B,wBACE,KAAC,qCACC,KAAC;kBACC,IAAC,UAAK,SAAQ,UAAU;kBACxB,KAAC,sBACE,SAAS,SAAS,EAAE,MAAM,MAC1B,IAAI,QAAQ,OAAO,UAAU,EAAE,IAAI,KAAK,IAAI,OAAO,MAC9C;EACP,gCAEG,IAAC;GACC,KAAI;GACJ,MAAK;GACL,MAAM,aAAa,UAAU;GAC7B,OAAM;IACN;EAEL,4BACC,IAAC;GACC,KAAI;GACJ,MAAK;GACL,MAAM,SAAS,UAAU;GACzB,OAAM;IACN;kBAEJ,IAAC;GACC,KAAI;GACJ,OAAO,mDAAmD,YAAY;IACtE;kBACF,IAAC,WAAM,yBAAyB,EAAE,QAAQ,IAAI,MAAM,IAAK,IAAI;KACxD,kBACP,IAAC,UACE,WACI,IACF;AAEV"}

package/dist/components/Message.d.ts

@@ -2,7 +2,7 @@ import { Temporal, toTemporalInstant } from "@js-temporal/polyfill";
 Date.prototype.toTemporalInstant = toTemporalInstant;
 import { MessageClass } from "../message.js";
 import { Session } from "../session.js";
-import * as hono_utils_html3 from "hono/utils/html";
+import * as hono_utils_html4 from "hono/utils/html";
 
 //#region src/components/Message.d.ts
 interface MessageProps {
@@ -12,7 +12,7 @@ interface MessageProps {
 declare function Message({
   session,
   message
-}: MessageProps): Promise<hono_utils_html3.HtmlEscapedString>;
+}: MessageProps): Promise<hono_utils_html4.HtmlEscapedString>;
 declare function renderCustomEmojis(html: string, emojis: Record<string, string>): string;
 //# sourceMappingURL=Message.d.ts.map
 

package/dist/deno.js

@@ -4,7 +4,7 @@
     
 //#region deno.json
 var name = "@fedify/botkit";
-var version = "0.5.0-dev.210+b2371c7b";
+var version = "0.5.0-dev.226+7cde32c7";
 var license = "AGPL-3.0-only";
 var exports = {
 	".": "./src/mod.ts",
@@ -12,6 +12,7 @@ var exports = {
 	"./emoji": "./src/emoji.ts",
 	"./events": "./src/events.ts",
 	"./follow": "./src/follow.ts",
+	"./instance": "./src/instance.ts",
 	"./message": "./src/message.ts",
 	"./poll": "./src/poll.ts",
 	"./reaction": "./src/reaction.ts",
@@ -43,16 +44,6 @@ var fmt = { "exclude": [
 	"*.yml",
 	"src/static/*.ts"
 ] };
-var tasks = {
-	"test": "deno test --allow-env=NODE_V8_COVERAGE,JEST_WORKER_ID --allow-net=hollo.social --parallel",
-	"test:node": "pnpm install && pnpm test",
-	"test-all": { "dependencies": [
-		"check",
-		"test",
-		"test:node"
-	] },
-	"coverage": "deno task test --coverage --clean && deno coverage --html"
-};
 var deno_default = {
 	name,
 	version,
@@ -60,8 +51,7 @@ var deno_default = {
 	exports,
 	imports,
 	exclude,
-	fmt,
-	tasks
+	fmt
 };
 
 //#endregion