@seedcord/gateway 0.1.0-next.3 → 0.1.0-next.5

package/dist/index.mjs

@@ -1,26 +1,24 @@
 import "reflect-metadata";
 import { installNodeDefaults } from "@seedcord/logger/node";
-import { BaseReplySender, CommandMetadataKey, EventMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, NoticeCard, PAGE_MAX, PermissionNames, SubscribeMetadataKey, WebhookUrlMetadataKey, areRoutes, decodeComponentRoute, deferFlags, getDevChannel, pageCursor, pickNotice, prefixOf, routeIdOf, runHandlerGates, sendFlags, setBotColor, slowGateMonitor } from "@seedcord/core/internal";
+import { BaseReplySender, CommandMetadataKey, EventMetadataKey, FaultThrottle, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, NoticeCard, PAGE_MAX, PermissionNames, PublishDefault, areRoutes, asError, decodeComponentRoute, deferFlags, dispatchedPayload, getDevChannel, outcomeFor, pageCursor, pickNotice, prefixOf, queuedMsFor, reportedWrite, routeIdOf, runHandlerGates, sendFlags, setBotColor, slowGateMonitor } from "@seedcord/core/internal";
 import { SeedcordErrorCode } from "@seedcord/errors";
 import { SeedcordError, SeedcordRangeError, SeedcordTypeError, validateDiscordToken } from "@seedcord/errors/internal";
-import { BaseHandler, BuilderComponent, CustomId, DispatchContext, Fault, Notice, RepliableHandler as RepliableHandler$1, RowComponent, Silence, defineGate, paginate } from "@seedcord/core";
+import { BaseHandler, BuilderComponent, Bus, CustomId, DispatchContext, Fault, Notice, RepliableHandler as RepliableHandler$1, RowComponent, Silence, Subscriber as Subscriber$1, WebhookLog as WebhookLog$1, defineGate, paginate } from "@seedcord/core";
 import { Logger, LoggerChannelRegistry, paint } from "@seedcord/logger";
 import { ActionRowBuilder, ButtonBuilder, ContextMenuCommandBuilder, SlashCommandBuilder, TextDisplayBuilder } from "@discordjs/builders";
 import { buildSlashRoute, routeLeavesOf } from "@seedcord/utils/internal";
 import { ApplicationCommandType, ButtonStyle, Client, Collection, ComponentType, DiscordAPIError, Events, Guild, GuildMember, Message, MessageFlags, PermissionFlagsBits, RESTJSONErrorCodes, Role, TextChannel, User, chatInputApplicationCommandMention } from "discord.js";
 import * as crypto from "node:crypto";
-import { TypedEventEmitter } from "@seedcord/event-emitter";
-import chalk from "chalk";
-import { Converters, Envapter } from "envapt";
-import { MessageFlags as MessageFlags$1, Routes, SeparatorSpacingSize } from "discord-api-types/v10";
-import { filterCirculars, formatFilePath, hasKeys, stripAnsi, timestampFromSnowflake } from "@seedcord/utils";
-import { DiscordAPIError as DiscordAPIError$1, REST } from "@discordjs/rest";
-import { CoordinatedShutdown, CoordinatedStartup, HealthCheck, ShutdownPhase, ShutdownPhase as ShutdownPhase$1, StartupPhase, StartupPhase as StartupPhase$1 } from "@seedcord/core/node";
+import { Plugin as Plugin$1 } from "@seedcord/core/plugin";
+import { CoordinatedShutdown, CoordinatedStartup, HealthCheck, Pluggable, ShutdownPhase, StartupPhase, SubscriberLoader, settleWithin } from "@seedcord/core/node/internal";
 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 { resolve } from "node:path";
 import { HmrModuleHandler } from "@seedcord/core/hmr";
+import { formatFilePath, hasKeys } from "@seedcord/utils";
 import { traverseDirectory } from "@seedcord/utils/node";
 
 export * from "@seedcord/errors"
@@ -29,11 +27,11 @@ export * from "@seedcord/core"
 
 export * from "@seedcord/logger"
 
-export * from "@seedcord/event-emitter"
+export * from "@seedcord/rate-limiter"
 
 export * from "@seedcord/utils"
 
-export * from "@seedcord/rate-limiter"
+export * from "@seedcord/event-emitter"
 
 //#region src/logger-bootstrap.ts
 installNodeDefaults();
@@ -147,7 +145,7 @@ let MiddlewareType = /* @__PURE__ */ function(MiddlewareType) {
 * Interaction middleware cannot specify event filters.
 *
 * @param type - Middleware kind from {@link MiddlewareType}
-* @param priority - Ordering value where lower runs earlier. {@default `0`}
+* @param priority - Ordering value where lower runs earlier. {@default `0` }
 * @param options - Additional registration options
 *
 * @decorator
@@ -335,7 +333,7 @@ const Emojis = emojiStorage;
 */
 var EmojiInjector = class {
 	core;
-	logger = new Logger("Emojis");
+	logger = new Logger("Emojis", { channel: "bot" });
 	constructor(core) {
 		this.core = core;
 	}
@@ -410,7 +408,7 @@ const MULTI_GUILD = Symbol("seedcord:commandmentions:multi-guild");
 */
 var CommandMentionInjector = class {
 	core;
-	logger = new Logger("CommandMentions");
+	logger = new Logger("CommandMentions", { channel: "bot" });
 	constructor(core) {
 		this.core = core;
 	}
@@ -568,7 +566,7 @@ function checkBotPermissions(target, scope, inverse = false, errors) {
 	}
 	const me = target.guild.members.me;
 	if (!me) {
-		new Logger("checkBotPermissions").warn(`Bot member is unavailable in guild ${target.guild.id} while checking permissions in channel ${target.id}`);
+		new Logger("checkBotPermissions", { channel: "errors" }).warn(`Bot member is unavailable in guild ${target.guild.id} while checking permissions in channel ${target.id}`);
 		const names = scope.map((bit) => PermissionNames.get(bit) ?? String(bit));
 		throw new ((errors?.missingNotice) ?? MissingPermissions)(void 0, "The bot", names);
 	}
@@ -767,8 +765,11 @@ function seedState(interaction) {
 */
 var ReplySender = class extends BaseReplySender {
 	interaction;
-	constructor(interaction, routeId) {
-		super(routeId, seedState(interaction));
+	constructor(interaction, routeId, bus) {
+		super(routeId, seedState(interaction), bus && {
+			bus,
+			interactionId: interaction.id
+		});
 		this.interaction = interaction;
 	}
 	async writeReply(response, opts) {
@@ -875,43 +876,9 @@ function slashRouteOf(interaction) {
 	return buildSlashRoute(interaction.commandName, subcommand, group);
 }
 
-//#endregion
-//#region src/miscellaneous/FaultThrottle.ts
-/**
-* Drops duplicate fault reports inside a fixed window so a recurring fault (a database outage on a
-* hot path) reports once per window instead of flooding the webhook. Keyed on a structural string, so
-* the map stays small, and a stale entry is evicted on the next read of its key.
-*
-* @internal
-*/
-var FaultThrottle = class {
-	windowMs;
-	now;
-	lastReportedAt = /* @__PURE__ */ new Map();
-	constructor(windowMs = 6e4, now = () => Date.now()) {
-		this.windowMs = windowMs;
-		this.now = now;
-	}
-	/** Evicts the entry for this key if it has aged out, so the map never holds stale keys forever. */
-	shouldReport(key) {
-		const last = this.lastReportedAt.get(key);
-		if (last === void 0) return true;
-		if (this.now() - last < this.windowMs) return false;
-		this.lastReportedAt.delete(key);
-		return true;
-	}
-	markReported(key) {
-		this.lastReportedAt.set(key, this.now());
-	}
-	clear() {
-		this.lastReportedAt.clear();
-	}
-};
-
 //#endregion
 //#region src/miscellaneous/extractErrorResponse.ts
-const logger$2 = new Logger("ErrorsHandling");
-const faultThrottle = new FaultThrottle();
+const logger$2 = new Logger("ErrorsHandling", { channel: "errors" });
 /**
 * Processes an error into a user-facing reply and routes its report.
 *
@@ -941,29 +908,30 @@ function extractErrorResponse(error, core, origin) {
 		response: override ? new override(uuid).render(ctx) : new Fault().render(ctx)
 	};
 }
-function withThrottle(origin, error, publish) {
+function withThrottle(core, origin, error, publish) {
+	const throttle = FaultThrottle.for(core);
 	const key = faultKey(origin, error);
-	if (!faultThrottle.shouldReport(key)) {
-		logger$2.info(`throttled duplicate fault ${key}`);
+	if (!throttle.shouldReport(key)) {
+		logger$2.debug(`throttled duplicate fault ${key}`);
 		return;
 	}
 	publish();
-	faultThrottle.markReported(key);
+	throttle.markReported(key);
 }
 function reportFault(denial, core, origin, uuid) {
-	withThrottle(origin, denial, () => {
-		logger$2.error(`${denial.name}: ${uuid}`, denial);
-		if (origin.interaction) core.bus.publish("handledException", {
+	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.publish("handledException", {
+		else if (origin.event) core.bus[PublishDefault]("handledException", {
 			denial,
 			uuid,
 			source: buildEventSource(origin.event, origin)
 		});
-		else core.bus.publish("unknownException", {
+		else core.bus[PublishDefault]("unknownException", {
 			uuid,
 			error: denial,
 			...scalarActors(origin),
@@ -978,10 +946,10 @@ function causeLine(error) {
 	return `\ncaused by ${cause.name}: ${first ?? cause.message}`;
 }
 function reportRawFault(error, core, origin, uuid) {
-	withThrottle(origin, error, () => {
-		if (core.config.errors?.errorStack ?? false) logger$2.error(uuid, error);
-		else logger$2.error(`${uuid} | ${error.message}${causeLine(error)}`);
-		core.bus.publish("unknownException", {
+	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),
@@ -1124,112 +1092,6 @@ async function getConfirmation(interaction, prompt, options) {
 	return confirmed;
 }
 
-//#endregion
-//#region src/interfaces/Plugin.ts
-/**
-* Base class for Seedcord plugins
-*
-* Extend this class to create plugins that integrate with the Seedcord lifecycle.
-* Plugins have access to the core instance and must implement initialization logic.
-*/
-var Plugin = class extends TypedEventEmitter {
-	pluggable;
-	name = this.constructor.name;
-	constructor(pluggable) {
-		super();
-		this.pluggable = pluggable;
-	}
-	/**
-	* Reloads plugin state on an HMR update. The base implementation is a no-op, override it in your plugin.
-	* @virtual
-	*/
-	onHmr(_event) {
-		return Promise.resolve();
-	}
-	/**
-	* Registers critical file patterns that should trigger a full restart when changed in Dev HMR.
-	* @param patterns - Glob patterns relative to the project root
-	*/
-	registerCriticalFiles(patterns) {
-		getDevChannel()?.send("seedcord:register-critical-files", { patterns });
-	}
-	/** @internal */
-	removeListener(event, listener) {
-		return super.removeListener(event, listener);
-	}
-	/** @internal */
-	removeAllListeners(event) {
-		return super.removeAllListeners(event);
-	}
-};
-/**
-* Base class for objects that can have plugins attached.
-*
-* Provides plugin attachment capabilities and lifecycle management. Plugins are attached during
-* configuration and initialized during startup. Not constructed directly, the host is a {@link Seedcord}.
-*/
-var Pluggable = class Pluggable extends TypedEventEmitter {
-	isInitialized = false;
-	shutdown;
-	startup;
-	plugins = [];
-	static PLUGIN_INIT_TIMEOUT_MS = 15e3;
-	constructor(shutdown, startup) {
-		super();
-		this.shutdown = shutdown;
-		this.startup = startup;
-	}
-	/** @internal */
-	async init() {
-		if (this.isInitialized) return this;
-		await this.startup.run();
-		this.isInitialized = true;
-		return this;
-	}
-	/**
-	* Attaches a plugin to this instance
-	*
-	* Plugins provide external functionality and are initialized during the specified startup phase.
-	* The plugin instance becomes available as a property in `core` wherever it's available.
-	*
-	* Make sure to augment the {@link Core} interface with the plugin type to ensure TypeScript recognizes it and provides intellisense.
-	*
-	* @typeParam Key - The property name for accessing the plugin
-	* @typeParam Ctor - The plugin constructor type
-	* @param key - Property name to access the plugin instance
-	* @param Plugin - Plugin constructor class
-	* @param startupPhase - When during startup to initialize this plugin ({@link StartupPhase})
-	* @param args - Additional arguments to pass to the plugin constructor
-	* @returns This instance with the plugin attached as a typed property
-	* @throws A **SeedcordError** When called after initialization or if key already exists
-	* @example
-	* ```typescript
-	* seedcord.attach('db', Mongo, StartupPhase.Configuration, { uri: 'mongodb://...', name: 'seedcord', dir: ... })
-	* ```
-	*/
-	attach(key, Plugin, startupPhase, ...args) {
-		if (this.isInitialized) throw new SeedcordError(SeedcordErrorCode.CorePluginAfterInit);
-		if (key in this) throw new SeedcordError(SeedcordErrorCode.CorePluginKeyExists, [key]);
-		const instance = new Plugin(this, ...args);
-		this.plugins.push(instance);
-		const entry = { [key]: instance };
-		this.startup.addTask(startupPhase, `Plugin:${key}`, async () => {
-			instance.logger.utils.initialization(key, "start");
-			await instance.init();
-			instance.logger.utils.initialization(key, "end");
-		}, Pluggable.PLUGIN_INIT_TIMEOUT_MS);
-		return Object.assign(this, entry);
-	}
-	/** @internal */
-	removeListener(event, listener) {
-		return super.removeListener(event, listener);
-	}
-	/** @internal */
-	removeAllListeners(event) {
-		return super.removeAllListeners(event);
-	}
-};
-
 //#endregion
 //#region src/handlers/BaseHandler.ts
 /**
@@ -1255,7 +1117,7 @@ var BaseHandler$1 = class extends BaseHandler {
 */
 var InteractionMiddleware = class extends BaseHandler$1 {
 	constructor(event, core) {
-		super(event, core);
+		super(event, core, void 0, "interactions");
 	}
 };
 
@@ -1275,8 +1137,8 @@ var RepliableHandler = class extends RepliableHandler$1 {
 	getEvent() {
 		return this.event;
 	}
-	buildSender(event, _core, routeId) {
-		return new ReplySender(event, routeId);
+	buildSender(event, core, routeId) {
+		return new ReplySender(event, routeId, core.bus);
 	}
 };
 
@@ -1431,7 +1293,7 @@ var ContextMenuHandler = class extends InteractionHandler {
 */
 var AutocompleteHandler = class extends BaseHandler$1 {
 	constructor(event, core, dispatch) {
-		super(event, core, dispatch);
+		super(event, core, dispatch, "interactions");
 	}
 	decodedFocused;
 	/**
@@ -1482,7 +1344,11 @@ var AutocompleteHandler = class extends BaseHandler$1 {
 	}
 	/** Send autocomplete suggestions, callback type 8. Prefer {@link match}, which restricts each field's choices to its declared type. */
 	async respond(choices) {
-		await this.event.respond(choices);
+		const routeId = this.dispatch?.routeId ?? "autocomplete";
+		await reportedWrite({
+			bus: this.core.bus,
+			interactionId: this.event.id
+		}, routeId, "respond", () => this.event.respond(choices));
 	}
 	/** The firing command route, for a field whose completion differs per registered command. */
 	get route() {
@@ -1675,7 +1541,7 @@ var SelectMenuHandler = class extends ComponentHandler {};
 var EventHandler = class extends BaseHandler$1 {
 	firedEvent;
 	constructor(event, core, eventName) {
-		super(event, core);
+		super(event, core, void 0, "events");
 		this.firedEvent = eventName;
 	}
 	/**
@@ -1728,7 +1594,7 @@ var EventHandler = class extends BaseHandler$1 {
 var EventMiddleware = class extends BaseHandler$1 {
 	firedEvent;
 	constructor(event, core, eventName) {
-		super(event, core);
+		super(event, core, void 0, "events");
 		this.firedEvent = eventName;
 	}
 	/**
@@ -1913,10 +1779,15 @@ var Paginator = class {
 			}
 		};
 	}
-	/** Render page 0 and send it, picking reply or followUp from the interaction's state. */
-	async start(interaction, core) {
-		const response = await this.page(contextOf(interaction, core), 0);
-		return new ReplySender(interaction, interactionRoute(interaction)).send(response, { ephemeral: this.config.ephemeral ?? false });
+	/**
+	* Render page 0 and send it through the handler's sender, picking reply or followUp from its ack state.
+	*
+	* @param handler - The handler starting the paginator, normally `this`.
+	*/
+	async start(handler) {
+		const interaction = handler.getEvent();
+		const response = await this.page(contextOf(interaction, handler.core), 0);
+		return handler.getSender().send(response, { ephemeral: this.config.ephemeral ?? false });
 	}
 	/** Render a page as a {@link ReplyResponse}. To post it elsewhere, add `flags: MessageFlags.IsComponentsV2`. */
 	async page(ctx, n) {
@@ -1976,250 +1847,32 @@ var CursorSource = class {
 };
 
 //#endregion
-//#region src/subscribers/Subscriber.ts
-/**
-* Abstract base class for handling application subscribers.
-*
-* Provides type-safe access to subscribers data and the core framework instance.
-* Extend this class to create custom subscriber handlers.
-*
-* @typeParam KeyOfSubscribers - The specific subscriber type this handler processes
-*/
-var Subscriber = class {
-	data;
-	core;
-	logger;
-	/**
-	* Instantiates the subscriber with event data and core.
-	*
-	* @param data - The subscriber event data
-	* @param core - The core framework instance
-	*/
-	constructor(data, core) {
-		this.data = data;
-		this.core = core;
-		this.logger = new Logger(this.constructor.name);
-	}
-};
-
-//#endregion
-//#region src/subscribers/decorators/Subscribe.ts
+//#region src/subscribers/index.ts
 /**
-* Registers a subscriber handler class with a specific subscriber event.
-*
-* Associates the decorated class with a subscriber event type for automatic
-* registration and execution when the subscriber is emitted.
+* Base class for a gateway subscriber, binding `this.core` to the gateway {@link Core}.
 *
-* @typeParam TSubscriber - The subscriber event name to register for
-* @param subscriber - The subscriber event name to register for
-* @param options - Options to configure the subscriber handler registration.
-* @decorator
-* @example
-* ```typescript
-* \@Subscribe('userJoin')
-* class WelcomeHandler extends Subscriber<'userJoin'> {
-*   async execute() {
-*     // Handle user join event
-*   }
-* }
-* ```
-* @example
-* ```ts
-* \@Subscribe('userJoin', { frequency: 'once' })
-* // or
-* \@Subscribe('userJoin')
-* ```
+* @typeParam KeyOfSubscribers - The subscription key this handler receives
 */
-function Subscribe(subscriber, options) {
-	return function(constructor) {
-		const meta = {
-			subscriber,
-			frequency: options?.frequency
-		};
-		Reflect.defineMetadata(SubscribeMetadataKey, meta, constructor);
-	};
-}
-
-//#endregion
-//#region src/subscribers/decorators/WebhookUrl.ts
-/**
-* Declares the environment variable a {@link WebhookLog} reporter reads its webhook url from.
-*
-* An unset variable disables the reporter with a boot warning. A set but malformed value throws
-* at boot.
-*
-* @param envKey - The environment variable name holding the webhook url
-* @decorator
-* @example
-* ```ts
-* \@Subscribe('memberBanned')
-* \@WebhookUrl('BAN_LOG_WEBHOOK_URL')
-* class BanLog extends WebhookLog<'memberBanned'> {
-*   report() {
-*     return { components: [new BanCard(this.data).component] };
-*   }
-* }
-* ```
-*/
-function WebhookUrl(envKey) {
-	return function(constructor) {
-		Reflect.defineMetadata(WebhookUrlMetadataKey, envKey, constructor);
-	};
-}
-
-//#endregion
-//#region src/miscellaneous/flagsFor.ts
-/** @internal */
-function flagsFor(ephemeral) {
-	let flags = MessageFlags$1.IsComponentsV2;
-	if (ephemeral) flags |= MessageFlags$1.Ephemeral;
-	return flags;
-}
-
-//#endregion
-//#region src/subscribers/bases/webhookHelpers.ts
-const DISCORD_WEBHOOK_REGEX = new RegExp(String.raw`^https?:\/\/(?:canary\.|ptb\.)?discord(?:app)?\.com\/api\/webhooks\/\d+\/[\w$-]+$`);
-function isDiscordWebhookUrl(value) {
-	return URL.canParse(value) && DISCORD_WEBHOOK_REGEX.test(value);
-}
-function jsonAttachment(name, description, data) {
-	const content = filterCirculars(data);
-	return {
-		name,
-		description,
-		data: Buffer.from(JSON.stringify(content, void 0, 2), "utf8")
-	};
-}
-function neutralizeFences(text) {
-	return text.replaceAll("```", "`​`​`");
-}
-/** An error's stack with its direct cause appended (one level), ANSI-stripped for the webhook payload. */
-function errorReport(error) {
-	let report = error.stack ?? `${error.name}: ${error.message}`;
-	if (Error.isError(error.cause)) {
-		const cause = error.cause.stack ?? `${error.cause.name}: ${error.cause.message}`;
-		report += `\n\nCaused by:\n${cause}`;
-	}
-	const stripped = neutralizeFences(stripAnsi(report));
-	return stripped.length > 1800 ? `${stripped.slice(0, 1799)}…` : stripped;
-}
-var WebhookSeparator = class extends BuilderComponent {
-	constructor() {
-		super("separator");
-		this.instance.setSpacing(SeparatorSpacingSize.Small).setDivider(true);
-	}
-};
-
-//#endregion
-//#region src/subscribers/bases/WebhookSender.ts
-const HTTP_NOT_FOUND = 404;
-const HTTP_UNAUTHORIZED = 401;
+var Subscriber = class extends Subscriber$1 {};
 /**
-* Sends component messages to a Discord webhook through `@discordjs/rest`.
+* Base class for a gateway subscriber that delivers its event to a Discord webhook, binding
+* `this.core` to the gateway {@link Core}.
 *
-* @throws A `SeedcordError` when the url does not carry a webhook id and token.
+* @typeParam KeyOfSubscribers - The subscription key this reporter receives
 */
-var WebhookSender = class {
-	rest = new REST();
-	route;
-	constructor(url) {
-		const match = /\/webhooks\/(\d+)\/([\w$-]+)$/.exec(url);
-		if (!match?.[1] || !match[2]) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, ["The url"]);
-		this.route = Routes.webhook(match[1], match[2]);
-	}
-	/**
-	* Fetches the webhook object, sending no message. Returns `missing` on a 404 or 401 from
-	* Discord and `unreachable` on any other failure.
-	*/
-	async verify() {
-		try {
-			await this.rest.get(this.route, { auth: false });
-			return "ok";
-		} catch (error) {
-			return error instanceof DiscordAPIError$1 && (error.status === HTTP_NOT_FOUND || error.status === HTTP_UNAUTHORIZED) ? "missing" : "unreachable";
-		}
-	}
-	async send(options) {
-		const { flags, username, components, files } = options;
-		await this.rest.post(this.route, {
-			auth: false,
-			query: new URLSearchParams({
-				with_components: "true",
-				wait: "true"
-			}),
-			body: {
-				flags,
-				username,
-				components: components.map((component) => component.toJSON()),
-				...files?.length && { attachments: files.map((file, id) => ({
-					id,
-					filename: file.name,
-					description: file.description
-				})) }
-			},
-			...files?.length && { files: files.map((file) => ({
-				name: file.name,
-				data: file.data
-			})) }
-		});
-	}
-};
+var WebhookLog = class extends WebhookLog$1 {};
 
 //#endregion
-//#region src/subscribers/bases/WebhookLog.ts
+//#region src/plugin.ts
 /**
-* Base class for subscribers that deliver their event to a Discord webhook.
+* Base class for a gateway plugin, binding `this.core` to the gateway {@link Core}.
 *
-* Declare the url's environment variable with `@WebhookUrl` and implement {@link report}. Url
-* resolution, validation, sender reuse, and sending run in the base. When the variable is unset
-* the reporter is skipped at registration with a boot warning.
+* A plugin that runs on either transport extends the base from `@seedcord/core/plugin`, whose
+* `this.core` carries the shared members only.
 *
-* @typeParam KeyOfSubscribers - The subscription key this reporter receives
+* @typeParam Opts - The transport, runtime, and capabilities the plugin declares.
 */
-var WebhookLog = class WebhookLog extends Subscriber {
-	static senders = /* @__PURE__ */ new Map();
-	async execute() {
-		const url = WebhookLog.urlOf(WebhookLog.envKeyOf(this.constructor));
-		if (url === null) {
-			this.logger.warn(`${chalk.bold(this.constructor.name)} has no webhook url set, this reporter is disabled`);
-			return;
-		}
-		const { username, components, files } = await this.report();
-		try {
-			await WebhookLog.senderFor(url).send({
-				flags: flagsFor(false),
-				username: username ?? this.constructor.name,
-				components,
-				files
-			});
-		} catch (error) {
-			this.logger.error("Failed to send webhook report", error);
-		}
-	}
-	/** @internal */
-	static senderFor(url) {
-		let sender = WebhookLog.senders.get(url);
-		if (!sender) {
-			sender = new WebhookSender(url);
-			WebhookLog.senders.set(url, sender);
-		}
-		return sender;
-	}
-	/** @internal */
-	static envKeyOf(ctor) {
-		const envKey = Reflect.getMetadata(WebhookUrlMetadataKey, ctor);
-		if (!envKey) throw new SeedcordError(SeedcordErrorCode.DecoratorWebhookUrlMissing, [ctor.name]);
-		return envKey;
-	}
-	/** @internal Returns null when the env var is unset, throws when set but malformed. */
-	static urlOf(envKey) {
-		if (!Envapter.has(envKey)) return null;
-		const raw = Envapter.getRequired(envKey, Converters.String).trim();
-		if (raw === "") return null;
-		if (!isDiscordWebhookUrl(raw)) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, [envKey]);
-		return raw;
-	}
-};
+var Plugin = class extends Plugin$1 {};
 
 //#endregion
 //#region src/bot/utilities/miscellaneous/contextMenuLeaves.ts
@@ -2275,8 +1928,7 @@ function slashRouteLeaves(commands) {
 var CommandRegistry = class {
 	core;
 	onDeployed;
-	name = "Commands";
-	logger = new Logger("Commands");
+	logger = new Logger("Commands", { channel: "commands" });
 	isInitialised = false;
 	globalCommands = [];
 	guildCommands = new Collection();
@@ -2363,7 +2015,7 @@ var CommandRegistry = class {
 				this.registerCommand(exported, rel);
 				this.hmrHandler?.trackHandler(fullPath, exported);
 			}
-		}, this.logger);
+		});
 	}
 	isCommandClass(obj) {
 		if (typeof obj !== "function") return false;
@@ -2525,7 +2177,7 @@ function eventGateContext(eventName, args, core) {
 
 //#endregion
 //#region src/bot/handleEventFault.ts
-const logger$1 = new Logger("EventBoundary");
+const logger$1 = new Logger("EventBoundary", { channel: "errors" });
 /**
 * The event controller boundary. Reports a throw from an event handler and never replies, since a
 * generic event has no reply target. A {@link Silence} or a non-reporting {@link Notice} stops quietly, a
@@ -2538,15 +2190,15 @@ function handleEventFault(caught, eventName, handlerName, args, core) {
 		if (caught.reason !== void 0 && (core.config.errors?.logSilences ?? true)) logger$1.debug(`Silence: ${caught.reason}`);
 		return;
 	}
-	if (!Error.isError(caught)) throw caught;
+	const error = asError(caught);
 	const ignore = new Set(core.config.errors?.ignoreEventApiCodes ?? []);
-	if (caught instanceof DiscordAPIError && ignore.has(caught.code)) {
-		logger$1.debug(`swallowed api code ${caught.code}`);
+	if (error instanceof DiscordAPIError && ignore.has(error.code)) {
+		logger$1.debug(`swallowed api code ${error.code}`);
 		return;
 	}
-	if (caught instanceof Notice && !caught.report) return;
+	if (error instanceof Notice && !error.report) return;
 	const actor = deriveEventActor(args);
-	extractErrorResponse(caught, core, {
+	extractErrorResponse(error, core, {
 		event: {
 			name: eventName,
 			handler: handlerName,
@@ -2561,21 +2213,22 @@ function handleEventFault(caught, eventName, handlerName, args, core) {
 //#endregion
 //#region src/bot/controllers/EventDispatcher.ts
 /**
-* Scans event handler directories, registers handlers with Discord client events,
-* and coordinates event execution through the handler system. Does not handle interactions.
-* Multiple handlers can point to one event.
+* Scans event handler directories, attaches one client listener per registered event, and runs the
+* handlers for each fire. Interactions route through InteractionDispatcher. Multiple handlers can
+* point to one event.
 *
 * @internal
 */
 var EventDispatcher = class {
 	core;
-	logger = new Logger("Events");
+	logger = new Logger("Events", { channel: "events" });
 	isInitialized = false;
-	name = "Events";
 	eventMap = /* @__PURE__ */ new Map();
 	middlewares = [];
 	executedOnceHandlers = /* @__PURE__ */ new Set();
 	attachedEvents = /* @__PURE__ */ new Set();
+	inFlight = /* @__PURE__ */ new Set();
+	draining = false;
 	loading = false;
 	loadedHandlers = [];
 	loadedMiddlewares = [];
@@ -2639,7 +2292,7 @@ var EventDispatcher = class {
 				this.registerHandler(val, relativePath);
 				this.hmrHandler?.trackHandler(fullPath, val);
 			}
-		}, this.logger);
+		});
 	}
 	async loadMiddlewares(dir) {
 		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
@@ -2648,7 +2301,7 @@ var EventDispatcher = class {
 				this.registerMiddleware(val, relativePath);
 				this.hmrHandler?.trackMiddleware(fullPath, val);
 			}
-		}, this.logger);
+		});
 	}
 	/** @internal For use in dev mode */
 	async onHmr(event) {
@@ -2744,15 +2397,26 @@ var EventDispatcher = class {
 		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.core.bot.client.on(eventName, (...args) => {
-			this.core.bot.emitSafe("any:event", eventName, ...args);
-			(async () => {
-				await this.processEvent(eventName, args).catch((err) => {
-					this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
-					this.core.bot.emit("error:unhandled:event", err);
-				});
-			})();
+			if (this.draining) return;
+			this.core.bus[PublishDefault]("anyEvent", {
+				name: eventName,
+				args
+			});
+			const run = this.processEvent(eventName, args).catch((caught) => {
+				const error = asError(caught);
+				this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${error.name}`, error.stack);
+				this.core.bus[PublishDefault]("unhandledEventError", { error });
+			});
+			this.inFlight.add(run);
+			run.finally(() => this.inFlight.delete(run));
 		});
 	}
+	stopAccepting() {
+		this.draining = true;
+	}
+	drain(timeoutMs) {
+		return settleWithin(Promise.allSettled(this.inFlight), timeoutMs);
+	}
 	async processEvent(eventName, args) {
 		const handlerEntries = this.eventMap.get(eventName);
 		if (!handlerEntries || handlerEntries.length === 0) return;
@@ -2817,7 +2481,7 @@ const HARMLESS_API_CODES = new Set([
 
 //#endregion
 //#region src/bot/handleInteractionFault.ts
-const logger = new Logger("InteractionBoundary");
+const logger = new Logger("InteractionBoundary", { channel: "errors" });
 /**
 * The interaction controller boundary. Sorts a throw from any handler-lifecycle phase into the right
 * user reply plus the right bus event. When a handler is built its sender is passed in, so the boundary
@@ -2826,33 +2490,45 @@ const logger = new Logger("InteractionBoundary");
 *
 * @internal
 */
-async function handleInteractionFault(caught, interaction, core, sender) {
+async function handleInteractionFault(caught, interaction, core, routeId, sender) {
 	if (caught instanceof Silence) {
 		if (caught.reason !== void 0 && (core.config.errors?.logSilences ?? true)) logger.debug(`Silence: ${caught.reason}`);
 		return;
 	}
-	if (!Error.isError(caught)) throw caught;
+	const error = asError(caught);
 	const ignore = new Set(core.config.errors?.ignoreApiCodes ?? []);
-	if (caught instanceof DiscordAPIError && ignore.has(caught.code)) {
-		logger.debug(`swallowed api code ${caught.code}`);
+	if (error instanceof DiscordAPIError && ignore.has(error.code)) {
+		logger.debug(`swallowed api code ${error.code}`);
 		return;
 	}
 	if (interaction.isAutocomplete()) {
-		extractErrorResponse(caught, core, {
+		extractErrorResponse(error, core, {
 			guild: interaction.guild,
 			user: interaction.user,
 			metadata: interaction,
 			route: slashRouteOf(interaction)
 		});
+		await sendEmptyChoices(interaction, core, routeId);
 		return;
 	}
-	const { response } = extractErrorResponse(caught, core, {
+	const { response } = extractErrorResponse(error, core, {
 		interaction,
 		guild: interaction.guild,
 		user: interaction.user,
 		metadata: interaction
 	});
-	await sendGuarded(sender ?? new ReplySender(interaction, interactionRoute(interaction)), response, caught instanceof Notice ? caught.ephemeral : true);
+	await sendGuarded(sender ?? new ReplySender(interaction, routeId, core.bus), response, error instanceof Notice ? error.ephemeral : true);
+}
+async function sendEmptyChoices(interaction, core, routeId) {
+	const telemetry = {
+		bus: core.bus,
+		interactionId: interaction.id
+	};
+	try {
+		await reportedWrite(telemetry, routeId, "respond", () => interaction.respond([]));
+	} catch (error) {
+		logger.debug(`autocomplete empty-choices send failed: ${String(error)}`);
+	}
 }
 async function sendGuarded(sender, response, ephemeral) {
 	try {
@@ -2876,9 +2552,8 @@ async function sendGuarded(sender, response, ephemeral) {
 */
 var InteractionDispatcher = class {
 	core;
-	logger = new Logger("Interactions");
+	logger = new Logger("Interactions", { channel: "interactions" });
 	isInitialized = false;
-	name = "Interactions";
 	slashMap = /* @__PURE__ */ new Map();
 	buttonMap = /* @__PURE__ */ new Map();
 	modalMap = /* @__PURE__ */ new Map();
@@ -2890,8 +2565,11 @@ var InteractionDispatcher = class {
 	messageContextMenuMap = /* @__PURE__ */ new Map();
 	userContextMenuMap = /* @__PURE__ */ new Map();
 	autocompleteMap = /* @__PURE__ */ new Map();
+	handlerFiles = /* @__PURE__ */ new Map();
 	keysToIgnore = /* @__PURE__ */ new Set();
 	middlewares = [];
+	inFlight = /* @__PURE__ */ new Set();
+	draining = false;
 	loading = false;
 	loadedHandlers = [];
 	loadedMiddlewares = [];
@@ -3006,7 +2684,7 @@ var InteractionDispatcher = class {
 				this.registerHandler(val, relativePath);
 				this.hmrHandler?.trackHandler(fullPath, val);
 			}
-		}, this.logger);
+		});
 	}
 	async loadMiddlewares(dir) {
 		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
@@ -3015,7 +2693,7 @@ var InteractionDispatcher = class {
 				this.registerMiddleware(val, relativePath);
 				this.hmrHandler?.trackMiddleware(fullPath, val);
 			}
-		}, this.logger);
+		});
 	}
 	registerMiddleware(middlewareCtor, relativePath) {
 		const metadata = Reflect.getMetadata(MiddlewareMetadataKey, middlewareCtor);
@@ -3045,6 +2723,7 @@ var InteractionDispatcher = class {
 		return obj.prototype instanceof InteractionMiddleware && Reflect.hasMetadata(MiddlewareMetadataKey, obj);
 	}
 	registerHandler(handlerClass, relativePath) {
+		const from = formatFilePath(relativePath);
 		const writes = [];
 		for (const [routeType, map] of this.routeTypes) {
 			const meta = Reflect.getMetadata(InteractionRouteKeys[routeType], handlerClass);
@@ -3052,16 +2731,16 @@ var InteractionDispatcher = class {
 			for (const route of meta) {
 				const existing = map.get(route);
 				if (existing && existing !== handlerClass) throw new SeedcordError(SeedcordErrorCode.InteractionDuplicateRoute, [
-					route,
-					existing.name,
-					handlerClass.name
+					`${routeType}:${route}`,
+					`${existing.name} (${this.handlerFiles.get(existing) ?? "unknown file"})`,
+					`${handlerClass.name} (${from})`
 				]);
 				writes.push([map, route]);
 			}
 		}
 		if (writes.length === 0) return;
 		for (const [map, route] of writes) map.set(route, handlerClass);
-		const from = formatFilePath(relativePath);
+		this.handlerFiles.set(handlerClass, from);
 		if (this.loading) this.loadedHandlers.push({
 			name: handlerClass.name,
 			from
@@ -3073,6 +2752,7 @@ var InteractionDispatcher = class {
 		await this.hmrHandler?.handle(event);
 	}
 	unregisterHandler(handlerClass, artifacts) {
+		this.handlerFiles.delete(handlerClass);
 		if (artifacts) {
 			for (const { routeType, routes } of artifacts) {
 				const map = this.routeTypes.find(([type]) => type === routeType)?.[1];
@@ -3092,44 +2772,92 @@ var InteractionDispatcher = class {
 	}
 	attachToClient() {
 		this.core.bot.client.on(Events.InteractionCreate, (interaction) => {
-			this.core.bot.emitSafe("any:interaction", interaction);
-			this.handleInteraction(interaction).catch((err) => {
-				this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
-				this.core.bot.emit("error:unhandled:interaction", err);
+			if (this.draining) return;
+			this.core.bus[PublishDefault]("anyInteraction", { interaction });
+			const run = this.handleInteraction(interaction).catch((caught) => {
+				const error = asError(caught);
+				this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${error.name}`, error.stack);
+				this.core.bus[PublishDefault]("unhandledInteractionError", { error });
 			});
+			this.inFlight.add(run);
+			run.finally(() => this.inFlight.delete(run));
 		});
 	}
-	async handleCustomIdInteraction(interaction, getMap, interactionType) {
+	stopAccepting() {
+		this.draining = true;
+	}
+	drain(timeoutMs) {
+		return settleWithin(Promise.allSettled(this.inFlight), timeoutMs);
+	}
+	async handleCustomIdInteraction(interaction, kind, getMap) {
 		if ([...this.keysToIgnore].some((matcher) => matcher.owns(interaction.customId))) return;
 		const prefix = prefixOf(interaction.customId);
-		if (!prefix) return this.logger.warn(`${interactionType} has invalid customId: ${interaction.customId}`);
-		await this.processInteraction(interaction, () => prefix, (key) => getMap().get(key));
+		if (!prefix) this.logger.warn(`${paint.sky.bold(kind)} has invalid customId: ${paint.mute(interaction.customId)}`);
+		await this.processInteraction(interaction, kind, () => prefix, (key) => getMap().get(key));
 	}
-	async processInteraction(interaction, extractKey, getHandler, fallback = UnhandledRepliable) {
+	async processInteraction(interaction, kind, extractKey, getHandler, fallback = UnhandledRepliable) {
 		const key = extractKey(interaction);
+		const startedAt = performance.now();
+		const queuedMs = queuedMsFor(interaction.id);
+		const matched = getHandler(key);
+		let routeId = `${kind}:${key || "unrouted"}`;
+		let reported = false;
+		const report = (outcome) => {
+			if (reported) return;
+			reported = true;
+			this.core.bus[PublishDefault]("interactionDispatched", dispatchedPayload({
+				routeId,
+				interactionId: interaction.id,
+				kind,
+				outcome,
+				startedAt,
+				fallback: !matched,
+				queuedMs
+			}));
+		};
 		let sender;
 		try {
-			if (!interaction.isAutocomplete()) for (const { ctor } of this.middlewares) await new ctor(interaction, this.core).execute();
-			let HandlerCtor = getHandler(key);
-			if (!HandlerCtor) {
-				this.logger.warn(`No handler found for key ${paint.sky.bold(key)}. Falling back to ${fallback.name}.`);
-				HandlerCtor = fallback;
-			}
-			this.logger.debug(`Processing ${paint.mint.bold(key)} with ${paint.mute(HandlerCtor.name)}`);
-			const dispatch = new DispatchContext(routeIdOf(HandlerCtor));
-			const handler = new HandlerCtor(interaction, this.core, dispatch);
+			if (!interaction.isAutocomplete()) await this.runMiddlewares(interaction);
+			const HandlerCtor = matched ?? fallback;
+			const dispatch = new DispatchContext(routeIdOf(HandlerCtor) ?? routeId);
+			routeId = dispatch.routeId ?? routeId;
+			const handler = this.buildHandler(HandlerCtor, interaction, dispatch, key, !matched);
 			if (handler instanceof RepliableHandler) sender = handler.getSender();
-			if (!interaction.isAutocomplete()) {
-				const monitor = slowGateMonitor();
-				try {
-					await runHandlerGates(HandlerCtor, interactionGateContext(interaction, this.core), dispatch.routeId ?? void 0, monitor?.observe);
-				} finally {
-					monitor?.report(dispatch.routeId);
-				}
+			const refusal = interaction.isAutocomplete() ? null : await this.gateRefusal(HandlerCtor, interaction, dispatch.routeId);
+			if (refusal) {
+				await this.answer(refusal.caught, interaction, routeId, sender, report);
+				return;
 			}
 			await handler.execute();
+			report("handled");
+		} catch (caught) {
+			await this.answer(caught, interaction, routeId, sender, report);
+		}
+	}
+	async answer(caught, interaction, routeId, sender, report) {
+		try {
+			await handleInteractionFault(caught, interaction, this.core, routeId, sender);
+		} finally {
+			report(outcomeFor(caught));
+		}
+	}
+	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)}`);
+		return new HandlerCtor(interaction, this.core, dispatch);
+	}
+	async runMiddlewares(interaction) {
+		for (const { ctor } of this.middlewares) await new ctor(interaction, this.core).execute();
+	}
+	async gateRefusal(HandlerCtor, interaction, routeId) {
+		const monitor = slowGateMonitor();
+		try {
+			await runHandlerGates(HandlerCtor, interactionGateContext(interaction, this.core), routeId ?? void 0, monitor?.observe);
+			return null;
 		} catch (caught) {
-			await handleInteractionFault(caught, interaction, this.core, sender);
+			return { caught };
+		} finally {
+			monitor?.report(routeId);
 		}
 	}
 	async handleInteraction(interaction) {
@@ -3174,47 +2902,41 @@ var InteractionDispatcher = class {
 	}
 	async handleSlashCommand(interaction) {
 		const route = slashRouteOf(interaction);
-		await this.processInteraction(interaction, () => route, (key) => this.slashMap.get(key));
+		await this.processInteraction(interaction, InteractionRoutes.Slash, () => route, (key) => this.slashMap.get(key));
 	}
 	async handleButton(interaction) {
-		await this.handleCustomIdInteraction(interaction, () => this.buttonMap, "Button");
+		await this.handleCustomIdInteraction(interaction, InteractionRoutes.Button, () => this.buttonMap);
 	}
 	async handleModal(interaction) {
-		await this.handleCustomIdInteraction(interaction, () => this.modalMap, "Modal");
+		await this.handleCustomIdInteraction(interaction, InteractionRoutes.Modal, () => this.modalMap);
 	}
 	async handleStringSelectMenu(interaction) {
-		await this.handleCustomIdInteraction(interaction, () => this.stringSelectMap, "String select menu");
+		await this.handleCustomIdInteraction(interaction, InteractionRoutes.StringMenu, () => this.stringSelectMap);
 	}
 	async handleUserSelectMenu(interaction) {
-		await this.handleCustomIdInteraction(interaction, () => this.userSelectMap, "User select menu");
+		await this.handleCustomIdInteraction(interaction, InteractionRoutes.UserMenu, () => this.userSelectMap);
 	}
 	async handleRoleSelectMenu(interaction) {
-		await this.handleCustomIdInteraction(interaction, () => this.roleSelectMap, "Role select menu");
+		await this.handleCustomIdInteraction(interaction, InteractionRoutes.RoleMenu, () => this.roleSelectMap);
 	}
 	async handleChannelSelectMenu(interaction) {
-		await this.handleCustomIdInteraction(interaction, () => this.channelSelectMap, "Channel select menu");
+		await this.handleCustomIdInteraction(interaction, InteractionRoutes.ChannelMenu, () => this.channelSelectMap);
 	}
 	async handleMentionableSelectMenu(interaction) {
-		await this.handleCustomIdInteraction(interaction, () => this.mentionableSelectMap, "Mentionable select menu");
+		await this.handleCustomIdInteraction(interaction, InteractionRoutes.MentionableMenu, () => this.mentionableSelectMap);
 	}
 	async handleMessageContextMenu(interaction) {
-		await this.processInteraction(interaction, () => interaction.commandName, (key) => this.messageContextMenuMap.get(key));
+		await this.processInteraction(interaction, InteractionRoutes.MessageContextMenu, () => interaction.commandName, (key) => this.messageContextMenuMap.get(key));
 	}
 	async handleUserContextMenu(interaction) {
-		await this.processInteraction(interaction, () => interaction.commandName, (key) => this.userContextMenuMap.get(key));
+		await this.processInteraction(interaction, InteractionRoutes.UserContextMenu, () => interaction.commandName, (key) => this.userContextMenuMap.get(key));
 	}
 	async handleAutocomplete(interaction) {
 		const route = slashRouteOf(interaction);
-		await this.processInteraction(interaction, () => route, (key) => this.autocompleteMap.get(key), UnhandledAutocomplete);
+		await this.processInteraction(interaction, InteractionRoutes.Autocomplete, () => route, (key) => this.autocompleteMap.get(key), UnhandledAutocomplete);
 	}
 };
 
-//#endregion
-//#region \0@oxc-project+runtime@0.135.0/helpers/esm/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-
 //#endregion
 //#region \0@oxc-project+runtime@0.135.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
@@ -3226,23 +2948,25 @@ function __decorate(decorators, target, key, desc) {
 
 //#endregion
 //#region src/bot/Bot.ts
+const DISPATCH_DRAIN_TIMEOUT_MS = 5e3;
+const DRAIN_TASK_TIMEOUT_MS = 6e3;
+const UNBIND_TIMEOUT_MS = 2e3;
+const LOGOUT_TIMEOUT_MS = 2e3;
 /**
-* Discord bot implementation that manages client and controllers
-*
-* Don't instantiate this class directly. Use `core.bot` instead.
+* The Discord client and its controllers. Access it through `core.bot`.
 */
-var Bot = class extends Plugin {
+var Bot = class {
 	/** @internal */
-	logger = new Logger("Bot");
+	logger = new Logger("Bot", { channel: "bot" });
 	isInitialized = false;
 	_client;
 	interactions;
 	events;
-	commands;
 	emojiInjector;
+	commands;
 	emojis = Emojis;
 	mentions = CommandMentions;
-	/** @internal For use in dev mode */
+	/** @internal */
 	async onHmr(event) {
 		if (this.interactions) await this.interactions.onHmr(event);
 		if (this.events) await this.events.onHmr(event);
@@ -3250,7 +2974,6 @@ var Bot = class extends Plugin {
 	}
 	/** @internal */
 	constructor(core) {
-		super(core);
 		this._client = new Client(core.config.bot.clientOptions);
 		if (core.config.bot.interactions.path) this.interactions = new InteractionDispatcher(core);
 		if (core.config.bot.events.path) this.events = new EventDispatcher(core);
@@ -3261,12 +2984,24 @@ var Bot = class extends Plugin {
 			});
 		}
 		this.emojiInjector = new EmojiInjector(core);
-		core.shutdown.addTask(ShutdownPhase$1.DiscordCleanup, "stop-bot", async () => await this.stop(), 2e3);
+		this.registerShutdownTasks(core);
 	}
-	/**
-	* Initializes Discord client and all controllers
-	* @internal
-	*/
+	registerShutdownTasks(core) {
+		core.shutdown.addTask(ShutdownPhase.Unbind, "stop-dispatch", () => {
+			this.stopAccepting();
+			return Promise.resolve();
+		}, UNBIND_TIMEOUT_MS);
+		core.shutdown.addTask(ShutdownPhase.Drain, "drain-dispatch", () => this.drain(), DRAIN_TASK_TIMEOUT_MS);
+		core.shutdown.addTask(ShutdownPhase.Logout, "stop-bot", async () => await this.stop(), LOGOUT_TIMEOUT_MS);
+	}
+	stopAccepting() {
+		this.interactions?.stopAccepting();
+		this.events?.stopAccepting();
+	}
+	async drain() {
+		await Promise.allSettled([this.interactions?.drain(DISPATCH_DRAIN_TIMEOUT_MS), this.events?.drain(DISPATCH_DRAIN_TIMEOUT_MS)]);
+	}
+	/** @internal */
 	async init() {
 		if (this.isInitialized) return;
 		this.isInitialized = true;
@@ -3282,27 +3017,19 @@ var Bot = class extends Plugin {
 			this.interactions?.warnUnhandledContextMenuRoutes(this.commands.contextMenuLeaves());
 		}
 	}
-	/**
-	* Stops the bot and cleans up connections
-	* @internal
-	*/
+	/** @internal */
 	async stop() {
 		this._client.removeAllListeners();
 		await this.logout();
 	}
-	/**
-	* Logs the bot into Discord using the configured token
-	*/
 	async login(token) {
-		this._client.once(Events.ClientReady, () => this.emit("ready"));
+		const ready = Promise.withResolvers();
+		this._client.once(Events.ClientReady, () => ready.resolve());
 		this._client.login(token);
-		await this.waitFor("ready");
+		await ready.promise;
 		this.logger.info(`Logged in as ${chalk.bold.magenta(this._client.user?.username)}!`);
 		return this;
 	}
-	/**
-	* Logs out and destroys the Discord client connection
-	*/
 	async logout() {
 		await this._client.destroy();
 		this.logger.info(chalk.bold.red("Logged out of Discord!"));
@@ -3310,248 +3037,19 @@ var Bot = class extends Plugin {
 	get client() {
 		return this._client;
 	}
-	emit(event, ...args) {
-		return super.emit(event, ...args);
-	}
-	emitSafe(event, ...args) {
-		return super.emitSafe(event, ...args);
-	}
-	onListenerError(error, event) {
-		this.logger.error(`listener for ${String(event)} threw`, error);
-	}
-};
-__decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) }), __decorateMetadata("design:type", String)], Bot.prototype, "botToken", void 0);
-
-//#endregion
-//#region src/subscribers/default/HandledException.ts
-let HandledException = class HandledException extends WebhookLog {
-	report() {
-		return {
-			username: "Handled Exception",
-			components: [new HandledExceptionContainer(this.data).component],
-			files: [jsonAttachment("source.json", "The raw source the fault came from", this.data.source.raw)]
-		};
-	}
-};
-HandledException = __decorate([Subscribe("handledException"), WebhookUrl("HANDLED_EXCEPTION_WEBHOOK_URL")], HandledException);
-var HandledExceptionContainer = class extends BuilderComponent {
-	constructor(data) {
-		super("container");
-		const { denial, uuid, source } = data;
-		this.instance.addTextDisplayComponents((text) => text.setContent(faultSummary(denial, source))).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent(`### UUID \`${uuid}\`\n\`\`\`${neutralizeFences(causeStack(denial))}\`\`\``)).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent("### Source")).addFileComponents((file) => file.setURL("attachment://source.json"));
-	}
-};
-function faultSummary(denial, source) {
-	const head = stripAnsi(`### A handled fault was reported: \`${denial.name}\`\n**Message:** ${denial.message}\n`);
-	if (source.kind === "event") return `${head}**Event:** ${source.eventName}\n**Handler:** ${source.handler}\n**User ID:** \`${source.userId ?? "n/a"}\`\n**Guild ID:** \`${source.guildId ?? "n/a"}\`\n**Channel ID:** \`${source.channelId ?? "n/a"}\``;
-	return `${head}**Kind:** ${source.interactionKind}\n**Command:** ${source.command ?? "n/a"}\n**CustomId:** ${source.customId ?? "n/a"}\n**User ID:** \`${source.userId}\`\n**Guild ID:** \`${source.guildId ?? "n/a"}\`\n**Channel ID:** \`${source.channelId ?? "n/a"}\`\n**Interaction ID:** \`${source.interactionId}\``;
-}
-function causeStack(denial) {
-	const { cause } = denial;
-	if (Error.isError(cause)) return stripAnsi(cause.stack ?? cause.message);
-	if (typeof cause === "string") return stripAnsi(cause);
-	if (typeof cause === "bigint" || typeof cause === "symbol" || typeof cause === "function") return cause.toString();
-	if (cause !== void 0) try {
-		return JSON.stringify(cause);
-	} catch {
-		return "[unserializable cause]";
-	}
-	return stripAnsi(denial.stack ?? "No cause recorded.");
-}
-
-//#endregion
-//#region src/subscribers/default/UnknownException.ts
-let UnknownException = class UnknownException extends WebhookLog {
-	report() {
-		const { metadata } = this.data;
-		return {
-			username: "Unknown Exception",
-			components: [new UnhandledErrorContainer(this.data).component],
-			files: metadata ? [jsonAttachment("metadata.json", "Metadata associated with the error", metadata)] : void 0
-		};
-	}
-};
-UnknownException = __decorate([Subscribe("unknownException"), WebhookUrl("UNKNOWN_EXCEPTION_WEBHOOK_URL")], UnknownException);
-var UnhandledErrorContainer = class extends BuilderComponent {
-	constructor(data) {
-		super("container");
-		const { uuid, error, guild, user, metadata } = data;
-		this.instance.addTextDisplayComponents((text) => text.setContent(`### An unknown exception was thrown\n**Guild ID:** \`${guild?.id ?? "Not used in a guild"}\`\n**Guild Name:** ${guild?.name ?? "Not used in a guild"}\n**User ID:** \`${user?.id ?? "Missing user info"}\`\n**Username:** ${user?.username ?? "Missing user info"}\n`)).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent(`### UUID \`${uuid}\`\n\`\`\`${errorReport(error)}\`\`\``));
-		this.addTimestampsIfAvailable(error);
-		this.addMetadataIfAvailable(metadata);
-	}
-	addTimestampsIfAvailable(error) {
-		if (!(error instanceof DiscordAPIError$1)) return;
-		const now = Date.now();
-		const snowflake = error.url.match(/\/interactions\/(\d+)\//)?.[1];
-		if (!snowflake) return void 0;
-		const interactionTs = timestampFromSnowflake(snowflake);
-		const diff = now - interactionTs;
-		const seconds = Math.floor(diff / 1e3);
-		const millis = diff % 1e3;
-		this.instance.addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent(`### Timestamps\n- **\`Interaction sent\` :** ${new Date(interactionTs).toISOString()} (${interactionTs})\n- **\`Error logged    \` :** ${new Date(now).toISOString()} (${now})\n- **\`Offset          \` :** ${seconds}s ${millis}ms`));
-	}
-	addMetadataIfAvailable(metadata) {
-		if (!metadata) return;
-		this.instance.addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent("### Metadata")).addFileComponents((file) => file.setURL("attachment://metadata.json"));
-	}
-};
-
-//#endregion
-//#region src/subscribers/Bus.ts
-/**
-* Registers and dispatches subscribers. Subscribers load from the configured directories and run
-* on a programmatic or framework-event publish. Accessed via `core.bus`. Do not construct it directly.
-*/
-var Bus = class extends Plugin {
-	core;
-	logger = new Logger("Subscribers");
-	/** @internal */
-	name = "Subscribers";
-	isInitialized = false;
-	subscribersMap = /* @__PURE__ */ new Map();
-	executedOnceHandlers = /* @__PURE__ */ new Set();
-	webhookProbes = /* @__PURE__ */ new Map();
-	hmrHandler;
-	constructor(core) {
-		super(core);
-		this.core = core;
-		if (this.core.config.subscribers.path) {
-			if (!Envapter.isDevelopment && !Envapter.isTest) return;
-			this.hmrHandler = new HmrModuleHandler({
-				handlersDir: this.core.config.subscribers.path,
-				isHandler: this.isSubscriber.bind(this),
-				registerHandler: this.registerSubscriber.bind(this),
-				unregisterHandler: this.unregisterSubscriber.bind(this),
-				getArtifacts: this.getArtifacts.bind(this),
-				logger: this.logger
-			});
-		}
-	}
-	getArtifacts(ctor) {
-		return [Reflect.getMetadata(SubscribeMetadataKey, ctor).subscriber];
-	}
-	/** @internal */
-	async init() {
-		if (this.isInitialized) return;
-		this.isInitialized = true;
-		this.registerSubscriber(UnknownException);
-		this.registerSubscriber(HandledException);
-		const subscribersDir = this.core.config.subscribers.path;
-		if (subscribersDir) {
-			this.logger.info(chalk.bold(subscribersDir));
-			await this.loadSubscribers(subscribersDir);
-			const totalSubscribers = [...this.subscribersMap.values()].reduce((acc, handlers) => acc + handlers.length, 0);
-			this.logger.utils.list([`${chalk.bold.magenta(totalSubscribers)} subscribers`], chalk.bold.green("Loaded"));
-		}
-		if (!Envapter.isTest) await this.verifyWebhooks();
-	}
-	/** @internal Exposed for tests. */
-	async verifyWebhooks() {
-		const missing = [];
-		await Promise.all([...this.webhookProbes].map(async ([url, envKeys]) => {
-			const result = await WebhookLog.senderFor(url).verify();
-			if (result === "missing") missing.push(...envKeys);
-			else if (result === "unreachable") this.logger.warn(`could not verify webhook at ${paint.sky.bold(envKeys.join(", "))}`);
-		}));
-		if (missing.length > 0) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookNotFound, [missing.join(", ")]);
-	}
-	/** @internal */
-	async onHmr(event) {
-		if (this.hmrHandler) await this.hmrHandler.handle(event);
-	}
-	async loadSubscribers(dir) {
-		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
-			for (const exportName of Object.keys(imported)) {
-				const val = imported[exportName];
-				if (this.isSubscriber(val)) {
-					this.registerSubscriber(val);
-					this.hmrHandler?.trackHandler(fullPath, val);
-					this.logger.utils.registration(val.name, relativePath);
-				}
-			}
-		}, this.logger);
-	}
-	registerSubscriber(handler) {
-		if (handler.prototype instanceof WebhookLog) {
-			const envKey = WebhookLog.envKeyOf(handler);
-			const url = WebhookLog.urlOf(envKey);
-			if (url === null) {
-				this.logger.warn(`${chalk.bold(handler.name)} disabled, ${paint.sky.bold(envKey)} is not set`);
-				return;
-			}
-			const envKeys = this.webhookProbes.get(url) ?? [];
-			if (!envKeys.includes(envKey)) envKeys.push(envKey);
-			this.webhookProbes.set(url, envKeys);
-		}
-		const options = Reflect.getMetadata(SubscribeMetadataKey, handler);
-		let handlers = this.subscribersMap.get(options.subscriber);
-		if (!handlers) {
-			handlers = [];
-			this.subscribersMap.set(options.subscriber, handlers);
-		}
-		handlers.push({
-			ctor: handler,
-			frequency: options.frequency ?? "on"
-		});
-	}
-	unregisterSubscriber(handler, artifacts) {
-		const subscribers = artifacts ?? [...this.subscribersMap.keys()];
-		for (const subscriber of subscribers) {
-			const handlers = this.subscribersMap.get(subscriber);
-			if (!handlers) continue;
-			const index = handlers.findIndex((entry) => entry.ctor === handler);
-			if (index !== -1) handlers.splice(index, 1);
-		}
-	}
-	isSubscriber(obj) {
-		if (typeof obj !== "function") return false;
-		return obj.prototype instanceof Subscriber && Reflect.hasMetadata(SubscribeMetadataKey, obj);
-	}
-	/**
-	* Publishes an event to its subscribers and native listeners.
-	*
-	* Fire-and-forget, so subscriber handlers run asynchronously and this returns before they
-	* complete, and callers must not assume side effects have landed. Errors thrown by a subscriber
-	* are caught and logged, never surfaced here. A `'once'` subscriber is marked as executed when
-	* it starts (even if it throws), so it never runs twice.
-	*
-	* @param event - The subscription key to publish
-	* @param data - Payload passed to each subscriber
-	* @returns Whether the underlying emitter had native listeners for the event
-	*/
-	publish(event, data) {
-		this.processSubscriber(event, data);
-		return super.emit(event, ...[data]);
-	}
-	async processSubscriber(subscriberName, data) {
-		const handlers = this.subscribersMap.get(subscriberName);
-		if (!handlers) return;
-		for (const entry of handlers) {
-			if (entry.frequency === "once" && this.executedOnceHandlers.has(entry.ctor)) continue;
-			try {
-				if (entry.frequency === "once") this.executedOnceHandlers.add(entry.ctor);
-				const Ctor = entry.ctor;
-				await new Ctor(data, this.core).execute();
-			} catch (err) {
-				this.logger.error(`Error in subscriber ${String(subscriberName)} handler ${entry.ctor.name}:`, err);
-			}
-		}
-	}
 };
+__decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) })], Bot.prototype, "botToken", void 0);
 
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.0-next.3";
+const version = "0.1.0-next.5";
 
 //#endregion
 //#region src/Seedcord.ts
 /**
-* Main Seedcord bot framework class
-*
-* Primary entry point for creating Discord bots with Seedcord.
-* Manages component lifecycle and provides plugin support.
+* The gateway bot host. Opens a discord.js gateway session, discovers handlers, and runs
+* coordinated startup and shutdown. Attach plugins with `attach()`.
 */
 var Seedcord = class Seedcord extends Pluggable {
 	config;
@@ -3561,83 +3059,86 @@ var Seedcord = class Seedcord extends Pluggable {
 	augmentTarget = "@seedcord/gateway";
 	/** @internal */
 	version = version;
-	static isInstantiated = false;
 	healthCheck;
 	hmrManager;
-	/** @see {@link CoordinatedShutdown} */
-	shutdown;
-	/** @see {@link CoordinatedStartup} */
-	startup;
 	/** @see {@link Bus} */
 	bus;
+	subscribers;
 	/** @see {@link Bot} */
 	bot;
 	/** @see {@link IRateLimiter} */
 	rateLimiter;
 	/**
-	* Creates a new Seedcord instance
-	*
 	* @param config - Bot configuration including paths and Discord client options
 	* @throws A **SeedcordError** When attempting to create multiple instances (singleton)
 	*/
 	constructor(config) {
-		if (Seedcord.isInstantiated) throw new SeedcordError(SeedcordErrorCode.CoreSingletonViolation);
-		Seedcord.isInstantiated = true;
-		const shutdown = new CoordinatedShutdown(config.shutdownEnabled);
-		const startup = new CoordinatedStartup();
-		super(shutdown, startup);
+		super(new CoordinatedShutdown(), new CoordinatedStartup());
 		this.config = config;
 		installNodeDefaults(config.logger);
 		setBotColor(config.botColor);
-		this.shutdown = shutdown;
-		this.startup = startup;
 		this.hmrManager = new HmrManager();
 		this.hmrManager.init();
 		this.bus = new Bus(this);
+		this.subscribers = new SubscriberLoader(this.bus, config.subscribers.path);
 		this.bot = new Bot(this);
 		this.rateLimiter = config.store ?? new MemoryRateLimiter();
-		this.healthCheck = new HealthCheck(this.shutdown, config.healthCheck);
+		this.healthCheck = HealthCheck.fromOption(this.shutdown, config.healthCheck);
 		this.registerStartupTasks();
 	}
 	/** The bot's discord username, populated after login. */
 	get username() {
 		return this.bot.client.user?.username;
 	}
+	pluginCapabilities() {
+		return {
+			client: this.bot.client,
+			token: this.bot.botToken,
+			rest: this.bot.client.rest
+		};
+	}
 	static reset() {
-		Seedcord.isInstantiated = false;
+		super.reset();
 		LoggerChannelRegistry.instance.reset();
 	}
 	registerStartupTasks() {
 		if (Envapter.isDevelopment || Envapter.isTest) this.registerHmrAwareModules();
-		this.startup.addTask(StartupPhase$1.Configuration, "Bus Initialization", async () => {
+		this.startup.addTask(StartupPhase.Configuration, "bus-initialization", async () => {
 			this.bus.logger.utils.initialization("Subscribers", "start");
-			await this.bus.init();
+			await this.subscribers.init();
 			this.bus.logger.utils.initialization("Subscribers", "end");
 		});
-		this.startup.addTask(StartupPhase$1.Instantiation, "Bot Initialization", async () => {
+		this.startup.addTask(StartupPhase.Login, "bot-initialization", async () => {
 			this.bot.logger.utils.initialization("Bot", "start");
 			await this.bot.init();
 			this.bot.logger.utils.initialization("Bot", "end");
 		});
-		this.startup.addTask(StartupPhase$1.Ready, "Health Check", async () => {
-			this.healthCheck.logger.utils.initialization("HealthCheck", "start");
-			await this.healthCheck.init();
-			this.healthCheck.logger.utils.initialization("HealthCheck", "end");
+		const { healthCheck } = this;
+		if (healthCheck) this.startup.addTask(StartupPhase.Ready, "health-check", async () => {
+			healthCheck.logger.utils.initialization("HealthCheck", "start");
+			await healthCheck.init();
+			healthCheck.logger.utils.initialization("HealthCheck", "end");
 		});
 	}
 	/**
 	* Starts the bot and runs all initialization tasks
 	*
-	* @returns This Seedcord instance when fully initialized
+	* @returns This Seedcord instance when initialized
 	*/
 	async start() {
-		await super.init();
+		try {
+			await super.init();
+		} catch (caught) {
+			await this.shutdown.run(1, false);
+			Seedcord.reset();
+			throw caught;
+		}
 		return this;
 	}
 	registerHmrAwareModules() {
-		this.startup.addTask(StartupPhase$1.Configuration, "HMR Registration", async () => {
+		this.startup.addTask(StartupPhase.Configuration, "hmr-registration", async () => {
 			this.hmrManager.register(this.bot);
-			this.hmrManager.register(this.bus);
+			this.hmrManager.register(this.subscribers);
 			for (const plugin of this.plugins) this.hmrManager.register(plugin);
 			await Promise.resolve();
 		});
@@ -3645,5 +3146,5 @@ var Seedcord = class Seedcord extends Pluggable {
 };
 
 //#endregion
-export { ArraySource, AutocompleteHandler, ButtonHandler, CommandMentions, ContextMenuHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, IgnoreBots, InteractionHandler, InteractionMiddleware, Middleware, MiddlewareType, ModalHandler, Nsfw, Paginator, Pluggable, Plugin, RegisterEvent, RepliableHandler, Seedcord, SelectMenuHandler, ShutdownPhase, SlashHandler, StartupPhase, Subscribe, Subscriber, WebhookLog, WebhookUrl, checkBotPermissions, checkPermissions, fetchGuildMember, fetchManyGuildMembers, fetchManyUsers, fetchRole, fetchText, fetchUser, getBotRole, getConfirmation, hasPermsToAssign, updateMemberRoles, version };
+export { ArraySource, AutocompleteHandler, ButtonHandler, CommandMentions, ContextMenuHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, IgnoreBots, InteractionHandler, InteractionMiddleware, Middleware, MiddlewareType, ModalHandler, Nsfw, Paginator, Plugin, RegisterEvent, RepliableHandler, Seedcord, SelectMenuHandler, SlashHandler, Subscriber, WebhookLog, checkBotPermissions, checkPermissions, fetchGuildMember, fetchManyGuildMembers, fetchManyUsers, fetchRole, fetchText, fetchUser, getBotRole, getConfirmation, hasPermsToAssign, updateMemberRoles, version };
 //# sourceMappingURL=index.mjs.map