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

package/dist/hmr.index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hmr.index.cjs","names":["sep"],"sources":["../src/hmr/HmrModuleHandler.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, sep } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\n\nimport type { Logger } from '@seedcord/logger';\nimport type { HmrUpdateEvent } from '@seedcord/types';\n\ninterface HmrStore<THandler, TMiddleware, TArtifacts> {\n    fileToHandlers: Map<string, Set<THandler>>;\n    fileToMiddlewares: Map<string, Set<TMiddleware>>;\n    handlerArtifacts: Map<THandler, TArtifacts>;\n}\n\n// justified: units are caller-supplied classes, name is read for log labels only\nconst displayName = (unit: unknown, fallback: string): string => (unit as { name?: string }).name ?? fallback;\n\ninterface HmrModuleHandlerOptions<THandler, TMiddleware = void, TArtifacts = unknown> {\n    handlersDir: string;\n    middlewaresDir?: string;\n    isHandler: (val: unknown) => val is THandler;\n    isMiddleware?: (val: unknown) => val is TMiddleware;\n    registerHandler: (handler: THandler, file: string) => void;\n    registerMiddleware?: (middleware: TMiddleware, file: string) => void;\n    unregisterHandler: (handler: THandler, artifacts?: TArtifacts) => void;\n    unregisterMiddleware?: (middleware: TMiddleware) => void;\n    /** Snapshotted per handler so a rollback re-registers with the same artifacts after the module re-imports. */\n    getArtifacts?: (handler: THandler) => TArtifacts;\n    logger: Logger;\n}\n\n/**\n * Reloads THandler and optional TMiddleware modules on HMR updates.\n *\n * Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.\n *\n * This is only useful during development.\n */\nexport class HmrModuleHandler<THandler, TMiddleware = void, TArtifacts = unknown> {\n    private readonly store: HmrStore<THandler, TMiddleware, TArtifacts>;\n    private readonly options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>;\n\n    constructor(options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>) {\n        // the caller's options object stays unmutated\n        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed, a leaf reload never reconstructs the singleton that holds these Maps\n        this.store = {\n            fileToHandlers: new Map(),\n            fileToMiddlewares: new Map(),\n            handlerArtifacts: new Map()\n        };\n    }\n\n    /** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */\n    public async handle(event: HmrUpdateEvent): Promise<void> {\n        const { file, affectedModules, type } = event;\n        const { logger, handlersDir, middlewaresDir } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.unload(file);\n            return;\n        }\n\n        // a directory is never importable, its files arrive as their own create events\n        if (type === 'createDir') return;\n\n        if (type === 'update' && !existsSync(file)) {\n            if (this.isTracked(file)) {\n                logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.unload(file);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n        const absHandlersDir = resolve(process.cwd(), handlersDir);\n        const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;\n\n        for (const fileToReload of filesToReload) {\n            // the separator keeps a sibling dir sharing the prefix (commands-extra vs commands) out\n            const isHandler = fileToReload.startsWith(absHandlersDir + sep);\n            const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;\n\n            if (!isHandler && !isMiddleware) {\n                continue;\n            }\n\n            await this.reloadWithRollback(fileToReload, rollbackEnabled);\n        }\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<void> {\n        const { logger } = this.options;\n        const snapshot = this.snapshotUnits(file);\n        this.unload(file);\n\n        const reloaded = await this.reloadFile(file);\n        if (reloaded) return;\n\n        // a failed reload can leave a partial registration\n        this.unload(file);\n        if (!rollbackEnabled) return;\n        if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;\n\n        // a typo keeps them live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${chalk.yellow.bold('Rolled back')} ${chalk.gray(formatFilePath(file))} to the last-good version`);\n    }\n\n    /** Links the handler to its source file so a later update can unload it. */\n    public trackHandler(file: string, handler: THandler): void {\n        let set = this.store.fileToHandlers.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToHandlers.set(file, set);\n        }\n        set.add(handler);\n\n        if (this.options.getArtifacts) {\n            const artifacts = this.options.getArtifacts(handler);\n            this.store.handlerArtifacts.set(handler, artifacts);\n        }\n    }\n\n    /** Links the middleware to its source file so a later update can unload it. */\n    public trackMiddleware(file: string, middleware: TMiddleware): void {\n        let set = this.store.fileToMiddlewares.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToMiddlewares.set(file, set);\n        }\n        set.add(middleware);\n    }\n\n    private isTracked(file: string): boolean {\n        return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);\n    }\n\n    private unload(file: string): void {\n        const { logger } = this.options;\n        const handlers = this.store.fileToHandlers.get(file);\n        if (handlers) {\n            for (const handler of handlers) {\n                const artifacts = this.store.handlerArtifacts.get(handler);\n                this.options.unregisterHandler(handler, artifacts);\n                this.store.handlerArtifacts.delete(handler);\n                const name = displayName(handler, 'Handler');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToHandlers.delete(file);\n        }\n\n        const middlewares = this.store.fileToMiddlewares.get(file);\n        if (middlewares) {\n            for (const middleware of middlewares) {\n                this.options.unregisterMiddleware?.(middleware);\n                const name = displayName(middleware, 'Middleware');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n    }\n\n    private async reloadFile(file: string): Promise<boolean> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return false;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph, so bust the import cache manually.\n            if (process.env.VITEST === 'true') fileUrl += `?update=${Date.now()}`;\n\n            // justified: a dynamic import resolves to an untyped export map\n            const imported = (await import(fileUrl)) as Record<string, unknown>;\n\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    const name = displayName(val, 'Handler');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    const name = displayName(val, 'Middleware');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                }\n            }\n\n            return true;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return false;\n        }\n    }\n\n    // restoring re-registers the same class objects, so a live db connection survives rollback\n    private snapshotUnits(file: string): { handlers: THandler[]; middlewares: TMiddleware[] } {\n        return {\n            handlers: [...(this.store.fileToHandlers.get(file) ?? [])],\n            middlewares: [...(this.store.fileToMiddlewares.get(file) ?? [])]\n        };\n    }\n\n    private restoreUnits(file: string, snapshot: { handlers: THandler[]; middlewares: TMiddleware[] }): void {\n        for (const handler of snapshot.handlers) {\n            this.options.registerHandler(handler, file);\n            this.trackHandler(file, handler);\n        }\n\n        if (this.options.registerMiddleware) {\n            for (const middleware of snapshot.middlewares) {\n                this.options.registerMiddleware(middleware, file);\n                this.trackMiddleware(file, middleware);\n            }\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/hmr.index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hmr.index.mjs","names":[],"sources":["../src/hmr/HmrModuleHandler.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, sep } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\n\nimport type { Logger } from '@seedcord/logger';\nimport type { HmrUpdateEvent } from '@seedcord/types';\n\ninterface HmrStore<THandler, TMiddleware, TArtifacts> {\n    fileToHandlers: Map<string, Set<THandler>>;\n    fileToMiddlewares: Map<string, Set<TMiddleware>>;\n    handlerArtifacts: Map<THandler, TArtifacts>;\n}\n\n// justified: units are caller-supplied classes, name is read for log labels only\nconst displayName = (unit: unknown, fallback: string): string => (unit as { name?: string }).name ?? fallback;\n\ninterface HmrModuleHandlerOptions<THandler, TMiddleware = void, TArtifacts = unknown> {\n    handlersDir: string;\n    middlewaresDir?: string;\n    isHandler: (val: unknown) => val is THandler;\n    isMiddleware?: (val: unknown) => val is TMiddleware;\n    registerHandler: (handler: THandler, file: string) => void;\n    registerMiddleware?: (middleware: TMiddleware, file: string) => void;\n    unregisterHandler: (handler: THandler, artifacts?: TArtifacts) => void;\n    unregisterMiddleware?: (middleware: TMiddleware) => void;\n    /** Snapshotted per handler so a rollback re-registers with the same artifacts after the module re-imports. */\n    getArtifacts?: (handler: THandler) => TArtifacts;\n    logger: Logger;\n}\n\n/**\n * Reloads THandler and optional TMiddleware modules on HMR updates.\n *\n * Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.\n *\n * This is only useful during development.\n */\nexport class HmrModuleHandler<THandler, TMiddleware = void, TArtifacts = unknown> {\n    private readonly store: HmrStore<THandler, TMiddleware, TArtifacts>;\n    private readonly options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>;\n\n    constructor(options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>) {\n        // the caller's options object stays unmutated\n        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed, a leaf reload never reconstructs the singleton that holds these Maps\n        this.store = {\n            fileToHandlers: new Map(),\n            fileToMiddlewares: new Map(),\n            handlerArtifacts: new Map()\n        };\n    }\n\n    /** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */\n    public async handle(event: HmrUpdateEvent): Promise<void> {\n        const { file, affectedModules, type } = event;\n        const { logger, handlersDir, middlewaresDir } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.unload(file);\n            return;\n        }\n\n        // a directory is never importable, its files arrive as their own create events\n        if (type === 'createDir') return;\n\n        if (type === 'update' && !existsSync(file)) {\n            if (this.isTracked(file)) {\n                logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.unload(file);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n        const absHandlersDir = resolve(process.cwd(), handlersDir);\n        const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;\n\n        for (const fileToReload of filesToReload) {\n            // the separator keeps a sibling dir sharing the prefix (commands-extra vs commands) out\n            const isHandler = fileToReload.startsWith(absHandlersDir + sep);\n            const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;\n\n            if (!isHandler && !isMiddleware) {\n                continue;\n            }\n\n            await this.reloadWithRollback(fileToReload, rollbackEnabled);\n        }\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<void> {\n        const { logger } = this.options;\n        const snapshot = this.snapshotUnits(file);\n        this.unload(file);\n\n        const reloaded = await this.reloadFile(file);\n        if (reloaded) return;\n\n        // a failed reload can leave a partial registration\n        this.unload(file);\n        if (!rollbackEnabled) return;\n        if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;\n\n        // a typo keeps them live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${chalk.yellow.bold('Rolled back')} ${chalk.gray(formatFilePath(file))} to the last-good version`);\n    }\n\n    /** Links the handler to its source file so a later update can unload it. */\n    public trackHandler(file: string, handler: THandler): void {\n        let set = this.store.fileToHandlers.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToHandlers.set(file, set);\n        }\n        set.add(handler);\n\n        if (this.options.getArtifacts) {\n            const artifacts = this.options.getArtifacts(handler);\n            this.store.handlerArtifacts.set(handler, artifacts);\n        }\n    }\n\n    /** Links the middleware to its source file so a later update can unload it. */\n    public trackMiddleware(file: string, middleware: TMiddleware): void {\n        let set = this.store.fileToMiddlewares.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToMiddlewares.set(file, set);\n        }\n        set.add(middleware);\n    }\n\n    private isTracked(file: string): boolean {\n        return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);\n    }\n\n    private unload(file: string): void {\n        const { logger } = this.options;\n        const handlers = this.store.fileToHandlers.get(file);\n        if (handlers) {\n            for (const handler of handlers) {\n                const artifacts = this.store.handlerArtifacts.get(handler);\n                this.options.unregisterHandler(handler, artifacts);\n                this.store.handlerArtifacts.delete(handler);\n                const name = displayName(handler, 'Handler');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToHandlers.delete(file);\n        }\n\n        const middlewares = this.store.fileToMiddlewares.get(file);\n        if (middlewares) {\n            for (const middleware of middlewares) {\n                this.options.unregisterMiddleware?.(middleware);\n                const name = displayName(middleware, 'Middleware');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n    }\n\n    private async reloadFile(file: string): Promise<boolean> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return false;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph, so bust the import cache manually.\n            if (process.env.VITEST === 'true') fileUrl += `?update=${Date.now()}`;\n\n            // justified: a dynamic import resolves to an untyped export map\n            const imported = (await import(fileUrl)) as Record<string, unknown>;\n\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    const name = displayName(val, 'Handler');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    const name = displayName(val, 'Middleware');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                }\n            }\n\n            return true;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return false;\n        }\n    }\n\n    // restoring re-registers the same class objects, so a live db connection survives rollback\n    private snapshotUnits(file: string): { handlers: THandler[]; middlewares: TMiddleware[] } {\n        return {\n            handlers: [...(this.store.fileToHandlers.get(file) ?? [])],\n            middlewares: [...(this.store.fileToMiddlewares.get(file) ?? [])]\n        };\n    }\n\n    private restoreUnits(file: string, snapshot: { handlers: THandler[]; middlewares: TMiddleware[] }): void {\n        for (const handler of snapshot.handlers) {\n            this.options.registerHandler(handler, file);\n            this.trackHandler(file, handler);\n        }\n\n        if (this.options.registerMiddleware) {\n            for (const middleware of snapshot.middlewares) {\n                this.options.registerMiddleware(middleware, file);\n                this.trackMiddleware(file, middleware);\n            }\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/is-never-Ddaba1Su.d.mts

@@ -1,58 +0,0 @@
-//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-never.d.ts
-/**
-Returns a boolean for whether the given type is `never`.
-
-@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919
-@link https://stackoverflow.com/a/53984913/10292952
-@link https://www.zhenghao.io/posts/ts-never
-
-Useful in type utilities, such as checking if something does not occur.
-
-@example
-```
-import type {IsNever, And} from 'type-fest';
-
-type A = IsNever<never>;
-//=> true
-
-type B = IsNever<any>;
-//=> false
-
-type C = IsNever<unknown>;
-//=> false
-
-type D = IsNever<never[]>;
-//=> false
-
-type E = IsNever<object>;
-//=> false
-
-type F = IsNever<string>;
-//=> false
-```
-
-@example
-```
-import type {IsNever} from 'type-fest';
-
-type IsTrue<T> = T extends true ? true : false;
-
-// When a distributive conditional is instantiated with `never`, the entire conditional results in `never`.
-type A = IsTrue<never>;
-//=> never
-
-// If you don't want that behaviour, you can explicitly add an `IsNever` check before the distributive conditional.
-type IsTrueFixed<T> =
-	IsNever<T> extends true ? false : T extends true ? true : false;
-
-type B = IsTrueFixed<never>;
-//=> false
-```
-
-@category Type Guard
-@category Utilities
-*/
-type IsNever<T> = [T] extends [never] ? true : false;
-//#endregion
-export { IsNever as t };
-//# sourceMappingURL=is-never-Ddaba1Su.d.mts.map

package/dist/node.index.cjs

@@ -1,521 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
-let _seedcord_errors = require("@seedcord/errors");
-let _seedcord_errors_internal = require("@seedcord/errors/internal");
-let _seedcord_logger = require("@seedcord/logger");
-let chalk = require("chalk");
-chalk = require_rolldown_runtime.__toESM(chalk, 1);
-let _seedcord_event_emitter = require("@seedcord/event-emitter");
-let node_http = require("node:http");
-
-//#region src/node/Lifecycle/CoordinatedLifecycle.ts
-/**
-* Abstract base class for coordinated lifecycle management (startup/shutdown)
-*/
-var CoordinatedLifecycle = class extends _seedcord_event_emitter.TypedEventEmitter {
-	phaseOrder;
-	phaseEnum;
-	logger;
-	tasksMap = /* @__PURE__ */ new Map();
-	constructor(loggerName, phaseOrder, phaseEnum) {
-		super();
-		this.phaseOrder = phaseOrder;
-		this.phaseEnum = phaseEnum;
-		this.logger = new _seedcord_logger.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 _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.LifecycleUnknownPhase, [phase]);
-		tasks.push({
-			name: taskName,
-			task,
-			timeout: timeoutMs
-		});
-		this.logger.debug(`${chalk.default.italic("Added")} ${this.getTaskType()} task ${chalk.default.bold.cyan(taskName)} to phase ${chalk.default.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.default.italic("Removed")} ${this.getTaskType()} task ${chalk.default.bold.cyan(taskName)} from phase ${chalk.default.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.default.bold.magenta(this.phaseEnum[phase])}`);
-			return;
-		}
-		this.logger.info(`${chalk.default.bold.yellow("Running")} ${this.getTaskType()} phase ${chalk.default.bold.magenta(this.phaseEnum[phase])} with ${chalk.default.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 _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.LifecyclePhaseFailures, [this.phaseEnum[phase], failures]);
-		this.logger.info(`Phase ${chalk.default.bold.magenta(this.phaseEnum[phase])} ${chalk.default.bold.green("completed successfully")}`);
-		this.emitPhase(phase, "complete");
-	}
-	/**
-	* Run a single task with timeout
-	*/
-	async runTaskWithTimeout(phase, task) {
-		this.logger.info(`${chalk.default.italic("Starting")} task ${chalk.default.bold.cyan(task.name)} in phase ${chalk.default.bold.magenta(this.phaseEnum[phase])}`);
-		let timeoutId;
-		try {
-			await Promise.race([task.task(), new Promise((_, reject) => {
-				timeoutId = setTimeout(() => {
-					reject(new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.LifecycleTaskTimeout, [task.name, task.timeout]));
-				}, task.timeout);
-			})]);
-			this.logger.info(`${chalk.default.italic("Completed")} task ${chalk.default.bold.cyan(task.name)} in phase ${chalk.default.bold.magenta(this.phaseEnum[phase])}`);
-		} catch (error) {
-			this.logger.error(`${chalk.default.italic("Failed")} task ${chalk.default.bold.cyan(task.name)} in phase ${chalk.default.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.default.yellow.bold("SIGTERM")} signal`);
-			this.run(0);
-		};
-		this.onSigInt = () => {
-			this.logger.info(`Received ${chalk.default.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.default.bold.yellow("Starting")} coordinated shutdown with exit code ${chalk.default.bold.cyan(exitCode)}`);
-		this.emitSafe("shutdown:start");
-		try {
-			for (const phase of PHASE_ORDER$1) await this.runPhase(phase);
-			this.logger.info(`${chalk.default.bold.green("Coordinated shutdown completed")} successfully`);
-			this.emitSafe("shutdown:complete");
-		} catch (error) {
-			this.logger.error(`${chalk.default.bold.red("Coordinated shutdown failed")}`);
-			this.emitSafe("shutdown:error", error);
-		} finally {
-			if (exitProcess) {
-				this.logger.info(`${chalk.default.bold.red("Exiting")} process with code ${chalk.default.bold.cyan(this.exitCode)}`);
-				setTimeout(() => {
-					process.exit(this.exitCode);
-				}, LOG_FLUSH_DELAY_MS);
-			} else {
-				this.logger.info(`${chalk.default.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 _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.LifecycleAddAfterCompletion);
-		if (this.isStartingUp) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.LifecycleAddDuringRun);
-		return true;
-	}
-	canRemoveTask() {
-		if (this.isStartingUp) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.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.default.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.default.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.default.bold.red("Coordinated startup failed")}`);
-			this.emitSafe("startup:error", error);
-			throw error;
-		} finally {
-			this.isStartingUp = false;
-		}
-	}
-	async runTaskWithTimeout(phase, task) {
-		this.logger.info(`${chalk.default.italic("Starting")} task ${chalk.default.bold.cyan(task.name)} in phase ${chalk.default.bold.magenta(StartupPhase[phase])}`);
-		let timeoutId;
-		try {
-			await Promise.race([task.task(), new Promise((_, reject) => {
-				timeoutId = setTimeout(() => {
-					reject(new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.LifecycleTaskTimeout, [task.name, task.timeout]));
-				}, task.timeout);
-			})]);
-			this.logger.info(`${chalk.default.italic("Completed")} task ${chalk.default.bold.cyan(task.name)} in phase ${chalk.default.bold.magenta(StartupPhase[phase])}`);
-		} catch (error) {
-			if (!this.isStartingUp) return;
-			this.logger.error(`${chalk.default.italic("Failed")} task ${chalk.default.bold.cyan(task.name)} in phase ${chalk.default.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 _seedcord_logger.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 = (0, node_http.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.default.green.bold("✓")} Health check server listening on ${chalk.default.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.default.bold.red("Health check server stopped"));
-			});
-		});
-	}
-};
-
-//#endregion
-exports.CoordinatedLifecycle = CoordinatedLifecycle;
-exports.CoordinatedShutdown = CoordinatedShutdown;
-exports.CoordinatedStartup = CoordinatedStartup;
-exports.HealthCheck = HealthCheck;
-exports.ShutdownPhase = ShutdownPhase;
-exports.StartupPhase = StartupPhase;
-//# sourceMappingURL=node.index.cjs.map