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

package/dist/index.mjs

@@ -1,20 +1,24 @@
 import "reflect-metadata";
-import { BuilderComponent, CustomId, Fault, Notice, RegisterCommand, RowComponent, Silence, defineGate, paginate } from "@seedcord/core";
-import { CommandMetadataKey, ComponentDefsKey, EventMetadataKey, GateNotice, GatedMetadataKey, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NotInGuild, NoticeCard, PAGE_MAX, SubscribeMetadataKey, decodeFor, pageCursor, pickNotice, prefixOf, runHandlerGates, setBotColor } from "@seedcord/core/internal";
+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 { SeedcordErrorCode } from "@seedcord/errors";
 import { SeedcordError, SeedcordRangeError, SeedcordTypeError, validateDiscordToken } from "@seedcord/errors/internal";
-import { filterCirculars, formatFilePath, hasKeys, prettify, traverseDirectory } from "@seedcord/utils";
-import { CoordinatedShutdown, CoordinatedStartup, HealthCheck, Logger, ShutdownPhase, StartupPhase, StrictEventEmitter } from "@seedcord/services";
-import chalk from "chalk";
+import { filterCirculars, formatFilePath, hasKeys, prettify } from "@seedcord/utils";
+import { Logger, LoggerChannelRegistry, paint } from "@seedcord/logger";
 import { ActionRowBuilder, ButtonBuilder, ContextMenuCommandBuilder, SlashCommandBuilder, TextDisplayBuilder } from "@discordjs/builders";
 import { buildSlashRoute, routeLeavesOf } from "@seedcord/utils/internal";
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { TypedEventEmitter } from "@seedcord/event-emitter";
 import { MemoryRateLimiter } from "@seedcord/rate-limiter";
-import { SeedcordBrand, wrapHot } from "@seedcord/types/internal";
-import { Envapt, Envapter } from "envapt";
+import { CoordinatedShutdown, CoordinatedStartup, HealthCheck, ShutdownPhase, StartupPhase } from "@seedcord/services";
+import { SeedcordBrand } from "@seedcord/types/internal";
+import { Envapter } from "envapt";
+import chalk from "chalk";
+import { Envapt } from "envapt/legacy";
+import { resolve } from "node:path";
+import { HmrModuleHandler } from "@seedcord/core/hmr";
+import { traverseDirectory } from "@seedcord/utils/node";
 import * as crypto from "node:crypto";
 
 export * from "@seedcord/core"
@@ -23,10 +27,18 @@ export * from "@seedcord/errors"
 
 export * from "@seedcord/utils"
 
-export * from "@seedcord/services"
+export * from "@seedcord/logger"
+
+export * from "@seedcord/event-emitter"
 
 export * from "@seedcord/rate-limiter"
 
+export * from "@seedcord/services"
+
+//#region src/logger-bootstrap.ts
+installNodeDefaults();
+
+//#endregion
 //#region src/bot/decorators/Events.ts
 /**
 * Registers an event handler class with one or more Discord.js events.
@@ -670,7 +682,7 @@ var EmojiInjector = class {
 	async init() {
 		this.clearEmojis();
 		if (!this.core.config.bot.emojis || Object.keys(this.core.config.bot.emojis).length === 0) {
-			this.logger.debug(chalk.bold.yellow("No emojis configured, skipping emoji injection."));
+			this.logger.debug("No emojis configured, skipping emoji injection.");
 			return;
 		}
 		const configEmojis = this.core.config.bot.emojis;
@@ -1227,16 +1239,6 @@ async function getConfirmation(interaction, prompt, options) {
 	return confirmed;
 }
 
-//#endregion
-//#region src/hmr/devChannel.ts
-let channel;
-function setDevChannel(next) {
-	channel = next;
-}
-function getDevChannel() {
-	return channel;
-}
-
 //#endregion
 //#region src/interfaces/Plugin.ts
 /**
@@ -1245,7 +1247,7 @@ function getDevChannel() {
 * 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 StrictEventEmitter {
+var Plugin = class extends TypedEventEmitter {
 	pluggable;
 	name = this.constructor.name;
 	constructor(pluggable) {
@@ -1267,16 +1269,12 @@ var Plugin = class extends StrictEventEmitter {
 		getDevChannel()?.send("seedcord:register-critical-files", { patterns });
 	}
 	/** @internal */
-	setMaxListeners(n) {
-		return super.setMaxListeners(n);
-	}
-	/** @internal */
 	removeListener(event, listener) {
 		return super.removeListener(event, listener);
 	}
 	/** @internal */
-	removeAllListeners(eventName) {
-		return super.removeAllListeners(eventName);
+	removeAllListeners(event) {
+		return super.removeAllListeners(event);
 	}
 };
 /**
@@ -1285,7 +1283,7 @@ var Plugin = class extends StrictEventEmitter {
 * 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 StrictEventEmitter {
+var Pluggable = class Pluggable extends TypedEventEmitter {
 	isInitialized = false;
 	shutdown;
 	startup;
@@ -1338,16 +1336,12 @@ var Pluggable = class Pluggable extends StrictEventEmitter {
 		return Object.assign(this, entry);
 	}
 	/** @internal */
-	setMaxListeners(n) {
-		return super.setMaxListeners(n);
-	}
-	/** @internal */
 	removeListener(event, listener) {
 		return super.removeListener(event, listener);
 	}
 	/** @internal */
-	removeAllListeners(eventName) {
-		return super.removeAllListeners(eventName);
+	removeAllListeners(event) {
+		return super.removeAllListeners(event);
 	}
 };
 
@@ -1360,10 +1354,12 @@ var BaseHandler = class {
 	core;
 	event;
 	logger;
-	constructor(event, core) {
+	dispatch;
+	constructor(event, core, dispatch) {
 		this.core = core;
 		this.event = event;
 		this.logger = new Logger(this.constructor.name);
+		this.dispatch = dispatch;
 	}
 	/** @internal */
 	getEvent() {
@@ -1399,8 +1395,8 @@ var InteractionMiddleware = class extends BaseHandler {
 * @typeParam Repliable - The interaction type this handler processes
 */
 var InteractionHandler = class extends BaseHandler {
-	constructor(event, core) {
-		super(event, core);
+	constructor(event, core, dispatch) {
+		super(event, core, dispatch);
 	}
 };
 
@@ -1545,8 +1541,8 @@ var ContextMenuHandler = class extends InteractionHandler {
 * ```
 */
 var AutocompleteHandler = class extends BaseHandler {
-	constructor(event, core) {
-		super(event, core);
+	constructor(event, core, dispatch) {
+		super(event, core, dispatch);
 	}
 	/**
 	* The focused option for this interaction. `value` is always the raw partial string the user is typing,
@@ -2163,171 +2159,6 @@ var WebhookLog = class extends Subscriber {
 	}
 };
 
-//#endregion
-//#region src/hmr/HmrModuleHandler.ts
-/**
-* Reloads THandler and optional TMiddleware modules on HMR updates.
-*
-* You can either implement a custom `onHmr()` method in your class by extending `HmrAware`, or if it's a plugin, override the existing `onHmr()` with fully custom logic. Or, use this class's `handle()` method inside your `onHmr()` to get standard HMR handling for your modules based on the provided options you give to the constructor.
-*
-* This is only useful during development.
-*/
-var HmrModuleHandler = class {
-	store;
-	options;
-	constructor(options) {
-		this.options = {
-			...options,
-			logger: options.logger.inChannel("hmr")
-		};
-		this.store = {
-			fileToHandlers: /* @__PURE__ */ new Map(),
-			fileToMiddlewares: /* @__PURE__ */ new Map(),
-			handlerArtifacts: /* @__PURE__ */ new Map()
-		};
-	}
-	/**
-	* Handles an HMR update event by reloading affected modules based on the event details and config. It receives an {@link HmrUpdateEvent}, then checks the type of update.
-	*
-	* - If it's a deletion, it unloads the module.
-	* - If it's an update/creation, it checks if the file is tracked, unloads it if so, then reloads the file if it is in the handlers or middlewares directory and is a valid handler/middleware.
-	*/
-	async handle(event) {
-		const { file, affectedModules, type } = event;
-		const { logger, handlersDir, middlewaresDir } = this.options;
-		if (type === "delete" || type === "deleteDir") {
-			this.unload(file);
-			return;
-		}
-		if (type === "update" && !existsSync(file)) {
-			if (this.isTracked(file)) {
-				logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);
-				this.unload(file);
-			}
-			return;
-		}
-		const rollbackEnabled = event.rollback ?? true;
-		const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];
-		const absHandlersDir = resolve(process.cwd(), handlersDir);
-		const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;
-		for (const fileToReload of filesToReload) {
-			const isHandler = fileToReload.startsWith(absHandlersDir);
-			const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir) : false;
-			if (!isHandler && !isMiddleware) continue;
-			await this.reloadWithRollback(fileToReload, rollbackEnabled);
-		}
-	}
-	async reloadWithRollback(file, rollbackEnabled) {
-		const { logger } = this.options;
-		const snapshot = this.snapshotUnits(file);
-		this.unload(file);
-		if (await this.reloadFile(file)) return;
-		this.unload(file);
-		if (!rollbackEnabled) return;
-		this.restoreUnits(file, snapshot);
-		logger.warn(`${chalk.yellow.bold("Rolled back")} ${chalk.gray(formatFilePath(file))} to the last-good version`);
-	}
-	/**
-	* Tracks a handler module as being loaded from a specific file.
-	* @param file - The file path the handler was loaded from.
-	* @param handler - The handler module instance.
-	*/
-	trackHandler(file, handler) {
-		let set = this.store.fileToHandlers.get(file);
-		if (!set) {
-			set = /* @__PURE__ */ new Set();
-			this.store.fileToHandlers.set(file, set);
-		}
-		set.add(handler);
-		if (this.options.getArtifacts) {
-			const artifacts = this.options.getArtifacts(handler);
-			this.store.handlerArtifacts.set(handler, artifacts);
-		}
-	}
-	/**
-	* Tracks a middleware module as being loaded from a specific file.
-	* @param file - The file path the middleware was loaded from.
-	* @param middleware - The middleware module instance.
-	*/
-	trackMiddleware(file, middleware) {
-		let set = this.store.fileToMiddlewares.get(file);
-		if (!set) {
-			set = /* @__PURE__ */ new Set();
-			this.store.fileToMiddlewares.set(file, set);
-		}
-		set.add(middleware);
-	}
-	isTracked(file) {
-		return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);
-	}
-	unload(file) {
-		const { logger } = this.options;
-		const handlers = this.store.fileToHandlers.get(file);
-		if (handlers) {
-			for (const handler of handlers) {
-				const artifacts = this.store.handlerArtifacts.get(handler);
-				this.options.unregisterHandler(handler, artifacts);
-				this.store.handlerArtifacts.delete(handler);
-				const name = handler.name ?? "Handler";
-				logger.info(`${chalk.red.bold("Unloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
-			}
-			this.store.fileToHandlers.delete(file);
-		}
-		const middlewares = this.store.fileToMiddlewares.get(file);
-		if (middlewares) {
-			for (const middleware of middlewares) {
-				this.options.unregisterMiddleware?.(middleware);
-				const name = middleware.name ?? "Middleware";
-				logger.info(`${chalk.red.bold("Unloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
-			}
-			this.store.fileToMiddlewares.delete(file);
-		}
-	}
-	async reloadFile(file) {
-		const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;
-		if (!existsSync(file)) {
-			logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);
-			return false;
-		}
-		try {
-			let fileUrl = pathToFileURL(file).href;
-			if (process.env.VITEST === "true") fileUrl += `?update=${Date.now()}`;
-			const imported = await import(fileUrl);
-			for (const val of Object.values(imported)) if (isHandler(val)) {
-				registerHandler(val, file);
-				this.trackHandler(file, val);
-				const name = val.name ?? "Handler";
-				logger.info(`${chalk.blue.bold("Reloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
-			} else if (isMiddleware && registerMiddleware && isMiddleware(val)) {
-				registerMiddleware(val, file);
-				this.trackMiddleware(file, val);
-				const name = val.name ?? "Middleware";
-				logger.info(`${chalk.blue.bold("Reloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
-			}
-			return true;
-		} catch (error) {
-			logger.error(`Failed to reload file: ${file}`, error);
-			return false;
-		}
-	}
-	snapshotUnits(file) {
-		return {
-			handlers: [...this.store.fileToHandlers.get(file) ?? []],
-			middlewares: [...this.store.fileToMiddlewares.get(file) ?? []]
-		};
-	}
-	restoreUnits(file, snapshot) {
-		for (const handler of snapshot.handlers) {
-			this.options.registerHandler(handler, file);
-			this.trackHandler(file, handler);
-		}
-		if (this.options.registerMiddleware) for (const middleware of snapshot.middlewares) {
-			this.options.registerMiddleware(middleware, file);
-			this.trackMiddleware(file, middleware);
-		}
-	}
-};
-
 //#endregion
 //#region src/bot/utilities/miscellaneous/contextMenuLeaves.ts
 /**
@@ -2388,6 +2219,8 @@ var CommandRegistry = class {
 	globalCommands = [];
 	guildCommands = new Collection();
 	ctorToCommand = /* @__PURE__ */ new Map();
+	loading = false;
+	loadedCommands = [];
 	hmrHandler;
 	pendingEvents = /* @__PURE__ */ new Map();
 	constructor(core, onDeployed) {
@@ -2414,16 +2247,33 @@ var CommandRegistry = class {
 		this.isInitialised = true;
 		const commandsDir = this.core.config.bot.commands.path;
 		if (!commandsDir) return;
-		this.logger.info(chalk.bold(commandsDir));
-		await this.loadCommands(commandsDir);
-		this.logger.utils.summary("Loaded commands", {
-			global: this.globalCommands.length,
-			"guild groups": this.guildCommands.size
-		});
+		this.loading = true;
+		this.loadedCommands.length = 0;
+		try {
+			await this.loadCommands(commandsDir);
+		} finally {
+			this.loading = false;
+		}
+		this.reportLoad();
 		getDevChannel()?.on("seedcord:refresh-commands", (data) => {
 			this.refresh(data.shouldRefresh);
 		});
 	}
+	reportLoad() {
+		const { utils } = this.logger;
+		utils.summary("Loaded commands", {
+			global: this.globalCommands.length,
+			"guild groups": this.guildCommands.size
+		});
+		let slash = 0;
+		let menu = 0;
+		for (const command of this.loadedCommands) if (command.kind === "slash command") slash++;
+		else menu++;
+		utils.block("Loaded commands", [...utils.entries(this.loadedCommands), ...utils.counts({
+			"slash commands": slash,
+			"context menus": menu
+		})]);
+	}
 	/** @internal */
 	async refresh(shouldRefresh = true) {
 		if (!shouldRefresh) {
@@ -2461,25 +2311,27 @@ var CommandRegistry = class {
 		const meta = Reflect.getMetadata(CommandMetadataKey, ctor);
 		if (!meta) return;
 		const comp = new ctor().component;
-		const commandType = comp instanceof SlashCommandBuilder ? "slash command" : "context menu command";
-		if (meta.scope === "global") {
-			this.globalCommands.push(comp);
-			this.logger.utils.registration(ctor.name, rel);
-			this.logger.utils.item(`Global ${commandType}: ${chalk.bold.cyan(comp.name)}`);
-		} else {
-			for (const g of meta.guilds) {
-				const arr = this.guildCommands.get(g) ?? [];
-				arr.push(comp);
-				this.guildCommands.set(g, arr);
-			}
-			this.logger.utils.registration(ctor.name, rel);
-			this.logger.utils.item(`Guild ${commandType}: ${chalk.bold.cyan(comp.name)} for ${chalk.magenta.bold(meta.guilds.length)} guild(s)`);
+		const kind = comp instanceof SlashCommandBuilder ? "slash command" : "context menu";
+		if (meta.scope === "global") this.globalCommands.push(comp);
+		else for (const g of meta.guilds) {
+			const arr = this.guildCommands.get(g) ?? [];
+			arr.push(comp);
+			this.guildCommands.set(g, arr);
 		}
 		this.ctorToCommand.set(ctor, {
 			name: comp.name,
 			scope: meta.scope,
 			...meta.scope === "guild" && { guilds: meta.guilds }
 		});
+		if (this.loading) {
+			this.loadedCommands.push({
+				name: comp.name,
+				from: formatFilePath(rel),
+				kind
+			});
+			return;
+		}
+		this.logger.utils.registration(comp.name, rel, `${meta.scope} ${kind}`);
 	}
 	unregisterCommand(ctor, artifacts) {
 		const info = artifacts ?? this.ctorToCommand.get(ctor);
@@ -2506,8 +2358,7 @@ var CommandRegistry = class {
 			const deployed = await this.core.bot.client.application?.commands.set(this.globalCommands);
 			if (deployed) result.global = deployed;
 			const tag = this.globalCommands.length === 1 ? "command" : "commands";
-			this.logger.utils.summary("Configured global", { [tag]: this.globalCommands.length });
-			this.logger.utils.item(`${this.globalCommands.map((command) => chalk.bold.cyan(command.name)).join(", ")}`);
+			this.logger.utils.block(`Deployed ${this.globalCommands.length} global ${tag}`, this.logger.utils.wrap(this.globalCommands.map((command) => command.name)), "info");
 		}
 		for (const [guildId, commands] of this.guildCommands.entries()) {
 			const guild = this.core.bot.client.guilds.cache.get(guildId);
@@ -2518,8 +2369,7 @@ var CommandRegistry = class {
 			const deployed = await guild.commands.set(commands);
 			result.guilds.set(guildId, deployed);
 			const tag = commands.length === 1 ? "command" : "commands";
-			this.logger.utils.summary(`Configured commands for ${chalk.bold.yellow(guild.name)}`, { [tag]: commands.length });
-			this.logger.utils.item(`${commands.map((command) => chalk.bold.cyan(command.name)).join(", ")}`);
+			this.logger.utils.block(`Deployed ${commands.length} ${tag} to ${paint.amber.bold(guild.name)}`, this.logger.utils.wrap(commands.map((command) => command.name)), "info");
 		}
 		this.onDeployed?.(result);
 		return result;
@@ -2582,7 +2432,8 @@ function interactionGateContext(interaction, core) {
 		guildId: interaction.guildId,
 		channelId: interaction.channelId,
 		memberRoleIds,
-		memberPermissions: interaction.memberPermissions?.bitfield ?? null
+		memberPermissions: interaction.memberPermissions?.bitfield ?? null,
+		routeId: null
 	};
 }
 function eventGateContext(eventName, args, core) {
@@ -2599,7 +2450,8 @@ function eventGateContext(eventName, args, core) {
 		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
+		memberPermissions: actor.member?.permissions.bitfield ?? null,
+		routeId: null
 	};
 }
 
@@ -2829,6 +2681,9 @@ var EventDispatcher = class {
 	middlewares = [];
 	executedOnceHandlers = /* @__PURE__ */ new Set();
 	attachedEvents = /* @__PURE__ */ new Set();
+	loading = false;
+	loadedHandlers = [];
+	loadedMiddlewares = [];
 	hmrHandler;
 	constructor(core) {
 		this.core = core;
@@ -2858,20 +2713,29 @@ var EventDispatcher = class {
 		this.isInitialized = true;
 		const handlersDir = this.core.config.bot.events.path;
 		if (!handlersDir) return;
-		this.logger.info(chalk.bold(handlersDir));
 		const middlewareDir = hasKeys(this.core.config.bot.events, ["middlewares"]) ? this.core.config.bot.events.middlewares : void 0;
-		if (middlewareDir) {
-			this.logger.info(`${chalk.bold(middlewareDir)} ${chalk.gray("(middlewares)")}`);
-			await this.loadMiddlewares(middlewareDir);
+		this.loading = true;
+		this.loadedHandlers.length = 0;
+		this.loadedMiddlewares.length = 0;
+		try {
+			if (middlewareDir) await this.loadMiddlewares(middlewareDir);
+			await this.loadHandlers(handlersDir);
+		} finally {
+			this.loading = false;
 		}
-		await this.loadHandlers(handlersDir);
 		this.attachToClient();
-		this.logger.info(`${chalk.bold.green("Loaded event handlers:")}`);
-		const eventList = [`${chalk.magenta.bold(this.middlewares.length)} middlewares`];
-		this.eventMap.forEach((handlers, eventName) => {
-			eventList.push(`${chalk.magenta.bold(handlers.length)} ${eventName}`);
+		this.reportLoad();
+	}
+	reportLoad() {
+		const { utils } = this.logger;
+		utils.summary("Loaded", {
+			"event handlers": this.loadedHandlers.length,
+			middlewares: this.loadedMiddlewares.length
 		});
-		this.logger.utils.list(eventList);
+		if (this.loadedMiddlewares.length > 0) utils.block("Loaded event middlewares", utils.entries(this.loadedMiddlewares));
+		const perEvent = {};
+		for (const [event, handlers] of this.eventMap) perEvent[event] = handlers.length;
+		utils.block("Loaded event handlers", [...utils.entries(this.loadedHandlers), ...utils.counts(perEvent)]);
 	}
 	async loadHandlers(dir) {
 		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
@@ -2921,7 +2785,14 @@ var EventDispatcher = class {
 			...metadata.events && { events: metadata.events }
 		});
 		this.middlewares.sort((a, b) => a.priority - b.priority);
-		this.logger.utils.registration(`${middlewareCtor.name} ${chalk.gray(`(${metadata.priority})`)}`, relativePath, "event middleware");
+		if (this.loading) {
+			this.loadedMiddlewares.push({
+				name: `${middlewareCtor.name} (${metadata.priority})`,
+				from: formatFilePath(relativePath)
+			});
+			return;
+		}
+		this.logger.utils.registration(`${middlewareCtor.name} ${paint.mute(`(${metadata.priority})`)}`, relativePath, "event middleware");
 	}
 	async runMiddlewares(eventName, args) {
 		for (const { ctor, events } of this.middlewares) {
@@ -2962,7 +2833,12 @@ var EventDispatcher = class {
 			const names = areRoutes(raw) ? raw : typeof raw === "string" ? [raw] : [];
 			for (const name of names) register(name, "on");
 		}
-		this.logger.utils.registration(handlerClass.name, relativePath);
+		const from = formatFilePath(relativePath);
+		if (this.loading) this.loadedHandlers.push({
+			name: handlerClass.name,
+			from
+		});
+		else this.logger.utils.registration(handlerClass.name, from);
 	}
 	attachToClient() {
 		for (const [eventName] of this.eventMap) this.attachListener(eventName);
@@ -2971,12 +2847,12 @@ var EventDispatcher = class {
 		if (this.attachedEvents.has(eventName)) return;
 		this.attachedEvents.add(eventName);
 		const handlerEntries = this.eventMap.get(eventName);
-		this.logger.debug(`Attaching ${chalk.bold.green(eventName)} to the client with ${chalk.gray(handlerEntries?.length ?? 0)} handler(s)`);
+		this.logger.debug(`Attaching ${paint.mint.bold(eventName)} to the client with ${paint.mute(handlerEntries?.length ?? 0)} handler(s)`);
 		this.core.bot.client.on(eventName, (...args) => {
-			this.core.bot.emit("any:event", eventName, ...args);
+			this.core.bot.emitSafe("any:event", eventName, ...args);
 			(async () => {
 				await this.processEvent(eventName, args).catch((err) => {
-					this.logger.error(`[${chalk.bold.red("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
+					this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
 					this.core.bot.emit("error:unhandled:event", err);
 				});
 			})();
@@ -2998,7 +2874,7 @@ var EventDispatcher = class {
 	}
 	async processHandler(eventName, ctor, args) {
 		try {
-			this.logger.debug(`Processing ${chalk.bold.green(eventName)} with ${chalk.gray(ctor.name)}`);
+			this.logger.debug(`Processing ${paint.mint.bold(eventName)} with ${paint.mute(ctor.name)}`);
 			const handler = new ctor(args, this.core, eventName);
 			await runHandlerGates(ctor, eventGateContext(eventName, args, this.core));
 			await handler.execute();
@@ -3090,6 +2966,9 @@ var InteractionDispatcher = class {
 	autocompleteMap = /* @__PURE__ */ new Map();
 	keysToIgnore = /* @__PURE__ */ new Set();
 	middlewares = [];
+	loading = false;
+	loadedHandlers = [];
+	loadedMiddlewares = [];
 	hmrHandler;
 	routeTypes = [
 		[InteractionRoutes.Slash, this.slashMap],
@@ -3132,7 +3011,7 @@ var InteractionDispatcher = class {
 	* @internal
 	*/
 	warnUnhandledRoutes(commandLeaves) {
-		for (const route of commandLeaves) if (!this.slashMap.has(route)) this.logger.warn(`Slash route ${chalk.bold.cyan(route)} has no registered ${chalk.bold("@SlashRoute")} handler.`);
+		for (const route of commandLeaves) if (!this.slashMap.has(route)) this.logger.warn(`Slash route ${paint.sky.bold(route)} has no registered ${chalk.bold("@SlashRoute")} handler.`);
 	}
 	/**
 	* Warns for each context-menu command with no matching handler, which would fall through to UnhandledEvent
@@ -3141,8 +3020,8 @@ var InteractionDispatcher = class {
 	* @internal
 	*/
 	warnUnhandledContextMenuRoutes(leaves) {
-		for (const name of leaves.user) if (!this.userContextMenuMap.has(name)) this.logger.warn(`User context menu ${chalk.bold.cyan(name)} has no registered ${chalk.bold("@ContextMenuRoute")} handler.`);
-		for (const name of leaves.message) if (!this.messageContextMenuMap.has(name)) this.logger.warn(`Message context menu ${chalk.bold.cyan(name)} has no registered ${chalk.bold("@ContextMenuRoute")} handler.`);
+		for (const name of leaves.user) if (!this.userContextMenuMap.has(name)) this.logger.warn(`User context menu ${paint.sky.bold(name)} has no registered ${chalk.bold("@ContextMenuRoute")} handler.`);
+		for (const name of leaves.message) if (!this.messageContextMenuMap.has(name)) this.logger.warn(`Message context menu ${paint.sky.bold(name)} has no registered ${chalk.bold("@ContextMenuRoute")} handler.`);
 	}
 	getArtifacts(handlerClass) {
 		const artifacts = [];
@@ -3160,29 +3039,39 @@ var InteractionDispatcher = class {
 		this.isInitialized = true;
 		const handlersDir = this.core.config.bot.interactions.path;
 		if (!handlersDir) return;
-		this.logger.info(chalk.bold(handlersDir));
 		const middlewareDir = hasKeys(this.core.config.bot.interactions, ["middlewares"]) ? this.core.config.bot.interactions.middlewares : void 0;
-		if (middlewareDir) {
-			this.logger.info(`${chalk.bold(middlewareDir)} ${chalk.gray("(middlewares)")}`);
-			await this.loadMiddlewares(middlewareDir);
+		this.loading = true;
+		this.loadedHandlers.length = 0;
+		this.loadedMiddlewares.length = 0;
+		try {
+			if (middlewareDir) await this.loadMiddlewares(middlewareDir);
+			await this.loadHandlers(handlersDir);
+		} finally {
+			this.loading = false;
 		}
-		await this.loadHandlers(handlersDir);
 		this.attachToClient();
-		this.logger.info(`${chalk.bold.green("Loaded interaction handlers:")}`);
-		this.logger.utils.list([
-			`${chalk.magenta.bold(this.middlewares.length)} middlewares`,
-			`${chalk.magenta.bold(this.slashMap.size)} slash commands`,
-			`${chalk.magenta.bold(this.buttonMap.size)} buttons`,
-			`${chalk.magenta.bold(this.modalMap.size)} modals`,
-			`${chalk.magenta.bold(this.stringSelectMap.size)} string selects`,
-			`${chalk.magenta.bold(this.userSelectMap.size)} user selects`,
-			`${chalk.magenta.bold(this.roleSelectMap.size)} role selects`,
-			`${chalk.magenta.bold(this.channelSelectMap.size)} channel selects`,
-			`${chalk.magenta.bold(this.mentionableSelectMap.size)} mentionable selects`,
-			`${chalk.magenta.bold(this.messageContextMenuMap.size)} message context menus`,
-			`${chalk.magenta.bold(this.userContextMenuMap.size)} user context menus`,
-			`${chalk.magenta.bold(this.autocompleteMap.size)} autocomplete`
-		]);
+		this.reportLoad();
+	}
+	reportLoad() {
+		const { utils } = this.logger;
+		utils.summary("Loaded", {
+			"interaction handlers": this.loadedHandlers.length,
+			middlewares: this.loadedMiddlewares.length
+		});
+		if (this.loadedMiddlewares.length > 0) utils.block("Loaded middlewares", utils.entries(this.loadedMiddlewares));
+		utils.block("Loaded interaction handlers", [...utils.entries(this.loadedHandlers), ...utils.counts({
+			slash: this.slashMap.size,
+			buttons: this.buttonMap.size,
+			modals: this.modalMap.size,
+			"string selects": this.stringSelectMap.size,
+			"user selects": this.userSelectMap.size,
+			"role selects": this.roleSelectMap.size,
+			"channel selects": this.channelSelectMap.size,
+			"mentionable selects": this.mentionableSelectMap.size,
+			"message menus": this.messageContextMenuMap.size,
+			"user menus": this.userContextMenuMap.size,
+			autocomplete: this.autocompleteMap.size
+		})]);
 	}
 	async loadHandlers(dir) {
 		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
@@ -3212,7 +3101,14 @@ var InteractionDispatcher = class {
 			priority: metadata.priority
 		});
 		this.middlewares.sort((a, b) => a.priority - b.priority);
-		this.logger.utils.registration(`${middlewareCtor.name} ${chalk.gray(`(${metadata.priority})`)}`, relativePath, "middleware");
+		if (this.loading) {
+			this.loadedMiddlewares.push({
+				name: `${middlewareCtor.name} (${metadata.priority})`,
+				from: formatFilePath(relativePath)
+			});
+			return;
+		}
+		this.logger.utils.registration(`${middlewareCtor.name} ${paint.mute(`(${metadata.priority})`)}`, relativePath, "middleware");
 	}
 	isHandlerClass(obj) {
 		if (typeof obj !== "function") return false;
@@ -3236,9 +3132,15 @@ var InteractionDispatcher = class {
 				]);
 				writes.push([map, route]);
 			}
-			this.logger.utils.registration(handlerClass.name, formatFilePath(relativePath));
 		}
+		if (writes.length === 0) return;
 		for (const [map, route] of writes) map.set(route, handlerClass);
+		const from = formatFilePath(relativePath);
+		if (this.loading) this.loadedHandlers.push({
+			name: handlerClass.name,
+			from
+		});
+		else this.logger.utils.registration(handlerClass.name, from);
 	}
 	/** @internal For use in dev mode */
 	async onHmr(event) {
@@ -3264,9 +3166,9 @@ var InteractionDispatcher = class {
 	}
 	attachToClient() {
 		this.core.bot.client.on(Events.InteractionCreate, (interaction) => {
-			this.core.bot.emit("any:interaction", interaction);
+			this.core.bot.emitSafe("any:interaction", interaction);
 			this.handleInteraction(interaction).catch((err) => {
-				this.logger.error(`[${chalk.bold.red("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
+				this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
 				this.core.bot.emit("error:unhandled:interaction", err);
 			});
 		});
@@ -3283,11 +3185,12 @@ var InteractionDispatcher = class {
 			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 ${chalk.bold.cyan(key)}. Falling back to UnhandledEvent.`);
+				this.logger.warn(`No handler found for key ${paint.sky.bold(key)}. Falling back to UnhandledEvent.`);
 				HandlerCtor = UnhandledEvent;
 			}
-			this.logger.debug(`Processing ${chalk.bold.green(key)} with ${chalk.gray(HandlerCtor.name)}`);
-			const handler = new HandlerCtor(interaction, this.core);
+			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));
 			await handler.execute();
 		} catch (caught) {
@@ -3368,7 +3271,7 @@ var InteractionDispatcher = class {
 	async handleAutocomplete(interaction) {
 		const route = slashRouteOf(interaction);
 		if (!this.autocompleteMap.has(route)) {
-			this.logger.warn(`No autocomplete handler for ${chalk.bold.cyan(route)}.`);
+			this.logger.warn(`No autocomplete handler for ${paint.sky.bold(route)}.`);
 			await interaction.respond([]);
 			return;
 		}
@@ -3478,48 +3381,14 @@ var Bot = class extends Plugin {
 	emit(event, ...args) {
 		return super.emit(event, ...args);
 	}
-};
-__decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) }), __decorateMetadata("design:type", String)], Bot.prototype, "botToken", void 0);
-
-//#endregion
-//#region src/hmr/HmrManager.ts
-var HmrManager = class {
-	logger = new Logger("HMR", { channel: "hmr" });
-	listeners = /* @__PURE__ */ new Set();
-	constructor() {}
-	/** @internal */
-	init() {
-		if (!import.meta.hot) return;
-		setDevChannel(wrapHot(import.meta.hot));
-		if (Envapter.isDevelopment || Envapter.isTest) {
-			this.logger.info("Enabled");
-			getDevChannel()?.on("seedcord:hmr", (payload) => {
-				const affected = payload.affectedModules?.length ?? 0;
-				this.logger.info(`${chalk.bold("1")} module changed, ${chalk.bold(affected)} affected modules`);
-				if (payload.affectedModules) this.logger.utils.list(payload.affectedModules.map((mod) => formatFilePath(mod)), "Affected modules: ");
-				this.handleUpdate(payload);
-			});
-		}
-	}
-	/** @internal */
-	register(listener) {
-		this.listeners.add(listener);
-	}
-	/** @internal */
-	unregister(listener) {
-		this.listeners.delete(listener);
+	emitSafe(event, ...args) {
+		return super.emitSafe(event, ...args);
 	}
-	async handleUpdate(event) {
-		const promises = [...this.listeners].map(async (listener) => {
-			try {
-				await listener.onHmr(event);
-			} catch (error) {
-				this.logger.error(`Error handling HMR update in ${chalk.bold(listener.name)}: `, error);
-			}
-		});
-		await Promise.all(promises);
+	onListenerError(error, event) {
+		this.logger.error(`listener for ${String(event)} threw`, error);
 	}
 };
+__decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) }), __decorateMetadata("design:type", String)], Bot.prototype, "botToken", void 0);
 
 //#endregion
 //#region src/subscribers/bases/webhookHelpers.ts
@@ -3811,7 +3680,7 @@ var Bus = class extends Plugin {
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.0-next.0";
+const version = "0.1.0-next.2";
 
 //#endregion
 //#region src/Seedcord.ts
@@ -3830,6 +3699,8 @@ var Seedcord = class Seedcord extends Pluggable {
 	/** @internal */
 	version = version;
 	static isInstantiated = false;
+	healthCheck;
+	hmrManager;
 	/** @see {@link CoordinatedShutdown} */
 	shutdown;
 	/** @see {@link CoordinatedStartup} */
@@ -3840,10 +3711,6 @@ var Seedcord = class Seedcord extends Pluggable {
 	bot;
 	/** @see {@link IRateLimiter} */
 	rateLimiter;
-	/** @see {@link HealthCheck} */
-	healthCheck;
-	/** @see {@link HmrManager} */
-	hmrManager;
 	/**
 	* Creates a new Seedcord instance
 	*
@@ -3857,6 +3724,7 @@ var Seedcord = class Seedcord extends Pluggable {
 		const startup = new CoordinatedStartup();
 		super(shutdown, startup);
 		this.config = config;
+		installNodeDefaults(config.logger);
 		setBotColor(config.botColor);
 		this.shutdown = shutdown;
 		this.startup = startup;
@@ -3864,18 +3732,18 @@ var Seedcord = class Seedcord extends Pluggable {
 		this.hmrManager.init();
 		this.bus = new Bus(this);
 		this.bot = new Bot(this);
-		this.rateLimiter = new MemoryRateLimiter();
+		this.rateLimiter = config.store ?? new MemoryRateLimiter();
 		this.healthCheck = new HealthCheck(this.shutdown, config.healthCheck);
 		this.registerStartupTasks();
 	}
-	/** @internal */
+	/** The bot's discord username, populated after login. */
+	get username() {
+		return this.bot.client.user?.username;
+	}
 	static reset() {
 		Seedcord.isInstantiated = false;
+		LoggerChannelRegistry.instance.reset();
 	}
-	/**
-	* Registers default startup tasks
-	* @internal
-	*/
 	registerStartupTasks() {
 		if (Envapter.isDevelopment || Envapter.isTest) this.registerHmrAwareModules();
 		this.startup.addTask(StartupPhase.Configuration, "Bus Initialization", async () => {
@@ -3914,5 +3782,5 @@ var Seedcord = class Seedcord extends Pluggable {
 };
 
 //#endregion
-export { ArraySource, AutocompleteHandler, AutocompleteRoute, ButtonHandler, ButtonRoute, CommandMentions, ContextMenuHandler, ContextMenuRoute, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, HmrModuleHandler, 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, 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 };
 //# sourceMappingURL=index.mjs.map