seedcord 0.10.2 → 0.10.3

package/dist/index.d.cts

@@ -1226,6 +1226,22 @@ declare enum SelectMenuType {
  * @internal
  */
 declare const InteractionMetadataKey: unique symbol;
+/**
+ * Extract the event type from an InteractionHandler subclass
+ *
+ * Used by the interaction routing decorators.
+ *
+ * @internal
+ */
+type HandlerEventType<TCtor extends new (...args: any[]) => InteractionHandler<Repliables>> = InstanceType<TCtor> extends InteractionHandler<infer TEvent> ? TEvent : never;
+/**
+ * Compile time assertion that the required event type(s) `TRequired` are included in the handler event union.
+ *
+ * Used by the interaction routing decorators.
+ *
+ * @internal
+ */
+type AssertHandles<TRequired, TCtor extends new (...args: any[]) => InteractionHandler<Repliables>> = Extract<HandlerEventType<TCtor>, TRequired> extends never ? Constructor<['Handler event generic must include', TRequired]> : TCtor;
 /**
  * Routes slash commands to handler classes
  *
@@ -1258,7 +1274,7 @@ declare const InteractionMetadataKey: unique symbol;
  * }
  * ```
  */
-declare function SlashRoute(routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ChatInputCommandInteraction>>) => void;
+declare function SlashRoute(routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ChatInputCommandInteraction, TCtor>) => void;
 /**
  * Routes button interactions to handler classes
  *
@@ -1269,7 +1285,7 @@ declare function SlashRoute(routeOrRoutes: string | string[]): (constructor: Con
  * @param routeOrRoutes - CustomId prefix(es) to handle
  * @decorator
  */
-declare function ButtonRoute(routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ButtonInteraction>>) => void;
+declare function ButtonRoute(routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ButtonInteraction, TCtor>) => void;
 /**
  * Routes modal submissions to handler classes
  *
@@ -1278,7 +1294,7 @@ declare function ButtonRoute(routeOrRoutes: string | string[]): (constructor: Co
  * @param routeOrRoutes - CustomId prefix(es) to handle
  * @decorator
  */
-declare function ModalRoute(routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ModalSubmitInteraction>>) => void;
+declare function ModalRoute(routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ModalSubmitInteraction, TCtor>) => void;
 /**
  * Routes context menu commands to handler classes
  *
@@ -1286,7 +1302,7 @@ declare function ModalRoute(routeOrRoutes: string | string[]): (constructor: Con
  * @param routeOrRoutes - Command name(s) to handle
  * @decorator
  */
-declare function ContextMenuRoute(type: 'message' | 'user', routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ContextMenuCommandInteraction>>) => void;
+declare function ContextMenuRoute(type: 'message' | 'user', routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ContextMenuCommandInteraction, TCtor>) => void;
 /**
  * Routes autocomplete interactions to handler classes
  *
@@ -1324,7 +1340,7 @@ type SelectMenuInteractionFor<SelectMenu extends SelectMenuType> = SelectMenu ex
  * }
  * ```
  */
-declare function SelectMenuRoute<SelectMenu extends SelectMenuType>(type: SelectMenu, routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<SelectMenuInteractionFor<SelectMenu>>>) => void;
+declare function SelectMenuRoute<SelectMenu extends SelectMenuType>(type: SelectMenu, routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<SelectMenuInteractionFor<SelectMenu>, TCtor>) => void;
 
 /**
  * Middleware types supported by Seedcord
@@ -2237,4 +2253,4 @@ declare class Seedcord extends Pluggable implements Core {
     start(): Promise<this>;
 }
 
-export { type ActionRowComponentType, type AllEffects, type AssignRoleErrorCtors, type AtleastOneMessageComponent, AutocompleteHandler, type AutocompleteHandlerConstructor, AutocompleteRoute, BaseComponent, type BaseCore, BaseErrorEmbed, BaseHandler, Bot, type BotConfig, type BotEvents, type BotPermissionScope, BuilderComponent, type BuilderType, BuilderTypes, ButtonRoute, CannotAssignBotRole, CannotSendEmbedsError, Catchable, type CatchableOptions, ChannelNotFoundError, ChannelNotTextChannel, type CheckPermissionOptions, Checkable, type ClassicPayload, type CommandCtor, type CommandMeta, CommandMetadataKey, CommandRegistry, type CommandRouteString, type CommandScope, type CommandsConfig, type ComponentInteractionFor, type ComponentsV2Payload, type Config, Confirmable, type ConfirmableClassicOptions, type ConfirmableComponentsV2Options, type ConfirmableContext, type ConfirmableFactory, type ConfirmableOptions, type ConfirmablePayload, type ConfirmableResolution, type ConfirmableSharedOptions, type ContainerLike, ContextMenuRoute, type Core, CouldNotFindChannel, CustomError, type CustomErrorConstructor, type CustomIdSource, DatabaseError, type DefaultEffects, type EffectKeys, EffectMetadataKey, type EffectParams, type Effects, type EffectsConfig, EffectsEmitter, EffectsHandler, EffectsRegistry, type EmbedLike, type EmojiConfigValue, EmojiInjector, type EmojiMap, Emojis, EventCatchable, type EventCatchableOptions, EventController, EventHandler, type EventHandlerConstructor, EventMetadataKey, EventMiddleware, type EventMiddlewareConstructor, type EventSpec, type EventsConfig, type ExtractComponent, type ExtractedErrorResponse, GenericError, type GlobalMeta, type GuildMeta, type Handler, type HandlerConstructor, type HandlerCtor, type HandlerWithChecks, HasDangerousPermissions, type HasPermsToAssignOptions, type Initializeable, type InjectedEmojiMap, type InstantiatedActionRow, type InstantiatedBuilder, InteractionController, InteractionHandler, InteractionMetadataKey, InteractionMiddleware, type InteractionMiddlewareConstructor, InteractionRoutes, type InteractionsConfig, type MaybeClearedClassic, type MessageContent, Middleware, type MiddlewareConstructor, type MiddlewareMetadata, MiddlewareMetadataKey, type MiddlewareOptions, MiddlewareType, MissingPermissions, ModalRoute, type OutcomeUiClassic, type OutcomeUiV2, type PermissionErrorCtors, PermissionNames, Pluggable, Plugin, type PluginArgs, type PluginCtor, type QuestionInput, RegisterCommand, RegisterEffect, type RegisterEffectMetadataEntry, type RegisterEffectOptions, RegisterEvent, type RegisterEventMetadataEntry, type RegisterEventOptions, type RepliableEventHandler, type RepliableInteractionHandler, type Repliables, type ResolverSource, RoleDoesNotExist, RoleHigherThanMe, RowComponent, type RowLike, RowTypes, type SavedEmojiType, Seedcord, type SelectMenuInteractionFor, SelectMenuRoute, SelectMenuType, SlashRoute, UnhandledEvent, UnknownException, UserNotFound, UserNotInGuild, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, type ValidNonInteractionTypes, WebhookLog, type WithChecks, attemptSendDM, buildSlashRoute, checkBotPermissions, checkPermissions, ensureBotPermissions, ensurePermissions, extractErrorResponse, fetchGuildMember, fetchManyGuildMembers, fetchManyUsers, fetchRole, fetchText, fetchUser, getBotRole, hasPermsToAssign, sendInText, throwCustomError, updateMemberRoles };
+export { type ActionRowComponentType, type AllEffects, type AssertHandles, type AssignRoleErrorCtors, type AtleastOneMessageComponent, AutocompleteHandler, type AutocompleteHandlerConstructor, AutocompleteRoute, BaseComponent, type BaseCore, BaseErrorEmbed, BaseHandler, Bot, type BotConfig, type BotEvents, type BotPermissionScope, BuilderComponent, type BuilderType, BuilderTypes, ButtonRoute, CannotAssignBotRole, CannotSendEmbedsError, Catchable, type CatchableOptions, ChannelNotFoundError, ChannelNotTextChannel, type CheckPermissionOptions, Checkable, type ClassicPayload, type CommandCtor, type CommandMeta, CommandMetadataKey, CommandRegistry, type CommandRouteString, type CommandScope, type CommandsConfig, type ComponentInteractionFor, type ComponentsV2Payload, type Config, Confirmable, type ConfirmableClassicOptions, type ConfirmableComponentsV2Options, type ConfirmableContext, type ConfirmableFactory, type ConfirmableOptions, type ConfirmablePayload, type ConfirmableResolution, type ConfirmableSharedOptions, type ContainerLike, ContextMenuRoute, type Core, CouldNotFindChannel, CustomError, type CustomErrorConstructor, type CustomIdSource, DatabaseError, type DefaultEffects, type EffectKeys, EffectMetadataKey, type EffectParams, type Effects, type EffectsConfig, EffectsEmitter, EffectsHandler, EffectsRegistry, type EmbedLike, type EmojiConfigValue, EmojiInjector, type EmojiMap, Emojis, EventCatchable, type EventCatchableOptions, EventController, EventHandler, type EventHandlerConstructor, EventMetadataKey, EventMiddleware, type EventMiddlewareConstructor, type EventSpec, type EventsConfig, type ExtractComponent, type ExtractedErrorResponse, GenericError, type GlobalMeta, type GuildMeta, type Handler, type HandlerConstructor, type HandlerCtor, type HandlerEventType, type HandlerWithChecks, HasDangerousPermissions, type HasPermsToAssignOptions, type Initializeable, type InjectedEmojiMap, type InstantiatedActionRow, type InstantiatedBuilder, InteractionController, InteractionHandler, InteractionMetadataKey, InteractionMiddleware, type InteractionMiddlewareConstructor, InteractionRoutes, type InteractionsConfig, type MaybeClearedClassic, type MessageContent, Middleware, type MiddlewareConstructor, type MiddlewareMetadata, MiddlewareMetadataKey, type MiddlewareOptions, MiddlewareType, MissingPermissions, ModalRoute, type OutcomeUiClassic, type OutcomeUiV2, type PermissionErrorCtors, PermissionNames, Pluggable, Plugin, type PluginArgs, type PluginCtor, type QuestionInput, RegisterCommand, RegisterEffect, type RegisterEffectMetadataEntry, type RegisterEffectOptions, RegisterEvent, type RegisterEventMetadataEntry, type RegisterEventOptions, type RepliableEventHandler, type RepliableInteractionHandler, type Repliables, type ResolverSource, RoleDoesNotExist, RoleHigherThanMe, RowComponent, type RowLike, RowTypes, type SavedEmojiType, Seedcord, type SelectMenuInteractionFor, SelectMenuRoute, SelectMenuType, SlashRoute, UnhandledEvent, UnknownException, UserNotFound, UserNotInGuild, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, type ValidNonInteractionTypes, WebhookLog, type WithChecks, attemptSendDM, buildSlashRoute, checkBotPermissions, checkPermissions, ensureBotPermissions, ensurePermissions, extractErrorResponse, fetchGuildMember, fetchManyGuildMembers, fetchManyUsers, fetchRole, fetchText, fetchUser, getBotRole, hasPermsToAssign, sendInText, throwCustomError, updateMemberRoles };

package/dist/index.d.ts

@@ -1226,6 +1226,22 @@ declare enum SelectMenuType {
  * @internal
  */
 declare const InteractionMetadataKey: unique symbol;
+/**
+ * Extract the event type from an InteractionHandler subclass
+ *
+ * Used by the interaction routing decorators.
+ *
+ * @internal
+ */
+type HandlerEventType<TCtor extends new (...args: any[]) => InteractionHandler<Repliables>> = InstanceType<TCtor> extends InteractionHandler<infer TEvent> ? TEvent : never;
+/**
+ * Compile time assertion that the required event type(s) `TRequired` are included in the handler event union.
+ *
+ * Used by the interaction routing decorators.
+ *
+ * @internal
+ */
+type AssertHandles<TRequired, TCtor extends new (...args: any[]) => InteractionHandler<Repliables>> = Extract<HandlerEventType<TCtor>, TRequired> extends never ? Constructor<['Handler event generic must include', TRequired]> : TCtor;
 /**
  * Routes slash commands to handler classes
  *
@@ -1258,7 +1274,7 @@ declare const InteractionMetadataKey: unique symbol;
  * }
  * ```
  */
-declare function SlashRoute(routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ChatInputCommandInteraction>>) => void;
+declare function SlashRoute(routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ChatInputCommandInteraction, TCtor>) => void;
 /**
  * Routes button interactions to handler classes
  *
@@ -1269,7 +1285,7 @@ declare function SlashRoute(routeOrRoutes: string | string[]): (constructor: Con
  * @param routeOrRoutes - CustomId prefix(es) to handle
  * @decorator
  */
-declare function ButtonRoute(routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ButtonInteraction>>) => void;
+declare function ButtonRoute(routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ButtonInteraction, TCtor>) => void;
 /**
  * Routes modal submissions to handler classes
  *
@@ -1278,7 +1294,7 @@ declare function ButtonRoute(routeOrRoutes: string | string[]): (constructor: Co
  * @param routeOrRoutes - CustomId prefix(es) to handle
  * @decorator
  */
-declare function ModalRoute(routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ModalSubmitInteraction>>) => void;
+declare function ModalRoute(routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ModalSubmitInteraction, TCtor>) => void;
 /**
  * Routes context menu commands to handler classes
  *
@@ -1286,7 +1302,7 @@ declare function ModalRoute(routeOrRoutes: string | string[]): (constructor: Con
  * @param routeOrRoutes - Command name(s) to handle
  * @decorator
  */
-declare function ContextMenuRoute(type: 'message' | 'user', routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<ContextMenuCommandInteraction>>) => void;
+declare function ContextMenuRoute(type: 'message' | 'user', routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<ContextMenuCommandInteraction, TCtor>) => void;
 /**
  * Routes autocomplete interactions to handler classes
  *
@@ -1324,7 +1340,7 @@ type SelectMenuInteractionFor<SelectMenu extends SelectMenuType> = SelectMenu ex
  * }
  * ```
  */
-declare function SelectMenuRoute<SelectMenu extends SelectMenuType>(type: SelectMenu, routeOrRoutes: string | string[]): (constructor: Constructor<InteractionHandler<SelectMenuInteractionFor<SelectMenu>>>) => void;
+declare function SelectMenuRoute<SelectMenu extends SelectMenuType>(type: SelectMenu, routeOrRoutes: string | string[]): <TCtor extends new (...args: any[]) => InteractionHandler<Repliables>>(constructor: AssertHandles<SelectMenuInteractionFor<SelectMenu>, TCtor>) => void;
 
 /**
  * Middleware types supported by Seedcord
@@ -2237,4 +2253,4 @@ declare class Seedcord extends Pluggable implements Core {
     start(): Promise<this>;
 }
 
-export { type ActionRowComponentType, type AllEffects, type AssignRoleErrorCtors, type AtleastOneMessageComponent, AutocompleteHandler, type AutocompleteHandlerConstructor, AutocompleteRoute, BaseComponent, type BaseCore, BaseErrorEmbed, BaseHandler, Bot, type BotConfig, type BotEvents, type BotPermissionScope, BuilderComponent, type BuilderType, BuilderTypes, ButtonRoute, CannotAssignBotRole, CannotSendEmbedsError, Catchable, type CatchableOptions, ChannelNotFoundError, ChannelNotTextChannel, type CheckPermissionOptions, Checkable, type ClassicPayload, type CommandCtor, type CommandMeta, CommandMetadataKey, CommandRegistry, type CommandRouteString, type CommandScope, type CommandsConfig, type ComponentInteractionFor, type ComponentsV2Payload, type Config, Confirmable, type ConfirmableClassicOptions, type ConfirmableComponentsV2Options, type ConfirmableContext, type ConfirmableFactory, type ConfirmableOptions, type ConfirmablePayload, type ConfirmableResolution, type ConfirmableSharedOptions, type ContainerLike, ContextMenuRoute, type Core, CouldNotFindChannel, CustomError, type CustomErrorConstructor, type CustomIdSource, DatabaseError, type DefaultEffects, type EffectKeys, EffectMetadataKey, type EffectParams, type Effects, type EffectsConfig, EffectsEmitter, EffectsHandler, EffectsRegistry, type EmbedLike, type EmojiConfigValue, EmojiInjector, type EmojiMap, Emojis, EventCatchable, type EventCatchableOptions, EventController, EventHandler, type EventHandlerConstructor, EventMetadataKey, EventMiddleware, type EventMiddlewareConstructor, type EventSpec, type EventsConfig, type ExtractComponent, type ExtractedErrorResponse, GenericError, type GlobalMeta, type GuildMeta, type Handler, type HandlerConstructor, type HandlerCtor, type HandlerWithChecks, HasDangerousPermissions, type HasPermsToAssignOptions, type Initializeable, type InjectedEmojiMap, type InstantiatedActionRow, type InstantiatedBuilder, InteractionController, InteractionHandler, InteractionMetadataKey, InteractionMiddleware, type InteractionMiddlewareConstructor, InteractionRoutes, type InteractionsConfig, type MaybeClearedClassic, type MessageContent, Middleware, type MiddlewareConstructor, type MiddlewareMetadata, MiddlewareMetadataKey, type MiddlewareOptions, MiddlewareType, MissingPermissions, ModalRoute, type OutcomeUiClassic, type OutcomeUiV2, type PermissionErrorCtors, PermissionNames, Pluggable, Plugin, type PluginArgs, type PluginCtor, type QuestionInput, RegisterCommand, RegisterEffect, type RegisterEffectMetadataEntry, type RegisterEffectOptions, RegisterEvent, type RegisterEventMetadataEntry, type RegisterEventOptions, type RepliableEventHandler, type RepliableInteractionHandler, type Repliables, type ResolverSource, RoleDoesNotExist, RoleHigherThanMe, RowComponent, type RowLike, RowTypes, type SavedEmojiType, Seedcord, type SelectMenuInteractionFor, SelectMenuRoute, SelectMenuType, SlashRoute, UnhandledEvent, UnknownException, UserNotFound, UserNotInGuild, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, type ValidNonInteractionTypes, WebhookLog, type WithChecks, attemptSendDM, buildSlashRoute, checkBotPermissions, checkPermissions, ensureBotPermissions, ensurePermissions, extractErrorResponse, fetchGuildMember, fetchManyGuildMembers, fetchManyUsers, fetchRole, fetchText, fetchUser, getBotRole, hasPermsToAssign, sendInText, throwCustomError, updateMemberRoles };
+export { type ActionRowComponentType, type AllEffects, type AssertHandles, type AssignRoleErrorCtors, type AtleastOneMessageComponent, AutocompleteHandler, type AutocompleteHandlerConstructor, AutocompleteRoute, BaseComponent, type BaseCore, BaseErrorEmbed, BaseHandler, Bot, type BotConfig, type BotEvents, type BotPermissionScope, BuilderComponent, type BuilderType, BuilderTypes, ButtonRoute, CannotAssignBotRole, CannotSendEmbedsError, Catchable, type CatchableOptions, ChannelNotFoundError, ChannelNotTextChannel, type CheckPermissionOptions, Checkable, type ClassicPayload, type CommandCtor, type CommandMeta, CommandMetadataKey, CommandRegistry, type CommandRouteString, type CommandScope, type CommandsConfig, type ComponentInteractionFor, type ComponentsV2Payload, type Config, Confirmable, type ConfirmableClassicOptions, type ConfirmableComponentsV2Options, type ConfirmableContext, type ConfirmableFactory, type ConfirmableOptions, type ConfirmablePayload, type ConfirmableResolution, type ConfirmableSharedOptions, type ContainerLike, ContextMenuRoute, type Core, CouldNotFindChannel, CustomError, type CustomErrorConstructor, type CustomIdSource, DatabaseError, type DefaultEffects, type EffectKeys, EffectMetadataKey, type EffectParams, type Effects, type EffectsConfig, EffectsEmitter, EffectsHandler, EffectsRegistry, type EmbedLike, type EmojiConfigValue, EmojiInjector, type EmojiMap, Emojis, EventCatchable, type EventCatchableOptions, EventController, EventHandler, type EventHandlerConstructor, EventMetadataKey, EventMiddleware, type EventMiddlewareConstructor, type EventSpec, type EventsConfig, type ExtractComponent, type ExtractedErrorResponse, GenericError, type GlobalMeta, type GuildMeta, type Handler, type HandlerConstructor, type HandlerCtor, type HandlerEventType, type HandlerWithChecks, HasDangerousPermissions, type HasPermsToAssignOptions, type Initializeable, type InjectedEmojiMap, type InstantiatedActionRow, type InstantiatedBuilder, InteractionController, InteractionHandler, InteractionMetadataKey, InteractionMiddleware, type InteractionMiddlewareConstructor, InteractionRoutes, type InteractionsConfig, type MaybeClearedClassic, type MessageContent, Middleware, type MiddlewareConstructor, type MiddlewareMetadata, MiddlewareMetadataKey, type MiddlewareOptions, MiddlewareType, MissingPermissions, ModalRoute, type OutcomeUiClassic, type OutcomeUiV2, type PermissionErrorCtors, PermissionNames, Pluggable, Plugin, type PluginArgs, type PluginCtor, type QuestionInput, RegisterCommand, RegisterEffect, type RegisterEffectMetadataEntry, type RegisterEffectOptions, RegisterEvent, type RegisterEventMetadataEntry, type RegisterEventOptions, type RepliableEventHandler, type RepliableInteractionHandler, type Repliables, type ResolverSource, RoleDoesNotExist, RoleHigherThanMe, RowComponent, type RowLike, RowTypes, type SavedEmojiType, Seedcord, type SelectMenuInteractionFor, SelectMenuRoute, SelectMenuType, SlashRoute, UnhandledEvent, UnknownException, UserNotFound, UserNotInGuild, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, type ValidNonInteractionTypes, WebhookLog, type WithChecks, attemptSendDM, buildSlashRoute, checkBotPermissions, checkPermissions, ensureBotPermissions, ensurePermissions, extractErrorResponse, fetchGuildMember, fetchManyGuildMembers, fetchManyUsers, fetchRole, fetchText, fetchUser, getBotRole, hasPermsToAssign, sendInText, throwCustomError, updateMemberRoles };