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

package/dist/index.cjs

@@ -38,16 +38,16 @@ let _seedcord_utils_internal = require("@seedcord/utils/internal");
 let discord_js = require("discord.js");
 let node_crypto = require("node:crypto");
 node_crypto = __toESM(node_crypto, 1);
-let _seedcord_event_emitter = require("@seedcord/event-emitter");
 let chalk = require("chalk");
 chalk = __toESM(chalk, 1);
 let envapt = require("envapt");
 let discord_api_types_v10 = require("discord-api-types/v10");
 let _seedcord_utils = require("@seedcord/utils");
 let _discordjs_rest = require("@discordjs/rest");
-let _seedcord_core_node = require("@seedcord/core/node");
+let _seedcord_core_node_internal = require("@seedcord/core/node/internal");
 let _seedcord_rate_limiter = require("@seedcord/rate-limiter");
 let _seedcord_types_internal = require("@seedcord/types/internal");
+let _seedcord_event_emitter = require("@seedcord/event-emitter");
 let envapt_legacy = require("envapt/legacy");
 let node_path = require("node:path");
 let _seedcord_core_hmr = require("@seedcord/core/hmr");
@@ -1142,112 +1142,6 @@ async function getConfirmation(interaction, prompt, options) {
 	return confirmed;
 }
 
-//#endregion
-//#region src/interfaces/Plugin.ts
-/**
-* Base class for Seedcord plugins
-*
-* Extend this class to create plugins that integrate with the Seedcord lifecycle.
-* Plugins have access to the core instance and must implement initialization logic.
-*/
-var Plugin = class extends _seedcord_event_emitter.TypedEventEmitter {
-	pluggable;
-	name = this.constructor.name;
-	constructor(pluggable) {
-		super();
-		this.pluggable = pluggable;
-	}
-	/**
-	* Reloads plugin state on an HMR update. The base implementation is a no-op, override it in your plugin.
-	* @virtual
-	*/
-	onHmr(_event) {
-		return Promise.resolve();
-	}
-	/**
-	* Registers critical file patterns that should trigger a full restart when changed in Dev HMR.
-	* @param patterns - Glob patterns relative to the project root
-	*/
-	registerCriticalFiles(patterns) {
-		(0, _seedcord_core_internal.getDevChannel)()?.send("seedcord:register-critical-files", { patterns });
-	}
-	/** @internal */
-	removeListener(event, listener) {
-		return super.removeListener(event, listener);
-	}
-	/** @internal */
-	removeAllListeners(event) {
-		return super.removeAllListeners(event);
-	}
-};
-/**
-* Base class for objects that can have plugins attached.
-*
-* Provides plugin attachment capabilities and lifecycle management. Plugins are attached during
-* configuration and initialized during startup. Not constructed directly, the host is a {@link Seedcord}.
-*/
-var Pluggable = class Pluggable extends _seedcord_event_emitter.TypedEventEmitter {
-	isInitialized = false;
-	shutdown;
-	startup;
-	plugins = [];
-	static PLUGIN_INIT_TIMEOUT_MS = 15e3;
-	constructor(shutdown, startup) {
-		super();
-		this.shutdown = shutdown;
-		this.startup = startup;
-	}
-	/** @internal */
-	async init() {
-		if (this.isInitialized) return this;
-		await this.startup.run();
-		this.isInitialized = true;
-		return this;
-	}
-	/**
-	* Attaches a plugin to this instance
-	*
-	* Plugins provide external functionality and are initialized during the specified startup phase.
-	* The plugin instance becomes available as a property in `core` wherever it's available.
-	*
-	* Make sure to augment the {@link Core} interface with the plugin type to ensure TypeScript recognizes it and provides intellisense.
-	*
-	* @typeParam Key - The property name for accessing the plugin
-	* @typeParam Ctor - The plugin constructor type
-	* @param key - Property name to access the plugin instance
-	* @param Plugin - Plugin constructor class
-	* @param startupPhase - When during startup to initialize this plugin ({@link StartupPhase})
-	* @param args - Additional arguments to pass to the plugin constructor
-	* @returns This instance with the plugin attached as a typed property
-	* @throws A **SeedcordError** When called after initialization or if key already exists
-	* @example
-	* ```typescript
-	* seedcord.attach('db', Mongo, StartupPhase.Configuration, { uri: 'mongodb://...', name: 'seedcord', dir: ... })
-	* ```
-	*/
-	attach(key, Plugin, startupPhase, ...args) {
-		if (this.isInitialized) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CorePluginAfterInit);
-		if (key in this) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CorePluginKeyExists, [key]);
-		const instance = new Plugin(this, ...args);
-		this.plugins.push(instance);
-		const entry = { [key]: instance };
-		this.startup.addTask(startupPhase, `Plugin:${key}`, async () => {
-			instance.logger.utils.initialization(key, "start");
-			await instance.init();
-			instance.logger.utils.initialization(key, "end");
-		}, Pluggable.PLUGIN_INIT_TIMEOUT_MS);
-		return Object.assign(this, entry);
-	}
-	/** @internal */
-	removeListener(event, listener) {
-		return super.removeListener(event, listener);
-	}
-	/** @internal */
-	removeAllListeners(event) {
-		return super.removeAllListeners(event);
-	}
-};
-
 //#endregion
 //#region src/handlers/BaseHandler.ts
 /**
@@ -2293,7 +2187,6 @@ function slashRouteLeaves(commands) {
 var CommandRegistry = class {
 	core;
 	onDeployed;
-	name = "Commands";
 	logger = new _seedcord_logger.Logger("Commands");
 	isInitialised = false;
 	globalCommands = [];
@@ -2589,11 +2482,12 @@ var EventDispatcher = class {
 	core;
 	logger = new _seedcord_logger.Logger("Events");
 	isInitialized = false;
-	name = "Events";
 	eventMap = /* @__PURE__ */ new Map();
 	middlewares = [];
 	executedOnceHandlers = /* @__PURE__ */ new Set();
 	attachedEvents = /* @__PURE__ */ new Set();
+	inFlight = /* @__PURE__ */ new Set();
+	draining = false;
 	loading = false;
 	loadedHandlers = [];
 	loadedMiddlewares = [];
@@ -2762,15 +2656,22 @@ var EventDispatcher = class {
 		const handlerEntries = this.eventMap.get(eventName);
 		this.logger.debug(`Attaching ${_seedcord_logger.paint.mint.bold(eventName)} to the client with ${_seedcord_logger.paint.mute(handlerEntries?.length ?? 0)} handler(s)`);
 		this.core.bot.client.on(eventName, (...args) => {
+			if (this.draining) return;
 			this.core.bot.emitSafe("any:event", eventName, ...args);
-			(async () => {
-				await this.processEvent(eventName, args).catch((err) => {
-					this.logger.error(`[${_seedcord_logger.paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
-					this.core.bot.emit("error:unhandled:event", err);
-				});
-			})();
+			const run = this.processEvent(eventName, args).catch((err) => {
+				this.logger.error(`[${_seedcord_logger.paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
+				this.core.bot.emit("error:unhandled:event", err);
+			});
+			this.inFlight.add(run);
+			run.finally(() => this.inFlight.delete(run));
 		});
 	}
+	stopAccepting() {
+		this.draining = true;
+	}
+	drain(timeoutMs) {
+		return (0, _seedcord_core_node_internal.settleWithin)(Promise.allSettled(this.inFlight), timeoutMs);
+	}
 	async processEvent(eventName, args) {
 		const handlerEntries = this.eventMap.get(eventName);
 		if (!handlerEntries || handlerEntries.length === 0) return;
@@ -2896,7 +2797,6 @@ var InteractionDispatcher = class {
 	core;
 	logger = new _seedcord_logger.Logger("Interactions");
 	isInitialized = false;
-	name = "Interactions";
 	slashMap = /* @__PURE__ */ new Map();
 	buttonMap = /* @__PURE__ */ new Map();
 	modalMap = /* @__PURE__ */ new Map();
@@ -2910,6 +2810,8 @@ var InteractionDispatcher = class {
 	autocompleteMap = /* @__PURE__ */ new Map();
 	keysToIgnore = /* @__PURE__ */ new Set();
 	middlewares = [];
+	inFlight = /* @__PURE__ */ new Set();
+	draining = false;
 	loading = false;
 	loadedHandlers = [];
 	loadedMiddlewares = [];
@@ -3110,13 +3012,22 @@ var InteractionDispatcher = class {
 	}
 	attachToClient() {
 		this.core.bot.client.on(discord_js.Events.InteractionCreate, (interaction) => {
+			if (this.draining) return;
 			this.core.bot.emitSafe("any:interaction", interaction);
-			this.handleInteraction(interaction).catch((err) => {
+			const run = this.handleInteraction(interaction).catch((err) => {
 				this.logger.error(`[${_seedcord_logger.paint.coral.bold("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
 				this.core.bot.emit("error:unhandled:interaction", err);
 			});
+			this.inFlight.add(run);
+			run.finally(() => this.inFlight.delete(run));
 		});
 	}
+	stopAccepting() {
+		this.draining = true;
+	}
+	drain(timeoutMs) {
+		return (0, _seedcord_core_node_internal.settleWithin)(Promise.allSettled(this.inFlight), timeoutMs);
+	}
 	async handleCustomIdInteraction(interaction, getMap, interactionType) {
 		if ([...this.keysToIgnore].some((matcher) => matcher.owns(interaction.customId))) return;
 		const prefix = (0, _seedcord_core_internal.prefixOf)(interaction.customId);
@@ -3244,23 +3155,25 @@ function __decorate(decorators, target, key, desc) {
 
 //#endregion
 //#region src/bot/Bot.ts
+const DISPATCH_DRAIN_TIMEOUT_MS = 5e3;
+const DRAIN_TASK_TIMEOUT_MS = 6e3;
+const UNBIND_TIMEOUT_MS = 2e3;
+const LOGOUT_TIMEOUT_MS = 2e3;
 /**
-* Discord bot implementation that manages client and controllers
-*
-* Don't instantiate this class directly. Use `core.bot` instead.
+* The Discord client and its controllers. Access it through `core.bot`.
 */
-var Bot = class extends Plugin {
+var Bot = class extends _seedcord_event_emitter.TypedEventEmitter {
 	/** @internal */
 	logger = new _seedcord_logger.Logger("Bot");
 	isInitialized = false;
 	_client;
 	interactions;
 	events;
-	commands;
 	emojiInjector;
+	commands;
 	emojis = Emojis;
 	mentions = CommandMentions;
-	/** @internal For use in dev mode */
+	/** @internal */
 	async onHmr(event) {
 		if (this.interactions) await this.interactions.onHmr(event);
 		if (this.events) await this.events.onHmr(event);
@@ -3268,7 +3181,7 @@ var Bot = class extends Plugin {
 	}
 	/** @internal */
 	constructor(core) {
-		super(core);
+		super();
 		this._client = new discord_js.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);
@@ -3279,12 +3192,24 @@ var Bot = class extends Plugin {
 			});
 		}
 		this.emojiInjector = new EmojiInjector(core);
-		core.shutdown.addTask(_seedcord_core_node.ShutdownPhase.DiscordCleanup, "stop-bot", async () => await this.stop(), 2e3);
+		this.registerShutdownTasks(core);
 	}
-	/**
-	* Initializes Discord client and all controllers
-	* @internal
-	*/
+	registerShutdownTasks(core) {
+		core.shutdown.addTask(_seedcord_core_node_internal.ShutdownPhase.Unbind, "stop-dispatch", () => {
+			this.stopAccepting();
+			return Promise.resolve();
+		}, UNBIND_TIMEOUT_MS);
+		core.shutdown.addTask(_seedcord_core_node_internal.ShutdownPhase.Drain, "drain-dispatch", () => this.drain(), DRAIN_TASK_TIMEOUT_MS);
+		core.shutdown.addTask(_seedcord_core_node_internal.ShutdownPhase.Logout, "stop-bot", async () => await this.stop(), LOGOUT_TIMEOUT_MS);
+	}
+	stopAccepting() {
+		this.interactions?.stopAccepting();
+		this.events?.stopAccepting();
+	}
+	async drain() {
+		await Promise.allSettled([this.interactions?.drain(DISPATCH_DRAIN_TIMEOUT_MS), this.events?.drain(DISPATCH_DRAIN_TIMEOUT_MS)]);
+	}
+	/** @internal */
 	async init() {
 		if (this.isInitialized) return;
 		this.isInitialized = true;
@@ -3300,17 +3225,11 @@ var Bot = class extends Plugin {
 			this.interactions?.warnUnhandledContextMenuRoutes(this.commands.contextMenuLeaves());
 		}
 	}
-	/**
-	* Stops the bot and cleans up connections
-	* @internal
-	*/
+	/** @internal */
 	async stop() {
 		this._client.removeAllListeners();
 		await this.logout();
 	}
-	/**
-	* Logs the bot into Discord using the configured token
-	*/
 	async login(token) {
 		this._client.once(discord_js.Events.ClientReady, () => this.emit("ready"));
 		this._client.login(token);
@@ -3318,9 +3237,6 @@ var Bot = class extends Plugin {
 		this.logger.info(`Logged in as ${chalk.default.bold.magenta(this._client.user?.username)}!`);
 		return this;
 	}
-	/**
-	* Logs out and destroys the Discord client connection
-	*/
 	async logout() {
 		await this._client.destroy();
 		this.logger.info(chalk.default.bold.red("Logged out of Discord!"));
@@ -3328,6 +3244,12 @@ var Bot = class extends Plugin {
 	get client() {
 		return this._client;
 	}
+	/**
+	* The overloads enforce the key/args correlation at compile time only. At runtime this forwards
+	* straight to the underlying TypedEventEmitter.
+	*
+	* @internal
+	*/
 	emit(event, ...args) {
 		return super.emit(event, ...args);
 	}
@@ -3421,18 +3343,16 @@ var UnhandledErrorContainer = class extends _seedcord_core.BuilderComponent {
 * Registers and dispatches subscribers. Subscribers load from the configured directories and run
 * on a programmatic or framework-event publish. Accessed via `core.bus`. Do not construct it directly.
 */
-var Bus = class extends Plugin {
+var Bus = class extends _seedcord_event_emitter.TypedEventEmitter {
 	core;
 	logger = new _seedcord_logger.Logger("Subscribers");
-	/** @internal */
-	name = "Subscribers";
 	isInitialized = false;
 	subscribersMap = /* @__PURE__ */ new Map();
 	executedOnceHandlers = /* @__PURE__ */ new Set();
 	webhookProbes = /* @__PURE__ */ new Map();
 	hmrHandler;
 	constructor(core) {
-		super(core);
+		super();
 		this.core = core;
 		if (this.core.config.subscribers.path) {
 			if (!envapt.Envapter.isDevelopment && !envapt.Envapter.isTest) return;
@@ -3561,17 +3481,15 @@ var Bus = class extends Plugin {
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.0-next.3";
+const version = "0.1.0-next.4";
 
 //#endregion
 //#region src/Seedcord.ts
 /**
-* Main Seedcord bot framework class
-*
-* Primary entry point for creating Discord bots with Seedcord.
-* Manages component lifecycle and provides plugin support.
+* The gateway bot host. Opens a discord.js gateway session, discovers handlers, and runs
+* coordinated startup and shutdown. Attach plugins with `attach()`.
 */
-var Seedcord = class Seedcord extends Pluggable {
+var Seedcord = class Seedcord extends _seedcord_core_node_internal.Pluggable {
 	config;
 	/** @internal */
 	[_seedcord_types_internal.SeedcordBrand] = true;
@@ -3579,7 +3497,6 @@ var Seedcord = class Seedcord extends Pluggable {
 	augmentTarget = "@seedcord/gateway";
 	/** @internal */
 	version = version;
-	static isInstantiated = false;
 	healthCheck;
 	hmrManager;
 	/** @see {@link CoordinatedShutdown} */
@@ -3593,16 +3510,12 @@ var Seedcord = class Seedcord extends Pluggable {
 	/** @see {@link IRateLimiter} */
 	rateLimiter;
 	/**
-	* Creates a new Seedcord instance
-	*
 	* @param config - Bot configuration including paths and Discord client options
 	* @throws A **SeedcordError** When attempting to create multiple instances (singleton)
 	*/
 	constructor(config) {
-		if (Seedcord.isInstantiated) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CoreSingletonViolation);
-		Seedcord.isInstantiated = true;
-		const shutdown = new _seedcord_core_node.CoordinatedShutdown(config.shutdownEnabled);
-		const startup = new _seedcord_core_node.CoordinatedStartup();
+		const shutdown = new _seedcord_core_node_internal.CoordinatedShutdown();
+		const startup = new _seedcord_core_node_internal.CoordinatedStartup();
 		super(shutdown, startup);
 		this.config = config;
 		(0, _seedcord_logger_node.installNodeDefaults)(config.logger);
@@ -3614,46 +3527,60 @@ var Seedcord = class Seedcord extends Pluggable {
 		this.bus = new Bus(this);
 		this.bot = new Bot(this);
 		this.rateLimiter = config.store ?? new _seedcord_rate_limiter.MemoryRateLimiter();
-		this.healthCheck = new _seedcord_core_node.HealthCheck(this.shutdown, config.healthCheck);
+		this.healthCheck = _seedcord_core_node_internal.HealthCheck.fromOption(this.shutdown, config.healthCheck);
 		this.registerStartupTasks();
 	}
 	/** The bot's discord username, populated after login. */
 	get username() {
 		return this.bot.client.user?.username;
 	}
+	pluginCapabilities() {
+		return {
+			client: this.bot.client,
+			token: this.bot.botToken,
+			rest: this.bot.client.rest
+		};
+	}
 	static reset() {
-		Seedcord.isInstantiated = false;
+		super.reset();
 		_seedcord_logger.LoggerChannelRegistry.instance.reset();
 	}
 	registerStartupTasks() {
 		if (envapt.Envapter.isDevelopment || envapt.Envapter.isTest) this.registerHmrAwareModules();
-		this.startup.addTask(_seedcord_core_node.StartupPhase.Configuration, "Bus Initialization", async () => {
+		this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "Bus Initialization", async () => {
 			this.bus.logger.utils.initialization("Subscribers", "start");
 			await this.bus.init();
 			this.bus.logger.utils.initialization("Subscribers", "end");
 		});
-		this.startup.addTask(_seedcord_core_node.StartupPhase.Instantiation, "Bot Initialization", async () => {
+		this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Login, "Bot Initialization", async () => {
 			this.bot.logger.utils.initialization("Bot", "start");
 			await this.bot.init();
 			this.bot.logger.utils.initialization("Bot", "end");
 		});
-		this.startup.addTask(_seedcord_core_node.StartupPhase.Ready, "Health Check", async () => {
-			this.healthCheck.logger.utils.initialization("HealthCheck", "start");
-			await this.healthCheck.init();
-			this.healthCheck.logger.utils.initialization("HealthCheck", "end");
+		const { healthCheck } = this;
+		if (healthCheck) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Ready, "Health Check", async () => {
+			healthCheck.logger.utils.initialization("HealthCheck", "start");
+			await healthCheck.init();
+			healthCheck.logger.utils.initialization("HealthCheck", "end");
 		});
 	}
 	/**
 	* Starts the bot and runs all initialization tasks
 	*
-	* @returns This Seedcord instance when fully initialized
+	* @returns This Seedcord instance when initialized
 	*/
 	async start() {
-		await super.init();
+		try {
+			await super.init();
+		} catch (caught) {
+			await this.shutdown.run(1, false);
+			Seedcord.reset();
+			throw caught;
+		}
 		return this;
 	}
 	registerHmrAwareModules() {
-		this.startup.addTask(_seedcord_core_node.StartupPhase.Configuration, "HMR Registration", async () => {
+		this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "HMR Registration", async () => {
 			this.hmrManager.register(this.bot);
 			this.hmrManager.register(this.bus);
 			for (const plugin of this.plugins) this.hmrManager.register(plugin);
@@ -3681,25 +3608,11 @@ exports.MiddlewareType = MiddlewareType;
 exports.ModalHandler = ModalHandler;
 exports.Nsfw = Nsfw;
 exports.Paginator = Paginator;
-exports.Pluggable = Pluggable;
-exports.Plugin = Plugin;
 exports.RegisterEvent = RegisterEvent;
 exports.RepliableHandler = RepliableHandler;
 exports.Seedcord = Seedcord;
 exports.SelectMenuHandler = SelectMenuHandler;
-Object.defineProperty(exports, 'ShutdownPhase', {
-  enumerable: true,
-  get: function () {
-    return _seedcord_core_node.ShutdownPhase;
-  }
-});
 exports.SlashHandler = SlashHandler;
-Object.defineProperty(exports, 'StartupPhase', {
-  enumerable: true,
-  get: function () {
-    return _seedcord_core_node.StartupPhase;
-  }
-});
 exports.Subscribe = Subscribe;
 exports.Subscriber = Subscriber;
 exports.WebhookLog = WebhookLog;