@seedcord/core 0.1.0-next.4 → 0.1.0-next.5

package/dist/node.index.mjs

@@ -0,0 +1,513 @@
+import { SeedcordErrorCode } from "@seedcord/errors";
+import { SeedcordError } from "@seedcord/errors/internal";
+import { Logger } from "@seedcord/logger";
+import chalk from "chalk";
+import { TypedEventEmitter } from "@seedcord/event-emitter";
+import { createServer } from "node:http";
+
+//#region src/node/Lifecycle/CoordinatedLifecycle.ts
+/**
+* Abstract base class for coordinated lifecycle management (startup/shutdown)
+*/
+var CoordinatedLifecycle = class extends TypedEventEmitter {
+	phaseOrder;
+	phaseEnum;
+	logger;
+	tasksMap = /* @__PURE__ */ new Map();
+	constructor(loggerName, phaseOrder, phaseEnum) {
+		super();
+		this.phaseOrder = phaseOrder;
+		this.phaseEnum = phaseEnum;
+		this.logger = new Logger(loggerName);
+		this.phaseOrder.forEach((phase) => this.tasksMap.set(phase, []));
+	}
+	/**
+	* Adds a lifecycle task to a specific phase.
+	*
+	* Tasks are executed in phase order during lifecycle operations.
+	* Each task has a timeout to prevent hanging operations.
+	*
+	* @param phase - The lifecycle phase to add the task to
+	* @param taskName - Unique name for the task (used for logging and removal)
+	* @param task - Async function to execute during the phase
+	* @param timeoutMs - Maximum time allowed for task execution in milliseconds
+	* @example
+	* ```typescript
+	* lifecycle.addTask(StartupPhase.Services, 'start-database', async () => {
+	*   await database.connect();
+	* }, 10000);
+	* ```
+	*/
+	addTask(phase, taskName, task, timeoutMs) {
+		if (!this.canAddTask()) return;
+		const tasks = this.tasksMap.get(phase);
+		if (!tasks) throw new SeedcordError(SeedcordErrorCode.LifecycleUnknownPhase, [phase]);
+		tasks.push({
+			name: taskName,
+			task,
+			timeout: timeoutMs
+		});
+		this.logger.debug(`${chalk.italic("Added")} ${this.getTaskType()} task ${chalk.bold.cyan(taskName)} to phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);
+	}
+	/**
+	* Removes a lifecycle task from a specific phase.
+	*
+	* @param phase - The lifecycle phase to remove the task from
+	* @param taskName - Name of the task to remove
+	* @returns True if the task was found and removed, false otherwise
+	*/
+	removeTask(phase, taskName) {
+		if (!this.canRemoveTask()) return false;
+		const tasks = this.tasksMap.get(phase);
+		if (!tasks) return false;
+		const initialLength = tasks.length;
+		const filteredTasks = tasks.filter((task) => task.name !== taskName);
+		this.tasksMap.set(phase, filteredTasks);
+		const removed = initialLength !== filteredTasks.length;
+		if (removed) this.logger.debug(`${chalk.italic("Removed")} ${this.getTaskType()} task ${chalk.bold.cyan(taskName)} from phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);
+		return removed;
+	}
+	/**
+	* Run all tasks in a specific phase
+	*/
+	async runPhase(phase) {
+		const tasks = this.tasksMap.get(phase) ?? [];
+		if (tasks.length === 0) {
+			this.logger.warn(`No tasks to run in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);
+			return;
+		}
+		this.logger.info(`${chalk.bold.yellow("Running")} ${this.getTaskType()} phase ${chalk.bold.magenta(this.phaseEnum[phase])} with ${chalk.bold.cyan(tasks.length)} tasks`);
+		this.emitPhase(phase, "start");
+		const failures = (await this.executeTasksInPhase(phase, tasks)).filter((r) => r.status === "rejected").length;
+		if (failures > 0) throw new SeedcordError(SeedcordErrorCode.LifecyclePhaseFailures, [this.phaseEnum[phase], failures]);
+		this.logger.info(`Phase ${chalk.bold.magenta(this.phaseEnum[phase])} ${chalk.bold.green("completed successfully")}`);
+		this.emitPhase(phase, "complete");
+	}
+	/**
+	* Run a single task with timeout
+	*/
+	async runTaskWithTimeout(phase, task) {
+		this.logger.info(`${chalk.italic("Starting")} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);
+		let timeoutId;
+		try {
+			await Promise.race([task.task(), new Promise((_, reject) => {
+				timeoutId = setTimeout(() => {
+					reject(new SeedcordError(SeedcordErrorCode.LifecycleTaskTimeout, [task.name, task.timeout]));
+				}, task.timeout);
+			})]);
+			this.logger.info(`${chalk.italic("Completed")} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);
+		} catch (error) {
+			this.logger.error(`${chalk.italic("Failed")} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}:`, error);
+			throw error;
+		} finally {
+			if (timeoutId) clearTimeout(timeoutId);
+		}
+	}
+	emitPhase(phase, action) {
+		this.emitSafeRaw(`phase:${phase}:${action}`);
+	}
+	onListenerError(error, event) {
+		this.logger.error(`listener for ${String(event)} threw`, error);
+	}
+};
+
+//#endregion
+//#region src/node/Lifecycle/CoordinatedShutdown.ts
+/**
+* Shutdown phases for coordinated application shutdown.
+*/
+let ShutdownPhase = /* @__PURE__ */ function(ShutdownPhase) {
+	/** Stop accepting new requests/interactions */
+	ShutdownPhase[ShutdownPhase["StopAcceptingRequests"] = 1] = "StopAcceptingRequests";
+	/** Stop background services (health checks, etc.) */
+	ShutdownPhase[ShutdownPhase["StopServices"] = 2] = "StopServices";
+	/** Disconnect from external resources (database, APIs) */
+	ShutdownPhase[ShutdownPhase["ExternalResources"] = 3] = "ExternalResources";
+	/** Disconnect from Discord */
+	ShutdownPhase[ShutdownPhase["DiscordCleanup"] = 4] = "DiscordCleanup";
+	/** Final cleanup tasks */
+	ShutdownPhase[ShutdownPhase["FinalCleanup"] = 5] = "FinalCleanup";
+	return ShutdownPhase;
+}({});
+/** Define the order of phases */
+const PHASE_ORDER$1 = [
+	1,
+	2,
+	3,
+	4,
+	5
+];
+const LOG_FLUSH_DELAY_MS = 500;
+/**
+* CoordinatedShutdown manages graceful application shutdown by executing registered tasks across defined phases.
+*
+* It listens for termination signals (SIGINT, SIGTERM) and runs tasks in parallel within each phase.
+* Tasks can be added or removed dynamically, and each task has an associated timeout.
+*/
+var CoordinatedShutdown = class extends CoordinatedLifecycle {
+	isShutdownEnabled;
+	isShuttingDown = false;
+	exitCode = 0;
+	onSigTerm = null;
+	onSigInt = null;
+	constructor(enabled = true) {
+		super("Shutdown", PHASE_ORDER$1, ShutdownPhase);
+		this.isShutdownEnabled = enabled;
+		this.registerSignalHandlers();
+	}
+	canAddTask() {
+		return this.isShutdownEnabled;
+	}
+	canRemoveTask() {
+		return true;
+	}
+	getTaskType() {
+		return "shutdown";
+	}
+	async executeTasksInPhase(phase, tasks) {
+		const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));
+		return Promise.allSettled(promises);
+	}
+	registerSignalHandlers() {
+		if (!this.isShutdownEnabled) return;
+		this.onSigTerm = () => {
+			this.logger.info(`Received ${chalk.yellow.bold("SIGTERM")} signal`);
+			this.run(0);
+		};
+		this.onSigInt = () => {
+			this.logger.info(`Received ${chalk.yellow.bold("SIGINT")} signal`);
+			this.run(0);
+		};
+		process.on("SIGTERM", this.onSigTerm);
+		process.on("SIGINT", this.onSigInt);
+	}
+	removeSignalHandlers() {
+		if (this.onSigTerm) {
+			process.off("SIGTERM", this.onSigTerm);
+			this.onSigTerm = null;
+		}
+		if (this.onSigInt) {
+			process.off("SIGINT", this.onSigInt);
+			this.onSigInt = null;
+		}
+	}
+	/**
+	* Adds a task to a specific shutdown phase with timeout.
+	*
+	* @param phase - The shutdown phase from {@link ShutdownPhase}
+	* @param taskName - Unique identifier for the task
+	* @param task - Async function to execute
+	* @param timeoutMs - Task timeout in milliseconds. {@default `5000`}
+	*/
+	addTask(phase, taskName, task, timeoutMs = 5e3) {
+		super.addTask(phase, taskName, task, timeoutMs);
+	}
+	/**
+	* Removes a task from a specific shutdown phase.
+	*
+	* @param phase - The shutdown phase to remove from
+	* @param taskName - Name of the task to remove
+	* @returns True if task was found and removed
+	*/
+	removeTask(phase, taskName) {
+		return super.removeTask(phase, taskName);
+	}
+	/**
+	* Executes the coordinated shutdown sequence.
+	*
+	* Runs all registered tasks across shutdown phases in reverse order.
+	* Tasks within each phase are executed in parallel for faster shutdown.
+	* Process exits with the specified code when complete.
+	*
+	* @param exitCode - Process exit code. {@default `0`}
+	* @param exitProcess - Whether to exit the process after shutdown. {@default `true`}
+	* @returns Promise that resolves when shutdown is complete
+	* @example
+	* ```typescript
+	* shutdown.addTask(ShutdownPhase.Services, 'database', () => db.disconnect(), 5000);
+	* await shutdown.run(0); // Graceful shutdown
+	* ```
+	*/
+	async run(exitCode = 0, exitProcess = true) {
+		this.removeSignalHandlers();
+		if (this.isShuttingDown) {
+			this.logger.warn("Shutdown sequence already in progress");
+			return;
+		}
+		this.isShuttingDown = true;
+		this.exitCode = exitCode;
+		this.logger.info(`${chalk.bold.yellow("Starting")} coordinated shutdown with exit code ${chalk.bold.cyan(exitCode)}`);
+		this.emitSafe("shutdown:start");
+		try {
+			for (const phase of PHASE_ORDER$1) await this.runPhase(phase);
+			this.logger.info(`${chalk.bold.green("Coordinated shutdown completed")} successfully`);
+			this.emitSafe("shutdown:complete");
+		} catch (error) {
+			this.logger.error(`${chalk.bold.red("Coordinated shutdown failed")}`);
+			this.emitSafe("shutdown:error", error);
+		} finally {
+			if (exitProcess) {
+				this.logger.info(`${chalk.bold.red("Exiting")} process with code ${chalk.bold.cyan(this.exitCode)}`);
+				setTimeout(() => {
+					process.exit(this.exitCode);
+				}, LOG_FLUSH_DELAY_MS);
+			} else {
+				this.logger.info(`${chalk.bold.yellow("Skipping")} process exit (dev mode)`);
+				this.isShuttingDown = false;
+			}
+		}
+	}
+};
+
+//#endregion
+//#region src/node/Lifecycle/CoordinatedStartup.ts
+/**
+* Startup phases for coordinated initialization
+*
+* Defines the order in which different components are initialized during bot startup.
+*/
+let StartupPhase = /* @__PURE__ */ function(StartupPhase) {
+	/** Validate environment variables and config files */
+	StartupPhase[StartupPhase["Validation"] = 1] = "Validation";
+	/** Discover plugin constructors via decorators or registry */
+	StartupPhase[StartupPhase["Discovery"] = 2] = "Discovery";
+	/** Register plugin metadata and declared dependencies */
+	StartupPhase[StartupPhase["Registration"] = 3] = "Registration";
+	/** Inject and validate plugin-specific configuration */
+	StartupPhase[StartupPhase["Configuration"] = 4] = "Configuration";
+	/** Instantiate plugin classes with Core and arguments */
+	StartupPhase[StartupPhase["Instantiation"] = 5] = "Instantiation";
+	/** Activate plugins by calling their init/setup methods */
+	StartupPhase[StartupPhase["Activation"] = 6] = "Activation";
+	/** Mark seedcord as ready and start handling interactions */
+	StartupPhase[StartupPhase["Ready"] = 7] = "Ready";
+	return StartupPhase;
+}({});
+/** Define the order of phases */
+const PHASE_ORDER = [
+	1,
+	2,
+	3,
+	4,
+	5,
+	6,
+	7
+];
+/**
+* Manages bot startup lifecycle with ordered phases
+*
+* Coordinates initialization of all bot components in a predictable sequence.
+* Tasks are executed within their designated phases to ensure proper dependency order.
+*/
+var CoordinatedStartup = class extends CoordinatedLifecycle {
+	isStartingUp = false;
+	hasStarted = false;
+	constructor() {
+		super("Startup", PHASE_ORDER, StartupPhase);
+	}
+	/**
+	* Adds a task to a specific startup phase with timeout.
+	*
+	* @param phase - The startup phase from {@link StartupPhase}
+	* @param taskName - Unique identifier for the task
+	* @param task - Async function to execute
+	* @param timeoutMs - Task timeout in milliseconds. {@default `10000`}
+	*/
+	addTask(phase, taskName, task, timeoutMs = 1e4) {
+		super.addTask(phase, taskName, task, timeoutMs);
+	}
+	canAddTask() {
+		if (this.hasStarted) throw new SeedcordError(SeedcordErrorCode.LifecycleAddAfterCompletion);
+		if (this.isStartingUp) throw new SeedcordError(SeedcordErrorCode.LifecycleAddDuringRun);
+		return true;
+	}
+	canRemoveTask() {
+		if (this.isStartingUp) throw new SeedcordError(SeedcordErrorCode.LifecycleRemoveDuringRun);
+		return true;
+	}
+	getTaskType() {
+		return "startup";
+	}
+	async executeTasksInPhase(phase, tasks) {
+		const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));
+		return Promise.allSettled(promises);
+	}
+	/**
+	* Executes the coordinated startup sequence.
+	*
+	* Runs all registered tasks across startup phases in the correct order.
+	* Each phase completes before the next phase begins. Tasks within a phase
+	* are executed sequentially to maintain predictable initialization.
+	*
+	* @returns Promise that resolves when startup is complete
+	* @throws An {@link Error} If startup fails or is called multiple times
+	* @example
+	* ```typescript
+	* const startup = new CoordinatedStartup();
+	* startup.addTask(StartupPhase.Services, 'database', () => db.connect(), 10000);
+	* await startup.run();
+	* ```
+	*/
+	async run() {
+		if (this.hasStarted) {
+			this.logger.warn("Startup sequence has already completed");
+			return;
+		}
+		if (this.isStartingUp) {
+			this.logger.warn("Startup sequence already in progress");
+			return;
+		}
+		this.isStartingUp = true;
+		this.logger.info(`${chalk.bold.green("Starting")} coordinated startup sequence`);
+		this.emitSafe("startup:start");
+		try {
+			for (const phase of PHASE_ORDER) {
+				if (!this.isStartingUp) {
+					this.logger.warn("Startup sequence aborted");
+					return;
+				}
+				await this.runPhase(phase);
+			}
+			this.hasStarted = true;
+			this.logger.info(`${chalk.bold.green("Coordinated startup completed")} successfully`);
+			this.emitSafe("startup:complete");
+		} catch (error) {
+			if (!this.isStartingUp) {
+				this.logger.warn("Startup sequence aborted during error handling");
+				return;
+			}
+			this.logger.error(`${chalk.bold.red("Coordinated startup failed")}`);
+			this.emitSafe("startup:error", error);
+			throw error;
+		} finally {
+			this.isStartingUp = false;
+		}
+	}
+	async runTaskWithTimeout(phase, task) {
+		this.logger.info(`${chalk.italic("Starting")} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}`);
+		let timeoutId;
+		try {
+			await Promise.race([task.task(), new Promise((_, reject) => {
+				timeoutId = setTimeout(() => {
+					reject(new SeedcordError(SeedcordErrorCode.LifecycleTaskTimeout, [task.name, task.timeout]));
+				}, task.timeout);
+			})]);
+			this.logger.info(`${chalk.italic("Completed")} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}`);
+		} catch (error) {
+			if (!this.isStartingUp) return;
+			this.logger.error(`${chalk.italic("Failed")} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}:`, error);
+			throw error;
+		} finally {
+			if (timeoutId) clearTimeout(timeoutId);
+		}
+	}
+	/**
+	* Aborts the startup sequence if it is currently running.
+	*/
+	abort() {
+		if (!this.isStartingUp) return;
+		this.isStartingUp = false;
+		this.logger.warn("Aborting coordinated startup sequence");
+	}
+	/**
+	* Check if startup has completed
+	*/
+	get isReady() {
+		return this.hasStarted;
+	}
+	/**
+	* Check if startup is currently running
+	*/
+	get isRunning() {
+		return this.isStartingUp;
+	}
+};
+
+//#endregion
+//#region src/node/HealthCheck.ts
+const HTTP_OK = 200;
+const HTTP_NOT_FOUND = 404;
+const DEFAULT_HEALTH_CHECK_PORT = 6967;
+const DEFAULT_HEALTH_CHECK_PATH = "/healthcheck";
+/**
+* HTTP health check service for monitoring bot status.
+*
+* Provides a simple HTTP endpoint that responds with JSON status
+* information, useful for container orchestration and monitoring.
+*/
+var HealthCheck = class {
+	/** @internal */
+	logger = new Logger("HealthCheck");
+	port;
+	path;
+	host;
+	server;
+	constructor(shutdown, options) {
+		this.port = options?.port ?? DEFAULT_HEALTH_CHECK_PORT;
+		this.path = options?.path ?? DEFAULT_HEALTH_CHECK_PATH;
+		this.host = options?.host;
+		shutdown.addTask(2, "stop-healthcheck-server", async () => await this.stop());
+	}
+	/**
+	* Starts the health check server.
+	* @returns Promise that resolves when the server is listening
+	* @internal
+	*/
+	async init() {
+		return new Promise((resolve, reject) => {
+			const server = createServer((req, res) => {
+				if (req.method === "GET" && req.url === this.path) {
+					res.writeHead(HTTP_OK, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({
+						status: "ok",
+						timestamp: Date.now()
+					}));
+				} else {
+					res.writeHead(HTTP_NOT_FOUND, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ status: "not found" }));
+				}
+			});
+			this.server = server;
+			const onListenError = (err) => reject(err);
+			server.on("error", onListenError);
+			server.once("listening", () => {
+				server.removeListener("error", onListenError);
+				server.on("error", (err) => this.logger.error("Health check server error", err));
+				const address = this.host ?? "localhost";
+				this.logger.info(`${chalk.green.bold("✓")} Health check server listening on ${chalk.cyan(`http://${address}:${this.port}${this.path}`)}`);
+				resolve();
+			});
+			if (this.host) {
+				this.logger.debug(`Binding health check server to ${this.host}`);
+				server.listen(this.port, this.host);
+			} else {
+				this.logger.debug("Binding health check server to all interfaces");
+				server.listen(this.port);
+			}
+		});
+	}
+	/**
+	* Stops the health check server.
+	*
+	* @returns Promise that resolves when the server is closed
+	* @internal
+	*/
+	stop() {
+		const server = this.server;
+		if (!server?.listening) return Promise.resolve();
+		return new Promise((resolve, reject) => {
+			server.once("close", () => resolve());
+			server.close((err) => {
+				if (err) {
+					reject(err);
+					return;
+				}
+				this.logger.info(chalk.bold.red("Health check server stopped"));
+			});
+		});
+	}
+};
+
+//#endregion
+export { CoordinatedLifecycle, CoordinatedShutdown, CoordinatedStartup, HealthCheck, ShutdownPhase, StartupPhase };
+//# sourceMappingURL=node.index.mjs.map

package/dist/node.index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.index.mjs","names":["PHASE_ORDER"],"sources":["../src/node/Lifecycle/CoordinatedLifecycle.ts","../src/node/Lifecycle/CoordinatedShutdown.ts","../src/node/Lifecycle/CoordinatedStartup.ts","../src/node/HealthCheck.ts"],"sourcesContent":["/*\n * Inspired by Akka Coordinated Shutdown: https://doc.akka.io/libraries/akka-core/current/coordinated-shutdown.html\n * and Lewis's implementation in a private repo elsewhere (https://github.com/Yomanz)\n */\n\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { TypedEventEmitter } from '@seedcord/event-emitter';\nimport { Logger } from '@seedcord/logger';\nimport chalk from 'chalk';\n\nimport type { LifecycleTask } from './LifecycleTypes';\nimport type { EventMap } from '@seedcord/event-emitter';\n\n/**\n * Abstract base class for coordinated lifecycle management (startup/shutdown)\n */\nexport abstract class CoordinatedLifecycle<\n    TPhase extends number,\n    TEvents extends EventMap<TEvents>\n> extends TypedEventEmitter<TEvents> {\n    protected readonly logger: Logger;\n    protected readonly tasksMap = new Map<TPhase, LifecycleTask[]>();\n\n    protected constructor(\n        loggerName: string,\n        protected readonly phaseOrder: TPhase[],\n        protected readonly phaseEnum: Record<number, string>\n    ) {\n        super();\n        this.logger = new Logger(loggerName);\n        this.phaseOrder.forEach((phase) => this.tasksMap.set(phase, []));\n    }\n\n    /**\n     * Adds a lifecycle task to a specific phase.\n     *\n     * Tasks are executed in phase order during lifecycle operations.\n     * Each task has a timeout to prevent hanging operations.\n     *\n     * @param phase - The lifecycle phase to add the task to\n     * @param taskName - Unique name for the task (used for logging and removal)\n     * @param task - Async function to execute during the phase\n     * @param timeoutMs - Maximum time allowed for task execution in milliseconds\n     * @example\n     * ```typescript\n     * lifecycle.addTask(StartupPhase.Services, 'start-database', async () => {\n     *   await database.connect();\n     * }, 10000);\n     * ```\n     */\n    public addTask(phase: TPhase, taskName: string, task: () => Promise<void>, timeoutMs: number): void {\n        if (!this.canAddTask()) return;\n\n        const tasks = this.tasksMap.get(phase);\n        if (!tasks) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleUnknownPhase, [phase]);\n        }\n\n        tasks.push({ name: taskName, task, timeout: timeoutMs });\n        this.logger.debug(\n            `${chalk.italic('Added')} ${this.getTaskType()} task ${chalk.bold.cyan(taskName)} to phase ${chalk.bold.magenta(this.phaseEnum[phase])}`\n        );\n    }\n\n    /**\n     * Removes a lifecycle task from a specific phase.\n     *\n     * @param phase - The lifecycle phase to remove the task from\n     * @param taskName - Name of the task to remove\n     * @returns True if the task was found and removed, false otherwise\n     */\n    public removeTask(phase: TPhase, taskName: string): boolean {\n        if (!this.canRemoveTask()) return false;\n\n        const tasks = this.tasksMap.get(phase);\n        if (!tasks) return false;\n\n        const initialLength = tasks.length;\n        const filteredTasks = tasks.filter((task) => task.name !== taskName);\n        this.tasksMap.set(phase, filteredTasks);\n\n        const removed = initialLength !== filteredTasks.length;\n        if (removed) {\n            this.logger.debug(\n                `${chalk.italic('Removed')} ${this.getTaskType()} task ${chalk.bold.cyan(taskName)} from phase ${chalk.bold.magenta(this.phaseEnum[phase])}`\n            );\n        }\n\n        return removed;\n    }\n\n    /**\n     * Run all tasks in a specific phase\n     */\n    protected async runPhase(phase: TPhase): Promise<void> {\n        const tasks = this.tasksMap.get(phase) ?? [];\n        if (tasks.length === 0) {\n            this.logger.warn(`No tasks to run in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);\n            return;\n        }\n\n        this.logger.info(\n            `${chalk.bold.yellow('Running')} ${this.getTaskType()} phase ${chalk.bold.magenta(this.phaseEnum[phase])} with ${chalk.bold.cyan(tasks.length)} tasks`\n        );\n        this.emitPhase(phase, 'start');\n\n        const results: PromiseSettledResult<void>[] = await this.executeTasksInPhase(phase, tasks);\n\n        const failures = results.filter((r) => r.status === 'rejected').length;\n        if (failures > 0) {\n            // raw phase name here. chalk's ANSI codes would otherwise leak into the serialized\n            // error message (e.g. the unknown-exception webhook payload).\n            throw new SeedcordError(SeedcordErrorCode.LifecyclePhaseFailures, [this.phaseEnum[phase], failures]);\n        }\n\n        this.logger.info(\n            `Phase ${chalk.bold.magenta(this.phaseEnum[phase])} ${chalk.bold.green('completed successfully')}`\n        );\n\n        this.emitPhase(phase, 'complete');\n    }\n\n    /**\n     * Run a single task with timeout\n     */\n    protected async runTaskWithTimeout(phase: TPhase, task: LifecycleTask): Promise<void> {\n        this.logger.info(\n            `${chalk.italic('Starting')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`\n        );\n\n        let timeoutId: NodeJS.Timeout | undefined;\n\n        try {\n            await Promise.race([\n                task.task(),\n                new Promise<void>((_, reject) => {\n                    timeoutId = setTimeout(() => {\n                        reject(new SeedcordError(SeedcordErrorCode.LifecycleTaskTimeout, [task.name, task.timeout]));\n                    }, task.timeout);\n                })\n            ]);\n\n            this.logger.info(\n                `${chalk.italic('Completed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`\n            );\n        } catch (error) {\n            this.logger.error(\n                `${chalk.italic('Failed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}:`,\n                error\n            );\n            throw error;\n        } finally {\n            if (timeoutId) {\n                clearTimeout(timeoutId);\n            }\n        }\n    }\n\n    // The phase key is interpolated from phaseOrder at runtime and is always a valid no-payload key of\n    // the subclass event map, but TS can't correlate a template-literal key with the generic TEvents.\n    private emitPhase(phase: TPhase, action: 'start' | 'complete'): void {\n        this.emitSafeRaw(`phase:${phase}:${action}`);\n    }\n\n    protected override onListenerError(error: unknown, event: string | symbol): void {\n        this.logger.error(`listener for ${String(event)} threw`, error);\n    }\n\n    // Abstract methods to be implemented by subclasses\n    protected abstract canAddTask(): boolean;\n    protected abstract canRemoveTask(): boolean;\n    protected abstract getTaskType(): string;\n    protected abstract executeTasksInPhase(\n        phase: TPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]>;\n}\n","import chalk from 'chalk';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\n\nimport type { LifecycleTask, PhaseEventMap } from './LifecycleTypes';\nimport type { UnionToTuple } from 'type-fest';\n\n/**\n * Shutdown phases for coordinated application shutdown.\n */\nexport enum ShutdownPhase {\n    /** Stop accepting new requests/interactions */\n    StopAcceptingRequests = 1,\n    /** Stop background services (health checks, etc.) */\n    StopServices,\n    /** Disconnect from external resources (database, APIs) */\n    ExternalResources,\n    /** Disconnect from Discord */\n    DiscordCleanup,\n    /** Final cleanup tasks */\n    FinalCleanup\n}\n\n/** Define the order of phases */\nconst PHASE_ORDER: ShutdownPhase[] = [\n    ShutdownPhase.StopAcceptingRequests,\n    ShutdownPhase.StopServices,\n    ShutdownPhase.ExternalResources,\n    ShutdownPhase.DiscordCleanup,\n    ShutdownPhase.FinalCleanup\n];\n\n/**\n * Strict-event-emitter payload map for coordinated shutdown phases.\n */\nexport type CoordinatedShutdownEvents = PhaseEventMap<'shutdown', UnionToTuple<ShutdownPhase>>;\n\n// Delay process.exit so the logger's file sink has a window to flush before the event loop dies.\nconst LOG_FLUSH_DELAY_MS = 500;\n\n/**\n * CoordinatedShutdown manages graceful application shutdown by executing registered tasks across defined phases.\n *\n * It listens for termination signals (SIGINT, SIGTERM) and runs tasks in parallel within each phase.\n * Tasks can be added or removed dynamically, and each task has an associated timeout.\n */\nexport class CoordinatedShutdown extends CoordinatedLifecycle<ShutdownPhase, CoordinatedShutdownEvents> {\n    private readonly isShutdownEnabled: boolean;\n\n    private isShuttingDown = false;\n    private exitCode = 0;\n    private onSigTerm: (() => void) | null = null;\n    private onSigInt: (() => void) | null = null;\n\n    public constructor(enabled = true) {\n        super('Shutdown', PHASE_ORDER, ShutdownPhase);\n\n        this.isShutdownEnabled = enabled;\n        this.registerSignalHandlers();\n    }\n\n    protected canAddTask(): boolean {\n        return this.isShutdownEnabled;\n    }\n\n    protected canRemoveTask(): boolean {\n        return true;\n    }\n\n    protected getTaskType(): string {\n        return 'shutdown';\n    }\n\n    protected async executeTasksInPhase(\n        phase: ShutdownPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]> {\n        const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));\n        return Promise.allSettled(promises);\n    }\n\n    private registerSignalHandlers(): void {\n        if (!this.isShutdownEnabled) return;\n\n        this.onSigTerm = () => {\n            this.logger.info(`Received ${chalk.yellow.bold('SIGTERM')} signal`);\n            void this.run(0);\n        };\n\n        this.onSigInt = () => {\n            this.logger.info(`Received ${chalk.yellow.bold('SIGINT')} signal`);\n            void this.run(0);\n        };\n\n        process.on('SIGTERM', this.onSigTerm);\n        process.on('SIGINT', this.onSigInt);\n    }\n\n    private removeSignalHandlers(): void {\n        if (this.onSigTerm) {\n            process.off('SIGTERM', this.onSigTerm);\n            this.onSigTerm = null;\n        }\n        if (this.onSigInt) {\n            process.off('SIGINT', this.onSigInt);\n            this.onSigInt = null;\n        }\n    }\n\n    /**\n     * Adds a task to a specific shutdown phase with timeout.\n     *\n     * @param phase - The shutdown phase from {@link ShutdownPhase}\n     * @param taskName - Unique identifier for the task\n     * @param task - Async function to execute\n     * @param timeoutMs - Task timeout in milliseconds. {@default `5000`}\n     */\n    public override addTask(phase: ShutdownPhase, taskName: string, task: () => Promise<void>, timeoutMs = 5000): void {\n        super.addTask(phase, taskName, task, timeoutMs);\n    }\n\n    /**\n     * Removes a task from a specific shutdown phase.\n     *\n     * @param phase - The shutdown phase to remove from\n     * @param taskName - Name of the task to remove\n     * @returns True if task was found and removed\n     */\n    public override removeTask(phase: ShutdownPhase, taskName: string): boolean {\n        return super.removeTask(phase, taskName);\n    }\n\n    /**\n     * Executes the coordinated shutdown sequence.\n     *\n     * Runs all registered tasks across shutdown phases in reverse order.\n     * Tasks within each phase are executed in parallel for faster shutdown.\n     * Process exits with the specified code when complete.\n     *\n     * @param exitCode - Process exit code. {@default `0`}\n     * @param exitProcess - Whether to exit the process after shutdown. {@default `true`}\n     * @returns Promise that resolves when shutdown is complete\n     * @example\n     * ```typescript\n     * shutdown.addTask(ShutdownPhase.Services, 'database', () => db.disconnect(), 5000);\n     * await shutdown.run(0); // Graceful shutdown\n     * ```\n     */\n    public async run(exitCode = 0, exitProcess = true): Promise<void> {\n        this.removeSignalHandlers();\n\n        if (this.isShuttingDown) {\n            this.logger.warn('Shutdown sequence already in progress');\n            return;\n        }\n\n        this.isShuttingDown = true;\n        this.exitCode = exitCode;\n        this.logger.info(\n            `${chalk.bold.yellow('Starting')} coordinated shutdown with exit code ${chalk.bold.cyan(exitCode)}`\n        );\n        this.emitSafe('shutdown:start');\n\n        try {\n            for (const phase of PHASE_ORDER) {\n                await this.runPhase(phase);\n            }\n\n            this.logger.info(`${chalk.bold.green('Coordinated shutdown completed')} successfully`);\n            this.emitSafe('shutdown:complete');\n        } catch (error) {\n            this.logger.error(`${chalk.bold.red('Coordinated shutdown failed')}`);\n            this.emitSafe('shutdown:error', error);\n        } finally {\n            if (exitProcess) {\n                this.logger.info(`${chalk.bold.red('Exiting')} process with code ${chalk.bold.cyan(this.exitCode)}`);\n                setTimeout(() => {\n                    process.exit(this.exitCode);\n                }, LOG_FLUSH_DELAY_MS);\n            } else {\n                this.logger.info(`${chalk.bold.yellow('Skipping')} process exit (dev mode)`);\n                this.isShuttingDown = false;\n            }\n        }\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport chalk from 'chalk';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\n\nimport type { LifecycleTask, PhaseEventMap } from './LifecycleTypes';\nimport type { UnionToTuple } from 'type-fest';\n\n/**\n * Startup phases for coordinated initialization\n *\n * Defines the order in which different components are initialized during bot startup.\n */\nexport enum StartupPhase {\n    /** Validate environment variables and config files */\n    Validation = 1,\n    /** Discover plugin constructors via decorators or registry */\n    Discovery,\n    /** Register plugin metadata and declared dependencies */\n    Registration,\n    /** Inject and validate plugin-specific configuration */\n    Configuration,\n    /** Instantiate plugin classes with Core and arguments */\n    Instantiation,\n    /** Activate plugins by calling their init/setup methods */\n    Activation,\n    /** Mark seedcord as ready and start handling interactions */\n    Ready\n}\n\n/** Define the order of phases */\nconst PHASE_ORDER: StartupPhase[] = [\n    StartupPhase.Validation,\n    StartupPhase.Discovery,\n    StartupPhase.Registration,\n    StartupPhase.Configuration,\n    StartupPhase.Instantiation,\n    StartupPhase.Activation,\n    StartupPhase.Ready\n];\n\n/**\n * Strict-event-emitter payload map for coordinated startup phases.\n */\nexport type CoordinatedStartupEvents = PhaseEventMap<'startup', UnionToTuple<StartupPhase>>;\n\n/**\n * Manages bot startup lifecycle with ordered phases\n *\n * Coordinates initialization of all bot components in a predictable sequence.\n * Tasks are executed within their designated phases to ensure proper dependency order.\n */\nexport class CoordinatedStartup extends CoordinatedLifecycle<StartupPhase, CoordinatedStartupEvents> {\n    private isStartingUp = false;\n    private hasStarted = false;\n\n    public constructor() {\n        super('Startup', PHASE_ORDER, StartupPhase);\n    }\n\n    /**\n     * Adds a task to a specific startup phase with timeout.\n     *\n     * @param phase - The startup phase from {@link StartupPhase}\n     * @param taskName - Unique identifier for the task\n     * @param task - Async function to execute\n     * @param timeoutMs - Task timeout in milliseconds. {@default `10000`}\n     */\n    public override addTask(\n        phase: StartupPhase,\n        taskName: string,\n        task: () => Promise<void>,\n        timeoutMs = 10_000\n    ): void {\n        super.addTask(phase, taskName, task, timeoutMs);\n    }\n\n    protected canAddTask(): boolean {\n        if (this.hasStarted) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleAddAfterCompletion);\n        }\n\n        if (this.isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleAddDuringRun);\n        }\n\n        return true;\n    }\n\n    protected canRemoveTask(): boolean {\n        if (this.isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleRemoveDuringRun);\n        }\n\n        return true;\n    }\n\n    protected getTaskType(): string {\n        return 'startup';\n    }\n\n    protected async executeTasksInPhase(\n        phase: StartupPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]> {\n        const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));\n        return Promise.allSettled(promises);\n    }\n\n    /**\n     * Executes the coordinated startup sequence.\n     *\n     * Runs all registered tasks across startup phases in the correct order.\n     * Each phase completes before the next phase begins. Tasks within a phase\n     * are executed sequentially to maintain predictable initialization.\n     *\n     * @returns Promise that resolves when startup is complete\n     * @throws An {@link Error} If startup fails or is called multiple times\n     * @example\n     * ```typescript\n     * const startup = new CoordinatedStartup();\n     * startup.addTask(StartupPhase.Services, 'database', () => db.connect(), 10000);\n     * await startup.run();\n     * ```\n     */\n    public async run(): Promise<void> {\n        if (this.hasStarted) {\n            this.logger.warn('Startup sequence has already completed');\n            return;\n        }\n\n        if (this.isStartingUp) {\n            this.logger.warn('Startup sequence already in progress');\n            return;\n        }\n\n        this.isStartingUp = true;\n        this.logger.info(`${chalk.bold.green('Starting')} coordinated startup sequence`);\n        this.emitSafe('startup:start');\n\n        try {\n            for (const phase of PHASE_ORDER) {\n                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- abort() can flip isStartingUp to false mid-loop from the cli\n                if (!this.isStartingUp) {\n                    this.logger.warn('Startup sequence aborted');\n                    return;\n                }\n                await this.runPhase(phase);\n            }\n\n            this.hasStarted = true;\n            this.logger.info(`${chalk.bold.green('Coordinated startup completed')} successfully`);\n            this.emitSafe('startup:complete');\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- abort() can flip isStartingUp to false before this catch runs\n            if (!this.isStartingUp) {\n                this.logger.warn('Startup sequence aborted during error handling');\n                return;\n            }\n            this.logger.error(`${chalk.bold.red('Coordinated startup failed')}`);\n            this.emitSafe('startup:error', error);\n            throw error;\n        } finally {\n            this.isStartingUp = false;\n        }\n    }\n\n    protected override async runTaskWithTimeout(phase: StartupPhase, task: LifecycleTask): Promise<void> {\n        this.logger.info(\n            `${chalk.italic('Starting')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}`\n        );\n\n        let timeoutId: NodeJS.Timeout | undefined;\n\n        try {\n            await Promise.race([\n                task.task(),\n                new Promise<void>((_, reject) => {\n                    timeoutId = setTimeout(() => {\n                        reject(new SeedcordError(SeedcordErrorCode.LifecycleTaskTimeout, [task.name, task.timeout]));\n                    }, task.timeout);\n                })\n            ]);\n\n            this.logger.info(\n                `${chalk.italic('Completed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}`\n            );\n        } catch (error) {\n            if (!this.isStartingUp) {\n                return;\n            }\n\n            this.logger.error(\n                `${chalk.italic('Failed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}:`,\n                error\n            );\n            throw error;\n        } finally {\n            if (timeoutId) {\n                clearTimeout(timeoutId);\n            }\n        }\n    }\n\n    /**\n     * Aborts the startup sequence if it is currently running.\n     */\n    public abort(): void {\n        if (!this.isStartingUp) return;\n\n        this.isStartingUp = false;\n        this.logger.warn('Aborting coordinated startup sequence');\n    }\n\n    /**\n     * Check if startup has completed\n     */\n    public get isReady(): boolean {\n        return this.hasStarted;\n    }\n\n    /**\n     * Check if startup is currently running\n     */\n    public get isRunning(): boolean {\n        return this.isStartingUp;\n    }\n}\n","import { createServer } from 'node:http';\n\nimport { Logger } from '@seedcord/logger';\nimport chalk from 'chalk';\n\nimport { ShutdownPhase } from './Lifecycle/CoordinatedShutdown';\n\nimport type { CoordinatedShutdown } from './Lifecycle/CoordinatedShutdown';\nimport type { HealthCheckConfig } from '@seedcord/types';\nimport type { IncomingMessage, Server, ServerResponse } from 'node:http';\n\nconst HTTP_OK = 200;\nconst HTTP_NOT_FOUND = 404;\n\nconst DEFAULT_HEALTH_CHECK_PORT = 6967;\nconst DEFAULT_HEALTH_CHECK_PATH = '/healthcheck';\n\n/**\n * HTTP health check service for monitoring bot status.\n *\n * Provides a simple HTTP endpoint that responds with JSON status\n * information, useful for container orchestration and monitoring.\n */\nexport class HealthCheck {\n    /** @internal */\n    public readonly logger = new Logger('HealthCheck');\n\n    public readonly port: number;\n    public readonly path: string;\n    public readonly host: string | undefined;\n\n    private server?: Server;\n\n    constructor(shutdown: CoordinatedShutdown, options?: HealthCheckConfig) {\n        this.port = options?.port ?? DEFAULT_HEALTH_CHECK_PORT;\n        this.path = options?.path ?? DEFAULT_HEALTH_CHECK_PATH;\n        this.host = options?.host;\n\n        shutdown.addTask(ShutdownPhase.StopServices, 'stop-healthcheck-server', async () => await this.stop());\n    }\n\n    /**\n     * Starts the health check server.\n     * @returns Promise that resolves when the server is listening\n     * @internal\n     */\n    public async init(): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            const server = createServer((req: IncomingMessage, res: ServerResponse) => {\n                if (req.method === 'GET' && req.url === this.path) {\n                    res.writeHead(HTTP_OK, { 'Content-Type': 'application/json' });\n                    res.end(JSON.stringify({ status: 'ok', timestamp: Date.now() }));\n                } else {\n                    res.writeHead(HTTP_NOT_FOUND, { 'Content-Type': 'application/json' });\n                    res.end(JSON.stringify({ status: 'not found' }));\n                }\n            });\n            this.server = server;\n\n            const onListenError = (err: Error): void => reject(err);\n            server.on('error', onListenError);\n\n            server.once('listening', () => {\n                // Swap the listen-time reject handler for a logging one: keeping it would reject an\n                // already-settled promise on a late error, and removing it without a replacement\n                // would crash the process on an unhandled 'error' event.\n                server.removeListener('error', onListenError);\n                server.on('error', (err) => this.logger.error('Health check server error', err));\n\n                const address = this.host ?? 'localhost';\n                this.logger.info(\n                    `${chalk.green.bold('✓')} Health check server listening on ${chalk.cyan(`http://${address}:${this.port}${this.path}`)}`\n                );\n                resolve();\n            });\n\n            if (this.host) {\n                this.logger.debug(`Binding health check server to ${this.host}`);\n                server.listen(this.port, this.host);\n            } else {\n                this.logger.debug('Binding health check server to all interfaces');\n                server.listen(this.port);\n            }\n        });\n    }\n\n    /**\n     * Stops the health check server.\n     *\n     * @returns Promise that resolves when the server is closed\n     * @internal\n     */\n    public stop(): Promise<void> {\n        const server = this.server;\n        // close() on a non-listening server invokes its callback with ERR_SERVER_NOT_RUNNING and\n        // never fires 'close', so without this guard the promise would hang the shutdown phase.\n        if (!server?.listening) return Promise.resolve();\n\n        return new Promise((resolve, reject) => {\n            server.once('close', () => resolve());\n            server.close((err) => {\n                if (err) {\n                    reject(err);\n                    return;\n                }\n                this.logger.info(chalk.bold.red('Health check server stopped'));\n            });\n        });\n    }\n}\n"],"mappings":"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"}