@seedcord/gateway 0.7.5 → 0.8.0

package/dist/index.mjs

@@ -1,23 +1,21 @@
 import "reflect-metadata";
-import { WinstonConsoleSink, WinstonFileSink, installNodeDefaults } from "@seedcord/logger/node";
-import { EventMetadataKey, EventMiddlewareMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionMiddlewareMetadataKey, MiddlewareRegistry, MissingPermissions, NoticeCard, PermissionNames, PublishDefault, accessorStore, areRoutes, asError, bindBotColor, busLoggerOf, clearStore, decodeComponentRoute, deferFlags, eventResultFor, guardedAccessor, interactionMiddleware, interactionRoutesOf, isEmojiTuple, outcomeFor, pickNotice, queuedMsFor, reportDispatch, reportedWrite, resultFor, runAfter, runHandlerGates, sendFlags, slowGateMonitor } from "@seedcord/core/internal";
+import { DRAIN_TASK_TIMEOUT_MS, DRAIN_WINDOW_MS, HealthCheck, InFlight, ShutdownPhase, StartupPhase, setEnvaptBaseDir, shutdownOf } from "@seedcord/core/node/internal";
+import { WinstonConsoleSink, WinstonFileSink, installNodeConsole } from "@seedcord/logger/node";
+import { COMMAND_DEPLOY_TIMEOUT_MS, CommandRegistry, EventMetadataKey, EventMiddlewareMetadataKey, FixedScope, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionMiddlewareMetadataKey, MiddlewareRegistry, MissingPermissions, NoticeCard, PermissionNames, PublishDefault, SubscriberLoader, accessorStore, attachmentsOf, bindBotColor, busLoggerOf, clearStore, connectDevChannel, decodeComponentRoute, deferFlags, eventResultFor, guardedAccessor, interactionMiddleware, interactionRoutesOf, isEmojiTuple, logUnknownFault, outcomeFor, pickNotice, queuedMsFor, readBotToken, reportDispatch, reportedWrite, resultFor, runAfter, runHandlerGates, sendFlags, slowGateMonitor } from "@seedcord/core/internal";
 import { SeedcordErrorCode, paint } from "@seedcord/errors";
-import { SeedcordError, SeedcordTypeError, validateDiscordToken } from "@seedcord/errors/internal";
+import { SeedcordError, SeedcordTypeError, throwSingleOrAggregate } from "@seedcord/errors/internal";
 import { ArraySourceBase, BaseHandler as BaseHandler$1, BaseReplySender, BuilderComponent, Bus, CursorSourceBase, CustomId, DispatchContext, Fault, InteractionKind, Notice, PaginatorBase, RepliableHandler as RepliableHandler$1, ResolvedEmoji, RowComponent, Silence, Subscriber as Subscriber$1, WebhookLog as WebhookLog$1, assertPermissions, defineGate } from "@seedcord/core";
-import { Logger, LoggerChannelRegistry } from "@seedcord/logger";
+import { Logger } from "@seedcord/logger";
 import { ButtonStyle, Client, ComponentType, DiscordAPIError, Events, GatewayIntentBits, Guild, GuildMember, IntentsBitField, InteractionContextType, Message, MessageFlags, PermissionFlagsBits, RESTJSONErrorCodes, Role, User } from "discord.js";
 import { ButtonBuilder, TextDisplayBuilder } from "@discordjs/builders";
-import { buildSlashRoute } from "@seedcord/utils/internal";
+import { asError, buildSlashRoute, isStringArray } from "@seedcord/utils/internal";
 import { Plugin as Plugin$1 } from "@seedcord/core/plugin";
-import { CoordinatedShutdown, CoordinatedStartup, Pluggable } from "@seedcord/core/node";
-import { CommandRegistry, DRAIN_TASK_TIMEOUT_MS, DRAIN_WINDOW_MS, HealthCheck, ShutdownPhase, StartupPhase, SubscriberLoader, drainInFlight, shutdownOf } from "@seedcord/core/node/internal";
+import { CoordinatedShutdown, CoordinatedStartup, ServerHost } from "@seedcord/core/node";
 import { MemoryRateLimiter } from "@seedcord/rate-limiter";
 import { HostAugmentTarget, HostVersion, SeedcordBrand } from "@seedcord/types/internal";
 import { Envapter } from "envapt";
-import { Envapt } from "envapt/legacy";
-import { HmrModuleHandler } from "@seedcord/core/hmr";
-import { formatFilePath, hasKeys } from "@seedcord/utils";
-import { traverseDirectory } from "@seedcord/utils/node";
+import { HmrModuleHandler, HmrModuleHandler as HmrModuleHandler$1 } from "@seedcord/core/hmr";
+import { formatFilePath, hasKeys, importFiles } from "@seedcord/utils";
 import * as crypto from "node:crypto";
 import { prefixOf } from "@seedcord/custom-id";
 
@@ -33,8 +31,12 @@ export * from "@seedcord/utils"
 
 export * from "@seedcord/event-emitter"
 
+//#region src/env-bootstrap.ts
+setEnvaptBaseDir();
+
+//#endregion
 //#region src/logger-bootstrap.ts
-installNodeDefaults();
+installNodeConsole();
 
 //#endregion
 //#region src/bot/decorators/Events.ts
@@ -147,13 +149,13 @@ function Gated(...gates) {
 * }
 * ```
 *
-* @throws A **SeedcordTypeError** If `priority` is not a finite number.
+* @throws A **SeedcordTypeError** when `priority` is not a finite number.
 */
 function RegisterEventMiddleware(options = {}) {
 	return function(ctor) {
 		const priority = Number(options.priority ?? 0);
-		if (!Number.isFinite(priority)) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorInvalidMiddlewarePriority);
-		if (options.events?.length === 0) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorEmptyMiddlewareFilter, ["events"]);
+		if (!Number.isFinite(priority)) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorInvalidMiddlewarePriority, [ctor.name, String(options.priority)]);
+		if (options.events?.length === 0) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorEmptyMiddlewareFilter, [ctor.name, "events"]);
 		const metadata = {
 			priority,
 			...options.events && { events: options.events }
@@ -271,7 +273,8 @@ var GatewayEmoji = class extends ResolvedEmoji {
 const emojiStorage = accessorStore();
 /**
 * The bot's resolved emojis, keyed by {@link EmojiMap}. Filled by {@link EmojiInjector} during startup.
-* Throws if you read a key the injector did not fill.
+*
+* @throws A **SeedcordError** when you read a key the injector did not fill.
 */
 const Emojis = guardedAccessor("Emojis", emojiStorage);
 var EmojiInjector = class {
@@ -288,19 +291,25 @@ var EmojiInjector = class {
 		}
 		const configEmojis = this.core.config.bot.emojis;
 		await this.core.bot.client.application?.emojis.fetch();
-		const failures = [];
+		const problems = [];
 		const fetchedGuilds = /* @__PURE__ */ new Set();
-		for (const [key, value] of Object.entries(configEmojis)) if (isEmojiTuple(value)) await this.resolveTuple(key, value, failures, fetchedGuilds);
-		else if (typeof value === "string") this.resolveString(key, value, failures);
-		else failures.push(`  - "${key}" has an invalid value (expected a name or [name, guildId])`);
-		if (failures.length > 0) throw new SeedcordError(SeedcordErrorCode.ConfigEmojiUnresolved, [failures.length, failures.join("\n")]);
+		for (const [key, value] of Object.entries(configEmojis)) if (isEmojiTuple(value)) await this.resolveTuple(key, value, problems, fetchedGuilds);
+		else if (typeof value === "string") this.resolveString(key, value, problems);
+		else problems.push(new SeedcordTypeError(SeedcordErrorCode.ConfigEmojiInvalid, [key]));
+		throwSingleOrAggregate(problems, SeedcordErrorCode.ConfigEmojiUnresolved);
 		this.logger.utils.summary("Loaded emojis", { emojis: Object.keys(emojiStorage).length });
 	}
-	async resolveTuple(key, value, failures, fetchedGuilds) {
+	async resolveTuple(key, value, problems, fetchedGuilds) {
 		const [emojiName, guildId] = value;
 		const guild = this.core.bot.client.guilds.cache.get(guildId);
 		if (!guild) {
-			failures.push(`  - "${emojiName}" for "${key}" targets guild ${guildId}, which is not available (check the Guilds intent)`);
+			problems.push(new SeedcordError(SeedcordErrorCode.ConfigEmojiSourceUnreadable, [
+				key,
+				emojiName,
+				`guild ${guildId}`,
+				"discord.js has no cached guild with that id",
+				"Check that the bot is in that guild, and that clientOptions.intents includes GatewayIntentBits.Guilds."
+			]));
 			return;
 		}
 		if (!fetchedGuilds.has(guildId)) {
@@ -309,15 +318,23 @@ var EmojiInjector = class {
 		}
 		const guildEmoji = guild.emojis.cache.find((e) => e.name === emojiName);
 		if (!guildEmoji) {
-			failures.push(`  - "${emojiName}" for "${key}" was not found in guild ${guildId}`);
+			problems.push(new SeedcordError(SeedcordErrorCode.ConfigEmojiNotFound, [
+				key,
+				emojiName,
+				`guild ${guildId}`
+			]));
 			return;
 		}
 		emojiStorage[key] = new GatewayEmoji(guildEmoji);
 	}
-	resolveString(key, emojiName, failures) {
+	resolveString(key, emojiName, problems) {
 		const appEmoji = this.core.bot.client.application?.emojis.cache.find((e) => e.name === emojiName);
 		if (!appEmoji) {
-			failures.push(`  - "${emojiName}" for "${key}" was not found among the application emojis`);
+			problems.push(new SeedcordError(SeedcordErrorCode.ConfigEmojiNotFound, [
+				key,
+				emojiName,
+				"the application"
+			]));
 			return;
 		}
 		emojiStorage[key] = new GatewayEmoji(appEmoji);
@@ -400,7 +417,8 @@ function botRoleOf(guild) {
 * Validates that the bot can assign a target role. Refuses when the target role is above the bot's, is managed, or the bot lacks Manage Roles.
 *
 * @param roleOrOptions - Target role or complete options for the check
-* @throws A `Notice` on refusal, or a `SeedcordError` when the bot has no role in the guild's role cache.
+* @throws A {@link Notice} when the check refuses.
+* @throws A **SeedcordError** when the bot has no role in the guild's role cache.
 *
 * @example
 * ```ts
@@ -763,16 +781,24 @@ var SlashHandler = class extends InteractionHandler {
 	async match(arms) {
 		const route = slashRouteOf(this.event);
 		const arm = Object.hasOwn(arms, route) ? arms[route] : void 0;
-		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.SlashMatchArmMissing, [route]);
+		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.MatchArmMissing, [
+			this.constructor.name,
+			"command route",
+			route
+		]);
 		return await arm(this.options);
 	}
 };
 
 //#endregion
 //#region src/handlers/interaction/ContextMenuHandler.ts
-function armFor(arms, name) {
+function armFor(handler, arms, name) {
 	const arm = Object.hasOwn(arms, name) ? arms[name] : void 0;
-	if (typeof arm !== "function") throw new SeedcordTypeError(SeedcordErrorCode.ContextMenuMatchArmMissing, [name]);
+	if (typeof arm !== "function") throw new SeedcordTypeError(SeedcordErrorCode.MatchArmMissing, [
+		handler.constructor.name,
+		"context menu command",
+		name
+	]);
 	return arm;
 }
 /**
@@ -832,7 +858,7 @@ var UserContextMenuHandler = class extends InteractionHandler {
 	* ```
 	*/
 	async match(arms) {
-		return await armFor(arms, this.event.commandName)(this.target, this.targetMember);
+		return await armFor(this, arms, this.event.commandName)(this.target, this.targetMember);
 	}
 };
 /**
@@ -887,7 +913,7 @@ var MessageContextMenuHandler = class extends InteractionHandler {
 	* ```
 	*/
 	async match(arms) {
-		return await armFor(arms, this.event.commandName)(this.target);
+		return await armFor(this, arms, this.event.commandName)(this.target);
 	}
 };
 
@@ -952,11 +978,11 @@ var AutocompleteHandler = class extends BaseHandler {
 	*
 	* Provide one arm per autocompletable field across the registered commands, keyed by field name. Each
 	* 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.
+	* arms must cover every autocompletable field. A missing field or an unknown key is a compile error.
 	*
 	* @param arms - One handler per autocompletable field, keyed by field name.
 	* @returns The result of the arm that ran.
+	* @throws A **SeedcordTypeError** with `MatchArmMissing` when the focused field has no arm. Only a stale-deployed command can send one.
 	*
 	* @example
 	* ```ts
@@ -975,7 +1001,11 @@ var AutocompleteHandler = class extends BaseHandler {
 		const { name, value } = this.focused;
 		const respond = (choices) => this.respond(choices);
 		const arm = Object.hasOwn(arms, name) ? arms[name] : void 0;
-		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.AutocompleteMatchArmMissing, [name]);
+		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.MatchArmMissing, [
+			this.constructor.name,
+			"focused field",
+			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. */
@@ -1028,10 +1058,11 @@ var ComponentHandler = class extends InteractionHandler {
 	/**
 	* The decoded params of the single route this handler is registered for.
 	*
-	* Reading this decodes `this.event.customId` once (cached after the first read) and throws
-	* `StaleCustomId` or `InvalidCustomId` when the wire no longer matches the current shape, which the
-	* controller boundary turns into a reply. On a handler registered for several routes this is
-	* `never`. Use {@link match} instead.
+	* Reading this decodes `this.event.customId` once and caches the result. On a handler registered
+	* for several routes this is `never`. Use {@link match} instead.
+	*
+	* @throws A **StaleCustomId** when the wire was encoded under an older shape. The controller boundary turns it into a reply.
+	* @throws An **InvalidCustomId** when the wire is corrupt. The controller boundary turns it into a reply.
 	*/
 	get params() {
 		return this.route.params;
@@ -1042,12 +1073,14 @@ var ComponentHandler = class extends InteractionHandler {
 	* handler `this.params` is `never`, leaving match as 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 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.
+	* decoded params. The compiler checks that the arms cover every registered route prefix. `match`
+	* decodes the wire before it runs an arm.
 	*
 	* @param arms - One callback per registered route, keyed by prefix.
 	* @returns The result of the arm that ran.
+	* @throws A **SeedcordTypeError** with `MatchArmMissing` when the wire's prefix has no arm.
+	* @throws A **StaleCustomId** when the wire was encoded under an older shape.
+	* @throws An **InvalidCustomId** when the wire is corrupt.
 	*
 	* @example
 	* ```ts
@@ -1065,7 +1098,11 @@ var ComponentHandler = class extends InteractionHandler {
 	async match(arms) {
 		const { prefix, params } = this.route;
 		const arm = Object.hasOwn(arms, prefix) ? arms[prefix] : void 0;
-		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdMatchArmMissing, [prefix]);
+		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.MatchArmMissing, [
+			this.constructor.name,
+			"component route",
+			prefix
+		]);
 		return await arm(params);
 	}
 };
@@ -1353,9 +1390,13 @@ var EventHandler = class extends BaseHandler {
 	*/
 	async match(arms) {
 		const name = this.firedEvent;
-		if (name === void 0) throw new SeedcordTypeError(SeedcordErrorCode.EventMatchArmMissing, ["<no event>"]);
+		if (name === void 0) throw new SeedcordError(SeedcordErrorCode.EventNameUnavailable, [this.constructor.name, "match()"]);
 		const arm = Object.hasOwn(arms, name) ? arms[name] : void 0;
-		if (typeof arm !== "function") throw new SeedcordTypeError(SeedcordErrorCode.EventMatchArmMissing, [name]);
+		if (typeof arm !== "function") throw new SeedcordTypeError(SeedcordErrorCode.MatchArmMissing, [
+			this.constructor.name,
+			"event",
+			name
+		]);
 		return await arm(...this.getEvent());
 	}
 };
@@ -1385,7 +1426,7 @@ var EventMiddleware = class extends BaseHandler {
 	* `this.event` directly and does not need this.
 	*/
 	get eventName() {
-		if (this.firedEvent === void 0) throw new SeedcordError(SeedcordErrorCode.EventMiddlewareNameUnavailable);
+		if (this.firedEvent === void 0) throw new SeedcordError(SeedcordErrorCode.EventNameUnavailable, [this.constructor.name, "this.eventName"]);
 		return this.firedEvent;
 	}
 };
@@ -1492,6 +1533,10 @@ var WebhookLog = class extends WebhookLog$1 {};
 
 //#endregion
 //#region src/Plugin.ts
+const GATEWAY_SCOPE = {
+	transport: "gateway",
+	runtime: "server"
+};
 /**
 * Base class for a gateway plugin, binding `this.core` to the gateway {@link Core}.
 *
@@ -1500,7 +1545,10 @@ var WebhookLog = class extends WebhookLog$1 {};
 *
 * @typeParam Opts - The transport and runtime the plugin declares.
 */
-var Plugin = class extends Plugin$1 {};
+var Plugin = class extends Plugin$1 {
+	/** @internal */
+	static [FixedScope] = GATEWAY_SCOPE;
+};
 
 //#endregion
 //#region src/miscellaneous/deriveEventActor.ts
@@ -1635,15 +1683,8 @@ function reportFault(denial, core, fault, uuid) {
 		metadata: metadataFor(fault)
 	});
 }
-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, fault, uuid) {
-	if (core.config.errors?.errorStack ?? false) logger$2.error(uuid, error);
-	else logger$2.error(`${uuid} | ${error.message}${causeLine(error)}`);
+	logUnknownFault(logger$2, uuid, error, core.config.errors);
 	core.bus[PublishDefault]("unknownException", {
 		uuid,
 		dispatchId: fault.dispatch.id,
@@ -1783,8 +1824,7 @@ var EventDispatcher = class {
 	middlewares = new MiddlewareRegistry(eventMiddleware);
 	executedOnceHandlers = /* @__PURE__ */ new Set();
 	attachedEvents = /* @__PURE__ */ new Set();
-	inFlight = /* @__PURE__ */ new Set();
-	draining = false;
+	inFlight = new InFlight(this.logger, "Events");
 	loading = false;
 	loadedHandlers = [];
 	loadedMiddlewares = [];
@@ -1794,7 +1834,7 @@ var EventDispatcher = class {
 		const eventsDir = this.core.config.bot.events.path;
 		if (!eventsDir) throw new SeedcordError(SeedcordErrorCode.CoreControllerPathMissing, ["EventDispatcher", "events"]);
 		if (!Envapter.isDevelopment && !Envapter.isTest) return;
-		this.hmrHandler = new HmrModuleHandler({
+		this.hmrHandler = new HmrModuleHandler$1({
 			handlersDir: eventsDir,
 			...hasKeys(this.core.config.bot.events, ["middlewares"]) && { middlewaresDir: this.core.config.bot.events.middlewares },
 			isHandler: this.isEventHandlerClass.bind(this),
@@ -1842,22 +1882,18 @@ var EventDispatcher = class {
 		utils.block("Loaded event handlers", [...utils.entries(this.loadedHandlers), ...utils.counts(perEvent)], "debug");
 	}
 	async loadHandlers(dir) {
-		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
-			for (const val of Object.values(imported)) {
-				if (!this.isEventHandlerClass(val)) continue;
-				this.registerHandler(val, relativePath);
-				this.hmrHandler?.trackHandler(fullPath, val);
-			}
-		});
+		for await (const { fullPath, relativePath, imported } of importFiles(dir)) for (const val of Object.values(imported)) {
+			if (!this.isEventHandlerClass(val)) continue;
+			this.registerHandler(val, relativePath);
+			this.hmrHandler?.trackHandler(fullPath, val);
+		}
 	}
 	async loadMiddlewares(dir) {
-		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
-			for (const val of Object.values(imported)) {
-				if (!this.isMiddlewareClass(val)) continue;
-				this.registerMiddleware(val, relativePath);
-				this.hmrHandler?.trackMiddleware(fullPath, val);
-			}
-		});
+		for await (const { fullPath, relativePath, imported } of importFiles(dir)) for (const val of Object.values(imported)) {
+			if (!this.isMiddlewareClass(val)) continue;
+			this.registerMiddleware(val, relativePath);
+			this.hmrHandler?.trackMiddleware(fullPath, val);
+		}
 	}
 	/** @internal */
 	async onHmr(event) {
@@ -1926,7 +1962,7 @@ var EventDispatcher = class {
 		};
 		if (Array.isArray(raw)) for (const entry of raw) register(entry.event, entry.frequency);
 		else {
-			const names = areRoutes(raw) ? raw : typeof raw === "string" ? [raw] : [];
+			const names = isStringArray(raw) ? raw : typeof raw === "string" ? [raw] : [];
 			for (const name of names) register(name, "on");
 		}
 		const from = formatFilePath(relativePath);
@@ -1944,21 +1980,20 @@ var EventDispatcher = class {
 		const handlerEntries = this.eventMap.get(eventName);
 		this.logger.debug(`Attaching ${paint.sky.bold(eventName)} to the client with ${paint.mute(handlerEntries?.length ?? 0)} handler(s)`);
 		this.core.bot.client.on(eventName, (...args) => {
-			if (this.draining) return;
+			if (this.inFlight.closed) return;
 			const run = this.processEvent(eventName, args).catch((caught) => {
 				const error = asError(caught);
 				this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${error.name}`, error.stack);
 				this.core.bus[PublishDefault]("unhandledEventError", { error });
 			});
-			this.inFlight.add(run);
-			run.finally(() => this.inFlight.delete(run));
+			this.inFlight.track(run);
 		});
 	}
 	stopAccepting() {
-		this.draining = true;
+		this.inFlight.close();
 	}
 	drain(timeoutMs) {
-		return drainInFlight(this.inFlight, timeoutMs, this.logger, "Events");
+		return this.inFlight.drain(timeoutMs);
 	}
 	async processEvent(eventName, args) {
 		const startedAt = performance.now();
@@ -2125,8 +2160,7 @@ var InteractionDispatcher = class {
 	handlerFiles = /* @__PURE__ */ new Map();
 	keysToIgnore = /* @__PURE__ */ new Set();
 	middlewares = new MiddlewareRegistry(interactionMiddleware);
-	inFlight = /* @__PURE__ */ new Set();
-	draining = false;
+	inFlight = new InFlight(this.logger, "Interactions");
 	loading = false;
 	loadedHandlers = [];
 	loadedMiddlewares = [];
@@ -2139,7 +2173,7 @@ var InteractionDispatcher = class {
 		const interactionsDir = this.core.config.bot.interactions.path;
 		if (!interactionsDir) throw new SeedcordError(SeedcordErrorCode.CoreControllerPathMissing, ["InteractionDispatcher", "interactions"]);
 		if (!Envapter.isDevelopment && !Envapter.isTest) return;
-		this.hmrHandler = new HmrModuleHandler({
+		this.hmrHandler = new HmrModuleHandler$1({
 			handlersDir: interactionsDir,
 			...hasKeys(this.core.config.bot.interactions, ["middlewares"]) && this.core.config.bot.interactions.middlewares && { middlewaresDir: this.core.config.bot.interactions.middlewares },
 			isHandler: this.isHandlerClass.bind(this),
@@ -2205,22 +2239,18 @@ var InteractionDispatcher = class {
 		})], "debug");
 	}
 	async loadHandlers(dir) {
-		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
-			for (const val of Object.values(imported)) {
-				if (!this.isHandlerClass(val)) continue;
-				this.registerHandler(val, relativePath);
-				this.hmrHandler?.trackHandler(fullPath, val);
-			}
-		});
+		for await (const { fullPath, relativePath, imported } of importFiles(dir)) for (const val of Object.values(imported)) {
+			if (!this.isHandlerClass(val)) continue;
+			this.registerHandler(val, relativePath);
+			this.hmrHandler?.trackHandler(fullPath, val);
+		}
 	}
 	async loadMiddlewares(dir) {
-		await traverseDirectory(dir, (fullPath, relativePath, imported) => {
-			for (const val of Object.values(imported)) {
-				if (!this.isMiddlewareClass(val)) continue;
-				this.registerMiddleware(val, relativePath);
-				this.hmrHandler?.trackMiddleware(fullPath, val);
-			}
-		});
+		for await (const { fullPath, relativePath, imported } of importFiles(dir)) for (const val of Object.values(imported)) {
+			if (!this.isMiddlewareClass(val)) continue;
+			this.registerMiddleware(val, relativePath);
+			this.hmrHandler?.trackMiddleware(fullPath, val);
+		}
 	}
 	registerMiddleware(middlewareCtor, relativePath) {
 		const metadata = this.middlewares.register(middlewareCtor);
@@ -2244,10 +2274,10 @@ var InteractionDispatcher = class {
 		const writes = [];
 		for (const [kind, routes] of interactionRoutesOf(handlerClass)) for (const route of routes) {
 			const existing = this.maps[kind].get(route);
-			if (existing && existing !== handlerClass) throw new SeedcordError(SeedcordErrorCode.InteractionDuplicateRoute, [
+			if (existing && existing !== handlerClass) throw new SeedcordTypeError(SeedcordErrorCode.CoreDuplicateName, [
+				"route",
 				`${kind}:${route}`,
-				`${existing.name} (${this.handlerFiles.get(existing) ?? "unknown file"})`,
-				`${handlerClass.name} (${from})`
+				[`${paint.bold(existing.name)} (${paint.path(this.handlerFiles.get(existing) ?? "unknown file")})`, `${paint.bold(handlerClass.name)} (${paint.path(from)})`]
 			]);
 			writes.push({
 				kind,
@@ -2274,22 +2304,21 @@ var InteractionDispatcher = class {
 	}
 	attachToClient() {
 		this.core.bot.client.on(Events.InteractionCreate, (interaction) => {
-			if (this.draining) return;
+			if (this.inFlight.closed) return;
 			this.core.bus[PublishDefault]("anyInteraction", { interaction });
 			const run = this.handleInteraction(interaction).catch((caught) => {
 				const error = asError(caught);
 				this.logger.error(`[${paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${error.name}`, error.stack);
 				this.core.bus[PublishDefault]("unhandledInteractionError", { error });
 			});
-			this.inFlight.add(run);
-			run.finally(() => this.inFlight.delete(run));
+			this.inFlight.track(run);
 		});
 	}
 	stopAccepting() {
-		this.draining = true;
+		this.inFlight.close();
 	}
 	drain(timeoutMs) {
-		return drainInFlight(this.inFlight, timeoutMs, this.logger, "Interactions");
+		return this.inFlight.drain(timeoutMs);
 	}
 	async handleCustomIdInteraction(interaction, kind) {
 		if ([...this.keysToIgnore].some((matcher) => matcher.owns(interaction.customId))) return;
@@ -2487,16 +2516,7 @@ function assertGuildsIntent(intents, commands) {
 	if ((IntentsBitField.resolve(intents) & GatewayIntentBits.Guilds) !== 0) return;
 	const needing = commands.filter((command) => reachesGuilds(command)).map((command) => command.name);
 	if (needing.length === 0) return;
-	throw new SeedcordError(SeedcordErrorCode.MissingGuildsIntent, [needing.join(", ")]);
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.152.0/helpers/esm/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
+	throw new SeedcordError(SeedcordErrorCode.MissingGuildsIntent, [needing]);
 }
 
 //#endregion
@@ -2504,16 +2524,19 @@ function __decorate(decorators, target, key, desc) {
 const UNBIND_TIMEOUT_MS = 2e3;
 const LOGOUT_TIMEOUT_MS = 2e3;
 const loggerSlot = Symbol("seedcord:bot:logger");
-const initSlot = Symbol("seedcord:bot:init");
 const controllersSlot = Symbol("seedcord:bot:controllers");
 /**
 * The Discord client and its controllers. Access it through `core.bot`.
 */
 var Bot = class {
+	get botToken() {
+		return readBotToken().value;
+	}
 	#logger = new Logger("Bot", { channel: "bot" });
 	/** @internal */
 	[loggerSlot] = this.#logger;
 	#isInitialized = false;
+	#readyToDeploy = Promise.withResolvers();
 	#intents;
 	#client;
 	#emojiInjector;
@@ -2534,6 +2557,7 @@ var Bot = class {
 		if (core.config.bot.events.path) this.#events = new EventDispatcher(core);
 		if (core.config.bot.commands.path) this.#commandRegistry = new CommandRegistry(core);
 		this.#emojiInjector = new EmojiInjector(core);
+		this.#registerStartupTasks(core);
 		this.#registerShutdownTasks(core);
 	}
 	/** @internal */
@@ -2550,6 +2574,16 @@ var Bot = class {
 		if (!application) throw new SeedcordError(SeedcordErrorCode.CoreApplicationUnavailable);
 		return application.id;
 	}
+	#registerStartupTasks(core) {
+		core.startup.addTask(StartupPhase.Login, "bot-initialization", async (signal) => {
+			this.#logger.utils.initialization("Bot", "start");
+			await this.#init(signal);
+			this.#logger.utils.initialization("Bot", "end");
+		});
+		const registry = this.#commandRegistry;
+		if (!registry) return;
+		core.startup.addTask(StartupPhase.Login, "command-deploy", (signal) => this.#deployCommands(registry, signal), COMMAND_DEPLOY_TIMEOUT_MS);
+	}
 	#registerShutdownTasks(core) {
 		core.shutdown.addTask(ShutdownPhase.Unbind, "stop-dispatch", () => {
 			this.#stopAccepting();
@@ -2565,21 +2599,28 @@ var Bot = class {
 	async #drain() {
 		await Promise.allSettled([this.#interactions?.drain(DRAIN_WINDOW_MS), this.#events?.drain(DRAIN_WINDOW_MS)]);
 	}
-	/** @internal */
-	async [initSlot]() {
+	async #init(signal) {
 		if (this.#isInitialized) return;
 		this.#isInitialized = true;
-		const token = this.botToken;
-		if (this.#interactions) await this.#interactions.init();
-		if (this.#events) await this.#events.init();
-		await this.#login(token);
-		await this.#emojiInjector.init();
-		if (!this.#commandRegistry) return;
-		await this.#commandRegistry.init();
-		assertGuildsIntent(this.#intents, this.#commandRegistry.allCommands());
-		await this.#commandRegistry.setCommands();
-		this.#interactions?.warnUnhandledRoutes(this.#commandRegistry.routeLeaves());
-		this.#interactions?.warnUnhandledContextMenuRoutes(this.#commandRegistry.contextMenuLeaves());
+		signal.addEventListener("abort", () => this.#readyToDeploy.resolve(false), { once: true });
+		try {
+			const token = this.botToken;
+			if (this.#interactions) await this.#interactions.init();
+			if (this.#events) await this.#events.init();
+			await this.#login(token);
+			await this.#emojiInjector.init();
+		} catch (error) {
+			this.#readyToDeploy.resolve(false);
+			throw error;
+		}
+		this.#readyToDeploy.resolve(true);
+	}
+	async #deployCommands(registry, signal) {
+		if (!await this.#readyToDeploy.promise) return;
+		await registry.deploy(signal, {
+			routes: this.#interactions,
+			check: (commands) => assertGuildsIntent(this.#intents, commands)
+		});
 	}
 	async #stop() {
 		this.#client.removeAllListeners();
@@ -2601,18 +2642,11 @@ var Bot = class {
 		return this.#client;
 	}
 };
-__decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) })], Bot.prototype, "botToken", void 0);
-function botLoggerOf(bot) {
-	return bot[loggerSlot];
-}
-function initBot(bot) {
-	return bot[initSlot]();
-}
 
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.7.5";
+const version = "0.8.0";
 
 //#endregion
 //#region src/Seedcord.ts
@@ -2620,7 +2654,7 @@ const version = "0.7.5";
 * 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 {
+var Seedcord = class extends ServerHost {
 	config;
 	/** @internal */
 	[SeedcordBrand] = true;
@@ -2628,11 +2662,11 @@ var Seedcord = class Seedcord extends Pluggable {
 	[HostAugmentTarget] = "@seedcord/gateway";
 	/** @internal */
 	[HostVersion] = version;
-	healthCheck;
-	hmrManager;
+	#healthCheck;
+	#hmrManager;
 	/** @see {@link Bus} */
 	bus;
-	subscribers;
+	#subscribers;
 	/** @see {@link Bot} */
 	bot;
 	/** The discord.js client's REST client. Its token is set during the Login phase. */
@@ -2645,76 +2679,61 @@ var Seedcord = class Seedcord extends Pluggable {
 	rateLimiter;
 	/**
 	* @param config - Bot configuration including paths and Discord client options
-	* @throws A **SeedcordError** When attempting to create multiple instances (singleton)
+	* @throws A **SeedcordError** when another `Seedcord` exists in this process and has not shut down.
+	* @throws A **SeedcordError** when the running Node or Bun is older than the range in `engines`.
 	*/
 	constructor(config) {
-		super(new CoordinatedShutdown(config.lifecycle?.shutdownDeadline), new CoordinatedStartup());
+		super("gateway", new CoordinatedShutdown(config.lifecycle?.shutdownDeadline), new CoordinatedStartup());
 		this.config = config;
-		installNodeDefaults(config.logger);
 		bindBotColor(() => this.config.botColor);
-		this.hmrManager = new HmrManager();
-		this.hmrManager.init();
+		this.#hmrManager = new HmrManager();
+		this.#hmrManager.init(connectDevChannel());
 		this.bus = new Bus(this);
-		this.subscribers = new SubscriberLoader(this.bus, config.subscribers.path);
+		this.#subscribers = new SubscriberLoader(this.bus, config.subscribers.path);
 		this.bot = new Bot(this);
 		this.rest = this.bot.client.rest;
 		this.rateLimiter = config.store ?? new MemoryRateLimiter();
-		this.healthCheck = HealthCheck.fromOption(shutdownOf(this), config.healthCheck);
-		this.registerStartupTasks();
+		this.#healthCheck = HealthCheck.fromOption(shutdownOf(this), config.healthCheck);
+		this.#registerStartupTasks();
 	}
 	/** The bot's discord username, populated after login. */
 	get username() {
 		return this.bot.client.user?.username;
 	}
-	static reset(host) {
-		if (!super.reset(host)) return false;
-		LoggerChannelRegistry.instance.configure({});
-		return true;
-	}
-	registerStartupTasks() {
-		if (Envapter.isDevelopment || Envapter.isTest) this.registerHmrAwareModules();
+	#registerStartupTasks() {
+		if (Envapter.isDevelopment || Envapter.isTest) this.#registerHmrAwareModules();
 		this.startup.addTask(StartupPhase.Configuration, "bus-initialization", async () => {
 			busLoggerOf(this.bus).utils.initialization("Subscribers", "start");
-			await this.subscribers.init();
+			await this.#subscribers.init();
 			busLoggerOf(this.bus).utils.initialization("Subscribers", "end");
 		});
-		this.startup.addTask(StartupPhase.Login, "bot-initialization", async () => {
-			botLoggerOf(this.bot).utils.initialization("Bot", "start");
-			await initBot(this.bot);
-			botLoggerOf(this.bot).utils.initialization("Bot", "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");
-		});
+	}
+	/** @internal */
+	async openHealth() {
+		const healthCheck = this.#healthCheck;
+		if (!healthCheck) return;
+		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 initialized
 	*/
-	async start() {
-		try {
-			await super.init();
-		} catch (caught) {
-			await shutdownOf(this).run(1, false);
-			Seedcord.reset(this);
-			throw caught;
-		}
-		return this;
+	start() {
+		return this.init();
 	}
-	registerHmrAwareModules() {
+	#registerHmrAwareModules() {
 		this.startup.addTask(StartupPhase.Configuration, "hmr-registration", async () => {
-			this.hmrManager.register(this.bot);
-			this.hmrManager.register(this.subscribers);
-			for (const plugin of this.plugins) this.hmrManager.register(plugin);
+			this.#hmrManager.register(this.bot);
+			this.#hmrManager.register(this.#subscribers);
+			for (const { instance } of attachmentsOf(this)) this.#hmrManager.register(instance);
 			await Promise.resolve();
 		});
 	}
 };
 
 //#endregion
-export { ArraySource, AutocompleteHandler, BaseHandler, ButtonHandler, ChannelMenuHandler, ComponentHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, GatewayEmoji, IgnoreBots, InteractionHandler, InteractionMiddleware, MentionableMenuHandler, MessageContextMenuHandler, ModalHandler, Nsfw, Paginator, Plugin, RegisterEvent, RegisterEventMiddleware, RepliableHandler, ReplySender, RoleMenuHandler, Seedcord, SelectMenuHandler, SlashHandler, StringMenuHandler, Subscriber, UserContextMenuHandler, UserMenuHandler, WebhookLog, WinstonConsoleSink, WinstonFileSink, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
+export { ArraySource, AutocompleteHandler, BaseHandler, ButtonHandler, ChannelMenuHandler, ComponentHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, GatewayEmoji, HmrModuleHandler, IgnoreBots, InteractionHandler, InteractionMiddleware, MentionableMenuHandler, MessageContextMenuHandler, ModalHandler, Nsfw, Paginator, Plugin, RegisterEvent, RegisterEventMiddleware, RepliableHandler, ReplySender, RoleMenuHandler, Seedcord, SelectMenuHandler, SlashHandler, StringMenuHandler, Subscriber, UserContextMenuHandler, UserMenuHandler, WebhookLog, WinstonConsoleSink, WinstonFileSink, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
 //# sourceMappingURL=index.mjs.map