@seedcord/gateway 0.3.0 → 0.4.0

package/dist/index.d.mts

@@ -1,11 +1,13 @@
 import "reflect-metadata";
-import { AnyCustomId, AutocompletableNames, AutocompleteRouteBrand, BaseReplySender, CacheFor, ChoiceValueOf, ComponentDefsBrand, ComponentKindBrand, ContextMenuKindBrand, ContextMenuNamesBrand, EntryFor, FocusedField, GateFitsWith, HasComponentDefs, MatchArms, MenuCacheFor, ModalLike, NamesFor, PageCursor, SingleParams, SlashOptions as SlashOptions$1, SlashRouteBrand } from "@seedcord/core/internal";
-import { ArraySource as ArraySource$1, AutocompleteOptions, BaseHandler as BaseHandler$1, Bus, CoreBase, CursorSource as CursorSource$1, DispatchContext, Gate, GateContextBase, GateNoticeOptions, GuildPermissionsContext, Initializeable, Notice, PaginatorBase, PaginatorConfig, PermissionNoticeOverrides, PermissionScope, RepliableHandler as RepliableHandler$1, RequiredOf, ResolvedEmoji, SelectMenuKind, SlashRegistry, Subscriber as Subscriber$1, SubscriptionKey, WebhookLog as WebhookLog$1 } from "@seedcord/core";
+import { WinstonConsoleSink, WinstonFileSink } from "@seedcord/logger/node";
+import { AnyCustomId, AutocompletableNames, AutocompleteRouteBrand, CacheFor, ChoiceValueOf, ComponentDefsBrand, ComponentKindBrand, ContextMenuKindBrand, ContextMenuLeaves, ContextMenuNamesBrand, EntryFor, FocusedField, GateFitsWith, HasComponentDefs, Initializeable, MatchArms, MenuCacheFor, NamesFor, PageCursor, SingleParams, SlashOptions as SlashOptions$1, SlashRouteBrand } from "@seedcord/core/internal";
+import { ArraySourceBase, AutocompleteOptions, BaseHandler as BaseHandler$1, BaseReplySender, Bus, CoreBase, CursorSourceBase, DispatchContext, Gate, GateContextBase, GateNoticeOptions, GuildPermissionsContext, ModalLike, Notice, PageSourceBase, PaginatorBase, PaginatorConfig, PermissionNoticeOverrides, PermissionScope, RepliableHandler as RepliableHandler$1, RequiredOf, ResolvedEmoji, SelectMenuKind, SlashRegistry, Subscriber as Subscriber$1, SubscriptionKey, WebhookLog as WebhookLog$1 } from "@seedcord/core";
 import { Logger } from "@seedcord/logger";
-import { APIInteractionGuildMember, APIModalInteractionResponseCallbackData, AnySelectMenuInteraction, ApplicationCommandOptionChoiceData, ApplicationCommandType, ApplicationEmoji, AutocompleteInteraction, BaseMessageOptions, BooleanCache, ButtonInteraction, ButtonStyle, CacheType, CacheTypeReducer, ChannelSelectMenuInteraction, ChatInputCommandInteraction, Client, ClientEvents, ClientOptions, CommandInteractionOption, ContextMenuCommandInteraction, Events, Guild, GuildEmoji, GuildMember, Interaction, MentionableSelectMenuInteraction, Message, MessageContextMenuCommandInteraction, ModalSubmitInteraction, Role, RoleSelectMenuInteraction, StringSelectMenuInteraction, TextChannel, User, UserContextMenuCommandInteraction, UserSelectMenuInteraction } from "discord.js";
+import { APIInteractionGuildMember, APIModalInteractionResponseCallbackData, AnySelectMenuInteraction, ApplicationCommandOptionChoiceData, ApplicationCommandType, ApplicationEmoji, AutocompleteInteraction, BaseMessageOptions, BooleanCache, ButtonInteraction, ButtonStyle, CacheType, CacheTypeReducer, ChannelSelectMenuInteraction, ChatInputCommandInteraction, Client, ClientEvents, ClientOptions, CommandInteractionOption, ContextMenuCommandInteraction, Events, Guild, GuildEmoji, GuildMember, Interaction, MentionableSelectMenuInteraction, Message, MessageContextMenuCommandInteraction, ModalSubmitFields, ModalSubmitInteraction, Role, RoleSelectMenuInteraction, StringSelectMenuInteraction, TextChannel, User, UserContextMenuCommandInteraction, UserSelectMenuInteraction } from "discord.js";
 import { Plugin as Plugin$1, PluginLifecycleSpec, PluginOptions, PluginOptions as PluginOptions$1 } from "@seedcord/core/plugin";
-import { CoordinatedShutdown, CoordinatedStartup, Pluggable } from "@seedcord/core/node/internal";
-import { SeedcordBrand, SeedcordInstance } from "@seedcord/types/internal";
+import { CoordinatedShutdown, CoordinatedStartup, Pluggable } from "@seedcord/core/node";
+import { CommandRegistry } from "@seedcord/core/node/internal";
+import { HostAugmentTarget, HostVersion, SeedcordBrand, SeedcordInstance } from "@seedcord/types/internal";
 import { BotConfig, Config, DeferOpts, EmojiMap, EventFrequency, HealthCheckOption, HmrAware, HmrUpdateEvent, IRateLimiter, ReplyResponse, SendOpts, TypedOmit } from "@seedcord/types";
 import { REST } from "@discordjs/rest";
 export * from "@seedcord/errors";
@@ -22,8 +24,8 @@ declare module '@seedcord/core/internal' {
     unhandledEventError: {
       error: Error;
     };
-    /** Triggered for every client event the bot receives, before its handlers run. */
-    anyEvent: { [Name in keyof ClientEvents]: {
+    /** Triggered before an event's handlers run. An event that no handler registered never triggers it. */
+    eventDispatching: { [Name in keyof ClientEvents]: {
       name: Name;
       args: ClientEvents[Name];
     }; }[keyof ClientEvents];
@@ -76,37 +78,140 @@ interface GatewayConfig extends Config {
   healthCheck?: HealthCheckOption;
 }
 //#endregion
+//#region src/bot/controllers/EventDispatcher.d.ts
+/**
+ * Interactions route through InteractionDispatcher.
+ *
+ * @internal
+ */
+declare class EventDispatcher implements Initializeable, HmrAware {
+  protected core: Core;
+  private readonly logger;
+  private isInitialized;
+  private readonly eventMap;
+  private readonly middlewares;
+  private readonly executedOnceHandlers;
+  private readonly attachedEvents;
+  private readonly inFlight;
+  private draining;
+  private loading;
+  private readonly loadedHandlers;
+  private readonly loadedMiddlewares;
+  private readonly hmrHandler?;
+  constructor(core: Core);
+  private getArtifacts;
+  init(): Promise<void>;
+  private reportLoad;
+  private loadHandlers;
+  private loadMiddlewares;
+  /** @internal */
+  onHmr(event: HmrUpdateEvent): Promise<void>;
+  private unregisterHandler;
+  private unregisterMiddleware;
+  private registerMiddleware;
+  private runMiddlewares;
+  private isEventHandlerClass;
+  private isMiddlewareClass;
+  private registerHandler;
+  private attachToClient;
+  private attachListener;
+  stopAccepting(): void;
+  drain(timeoutMs: number): Promise<void>;
+  private processEvent;
+  private processHandler;
+}
+//#endregion
+//#region src/bot/controllers/InteractionDispatcher.d.ts
+declare class InteractionDispatcher implements Initializeable, HmrAware {
+  protected core: Core;
+  private readonly logger;
+  private isInitialized;
+  private readonly slashMap;
+  private readonly buttonMap;
+  private readonly modalMap;
+  private readonly stringSelectMap;
+  private readonly userSelectMap;
+  private readonly roleSelectMap;
+  private readonly channelSelectMap;
+  private readonly mentionableSelectMap;
+  private readonly messageContextMenuMap;
+  private readonly userContextMenuMap;
+  private readonly autocompleteMap;
+  private readonly handlerFiles;
+  private readonly keysToIgnore;
+  private readonly middlewares;
+  private readonly inFlight;
+  private draining;
+  private loading;
+  private readonly loadedHandlers;
+  private readonly loadedMiddlewares;
+  private readonly hmrHandler?;
+  private readonly routeTypes;
+  constructor(core: Core);
+  warnUnhandledRoutes(commandLeaves: Iterable<string>): void;
+  warnUnhandledContextMenuRoutes(leaves: ContextMenuLeaves): void;
+  private getArtifacts;
+  init(): Promise<void>;
+  private reportLoad;
+  private loadHandlers;
+  private loadMiddlewares;
+  private registerMiddleware;
+  private isHandlerClass;
+  private isMiddlewareClass;
+  private registerHandler;
+  onHmr(event: HmrUpdateEvent): Promise<void>;
+  private unregisterHandler;
+  private unregisterMiddleware;
+  private attachToClient;
+  stopAccepting(): void;
+  drain(timeoutMs: number): Promise<void>;
+  private handleCustomIdInteraction;
+  private processInteraction;
+  private answer;
+  private buildHandler;
+  private runMiddlewares;
+  private gateRefusal;
+  private handleInteraction;
+  private handleSlashCommand;
+  private handleButton;
+  private handleModal;
+  private handleStringSelectMenu;
+  private handleUserSelectMenu;
+  private handleRoleSelectMenu;
+  private handleChannelSelectMenu;
+  private handleMentionableSelectMenu;
+  private handleMessageContextMenu;
+  private handleUserContextMenu;
+  private handleAutocomplete;
+}
+//#endregion
 //#region src/bot/Bot.d.ts
+declare const loggerSlot: unique symbol;
+declare const initSlot: unique symbol;
+declare const controllersSlot: unique symbol;
+interface Controllers {
+  readonly interactions?: InteractionDispatcher | undefined;
+  readonly events?: EventDispatcher | undefined;
+  readonly commandRegistry?: CommandRegistry | undefined;
+}
 /**
  * The Discord client and its controllers. Access it through `core.bot`.
  */
-declare const loggerSlot: unique symbol;
-declare class Bot implements Initializeable, HmrAware {
+declare class Bot implements HmrAware {
+  #private;
   readonly botToken: string;
-  private readonly logger;
   /** @internal */
   readonly [loggerSlot]: Logger;
-  private isInitialized;
-  private readonly intents;
-  private readonly _client;
-  private readonly interactions?;
-  private readonly events?;
-  private readonly emojiInjector;
-  private readonly commandRegistry?;
   /** @internal */
   onHmr(event: HmrUpdateEvent): Promise<void>;
   /** @internal */
   constructor(core: Core);
-  private applicationId;
-  private registerShutdownTasks;
-  private stopAccepting;
-  private drain;
   /** @internal */
-  init(): Promise<void>;
+  get [controllersSlot](): Controllers;
   /** @internal */
-  stop(): Promise<void>;
-  private login;
-  private logout;
+  get applicationId(): string;
+  /** @internal */
+  [initSlot](): Promise<void>;
   get client(): Client;
 }
 //#endregion
@@ -739,9 +844,15 @@ declare abstract class SlashHandler<Route extends keyof SlashRegistry, Cache ext
   /** @internal */
   readonly [SlashRouteBrand]?: Route;
   /**
-   * The typed options for this command's route. Required options drop the null, choices narrow to their
-   * literal union, and only the getters for kinds this command actually uses appear. Use `this.event.options`
-   * directly for anything outside this view, such as narrowing a channel option by type.
+   * The typed options for this command's route. Only the getters for kinds this command declares appear.
+   * Each getter's name argument is restricted to that command's options of its kind.
+   *
+   * - A required option drops the null.
+   * - Choices narrow to their literal union.
+   * - A channel option declared with `addChannelTypes` narrows to those types.
+   *
+   * Use `this.event.options` directly for anything outside this view, such as `getSubcommand()`.
+   * However, for the common case, the methods in this would suffice.
    */
   protected get options(): SlashOptions<Route, Cache>;
   /**
@@ -761,8 +872,8 @@ declare abstract class SlashHandler<Route extends keyof SlashRegistry, Cache ext
    * class ModHandler extends SlashHandler<'ban' | 'kick'> {
    *     async execute() {
    *         await this.match({
-   *             ban: (options) => this.event.guild?.members.ban(options.getUser('target', true).id),
-   *             kick: (options) => this.event.guild?.members.kick(options.getUser('member', true).id)
+   *             ban: (options) => this.event.guild?.members.ban(options.getUser('target').id),
+   *             kick: (options) => this.event.guild?.members.kick(options.getUser('member').id)
    *         });
    *     }
    * }
@@ -772,6 +883,8 @@ declare abstract class SlashHandler<Route extends keyof SlashRegistry, Cache ext
 }
 //#endregion
 //#region src/handlers/interaction/ContextMenuHandler.d.ts
+type UserMenuArms<Names extends NamesFor<ApplicationCommandType.User>, Ret> = { [Name in Names]: (target: User, member: CacheTypeReducer<MenuCacheFor<ApplicationCommandType.User, Name>, GuildMember, APIInteractionGuildMember> | null) => Promisable<Ret>; };
+type MessageMenuArms<Names extends NamesFor<ApplicationCommandType.Message>, Ret> = { [Name in Names]: (target: Message<BooleanCache<MenuCacheFor<ApplicationCommandType.Message, Name>>>) => Promisable<Ret>; };
 /**
  * Base class for a user context-menu command handler (right-click a user).
  *
@@ -799,6 +912,34 @@ declare abstract class UserContextMenuHandler<Names extends NamesFor<Application
   protected get target(): User;
   /** The right-clicked user's guild member, null outside a guild. */
   protected get targetMember(): CacheTypeReducer<Cache, GuildMember, APIInteractionGuildMember> | null;
+  /** Which of the registered commands fired. */
+  protected get commandName(): Names;
+  /**
+   * Run the arm for whichever command fired. Use this only when the handler is registered for several
+   * names.
+   *
+   * Provide one arm per registered name, keyed by the name Discord shows in the right-click menu. Each
+   * arm receives the clicked user and that user's guild member, both narrowed to the cache state of that
+   * one command. The arms must cover every name in the generic. A missing name or an unknown key is a
+   * compile error.
+   *
+   * @param arms - One handler per registered command name.
+   * @returns The result of the arm that ran.
+   *
+   * @example
+   * ```ts
+   * \@UserContextMenuRoute('View Profile', 'Warn')
+   * class Moderation extends UserContextMenuHandler<'View Profile' | 'Warn'> {
+   *     async execute() {
+   *         await this.match({
+   *             'View Profile': (user) => this.reply(`Profile for ${user.tag}.`),
+   *             Warn: (user, member) => this.reply(`Warned ${member?.displayName ?? user.tag}.`)
+   *         });
+   *     }
+   * }
+   * ```
+   */
+  protected match<Ret>(arms: UserMenuArms<Names, Ret>): Promise<Ret>;
 }
 /**
  * Base class for a message context-menu command handler (right-click a message).
@@ -825,6 +966,33 @@ declare abstract class MessageContextMenuHandler<Names extends NamesFor<Applicat
   /** @internal */
   readonly [ContextMenuNamesBrand]?: Names;
   protected get target(): Message<BooleanCache<Cache>>;
+  /** Which of the registered commands fired. */
+  protected get commandName(): Names;
+  /**
+   * Run the arm for whichever command fired. Use this only when the handler is registered for several
+   * names.
+   *
+   * Provide one arm per registered name, keyed by the name Discord shows in the right-click menu. Each
+   * arm receives the clicked message, narrowed to the cache state of that one command. The arms must
+   * cover every name in the generic. A missing name or an unknown key is a compile error.
+   *
+   * @param arms - One handler per registered command name.
+   * @returns The result of the arm that ran.
+   *
+   * @example
+   * ```ts
+   * \@MessageContextMenuRoute('Report Message', 'Pin Message')
+   * class MessageTools extends MessageContextMenuHandler<'Report Message' | 'Pin Message'> {
+   *     async execute() {
+   *         await this.match({
+   *             'Report Message': (message) => this.report(message),
+   *             'Pin Message': (message) => message.pin()
+   *         });
+   *     }
+   * }
+   * ```
+   */
+  protected match<Ret>(arms: MessageMenuArms<Names, Ret>): Promise<Ret>;
 }
 //#endregion
 //#region src/handlers/interaction/AutocompleteHandler.d.ts
@@ -991,8 +1159,8 @@ declare abstract class ButtonHandler<Defs extends readonly AnyCustomId[], Cache
  *
  * Register the customId definitions this handler decodes with `@ModalRoute`, list the same ones in the
  * generic, then read `this.params` for a single route or `this.match` for several. Read the submitted
- * inputs from `this.event.fields`, and reply through the handler members. Discord forbids opening a modal in
- * response to a modal, so `showModal` fails compilation on this kind.
+ * inputs from `this.fields`. Reply through the handler members. `showModal` fails compilation on this kind,
+ * because Discord forbids opening a modal in response to a modal.
  *
  * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof ConfigId]`.
  * @typeParam Cache - The interaction cache state, `'cached'` by default.
@@ -1003,7 +1171,7 @@ declare abstract class ButtonHandler<Defs extends readonly AnyCustomId[], Cache
  * class ConfigModal extends ModalHandler<[typeof ConfigId]> {
  *     async execute() {
  *         const { guildId } = this.params;
- *         const name = this.event.fields.getTextInputValue('name');
+ *         const name = this.fields.getTextInputValue('name');
  *         await this.reply(`saved ${name} for ${guildId}`);
  *     }
  * }
@@ -1012,6 +1180,8 @@ declare abstract class ButtonHandler<Defs extends readonly AnyCustomId[], Cache
 declare abstract class ModalHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends ComponentHandler<ModalSubmitInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: 'modal';
+  /** The fields this modal submitted, read by custom id. */
+  protected get fields(): ModalSubmitFields<Cache>;
   /** Rewrite the message this modal was opened from. Throws when a command opened the modal. */
   protected update(response: GatewayReplyResponse | string): Promise<SentMessage>;
   /** Acknowledge the submit without changing the source message. Throws when a command opened the modal. */
@@ -1020,14 +1190,18 @@ declare abstract class ModalHandler<Defs extends readonly AnyCustomId[], Cache e
 }
 //#endregion
 //#region src/handlers/interaction/components/SelectMenuHandler.d.ts
+type SelectKey = 'values' | 'users' | 'members' | 'roles' | 'channels';
+type EventMember<Kind extends SelectMenuKind, Cache extends CacheType, Key extends SelectKey> = Key extends keyof SelectMenuInteractionFor<Kind, Cache> ? SelectMenuInteractionFor<Kind, Cache>[Key] : never;
 type SelectMenuInteractionFor<SelectMenu extends SelectMenuKind, Cache extends CacheType = CacheType> = SelectMenu extends SelectMenuKind.String ? StringSelectMenuInteraction<Cache> : SelectMenu extends SelectMenuKind.User ? UserSelectMenuInteraction<Cache> : SelectMenu extends SelectMenuKind.Role ? RoleSelectMenuInteraction<Cache> : SelectMenu extends SelectMenuKind.Channel ? ChannelSelectMenuInteraction<Cache> : SelectMenu extends SelectMenuKind.Mentionable ? MentionableSelectMenuInteraction<Cache> : never;
 /**
  * Base class for a select menu handler.
  *
- * Pass the select kind first and the customId definitions second, the same order as `@SelectMenuRoute`,
- * so `this.event` and `this.event.values` are narrowed to that kind. Read `this.params` for a single
- * route or `this.match` for several, and reply through the handler members or rewrite the source message
- * with `this.update`.
+ * Pass the select kind first and the customId definitions second, the same order as `@SelectMenuRoute`.
+ * Read the picked ids from `this.values`. The kind decides which of `this.users`, `this.members`,
+ * `this.roles`, and `this.channels` this handler carries. The rest are `never`.
+ *
+ * Read `this.params` for a single route or `this.match` for several. Reply through the handler members, or
+ * rewrite the source message with `this.update`.
  *
  * @typeParam Kind - The select kind from {@link SelectMenuKind}, e.g. `SelectMenuKind.User`.
  * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof AssignId]`.
@@ -1039,7 +1213,7 @@ type SelectMenuInteractionFor<SelectMenu extends SelectMenuKind, Cache extends C
  * class AssignSelect extends SelectMenuHandler<SelectMenuKind.User, [typeof AssignId]> {
  *     async execute() {
  *         const { roleId } = this.params;
- *         await this.reply(`assigning ${this.event.values.length} member(s) to <@&${roleId}>`);
+ *         await this.reply(`assigning ${this.users.size} member(s) to <@&${roleId}>`);
  *     }
  * }
  * ```
@@ -1047,6 +1221,17 @@ type SelectMenuInteractionFor<SelectMenu extends SelectMenuKind, Cache extends C
 declare abstract class SelectMenuHandler<Kind extends SelectMenuKind, Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends ComponentHandler<SelectMenuInteractionFor<Kind, Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: Kind;
+  private eventMember;
+  /** The ids this select picked. */
+  protected get values(): string[];
+  /** The users this select picked. */
+  protected get users(): EventMember<Kind, Cache, 'users'>;
+  /** The guild members behind the picked users. Discord resolves these only inside a guild. */
+  protected get members(): EventMember<Kind, Cache, 'members'>;
+  /** The roles this select picked. */
+  protected get roles(): EventMember<Kind, Cache, 'roles'>;
+  /** The channels this select picked. */
+  protected get channels(): EventMember<Kind, Cache, 'channels'>;
 }
 //#endregion
 //#region src/bot/decorators/Middlewares.d.ts
@@ -1152,7 +1337,7 @@ declare class GatewayEmoji<Source extends SavedEmojiType = SavedEmojiType> exten
 type InjectedEmojiMap = { [K in keyof EmojiMap]: EmojiMap[K] extends 'guild' ? GatewayEmoji<GuildEmoji> : GatewayEmoji<ApplicationEmoji>; };
 /**
  * The bot's resolved emojis, keyed by {@link EmojiMap}. Filled by {@link EmojiInjector} during startup.
- * A read before that throws.
+ * Throws if you read a key the injector did not fill.
  */
 declare const Emojis: InjectedEmojiMap;
 //#endregion
@@ -1344,7 +1529,7 @@ interface DefaultConfirmOptions extends ConfirmOptions {
  * \@SlashRoute('ban')
  * class BanHandler extends SlashHandler<'ban'> {
  *     async execute() {
- *         const target = this.options.getUser('target', true);
+ *         const target = this.options.getUser('target');
  *         if (!(await getConfirmation(this, `Ban ${target.tag}? This cannot be undone.`))) return;
  *         await this.event.guild?.members.ban(target.id);
  *     }
@@ -1395,7 +1580,7 @@ declare function getConfirmation(handler: RepliableHandler<NonModalInteraction>,
  *     }
  * }
  *
- * const target = this.options.getUser('target', true);
+ * const target = this.options.getUser('target');
  * const confirmed = await getConfirmation(
  *     this,
  *     (ids) => ({ components: [new BanPrompt(`Ban ${target.tag}?`).component, new ConfirmRow(ids).component] }),
@@ -1452,15 +1637,29 @@ declare class Paginator<Item, const Prefix extends string> extends PaginatorBase
   readonly Handler: PaginatorHandlerCtor<Prefix>;
   constructor(config: PaginatorConfig<Item, Prefix, PageContext>);
   /**
-   * Render page 0 and send it through the handler's sender, which picks reply, edit, or followUp from its
-   * ack state.
+   * Render a page as a {@link ReplyResponse} without sending anything.
+   *
+   * @param handler - The handler rendering the page, normally `this`.
+   * @param n - The zero-based page.
+   */
+  page(handler: RepliableHandler<Repliables>, n: number): Promise<ReplyResponse>;
+  /**
+   * Send a page through the handler's sender. The sender picks reply, edit, or followUp from its ack state.
    *
    * @param handler - The handler starting the paginator, normally `this`.
+   * @param n - The zero-based page to open on.
    */
-  start(handler: RepliableHandler<Repliables>): Promise<Message>;
+  start(handler: RepliableHandler<Repliables>, n?: number): Promise<SentMessage>;
 }
 //#endregion
 //#region src/pagination/sources.d.ts
+/**
+ * The one method a paginator calls on a source, once per click. Implement it for a source neither shipped
+ * one covers.
+ *
+ * @typeParam Item - The item type the source pages over.
+ */
+type PageSource<Item> = PageSourceBase<Item, PageContext>;
 /**
  * A source for a bounded list you can load whole. It loads the full list on every click, then slices the
  * page, so the real total is known (a real last button, "Page X of Y"). Cache inside your loader if the
@@ -1468,7 +1667,7 @@ declare class Paginator<Item, const Prefix extends string> extends PaginatorBase
  *
  * @typeParam Item - The item type, inferred from the loader's return.
  */
-declare class ArraySource<Item> extends ArraySource$1<Item, PageContext> {}
+declare class ArraySource<Item> extends ArraySourceBase<Item, PageContext> {}
 /**
  * A source for a large or unknown-length set you fetch one page at a time (SQL LIMIT/OFFSET, a paged API).
  * The fetcher receives the page index and the page size and reports whether a next page exists. A cursor
@@ -1477,7 +1676,7 @@ declare class ArraySource<Item> extends ArraySource$1<Item, PageContext> {}
  *
  * @typeParam Item - The item type, inferred from the fetcher's slice.
  */
-declare class CursorSource<Item> extends CursorSource$1<Item, PageContext> {}
+declare class CursorSource<Item> extends CursorSourceBase<Item, PageContext> {}
 //#endregion
 //#region src/subscribers/index.d.ts
 /**
@@ -1526,9 +1725,9 @@ declare class Seedcord extends Pluggable<'gateway', 'server'> implements Core, S
   /** @internal */
   readonly [SeedcordBrand] = true;
   /** @internal */
-  readonly augmentTarget = "@seedcord/gateway";
+  readonly [HostAugmentTarget] = "@seedcord/gateway";
   /** @internal */
-  readonly version: string;
+  readonly [HostVersion]: string;
   private readonly healthCheck?;
   private readonly hmrManager;
   /** @see {@link Bus} */
@@ -1538,6 +1737,8 @@ declare class Seedcord extends Pluggable<'gateway', 'server'> implements Core, S
   readonly bot: Bot;
   /** The discord.js client's REST client. Its token is set during the Login phase. */
   readonly rest: REST;
+  /** The bot's Discord application id. Throws if you read it before login. */
+  get applicationId(): string;
   /** @see {@link IRateLimiter} */
   readonly rateLimiter: IRateLimiter;
   /**
@@ -1547,7 +1748,7 @@ declare class Seedcord extends Pluggable<'gateway', 'server'> implements Core, S
   constructor(config: GatewayConfig);
   /** The bot's discord username, populated after login. */
   get username(): string | undefined;
-  protected static reset(): void;
+  protected static reset(host?: object): boolean;
   private registerStartupTasks;
   /**
    * Starts the bot and runs all initialization tasks
@@ -1562,5 +1763,5 @@ declare class Seedcord extends Pluggable<'gateway', 'server'> implements Core, S
 /** Package version */
 declare const version: string;
 //#endregion
-export { ArraySource, AssignRoleNoticeOverrides, AutocompleteHandler, BaseHandler, ButtonHandler, type CheckPermissionOptions, ComponentHandler, type ConfirmOptions, type Core, CursorSource, type DefaultConfirmOptions, Emojis, type EventGateContext, EventHandler, EventMiddleware, type EventSpec, type EventsConfig, type GateContext, Gated, type GatewayBotConfig, type GatewayConfig, GatewayEmoji, type GatewayFile, type GatewayPluginOptions, type GatewayReplyResponse, HasPermsToAssignOptions, IgnoreBots, type InjectedEmojiMap, type InteractionGateContext, InteractionHandler, InteractionMiddleware, MessageContextMenuHandler, Middleware, type MiddlewareOptions, MiddlewareType, ModalHandler, Nsfw, type PageContext, Paginator, Plugin, type PluginLifecycleSpec, type PluginOptions, RegisterEvent, type RegisterEventOptions, RepliableHandler, type Repliables, Seedcord, SelectMenuHandler, SlashHandler, type SlashOptions, Subscriber, UserContextMenuHandler, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, WebhookLog, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
+export { ArraySource, AssignRoleNoticeOverrides, AutocompleteHandler, BaseHandler, ButtonHandler, type CheckPermissionOptions, ComponentHandler, type ConfirmOptions, type Core, CursorSource, type DefaultConfirmOptions, Emojis, type EventGateContext, EventHandler, EventMiddleware, type EventSpec, type EventsConfig, type GateContext, Gated, type GatewayBotConfig, type GatewayConfig, GatewayEmoji, type GatewayFile, type GatewayPluginOptions, type GatewayReplyResponse, HasPermsToAssignOptions, IgnoreBots, type InjectedEmojiMap, type InteractionGateContext, InteractionHandler, InteractionMiddleware, MessageContextMenuHandler, Middleware, type MiddlewareOptions, MiddlewareType, ModalHandler, Nsfw, type PageContext, type PageSource, Paginator, Plugin, type PluginLifecycleSpec, type PluginOptions, RegisterEvent, type RegisterEventOptions, RepliableHandler, type Repliables, ReplySender, Seedcord, SelectMenuHandler, type SentMessage, SlashHandler, type SlashOptions, Subscriber, UserContextMenuHandler, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, WebhookLog, WinstonConsoleSink, WinstonFileSink, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
 //# sourceMappingURL=index.d.mts.map