@seedcord/gateway 0.7.1 → 0.7.3

package/README.md

@@ -6,10 +6,10 @@
 </div>
 
 <div align="center">
-  <h3>The whole Discord bot, wired and typed</h3>
+  <h3>The whole Discord bot, typed end to end</h3>
   <a href="https://seedcord.org">Website</a> ·
-  <a href="https://guide.seedcord.org">Guide</a> ·
-  <a href="https://docs.seedcord.org">Reference</a> ·
+  <a href="https://seedcord.org/guide">Guide</a> ·
+  <a href="https://seedcord.org/docs">Reference</a> ·
   <a href="https://discord.gg/DzFxY58WXf">Discord</a>
 </div>
 
@@ -23,7 +23,7 @@
 
 ## About
 
-`@seedcord/gateway` runs a seedcord bot over a websocket connection, built on discord.js. A gateway connection carries message, member, voice, and reaction events. Discord never posts those to an interactions endpoint. Pick this transport when the bot reacts to any of them.
+`@seedcord/gateway` runs a seedcord bot over a websocket connection through the discord.js client, which also keeps the cache. A gateway connection carries message, member, voice, and reaction events. Discord never posts those to an interactions endpoint. Pick this transport when the bot reacts to any of them.
 
 Until v1.0.0, minor versions can break.
 

package/dist/index.d.mts

@@ -10,6 +10,7 @@ import { CommandRegistry } from "@seedcord/core/node/internal";
 import { HostAugmentTarget, HostVersion, SeedcordBrand, SeedcordInstance } from "@seedcord/types/internal";
 import { AnyCustomId } from "@seedcord/custom-id";
 import { BotConfig, Config, DeferOpts, EmojiMap, EventFrequency, HealthCheckOption, HmrAware, HmrUpdateEvent, IRateLimiter, ReplyResponse, SendOpts, TypedOmit } from "@seedcord/types";
+import { Constructor, IsUnion, NonEmptyTuple, Promisable } from "type-fest";
 import { REST } from "@discordjs/rest";
 export * from "@seedcord/errors";
 export * from "@seedcord/core";
@@ -282,181 +283,10 @@ type NonModalInteraction = Exclude<Repliables, ModalSubmitInteraction>;
  * The gateway base, fixes the core base's `TCore` to the gateway {@link Core} and adds the `getEvent`
  * gate hook.
  */
-declare abstract class BaseHandler<ValidEvent extends ValidEventTypes> extends BaseHandler$1<ValidEvent, Core> {
+export declare abstract class BaseHandler<ValidEvent extends ValidEventTypes> extends BaseHandler$1<ValidEvent, Core> {
   getEvent(): ValidEvent;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/basic.d.ts
-/**
-Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).
-
-@category Class
-*/
-type Constructor<T, Arguments extends unknown[] = any[]> = new (...arguments_: Arguments) => T;
-//#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/is-never.d.ts
-/**
-Returns a boolean for whether the given type is `never`.
-
-@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919
-@link https://stackoverflow.com/a/53984913/10292952
-@link https://www.zhenghao.io/posts/ts-never
-
-Useful in type utilities, such as checking if something does not occur.
-
-@example
-```
-import type {IsNever, And} from 'type-fest';
-
-type A = IsNever<never>;
-//=> true
-
-type B = IsNever<any>;
-//=> false
-
-type C = IsNever<unknown>;
-//=> false
-
-type D = IsNever<never[]>;
-//=> false
-
-type E = IsNever<object>;
-//=> false
-
-type F = IsNever<string>;
-//=> false
-```
-
-@example
-```
-import type {IsNever} from 'type-fest';
-
-type IsTrue<T> = T extends true ? true : false;
-
-// When a distributive conditional is instantiated with `never`, the entire conditional results in `never`.
-type A = IsTrue<never>;
-//=> never
-
-// If you don't want that behaviour, you can explicitly add an `IsNever` check before the distributive conditional.
-type IsTrueFixed<T> =
-	IsNever<T> extends true ? false : T extends true ? true : false;
-
-type B = IsTrueFixed<never>;
-//=> false
-```
-
-@category Type Guard
-@category Utilities
-*/
-type IsNever<T> = [T] extends [never] ? true : false;
-//#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/is-equal.d.ts
-/**
-Returns a boolean for whether the two given types are equal.
-
-@link https://github.com/microsoft/TypeScript/issues/27024#issuecomment-421529650
-@link https://stackoverflow.com/questions/68961864/how-does-the-equals-work-in-typescript/68963796#68963796
-
-Use-cases:
-- If you want to make a conditional branch based on the result of a comparison of two types.
-
-@example
-```
-import type {IsEqual} from 'type-fest';
-
-// This type returns a boolean for whether the given array includes the given item.
-// `IsEqual` is used to compare the given array at position 0 and the given item and then return true if they are equal.
-type Includes<Value extends readonly any[], Item> =
-	Value extends readonly [Value[0], ...infer rest]
-		? IsEqual<Value[0], Item> extends true
-			? true
-			: Includes<rest, Item>
-		: false;
-```
-
-@category Type Guard
-@category Utilities
-*/
-type IsEqual<A, B> = [A] extends [B] ? [B] extends [A] ? _IsEqual<A, B> : false : false;
-// This version fails the `equalWrappedTupleIntersectionToBeNeverAndNeverExpanded` test in `test-d/is-equal.ts`.
-type _IsEqual<A, B> = (<G>() => G extends A & G | G ? 1 : 2) extends (<G>() => G extends B & G | G ? 1 : 2) ? true : false;
-//#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/non-empty-tuple.d.ts
-/**
-Matches any non-empty tuple.
-
-@example
-```
-import type {NonEmptyTuple} from 'type-fest';
-
-const sum = (...numbers: NonEmptyTuple<number>) => numbers.reduce((total, value) => total + value, 0);
-
-sum(1, 2, 3);
-// Ok
-
-// @ts-expect-error
-sum();
-// Error: Expected at least 1 arguments, but got 0.
-```
-
-@see {@link RequireAtLeastOne} for objects
-
-@category Array
-*/
-type NonEmptyTuple<T = unknown> = readonly [T, ...T[]];
-//#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/is-union.d.ts
-/**
-Returns a boolean for whether the given type is a union.
-
-@example
-```
-import type {IsUnion} from 'type-fest';
-
-type A = IsUnion<string | number>;
-//=> true
-
-type B = IsUnion<string>;
-//=> false
-```
-*/
-type IsUnion<T> = InternalIsUnion<T>;
-/**
-The actual implementation of `IsUnion`.
-*/
-type InternalIsUnion<T, U = T> = (IsNever<T> extends true ? false : T extends any ? IsEqual<U, T> extends true ? false : true : never) extends (infer Result) ?
-// In some cases `Result` will return `false | true` which is `boolean`,
-// that means `T` has at least two types and it's a union type,
-// so we will return `true` instead of `boolean`.
-boolean extends Result ? true : Result : never; // Should never happen
-//#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/promisable.d.ts
-/**
-Create a type that represents either the value or the value wrapped in `PromiseLike`.
-
-Use-cases:
-- A function accepts a callback that may either return a value synchronously or may return a promised value.
-- This type could be the return type of `Promise#then()`, `Promise#catch()`, and `Promise#finally()` callbacks.
-
-Please upvote [this issue](https://github.com/microsoft/TypeScript/issues/31394) if you want to have this type as a built-in in TypeScript.
-
-@example
-```
-import type {Promisable} from 'type-fest';
-
-async function logger(getLogEntry: () => Promisable<string>): Promise<void> {
-	const entry = await getLogEntry();
-	console.log(entry);
-}
-
-await logger(() => 'foo');
-await logger(() => Promise.resolve('bar'));
-```
-
-@category Async
-*/
-type Promisable<T> = T | PromiseLike<T>;
-//#endregion
 //#region src/handlers/event/payload.d.ts
 /** @internal */
 type SingleEventPayload<Names extends ValidNonInteractionKeys> = IsUnion<Names> extends true ? never : ClientEvents[Names];
@@ -485,7 +315,7 @@ type EventMatchArms<Names extends ValidNonInteractionKeys, Ret> = { [Name in Nam
  * }
  * ```
  */
-declare abstract class EventHandler<in out Names extends ValidNonInteractionKeys> extends BaseHandler<ClientEvents[Names]> {
+export declare abstract class EventHandler<in out Names extends ValidNonInteractionKeys> extends BaseHandler<ClientEvents[Names]> {
   private readonly firedEvent;
   constructor(event: ClientEvents[Names], core: Core, dispatch: DispatchContext, eventName?: Names);
   protected readonly event: SingleEventPayload<Names>;
@@ -529,7 +359,7 @@ declare abstract class EventHandler<in out Names extends ValidNonInteractionKeys
  *
  * @typeParam EventName - One or more `ClientEvents` keys. Defaults to every event (catchall).
  */
-declare abstract class EventMiddleware<in out EventName extends ValidNonInteractionKeys = ValidNonInteractionKeys> extends BaseHandler<ClientEvents[EventName]> {
+export declare abstract class EventMiddleware<in out EventName extends ValidNonInteractionKeys = ValidNonInteractionKeys> extends BaseHandler<ClientEvents[EventName]> {
   private readonly firedEvent;
   constructor(event: ClientEvents[EventName], core: Core, dispatch: DispatchContext, eventName?: EventName);
   protected readonly event: SingleEventPayload<EventName>;
@@ -610,12 +440,12 @@ type EventSpec<EventKey extends ValidNonInteractionKeys> = readonly [event: Even
  * }
  * ```
  */
-declare function RegisterEvent<const Defs extends readonly EventSpec<ValidNonInteractionKeys>[]>(...defs: Defs): <HandlerCtor extends Constructor<EventHandler<Defs[number][0]>>>(constructor: HandlerCtor) => void;
+export declare function RegisterEvent<const Defs extends readonly EventSpec<ValidNonInteractionKeys>[]>(...defs: Defs): <HandlerCtor extends Constructor<EventHandler<Defs[number][0]>>>(constructor: HandlerCtor) => void;
 //#endregion
 //#region src/bot/ReplySender.d.ts
 type SentMessage = Message;
 /** Writes interaction responses through discord.js. The repliable handler bases and the dispatcher construct it. */
-declare class ReplySender extends BaseReplySender<SentMessage, GatewayFile> {
+export declare class ReplySender extends BaseReplySender<SentMessage, GatewayFile> {
   private readonly interaction;
   constructor(interaction: Repliables, dispatch: DispatchContext, bus: Bus);
   protected writeReply(response: GatewayReplyResponse | string, opts?: SendOpts): Promise<SentMessage | undefined>;
@@ -647,7 +477,7 @@ declare class ReplySender extends BaseReplySender<SentMessage, GatewayFile> {
  *
  * @typeParam Event - The repliable interaction type this handler processes
  */
-declare abstract class RepliableHandler<Event extends Repliables> extends RepliableHandler$1<Event, Core, SentMessage, GatewayFile, ReplySender> {
+export declare abstract class RepliableHandler<Event extends Repliables> extends RepliableHandler$1<Event, Core, SentMessage, GatewayFile, ReplySender> {
   /** @internal */
   getEvent(): Event;
   protected buildSender(event: Event, core: Core, dispatch: DispatchContext): ReplySender;
@@ -663,7 +493,7 @@ declare abstract class RepliableHandler<Event extends Repliables> extends Replia
  *
  * @typeParam Repliable - The interaction type this handler processes
  */
-declare abstract class InteractionHandler<Repliable extends Repliables> extends RepliableHandler<Repliable> {
+export declare abstract class InteractionHandler<Repliable extends Repliables> extends RepliableHandler<Repliable> {
   constructor(event: Repliable, core: Core, dispatch: DispatchContext);
   /**
    * Open a modal. Must be the initial response to this interaction. The modal kind rejects this call at
@@ -804,7 +634,7 @@ type FitAll<TCtor extends AnyHandlerCtor, Gates extends readonly Gate<GateContex
  * @see {@link defineEffectGate}
  * @decorator
  */
-declare function Gated<const Gates extends NonEmptyTuple<Gate<GateContextBase>>>(...gates: Gates): <TCtor extends AnyHandlerCtor>(ctor: FitAll<TCtor, Gates> extends Gates ? TCtor : FitAll<TCtor, Gates>) => void;
+export declare function Gated<const Gates extends NonEmptyTuple<Gate<GateContextBase>>>(...gates: Gates): <TCtor extends AnyHandlerCtor>(ctor: FitAll<TCtor, Gates> extends Gates ? TCtor : FitAll<TCtor, Gates>) => void;
 //#endregion
 //#region src/bot/decorators/Middlewares.d.ts
 /** Registration options for an event middleware. */
@@ -839,7 +669,7 @@ interface EventMiddlewareOptions<Events extends NonEmptyTuple<ValidNonInteractio
  *
  * @throws A **SeedcordTypeError** If `priority` is not a finite number.
  */
-declare function RegisterEventMiddleware<const Events extends NonEmptyTuple<ValidNonInteractionKeys> = NonEmptyTuple<ValidNonInteractionKeys>>(options?: EventMiddlewareOptions<Events>): (ctor: Constructor<EventMiddleware<Events[number]>>) => void;
+export declare function RegisterEventMiddleware<const Events extends NonEmptyTuple<ValidNonInteractionKeys> = NonEmptyTuple<ValidNonInteractionKeys>>(options?: EventMiddlewareOptions<Events>): (ctor: Constructor<EventMiddleware<Events[number]>>) => void;
 //#endregion
 //#region src/bot/gates/catalog/IgnoreBots.d.ts
 /**
@@ -861,7 +691,7 @@ declare function RegisterEventMiddleware<const Events extends NonEmptyTuple<Vali
  * }
  * ```
  */
-declare const IgnoreBots: import("@seedcord/core").Gate<EventGateContext<ValidNonInteractionKeys>, "IgnoreBots">;
+export declare const IgnoreBots: import("@seedcord/core").Gate<EventGateContext<ValidNonInteractionKeys>, "IgnoreBots">;
 //#endregion
 //#region src/bot/gates/catalog/Nsfw.d.ts
 /**
@@ -884,12 +714,12 @@ declare const IgnoreBots: import("@seedcord/core").Gate<EventGateContext<ValidNo
  * }
  * ```
  */
-declare function Nsfw(options?: GateNoticeOptions): Gate<InteractionGateContext<NonModalInteraction>, 'Nsfw'>;
+export declare function Nsfw(options?: GateNoticeOptions): Gate<InteractionGateContext<NonModalInteraction>, 'Nsfw'>;
 //#endregion
 //#region src/bot/injectors/EmojiInjector.d.ts
 type SavedEmojiType = GuildEmoji | ApplicationEmoji;
 /** A resolved emoji, plus the discord.js emoji it came from on {@link GatewayEmoji.source}. */
-declare class GatewayEmoji<Source extends SavedEmojiType = SavedEmojiType> extends ResolvedEmoji {
+export declare class GatewayEmoji<Source extends SavedEmojiType = SavedEmojiType> extends ResolvedEmoji {
   #private;
   constructor(source: Source);
   /** What discord.js resolved, for `.url` and the management calls. */
@@ -905,7 +735,7 @@ type InjectedEmojiMap = { [K in keyof EmojiMap]: EmojiMap[K] extends 'guild' ? G
  * The bot's resolved emojis, keyed by {@link EmojiMap}. Filled by {@link EmojiInjector} during startup.
  * Throws if you read a key the injector did not fill.
  */
-declare const Emojis: InjectedEmojiMap;
+export declare const Emojis: InjectedEmojiMap;
 //#endregion
 //#region src/bot/utilities/permissions/checkBotPermissions.d.ts
 /**
@@ -921,7 +751,7 @@ declare const Emojis: InjectedEmojiMap;
  * checkBotPermissions(textChannel, [PermissionFlagsBits.SendMessages, PermissionFlagsBits.ViewChannel]);
  * ```
  */
-declare function checkBotPermissions(target: Guild | TextChannel, scope: PermissionScope, inverse?: boolean, errors?: PermissionNoticeOverrides): void;
+export declare function checkBotPermissions(target: Guild | TextChannel, scope: PermissionScope, inverse?: boolean, errors?: PermissionNoticeOverrides): void;
 //#endregion
 //#region src/bot/utilities/permissions/checkPermissions.d.ts
 /** Options for {@link checkPermissions}. */
@@ -956,7 +786,7 @@ interface CheckPermissionOptions extends PermissionNoticeOverrides {
  * });
  * ```
  */
-declare function checkPermissions(target: Role | GuildMember, ctx: Guild, scope: PermissionScope, inverse?: boolean, errors?: PermissionNoticeOverrides): void;
+export declare function checkPermissions(target: Role | GuildMember, ctx: Guild, scope: PermissionScope, inverse?: boolean, errors?: PermissionNoticeOverrides): void;
 /**
  * Checks a {@link Role} or a {@link GuildMember} against the overwrite-resolved set in a
  * {@link TextChannel}. Refuses when a permission in `scope` is missing, or with `inverse` when one is
@@ -970,7 +800,7 @@ declare function checkPermissions(target: Role | GuildMember, ctx: Guild, scope:
  * checkPermissions(role, textChannel, [PermissionFlagsBits.SendMessages, PermissionFlagsBits.ViewChannel]);
  * ```
  */
-declare function checkPermissions(target: Role | GuildMember, ctx: TextChannel, scope: PermissionScope, inverse?: boolean, errors?: PermissionNoticeOverrides): void;
+export declare function checkPermissions(target: Role | GuildMember, ctx: TextChannel, scope: PermissionScope, inverse?: boolean, errors?: PermissionNoticeOverrides): void;
 /**
  * Checks permissions with an options object. Refuses when a permission in
  * {@link CheckPermissionOptions.scope} is missing, or with `options.inverse` when one is present.
@@ -987,13 +817,13 @@ declare function checkPermissions(target: Role | GuildMember, ctx: TextChannel,
  * });
  * ```
  */
-declare function checkPermissions(options: CheckPermissionOptions): void;
+export declare function checkPermissions(options: CheckPermissionOptions): void;
 //#endregion
 //#region src/bot/utilities/permissions/hasPermsToAssign.d.ts
 /**
  * Optional custom error constructors for {@link HasPermsToAssignOptions}.
  */
-interface AssignRoleNoticeOverrides {
+export interface AssignRoleNoticeOverrides {
   higherNotice?: new (message: string, role: Role, botRole: Role) => Notice;
   managedNotice?: new (message: string) => Notice;
   missingNotice?: new (message: string | undefined, subject: string, missingPerms: readonly string[]) => Notice;
@@ -1001,7 +831,7 @@ interface AssignRoleNoticeOverrides {
 /**
  * Options for {@link hasPermsToAssign}.
  */
-interface HasPermsToAssignOptions {
+export interface HasPermsToAssignOptions {
   targetRole: Role;
   noticeOverrides?: AssignRoleNoticeOverrides;
 }
@@ -1029,7 +859,7 @@ interface HasPermsToAssignOptions {
  * });
  * ```
  */
-declare function hasPermsToAssign(roleOrOptions: Role | HasPermsToAssignOptions): void;
+export declare function hasPermsToAssign(roleOrOptions: Role | HasPermsToAssignOptions): void;
 //#endregion
 //#region src/bot/confirm/getConfirmation.d.ts
 type Outcome = ReplyResponse | (() => Promisable<ReplyResponse>);
@@ -1102,7 +932,7 @@ interface DefaultConfirmOptions extends ConfirmOptions {
  * }
  * ```
  */
-declare function getConfirmation(handler: RepliableHandler<NonModalInteraction>, prompt: string, options?: DefaultConfirmOptions): Promise<boolean>;
+export declare function getConfirmation(handler: RepliableHandler<NonModalInteraction>, prompt: string, options?: DefaultConfirmOptions): Promise<boolean>;
 /**
  * Shows a confirm/cancel prompt you build yourself and resolves to `true` only if the invoking user clicks
  * confirm. The factory receives the two minted button ids. Set them on your own buttons. A cancel click or a
@@ -1155,7 +985,7 @@ declare function getConfirmation(handler: RepliableHandler<NonModalInteraction>,
  * if (!confirmed) return;
  * ```
  */
-declare function getConfirmation(handler: RepliableHandler<NonModalInteraction>, prompt: (ids: {
+export declare function getConfirmation(handler: RepliableHandler<NonModalInteraction>, prompt: (ids: {
   confirm: string;
   cancel: string;
 }) => Promisable<ReplyResponse>, options?: ConfirmOptions): Promise<boolean>;
@@ -1197,7 +1027,7 @@ type InteractionOf<Kind extends MiddlewareKind> = InteractionForKind[Kind];
  * }
  * ```
  */
-declare abstract class InteractionMiddleware<in out Kind extends MiddlewareKind = MiddlewareKind> extends RepliableHandler<InteractionOf<Kind>> {
+export declare abstract class InteractionMiddleware<in out Kind extends MiddlewareKind = MiddlewareKind> extends RepliableHandler<InteractionOf<Kind>> {
   /** @internal */
   readonly [MiddlewareKindsBrand]?: Kind;
   constructor(event: InteractionOf<Kind>, core: Core, dispatch: DispatchContext, sender: ReplySender);
@@ -1266,7 +1096,7 @@ type SlashMatchArms<Route extends keyof SlashRegistry, Cache extends CacheType,
  * }
  * ```
  */
-declare abstract class SlashHandler<Route extends keyof SlashRegistry, Cache extends CacheType = CacheFor<Route>> extends InteractionHandler<ChatInputCommandInteraction<Cache>> {
+export declare abstract class SlashHandler<Route extends keyof SlashRegistry, Cache extends CacheType = CacheFor<Route>> extends InteractionHandler<ChatInputCommandInteraction<Cache>> {
   /** @internal */
   readonly [SlashRouteBrand]?: Route;
   /**
@@ -1332,7 +1162,7 @@ type MessageMenuArms<Names extends NamesFor<ApplicationCommandType.Message>, Ret
  * }
  * ```
  */
-declare abstract class UserContextMenuHandler<Names extends NamesFor<ApplicationCommandType.User>, Cache extends CacheType = MenuCacheFor<ApplicationCommandType.User, Names>> extends InteractionHandler<UserContextMenuCommandInteraction<Cache>> {
+export 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 */
@@ -1388,7 +1218,7 @@ declare abstract class UserContextMenuHandler<Names extends NamesFor<Application
  * }
  * ```
  */
-declare abstract class MessageContextMenuHandler<Names extends NamesFor<ApplicationCommandType.Message>, Cache extends CacheType = MenuCacheFor<ApplicationCommandType.Message, Names>> extends InteractionHandler<MessageContextMenuCommandInteraction<Cache>> {
+export declare abstract class MessageContextMenuHandler<Names extends NamesFor<ApplicationCommandType.Message>, Cache extends CacheType = MenuCacheFor<ApplicationCommandType.Message, Names>> extends InteractionHandler<MessageContextMenuCommandInteraction<Cache>> {
   /** @internal */
   readonly [ContextMenuKindBrand]?: ApplicationCommandType.Message;
   /** @internal */
@@ -1447,7 +1277,7 @@ type FocusedArms<Route extends keyof SlashRegistry, Ret> = { [Name in Autocomple
  * }
  * ```
  */
-declare abstract class AutocompleteHandler<Route extends keyof SlashRegistry, Cache extends CacheType = CacheFor<Route>> extends BaseHandler<AutocompleteInteraction<Cache>> {
+export 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);
@@ -1506,7 +1336,7 @@ type ComponentInteraction = ButtonInteraction | ModalSubmitInteraction | AnySele
  * @typeParam Event - The component interaction type this handler processes
  * @typeParam Defs - The customId route definitions registered on the concrete handler
  */
-declare abstract class ComponentHandler<Event extends ComponentInteraction, Defs extends readonly AnyCustomId[]> extends InteractionHandler<Event> implements HasComponentDefs<Defs> {
+export declare abstract class ComponentHandler<Event extends ComponentInteraction, Defs extends readonly AnyCustomId[]> extends InteractionHandler<Event> implements HasComponentDefs<Defs> {
   /** @internal */
   readonly [ComponentDefsBrand]?: Defs;
   /** Rewrite the source message this component interaction came from. */
@@ -1576,7 +1406,7 @@ declare abstract class ComponentHandler<Event extends ComponentInteraction, Defs
  * }
  * ```
  */
-declare abstract class ButtonHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends ComponentHandler<ButtonInteraction<Cache>, Defs> {
+export declare abstract class ButtonHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends ComponentHandler<ButtonInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: InteractionKind.Button;
 }
@@ -1605,7 +1435,7 @@ 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> {
+export declare abstract class ModalHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends ComponentHandler<ModalSubmitInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: InteractionKind.Modal;
   /** The fields this modal submitted, read by custom id. */
@@ -1628,7 +1458,7 @@ declare abstract class ModalHandler<Defs extends readonly AnyCustomId[], Cache e
  * @typeParam Event - The select menu interaction type this handler processes
  * @typeParam Defs - The customId route definitions registered on the concrete handler
  */
-declare abstract class SelectMenuHandler<Event extends AnySelectMenuInteraction, Defs extends readonly AnyCustomId[]> extends ComponentHandler<Event, Defs> {
+export declare abstract class SelectMenuHandler<Event extends AnySelectMenuInteraction, Defs extends readonly AnyCustomId[]> extends ComponentHandler<Event, Defs> {
   /** The values this select picked. On every kind but the string menu they are snowflake ids. */
   protected get values(): string[];
 }
@@ -1653,7 +1483,7 @@ declare abstract class SelectMenuHandler<Event extends AnySelectMenuInteraction,
  * }
  * ```
  */
-declare abstract class StringMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<StringSelectMenuInteraction<Cache>, Defs> {
+export declare abstract class StringMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<StringSelectMenuInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: InteractionKind.StringMenu;
 }
@@ -1677,7 +1507,7 @@ declare abstract class StringMenuHandler<Defs extends readonly AnyCustomId[], Ca
  * }
  * ```
  */
-declare abstract class UserMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<UserSelectMenuInteraction<Cache>, Defs> {
+export declare abstract class UserMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<UserSelectMenuInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: InteractionKind.UserMenu;
   /** The users this select picked. */
@@ -1704,7 +1534,7 @@ declare abstract class UserMenuHandler<Defs extends readonly AnyCustomId[], Cach
  * }
  * ```
  */
-declare abstract class RoleMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<RoleSelectMenuInteraction<Cache>, Defs> {
+export declare abstract class RoleMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<RoleSelectMenuInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: InteractionKind.RoleMenu;
   /** The roles this select picked. */
@@ -1729,7 +1559,7 @@ declare abstract class RoleMenuHandler<Defs extends readonly AnyCustomId[], Cach
  * }
  * ```
  */
-declare abstract class ChannelMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<ChannelSelectMenuInteraction<Cache>, Defs> {
+export declare abstract class ChannelMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<ChannelSelectMenuInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: InteractionKind.ChannelMenu;
   /** The channels this select picked. */
@@ -1754,7 +1584,7 @@ declare abstract class ChannelMenuHandler<Defs extends readonly AnyCustomId[], C
  * }
  * ```
  */
-declare abstract class MentionableMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<MentionableSelectMenuInteraction<Cache>, Defs> {
+export declare abstract class MentionableMenuHandler<Defs extends readonly AnyCustomId[], Cache extends CacheType = 'cached'> extends SelectMenuHandler<MentionableSelectMenuInteraction<Cache>, Defs> {
   /** @internal */
   readonly [ComponentKindBrand]?: InteractionKind.MentionableMenu;
   /** The users this select picked. */
@@ -1803,7 +1633,7 @@ type PaginatorHandlerCtor<Prefix extends string> = new (...args: ConstructorPara
  * export class BansNav extends Bans.Handler {}
  * ```
  */
-declare class Paginator<Item, const Prefix extends string> extends PaginatorBase<Item, Prefix, PageContext> {
+export declare class Paginator<Item, const Prefix extends string> extends PaginatorBase<Item, Prefix, PageContext> {
   /** The nav handler base. Extend it with an empty body and decorate it, `@ButtonRoute(p.cursor)`. */
   readonly Handler: PaginatorHandlerCtor<Prefix>;
   constructor(config: PaginatorConfig<Item, Prefix, PageContext>);
@@ -1838,7 +1668,7 @@ type PageSource<Item> = PageSourceBase<Item, PageContext>;
  *
  * @typeParam Item - The item type, inferred from the loader's return.
  */
-declare class ArraySource<Item> extends ArraySourceBase<Item, PageContext> {}
+export 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
@@ -1847,7 +1677,7 @@ declare class ArraySource<Item> extends ArraySourceBase<Item, PageContext> {}
  *
  * @typeParam Item - The item type, inferred from the fetcher's slice.
  */
-declare class CursorSource<Item> extends CursorSourceBase<Item, PageContext> {}
+export declare class CursorSource<Item> extends CursorSourceBase<Item, PageContext> {}
 //#endregion
 //#region src/subscribers/index.d.ts
 /**
@@ -1855,14 +1685,14 @@ declare class CursorSource<Item> extends CursorSourceBase<Item, PageContext> {}
  *
  * @typeParam KeyOfSubscribers - The subscription key this handler receives
  */
-declare abstract class Subscriber<KeyOfSubscribers extends SubscriptionKey> extends Subscriber$1<KeyOfSubscribers, Core> {}
+export declare abstract class Subscriber<KeyOfSubscribers extends SubscriptionKey> extends Subscriber$1<KeyOfSubscribers, Core> {}
 /**
  * Base class for a gateway subscriber that delivers its event to a Discord webhook, binding
  * `this.core` to the gateway {@link Core}.
  *
  * @typeParam KeyOfSubscribers - The subscription key this reporter receives
  */
-declare abstract class WebhookLog<KeyOfSubscribers extends SubscriptionKey> extends WebhookLog$1<KeyOfSubscribers, Core> {}
+export declare abstract class WebhookLog<KeyOfSubscribers extends SubscriptionKey> extends WebhookLog$1<KeyOfSubscribers, Core> {}
 //#endregion
 //#region src/plugin.d.ts
 /**
@@ -1881,7 +1711,7 @@ type GatewayPluginOptions = TypedOmit<PluginOptions$1, 'transport' | 'runtime'>
  *
  * @typeParam Opts - The transport and runtime the plugin declares.
  */
-declare abstract class Plugin<Opts extends GatewayPluginOptions = {
+export declare abstract class Plugin<Opts extends GatewayPluginOptions = {
   transport: 'gateway';
   runtime: 'server';
 }> extends Plugin$1<Opts, Core> {}
@@ -1891,7 +1721,7 @@ declare abstract class Plugin<Opts extends GatewayPluginOptions = {
  * The gateway bot host. Opens a discord.js gateway session, discovers handlers, and runs
  * coordinated startup and shutdown. Attach plugins with `attach()`.
  */
-declare class Seedcord extends Pluggable<'gateway', 'server'> implements Core, SeedcordInstance {
+export declare class Seedcord extends Pluggable<'gateway', 'server'> implements SeedcordInstance {
   readonly config: GatewayConfig;
   /** @internal */
   readonly [SeedcordBrand] = true;
@@ -1932,7 +1762,7 @@ declare class Seedcord extends Pluggable<'gateway', 'server'> implements Core, S
 //#endregion
 //#region src/version.d.ts
 /** Package version */
-declare const version: string;
+export declare const version: string;
 //#endregion
-export { ArraySource, AssignRoleNoticeOverrides, AutocompleteHandler, BaseHandler, ButtonHandler, ChannelMenuHandler, type CheckPermissionOptions, ComponentHandler, type ConfirmOptions, type Core, CursorSource, type DefaultConfirmOptions, Emojis, type EventGateContext, EventHandler, EventMiddleware, type EventMiddlewareOptions, 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, MentionableMenuHandler, MessageContextMenuHandler, ModalHandler, Nsfw, type PageContext, type PageSource, Paginator, Plugin, type PluginLifecycleSpec, type PluginOptions, RegisterEvent, RegisterEventMiddleware, type RegisterEventOptions, RepliableHandler, type Repliables, ReplySender, RoleMenuHandler, Seedcord, SelectMenuHandler, type SentMessage, SlashHandler, type SlashOptions, StringMenuHandler, Subscriber, UserContextMenuHandler, UserMenuHandler, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, WebhookLog, WinstonConsoleSink, WinstonFileSink, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
+export { type CheckPermissionOptions, type ConfirmOptions, type Core, type DefaultConfirmOptions, type EventGateContext, type EventMiddlewareOptions, type EventSpec, type EventsConfig, type GateContext, type GatewayBotConfig, type GatewayConfig, type GatewayFile, type GatewayPluginOptions, type GatewayReplyResponse, type InjectedEmojiMap, type InteractionGateContext, type PageContext, type PageSource, type PluginLifecycleSpec, type PluginOptions, type RegisterEventOptions, type Repliables, type SentMessage, type SlashOptions, type ValidEventTypes, type ValidInteractionTypes, type ValidNonInteractionKeys, WinstonConsoleSink, WinstonFileSink };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1869,10 +1869,9 @@ var EventDispatcher = class {
 			const handlers = this.eventMap.get(event);
 			if (!handlers) continue;
 			const index = handlers.findIndex((h) => h.ctor === handlerClass);
-			if (index !== -1) {
-				handlers.splice(index, 1);
-				if (handlers.length === 0) this.eventMap.delete(event);
-			}
+			if (!(index !== -1)) continue;
+			handlers.splice(index, 1);
+			if (handlers.length === 0) this.eventMap.delete(event);
 		}
 	}
 	unregisterMiddleware(middlewareCtor) {
@@ -2225,14 +2224,12 @@ var InteractionDispatcher = class {
 	}
 	registerMiddleware(middlewareCtor, relativePath) {
 		const metadata = this.middlewares.register(middlewareCtor);
-		if (!metadata) return;
-		if (this.loading) {
-			const scope = metadata.keys ? `${metadata.priority}, ${metadata.keys.join(", ")}` : metadata.priority;
-			this.loadedMiddlewares.push({
-				name: `${middlewareCtor.name} (${String(scope)})`,
-				from: formatFilePath(relativePath)
-			});
-		}
+		if (!metadata || !this.loading) return;
+		const scope = metadata.keys ? `${metadata.priority}, ${metadata.keys.join(", ")}` : metadata.priority;
+		this.loadedMiddlewares.push({
+			name: `${middlewareCtor.name} (${String(scope)})`,
+			from: formatFilePath(relativePath)
+		});
 	}
 	isHandlerClass(obj) {
 		if (typeof obj !== "function") return false;
@@ -2494,7 +2491,7 @@ function assertGuildsIntent(intents, commands) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.152.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -2577,13 +2574,12 @@ var Bot = class {
 		if (this.#events) await this.#events.init();
 		await this.#login(token);
 		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());
-		}
+		if (!this.#commandRegistry) return;
+		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());
 	}
 	async #stop() {
 		this.#client.removeAllListeners();
@@ -2616,7 +2612,7 @@ function initBot(bot) {
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.7.1";
+const version = "0.7.3";
 
 //#endregion
 //#region src/Seedcord.ts