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

package/dist/repository.d.ts

@@ -11,28 +11,41 @@ import { Actor, Announce, Announce as Announce$1, Create, Create as Create$1, Fo
 type Uuid = ReturnType<typeof crypto.randomUUID>;
 /**
  * A repository for storing bot data.
+ *
+ * Since BotKit 0.5.0, a single repository can store data for multiple bot
+ * actors hosted on the same instance.  Every method takes the identifier of
+ * the bot actor that owns the data as its first parameter, and data belonging
+ * to different identifiers are completely isolated from each other.
+ *
+ * If you deal with a single bot actor, you can use
+ * the {@link Repository.forIdentifier} method to get
+ * an {@link ActorScopedRepository} view which binds the identifier once.
  * @since 0.3.0
  */
 interface Repository {
   /**
-   * Sets the key pairs of the bot actor.
+   * Sets the key pairs of a bot actor.
+   * @param identifier The identifier of the bot actor that owns the key pairs.
    * @param keyPairs The key pairs to set.
    */
-  setKeyPairs(keyPairs: CryptoKeyPair[]): Promise<void>;
+  setKeyPairs(identifier: string, keyPairs: CryptoKeyPair[]): Promise<void>;
   /**
-   * Gets the key pairs of the bot actor.
+   * Gets the key pairs of a bot actor.
+   * @param identifier The identifier of the bot actor that owns the key pairs.
    * @returns The key pairs of the bot actor. If the key pairs do not exist,
    *          `undefined` will be returned.
    */
-  getKeyPairs(): Promise<CryptoKeyPair[] | undefined>;
+  getKeyPairs(identifier: string): Promise<CryptoKeyPair[] | undefined>;
   /**
    * Adds a message to the repository.
+   * @param identifier The identifier of the bot actor that owns the message.
    * @param id The UUID of the message.
    * @param activity The activity to add.
    */
-  addMessage(id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
+  addMessage(identifier: string, id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
   /**
    * Updates a message in the repository.
+   * @param identifier The identifier of the bot actor that owns the message.
    * @param id The UUID of the message.
    * @param updater The function to update the message.  The function will be
    *                called with the existing message, and the return value will
@@ -44,6 +57,243 @@ interface Repository {
    * @returns `true` if the message was updated, `false` if the message does not
    *          exist.
    */
+  updateMessage(identifier: string, id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
+  /**
+   * Removes a message from the repository.
+   * @param identifier The identifier of the bot actor that owns the message.
+   * @param id The UUID of the message to remove.
+   * @returns The removed activity.  If the message does not exist, `undefined`
+   *          will be returned.
+   */
+  removeMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  /**
+   * Gets messages from the repository.
+   * @param identifier The identifier of the bot actor that owns the messages.
+   * @param options The options for getting messages.
+   * @returns An async iterable of message activities.
+   */
+  getMessages(identifier: string, options?: RepositoryGetMessagesOptions): AsyncIterable<Create$1 | Announce$1>;
+  /**
+   * Gets a message from the repository.
+   * @param identifier The identifier of the bot actor that owns the message.
+   * @param id The UUID of the message to get.
+   * @returns The message activity, or `undefined` if the message does not
+   *          exist.
+   */
+  getMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  /**
+   * Counts the number of messages in the repository.
+   * @param identifier The identifier of the bot actor that owns the messages.
+   * @returns The number of messages in the repository.
+   */
+  countMessages(identifier: string): Promise<number>;
+  /**
+   * Adds a follower to the repository.
+   * @param identifier The identifier of the bot actor that is followed.
+   * @param followId The URL of the follow request.
+   * @param follower The actor who follows the bot.
+   */
+  addFollower(identifier: string, followId: URL, follower: Actor): Promise<void>;
+  /**
+   * Removes a follower from the repository.
+   * @param identifier The identifier of the bot actor that is followed.
+   * @param followId The URL of the follow request.
+   * @param followerId The ID of the actor to remove.
+   * @returns The removed actor.  If the follower does not exist or the follow
+   *          request is not about the follower, `undefined` will be returned.
+   */
+  removeFollower(identifier: string, followId: URL, followerId: URL): Promise<Actor | undefined>;
+  /**
+   * Checks if the repository has a follower.
+   * @param identifier The identifier of the bot actor that is followed.
+   * @param followerId The ID of the follower to check.
+   * @returns `true` if the repository has the follower, `false` otherwise.
+   */
+  hasFollower(identifier: string, followerId: URL): Promise<boolean>;
+  /**
+   * Gets followers from the repository.
+   * @param identifier The identifier of the bot actor that is followed.
+   * @param options The options for getting followers.
+   * @returns An async iterable of actors who follow the bot.
+   */
+  getFollowers(identifier: string, options?: RepositoryGetFollowersOptions): AsyncIterable<Actor>;
+  /**
+   * Counts the number of followers in the repository.
+   * @param identifier The identifier of the bot actor that is followed.
+   * @returns The number of followers in the repository.
+   */
+  countFollowers(identifier: string): Promise<number>;
+  /**
+   * Adds a sent follow request to the repository.
+   * @param identifier The identifier of the bot actor that sent the follow
+   *                   request.
+   * @param id The UUID of the follow request.
+   * @param follow The follow activity to add.
+   */
+  addSentFollow(identifier: string, id: Uuid, follow: Follow): Promise<void>;
+  /**
+   * Removes a sent follow request from the repository.
+   * @param identifier The identifier of the bot actor that sent the follow
+   *                   request.
+   * @param id The UUID of the follow request to remove.
+   * @returns The removed follow activity.  If the follow request does not
+   *          exist, `undefined` will be returned.
+   */
+  removeSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  /**
+   * Gets a sent follow request from the repository.
+   * @param identifier The identifier of the bot actor that sent the follow
+   *                   request.
+   * @param id The UUID of the follow request to get.
+   * @returns The `Follow` activity, or `undefined` if the follow request does
+   *          not exist.
+   */
+  getSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  /**
+   * Adds a followee to the repository.
+   * @param identifier The identifier of the bot actor that follows
+   *                   the followee.
+   * @param followeeId The ID of the followee to add.
+   * @param follow The follow activity to add.
+   */
+  addFollowee(identifier: string, followeeId: URL, follow: Follow): Promise<void>;
+  /**
+   * Removes a followee from the repository.
+   * @param identifier The identifier of the bot actor that follows
+   *                   the followee.
+   * @param followeeId The ID of the followee to remove.
+   * @returns The `Follow` activity that was removed.  If the followee does not
+   *          exist, `undefined` will be returned.
+   */
+  removeFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  /**
+   * Gets a followee from the repository.
+   * @param identifier The identifier of the bot actor that follows
+   *                   the followee.
+   * @param followeeId The ID of the followee to get.
+   * @returns The `Follow` activity, or `undefined` if the followee does not
+   *          exist.
+   */
+  getFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  /**
+   * Finds the identifiers of the bot actors that follow the given actor.
+   * This is the reverse lookup of {@link Repository.getFollowee}: it answers
+   * the question “which bots on this instance follow this remote actor?”,
+   * which is used for routing incoming activities from followed actors to
+   * the right bots.
+   * @param followeeId The ID of the followee to look up.
+   * @returns An async iterable of the identifiers of the bot actors that
+   *          follow the given actor.  If no bots follow the actor, an empty
+   *          iterable will be returned.
+   * @since 0.5.0
+   */
+  findFollowedBots(followeeId: URL): AsyncIterable<string>;
+  /**
+   * Records a vote in a poll.  If the same voter had already voted for the
+   * same option in a poll, the vote will be silently ignored.
+   * @param identifier The identifier of the bot actor that owns the poll.
+   * @param messageId The UUID of the poll message to vote on.
+   * @param voterId The ID of the voter.  It should be a URL of the actor who is
+   *                voting.
+   * @param option The option that the voter is voting for.  It should be one of
+   *               the options in the poll.  If the poll allows multiple
+   *               selections, this should be a single option that the voter is
+   *               voting for, which is one of multiple calls to this method.
+   * @since 0.3.0
+   */
+  vote(identifier: string, messageId: Uuid, voterId: URL, option: string): Promise<void>;
+  /**
+   * Counts the number of voters in a poll.  Even if the poll allows multiple
+   * selections, each voter is counted only once.
+   * @param identifier The identifier of the bot actor that owns the poll.
+   * @param messageId The UUID of the poll message to count voters for.
+   * @returns The number of voters in the poll.  If the poll does not exist,
+   *          0 will be returned.
+   * @since 0.3.0
+   */
+  countVoters(identifier: string, messageId: Uuid): Promise<number>;
+  /**
+   * Counts the votes for each option in a poll.  If the poll allows multiple
+   * selections, each option is counted separately, and the same voter can
+   * vote for multiple options.
+   * @param identifier The identifier of the bot actor that owns the poll.
+   * @param messageId The UUID of the poll message to count votes for.
+   * @returns A record where the keys are the options and the values are
+   *          the number of votes for each option.  If the poll does not exist,
+   *          an empty record will be returned.  Some options may not be
+   *          present in the record if no votes were cast for them.
+   * @since 0.3.0
+   */
+  countVotes(identifier: string, messageId: Uuid): Promise<Readonly<Record<string, number>>>;
+  /**
+   * Returns a view of this repository which is scoped to the given bot actor
+   * identifier.  The returned view exposes the same operations without
+   * the `identifier` parameter.
+   * @param identifier The identifier of the bot actor to scope the view to.
+   * @returns The scoped repository view.
+   * @since 0.5.0
+   */
+  forIdentifier(identifier: string): ActorScopedRepository;
+  /**
+   * Migrates data stored by BotKit 0.4 or earlier, which was not scoped by
+   * bot actor identifiers, so that it belongs to the given identifier.
+   * Implementations should make this operation idempotent: calling it again
+   * after a successful migration should be a no-op.
+   *
+   * This method is optional; repositories which have no legacy data format
+   * do not need to implement it.
+   * @param identifier The identifier of the bot actor that adopts the legacy
+   *                   data.
+   * @since 0.5.0
+   */
+  migrate?(identifier: string): Promise<void>;
+}
+/**
+ * A view of a {@link Repository} which is scoped to a single bot actor
+ * identifier.  It exposes the same operations as {@link Repository} without
+ * the `identifier` parameter, which is bound at construction time.
+ * @since 0.5.0
+ */
+declare class ActorScopedRepository {
+  /**
+   * The underlying repository.
+   */
+  readonly repository: Repository;
+  /**
+   * The identifier of the bot actor this view is scoped to.
+   */
+  readonly identifier: string;
+  /**
+   * Creates a new scoped repository view.
+   * @param repository The underlying repository.
+   * @param identifier The identifier of the bot actor to scope the view to.
+   */
+  constructor(repository: Repository, identifier: string);
+  /**
+   * Sets the key pairs of the bot actor.
+   * @param keyPairs The key pairs to set.
+   */
+  setKeyPairs(keyPairs: CryptoKeyPair[]): Promise<void>;
+  /**
+   * Gets the key pairs of the bot actor.
+   * @returns The key pairs of the bot actor. If the key pairs do not exist,
+   *          `undefined` will be returned.
+   */
+  getKeyPairs(): Promise<CryptoKeyPair[] | undefined>;
+  /**
+   * Adds a message to the repository.
+   * @param id The UUID of the message.
+   * @param activity The activity to add.
+   */
+  addMessage(id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
+  /**
+   * Updates a message in the repository.
+   * @param id The UUID of the message.
+   * @param updater The function to update the message.  See also
+   *                {@link Repository.updateMessage}.
+   * @returns `true` if the message was updated, `false` if the message does not
+   *          exist.
+   */
   updateMessage(id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
   /**
    * Removes a message from the repository.
@@ -145,13 +395,8 @@ interface Repository {
    * Records a vote in a poll.  If the same voter had already voted for the
    * same option in a poll, the vote will be silently ignored.
    * @param messageId The UUID of the poll message to vote on.
-   * @param voterId The ID of the voter.  It should be a URL of the actor who is
-   *                voting.
-   * @param option The option that the voter is voting for.  It should be one of
-   *               the options in the poll.  If the poll allows multiple
-   *               selections, this should be a single option that the voter is
-   *               voting for, which is one of multiple calls to this method.
-   * @since 0.3.0
+   * @param voterId The ID of the voter.
+   * @param option The option that the voter is voting for.
    */
   vote(messageId: Uuid, voterId: URL, option: string): Promise<void>;
   /**
@@ -160,19 +405,14 @@ interface Repository {
    * @param messageId The UUID of the poll message to count voters for.
    * @returns The number of voters in the poll.  If the poll does not exist,
    *          0 will be returned.
-   * @since 0.3.0
    */
   countVoters(messageId: Uuid): Promise<number>;
   /**
-   * Counts the votes for each option in a poll.  If the poll allows multiple
-   * selections, each option is counted separately, and the same voter can
-   * vote for multiple options.
+   * Counts the votes for each option in a poll.
    * @param messageId The UUID of the poll message to count votes for.
    * @returns A record where the keys are the options and the values are
-   *          the number of votes for each option.  If the poll does not exist,
-   *          an empty record will be returned.  Some options may not be
-   *          present in the record if no votes were cast for them.
-   * @since 0.3.0
+   *          the number of votes for each option.  See also
+   *          {@link Repository.countVotes}.
    */
   countVotes(messageId: Uuid): Promise<Readonly<Record<string, number>>>;
 }
@@ -218,116 +458,110 @@ interface RepositoryGetFollowersOptions {
   readonly limit?: number;
 }
 /**
- * The prefixes for key-value store keys used by the bot.
- * @since 0.3.0
+ * Options for creating a {@link KvRepository}.
+ * @since 0.5.0
  */
-interface KvStoreRepositoryPrefixes {
-  /**
-   * The key prefix used for storing the key pairs of the bot actor.
-   * @default `["_botkit", "keyPairs"]`
-   */
-  readonly keyPairs: KvKey$1;
+interface KvRepositoryOptions {
   /**
-   * The key prefix used for storing published messages.
-   * @default `["_botkit", "messages"]`
+   * The key prefix under which all BotKit data is stored.  Data belonging to
+   * a bot actor is stored under `[...prefix, "bots", identifier, ...]`, and
+   * instance-wide indices are stored under `[...prefix, "index", ...]`.
+   * @default `["_botkit"]`
    */
-  readonly messages: KvKey$1;
-  /**
-   * The key prefix used for storing followers.
-   * @default `["_botkit", "followers"]`
-   */
-  readonly followers: KvKey$1;
-  /**
-   * The key prefix used for storing incoming follow requests.
-   * @default `["_botkit", "followRequests"]`
-   */
-  readonly followRequests: KvKey$1;
-  /**
-   * The key prefix used for storing followees.
-   * @default `["_botkit", "followees"]`
-   */
-  readonly followees: KvKey$1;
-  /**
-   * The key prefix used for storing outgoing follow requests.
-   * @default `["_botkit", "follows"]`
-   */
-  readonly follows: KvKey$1;
-  /**
-   * The key prefix used for storing poll votes.
-   * @default `["_botkit", "polls"]`
-   * @since 0.3.0
-   */
-  readonly polls: KvKey$1;
+  readonly prefix?: KvKey$1;
 }
 /**
  * A repository for storing bot data using a key-value store.
  */
 declare class KvRepository implements Repository {
+  #private;
   readonly kv: KvStore$1;
-  readonly prefixes: KvStoreRepositoryPrefixes;
+  /**
+   * The key prefix under which all BotKit data is stored.
+   * @since 0.5.0
+   */
+  readonly prefix: KvKey$1;
   /**
    * Creates a new key-value store repository.
    * @param kv The key-value store to use.
-   * @param prefixes The prefixes for key-value store keys.
-   */
-  constructor(kv: KvStore$1, prefixes?: KvStoreRepositoryPrefixes);
-  setKeyPairs(keyPairs: CryptoKeyPair[]): Promise<void>;
-  getKeyPairs(): Promise<CryptoKeyPair[] | undefined>;
-  addMessage(id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
-  updateMessage(id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
-  removeMessage(id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
-  getMessages(options?: RepositoryGetMessagesOptions): AsyncIterable<Create$1 | Announce$1>;
-  getMessage(id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
-  countMessages(): Promise<number>;
-  addFollower(followRequestId: URL, follower: Actor): Promise<void>;
-  removeFollower(followRequestId: URL, actorId: URL): Promise<Actor | undefined>;
-  hasFollower(followerId: URL): Promise<boolean>;
-  getFollowers(options?: RepositoryGetFollowersOptions): AsyncIterable<Actor>;
-  countFollowers(): Promise<number>;
-  addSentFollow(id: Uuid, follow: Follow): Promise<void>;
-  removeSentFollow(id: Uuid): Promise<Follow | undefined>;
-  getSentFollow(id: Uuid): Promise<Follow | undefined>;
-  addFollowee(followeeId: URL, follow: Follow): Promise<void>;
-  removeFollowee(followeeId: URL): Promise<Follow | undefined>;
-  getFollowee(followeeId: URL): Promise<Follow | undefined>;
-  vote(messageId: Uuid, voterId: URL, option: string): Promise<void>;
-  countVoters(messageId: Uuid): Promise<number>;
-  countVotes(messageId: Uuid): Promise<Readonly<Record<string, number>>>;
+   * @param options The options for the repository.
+   */
+  constructor(kv: KvStore$1, options?: KvRepositoryOptions);
+  /**
+   * Migrates data stored by BotKit 0.4 or earlier, which was not scoped by
+   * bot actor identifiers, so that it belongs to the given identifier.
+   *
+   * The legacy data can be adopted by exactly one identifier.  The adopter
+   * is claimed atomically (through a compare-and-set operation when the
+   * underlying store supports one) before anything is copied, so that
+   * reusing the repository for another bot, even concurrently, does not
+   * adopt the same rows again.  Legacy keys are copied, not moved, and
+   * the completion is recorded last, so a partially failed run is simply
+   * retried by the adopter on the next call without data loss.  Followees
+   * are also entered into the reverse lookup index used by
+   * {@link KvRepository.findFollowedBots}.
+   *
+   * Calling this method again after a successful migration is a no-op.
+   * @param identifier The identifier of the bot actor that adopts the legacy
+   *                   data.
+   * @since 0.5.0
+   */
+  migrate(identifier: string): Promise<void>;
+  setKeyPairs(identifier: string, keyPairs: CryptoKeyPair[]): Promise<void>;
+  getKeyPairs(identifier: string): Promise<CryptoKeyPair[] | undefined>;
+  addMessage(identifier: string, id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
+  updateMessage(identifier: string, id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
+  removeMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  getMessages(identifier: string, options?: RepositoryGetMessagesOptions): AsyncIterable<Create$1 | Announce$1>;
+  getMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  countMessages(identifier: string): Promise<number>;
+  addFollower(identifier: string, followRequestId: URL, follower: Actor): Promise<void>;
+  removeFollower(identifier: string, followRequestId: URL, actorId: URL): Promise<Actor | undefined>;
+  hasFollower(identifier: string, followerId: URL): Promise<boolean>;
+  getFollowers(identifier: string, options?: RepositoryGetFollowersOptions): AsyncIterable<Actor>;
+  countFollowers(identifier: string): Promise<number>;
+  addSentFollow(identifier: string, id: Uuid, follow: Follow): Promise<void>;
+  removeSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  getSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  addFollowee(identifier: string, followeeId: URL, follow: Follow): Promise<void>;
+  removeFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  getFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  findFollowedBots(followeeId: URL): AsyncIterable<string>;
+  vote(identifier: string, messageId: Uuid, voterId: URL, option: string): Promise<void>;
+  countVoters(identifier: string, messageId: Uuid): Promise<number>;
+  countVotes(identifier: string, messageId: Uuid): Promise<Readonly<Record<string, number>>>;
+  forIdentifier(identifier: string): ActorScopedRepository;
 }
 /**
  * A repository for storing bot data in memory.  This repository is not
  * persistent and is only suitable for testing or development.
  */
 declare class MemoryRepository implements Repository {
-  keyPairs?: CryptoKeyPair[];
-  messages: Map<Uuid, Create$1 | Announce$1>;
-  followers: Map<string, Actor>;
-  followRequests: Record<string, string>;
-  sentFollows: Record<string, Follow>;
-  followees: Record<string, Follow>;
-  polls: Record<Uuid, Record<string, Set<string>>>;
-  setKeyPairs(keyPairs: CryptoKeyPair[]): Promise<void>;
-  getKeyPairs(): Promise<CryptoKeyPair[] | undefined>;
-  addMessage(id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
-  updateMessage(id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
-  removeMessage(id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
-  getMessages(options?: RepositoryGetMessagesOptions): AsyncIterable<Create$1 | Announce$1>;
-  getMessage(id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
-  countMessages(): Promise<number>;
-  addFollower(followId: URL, follower: Actor): Promise<void>;
-  removeFollower(followId: URL, followerId: URL): Promise<Actor | undefined>;
-  hasFollower(followerId: URL): Promise<boolean>;
-  getFollowers(options?: RepositoryGetFollowersOptions): AsyncIterable<Actor>;
-  countFollowers(): Promise<number>;
-  addSentFollow(id: Uuid, follow: Follow): Promise<void>;
-  removeSentFollow(id: Uuid): Promise<Follow | undefined>;
-  getSentFollow(id: Uuid): Promise<Follow | undefined>;
-  addFollowee(followeeId: URL, follow: Follow): Promise<void>;
-  removeFollowee(followeeId: URL): Promise<Follow | undefined>;
-  getFollowee(followeeId: URL): Promise<Follow | undefined>;
-  vote(messageId: Uuid, voterId: URL, option: string): Promise<void>;
-  countVoters(messageId: Uuid): Promise<number>;
-  countVotes(messageId: Uuid): Promise<Readonly<Record<string, number>>>;
+  #private;
+  setKeyPairs(identifier: string, keyPairs: CryptoKeyPair[]): Promise<void>;
+  getKeyPairs(identifier: string): Promise<CryptoKeyPair[] | undefined>;
+  addMessage(identifier: string, id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
+  updateMessage(identifier: string, id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
+  removeMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  getMessages(identifier: string, options?: RepositoryGetMessagesOptions): AsyncIterable<Create$1 | Announce$1>;
+  getMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  countMessages(identifier: string): Promise<number>;
+  addFollower(identifier: string, followId: URL, follower: Actor): Promise<void>;
+  removeFollower(identifier: string, followId: URL, followerId: URL): Promise<Actor | undefined>;
+  hasFollower(identifier: string, followerId: URL): Promise<boolean>;
+  getFollowers(identifier: string, options?: RepositoryGetFollowersOptions): AsyncIterable<Actor>;
+  countFollowers(identifier: string): Promise<number>;
+  addSentFollow(identifier: string, id: Uuid, follow: Follow): Promise<void>;
+  removeSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  getSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  addFollowee(identifier: string, followeeId: URL, follow: Follow): Promise<void>;
+  removeFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  getFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  findFollowedBots(followeeId: URL): AsyncIterable<string>;
+  vote(identifier: string, messageId: Uuid, voterId: URL, option: string): Promise<void>;
+  countVoters(identifier: string, messageId: Uuid): Promise<number>;
+  countVotes(identifier: string, messageId: Uuid): Promise<Readonly<Record<string, number>>>;
+  forIdentifier(identifier: string): ActorScopedRepository;
 }
 /**
  * A repository decorator that adds an in-memory cache layer on top of another
@@ -335,9 +569,10 @@ declare class MemoryRepository implements Repository {
  * of accesses to the underlying persistent storage, but it increases memory
  * usage. The cache is not persistent and will be lost when the process exits.
  *
- * Note: List operations like `getMessages` and `getFollowers`, and count
- * operations like `countMessages` and `countFollowers` are not cached and
- * always delegate to the underlying repository.
+ * Note: List operations like `getMessages` and `getFollowers`, count
+ * operations like `countMessages` and `countFollowers`, and reverse lookups
+ * like `findFollowedBots` are not cached and always delegate to the
+ * underlying repository.
  * @since 0.3.0
  */
 declare class MemoryCachedRepository implements Repository {
@@ -350,30 +585,42 @@ declare class MemoryCachedRepository implements Repository {
    *              If not provided, a new one will be created internally.
    */
   constructor(underlying: Repository, cache?: MemoryRepository);
-  setKeyPairs(keyPairs: CryptoKeyPair[]): Promise<void>;
-  getKeyPairs(): Promise<CryptoKeyPair[] | undefined>;
-  addMessage(id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
-  updateMessage(id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
-  removeMessage(id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
-  getMessages(options?: RepositoryGetMessagesOptions): AsyncIterable<Create$1 | Announce$1>;
-  getMessage(id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
-  countMessages(): Promise<number>;
-  addFollower(followId: URL, follower: Actor): Promise<void>;
-  removeFollower(followId: URL, followerId: URL): Promise<Actor | undefined>;
-  hasFollower(followerId: URL): Promise<boolean>;
-  getFollowers(options?: RepositoryGetFollowersOptions): AsyncIterable<Actor>;
-  countFollowers(): Promise<number>;
-  addSentFollow(id: Uuid, follow: Follow): Promise<void>;
-  removeSentFollow(id: Uuid): Promise<Follow | undefined>;
-  getSentFollow(id: Uuid): Promise<Follow | undefined>;
-  addFollowee(followeeId: URL, follow: Follow): Promise<void>;
-  removeFollowee(followeeId: URL): Promise<Follow | undefined>;
-  getFollowee(followeeId: URL): Promise<Follow | undefined>;
-  vote(messageId: Uuid, voterId: URL, option: string): Promise<void>;
-  countVoters(messageId: Uuid): Promise<number>;
-  countVotes(messageId: Uuid): Promise<Readonly<Record<string, number>>>;
+  setKeyPairs(identifier: string, keyPairs: CryptoKeyPair[]): Promise<void>;
+  getKeyPairs(identifier: string): Promise<CryptoKeyPair[] | undefined>;
+  addMessage(identifier: string, id: Uuid, activity: Create$1 | Announce$1): Promise<void>;
+  updateMessage(identifier: string, id: Uuid, updater: (existing: Create$1 | Announce$1) => Create$1 | Announce$1 | undefined | Promise<Create$1 | Announce$1 | undefined>): Promise<boolean>;
+  removeMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  getMessages(identifier: string, options?: RepositoryGetMessagesOptions): AsyncIterable<Create$1 | Announce$1>;
+  getMessage(identifier: string, id: Uuid): Promise<Create$1 | Announce$1 | undefined>;
+  countMessages(identifier: string): Promise<number>;
+  addFollower(identifier: string, followId: URL, follower: Actor): Promise<void>;
+  removeFollower(identifier: string, followId: URL, followerId: URL): Promise<Actor | undefined>;
+  hasFollower(identifier: string, followerId: URL): Promise<boolean>;
+  getFollowers(identifier: string, options?: RepositoryGetFollowersOptions): AsyncIterable<Actor>;
+  countFollowers(identifier: string): Promise<number>;
+  addSentFollow(identifier: string, id: Uuid, follow: Follow): Promise<void>;
+  removeSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  getSentFollow(identifier: string, id: Uuid): Promise<Follow | undefined>;
+  addFollowee(identifier: string, followeeId: URL, follow: Follow): Promise<void>;
+  removeFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  getFollowee(identifier: string, followeeId: URL): Promise<Follow | undefined>;
+  findFollowedBots(followeeId: URL): AsyncIterable<string>;
+  vote(identifier: string, messageId: Uuid, voterId: URL, option: string): Promise<void>;
+  countVoters(identifier: string, messageId: Uuid): Promise<number>;
+  countVotes(identifier: string, messageId: Uuid): Promise<Readonly<Record<string, number>>>;
+  forIdentifier(identifier: string): ActorScopedRepository;
+  /**
+   * Migrates data stored by BotKit 0.4 or earlier in the underlying
+   * repository, so that it belongs to the given identifier.  The cache is
+   * not involved: it starts empty and only ever holds values read after
+   * the migration.
+   * @param identifier The identifier of the bot actor that adopts the
+   *                   legacy data.
+   * @since 0.5.0
+   */
+  migrate(identifier: string): Promise<void>;
 }
 //# sourceMappingURL=repository.d.ts.map
 //#endregion
-export { Announce, Create, KvKey, KvRepository, KvStore, KvStoreRepositoryPrefixes, MemoryCachedRepository, MemoryRepository, Repository, RepositoryGetFollowersOptions, RepositoryGetMessagesOptions, Uuid };
+export { ActorScopedRepository, Announce, Create, KvKey, KvRepository, KvRepositoryOptions, KvStore, MemoryCachedRepository, MemoryRepository, Repository, RepositoryGetFollowersOptions, RepositoryGetMessagesOptions, Uuid };
 //# sourceMappingURL=repository.d.ts.map