@seedcord/gateway 0.2.1 → 0.3.1

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import "reflect-metadata";
-import { AnyCustomId, AutocompletableNames, AutocompleteRouteBrand, BaseReplySender, ChoiceValueOf, ComponentDefsBrand, ComponentKindBrand, ContextMenuKindBrand, EntryFor, FocusedField, GateFitsWith, HasComponentDefs, MatchArms, ModalLike, PageCursor, SingleParams, SlashOptions as SlashOptions$1, SlashRouteBrand } from "@seedcord/core/internal";
-import { ArraySource as ArraySource$1, AutocompleteOptions, BaseHandler as BaseHandler$1, Bus, ContextMenuKind, CoreBase, CursorSource as CursorSource$1, DispatchContext, Gate, GateContextBase, GateNoticeOptions, GuildPermissionsContext, Initializeable, Notice, PaginatorBase, PaginatorConfig, PermissionNoticeOverrides, PermissionScope, RepliableHandler as RepliableHandler$1, RequiredOf, ResolvedEmoji, SelectMenuKind, SlashOptionRegistry, Subscriber as Subscriber$1, SubscriptionKey, WebhookLog as WebhookLog$1 } from "@seedcord/core";
+import { AnyCustomId, AutocompletableNames, AutocompleteRouteBrand, BaseReplySender, CacheFor, ChoiceValueOf, ComponentDefsBrand, ComponentKindBrand, ContextMenuKindBrand, ContextMenuNamesBrand, EntryFor, FocusedField, GateFitsWith, HasComponentDefs, Initializeable, 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, 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 { 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 { Plugin as Plugin$1, PluginLifecycleSpec, PluginOptions, PluginOptions as PluginOptions$1 } from "@seedcord/core/plugin";
@@ -77,16 +77,17 @@ interface GatewayConfig extends Config {
 }
 //#endregion
 //#region src/bot/Bot.d.ts
+declare const loggerSlot: unique symbol;
 /**
  * The Discord client and its controllers. Access it through `core.bot`.
  */
-declare const loggerSlot: unique symbol;
 declare class Bot implements Initializeable, HmrAware {
   readonly botToken: string;
   private readonly logger;
   /** @internal */
   readonly [loggerSlot]: Logger;
   private isInitialized;
+  private readonly intents;
   private readonly _client;
   private readonly interactions?;
   private readonly events?;
@@ -96,7 +97,8 @@ declare class Bot implements Initializeable, HmrAware {
   onHmr(event: HmrUpdateEvent): Promise<void>;
   /** @internal */
   constructor(core: Core);
-  private applicationId;
+  /** @internal */
+  get applicationId(): string;
   private registerShutdownTasks;
   private stopAccepting;
   private drain;
@@ -706,13 +708,13 @@ interface GatewayLens<Cache extends CacheType> {
  * A channel option declared with `addChannelTypes` narrows `getChannel` to the matching channel subtype.
  * Pass the raw `this.event.options` resolver for anything this view does not cover.
  *
- * @typeParam Route - A route key from the generated {@link SlashOptionRegistry}.
- * @typeParam Cache - The interaction cache state, `'cached'` by default.
+ * @typeParam Route - A route key from the generated {@link SlashRegistry}.
+ * @typeParam Cache - The interaction cache state. The command's contexts set it.
  */
-type SlashOptions<Route extends keyof SlashOptionRegistry, Cache extends CacheType = 'cached'> = SlashOptions$1<Route, GatewayLens<Cache>>;
+type SlashOptions<Route extends keyof SlashRegistry, Cache extends CacheType = CacheFor<Route>> = SlashOptions$1<Route, GatewayLens<Cache>>;
 //#endregion
 //#region src/handlers/interaction/SlashHandler.d.ts
-type SlashMatchArms<Route extends keyof SlashOptionRegistry, Cache extends CacheType, Ret> = { [Key in Route]: (options: SlashOptions<Key, Cache>) => Promisable<Ret>; };
+type SlashMatchArms<Route extends keyof SlashRegistry, Cache extends CacheType, Ret> = { [Key in Route]: (options: SlashOptions<Key, Cache>) => Promisable<Ret>; };
 /**
  * Base class for a chat-input (slash) command handler.
  *
@@ -720,8 +722,8 @@ type SlashMatchArms<Route extends keyof SlashOptionRegistry, Cache extends Cache
  * `this.options` for a single command or `this.match` for several. Command authoring stays plain
  * discord.js, `seedcord codegen` reads its `toJSON()` to type these options.
  *
- * @typeParam Route - One or more route keys from {@link SlashOptionRegistry}, e.g. `'ban'` or `'ban' | 'kick'`.
- * @typeParam Cache - The interaction cache state, `'cached'` by default.
+ * @typeParam Route - One or more route keys from {@link SlashRegistry}, e.g. `'ban'` or `'ban' | 'kick'`.
+ * @typeParam Cache - The interaction cache state. The command's contexts set it.
  *
  * @example
  * ```ts
@@ -734,7 +736,7 @@ type SlashMatchArms<Route extends keyof SlashOptionRegistry, Cache extends Cache
  * }
  * ```
  */
-declare abstract class SlashHandler<Route extends keyof SlashOptionRegistry, Cache extends CacheType = 'cached'> extends InteractionHandler<ChatInputCommandInteraction<Cache>> {
+declare abstract class SlashHandler<Route extends keyof SlashRegistry, Cache extends CacheType = CacheFor<Route>> extends InteractionHandler<ChatInputCommandInteraction<Cache>> {
   /** @internal */
   readonly [SlashRouteBrand]?: Route;
   /**
@@ -771,43 +773,63 @@ declare abstract class SlashHandler<Route extends keyof SlashOptionRegistry, Cac
 }
 //#endregion
 //#region src/handlers/interaction/ContextMenuHandler.d.ts
-type InteractionFor<Kind extends ContextMenuKind, Cache extends CacheType> = Kind extends ApplicationCommandType.User ? UserContextMenuCommandInteraction<Cache> : MessageContextMenuCommandInteraction<Cache>;
-type TargetFor<Kind extends ContextMenuKind, Cache extends CacheType> = Kind extends ApplicationCommandType.User ? User : Message<BooleanCache<Cache>>;
-type TargetMemberFor<Kind extends ContextMenuKind, Cache extends CacheType> = Kind extends ApplicationCommandType.User ? CacheTypeReducer<Cache, GuildMember, APIInteractionGuildMember> | null : never;
 /**
- * Base class for a context-menu command handler (right-click a user or a message).
+ * Base class for a user context-menu command handler (right-click a user).
  *
- * Pass the kind from `discord.js`'s {@link ApplicationCommandType} as the generic, the same value as
- * `@ContextMenuRoute`. Read the right-clicked entity from `this.target`, a `User` for a user menu and a
- * `Message` for a message menu. Context menus carry no options, so a handler registered for several names
- * reads `this.target` uniformly with no per-name branch.
+ * Pass the command name(s) as the generic, the same as `@UserContextMenuRoute`. Read the right-clicked
+ * user from `this.target` and that same user's guild member from `this.targetMember`.
  *
- * @typeParam Kind - `ApplicationCommandType.User` or `ApplicationCommandType.Message`.
- * @typeParam Cache - The interaction cache state, `'cached'` by default.
+ * @typeParam Names - One or more command names from the generated user registry.
+ * @typeParam Cache - The interaction cache state. The command's contexts set it.
+ *
+ * @example
+ * ```ts
+ * \@UserContextMenuRoute('View Profile')
+ * class ViewProfile extends UserContextMenuHandler<'View Profile'> {
+ *     async execute() {
+ *         const user = this.target;
+ *     }
+ * }
+ * ```
+ */
+declare abstract class UserContextMenuHandler<Names extends NamesFor<ApplicationCommandType.User>, Cache extends CacheType = MenuCacheFor<ApplicationCommandType.User, Names>> extends InteractionHandler<UserContextMenuCommandInteraction<Cache>> {
+  /** @internal */
+  readonly [ContextMenuKindBrand]?: ApplicationCommandType.User;
+  /** @internal */
+  readonly [ContextMenuNamesBrand]?: Names;
+  protected get target(): User;
+  /** The right-clicked user's guild member, null outside a guild. */
+  protected get targetMember(): CacheTypeReducer<Cache, GuildMember, APIInteractionGuildMember> | null;
+}
+/**
+ * Base class for a message context-menu command handler (right-click a message).
+ *
+ * Pass the command name(s) as the generic, the same as `@MessageContextMenuRoute`. Read the right-clicked
+ * message from `this.target`.
+ *
+ * @typeParam Names - One or more command names from the generated message registry.
+ * @typeParam Cache - The interaction cache state. The command's contexts set it.
  *
  * @example
  * ```ts
- * \@ContextMenuRoute(ApplicationCommandType.Message, 'Report Message')
- * class ReportMessage extends ContextMenuHandler<ApplicationCommandType.Message> {
+ * \@MessageContextMenuRoute('Report Message')
+ * class ReportMessage extends MessageContextMenuHandler<'Report Message'> {
  *     async execute() {
  *         const message = this.target;
  *     }
  * }
  * ```
  */
-declare abstract class ContextMenuHandler<Kind extends ContextMenuKind, Cache extends CacheType = 'cached'> extends InteractionHandler<InteractionFor<Kind, Cache>> {
+declare abstract class MessageContextMenuHandler<Names extends NamesFor<ApplicationCommandType.Message>, Cache extends CacheType = MenuCacheFor<ApplicationCommandType.Message, Names>> extends InteractionHandler<MessageContextMenuCommandInteraction<Cache>> {
   /** @internal */
-  readonly [ContextMenuKindBrand]?: Kind;
-  protected get target(): TargetFor<Kind, Cache>;
-  /**
-   * The invoking guild member, resolved only on user menus. Reading it on a message menu is a compile
-   * error since the type is `never` there.
-   */
-  protected get targetMember(): TargetMemberFor<Kind, Cache>;
+  readonly [ContextMenuKindBrand]?: ApplicationCommandType.Message;
+  /** @internal */
+  readonly [ContextMenuNamesBrand]?: Names;
+  protected get target(): Message<BooleanCache<Cache>>;
 }
 //#endregion
 //#region src/handlers/interaction/AutocompleteHandler.d.ts
-type FocusedArms<Route extends keyof SlashOptionRegistry, Ret> = { [Name in AutocompletableNames<Route>]: (value: string, respond: (choices: readonly ApplicationCommandOptionChoiceData<ChoiceValueOf<EntryFor<Route, Name>>>[]) => Promise<void>) => Promisable<Ret>; };
+type FocusedArms<Route extends keyof SlashRegistry, Ret> = { [Name in AutocompletableNames<Route>]: (value: string, respond: (choices: readonly ApplicationCommandOptionChoiceData<ChoiceValueOf<EntryFor<Route, Name>>>[]) => Promise<void>) => Promisable<Ret>; };
 /**
  * Base class for a Discord autocomplete handler.
  *
@@ -815,8 +837,8 @@ type FocusedArms<Route extends keyof SlashOptionRegistry, Ret> = { [Name in Auto
  * `@AutocompleteRoute`. Branch on the focused field with `this.match`, read already-entered sibling options
  * with `this.options`, and find which command fired with `this.route`.
  *
- * @typeParam Route - One or more route keys from {@link SlashOptionRegistry}, e.g. `'search'` or `'search' | 'find'`.
- * @typeParam Cache - The interaction cache state, `'cached'` by default.
+ * @typeParam Route - One or more route keys from {@link SlashRegistry}, e.g. `'search'` or `'search' | 'find'`.
+ * @typeParam Cache - The interaction cache state. The command's contexts set it.
  *
  * @example
  * ```ts
@@ -830,7 +852,7 @@ type FocusedArms<Route extends keyof SlashOptionRegistry, Ret> = { [Name in Auto
  * }
  * ```
  */
-declare abstract class AutocompleteHandler<Route extends keyof SlashOptionRegistry, Cache extends CacheType = 'cached'> extends BaseHandler<AutocompleteInteraction<Cache>> {
+declare abstract class AutocompleteHandler<Route extends keyof SlashRegistry, Cache extends CacheType = CacheFor<Route>> extends BaseHandler<AutocompleteInteraction<Cache>> {
   /** @internal */
   readonly [AutocompleteRouteBrand]?: Route;
   constructor(event: AutocompleteInteraction<Cache>, core: Core, dispatch?: DispatchContext);
@@ -1131,7 +1153,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
@@ -1404,7 +1426,7 @@ interface PageContext {
 }
 //#endregion
 //#region src/pagination/Paginator.d.ts
-type PaginatorHandlerCtor<Prefix extends string> = new (event: ButtonInteraction<'cached'>, core: Core) => ButtonHandler<[PageCursor<Prefix>]> & {
+type PaginatorHandlerCtor<Prefix extends string> = new (event: ButtonInteraction<CacheType>, core: Core) => ButtonHandler<[PageCursor<Prefix>], CacheType> & {
   execute(): Promise<void>;
 };
 /**
@@ -1418,7 +1440,7 @@ type PaginatorHandlerCtor<Prefix extends string> = new (event: ButtonInteraction
  * ```ts
  * export const Bans = new Paginator({
  *     prefix: 'bans',
- *     source: new ArraySource((ctx) => ctx.guild.bans.fetch().then((b) => [...b.values()]), { perPage: 10 }),
+ *     source: new ArraySource((ctx) => ctx.guild?.bans.fetch().then((b) => [...b.values()]) ?? [], { perPage: 10 }),
  *     renderItem: (ban) => ban.user.tag
  * });
  *
@@ -1517,6 +1539,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;
   /**
@@ -1541,5 +1565,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, ContextMenuHandler, 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, 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, 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, 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 };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,11 +1,11 @@
 import "reflect-metadata";
 import { installNodeDefaults } from "@seedcord/logger/node";
-import { BaseReplySender, CommandInjector, EventMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, NoticeCard, PermissionNames, PublishDefault, accessorStore, areRoutes, asError, busLoggerOf, clearStore, decodeComponentRoute, deferFlags, guardedAccessor, isEmojiTuple, outcomeFor, pickNotice, prefixOf, queuedMsFor, reportDispatch, reportedWrite, routeIdOf, runHandlerGates, sendFlags, setBotColor, slowGateMonitor } from "@seedcord/core/internal";
+import { BaseReplySender, EventMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, NoticeCard, PermissionNames, PublishDefault, accessorStore, areRoutes, asError, busLoggerOf, clearStore, decodeComponentRoute, deferFlags, guardedAccessor, isEmojiTuple, outcomeFor, pickNotice, prefixOf, queuedMsFor, reportDispatch, reportedWrite, routeIdOf, runHandlerGates, sendFlags, setBotColor, slowGateMonitor } from "@seedcord/core/internal";
 import { SeedcordErrorCode, paint } from "@seedcord/errors";
 import { SeedcordError, SeedcordTypeError, validateDiscordToken } from "@seedcord/errors/internal";
 import { ArraySource as ArraySource$1, BaseHandler as BaseHandler$1, BuilderComponent, Bus, CursorSource as CursorSource$1, CustomId, DispatchContext, Fault, Notice, PaginatorBase, RepliableHandler as RepliableHandler$1, ResolvedEmoji, RowComponent, Silence, Subscriber as Subscriber$1, WebhookLog as WebhookLog$1, assertPermissions, defineGate } from "@seedcord/core";
 import { Logger, LoggerChannelRegistry } from "@seedcord/logger";
-import { ButtonStyle, Client, ComponentType, DiscordAPIError, Events, Guild, GuildMember, Message, MessageFlags, PermissionFlagsBits, RESTJSONErrorCodes, Role, User } from "discord.js";
+import { ButtonStyle, Client, ComponentType, DiscordAPIError, Events, GatewayIntentBits, Guild, GuildMember, IntentsBitField, InteractionContextType, Message, MessageFlags, PermissionFlagsBits, RESTJSONErrorCodes, Role, User } from "discord.js";
 import { ButtonBuilder, TextDisplayBuilder } from "@discordjs/builders";
 import { buildSlashRoute } from "@seedcord/utils/internal";
 import { Plugin as Plugin$1 } from "@seedcord/core/plugin";
@@ -274,7 +274,7 @@ var GatewayEmoji = class extends ResolvedEmoji {
 const emojiStorage = accessorStore();
 /**
 * 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.
 */
 const Emojis = guardedAccessor("Emojis", emojiStorage);
 var EmojiInjector = class {
@@ -708,8 +708,8 @@ function slashRouteOf(interaction) {
 * `this.options` for a single command or `this.match` for several. Command authoring stays plain
 * discord.js, `seedcord codegen` reads its `toJSON()` to type these options.
 *
-* @typeParam Route - One or more route keys from {@link SlashOptionRegistry}, e.g. `'ban'` or `'ban' | 'kick'`.
-* @typeParam Cache - The interaction cache state, `'cached'` by default.
+* @typeParam Route - One or more route keys from {@link SlashRegistry}, e.g. `'ban'` or `'ban' | 'kick'`.
+* @typeParam Cache - The interaction cache state. The command's contexts set it.
 *
 * @example
 * ```ts
@@ -766,39 +766,57 @@ var SlashHandler = class extends InteractionHandler {
 //#endregion
 //#region src/handlers/interaction/ContextMenuHandler.ts
 /**
-* Base class for a context-menu command handler (right-click a user or a message).
+* Base class for a user context-menu command handler (right-click a user).
 *
-* Pass the kind from `discord.js`'s {@link ApplicationCommandType} as the generic, the same value as
-* `@ContextMenuRoute`. Read the right-clicked entity from `this.target`, a `User` for a user menu and a
-* `Message` for a message menu. Context menus carry no options, so a handler registered for several names
-* reads `this.target` uniformly with no per-name branch.
+* Pass the command name(s) as the generic, the same as `@UserContextMenuRoute`. Read the right-clicked
+* user from `this.target` and that same user's guild member from `this.targetMember`.
 *
-* @typeParam Kind - `ApplicationCommandType.User` or `ApplicationCommandType.Message`.
-* @typeParam Cache - The interaction cache state, `'cached'` by default.
+* @typeParam Names - One or more command names from the generated user registry.
+* @typeParam Cache - The interaction cache state. The command's contexts set it.
 *
 * @example
 * ```ts
-* \@ContextMenuRoute(ApplicationCommandType.Message, 'Report Message')
-* class ReportMessage extends ContextMenuHandler<ApplicationCommandType.Message> {
+* \@UserContextMenuRoute('View Profile')
+* class ViewProfile extends UserContextMenuHandler<'View Profile'> {
 *     async execute() {
-*         const message = this.target;
+*         const user = this.target;
 *     }
 * }
 * ```
 */
-var ContextMenuHandler = class extends InteractionHandler {
+var UserContextMenuHandler = class extends InteractionHandler {
 	get target() {
-		const event = this.event;
-		return "targetUser" in event ? event.targetUser : event.targetMessage;
+		return this.event.targetUser;
 	}
-	/**
-	* The invoking guild member, resolved only on user menus. Reading it on a message menu is a compile
-	* error since the type is `never` there.
-	*/
+	/** The right-clicked user's guild member, null outside a guild. */
 	get targetMember() {
 		return this.event.targetMember;
 	}
 };
+/**
+* Base class for a message context-menu command handler (right-click a message).
+*
+* Pass the command name(s) as the generic, the same as `@MessageContextMenuRoute`. Read the right-clicked
+* message from `this.target`.
+*
+* @typeParam Names - One or more command names from the generated message registry.
+* @typeParam Cache - The interaction cache state. The command's contexts set it.
+*
+* @example
+* ```ts
+* \@MessageContextMenuRoute('Report Message')
+* class ReportMessage extends MessageContextMenuHandler<'Report Message'> {
+*     async execute() {
+*         const message = this.target;
+*     }
+* }
+* ```
+*/
+var MessageContextMenuHandler = class extends InteractionHandler {
+	get target() {
+		return this.event.targetMessage;
+	}
+};
 
 //#endregion
 //#region src/handlers/interaction/AutocompleteHandler.ts
@@ -809,8 +827,8 @@ var ContextMenuHandler = class extends InteractionHandler {
 * `@AutocompleteRoute`. Branch on the focused field with `this.match`, read already-entered sibling options
 * with `this.options`, and find which command fired with `this.route`.
 *
-* @typeParam Route - One or more route keys from {@link SlashOptionRegistry}, e.g. `'search'` or `'search' | 'find'`.
-* @typeParam Cache - The interaction cache state, `'cached'` by default.
+* @typeParam Route - One or more route keys from {@link SlashRegistry}, e.g. `'search'` or `'search' | 'find'`.
+* @typeParam Cache - The interaction cache state. The command's contexts set it.
 *
 * @example
 * ```ts
@@ -1177,7 +1195,7 @@ function contextOf(interaction, core) {
 * ```ts
 * export const Bans = new Paginator({
 *     prefix: 'bans',
-*     source: new ArraySource((ctx) => ctx.guild.bans.fetch().then((b) => [...b.values()]), { perPage: 10 }),
+*     source: new ArraySource((ctx) => ctx.guild?.bans.fetch().then((b) => [...b.values()]) ?? [], { perPage: 10 }),
 *     renderItem: (ban) => ban.user.tag
 * });
 *
@@ -2165,6 +2183,20 @@ var InteractionDispatcher = class {
 	}
 };
 
+//#endregion
+//#region src/miscellaneous/assertGuildsIntent.ts
+function reachesGuilds(command) {
+	const contexts = command.toJSON().contexts;
+	if (!contexts || contexts.length === 0) return true;
+	return contexts.includes(InteractionContextType.Guild);
+}
+function assertGuildsIntent(intents, commands) {
+	if ((IntentsBitField.resolve(intents) & GatewayIntentBits.Guilds) !== 0) return;
+	const needing = commands.filter((command) => reachesGuilds(command)).map((command) => command.name);
+	if (needing.length === 0) return;
+	throw new SeedcordError(SeedcordErrorCode.MissingGuildsIntent, [needing.join(", ")]);
+}
+
 //#endregion
 //#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
@@ -2180,15 +2212,16 @@ const DISPATCH_DRAIN_TIMEOUT_MS = 5e3;
 const DRAIN_TASK_TIMEOUT_MS = 6e3;
 const UNBIND_TIMEOUT_MS = 2e3;
 const LOGOUT_TIMEOUT_MS = 2e3;
+const loggerSlot = Symbol("seedcord:bot:logger");
 /**
 * The Discord client and its controllers. Access it through `core.bot`.
 */
-const loggerSlot = Symbol("seedcord:bot:logger");
 var Bot = class {
 	logger = new Logger("Bot", { channel: "bot" });
 	/** @internal */
 	[loggerSlot] = this.logger;
 	isInitialized = false;
+	intents;
 	_client;
 	interactions;
 	events;
@@ -2202,26 +2235,16 @@ var Bot = class {
 	}
 	/** @internal */
 	constructor(core) {
+		this.intents = core.config.bot.clientOptions.intents;
 		this._client = new Client(core.config.bot.clientOptions);
 		if (core.config.bot.interactions.path) this.interactions = new InteractionDispatcher(core);
 		if (core.config.bot.events.path) this.events = new EventDispatcher(core);
-		const commandsDir = core.config.bot.commands.path;
-		if (commandsDir) {
-			const injector = new CommandInjector();
-			const registry = new CommandRegistry({
-				dir: commandsDir,
-				rest: this._client.rest,
-				applicationId: () => this.applicationId(),
-				onDeployed: (result) => {
-					injector.inject(result, registry.allCommands());
-				}
-			});
-			this.commandRegistry = registry;
-		}
+		if (core.config.bot.commands.path) this.commandRegistry = new CommandRegistry(core);
 		this.emojiInjector = new EmojiInjector(core);
 		this.registerShutdownTasks(core);
 	}
-	applicationId() {
+	/** @internal */
+	get applicationId() {
 		const { application } = this._client;
 		if (!application) throw new SeedcordError(SeedcordErrorCode.CoreApplicationUnavailable);
 		return application.id;
@@ -2252,6 +2275,7 @@ var Bot = class {
 		await this.emojiInjector.init();
 		if (this.commandRegistry) {
 			await this.commandRegistry.init();
+			assertGuildsIntent(this.intents, this.commandRegistry.allCommands());
 			await this.commandRegistry.setCommands();
 			this.interactions?.warnUnhandledRoutes(this.commandRegistry.routeLeaves());
 			this.interactions?.warnUnhandledContextMenuRoutes(this.commandRegistry.contextMenuLeaves());
@@ -2287,7 +2311,7 @@ function botLoggerOf(bot) {
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.2.1";
+const version = "0.3.1";
 
 //#endregion
 //#region src/Seedcord.ts
@@ -2312,6 +2336,10 @@ var Seedcord = class Seedcord extends Pluggable {
 	bot;
 	/** The discord.js client's REST client. Its token is set during the Login phase. */
 	rest;
+	/** The bot's Discord application id. Throws if you read it before login. */
+	get applicationId() {
+		return this.bot.applicationId;
+	}
 	/** @see {@link IRateLimiter} */
 	rateLimiter;
 	/**
@@ -2386,5 +2414,5 @@ var Seedcord = class Seedcord extends Pluggable {
 };
 
 //#endregion
-export { ArraySource, AutocompleteHandler, BaseHandler, ButtonHandler, ComponentHandler, ContextMenuHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, GatewayEmoji, IgnoreBots, InteractionHandler, InteractionMiddleware, Middleware, MiddlewareType, ModalHandler, Nsfw, Paginator, Plugin, RegisterEvent, RepliableHandler, Seedcord, SelectMenuHandler, SlashHandler, Subscriber, WebhookLog, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
+export { ArraySource, AutocompleteHandler, BaseHandler, ButtonHandler, ComponentHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, GatewayEmoji, IgnoreBots, InteractionHandler, InteractionMiddleware, MessageContextMenuHandler, Middleware, MiddlewareType, ModalHandler, Nsfw, Paginator, Plugin, RegisterEvent, RepliableHandler, Seedcord, SelectMenuHandler, SlashHandler, Subscriber, UserContextMenuHandler, WebhookLog, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
 //# sourceMappingURL=index.mjs.map