@seedcord/gateway 0.1.4 → 0.2.0-next.0

package/README.md

@@ -1,16 +1,45 @@
-<p align="center">
+<div align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://cdn.seedcord.org/assets/wordmark-dark.webp" />
     <img src="https://cdn.seedcord.org/assets/wordmark-light.webp" alt="seedcord" width="440" />
   </picture>
-</p>
+</div>
 
----
+<div align="center">
+  <h3>The whole Discord bot, wired and typed</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://discord.gg/DzFxY58WXf">Discord</a>
+</div>
 
-_This repository is a work in progress._
+<br />
 
-- There are no stable releases yet but changes are being made actively.
-- Until a major v1.0.0 release for seedcord, expect breaking changes in minor versions.
-- Documentation will come soon as well!
+<div align="center">
 
-If you'd like to try it out, you can check out the code in `mock`
+[![npm](https://img.shields.io/npm/v/@seedcord/gateway?style=flat-square&logo=npm&logoColor=c8341f&label=&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/@seedcord/gateway) [![node](https://img.shields.io/node/v/@seedcord/gateway?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![license](https://img.shields.io/npm/l/@seedcord/gateway?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)
+
+</div>
+
+## 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.
+
+Until v1.0.0, minor versions can break.
+
+## Installation
+
+```sh
+pnpm add @seedcord/gateway discord.js
+```
+
+`discord.js`, `envapt`, and `typescript` are peer dependencies. `pnpm create seedcord` sets all of it up.
+
+## What it adds over the core
+
+Everything in `@seedcord/core`, plus the parts that use a live connection:
+
+- `Seedcord`, the class that connects and holds the discord.js client
+- event subscribers, through `Subscriber` and `WebhookLog`
+- `getConfirmation`, which waits on a button press and returns the answer
+- pagination sources bound to the gateway

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import "reflect-metadata";
-import { AnyCustomId, AutocompletableNames, BaseReplySender, ChoiceValueOf, EntryFor, FocusedField, GateFitsWith, HasComponentDefs, MatchArms, ModalLike, PageCursor, SingleParams, SlashOptions as SlashOptions$1 } 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, SelectMenuKind, SlashOptionRegistry, Subscriber as Subscriber$1, SubscriptionKey, WebhookLog as WebhookLog$1 } from "@seedcord/core";
+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 { 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";
@@ -80,10 +80,12 @@ interface GatewayConfig extends Config {
 /**
  * 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 logger: Logger;
+  readonly [loggerSlot]: Logger;
   private isInitialized;
   private readonly _client;
   private readonly interactions?;
@@ -479,6 +481,66 @@ 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;
 //#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> {
+  private readonly interaction;
+  constructor(interaction: Repliables, routeId: string, bus: Bus);
+  protected writeReply(response: GatewayReplyResponse | string, opts?: SendOpts): Promise<SentMessage | undefined>;
+  protected writeDefer(opts?: DeferOpts): Promise<void>;
+  protected writeDeferUpdate(): Promise<void>;
+  protected writeUpdate(response: GatewayReplyResponse | string): Promise<SentMessage | undefined>;
+  protected writeFollowUp(response: GatewayReplyResponse | string, opts?: SendOpts): Promise<SentMessage>;
+  protected writeEditOriginal(response: GatewayReplyResponse | string): Promise<SentMessage>;
+  protected writeEditTarget(targetId: string, response: GatewayReplyResponse | string): Promise<SentMessage>;
+  protected writeDeleteOriginal(): Promise<void>;
+  protected writeDeleteTarget(targetId: string): Promise<void>;
+  protected writeModal(data: APIModalInteractionResponseCallbackData): Promise<void>;
+  protected guardModalSource(): void;
+  private rejectModalSubmit;
+  private sourceInteraction;
+  private replyOptions;
+  private editOptions;
+  private updateOptions;
+  private createdMessage;
+}
+//#endregion
+//#region src/handlers/RepliableHandler.d.ts
+/**
+ * Shared base the repliable interaction handlers extend.
+ *
+ * Not a public entry point. Extend {@link SlashHandler}, {@link ButtonHandler}, {@link ModalHandler},
+ * {@link SelectMenuHandler}, or {@link ContextMenuHandler} instead. This class binds the core reply base
+ * to the gateway sender.
+ *
+ * @typeParam Event - The repliable interaction type this handler processes
+ */
+declare abstract class RepliableHandler<Event extends Repliables> extends RepliableHandler$1<Event, Core, SentMessage, GatewayFile, ReplySender> {
+  /** @internal */
+  getEvent(): Event;
+  protected buildSender(event: Event, core: Core, routeId: string): ReplySender;
+}
+//#endregion
+//#region src/handlers/interaction/InteractionHandler.d.ts
+/**
+ * Shared base the typed interaction handlers extend.
+ *
+ * Not a public entry point. Extend {@link SlashHandler}, {@link ButtonHandler}, {@link ModalHandler},
+ * or {@link SelectMenuHandler} instead. This class adds `showModal` on top of the reply members those bases
+ * share.
+ *
+ * @typeParam Repliable - The interaction type this handler processes
+ */
+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
+   * compile time (Discord forbids a modal in response to a modal).
+   */
+  protected showModal(this: InteractionHandler<NonModalInteraction>, modal: ModalLike): Promise<void>;
+}
+//#endregion
 //#region src/bot/gates/Gate.d.ts
 /**
  * The interaction arm. It extends {@link GuildPermissionsContext} with the live interaction and
@@ -566,66 +628,6 @@ interface EventGateContext<Names extends ValidNonInteractionKeys = ValidNonInter
  */
 type GateContext = InteractionGateContext | EventGateContext;
 //#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> {
-  private readonly interaction;
-  constructor(interaction: Repliables, routeId: string, bus: Bus);
-  protected writeReply(response: GatewayReplyResponse | string, opts?: SendOpts): Promise<SentMessage | undefined>;
-  protected writeDefer(opts?: DeferOpts): Promise<void>;
-  protected writeDeferUpdate(): Promise<void>;
-  protected writeUpdate(response: GatewayReplyResponse | string): Promise<SentMessage | undefined>;
-  protected writeFollowUp(response: GatewayReplyResponse | string, opts?: SendOpts): Promise<SentMessage>;
-  protected writeEditOriginal(response: GatewayReplyResponse | string): Promise<SentMessage>;
-  protected writeEditTarget(targetId: string, response: GatewayReplyResponse | string): Promise<SentMessage>;
-  protected writeDeleteOriginal(): Promise<void>;
-  protected writeDeleteTarget(targetId: string): Promise<void>;
-  protected writeModal(data: APIModalInteractionResponseCallbackData): Promise<void>;
-  protected guardModalSource(): void;
-  private rejectModalSubmit;
-  private sourceInteraction;
-  private replyOptions;
-  private editOptions;
-  private updateOptions;
-  private createdMessage;
-}
-//#endregion
-//#region src/handlers/RepliableHandler.d.ts
-/**
- * Shared base the repliable interaction handlers extend.
- *
- * Not a public entry point. Extend {@link SlashHandler}, {@link ButtonHandler}, {@link ModalHandler},
- * {@link SelectMenuHandler}, or {@link ContextMenuHandler} instead. This class binds the core reply base
- * to the gateway sender.
- *
- * @typeParam Event - The repliable interaction type this handler processes
- */
-declare abstract class RepliableHandler<Event extends Repliables> extends RepliableHandler$1<Event, Core, SentMessage, GatewayFile, ReplySender> {
-  /** @internal */
-  getEvent(): Event;
-  protected buildSender(event: Event, core: Core, routeId: string): ReplySender;
-}
-//#endregion
-//#region src/handlers/interaction/InteractionHandler.d.ts
-/**
- * Shared base the typed interaction handlers extend.
- *
- * Not a public entry point. Extend {@link SlashHandler}, {@link ButtonHandler}, {@link ModalHandler},
- * or {@link SelectMenuHandler} instead. This class adds `showModal` on top of the reply members those bases
- * share.
- *
- * @typeParam Repliable - The interaction type this handler processes
- */
-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
-   * compile time (Discord forbids a modal in response to a modal).
-   */
-  protected showModal(this: InteractionHandler<NonModalInteraction>, modal: ModalLike): Promise<void>;
-}
-//#endregion
 //#region src/bot/gates/matching.d.ts
 type AnyHandlerCtor = abstract new (...args: never[]) => {
   execute(): Promise<void>;
@@ -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>> {
   /** @internal */
-  readonly __slashRoute?: Route;
+  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`
@@ -795,7 +797,7 @@ type TargetMemberFor<Kind extends ContextMenuKind, Cache extends CacheType> = Ki
  */
 declare abstract class ContextMenuHandler<Kind extends ContextMenuKind, Cache extends CacheType = 'cached'> extends InteractionHandler<InteractionFor<Kind, Cache>> {
   /** @internal */
-  readonly __ctxKind?: Kind;
+  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
@@ -830,7 +832,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>> {
   /** @internal */
-  readonly __autocompleteRoute?: Route;
+  readonly [AutocompleteRouteBrand]?: Route;
   constructor(event: AutocompleteInteraction<Cache>, core: Core, dispatch?: DispatchContext);
   private decodedFocused?;
   /**
@@ -889,7 +891,7 @@ type ComponentInteraction = ButtonInteraction | ModalSubmitInteraction | AnySele
  */
 declare abstract class ComponentHandler<Event extends ComponentInteraction, Defs extends readonly AnyCustomId[]> extends InteractionHandler<Event> implements HasComponentDefs<Defs> {
   /** @internal */
-  readonly __componentDefs?: Defs;
+  readonly [ComponentDefsBrand]?: Defs;
   /** Rewrite the source message this component interaction came from. */
   protected update(response: GatewayReplyResponse | string): Promise<SentMessage>;
   /** Acknowledge the component without changing the source message. */
@@ -959,7 +961,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> {
   /** @internal */
-  readonly __component?: 'button';
+  readonly [ComponentKindBrand]?: 'button';
 }
 //#endregion
 //#region src/handlers/interaction/components/ModalHandler.d.ts
@@ -988,7 +990,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> {
   /** @internal */
-  readonly __component?: 'modal';
+  readonly [ComponentKindBrand]?: 'modal';
   /** 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. */
@@ -1023,7 +1025,7 @@ 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 __component?: Kind;
+  readonly [ComponentKindBrand]?: Kind;
 }
 //#endregion
 //#region src/bot/decorators/Middlewares.d.ts
@@ -1113,11 +1115,20 @@ declare const IgnoreBots: import("@seedcord/core").Gate<EventGateContext<ValidNo
 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 {
+  #private;
+  constructor(source: Source);
+  /** What discord.js resolved, for `.url` and the management calls. */
+  get source(): Source;
+}
 /**
- * The global {@link Emojis} accessor type. Each key resolves to its precise class, `GuildEmoji` for a `'guild'`
- * tag and `ApplicationEmoji` for an `'application'` tag, the tags `seedcord codegen` writes into {@link EmojiMap}.
+ * The global {@link Emojis} accessor type. Each key's `source` resolves to its precise class, `GuildEmoji`
+ * for a `'guild'` tag and `ApplicationEmoji` for an `'application'` tag, the tags `seedcord codegen`
+ * writes into {@link EmojiMap}.
  */
-type InjectedEmojiMap = { [K in keyof EmojiMap]: EmojiMap[K] extends 'guild' ? GuildEmoji : ApplicationEmoji; };
+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.
@@ -1523,5 +1534,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, 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, 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 };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,10 +1,10 @@
 import "reflect-metadata";
 import { installNodeDefaults } from "@seedcord/logger/node";
-import { BaseReplySender, CommandInjector, EventMetadataKey, FaultThrottle, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, NoticeCard, PermissionNames, PublishDefault, accessorStore, areRoutes, asError, clearStore, decodeComponentRoute, deferFlags, guardedAccessor, isEmojiTuple, outcomeFor, pickNotice, prefixOf, queuedMsFor, reportDispatch, reportedWrite, routeIdOf, runHandlerGates, sendFlags, setBotColor, slowGateMonitor } from "@seedcord/core/internal";
-import { SeedcordErrorCode } from "@seedcord/errors";
+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 { 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, RowComponent, Silence, Subscriber as Subscriber$1, WebhookLog as WebhookLog$1, assertPermissions, defineGate } from "@seedcord/core";
-import { Logger, LoggerChannelRegistry, paint } from "@seedcord/logger";
+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 { ButtonBuilder, TextDisplayBuilder } from "@discordjs/builders";
 import { buildSlashRoute } from "@seedcord/utils/internal";
@@ -13,7 +13,6 @@ import { CommandRegistry, CoordinatedShutdown, CoordinatedStartup, HealthCheck,
 import { MemoryRateLimiter } from "@seedcord/rate-limiter";
 import { SeedcordBrand } from "@seedcord/types/internal";
 import { Envapter } from "envapt";
-import chalk from "chalk";
 import { Envapt } from "envapt/legacy";
 import { HmrModuleHandler } from "@seedcord/core/hmr";
 import { formatFilePath, hasKeys } from "@seedcord/utils";
@@ -260,6 +259,18 @@ function Nsfw(options) {
 
 //#endregion
 //#region src/bot/injectors/EmojiInjector.ts
+/** A resolved emoji, plus the discord.js emoji it came from on {@link GatewayEmoji.source}. */
+var GatewayEmoji = class extends ResolvedEmoji {
+	#source;
+	constructor(source) {
+		super(source.name, source.id, source.animated);
+		this.#source = source;
+	}
+	/** What discord.js resolved, for `.url` and the management calls. */
+	get source() {
+		return this.#source;
+	}
+};
 const emojiStorage = accessorStore();
 /**
 * The bot's resolved emojis, keyed by {@link EmojiMap}. Filled by {@link EmojiInjector} during startup.
@@ -304,7 +315,7 @@ var EmojiInjector = class {
 			failures.push(`  - "${emojiName}" for "${key}" was not found in guild ${guildId}`);
 			return;
 		}
-		emojiStorage[key] = guildEmoji;
+		emojiStorage[key] = new GatewayEmoji(guildEmoji);
 	}
 	resolveString(key, emojiName, failures) {
 		const appEmoji = this.core.bot.client.application?.emojis.cache.find((e) => e.name === emojiName);
@@ -312,7 +323,7 @@ var EmojiInjector = class {
 			failures.push(`  - "${emojiName}" for "${key}" was not found among the application emojis`);
 			return;
 		}
-		emojiStorage[key] = appEmoji;
+		emojiStorage[key] = new GatewayEmoji(appEmoji);
 	}
 	clearEmojis() {
 		clearStore(emojiStorage);
@@ -1350,35 +1361,26 @@ function extractErrorResponse(error, core, origin) {
 		response: override ? new override(uuid).render(ctx) : new Fault().render(ctx)
 	};
 }
-function withThrottle(core, origin, error, publish) {
-	const throttle = FaultThrottle.for(core);
-	const key = faultKey(origin, error);
-	if (!throttle.shouldReport(key)) {
-		logger$2.debug(`throttled duplicate fault ${key}`);
-		return;
-	}
-	publish();
-	throttle.markReported(key);
-}
 function reportFault(denial, core, origin, uuid) {
 	logger$2.error(`${denial.name}: ${uuid}`, denial);
-	withThrottle(core, origin, denial, () => {
-		if (origin.interaction) core.bus[PublishDefault]("handledException", {
-			denial,
-			uuid,
-			source: buildInteractionSource(origin.interaction)
-		});
-		else if (origin.event) core.bus[PublishDefault]("handledException", {
-			denial,
-			uuid,
-			source: buildEventSource(origin.event, origin)
-		});
-		else core.bus[PublishDefault]("unknownException", {
-			uuid,
-			error: denial,
-			...scalarActors(origin),
-			metadata: metadataFor(origin)
-		});
+	if (origin.interaction) core.bus[PublishDefault]("handledException", {
+		denial,
+		uuid,
+		routeId: origin.routeId,
+		source: buildInteractionSource(origin.interaction)
+	});
+	else if (origin.event) core.bus[PublishDefault]("handledException", {
+		denial,
+		uuid,
+		routeId: origin.routeId,
+		source: buildEventSource(origin.event, origin)
+	});
+	else core.bus[PublishDefault]("unknownException", {
+		uuid,
+		error: denial,
+		routeId: origin.routeId,
+		...scalarActors(origin),
+		metadata: metadataFor(origin)
 	});
 }
 function causeLine(error) {
@@ -1390,13 +1392,12 @@ function causeLine(error) {
 function reportRawFault(error, core, origin, uuid) {
 	if (core.config.errors?.errorStack ?? false) logger$2.error(uuid, error);
 	else logger$2.error(`${uuid} | ${error.message}${causeLine(error)}`);
-	withThrottle(core, origin, error, () => {
-		core.bus[PublishDefault]("unknownException", {
-			uuid,
-			error,
-			...scalarActors(origin),
-			metadata: metadataFor(origin)
-		});
+	core.bus[PublishDefault]("unknownException", {
+		uuid,
+		error,
+		routeId: origin.routeId,
+		...scalarActors(origin),
+		metadata: metadataFor(origin)
 	});
 }
 function scalarActors(origin) {
@@ -1430,19 +1431,6 @@ function buildEventSource(event, origin) {
 		raw: event.args
 	};
 }
-function faultKey(origin, error) {
-	const name = error instanceof Notice ? error.name : error instanceof DiscordAPIError ? String(error.code) : error.constructor.name;
-	if (origin.event) return `${origin.event.name}:${origin.event.handler}:${name}`;
-	if (origin.interaction) return `${interactionRoute(origin.interaction)}:${name}`;
-	if (origin.route) return `autocomplete:${origin.route}:${name}`;
-	return `autocomplete:${name}`;
-}
-function interactionRoute(interaction) {
-	if (interaction.isChatInputCommand()) return slashRouteOf(interaction);
-	if (interaction.isContextMenuCommand()) return interaction.commandName;
-	if (interaction.isButton() || interaction.isAnySelectMenu() || interaction.isModalSubmit()) return prefixOf(interaction.customId) || interaction.customId;
-	return "interaction";
-}
 function buildInteractionSource(interaction) {
 	const command = interaction.isChatInputCommand() ? slashRouteOf(interaction) : interaction.isContextMenuCommand() ? interaction.commandName : null;
 	const customId = interaction.isButton() || interaction.isAnySelectMenu() || interaction.isModalSubmit() ? interaction.customId : null;
@@ -1489,6 +1477,7 @@ function handleEventFault(caught, eventName, handlerName, args, core) {
 			args,
 			channelId: actor.channelId
 		},
+		routeId: `event:${eventName}:${handlerName}`,
 		guild: actor.guild,
 		user: actor.user
 	});
@@ -1672,7 +1661,7 @@ var EventDispatcher = class {
 		if (this.attachedEvents.has(eventName)) return;
 		this.attachedEvents.add(eventName);
 		const handlerEntries = this.eventMap.get(eventName);
-		this.logger.debug(`Attaching ${paint.mint.bold(eventName)} to the client with ${paint.mute(handlerEntries?.length ?? 0)} handler(s)`);
+		this.logger.debug(`Attaching ${paint.sky.bold(eventName)} to the client with ${paint.mute(handlerEntries?.length ?? 0)} handler(s)`);
 		this.core.bot.client.on(eventName, (...args) => {
 			if (this.draining) return;
 			this.core.bus[PublishDefault]("anyEvent", {
@@ -1710,7 +1699,7 @@ var EventDispatcher = class {
 	}
 	async processHandler(eventName, ctor, args) {
 		try {
-			this.logger.debug(`Processing ${paint.mint.bold(eventName)} with ${paint.mute(ctor.name)}`);
+			this.logger.debug(`Processing ${paint.sky.bold(eventName)} with ${paint.mute(ctor.name)}`);
 			const handler = new ctor(args, this.core, eventName);
 			const eventCtx = eventGateContext(eventName, args, this.core);
 			await runHandlerGates(ctor, eventCtx);
@@ -1767,16 +1756,17 @@ async function handleInteractionFault(caught, interaction, core, routeId, sender
 	}
 	if (interaction.isAutocomplete()) {
 		extractErrorResponse(error, core, {
+			routeId,
 			guild: interaction.guild,
 			user: interaction.user,
-			metadata: interaction,
-			route: slashRouteOf(interaction)
+			metadata: interaction
 		});
 		await sendEmptyChoices(interaction, core, routeId);
 		return;
 	}
 	const { response } = extractErrorResponse(error, core, {
 		interaction,
+		routeId,
 		guild: interaction.guild,
 		user: interaction.user,
 		metadata: interaction
@@ -1867,11 +1857,11 @@ var InteractionDispatcher = class {
 		});
 	}
 	warnUnhandledRoutes(commandLeaves) {
-		for (const route of commandLeaves) if (!this.slashMap.has(route)) this.logger.warn(`Slash route ${paint.sky.bold(route)} has no registered ${chalk.bold("@SlashRoute")} handler.`);
+		for (const route of commandLeaves) if (!this.slashMap.has(route)) this.logger.warn(`Slash route ${paint.sky.bold(route)} has no registered ${paint.bold("@SlashRoute")} handler.`);
 	}
 	warnUnhandledContextMenuRoutes(leaves) {
-		for (const name of leaves.user) if (!this.userContextMenuMap.has(name)) this.logger.warn(`User context menu ${paint.sky.bold(name)} has no registered ${chalk.bold("@ContextMenuRoute")} handler.`);
-		for (const name of leaves.message) if (!this.messageContextMenuMap.has(name)) this.logger.warn(`Message context menu ${paint.sky.bold(name)} has no registered ${chalk.bold("@ContextMenuRoute")} handler.`);
+		for (const name of leaves.user) if (!this.userContextMenuMap.has(name)) this.logger.warn(`User context menu ${paint.sky.bold(name)} has no registered ${paint.bold("@ContextMenuRoute")} handler.`);
+		for (const name of leaves.message) if (!this.messageContextMenuMap.has(name)) this.logger.warn(`Message context menu ${paint.sky.bold(name)} has no registered ${paint.bold("@ContextMenuRoute")} handler.`);
 	}
 	getArtifacts(handlerClass) {
 		const artifacts = [];
@@ -2083,7 +2073,7 @@ var InteractionDispatcher = class {
 	}
 	buildHandler(HandlerCtor, interaction, dispatch, key, isFallback) {
 		if (isFallback) this.logger.warn(`No handler found for key ${paint.sky.bold(key)}. Falling back to ${HandlerCtor.name}.`);
-		this.logger.debug(`Processing ${paint.mint.bold(key)} with ${paint.mute(HandlerCtor.name)}`);
+		this.logger.debug(`Processing ${paint.sky.bold(key)} with ${paint.mute(HandlerCtor.name)}`);
 		return new HandlerCtor(interaction, this.core, dispatch);
 	}
 	async runMiddlewares(interaction) {
@@ -2193,9 +2183,11 @@ const LOGOUT_TIMEOUT_MS = 2e3;
 /**
 * The Discord client and its controllers. Access it through `core.bot`.
 */
+const loggerSlot = Symbol("seedcord:bot:logger");
 var Bot = class {
-	/** @internal */
 	logger = new Logger("Bot", { channel: "bot" });
+	/** @internal */
+	[loggerSlot] = this.logger;
 	isInitialized = false;
 	_client;
 	interactions;
@@ -2275,23 +2267,27 @@ var Bot = class {
 		this._client.once(Events.ClientReady, () => ready.resolve());
 		this._client.login(token);
 		await ready.promise;
-		this.logger.info(`Logged in as ${chalk.bold.magenta(this._client.user?.username)}!`);
+		this.logger.info(`Logged in as ${paint.sky.bold(this._client.user?.username)}!`);
 		return this;
 	}
 	async logout() {
 		await this._client.destroy();
-		this.logger.info(chalk.bold.red("Logged out of Discord!"));
+		this.logger.info(paint.coral.bold("Logged out of Discord!"));
 	}
 	get client() {
 		return this._client;
 	}
 };
 __decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) })], Bot.prototype, "botToken", void 0);
+/** @internal */
+function botLoggerOf(bot) {
+	return bot[loggerSlot];
+}
 
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.4";
+const version = "0.2.0-next.0";
 
 //#endregion
 //#region src/Seedcord.ts
@@ -2348,14 +2344,14 @@ var Seedcord = class Seedcord extends Pluggable {
 	registerStartupTasks() {
 		if (Envapter.isDevelopment || Envapter.isTest) this.registerHmrAwareModules();
 		this.startup.addTask(StartupPhase.Configuration, "bus-initialization", async () => {
-			this.bus.logger.utils.initialization("Subscribers", "start");
+			busLoggerOf(this.bus).utils.initialization("Subscribers", "start");
 			await this.subscribers.init();
-			this.bus.logger.utils.initialization("Subscribers", "end");
+			busLoggerOf(this.bus).utils.initialization("Subscribers", "end");
 		});
 		this.startup.addTask(StartupPhase.Login, "bot-initialization", async () => {
-			this.bot.logger.utils.initialization("Bot", "start");
+			botLoggerOf(this.bot).utils.initialization("Bot", "start");
 			await this.bot.init();
-			this.bot.logger.utils.initialization("Bot", "end");
+			botLoggerOf(this.bot).utils.initialization("Bot", "end");
 		});
 		const { healthCheck } = this;
 		if (healthCheck) this.startup.addTask(StartupPhase.Ready, "health-check", async () => {
@@ -2390,5 +2386,5 @@ var Seedcord = class Seedcord extends Pluggable {
 };
 
 //#endregion
-export { ArraySource, AutocompleteHandler, BaseHandler, ButtonHandler, ComponentHandler, ContextMenuHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, 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, 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 };
 //# sourceMappingURL=index.mjs.map