@seedcord/gateway 0.3.0 → 0.4.0

package/dist/index.mjs

@@ -1,17 +1,18 @@
 import "reflect-metadata";
-import { installNodeDefaults } from "@seedcord/logger/node";
-import { BaseReplySender, CommandInjector, EventMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, NoticeCard, PermissionNames, PublishDefault, accessorStore, areRoutes, asError, busLoggerOf, clearStore, decodeComponentRoute, deferFlags, guardedAccessor, isEmojiTuple, outcomeFor, pickNotice, prefixOf, queuedMsFor, reportDispatch, reportedWrite, routeIdOf, runHandlerGates, sendFlags, setBotColor, slowGateMonitor } from "@seedcord/core/internal";
+import { WinstonConsoleSink, WinstonFileSink, installNodeDefaults } from "@seedcord/logger/node";
+import { EventMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, NoticeCard, PermissionNames, PublishDefault, accessorStore, areRoutes, asError, busLoggerOf, clearStore, decodeComponentRoute, deferFlags, guardedAccessor, isEmojiTuple, outcomeFor, pickNotice, prefixOf, queuedMsFor, reportDispatch, reportedWrite, routeIdOf, runHandlerGates, sendFlags, setBotColor, slowGateMonitor } from "@seedcord/core/internal";
 import { SeedcordErrorCode, paint } from "@seedcord/errors";
 import { SeedcordError, SeedcordTypeError, validateDiscordToken } from "@seedcord/errors/internal";
-import { ArraySource as ArraySource$1, BaseHandler as BaseHandler$1, BuilderComponent, Bus, CursorSource as CursorSource$1, CustomId, DispatchContext, Fault, Notice, PaginatorBase, RepliableHandler as RepliableHandler$1, ResolvedEmoji, RowComponent, Silence, Subscriber as Subscriber$1, WebhookLog as WebhookLog$1, assertPermissions, defineGate } from "@seedcord/core";
+import { ArraySourceBase, BaseHandler as BaseHandler$1, BaseReplySender, BuilderComponent, Bus, CursorSourceBase, CustomId, DispatchContext, Fault, Notice, PaginatorBase, RepliableHandler as RepliableHandler$1, ResolvedEmoji, RowComponent, Silence, Subscriber as Subscriber$1, WebhookLog as WebhookLog$1, assertPermissions, defineGate } from "@seedcord/core";
 import { Logger, LoggerChannelRegistry } from "@seedcord/logger";
 import { ButtonStyle, Client, ComponentType, DiscordAPIError, Events, 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 { Plugin as Plugin$1 } from "@seedcord/core/plugin";
-import { CommandRegistry, CoordinatedShutdown, CoordinatedStartup, HealthCheck, Pluggable, ShutdownPhase, StartupPhase, SubscriberLoader, settleWithin } from "@seedcord/core/node/internal";
+import { CoordinatedShutdown, CoordinatedStartup, Pluggable } from "@seedcord/core/node";
+import { CommandRegistry, HealthCheck, ShutdownPhase, StartupPhase, SubscriberLoader, settleWithin, shutdownOf } from "@seedcord/core/node/internal";
 import { MemoryRateLimiter } from "@seedcord/rate-limiter";
-import { SeedcordBrand } from "@seedcord/types/internal";
+import { HostAugmentTarget, HostVersion, SeedcordBrand } from "@seedcord/types/internal";
 import { Envapter } from "envapt";
 import { Envapt } from "envapt/legacy";
 import { HmrModuleHandler } from "@seedcord/core/hmr";
@@ -160,7 +161,7 @@ function Middleware(type, priority = 0, options = {}) {
 	return (ctor) => {
 		const normalizedPriority = Number(priority);
 		if (!Number.isFinite(normalizedPriority)) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorInvalidMiddlewarePriority);
-		if (type === "interaction" && Array.isArray(options.events) && options.events.length > 0) throw new SeedcordError(SeedcordErrorCode.DecoratorInteractionEventFilter);
+		if (type === "interaction" && Array.isArray(options.events) && options.events.length > 0) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorInteractionEventFilter);
 		const metadata = {
 			priority: normalizedPriority,
 			type,
@@ -200,6 +201,7 @@ const IgnoreBots = defineGate("IgnoreBots", (ctx) => {
 var NotNsfw = class extends GateNotice {
 	constructor(message = "This can only be used in an age-restricted channel.") {
 		super(message);
+		this.summary = "be in an age-restricted channel";
 	}
 };
 var RoleHigherThanMe = class extends Notice {
@@ -274,7 +276,7 @@ var GatewayEmoji = class extends ResolvedEmoji {
 const emojiStorage = accessorStore();
 /**
 * The bot's resolved emojis, keyed by {@link EmojiMap}. Filled by {@link EmojiInjector} during startup.
-* A read before that throws.
+* Throws if you read a key the injector did not fill.
 */
 const Emojis = guardedAccessor("Emojis", emojiStorage);
 var EmojiInjector = class {
@@ -486,7 +488,7 @@ async function getConfirmation(handler, prompt, options) {
 	const { ephemeral = true, timeoutMs = DEFAULT_TIMEOUT_MS } = options ?? {};
 	const response = typeof prompt === "string" ? defaultPrompt(prompt, options) : await prompt(CONFIRM_IDS);
 	const interaction = handler.getEvent();
-	const sender = handler.getSender();
+	const { sender } = handler;
 	const message = await sender.send(response, { ephemeral });
 	const winner = await collectChoice(message, interaction.user.id, timeoutMs);
 	if (!winner) {
@@ -724,9 +726,15 @@ function slashRouteOf(interaction) {
 */
 var SlashHandler = class extends InteractionHandler {
 	/**
-	* The typed options for this command's route. Required options drop the null, choices narrow to their
-	* literal union, and only the getters for kinds this command actually uses appear. Use `this.event.options`
-	* directly for anything outside this view, such as narrowing a channel option by type.
+	* The typed options for this command's route. Only the getters for kinds this command declares appear.
+	* Each getter's name argument is restricted to that command's options of its kind.
+	*
+	* - A required option drops the null.
+	* - Choices narrow to their literal union.
+	* - A channel option declared with `addChannelTypes` narrows to those types.
+	*
+	* Use `this.event.options` directly for anything outside this view, such as `getSubcommand()`.
+	* However, for the common case, the methods in this would suffice.
 	*/
 	get options() {
 		return this.event.options;
@@ -748,8 +756,8 @@ var SlashHandler = class extends InteractionHandler {
 	* class ModHandler extends SlashHandler<'ban' | 'kick'> {
 	*     async execute() {
 	*         await this.match({
-	*             ban: (options) => this.event.guild?.members.ban(options.getUser('target', true).id),
-	*             kick: (options) => this.event.guild?.members.kick(options.getUser('member', true).id)
+	*             ban: (options) => this.event.guild?.members.ban(options.getUser('target').id),
+	*             kick: (options) => this.event.guild?.members.kick(options.getUser('member').id)
 	*         });
 	*     }
 	* }
@@ -758,13 +766,18 @@ 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 SeedcordError(SeedcordErrorCode.SlashMatchArmMissing, [route]);
+		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.SlashMatchArmMissing, [route]);
 		return await arm(this.options);
 	}
 };
 
 //#endregion
 //#region src/handlers/interaction/ContextMenuHandler.ts
+function armFor(arms, name) {
+	const arm = Object.hasOwn(arms, name) ? arms[name] : void 0;
+	if (typeof arm !== "function") throw new SeedcordTypeError(SeedcordErrorCode.ContextMenuMatchArmMissing, [name]);
+	return arm;
+}
 /**
 * Base class for a user context-menu command handler (right-click a user).
 *
@@ -792,6 +805,38 @@ var UserContextMenuHandler = class extends InteractionHandler {
 	get targetMember() {
 		return this.event.targetMember;
 	}
+	/** Which of the registered commands fired. */
+	get commandName() {
+		return this.event.commandName;
+	}
+	/**
+	* Run the arm for whichever command fired. Use this only when the handler is registered for several
+	* names.
+	*
+	* Provide one arm per registered name, keyed by the name Discord shows in the right-click menu. Each
+	* arm receives the clicked user and that user's guild member, both narrowed to the cache state of that
+	* one command. The arms must cover every name in the generic. A missing name or an unknown key is a
+	* compile error.
+	*
+	* @param arms - One handler per registered command name.
+	* @returns The result of the arm that ran.
+	*
+	* @example
+	* ```ts
+	* \@UserContextMenuRoute('View Profile', 'Warn')
+	* class Moderation extends UserContextMenuHandler<'View Profile' | 'Warn'> {
+	*     async execute() {
+	*         await this.match({
+	*             'View Profile': (user) => this.reply(`Profile for ${user.tag}.`),
+	*             Warn: (user, member) => this.reply(`Warned ${member?.displayName ?? user.tag}.`)
+	*         });
+	*     }
+	* }
+	* ```
+	*/
+	async match(arms) {
+		return await armFor(arms, this.event.commandName)(this.target, this.targetMember);
+	}
 };
 /**
 * Base class for a message context-menu command handler (right-click a message).
@@ -816,6 +861,37 @@ var MessageContextMenuHandler = class extends InteractionHandler {
 	get target() {
 		return this.event.targetMessage;
 	}
+	/** Which of the registered commands fired. */
+	get commandName() {
+		return this.event.commandName;
+	}
+	/**
+	* Run the arm for whichever command fired. Use this only when the handler is registered for several
+	* names.
+	*
+	* Provide one arm per registered name, keyed by the name Discord shows in the right-click menu. Each
+	* arm receives the clicked message, narrowed to the cache state of that one command. The arms must
+	* cover every name in the generic. A missing name or an unknown key is a compile error.
+	*
+	* @param arms - One handler per registered command name.
+	* @returns The result of the arm that ran.
+	*
+	* @example
+	* ```ts
+	* \@MessageContextMenuRoute('Report Message', 'Pin Message')
+	* class MessageTools extends MessageContextMenuHandler<'Report Message' | 'Pin Message'> {
+	*     async execute() {
+	*         await this.match({
+	*             'Report Message': (message) => this.report(message),
+	*             'Pin Message': (message) => message.pin()
+	*         });
+	*     }
+	* }
+	* ```
+	*/
+	async match(arms) {
+		return await armFor(arms, this.event.commandName)(this.target);
+	}
 };
 
 //#endregion
@@ -890,7 +966,7 @@ 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 SeedcordError(SeedcordErrorCode.AutocompleteMatchArmMissing, [name]);
+		if (!arm) throw new SeedcordTypeError(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. */
@@ -980,7 +1056,7 @@ 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 SeedcordError(SeedcordErrorCode.CustomIdMatchArmMissing, [prefix]);
+		if (!arm) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdMatchArmMissing, [prefix]);
 		return await arm(params);
 	}
 };
@@ -1018,8 +1094,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`, and reply through the handler members. Discord forbids opening a modal in
-* response to a modal, so `showModal` fails compilation on this kind.
+* inputs from `this.fields`. Reply through the handler members. `showModal` fails compilation on this kind,
+* because Discord forbids opening a modal in response to a modal.
 *
 * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof ConfigId]`.
 * @typeParam Cache - The interaction cache state, `'cached'` by default.
@@ -1030,13 +1106,17 @@ var ButtonHandler = class extends ComponentHandler {};
 * class ConfigModal extends ModalHandler<[typeof ConfigId]> {
 *     async execute() {
 *         const { guildId } = this.params;
-*         const name = this.event.fields.getTextInputValue('name');
+*         const name = this.fields.getTextInputValue('name');
 *         await this.reply(`saved ${name} for ${guildId}`);
 *     }
 * }
 * ```
 */
 var ModalHandler = class extends ComponentHandler {
+	/** The fields this modal submitted, read by custom id. */
+	get fields() {
+		return this.event.fields;
+	}
 	/** Rewrite the message this modal was opened from. Throws when a command opened the modal. */
 	update(response) {
 		this.ensureSourceMessage("update");
@@ -1058,10 +1138,12 @@ var ModalHandler = class extends ComponentHandler {
 /**
 * Base class for a select menu handler.
 *
-* 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, and reply through the handler members or rewrite the source message
-* with `this.update`.
+* Pass the select kind first and the customId definitions second, the same order as `@SelectMenuRoute`.
+* Read the picked ids from `this.values`. The kind decides which of `this.users`, `this.members`,
+* `this.roles`, and `this.channels` this handler carries. The rest are `never`.
+*
+* 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`.
 *
 * @typeParam Kind - The select kind from {@link SelectMenuKind}, e.g. `SelectMenuKind.User`.
 * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof AssignId]`.
@@ -1073,12 +1155,36 @@ var ModalHandler = class extends ComponentHandler {
 * class AssignSelect extends SelectMenuHandler<SelectMenuKind.User, [typeof AssignId]> {
 *     async execute() {
 *         const { roleId } = this.params;
-*         await this.reply(`assigning ${this.event.values.length} member(s) to <@&${roleId}>`);
+*         await this.reply(`assigning ${this.users.size} member(s) to <@&${roleId}>`);
 *     }
 * }
 * ```
 */
-var SelectMenuHandler = class extends ComponentHandler {};
+var SelectMenuHandler = class extends ComponentHandler {
+	eventMember(key) {
+		return this.event[key];
+	}
+	/** The ids this select picked. */
+	get values() {
+		return this.eventMember("values");
+	}
+	/** The users this select picked. */
+	get users() {
+		return this.eventMember("users");
+	}
+	/** The guild members behind the picked users. Discord resolves these only inside a guild. */
+	get members() {
+		return this.eventMember("members");
+	}
+	/** The roles this select picked. */
+	get roles() {
+		return this.eventMember("roles");
+	}
+	/** The channels this select picked. */
+	get channels() {
+		return this.eventMember("channels");
+	}
+};
 
 //#endregion
 //#region src/handlers/event/EventHandler.ts
@@ -1137,9 +1243,9 @@ var EventHandler = class extends BaseHandler {
 	*/
 	async match(arms) {
 		const name = this.firedEvent;
-		if (name === void 0) throw new SeedcordError(SeedcordErrorCode.EventMatchArmMissing, ["<no event>"]);
-		const arm = arms[name];
-		if (typeof arm !== "function") throw new SeedcordError(SeedcordErrorCode.EventMatchArmMissing, [name]);
+		if (name === void 0) throw new SeedcordTypeError(SeedcordErrorCode.EventMatchArmMissing, ["<no event>"]);
+		const arm = Object.hasOwn(arms, name) ? arms[name] : void 0;
+		if (typeof arm !== "function") throw new SeedcordTypeError(SeedcordErrorCode.EventMatchArmMissing, [name]);
 		return await arm(...this.getEvent());
 	}
 };
@@ -1208,25 +1314,33 @@ var Paginator = class extends PaginatorBase {
 	Handler;
 	constructor(config) {
 		super(config);
-		const loadPage = (ctx, n) => this.page(ctx, n);
+		const pageFor = (handler, n) => this.page(handler, n);
 		this.Handler = class Nav extends ButtonHandler {
 			async execute() {
 				await this.deferUpdate();
-				const response = await loadPage(contextOf(this.event, this.core), this.params.page);
+				const response = await pageFor(this, this.params.page);
 				await this.update(response);
 			}
 		};
 	}
 	/**
-	* Render page 0 and send it through the handler's sender, which picks reply, edit, or followUp from its
-	* ack state.
+	* Render a page as a {@link ReplyResponse} without sending anything.
+	*
+	* @param handler - The handler rendering the page, normally `this`.
+	* @param n - The zero-based page.
+	*/
+	async page(handler, n) {
+		return this.buildPage(contextOf(handler.getEvent(), handler.core), n);
+	}
+	/**
+	* Send a page through the handler's sender. The sender picks reply, edit, or followUp from its ack state.
 	*
 	* @param handler - The handler starting the paginator, normally `this`.
+	* @param n - The zero-based page to open on.
 	*/
-	async start(handler) {
-		const interaction = handler.getEvent();
-		const response = await this.page(contextOf(interaction, handler.core), 0);
-		return handler.getSender().send(response, { ephemeral: this.config.ephemeral ?? false });
+	async start(handler, n = 0) {
+		const response = await this.page(handler, n);
+		return handler.sender.send(response, { ephemeral: this.config.ephemeral ?? false });
 	}
 };
 
@@ -1239,7 +1353,7 @@ var Paginator = class extends PaginatorBase {
 *
 * @typeParam Item - The item type, inferred from the loader's return.
 */
-var ArraySource = class extends ArraySource$1 {};
+var ArraySource = class extends ArraySourceBase {};
 /**
 * A source for a large or unknown-length set you fetch one page at a time (SQL LIMIT/OFFSET, a paged API).
 * The fetcher receives the page index and the page size and reports whether a next page exists. A cursor
@@ -1248,7 +1362,7 @@ var ArraySource = class extends ArraySource$1 {};
 *
 * @typeParam Item - The item type, inferred from the fetcher's slice.
 */
-var CursorSource = class extends CursorSource$1 {};
+var CursorSource = class extends CursorSourceBase {};
 
 //#endregion
 //#region src/subscribers/index.ts
@@ -1682,7 +1796,7 @@ var EventDispatcher = class {
 		this.logger.debug(`Attaching ${paint.sky.bold(eventName)} to the client with ${paint.mute(handlerEntries?.length ?? 0)} handler(s)`);
 		this.core.bot.client.on(eventName, (...args) => {
 			if (this.draining) return;
-			this.core.bus[PublishDefault]("anyEvent", {
+			this.core.bus[PublishDefault]("eventDispatching", {
 				name: eventName,
 				args
 			});
@@ -2070,7 +2184,7 @@ var InteractionDispatcher = class {
 			const dispatch = new DispatchContext(routeIdOf(HandlerCtor) ?? routeId);
 			routeId = dispatch.routeId ?? routeId;
 			const handler = this.buildHandler(HandlerCtor, interaction, dispatch, key, !matched);
-			if (handler instanceof RepliableHandler) sender = handler.getSender();
+			if (handler instanceof RepliableHandler) sender = handler.sender;
 			const refusal = interaction.isAutocomplete() ? null : await this.gateRefusal(HandlerCtor, interaction, dispatch.routeId);
 			if (refusal) {
 				await this.answer(refusal.caught, interaction, routeId, sender, report);
@@ -2212,117 +2326,117 @@ const DISPATCH_DRAIN_TIMEOUT_MS = 5e3;
 const DRAIN_TASK_TIMEOUT_MS = 6e3;
 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`.
 */
-const loggerSlot = Symbol("seedcord:bot:logger");
 var Bot = class {
-	logger = new Logger("Bot", { channel: "bot" });
+	#logger = new Logger("Bot", { channel: "bot" });
 	/** @internal */
-	[loggerSlot] = this.logger;
-	isInitialized = false;
-	intents;
-	_client;
-	interactions;
-	events;
-	emojiInjector;
-	commandRegistry;
+	[loggerSlot] = this.#logger;
+	#isInitialized = false;
+	#intents;
+	#client;
+	#emojiInjector;
+	#interactions;
+	#events;
+	#commandRegistry;
 	/** @internal */
 	async onHmr(event) {
-		if (this.interactions) await this.interactions.onHmr(event);
-		if (this.events) await this.events.onHmr(event);
-		if (this.commandRegistry) await this.commandRegistry.onHmr(event);
+		if (this.#interactions) await this.#interactions.onHmr(event);
+		if (this.#events) await this.#events.onHmr(event);
+		if (this.#commandRegistry) await this.#commandRegistry.onHmr(event);
 	}
 	/** @internal */
 	constructor(core) {
-		this.intents = core.config.bot.clientOptions.intents;
-		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);
-		const commandsDir = core.config.bot.commands.path;
-		if (commandsDir) {
-			const injector = new CommandInjector();
-			const registry = new CommandRegistry({
-				dir: commandsDir,
-				rest: this._client.rest,
-				applicationId: () => this.applicationId(),
-				onDeployed: (result) => {
-					injector.inject(result, registry.allCommands());
-				}
-			});
-			this.commandRegistry = registry;
-		}
-		this.emojiInjector = new EmojiInjector(core);
-		this.registerShutdownTasks(core);
+		this.#intents = core.config.bot.clientOptions.intents;
+		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);
+		if (core.config.bot.commands.path) this.#commandRegistry = new CommandRegistry(core);
+		this.#emojiInjector = new EmojiInjector(core);
+		this.#registerShutdownTasks(core);
+	}
+	/** @internal */
+	get [controllersSlot]() {
+		return {
+			interactions: this.#interactions,
+			events: this.#events,
+			commandRegistry: this.#commandRegistry
+		};
 	}
-	applicationId() {
-		const { application } = this._client;
+	/** @internal */
+	get applicationId() {
+		const { application } = this.#client;
 		if (!application) throw new SeedcordError(SeedcordErrorCode.CoreApplicationUnavailable);
 		return application.id;
 	}
-	registerShutdownTasks(core) {
+	#registerShutdownTasks(core) {
 		core.shutdown.addTask(ShutdownPhase.Unbind, "stop-dispatch", () => {
-			this.stopAccepting();
+			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);
+		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();
+	#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)]);
+	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;
+	async [initSlot]() {
+		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) {
-			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());
+		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) {
+			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());
 		}
 	}
-	/** @internal */
-	async stop() {
-		this._client.removeAllListeners();
-		await this.logout();
+	async #stop() {
+		this.#client.removeAllListeners();
+		await this.#logout();
 	}
-	async login(token) {
+	async #login(token) {
 		const ready = Promise.withResolvers();
-		this._client.once(Events.ClientReady, () => ready.resolve());
-		this._client.login(token);
+		this.#client.once(Events.ClientReady, () => ready.resolve());
+		this.#client.login(token);
 		await ready.promise;
-		this.logger.info(`Logged in as ${paint.sky.bold(this._client.user?.username)}!`);
+		this.#logger.info(`Logged in as ${paint.sky.bold(this.#client.user?.username)}!`);
 		return this;
 	}
-	async logout() {
-		await this._client.destroy();
-		this.logger.info(paint.coral.bold("Logged out of Discord!"));
+	async #logout() {
+		await this.#client.destroy();
+		this.#logger.info(paint.coral.bold("Logged out of Discord!"));
 	}
 	get client() {
-		return this._client;
+		return this.#client;
 	}
 };
 __decorate([Envapt("DISCORD_BOT_TOKEN", { converter: (raw) => validateDiscordToken(raw) })], Bot.prototype, "botToken", void 0);
-/** @internal */
 function botLoggerOf(bot) {
 	return bot[loggerSlot];
 }
+function initBot(bot) {
+	return bot[initSlot]();
+}
 
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.3.0";
+const version = "0.4.0";
 
 //#endregion
 //#region src/Seedcord.ts
@@ -2335,9 +2449,9 @@ var Seedcord = class Seedcord extends Pluggable {
 	/** @internal */
 	[SeedcordBrand] = true;
 	/** @internal */
-	augmentTarget = "@seedcord/gateway";
+	[HostAugmentTarget] = "@seedcord/gateway";
 	/** @internal */
-	version = version;
+	[HostVersion] = version;
 	healthCheck;
 	hmrManager;
 	/** @see {@link Bus} */
@@ -2347,6 +2461,10 @@ var Seedcord = class Seedcord extends Pluggable {
 	bot;
 	/** The discord.js client's REST client. Its token is set during the Login phase. */
 	rest;
+	/** The bot's Discord application id. Throws if you read it before login. */
+	get applicationId() {
+		return this.bot.applicationId;
+	}
 	/** @see {@link IRateLimiter} */
 	rateLimiter;
 	/**
@@ -2365,16 +2483,17 @@ var Seedcord = class Seedcord extends Pluggable {
 		this.bot = new Bot(this);
 		this.rest = this.bot.client.rest;
 		this.rateLimiter = config.store ?? new MemoryRateLimiter();
-		this.healthCheck = HealthCheck.fromOption(this.shutdown, config.healthCheck);
+		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() {
-		super.reset();
+	static reset(host) {
+		if (!super.reset(host)) return false;
 		LoggerChannelRegistry.instance.configure({});
+		return true;
 	}
 	registerStartupTasks() {
 		if (Envapter.isDevelopment || Envapter.isTest) this.registerHmrAwareModules();
@@ -2385,7 +2504,7 @@ var Seedcord = class Seedcord extends Pluggable {
 		});
 		this.startup.addTask(StartupPhase.Login, "bot-initialization", async () => {
 			botLoggerOf(this.bot).utils.initialization("Bot", "start");
-			await this.bot.init();
+			await initBot(this.bot);
 			botLoggerOf(this.bot).utils.initialization("Bot", "end");
 		});
 		const { healthCheck } = this;
@@ -2404,8 +2523,8 @@ var Seedcord = class Seedcord extends Pluggable {
 		try {
 			await super.init();
 		} catch (caught) {
-			await this.shutdown.run(1, false);
-			Seedcord.reset();
+			await shutdownOf(this).run(1, false);
+			Seedcord.reset(this);
 			throw caught;
 		}
 		return this;
@@ -2421,5 +2540,5 @@ var Seedcord = class Seedcord extends Pluggable {
 };
 
 //#endregion
-export { ArraySource, AutocompleteHandler, BaseHandler, ButtonHandler, ComponentHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, GatewayEmoji, IgnoreBots, InteractionHandler, InteractionMiddleware, MessageContextMenuHandler, Middleware, MiddlewareType, ModalHandler, Nsfw, Paginator, Plugin, RegisterEvent, RepliableHandler, Seedcord, SelectMenuHandler, SlashHandler, Subscriber, UserContextMenuHandler, WebhookLog, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
+export { ArraySource, AutocompleteHandler, BaseHandler, ButtonHandler, ComponentHandler, CursorSource, Emojis, EventHandler, EventMiddleware, Gated, GatewayEmoji, IgnoreBots, InteractionHandler, InteractionMiddleware, MessageContextMenuHandler, Middleware, MiddlewareType, ModalHandler, Nsfw, Paginator, Plugin, RegisterEvent, RepliableHandler, ReplySender, Seedcord, SelectMenuHandler, SlashHandler, Subscriber, UserContextMenuHandler, WebhookLog, WinstonConsoleSink, WinstonFileSink, checkBotPermissions, checkPermissions, getConfirmation, hasPermsToAssign, version };
 //# sourceMappingURL=index.mjs.map