@seedcord/gateway 0.1.0-next.2 → 0.1.0-next.4

package/dist/index.mjs

@@ -1,39 +1,39 @@
 import "reflect-metadata";
 import { installNodeDefaults } from "@seedcord/logger/node";
-import { BuilderComponent, CustomId, DispatchContext, Fault, Notice, RegisterCommand, RowComponent, Silence, defineGate, paginate } from "@seedcord/core";
-import { CommandMetadataKey, ComponentDefsKey, EventMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NotInGuild, NoticeCard, PAGE_MAX, SubscribeMetadataKey, decodeFor, getDevChannel, pageCursor, pickNotice, prefixOf, routeIdOf, runHandlerGates, setBotColor } from "@seedcord/core/internal";
-import { ApplicationCommandType, AttachmentBuilder, ButtonStyle, Client, Collection, ComponentType, DiscordAPIError, Events, Guild, GuildMember, Message, MessageFlags, PermissionFlagsBits, RESTJSONErrorCodes, Role, SeparatorSpacingSize, SnowflakeUtil, TextChannel, User, WebhookClient, chatInputApplicationCommandMention } from "discord.js";
+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 { SeedcordErrorCode } from "@seedcord/errors";
 import { SeedcordError, SeedcordRangeError, SeedcordTypeError, validateDiscordToken } from "@seedcord/errors/internal";
-import { filterCirculars, formatFilePath, hasKeys, prettify } from "@seedcord/utils";
+import { BaseHandler, BuilderComponent, CustomId, DispatchContext, Fault, Notice, RepliableHandler as RepliableHandler$1, RowComponent, Silence, 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 { TypedEventEmitter } from "@seedcord/event-emitter";
+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 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, Pluggable, ShutdownPhase, StartupPhase, settleWithin } from "@seedcord/core/node/internal";
 import { MemoryRateLimiter } from "@seedcord/rate-limiter";
-import { CoordinatedShutdown, CoordinatedStartup, HealthCheck, ShutdownPhase, StartupPhase } from "@seedcord/services";
 import { SeedcordBrand } from "@seedcord/types/internal";
-import { Envapter } from "envapt";
-import chalk from "chalk";
+import { TypedEventEmitter } from "@seedcord/event-emitter";
 import { Envapt } from "envapt/legacy";
 import { resolve } from "node:path";
 import { HmrModuleHandler } from "@seedcord/core/hmr";
 import { traverseDirectory } from "@seedcord/utils/node";
-import * as crypto from "node:crypto";
-
-export * from "@seedcord/core"
 
 export * from "@seedcord/errors"
 
-export * from "@seedcord/utils"
+export * from "@seedcord/core"
 
 export * from "@seedcord/logger"
 
-export * from "@seedcord/event-emitter"
+export * from "@seedcord/utils"
 
 export * from "@seedcord/rate-limiter"
 
-export * from "@seedcord/services"
+export * from "@seedcord/event-emitter"
 
 //#region src/logger-bootstrap.ts
 installNodeDefaults();
@@ -131,190 +131,6 @@ function Gated(...gates) {
 	};
 }
 
-//#endregion
-//#region src/miscellaneous/areRoutes.ts
-/**
-* Checks if the provided value is an array of strings.
-*
-* @internal
-*/
-function areRoutes(routes) {
-	return Array.isArray(routes) && routes.every((r) => typeof r === "string");
-}
-
-//#endregion
-//#region src/bot/decorators/Interactions.ts
-/**
-* Types of select menus supported for routing
-*/
-let SelectMenuKind = /* @__PURE__ */ function(SelectMenuKind) {
-	SelectMenuKind["String"] = "string";
-	SelectMenuKind["User"] = "user";
-	SelectMenuKind["Role"] = "role";
-	SelectMenuKind["Channel"] = "channel";
-	SelectMenuKind["Mentionable"] = "mentionable";
-	return SelectMenuKind;
-}({});
-/**
-* Routes one or more slash commands to a {@link SlashHandler}.
-*
-* Pass the same route string(s) as the handler's generic. A single command reads `this.options`, several
-* commands branch with `this.match`. The decorator routes and the generic must match exactly, so listing
-* fewer or more than the handler declares is a compile error. Subcommands use a slash path.
-*
-* @param routes - The route string(s) this handler serves, e.g. `'ban'`, `'ban', 'kick'`, or `'demo/setup'`.
-* @decorator
-* @example
-* ```ts
-* \@SlashRoute('ban')
-* class BanHandler extends SlashHandler<'ban'> {
-*     async execute() {
-*         const target = this.options.getUser('target');
-*     }
-* }
-* ```
-*
-* @example
-* ```ts
-* \@SlashRoute('ban', 'kick')
-* class ModerationHandler extends SlashHandler<'ban' | 'kick'> {
-*     async execute() {
-*         await this.match({ ban: (o) => o.getUser('target'), kick: (o) => o.getUser('member') });
-*     }
-* }
-* ```
-*/
-function SlashRoute(...routes) {
-	return function(constructor) {
-		storeMetadata(InteractionRoutes.Slash, routes, constructor);
-	};
-}
-/**
-* Routes button interactions to handler classes.
-*
-* Pass the {@link CustomId} definition(s) this handler decodes and list the same ones in the handler's
-* generic. Passing different definitions to the decorator and the generic is a compile error. Routing
-* matches the stable prefix, so a wire minted from an older shape still reaches the handler, where
-* reading this.params throws StaleCustomId and the controller boundary turns it into a reply.
-*
-* @param defs - The customId definition(s) this handler decodes, one per route.
-* @decorator
-*/
-function ButtonRoute(...defs) {
-	return function(constructor) {
-		storeComponentRoute(InteractionRoutes.Button, defs, constructor);
-	};
-}
-/**
-* Routes modal submissions to handler classes.
-*
-* Pass the {@link CustomId} definition(s) this handler decodes and list the same ones in the handler's
-* generic. Passing different definitions to the decorator and the generic is a compile error. Routing
-* matches the stable prefix, so an older-shape wire still reaches the handler and throws StaleCustomId
-* on read, the same as a button route.
-*
-* @param defs - The customId definition(s) this handler decodes, one per route.
-* @decorator
-*/
-function ModalRoute(...defs) {
-	return function(constructor) {
-		storeComponentRoute(InteractionRoutes.Modal, defs, constructor);
-	};
-}
-/**
-* Routes one or more context-menu commands to a {@link ContextMenuHandler}.
-*
-* Pass the kind (`ApplicationCommandType.User` or `ApplicationCommandType.Message`) and the command name(s),
-* each checked against that kind's registry, so a typo is a compile error. The same kind must sit on the
-* handler's generic, cross-checked both directions. Context menus carry no options, so a multi-name handler
-* reads `this.target` uniformly with no branch.
-*
-* @param kind - The context-menu kind, `ApplicationCommandType.User` or `ApplicationCommandType.Message`.
-* @param names - The command name(s) this handler serves, keyed off the matching registry.
-* @decorator
-* @example
-* ```ts
-* \@ContextMenuRoute(ApplicationCommandType.User, 'View Profile')
-* class ViewProfile extends ContextMenuHandler<ApplicationCommandType.User> {
-*     async execute() {
-*         const user = this.target;
-*     }
-* }
-* ```
-*/
-function ContextMenuRoute(kind, ...names) {
-	return function(constructor) {
-		storeMetadata(kind === ApplicationCommandType.User ? InteractionRoutes.UserContextMenu : InteractionRoutes.MessageContextMenu, names, constructor);
-	};
-}
-/**
-* Routes one or more commands' autocomplete to an {@link AutocompleteHandler}.
-*
-* Pass the same command route string(s) as the handler's generic. One command branches with `this.match`
-* over its autocompletable fields, several commands share one handler whose arms span every command's
-* fields. The decorator routes and the generic must match exactly, so listing fewer or more than the
-* handler declares is a compile error.
-*
-* @param routes - The command route string(s) this handler serves, e.g. `'search'` or `'search', 'find'`.
-* @decorator
-* @example
-* ```ts
-* \@AutocompleteRoute('search')
-* class SearchAutocomplete extends AutocompleteHandler<'search'> {
-*     async execute() {
-*         await this.match({ query: (value, respond) => respond([{ name: value, value }]) });
-*     }
-* }
-* ```
-*/
-function AutocompleteRoute(...routes) {
-	return function(constructor) {
-		storeMetadata(InteractionRoutes.Autocomplete, routes, constructor);
-	};
-}
-/**
-* Routes select menu interactions to handler classes.
-*
-* Pass the select kind and the {@link CustomId} definition(s) this handler decodes. The handler's
-* generic must list the same definitions, and its second generic argument must be the matching select
-* interaction type, or it is a compile error.
-*
-* @param type - Select menu kind from {@link SelectMenuKind}.
-* @param defs - The customId definition(s) this handler decodes, one per route.
-* @decorator
-*
-* @example
-* ```typescript
-* \@SelectMenuRoute(SelectMenuKind.User, AssignId)
-* class AssignSelect extends SelectMenuHandler<SelectMenuKind.User, [typeof AssignId]> {
-*   // handles user select menus minted from AssignId
-* }
-* ```
-*/
-function SelectMenuRoute(type, ...defs) {
-	return function(constructor) {
-		storeComponentRoute({
-			["string"]: InteractionRoutes.StringMenu,
-			["user"]: InteractionRoutes.UserMenu,
-			["role"]: InteractionRoutes.RoleMenu,
-			["channel"]: InteractionRoutes.ChannelMenu,
-			["mentionable"]: InteractionRoutes.MentionableMenu
-		}[type], defs, constructor);
-	};
-}
-function storeComponentRoute(route, defs, constructor) {
-	storeMetadata(route, defs.map((def) => def.prefix), constructor);
-	Reflect.defineMetadata(ComponentDefsKey, defs, constructor);
-}
-function storeMetadata(route, routes, constructor) {
-	const key = InteractionRouteKeys[route];
-	const savedRoutes = Reflect.getMetadata(key, constructor);
-	const existing = areRoutes(savedRoutes) ? savedRoutes : [];
-	const toStore = Array.isArray(routes) ? routes : [routes];
-	Reflect.defineMetadata(key, [...existing, ...toStore], constructor);
-	Reflect.defineMetadata(InteractionMetadataKey, true, constructor);
-}
-
 //#endregion
 //#region src/bot/decorators/Middlewares.ts
 /**
@@ -383,21 +199,6 @@ const IgnoreBots = defineGate("IgnoreBots", (ctx) => {
 	if (ctx.user?.bot) throw new Silence("actor is a bot");
 });
 
-//#endregion
-//#region src/bot/notices/utils.ts
-function mentionFor(subject) {
-	if (subject instanceof Role) return `<@&${subject.id}>`;
-	if (subject instanceof TextChannel) return `<#${subject.id}>`;
-	if (subject instanceof GuildMember) return `<@${subject.id}>`;
-	return `\`${subject.name}\``;
-}
-function labelFor(subject) {
-	if (subject instanceof Role) return "role";
-	if (subject instanceof TextChannel) return "channel";
-	if (subject instanceof GuildMember) return "member";
-	return "guild";
-}
-
 //#endregion
 //#region src/bot/notices/index.ts
 var NotNsfw = class extends GateNotice {
@@ -405,13 +206,6 @@ var NotNsfw = class extends GateNotice {
 		super(message);
 	}
 };
-var MissingRole = class extends GateNotice {
-	role;
-	constructor(message, role) {
-		super(message ?? (role ? `You need the ${role.name} role to use this.` : "You do not have the required role."));
-		this.role = role;
-	}
-};
 var RoleHigherThanMe = class extends Notice {
 	role;
 	botRole;
@@ -432,30 +226,19 @@ var CannotAssignBotRole = class extends Notice {
 		return { components: [new NoticeCard("I cannot assign a managed role.").component] };
 	}
 };
-var MissingPermissions = class extends Notice {
-	where;
-	missingPerms;
-	constructor(message, where, missingPerms) {
-		super(message);
-		this.where = where;
-		this.missingPerms = missingPerms;
-	}
-	render() {
-		const bullets = this.missingPerms.map((perm) => `• ${perm}`).join("\n");
-		return { components: [new NoticeCard(`The ${labelFor(this.where)} ${mentionFor(this.where)} is missing the following permission entries:\n\n${bullets}`).component] };
-	}
-};
 var HasDangerousPermissions = class extends Notice {
-	target;
+	subject;
 	dangerousPerms;
-	constructor(message, target, dangerousPerms) {
-		super(message);
-		this.target = target;
+	customLead;
+	constructor(message, subject, dangerousPerms) {
+		super(message ?? "A dangerous permission is enabled.");
+		this.subject = subject;
 		this.dangerousPerms = dangerousPerms;
+		this.customLead = message;
 	}
 	render() {
 		const bullets = this.dangerousPerms.map((perm) => `• ${perm}`).join("\n");
-		return { components: [new NoticeCard(`The ${labelFor(this.target)} ${mentionFor(this.target)} has the following permission entries that must not be enabled:\n\n${bullets}`).component] };
+		return { components: [new NoticeCard(`${this.customLead ?? `${this.subject} has the following permission entries that must not be enabled:`}\n\n${bullets}`).component] };
 	}
 };
 var UserNotFound = class extends Notice {
@@ -531,129 +314,6 @@ function Nsfw(options) {
 	});
 }
 
-//#endregion
-//#region src/bot/utilities/permissions/checkPermissions.ts
-/**
-* Map of permission bits to their prettified human readable names.
-*/
-const PermissionNames = new Map(Object.entries(PermissionFlagsBits).map(([key, bit]) => [bit, prettify(key)]));
-function checkPermissions(a, b, c, d, e) {
-	const { for: pFor, in: pIn, scope, inverse = false, missing: missingCtor, dangerous: dangerousCtor } = a instanceof Role || a instanceof GuildMember ? {
-		for: a,
-		in: b,
-		scope: c,
-		inverse: d ?? false,
-		...e
-	} : a;
-	const Missing = missingCtor ?? MissingPermissions;
-	const Dangerous = dangerousCtor ?? HasDangerousPermissions;
-	const perms = pIn instanceof Guild ? pFor.permissions : pIn.permissionsFor(pFor, true);
-	const names = (bits) => bits.map((bit) => PermissionNames.get(bit) ?? String(bit));
-	const present = scope.filter((bit) => perms.has(bit, true));
-	const presentNames = names(present);
-	if (inverse) {
-		if (present.length > 0) throw new Dangerous(`${pFor instanceof Role ? "Role" : "Member"} has dangerous permissions in this ${pIn instanceof Guild ? "guild" : "channel"}`, pFor, presentNames);
-		return;
-	}
-	const missingBits = scope.filter((bit) => !perms.has(bit, true));
-	if (missingBits.length > 0) throw new Missing("Missing Any/All/No Permissions", pFor, names(missingBits));
-}
-
-//#endregion
-//#region src/bot/gates/catalog/permissions.ts
-const UNCACHED_MEMBER = "Your server member data could not be resolved. Try again.";
-/**
-* Requires the caller to hold every permission in `scope`, via `checkPermissions`. Refuses outside a guild.
-*
-* Interaction-only and excludes ModalSubmit, since a modal lacks a reliable cached caller member.
-*
-* @param scope - The permission flag bits the caller must all hold.
-* @param options - Override each refusal, the outside-guild one with `notInGuild` and the missing-permissions one with `missing`.
-*
-* @see {@link Gated}
-*
-* @example
-* ```ts
-* import { PermissionFlagsBits } from 'discord.js';
-*
-* \@Gated(RequirePermissions([PermissionFlagsBits.BanMembers]))
-* \@SlashRoute('ban')
-* class BanHandler extends SlashHandler<'ban'> {
-*     async execute() {
-*         const target = this.options.getUser('target');
-*     }
-* }
-* ```
-*/
-function RequirePermissions(scope, options) {
-	return defineGate("RequirePermissions", (ctx) => {
-		if (!ctx.guild) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message));
-		if (!ctx.member) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message ?? UNCACHED_MEMBER));
-		checkPermissions(ctx.member, ctx.guild, scope, false, options?.missing ? { missing: options.missing } : void 0);
-	});
-}
-/**
-* Requires the bot to hold every permission in `scope`, via `checkPermissions`. Refuses outside a guild.
-*
-* It reads the bot's own member, so it attaches to modal handlers as well.
-*
-* @param scope - The permission flag bits the bot must all hold.
-* @param options - Override each refusal, the outside-guild one with `notInGuild` and the missing-permissions one with `missing`.
-*
-* @see {@link Gated}
-*
-* @example
-* ```ts
-* import { PermissionFlagsBits } from 'discord.js';
-*
-* \@Gated(RequireBotPermissions([PermissionFlagsBits.BanMembers]))
-* \@ModalRoute(MyModalId)
-* class MyModalHandler extends ModalHandler<[typeof MyModalId]> {
-*     async execute() {
-*         // ...
-*     }
-* }
-* ```
-*/
-function RequireBotPermissions(scope, options) {
-	return defineGate("RequireBotPermissions", (ctx) => {
-		const botMember = ctx.guild?.members.me;
-		if (!ctx.guild || !botMember) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message));
-		checkPermissions(botMember, ctx.guild, scope, false, options?.missing ? { missing: options.missing } : void 0);
-	});
-}
-/**
-* Requires the caller to have `roleId`, read from the member's role cache. Refuses outside a guild first, then
-* when the role is missing.
-*
-* Interaction-only and excludes ModalSubmit.
-*
-* @param roleId - The role snowflake the caller must hold, read from the member's role cache.
-* @param options - Override each refusal, the outside-guild one with `notInGuild` and the missing-role one with `missingRole`.
-*
-* @see {@link Gated}
-*
-* @example
-* ```ts
-* \@Gated(RequireRole('123456789012345678'))
-* \@SlashRoute('vip')
-* class VipHandler extends SlashHandler<'vip'> {
-*     async execute() {
-*         // ...
-*     }
-* }
-* ```
-*/
-function RequireRole(roleId, options) {
-	return defineGate("RequireRole", (ctx) => {
-		if (!ctx.guild) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message));
-		if (!ctx.member) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message ?? UNCACHED_MEMBER));
-		if (ctx.member.roles.cache.has(roleId)) return;
-		const role = ctx.guild.roles.cache.get(roleId) ?? null;
-		throw pickNotice(options?.missingRole, (message) => new MissingRole(message, role));
-	});
-}
-
 //#endregion
 //#region src/bot/injectors/EmojiInjector.ts
 const emojiStorage = {};
@@ -842,6 +502,37 @@ async function fetchText(client, channelId) {
 	throw new CouldNotFindChannel("Channel not found or not a text channel", channelId);
 }
 
+//#endregion
+//#region src/bot/notices/utils.ts
+function mentionFor(subject) {
+	if (subject instanceof Role) return `<@&${subject.id}>`;
+	return `<@${subject.id}>`;
+}
+
+//#endregion
+//#region src/bot/utilities/permissions/checkPermissions.ts
+function checkPermissions(a, b, c, d, e) {
+	const { for: pFor, in: pIn, scope, inverse = false, missingNotice: missingCtor, dangerousNotice: dangerousCtor } = a instanceof Role || a instanceof GuildMember ? {
+		for: a,
+		in: b,
+		scope: c,
+		inverse: d ?? false,
+		...e
+	} : a;
+	const Missing = missingCtor ?? MissingPermissions;
+	const Dangerous = dangerousCtor ?? HasDangerousPermissions;
+	const subject = mentionFor(pFor);
+	const perms = pIn instanceof Guild ? pFor.permissions : pIn.permissionsFor(pFor, true);
+	const names = (bits) => bits.map((bit) => PermissionNames.get(bit) ?? String(bit));
+	if (inverse) {
+		const present = scope.filter((bit) => perms.has(bit, true));
+		if (present.length > 0) throw new Dangerous(void 0, subject, names(present));
+		return;
+	}
+	const missingBits = scope.filter((bit) => !perms.has(bit, true));
+	if (missingBits.length > 0) throw new Missing(void 0, subject, names(missingBits));
+}
+
 //#endregion
 //#region src/bot/utilities/permissions/checkBotPermissions.ts
 /**
@@ -870,7 +561,7 @@ function checkBotPermissions(target, scope, inverse = false, errors) {
 		const me = target.members.me;
 		if (!me) {
 			const names = scope.map((bit) => PermissionNames.get(bit) ?? String(bit));
-			throw new ((errors?.missing) ?? MissingPermissions)("Missing Permissions", target, names);
+			throw new ((errors?.missingNotice) ?? MissingPermissions)(void 0, "The bot", names);
 		}
 		checkPermissions(me, target, scope, inverse, errors);
 		return;
@@ -879,7 +570,7 @@ function checkBotPermissions(target, scope, inverse = false, errors) {
 	if (!me) {
 		new Logger("checkBotPermissions").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?.missing) ?? MissingPermissions)("Missing Permissions", target, names);
+		throw new ((errors?.missingNotice) ?? MissingPermissions)(void 0, "The bot", names);
 	}
 	checkPermissions(me, target, scope, inverse, errors);
 }
@@ -916,26 +607,26 @@ function getBotRole(guild) {
 * // Check with custom error handling
 * hasPermsToAssign({
 *   targetRole: role,
-*   errors: {
-*     higher: CustomHigherError,
-*     managed: CustomManagedError,
-*     missing: CustomMissingPermissionsError
+*   noticeOverrides: {
+*     higherNotice: CustomHigherNotice,
+*     managedNotice: CustomManagedNotice,
+*     missingNotice: CustomMissingPermissionsNotice
 *   }
 * });
 * ```
 */
 function hasPermsToAssign(roleOrOptions) {
-	const { targetRole, errors } = roleOrOptions instanceof Role ? {
+	const { targetRole, noticeOverrides: errors } = roleOrOptions instanceof Role ? {
 		targetRole: roleOrOptions,
-		errors: void 0
+		noticeOverrides: void 0
 	} : roleOrOptions;
-	const HigherErr = errors?.higher ?? RoleHigherThanMe;
-	const ManagedErr = errors?.managed ?? CannotAssignBotRole;
-	const Missing = errors?.missing ?? MissingPermissions;
+	const HigherNotice = errors?.higherNotice ?? RoleHigherThanMe;
+	const ManagedNotice = errors?.managedNotice ?? CannotAssignBotRole;
+	const MissingNotice = errors?.missingNotice ?? MissingPermissions;
 	const botRole = getBotRole(targetRole.guild);
-	if (targetRole.comparePositionTo(botRole) >= 0) throw new HigherErr("Role is higher than me", targetRole, botRole);
-	if (targetRole.managed) throw new ManagedErr(`Cannot assign managed role ${targetRole.name}`);
-	checkBotPermissions(targetRole.guild, [PermissionFlagsBits.ManageRoles], false, { missing: Missing });
+	if (targetRole.comparePositionTo(botRole) >= 0) throw new HigherNotice("Role is higher than me", targetRole, botRole);
+	if (targetRole.managed) throw new ManagedNotice(`Cannot assign managed role ${targetRole.name}`);
+	checkBotPermissions(targetRole.guild, [PermissionFlagsBits.ManageRoles], false, { missingNotice: MissingNotice });
 }
 
 //#endregion
@@ -1062,115 +753,310 @@ async function updateMemberRoles(rolesToAdd, rolesToRemove, member) {
 	await member.roles.set([...updated]);
 }
 
-//#endregion
-//#region src/bot/harmlessApiCodes.ts
-/**
-* Discord API error codes that mean a dead end on an interaction, a dead token, a double ack, or a gone
-* message. There is nothing to show the user and no bug to report. The controller boundary drops them on
-* the original throw, and {@link ReplySender} drops them on its own send.
-*
-* @internal
-*/
-const HARMLESS_API_CODES = new Set([
-	RESTJSONErrorCodes.UnknownInteraction,
-	RESTJSONErrorCodes.InteractionHasAlreadyBeenAcknowledged,
-	RESTJSONErrorCodes.UnknownMessage
-]);
-
-//#endregion
-//#region src/miscellaneous/flagsFor.ts
-/**
-* Builds the `flags` bitfield for a framework reply. Every framework reply is ComponentsV2, so the
-* IsComponentsV2 flag is always set.
-*
-* @param ephemeral - Whether the reply is ephemeral.
-* @returns The OR'd `MessageFlags` value as a plain number.
-*
-* @internal
-*/
-function flagsFor(ephemeral) {
-	let flags = MessageFlags.IsComponentsV2;
-	if (ephemeral) flags |= MessageFlags.Ephemeral;
-	return flags;
-}
-
 //#endregion
 //#region src/bot/ReplySender.ts
+function seedState(interaction) {
+	if (interaction.deferred && interaction.ephemeral === null) return "deferred-update";
+	if (interaction.replied) return "replied";
+	if (interaction.deferred) return "deferred-reply";
+	return "unacked";
+}
 /**
-* Sends a {@link ReplyResponse} to an interaction, picking reply, editReply, or followUp from the live
-* acknowledgement state. Logs and drops its own send failures so a dead token never escapes into the
-* controller.
+* Writes interaction responses through the discord.js interaction. Construction is internal to the repliable
+* handler bases and the dispatcher.
 */
-var ReplySender = class {
+var ReplySender = class extends BaseReplySender {
 	interaction;
-	logger = new Logger("ReplySender");
-	constructor(interaction) {
+	constructor(interaction, routeId) {
+		super(routeId, seedState(interaction));
 		this.interaction = interaction;
 	}
-	/**
-	* Sends the reply and returns the sent message so a caller can attach a collector to it. Never throws,
-	* a failed send is logged and dropped and resolves to `undefined`.
-	*
-	* @param response - The ComponentsV2 reply to show.
-	* @param ephemeral - Whether the reply is ephemeral. {@default `true`}
-	* @returns The sent {@link Message}, or `undefined` when the send was swallowed.
-	*/
-	async send(response, ephemeral = true) {
-		try {
-			return await this.dispatch(response, ephemeral);
-		} catch (error) {
-			this.logSwallowed("send", error);
-			return;
-		}
+	async writeReply(response, opts) {
+		const result = await this.interaction.reply({
+			...this.replyOptions(response, sendFlags(opts)),
+			withResponse: true
+		});
+		return this.createdMessage(result);
 	}
-	/**
-	* Edits an already-sent message to a new {@link ReplyResponse}. Used to swap a confirmation prompt for
-	* its outcome. Never throws, a failed edit is logged and dropped.
-	*
-	* @param message - The message to edit (the handle a prior {@link send} returned).
-	* @param response - The reply to replace it with.
-	*/
-	async edit(message, response) {
-		try {
-			await this.interaction.webhook.editMessage(message, this.editBody(response));
-		} catch (error) {
-			this.logSwallowed("edit", error);
-		}
+	async writeDefer(opts) {
+		await this.interaction.deferReply({ flags: deferFlags(opts) });
 	}
-	async dispatch(response, ephemeral) {
-		if (this.interaction.replied) return await this.interaction.followUp(this.replyOptions(response, ephemeral));
-		if (this.interaction.deferred) {
-			if (this.interaction.ephemeral === null) return await this.interaction.followUp(this.replyOptions(response, ephemeral));
-			return await this.interaction.editReply(this.editBody(response));
-		}
-		await this.interaction.reply(this.replyOptions(response, ephemeral));
-		return await this.interaction.fetchReply();
+	async writeDeferUpdate() {
+		await this.sourceInteraction("deferUpdate").deferUpdate();
+	}
+	async writeUpdate(response) {
+		const result = await this.sourceInteraction("update").update({
+			...this.updateOptions(response),
+			withResponse: true
+		});
+		return this.createdMessage(result);
+	}
+	async writeFollowUp(response, opts) {
+		return await this.interaction.followUp(this.replyOptions(response, sendFlags(opts)));
+	}
+	async writeEditOriginal(response) {
+		return await this.interaction.editReply(this.editOptions(response));
 	}
-	replyOptions(response, ephemeral) {
+	async writeEditTarget(targetId, response) {
+		return await this.interaction.webhook.editMessage(targetId, this.editOptions(response));
+	}
+	async writeDeleteOriginal() {
+		await this.interaction.deleteReply();
+	}
+	async writeDeleteTarget(targetId) {
+		await this.interaction.deleteReply(targetId);
+	}
+	async writeModal(data) {
+		const { interaction } = this;
+		if (interaction.isModalSubmit()) this.rejectModalSubmit();
+		await interaction.showModal(data);
+	}
+	guardModalSource() {
+		if (this.interaction.isModalSubmit()) this.rejectModalSubmit();
+	}
+	rejectModalSubmit() {
+		throw new SeedcordError(SeedcordErrorCode.ReplyIllegalAckState, [
+			"showModal",
+			"this interaction is a modal submit",
+			"A modal cannot open another modal.",
+			this.routeId
+		]);
+	}
+	sourceInteraction(method) {
+		const { interaction } = this;
+		if (interaction.isMessageComponent()) return interaction;
+		if (interaction.isModalSubmit() && interaction.isFromMessage()) return interaction;
+		throw new SeedcordError(SeedcordErrorCode.ReplyUpdateWithoutSource, [method, this.routeId]);
+	}
+	replyOptions(response, flags) {
+		const reply = this.serialize(response);
 		return {
-			components: response.components,
-			flags: flagsFor(ephemeral),
-			...response.allowedMentions && { allowedMentions: response.allowedMentions },
-			...response.files && { files: response.files }
+			components: reply.components,
+			flags,
+			...reply.allowedMentions && { allowedMentions: reply.allowedMentions },
+			...reply.files && { files: [...reply.files] }
 		};
 	}
-	editBody(response) {
+	editOptions(response) {
+		const reply = this.serialize(response);
 		return {
-			components: response.components,
+			components: reply.components,
 			flags: MessageFlags.IsComponentsV2,
-			...response.allowedMentions && { allowedMentions: response.allowedMentions },
-			...response.files && { files: response.files }
+			...reply.allowedMentions && { allowedMentions: reply.allowedMentions },
+			...reply.files && { files: [...reply.files] }
 		};
 	}
-	logSwallowed(action, error) {
-		if (error instanceof DiscordAPIError && HARMLESS_API_CODES.has(error.code)) {
-			this.logger.debug(`reply ${action} hit harmless code ${error.code}`);
-			return;
-		}
-		this.logger.error(`reply ${action} failed`, error);
+	updateOptions(response) {
+		const reply = this.serialize(response);
+		return {
+			components: reply.components,
+			flags: MessageFlags.IsComponentsV2,
+			...reply.allowedMentions && { allowedMentions: reply.allowedMentions },
+			...reply.files && { files: [...reply.files] }
+		};
+	}
+	createdMessage(result) {
+		return result.resource?.message ?? void 0;
 	}
 };
 
+//#endregion
+//#region src/bot/utilities/miscellaneous/slashRouteOf.ts
+/**
+* Computes the dispatch route for a chat-input or autocomplete interaction. The controller and
+* `seedcord codegen` both assemble route keys through the same {@link buildSlashRoute}, so a dispatched
+* interaction and a generated registry key always match.
+*
+* @internal
+*/
+function slashRouteOf(interaction) {
+	const group = interaction.options.getSubcommandGroup(false) ?? void 0;
+	const subcommand = interaction.options.getSubcommand(false) ?? void 0;
+	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();
+/**
+* Processes an error into a user-facing reply and routes its report.
+*
+* A {@link Notice} always renders its own reply. A reporting denial (`report: true`) additionally
+* publishes `handledException` on the interaction path. A raw, non-denial throw publishes
+* `unknownException` and renders the configured `defaultError` (or a generic {@link Fault}). One uuid is
+* threaded into both the reply and the bus payload.
+*/
+function extractErrorResponse(error, core, origin) {
+	const uuid = crypto.randomUUID();
+	const developerUsername = core.config.notifications?.developerUsername;
+	const ctx = developerUsername === void 0 ? { uuid } : {
+		uuid,
+		developerUsername
+	};
+	if (error instanceof Notice) {
+		if (error.report) reportFault(error, core, origin, uuid);
+		return {
+			uuid,
+			response: error.render(ctx)
+		};
+	}
+	reportRawFault(error, core, origin, uuid);
+	const override = core.config.errors?.defaultError;
+	return {
+		uuid,
+		response: override ? new override(uuid).render(ctx) : new Fault().render(ctx)
+	};
+}
+function withThrottle(origin, error, publish) {
+	const key = faultKey(origin, error);
+	if (!faultThrottle.shouldReport(key)) {
+		logger$2.info(`throttled duplicate fault ${key}`);
+		return;
+	}
+	publish();
+	faultThrottle.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", {
+			denial,
+			uuid,
+			source: buildInteractionSource(origin.interaction)
+		});
+		else if (origin.event) core.bus.publish("handledException", {
+			denial,
+			uuid,
+			source: buildEventSource(origin.event, origin)
+		});
+		else core.bus.publish("unknownException", {
+			uuid,
+			error: denial,
+			...scalarActors(origin),
+			metadata: metadataFor(origin)
+		});
+	});
+}
+function causeLine(error) {
+	const { cause } = error;
+	if (!Error.isError(cause)) return "";
+	const [first] = cause.message.split("\n");
+	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", {
+			uuid,
+			error,
+			...scalarActors(origin),
+			metadata: metadataFor(origin)
+		});
+	});
+}
+function scalarActors(origin) {
+	return {
+		guild: origin.guild ? {
+			id: origin.guild.id,
+			name: origin.guild.name
+		} : void 0,
+		user: origin.user ? {
+			id: origin.user.id,
+			username: origin.user.username
+		} : void 0
+	};
+}
+function metadataFor(origin) {
+	if (origin.event) return {
+		eventName: origin.event.name,
+		handler: origin.event.handler,
+		args: origin.event.args
+	};
+	return origin.metadata;
+}
+function buildEventSource(event, origin) {
+	return {
+		kind: "event",
+		eventName: event.name,
+		handler: event.handler,
+		userId: origin.user?.id ?? null,
+		guildId: origin.guild?.id ?? null,
+		channelId: event.channelId,
+		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}`;
+}
+/** The stable route id of a repliable interaction, its slash route path, command name, or customId prefix. */
+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;
+	return {
+		kind: "interaction",
+		interactionKind: interactionKind(interaction),
+		command,
+		customId,
+		userId: interaction.user.id,
+		guildId: interaction.guildId,
+		channelId: interaction.channelId,
+		interactionId: interaction.id,
+		raw: interaction
+	};
+}
+function interactionKind(interaction) {
+	if (interaction.isChatInputCommand()) return "slash";
+	if (interaction.isContextMenuCommand()) return "context-menu";
+	if (interaction.isButton()) return "button";
+	if (interaction.isAnySelectMenu()) return "select";
+	return "modal";
+}
+
 //#endregion
 //#region src/bot/confirm/reserved.ts
 const RESERVED_CONFIRM_PREFIX = "__seedcord_confirm";
@@ -1215,152 +1101,36 @@ async function collectChoice(message, userId, timeoutMs) {
 		return null;
 	}
 }
-async function settle(sender, interaction, message, outcome) {
+async function settle(sender, message, outcome) {
 	if (outcome === void 0) {
-		await interaction.deleteReply(message).catch(() => void 0);
+		await sender.delete(message).catch(() => void 0);
 		return;
 	}
 	await sender.edit(message, typeof outcome === "function" ? await outcome() : outcome);
 }
-async function getConfirmation(interaction, prompt, options) {
-	const { ephemeral = true, timeoutMs = DEFAULT_TIMEOUT_MS } = options ?? {};
-	const response = typeof prompt === "string" ? defaultPrompt(prompt, options) : await prompt(CONFIRM_IDS);
-	const sender = new ReplySender(interaction);
-	const message = await sender.send(response, ephemeral);
-	if (!message) return false;
-	const winner = await collectChoice(message, interaction.user.id, timeoutMs);
-	if (!winner) {
-		await settle(sender, interaction, message, options?.onTimeout);
-		return false;
-	}
-	await winner.deferUpdate().catch(() => void 0);
-	const confirmed = winner.customId === CONFIRM_IDS.confirm;
-	await settle(sender, interaction, message, confirmed ? options?.onConfirm : options?.onCancel);
-	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);
+async function getConfirmation(interaction, prompt, options) {
+	const { ephemeral = true, timeoutMs = DEFAULT_TIMEOUT_MS } = options ?? {};
+	const response = typeof prompt === "string" ? defaultPrompt(prompt, options) : await prompt(CONFIRM_IDS);
+	const sender = new ReplySender(interaction, interactionRoute(interaction));
+	const message = await sender.send(response, { ephemeral });
+	const winner = await collectChoice(message, interaction.user.id, timeoutMs);
+	if (!winner) {
+		await settle(sender, message, options?.onTimeout);
+		return false;
 	}
-};
+	await winner.deferUpdate().catch(() => void 0);
+	const confirmed = winner.customId === CONFIRM_IDS.confirm;
+	await settle(sender, message, confirmed ? options?.onConfirm : options?.onCancel);
+	return confirmed;
+}
 
 //#endregion
 //#region src/handlers/BaseHandler.ts
 /**
-* Base class for a Discord event or interaction handler. Don't register handlers directly, use the more specific handler subclasses.
+* The gateway base, fixes the core base's `TCore` to the gateway {@link Core} and adds the `getEvent`
+* gate hook.
 */
-var BaseHandler = class {
-	core;
-	event;
-	logger;
-	dispatch;
-	constructor(event, core, dispatch) {
-		this.core = core;
-		this.event = event;
-		this.logger = new Logger(this.constructor.name);
-		this.dispatch = dispatch;
-	}
+var BaseHandler$1 = class extends BaseHandler {
 	/** @internal */
 	getEvent() {
 		return this.event;
@@ -1377,43 +1147,56 @@ var BaseHandler = class {
 *
 * @typeParam Repliable - The interaction type this middleware processes
 */
-var InteractionMiddleware = class extends BaseHandler {
+var InteractionMiddleware = class extends BaseHandler$1 {
 	constructor(event, core) {
 		super(event, core);
 	}
 };
 
 //#endregion
-//#region src/handlers/interaction/InteractionHandler.ts
+//#region src/handlers/RepliableHandler.ts
 /**
-* Shared base the typed interaction handlers extend.
+* Shared base the repliable interaction handlers extend.
 *
-* Not a public entry point. You should be using {@link SlashHandler}, {@link ButtonHandler}, {@link ModalHandler},
-* or {@link SelectMenuHandler} instead. This class only carries the repliable-event plumbing those bases share,
-* so DO NOT use it directly.
+* 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 Repliable - The interaction type this handler processes
+* @typeParam Event - The repliable interaction type this handler processes
 */
-var InteractionHandler = class extends BaseHandler {
-	constructor(event, core, dispatch) {
-		super(event, core, dispatch);
+var RepliableHandler = class extends RepliableHandler$1 {
+	/** @internal */
+	getEvent() {
+		return this.event;
+	}
+	buildSender(event, _core, routeId) {
+		return new ReplySender(event, routeId);
 	}
 };
 
 //#endregion
-//#region src/bot/utilities/miscellaneous/slashRouteOf.ts
+//#region src/handlers/interaction/InteractionHandler.ts
 /**
-* Computes the dispatch route for a chat-input or autocomplete interaction. The controller and
-* `seedcord codegen` both assemble route keys through the same {@link buildSlashRoute}, so a dispatched
-* interaction and a generated registry key always match.
+* Shared base the typed interaction handlers extend.
 *
-* @internal
+* 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
 */
-function slashRouteOf(interaction) {
-	const group = interaction.options.getSubcommandGroup(false) ?? void 0;
-	const subcommand = interaction.options.getSubcommand(false) ?? void 0;
-	return buildSlashRoute(interaction.commandName, subcommand, group);
-}
+var InteractionHandler = class extends RepliableHandler {
+	constructor(event, core, dispatch) {
+		super(event, core, dispatch);
+	}
+	/**
+	* 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).
+	*/
+	showModal(modal) {
+		return this.sender.showModal(modal);
+	}
+};
 
 //#endregion
 //#region src/handlers/interaction/SlashHandler.ts
@@ -1449,7 +1232,7 @@ var SlashHandler = class extends InteractionHandler {
 	}
 	/**
 	* Run the arm for whichever command fired. Use this only when the handler is registered for several
-	* routes. A single-route handler reads `this.options` directly instead, match buys nothing there.
+	* routes.
 	*
 	* Provide one arm per registered route, keyed by its route string, and each arm receives that route's
 	* own narrowed options. The arms must cover every route in the generic, a missing route or an unknown
@@ -1473,7 +1256,7 @@ var SlashHandler = class extends InteractionHandler {
 	*/
 	async match(arms) {
 		const route = slashRouteOf(this.event);
-		const arm = arms[route];
+		const arm = Object.hasOwn(arms, route) ? arms[route] : void 0;
 		if (!arm) throw new SeedcordError(SeedcordErrorCode.SlashMatchArmMissing, [route]);
 		return await arm(this.options);
 	}
@@ -1540,15 +1323,15 @@ var ContextMenuHandler = class extends InteractionHandler {
 * }
 * ```
 */
-var AutocompleteHandler = class extends BaseHandler {
+var AutocompleteHandler = class extends BaseHandler$1 {
 	constructor(event, core, dispatch) {
 		super(event, core, dispatch);
 	}
+	decodedFocused;
 	/**
 	* The focused option for this interaction. `value` is always the raw partial string the user is typing,
 	* even for an integer or number option, so coerce it yourself when you need a number.
 	*/
-	decodedFocused;
 	get focused() {
 		if (this.decodedFocused) return this.decodedFocused;
 		const raw = this.event.options.getFocused(true);
@@ -1564,7 +1347,7 @@ var AutocompleteHandler = class extends BaseHandler {
 	* match is how you read it. There is no single-field shortcut the way slash/component handlers have one.
 	*
 	* Provide one arm per autocompletable field across the registered commands, keyed by field name. Each
-	* arm receives the focused partial value and a `respond` pinned to that field's choice value type. The
+	* arm receives the focused partial value and a `respond` typed to that field's choice value. The
 	* arms must cover every autocompletable field, a missing field or an unknown key is a compile error. A
 	* focused field with no arm, only reachable from a stale-deployed command, throws at runtime.
 	*
@@ -1586,11 +1369,15 @@ var AutocompleteHandler = class extends BaseHandler {
 	*/
 	async match(arms) {
 		const { name, value } = this.focused;
-		const respond = (choices) => this.event.respond(choices);
-		const arm = arms[name];
+		const respond = (choices) => this.respond(choices);
+		const arm = Object.hasOwn(arms, name) ? arms[name] : void 0;
 		if (!arm) throw new SeedcordError(SeedcordErrorCode.AutocompleteMatchArmMissing, [name]);
 		return await arm(value, respond);
 	}
+	/** 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);
+	}
 	/** The firing command route, for a field whose completion differs per registered command. */
 	get route() {
 		return slashRouteOf(this.event);
@@ -1598,7 +1385,7 @@ var AutocompleteHandler = class extends BaseHandler {
 	/**
 	* The already-entered options on this command, restricted to the kinds Discord resolves during autocomplete
 	* (string, integer, number, boolean) with every read nullable, since a sibling is partial while the user
-	* types the focused field. Read the focused field from `this.focused`, not here.
+	* types the focused field. The focused field is on `this.focused`.
 	*/
 	get options() {
 		return this.event.options;
@@ -1610,25 +1397,25 @@ var AutocompleteHandler = class extends BaseHandler {
 /**
 * Shared base the customId-routed component handlers extend.
 *
-* Not a public entry point. You should be using {@link ButtonHandler}, {@link SelectMenuHandler}, or
-* {@link ModalHandler} instead. This class only carries the customId decode and route-matching plumbing
-* those bases share, so DO NOT use it directly.
+* Not a public entry point. Extend {@link ButtonHandler}, {@link SelectMenuHandler}, or {@link ModalHandler}
+* instead. This class defines the customId decode and the route matching those bases share.
 *
 * @typeParam Event - The component interaction type this handler processes
 * @typeParam Defs - The customId route definitions registered on the concrete handler
 */
 var ComponentHandler = class extends InteractionHandler {
-	get registeredDefs() {
-		const defs = Reflect.getMetadata(ComponentDefsKey, this.constructor);
-		if (!defs) throw new SeedcordError(SeedcordErrorCode.CustomIdHandlerRouteMissing, [this.constructor.name]);
-		return defs;
+	/** Rewrite the source message this component interaction came from. */
+	update(response) {
+		return this.sender.update(response);
+	}
+	/** Acknowledge the component without changing the source message. */
+	deferUpdate() {
+		return this.sender.deferUpdate();
 	}
 	decoded;
 	get route() {
-		if (this.decoded) return this.decoded;
-		const decoded = decodeFor(this.registeredDefs, this.event.customId);
-		this.decoded = decoded;
-		return decoded;
+		this.decoded ??= decodeComponentRoute(this.constructor, this.event.customId);
+		return this.decoded;
 	}
 	/**
 	* The decoded params of the single route this handler is registered for.
@@ -1647,10 +1434,11 @@ var ComponentHandler = class extends InteractionHandler {
 	* handler `this.params` is `never`, so match is the only way to read the decoded params.
 	*
 	* Provide one arm per registered route, keyed by its prefix, and each arm receives that route's own
-	* decoded params. The arms must cover every registered def, a missing prefix or an unknown key is a
-	* compile error. Decoding runs before any arm, so a stale or corrupt wire throws before an arm body executes.
+	* decoded params. The arms cover every registered route prefix, checked at compile time, and a prefix
+	* unmatched at runtime throws `CustomIdMatchArmMissing`. Decoding runs before any arm, so a stale or
+	* corrupt wire throws before an arm body executes.
 	*
-	* @param arms - One handler per registered route, keyed by prefix.
+	* @param arms - One callback per registered route, keyed by prefix.
 	* @returns The result of the arm that ran.
 	*
 	* @example
@@ -1659,8 +1447,8 @@ var ComponentHandler = class extends InteractionHandler {
 	* class ReviewButtons extends ButtonHandler<[typeof Approve, typeof Reject]> {
 	*     async execute() {
 	*         await this.match({
-	*             approve: ({ userId }) => this.event.reply(`approved <@${userId}>`),
-	*             reject: ({ userId }) => this.event.reply(`rejected <@${userId}>`)
+	*             approve: ({ userId }) => this.reply(`approved <@${userId}>`),
+	*             reject: ({ userId }) => this.reply(`rejected <@${userId}>`)
 	*         });
 	*     }
 	* }
@@ -1668,7 +1456,7 @@ var ComponentHandler = class extends InteractionHandler {
 	*/
 	async match(arms) {
 		const { prefix, params } = this.route;
-		const arm = arms[prefix];
+		const arm = Object.hasOwn(arms, prefix) ? arms[prefix] : void 0;
 		if (!arm) throw new SeedcordError(SeedcordErrorCode.CustomIdMatchArmMissing, [prefix]);
 		return await arm(params);
 	}
@@ -1680,8 +1468,9 @@ var ComponentHandler = class extends InteractionHandler {
 * Base class for a button interaction handler.
 *
 * Register the customId definitions this handler decodes with `@ButtonRoute`, list the same ones in the
-* generic, then read `this.params` for a single route or `this.match` for several. Passing different
-* definitions to the decorator and the generic is a compile error.
+* generic, then read `this.params` for a single route or `this.match` for several. Reply through the handler
+* members, or rewrite the source message with `this.update`. Passing different definitions to the decorator
+* and the generic is a compile error.
 *
 * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof ApproveId]`.
 * @typeParam Cache - The interaction cache state, `'cached'` by default.
@@ -1692,7 +1481,7 @@ var ComponentHandler = class extends InteractionHandler {
 * class ApproveButton extends ButtonHandler<[typeof ApproveId]> {
 *     async execute() {
 *         const { userId } = this.params;
-*         await this.event.reply(`approved <@${userId}>`);
+*         await this.reply(`approved <@${userId}>`);
 *     }
 * }
 * ```
@@ -1706,7 +1495,8 @@ var ButtonHandler = class extends ComponentHandler {};
 *
 * Register the customId definitions this handler decodes with `@ModalRoute`, list the same ones in the
 * generic, then read `this.params` for a single route or `this.match` for several. Read the submitted
-* inputs from `this.event.fields`.
+* inputs from `this.event.fields`, and reply through the handler members. Discord forbids opening a modal in
+* response to a modal, so `showModal` fails compilation on this kind.
 *
 * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof ConfigId]`.
 * @typeParam Cache - The interaction cache state, `'cached'` by default.
@@ -1718,7 +1508,7 @@ var ButtonHandler = class extends ComponentHandler {};
 *     async execute() {
 *         const { guildId } = this.params;
 *         const name = this.event.fields.getTextInputValue('name');
-*         await this.event.reply(`saved ${name} for ${guildId}`);
+*         await this.reply(`saved ${name} for ${guildId}`);
 *     }
 * }
 * ```
@@ -1732,7 +1522,8 @@ var ModalHandler = class extends ComponentHandler {};
 *
 * Pass the select kind first and the customId definitions second, the same order as `@SelectMenuRoute`,
 * so `this.event` and `this.event.values` are narrowed to that kind. Read `this.params` for a single
-* route or `this.match` for several.
+* route or `this.match` for several, and reply through the handler members or rewrite the source message
+* with `this.update`.
 *
 * @typeParam Kind - The select kind from {@link SelectMenuKind}, e.g. `SelectMenuKind.User`.
 * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof AssignId]`.
@@ -1744,7 +1535,7 @@ var ModalHandler = class extends ComponentHandler {};
 * class AssignSelect extends SelectMenuHandler<SelectMenuKind.User, [typeof AssignId]> {
 *     async execute() {
 *         const { roleId } = this.params;
-*         await this.event.reply(`assigning ${this.event.values.length} member(s) to <@&${roleId}>`);
+*         await this.reply(`assigning ${this.event.values.length} member(s) to <@&${roleId}>`);
 *     }
 * }
 * ```
@@ -1775,7 +1566,7 @@ var SelectMenuHandler = class extends ComponentHandler {};
 * }
 * ```
 */
-var EventHandler = class extends BaseHandler {
+var EventHandler = class extends BaseHandler$1 {
 	firedEvent;
 	constructor(event, core, eventName) {
 		super(event, core);
@@ -1828,7 +1619,7 @@ var EventHandler = class extends BaseHandler {
 *
 * @typeParam EventName - One or more `ClientEvents` keys. Defaults to every event (catchall).
 */
-var EventMiddleware = class extends BaseHandler {
+var EventMiddleware = class extends BaseHandler$1 {
 	firedEvent;
 	constructor(event, core, eventName) {
 		super(event, core);
@@ -2010,16 +1801,16 @@ var Paginator = class {
 		const loadPage = (ctx, n) => this.page(ctx, n);
 		this.Handler = class Nav extends ButtonHandler {
 			async execute() {
-				await this.event.deferUpdate();
+				await this.deferUpdate();
 				const response = await loadPage(contextOf(this.event, this.core), this.params.page);
-				await new ReplySender(this.event).edit(this.event.message, response);
+				await this.update(response);
 			}
 		};
 	}
 	/** 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).send(response, this.config.ephemeral ?? false);
+		return new ReplySender(interaction, interactionRoute(interaction)).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) {
@@ -2143,19 +1934,184 @@ function Subscribe(subscriber, options) {
 	};
 }
 
+//#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;
+/**
+* Sends component messages to a Discord webhook through `@discordjs/rest`.
+*
+* @throws A `SeedcordError` when the url does not carry a webhook id and token.
+*/
+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
+			})) }
+		});
+	}
+};
+
 //#endregion
 //#region src/subscribers/bases/WebhookLog.ts
 /**
-* Abstract webhook logging handler for subscriber events.
+* Base class for subscribers that deliver their event to a Discord webhook.
 *
-* Extends Subscriber to provide webhook-based logging capabilities.
-* Implementations must define the webhook client to send messages to by implementing the webhook property.
+* 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.
 *
-* @typeParam KeyOfSubscribers - The specific subscriber type this handler processes
+* @typeParam KeyOfSubscribers - The subscription key this reporter receives
 */
-var WebhookLog = class extends Subscriber {
-	constructor(data, core) {
-		super(data, core);
+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;
 	}
 };
 
@@ -2213,7 +2169,6 @@ function slashRouteLeaves(commands) {
 var CommandRegistry = class {
 	core;
 	onDeployed;
-	name = "Commands";
 	logger = new Logger("Commands");
 	isInitialised = false;
 	globalCommands = [];
@@ -2401,231 +2356,64 @@ function deriveEventActor(args) {
 			user: arg.user,
 			channelId: null
 		};
-		if (arg instanceof User) return {
-			guild: null,
-			member: null,
-			user: arg,
-			channelId: null
-		};
-	}
-	return {
-		guild: null,
-		member: null,
-		user: null,
-		channelId: null
-	};
-}
-
-//#endregion
-//#region src/bot/gates/runGates.ts
-function interactionGateContext(interaction, core) {
-	const rawMember = interaction.member;
-	const memberRoleIds = rawMember instanceof GuildMember ? [...rawMember.roles.cache.keys()].filter((id) => id !== interaction.guildId) : rawMember?.roles ?? [];
-	return {
-		kind: "interaction",
-		interaction,
-		core,
-		user: interaction.user,
-		guild: interaction.guild,
-		member: rawMember instanceof GuildMember ? rawMember : null,
-		userId: interaction.user.id,
-		guildId: interaction.guildId,
-		channelId: interaction.channelId,
-		memberRoleIds,
-		memberPermissions: interaction.memberPermissions?.bitfield ?? null,
-		routeId: null
-	};
-}
-function eventGateContext(eventName, args, core) {
-	const actor = deriveEventActor(args);
-	return {
-		kind: "event",
-		core,
-		eventName,
-		payload: args,
-		user: actor.user,
-		guild: actor.guild,
-		member: actor.member,
-		userId: actor.user?.id ?? null,
-		guildId: actor.guild?.id ?? null,
-		channelId: actor.channelId,
-		memberRoleIds: actor.member ? [...actor.member.roles.cache.keys()].filter((id) => id !== actor.guild?.id) : [],
-		memberPermissions: actor.member?.permissions.bitfield ?? null,
-		routeId: null
-	};
-}
-
-//#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");
-/**
-* The single throttle for every fault publish, so a recurring fault reports once per window across both
-* the interaction and event paths. Exported so tests reset it between cases.
-*
-* @internal
-*/
-const faultThrottle = new FaultThrottle();
-/**
-* Processes an error into a user-facing reply and routes its report.
-*
-* A {@link Notice} always renders its own reply. A reporting denial (`report: true`) additionally
-* publishes `handledException` on the interaction path. A raw, non-denial throw publishes
-* `unknownException` and renders the configured `defaultError` (or a generic {@link Fault}). One uuid is
-* threaded into both the reply and the bus payload.
-*
-* @internal
-*/
-function extractErrorResponse(error, core, origin) {
-	const uuid = crypto.randomUUID();
-	const developerUsername = core.config.notifications?.developerUsername;
-	const ctx = developerUsername === void 0 ? { uuid } : {
-		uuid,
-		developerUsername
-	};
-	if (error instanceof Notice) {
-		if (error.report) reportFault(error, core, origin, uuid);
-		return {
-			uuid,
-			response: error.render(ctx)
-		};
-	}
-	reportRawFault(error, core, origin, uuid);
-	const override = core.config.errors?.defaultError;
-	return {
-		uuid,
-		response: override ? new override(uuid).render(ctx) : new Fault().render(ctx)
-	};
-}
-function withThrottle(origin, error, publish) {
-	const key = faultKey(origin, error);
-	if (!faultThrottle.shouldReport(key)) {
-		logger$2.info(`throttled duplicate fault ${key}`);
-		return;
+		if (arg instanceof User) return {
+			guild: null,
+			member: null,
+			user: arg,
+			channelId: null
+		};
 	}
-	publish();
-	faultThrottle.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", {
-			denial,
-			uuid,
-			source: buildInteractionSource(origin.interaction)
-		});
-		else if (origin.event) core.bus.publish("handledException", {
-			denial,
-			uuid,
-			source: buildEventSource(origin.event, origin)
-		});
-		else core.bus.publish("unknownException", {
-			uuid,
-			error: denial,
-			guild: origin.guild,
-			user: origin.user,
-			metadata: metadataFor(origin)
-		});
-	});
-}
-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}`);
-		core.bus.publish("unknownException", {
-			uuid,
-			error,
-			guild: origin.guild,
-			user: origin.user,
-			metadata: metadataFor(origin)
-		});
-	});
-}
-function metadataFor(origin) {
-	if (origin.event) return {
-		eventName: origin.event.name,
-		handler: origin.event.handler,
-		args: origin.event.args
-	};
-	return origin.metadata;
-}
-function buildEventSource(event, origin) {
 	return {
-		kind: "event",
-		eventName: event.name,
-		handler: event.handler,
-		userId: origin.user?.id ?? null,
-		guildId: origin.guild?.id ?? null,
-		channelId: event.channelId,
-		raw: event.args
+		guild: null,
+		member: null,
+		user: null,
+		channelId: null
 	};
 }
-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;
+
+//#endregion
+//#region src/bot/gates/runGates.ts
+function interactionGateContext(interaction, core) {
+	const rawMember = interaction.member;
+	const memberRoleIds = rawMember instanceof GuildMember ? [...rawMember.roles.cache.keys()].filter((id) => id !== interaction.guildId) : rawMember?.roles ?? [];
 	return {
 		kind: "interaction",
-		interactionKind: interactionKind(interaction),
-		command,
-		customId,
+		interaction,
+		core,
+		user: interaction.user,
+		guild: interaction.guild,
+		member: rawMember instanceof GuildMember ? rawMember : null,
 		userId: interaction.user.id,
 		guildId: interaction.guildId,
 		channelId: interaction.channelId,
-		interactionId: interaction.id,
-		raw: interaction
+		memberRoleIds,
+		memberPermissions: interaction.memberPermissions?.bitfield ?? null,
+		appPermissions: interaction.appPermissions.bitfield,
+		memberGuildPermissions: rawMember instanceof GuildMember ? rawMember.permissions.bitfield : null,
+		appGuildPermissions: interaction.guild?.members.me?.permissions.bitfield ?? null,
+		routeId: null
 	};
 }
-function interactionKind(interaction) {
-	if (interaction.isChatInputCommand()) return "slash";
-	if (interaction.isContextMenuCommand()) return "context-menu";
-	if (interaction.isButton()) return "button";
-	if (interaction.isAnySelectMenu()) return "select";
-	return "modal";
+function eventGateContext(eventName, args, core) {
+	const actor = deriveEventActor(args);
+	return {
+		kind: "event",
+		core,
+		eventName,
+		payload: args,
+		user: actor.user,
+		guild: actor.guild,
+		member: actor.member,
+		userId: actor.user?.id ?? null,
+		guildId: actor.guild?.id ?? null,
+		channelId: actor.channelId,
+		memberRoleIds: actor.member ? [...actor.member.roles.cache.keys()].filter((id) => id !== actor.guild?.id) : [],
+		memberPermissions: actor.member?.permissions.bitfield ?? null,
+		appPermissions: null,
+		memberGuildPermissions: actor.member?.permissions.bitfield ?? null,
+		appGuildPermissions: actor.guild?.members.me?.permissions.bitfield ?? null,
+		routeId: null
+	};
 }
 
 //#endregion
@@ -2640,7 +2428,7 @@ const logger$1 = new Logger("EventBoundary");
 */
 function handleEventFault(caught, eventName, handlerName, args, core) {
 	if (caught instanceof Silence) {
-		if (caught.reason !== void 0) logger$1.debug(`Silence: ${caught.reason}`);
+		if (caught.reason !== void 0 && (core.config.errors?.logSilences ?? true)) logger$1.debug(`Silence: ${caught.reason}`);
 		return;
 	}
 	if (!Error.isError(caught)) throw caught;
@@ -2676,11 +2464,12 @@ var EventDispatcher = class {
 	core;
 	logger = new Logger("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 = [];
@@ -2849,15 +2638,22 @@ 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) => {
+			if (this.draining) return;
 			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);
-				});
-			})();
+			const run = 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);
+			});
+			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;
@@ -2885,35 +2681,55 @@ var EventDispatcher = class {
 };
 
 //#endregion
-//#region src/bot/defaults/UnhandledEvent.ts
+//#region src/bot/defaults/UnhandledRepliable.ts
 /**
-* Default handler for unhandled interactions. A reply failure here rides the controller boundary as a
-* raw fault, so it needs no decorator of its own.
-*
-* @internal
+* @internal Default handler for unhandled repliable interactions.
 */
-var UnhandledEvent = class extends InteractionHandler {
+var UnhandledRepliable = class extends InteractionHandler {
 	async execute() {
-		await this.event.reply({
-			content: `Feature not implemented yet.`,
-			flags: MessageFlags.Ephemeral
-		});
+		await this.reply("Feature not implemented yet.");
+	}
+};
+
+//#endregion
+//#region src/bot/defaults/UnhandledAutocomplete.ts
+/**
+* @internal Default handler for an autocomplete with no registered handler.
+*/
+var UnhandledAutocomplete = class extends AutocompleteHandler {
+	async execute() {
+		await this.respond([]);
 	}
 };
 
+//#endregion
+//#region src/bot/harmlessApiCodes.ts
+/**
+* Discord API error codes that mean a dead end on an interaction, a dead token, a double ack, or a gone
+* message. Nothing to show the user and no bug to report, so the boundary's fault-card send drops them.
+*
+* @internal
+*/
+const HARMLESS_API_CODES = new Set([
+	RESTJSONErrorCodes.UnknownInteraction,
+	RESTJSONErrorCodes.InteractionHasAlreadyBeenAcknowledged,
+	RESTJSONErrorCodes.UnknownMessage
+]);
+
 //#endregion
 //#region src/bot/handleInteractionFault.ts
 const logger = new Logger("InteractionBoundary");
 /**
 * The interaction controller boundary. Sorts a throw from any handler-lifecycle phase into the right
-* user reply plus the right bus event, building a {@link ReplySender} lazily so it reads the live
-* acknowledgement state at catch time.
+* user reply plus the right bus event. When a handler is built its sender is passed in, so the boundary
+* sends from the current ack state. A middleware or pre-construction throw arrives with no sender, so the
+* boundary builds one from the interaction flags.
 *
 * @internal
 */
-async function handleInteractionFault(caught, interaction, core) {
+async function handleInteractionFault(caught, interaction, core, sender) {
 	if (caught instanceof Silence) {
-		if (caught.reason !== void 0) logger.debug(`Silence: ${caught.reason}`);
+		if (caught.reason !== void 0 && (core.config.errors?.logSilences ?? true)) logger.debug(`Silence: ${caught.reason}`);
 		return;
 	}
 	if (!Error.isError(caught)) throw caught;
@@ -2937,7 +2753,18 @@ async function handleInteractionFault(caught, interaction, core) {
 		user: interaction.user,
 		metadata: interaction
 	});
-	await new ReplySender(interaction).send(response, caught instanceof Notice ? caught.ephemeral : true);
+	await sendGuarded(sender ?? new ReplySender(interaction, interactionRoute(interaction)), response, caught instanceof Notice ? caught.ephemeral : true);
+}
+async function sendGuarded(sender, response, ephemeral) {
+	try {
+		await sender.send(response, { ephemeral });
+	} catch (error) {
+		if (error instanceof DiscordAPIError && HARMLESS_API_CODES.has(error.code)) {
+			logger.debug(`reply send hit harmless code ${error.code}`);
+			return;
+		}
+		logger.error("reply send failed", error);
+	}
 }
 
 //#endregion
@@ -2952,7 +2779,6 @@ var InteractionDispatcher = class {
 	core;
 	logger = new Logger("Interactions");
 	isInitialized = false;
-	name = "Interactions";
 	slashMap = /* @__PURE__ */ new Map();
 	buttonMap = /* @__PURE__ */ new Map();
 	modalMap = /* @__PURE__ */ new Map();
@@ -2966,6 +2792,8 @@ var InteractionDispatcher = class {
 	autocompleteMap = /* @__PURE__ */ new Map();
 	keysToIgnore = /* @__PURE__ */ new Set();
 	middlewares = [];
+	inFlight = /* @__PURE__ */ new Set();
+	draining = false;
 	loading = false;
 	loadedHandlers = [];
 	loadedMiddlewares = [];
@@ -3006,7 +2834,7 @@ var InteractionDispatcher = class {
 	}
 	/**
 	* Warns for each command route with no registered `@SlashRoute` handler, which would fall through to
-	* UnhandledEvent at runtime. A bot may route commands outside the registry, so this does not throw.
+	* UnhandledRepliable at runtime. A bot may route commands outside the registry, so this does not throw.
 	*
 	* @internal
 	*/
@@ -3014,7 +2842,7 @@ var InteractionDispatcher = class {
 		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.`);
 	}
 	/**
-	* Warns for each context-menu command with no matching handler, which would fall through to UnhandledEvent
+	* Warns for each context-menu command with no matching handler, which would fall through to UnhandledRepliable
 	* at runtime. Checked per kind since a user and a message command can share a name.
 	*
 	* @internal
@@ -3166,35 +2994,53 @@ var InteractionDispatcher = class {
 	}
 	attachToClient() {
 		this.core.bot.client.on(Events.InteractionCreate, (interaction) => {
+			if (this.draining) return;
 			this.core.bot.emitSafe("any:interaction", interaction);
-			this.handleInteraction(interaction).catch((err) => {
+			const run = 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);
 			});
+			this.inFlight.add(run);
+			run.finally(() => this.inFlight.delete(run));
 		});
 	}
+	stopAccepting() {
+		this.draining = true;
+	}
+	drain(timeoutMs) {
+		return settleWithin(Promise.allSettled(this.inFlight), timeoutMs);
+	}
 	async handleCustomIdInteraction(interaction, getMap, interactionType) {
 		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));
 	}
-	async processInteraction(interaction, extractKey, getHandler) {
+	async processInteraction(interaction, extractKey, getHandler, fallback = UnhandledRepliable) {
 		const key = extractKey(interaction);
+		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 UnhandledEvent.`);
-				HandlerCtor = UnhandledEvent;
+				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 runHandlerGates(HandlerCtor, interactionGateContext(interaction, this.core));
+			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);
+				}
+			}
 			await handler.execute();
 		} catch (caught) {
-			await handleInteractionFault(caught, interaction, this.core);
+			await handleInteractionFault(caught, interaction, this.core, sender);
 		}
 	}
 	async handleInteraction(interaction) {
@@ -3270,12 +3116,7 @@ var InteractionDispatcher = class {
 	}
 	async handleAutocomplete(interaction) {
 		const route = slashRouteOf(interaction);
-		if (!this.autocompleteMap.has(route)) {
-			this.logger.warn(`No autocomplete handler for ${paint.sky.bold(route)}.`);
-			await interaction.respond([]);
-			return;
-		}
-		await this.processInteraction(interaction, () => route, (key) => this.autocompleteMap.get(key));
+		await this.processInteraction(interaction, () => route, (key) => this.autocompleteMap.get(key), UnhandledAutocomplete);
 	}
 };
 
@@ -3296,23 +3137,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 extends TypedEventEmitter {
 	/** @internal */
 	logger = new Logger("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);
@@ -3320,7 +3163,7 @@ var Bot = class extends Plugin {
 	}
 	/** @internal */
 	constructor(core) {
-		super(core);
+		super();
 		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);
@@ -3331,12 +3174,24 @@ var Bot = class extends Plugin {
 			});
 		}
 		this.emojiInjector = new EmojiInjector(core);
-		core.shutdown.addTask(ShutdownPhase.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;
@@ -3352,25 +3207,18 @@ 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) {
-		await this._client.login(token);
+		this._client.once(Events.ClientReady, () => this.emit("ready"));
+		this._client.login(token);
+		await this.waitFor("ready");
 		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!"));
@@ -3378,6 +3226,12 @@ var Bot = class extends Plugin {
 	get client() {
 		return this._client;
 	}
+	/**
+	* The overloads enforce the key/args correlation at compile time only. At runtime this forwards
+	* straight to the underlying TypedEventEmitter.
+	*
+	* @internal
+	*/
 	emit(event, ...args) {
 		return super.emit(event, ...args);
 	}
@@ -3390,157 +3244,70 @@ var Bot = class extends Plugin {
 };
 __decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) }), __decorateMetadata("design:type", String)], Bot.prototype, "botToken", void 0);
 
-//#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$-]+$`);
-/**
-* Whether a string is a well-formed Discord webhook URL.
-*
-* @internal
-*/
-function isDiscordWebhookUrl(value) {
-	return URL.canParse(value) && DISCORD_WEBHOOK_REGEX.test(value);
-}
-/**
-* Serializes a value to a JSON attachment, made circular-safe first.
-*
-* @internal
-*/
-function jsonAttachment(name, description, data) {
-	const content = filterCirculars(data);
-	return new AttachmentBuilder(Buffer.from(JSON.stringify(content, void 0, 2), "utf8"), {
-		name,
-		description
-	});
-}
-/**
-* The small divider the default webhook reporters place between sections.
-*
-* @internal
-*/
-var WebhookSeparator = class extends BuilderComponent {
-	constructor() {
-		super("separator");
-		this.instance.setSpacing(SeparatorSpacingSize.Small).setDivider(true);
-	}
-};
-
 //#endregion
 //#region src/subscribers/default/HandledException.ts
-var _HandledException;
-function webhookUrlValidator$1(raw) {
-	if (raw !== null && typeof raw !== "string") throw new SeedcordError(SeedcordErrorCode.ConfigHandledExceptionWebhookInvalid);
-	const value = raw?.trim() ?? "";
-	if (value === "") throw new SeedcordError(SeedcordErrorCode.ConfigHandledExceptionWebhookMissing);
-	if (!isDiscordWebhookUrl(value)) throw new SeedcordError(SeedcordErrorCode.ConfigHandledExceptionWebhookInvalid);
-	return value;
-}
 let HandledException = class HandledException extends WebhookLog {
-	static {
-		_HandledException = this;
-	}
-	webhook = new WebhookClient({ url: _HandledException.handledExceptionWebhookUrl });
-	async execute() {
-		const { source } = this.data;
-		try {
-			await this.webhook.send({
-				flags: flagsFor(false),
-				withComponents: true,
-				username: "Handled Exception",
-				components: [new HandledExceptionContainer(this.data).component],
-				files: [jsonAttachment("source.json", "The raw source the fault came from", source.raw)]
-			});
-		} catch (error) {
-			this.logger.error("Failed to send handled exception webhook", error);
-		}
+	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)]
+		};
 	}
 };
-__decorate([Envapt("HANDLED_EXCEPTION_WEBHOOK_URL", { converter: (raw) => webhookUrlValidator$1(raw) }), __decorateMetadata("design:type", String)], HandledException, "handledExceptionWebhookUrl", void 0);
-HandledException = _HandledException = __decorate([Subscribe("handledException")], HandledException);
+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\`\`\`${causeStack(denial)}\`\`\``)).addSeparatorComponents(new WebhookSeparator().component).addTextDisplayComponents((text) => text.setContent("### Source")).addFileComponents((file) => file.setURL("attachment://source.json"));
+		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"));
 	}
 };
-/**
-* The summary block of a fault report, narrowed per source kind so an interaction fault shows its
-* command and customId while an event fault shows its event name and handler.
-*
-* @internal
-*/
 function faultSummary(denial, source) {
-	const head = `### A handled fault was reported: \`${denial.name}\`\n**Message:** ${denial.message}\n`;
+	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}\``;
 }
-/**
-* The text shown for a denial's cause in the report. Tolerates a non-serializable cause (a bigint or a
-* circular object) so building the report never throws.
-*
-* @internal
-*/
 function causeStack(denial) {
 	const { cause } = denial;
-	if (Error.isError(cause)) return cause.stack ?? cause.message;
-	if (typeof cause === "string") return cause;
+	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 denial.stack ?? "No cause recorded.";
+	return stripAnsi(denial.stack ?? "No cause recorded.");
 }
 
 //#endregion
 //#region src/subscribers/default/UnknownException.ts
-var _UnknownException;
-function webhookUrlValidator(raw) {
-	if (raw !== null && typeof raw !== "string") throw new SeedcordError(SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid);
-	const value = raw?.trim() ?? "";
-	if (value === "") throw new SeedcordError(SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing);
-	if (!isDiscordWebhookUrl(value)) throw new SeedcordError(SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid);
-	return value;
-}
 let UnknownException = class UnknownException extends WebhookLog {
-	static {
-		_UnknownException = this;
-	}
-	webhook = new WebhookClient({ url: _UnknownException.unknownExceptionWebhookUrl });
-	async execute() {
+	report() {
 		const { metadata } = this.data;
-		const metadataFile = metadata ? jsonAttachment("metadata.json", "Metadata associated with the error", metadata) : null;
-		try {
-			await this.webhook.send({
-				flags: flagsFor(false),
-				withComponents: true,
-				username: "Unknown Exception",
-				components: [new UnhandledErrorContainer(this.data).component],
-				files: metadataFile ? [metadataFile] : []
-			});
-		} catch (error) {
-			this.logger.error("Failed to send unknown exception webhook", error);
-		}
+		return {
+			username: "Unknown Exception",
+			components: [new UnhandledErrorContainer(this.data).component],
+			files: metadata ? [jsonAttachment("metadata.json", "Metadata associated with the error", metadata)] : void 0
+		};
 	}
 };
-__decorate([Envapt("UNKNOWN_EXCEPTION_WEBHOOK_URL", { converter: (raw) => webhookUrlValidator(raw) }), __decorateMetadata("design:type", String)], UnknownException, "unknownExceptionWebhookUrl", void 0);
-UnknownException = _UnknownException = __decorate([Subscribe("unknownException")], UnknownException);
+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\`\`\`${error.stack}\`\`\``));
+		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)) return;
+		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 = Number(SnowflakeUtil.deconstruct(snowflake).timestamp);
+		const interactionTs = timestampFromSnowflake(snowflake);
 		const diff = now - interactionTs;
 		const seconds = Math.floor(diff / 1e3);
 		const millis = diff % 1e3;
@@ -3555,24 +3322,19 @@ var UnhandledErrorContainer = class extends BuilderComponent {
 //#endregion
 //#region src/subscribers/Bus.ts
 /**
-* Manages application subscribers and event handling
-*
-* Provides a centralized system for registering and executing custom subscribers
-* throughout the application lifecycle. Bus subscribers are loaded from configured directories
-* and can be triggered programmatically or by framework events. Accessed via `core.bus`. Do not
-* construct it directly.
+* 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 {
+var Bus = class extends TypedEventEmitter {
 	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);
+		super();
 		this.core = core;
 		if (this.core.config.subscribers.path) {
 			if (!Envapter.isDevelopment && !Envapter.isTest) return;
@@ -3595,7 +3357,6 @@ var Bus = class extends Plugin {
 		this.isInitialized = true;
 		this.registerSubscriber(UnknownException);
 		this.registerSubscriber(HandledException);
-		Envapter.require("UNKNOWN_EXCEPTION_WEBHOOK_URL", "HANDLED_EXCEPTION_WEBHOOK_URL");
 		const subscribersDir = this.core.config.subscribers.path;
 		if (subscribersDir) {
 			this.logger.info(chalk.bold(subscribersDir));
@@ -3603,8 +3364,19 @@ var Bus = class extends Plugin {
 			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 For use in dev mode */
+	/** @internal */
 	async onHmr(event) {
 		if (this.hmrHandler) await this.hmrHandler.handle(event);
 	}
@@ -3621,6 +3393,17 @@ var Bus = class extends Plugin {
 		}, 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) {
@@ -3680,15 +3463,13 @@ var Bus = class extends Plugin {
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.0-next.2";
+const version = "0.1.0-next.4";
 
 //#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;
@@ -3698,7 +3479,6 @@ var Seedcord = class Seedcord extends Pluggable {
 	augmentTarget = "@seedcord/gateway";
 	/** @internal */
 	version = version;
-	static isInstantiated = false;
 	healthCheck;
 	hmrManager;
 	/** @see {@link CoordinatedShutdown} */
@@ -3712,15 +3492,11 @@ var Seedcord = class Seedcord extends Pluggable {
 	/** @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 shutdown = new CoordinatedShutdown();
 		const startup = new CoordinatedStartup();
 		super(shutdown, startup);
 		this.config = config;
@@ -3733,15 +3509,22 @@ var Seedcord = class Seedcord extends Pluggable {
 		this.bus = new Bus(this);
 		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() {
@@ -3751,24 +3534,31 @@ var Seedcord = class Seedcord extends Pluggable {
 			await this.bus.init();
 			this.bus.logger.utils.initialization("Subscribers", "end");
 		});
-		this.startup.addTask(StartupPhase.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.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() {
@@ -3782,5 +3572,5 @@ var Seedcord = class Seedcord extends Pluggable {
 };
 
 //#endregion
-export { ArraySource, AutocompleteHandler, AutocompleteRoute, ButtonHandler, ButtonRoute, CommandMentions, ContextMenuHandler, ContextMenuRoute, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, IgnoreBots, InteractionHandler, InteractionMiddleware, Middleware, MiddlewareType, ModalHandler, ModalRoute, Nsfw, Paginator, Pluggable, Plugin, RegisterCommand, RegisterEvent, ReplySender, RequireBotPermissions, RequirePermissions, RequireRole, Seedcord, SelectMenuHandler, SelectMenuKind, SelectMenuRoute, SlashHandler, SlashRoute, Subscribe, Subscriber, WebhookLog, 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, RegisterEvent, RepliableHandler, Seedcord, SelectMenuHandler, SlashHandler, Subscribe, Subscriber, WebhookLog, WebhookUrl, checkBotPermissions, checkPermissions, fetchGuildMember, fetchManyGuildMembers, fetchManyUsers, fetchRole, fetchText, fetchUser, getBotRole, getConfirmation, hasPermsToAssign, updateMemberRoles, version };
 //# sourceMappingURL=index.mjs.map