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

package/dist/hmr.index.cjs

@@ -0,0 +1,166 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
+let _seedcord_utils = require("@seedcord/utils");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk, 1);
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let node_url = require("node:url");
+
+//#region src/hmr/HmrModuleHandler.ts
+const displayName = (unit, fallback) => unit.name ?? fallback;
+/**
+* Reloads THandler and optional TMiddleware modules on HMR updates.
+*
+* Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.
+*
+* This is only useful during development.
+*/
+var HmrModuleHandler = class {
+	store;
+	options;
+	constructor(options) {
+		this.options = {
+			...options,
+			logger: options.logger.inChannel("hmr")
+		};
+		this.store = {
+			fileToHandlers: /* @__PURE__ */ new Map(),
+			fileToMiddlewares: /* @__PURE__ */ new Map(),
+			handlerArtifacts: /* @__PURE__ */ new Map()
+		};
+	}
+	/** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */
+	async handle(event) {
+		const { file, affectedModules, type } = event;
+		const { logger, handlersDir, middlewaresDir } = this.options;
+		if (type === "delete" || type === "deleteDir") {
+			this.unload(file);
+			return;
+		}
+		if (type === "createDir") return;
+		if (type === "update" && !(0, node_fs.existsSync)(file)) {
+			if (this.isTracked(file)) {
+				logger.info(`Received update for non-existent file: ${(0, _seedcord_utils.formatFilePath)(file)}, treating as delete`);
+				this.unload(file);
+			}
+			return;
+		}
+		const rollbackEnabled = event.rollback ?? true;
+		const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];
+		const absHandlersDir = (0, node_path.resolve)(process.cwd(), handlersDir);
+		const absMiddlewaresDir = middlewaresDir ? (0, node_path.resolve)(process.cwd(), middlewaresDir) : null;
+		for (const fileToReload of filesToReload) {
+			const isHandler = fileToReload.startsWith(absHandlersDir + node_path.sep);
+			const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + node_path.sep) : false;
+			if (!isHandler && !isMiddleware) continue;
+			await this.reloadWithRollback(fileToReload, rollbackEnabled);
+		}
+	}
+	async reloadWithRollback(file, rollbackEnabled) {
+		const { logger } = this.options;
+		const snapshot = this.snapshotUnits(file);
+		this.unload(file);
+		if (await this.reloadFile(file)) return;
+		this.unload(file);
+		if (!rollbackEnabled) return;
+		if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;
+		this.restoreUnits(file, snapshot);
+		logger.warn(`${chalk.default.yellow.bold("Rolled back")} ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))} to the last-good version`);
+	}
+	/** Links the handler to its source file so a later update can unload it. */
+	trackHandler(file, handler) {
+		let set = this.store.fileToHandlers.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToHandlers.set(file, set);
+		}
+		set.add(handler);
+		if (this.options.getArtifacts) {
+			const artifacts = this.options.getArtifacts(handler);
+			this.store.handlerArtifacts.set(handler, artifacts);
+		}
+	}
+	/** Links the middleware to its source file so a later update can unload it. */
+	trackMiddleware(file, middleware) {
+		let set = this.store.fileToMiddlewares.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToMiddlewares.set(file, set);
+		}
+		set.add(middleware);
+	}
+	isTracked(file) {
+		return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);
+	}
+	unload(file) {
+		const { logger } = this.options;
+		const handlers = this.store.fileToHandlers.get(file);
+		if (handlers) {
+			for (const handler of handlers) {
+				const artifacts = this.store.handlerArtifacts.get(handler);
+				this.options.unregisterHandler(handler, artifacts);
+				this.store.handlerArtifacts.delete(handler);
+				const name = displayName(handler, "Handler");
+				logger.info(`${chalk.default.red.bold("Unloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			}
+			this.store.fileToHandlers.delete(file);
+		}
+		const middlewares = this.store.fileToMiddlewares.get(file);
+		if (middlewares) {
+			for (const middleware of middlewares) {
+				this.options.unregisterMiddleware?.(middleware);
+				const name = displayName(middleware, "Middleware");
+				logger.info(`${chalk.default.red.bold("Unloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			}
+			this.store.fileToMiddlewares.delete(file);
+		}
+	}
+	async reloadFile(file) {
+		const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;
+		if (!(0, node_fs.existsSync)(file)) {
+			logger.info(`File does not exist, skipping reload: ${(0, _seedcord_utils.formatFilePath)(file)}`);
+			return false;
+		}
+		try {
+			let fileUrl = (0, node_url.pathToFileURL)(file).href;
+			if (process.env.VITEST === "true") fileUrl += `?update=${Date.now()}`;
+			const imported = await import(fileUrl);
+			for (const val of Object.values(imported)) if (isHandler(val)) {
+				registerHandler(val, file);
+				this.trackHandler(file, val);
+				const name = displayName(val, "Handler");
+				logger.info(`${chalk.default.blue.bold("Reloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			} else if (isMiddleware && registerMiddleware && isMiddleware(val)) {
+				registerMiddleware(val, file);
+				this.trackMiddleware(file, val);
+				const name = displayName(val, "Middleware");
+				logger.info(`${chalk.default.blue.bold("Reloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			}
+			return true;
+		} catch (error) {
+			logger.error(`Failed to reload file: ${file}`, error);
+			return false;
+		}
+	}
+	snapshotUnits(file) {
+		return {
+			handlers: [...this.store.fileToHandlers.get(file) ?? []],
+			middlewares: [...this.store.fileToMiddlewares.get(file) ?? []]
+		};
+	}
+	restoreUnits(file, snapshot) {
+		for (const handler of snapshot.handlers) {
+			this.options.registerHandler(handler, file);
+			this.trackHandler(file, handler);
+		}
+		if (this.options.registerMiddleware) for (const middleware of snapshot.middlewares) {
+			this.options.registerMiddleware(middleware, file);
+			this.trackMiddleware(file, middleware);
+		}
+	}
+};
+
+//#endregion
+exports.HmrModuleHandler = HmrModuleHandler;
+//# sourceMappingURL=hmr.index.cjs.map

package/dist/hmr.index.cjs.map

@@ -0,0 +1 @@
+{"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":";;;;;;;;;;AAiBA,MAAM,eAAe,MAAe,aAA8B,KAA2B,QAAQ;;;;;;;;AAuBrG,IAAa,mBAAb,MAAkF;CAC9E,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAqE;EAE7E,KAAK,UAAU;GAAE,GAAG;GAAS,QAAQ,QAAQ,OAAO,UAAU,KAAK;EAAE;EAGrE,KAAK,QAAQ;GACT,gCAAgB,IAAI,IAAI;GACxB,mCAAmB,IAAI,IAAI;GAC3B,kCAAkB,IAAI,IAAI;EAC9B;CACJ;;CAGA,MAAa,OAAO,OAAsC;EACtD,MAAM,EAAE,MAAM,iBAAiB,SAAS;EACxC,MAAM,EAAE,QAAQ,aAAa,mBAAmB,KAAK;EAErD,IAAI,SAAS,YAAY,SAAS,aAAa;GAC3C,KAAK,OAAO,IAAI;GAChB;EACJ;EAGA,IAAI,SAAS,aAAa;EAE1B,IAAI,SAAS,YAAY,yBAAY,IAAI,GAAG;GACxC,IAAI,KAAK,UAAU,IAAI,GAAG;IACtB,OAAO,KAAK,8EAAyD,IAAI,EAAE,qBAAqB;IAChG,KAAK,OAAO,IAAI;GACpB;GACA;EACJ;EAEA,MAAM,kBAAkB,MAAM,YAAY;EAC1C,MAAM,gBAAgB,mBAAmB,gBAAgB,SAAS,IAAI,kBAAkB,CAAC,IAAI;EAC7F,MAAM,wCAAyB,QAAQ,IAAI,GAAG,WAAW;EACzD,MAAM,oBAAoB,wCAAyB,QAAQ,IAAI,GAAG,cAAc,IAAI;EAEpF,KAAK,MAAM,gBAAgB,eAAe;GAEtC,MAAM,YAAY,aAAa,WAAW,iBAAiBA,aAAG;GAC9D,MAAM,eAAe,oBAAoB,aAAa,WAAW,oBAAoBA,aAAG,IAAI;GAE5F,IAAI,CAAC,aAAa,CAAC,cACf;GAGJ,MAAM,KAAK,mBAAmB,cAAc,eAAe;EAC/D;CACJ;CAEA,MAAc,mBAAmB,MAAc,iBAAyC;EACpF,MAAM,EAAE,WAAW,KAAK;EACxB,MAAM,WAAW,KAAK,cAAc,IAAI;EACxC,KAAK,OAAO,IAAI;EAGhB,IAAI,MADmB,KAAK,WAAW,IAAI,GAC7B;EAGd,KAAK,OAAO,IAAI;EAChB,IAAI,CAAC,iBAAiB;EACtB,IAAI,SAAS,SAAS,WAAW,KAAK,SAAS,YAAY,WAAW,GAAG;EAGzE,KAAK,aAAa,MAAM,QAAQ;EAChC,OAAO,KAAK,GAAG,cAAM,OAAO,KAAK,aAAa,EAAE,GAAG,cAAM,yCAAoB,IAAI,CAAC,EAAE,0BAA0B;CAClH;;CAGA,AAAO,aAAa,MAAc,SAAyB;EACvD,IAAI,MAAM,KAAK,MAAM,eAAe,IAAI,IAAI;EAC5C,IAAI,CAAC,KAAK;GACN,sBAAM,IAAI,IAAI;GACd,KAAK,MAAM,eAAe,IAAI,MAAM,GAAG;EAC3C;EACA,IAAI,IAAI,OAAO;EAEf,IAAI,KAAK,QAAQ,cAAc;GAC3B,MAAM,YAAY,KAAK,QAAQ,aAAa,OAAO;GACnD,KAAK,MAAM,iBAAiB,IAAI,SAAS,SAAS;EACtD;CACJ;;CAGA,AAAO,gBAAgB,MAAc,YAA+B;EAChE,IAAI,MAAM,KAAK,MAAM,kBAAkB,IAAI,IAAI;EAC/C,IAAI,CAAC,KAAK;GACN,sBAAM,IAAI,IAAI;GACd,KAAK,MAAM,kBAAkB,IAAI,MAAM,GAAG;EAC9C;EACA,IAAI,IAAI,UAAU;CACtB;CAEA,AAAQ,UAAU,MAAuB;EACrC,OAAO,KAAK,MAAM,eAAe,IAAI,IAAI,KAAK,KAAK,MAAM,kBAAkB,IAAI,IAAI;CACvF;CAEA,AAAQ,OAAO,MAAoB;EAC/B,MAAM,EAAE,WAAW,KAAK;EACxB,MAAM,WAAW,KAAK,MAAM,eAAe,IAAI,IAAI;EACnD,IAAI,UAAU;GACV,KAAK,MAAM,WAAW,UAAU;IAC5B,MAAM,YAAY,KAAK,MAAM,iBAAiB,IAAI,OAAO;IACzD,KAAK,QAAQ,kBAAkB,SAAS,SAAS;IACjD,KAAK,MAAM,iBAAiB,OAAO,OAAO;IAC1C,MAAM,OAAO,YAAY,SAAS,SAAS;IAC3C,OAAO,KACH,GAAG,cAAM,IAAI,KAAK,UAAU,EAAE,GAAG,cAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,cAAM,yCAAoB,IAAI,CAAC,GAClG;GACJ;GACA,KAAK,MAAM,eAAe,OAAO,IAAI;EACzC;EAEA,MAAM,cAAc,KAAK,MAAM,kBAAkB,IAAI,IAAI;EACzD,IAAI,aAAa;GACb,KAAK,MAAM,cAAc,aAAa;IAClC,KAAK,QAAQ,uBAAuB,UAAU;IAC9C,MAAM,OAAO,YAAY,YAAY,YAAY;IACjD,OAAO,KACH,GAAG,cAAM,IAAI,KAAK,UAAU,EAAE,GAAG,cAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,cAAM,yCAAoB,IAAI,CAAC,GAClG;GACJ;GACA,KAAK,MAAM,kBAAkB,OAAO,IAAI;EAC5C;CACJ;CAEA,MAAc,WAAW,MAAgC;EACrD,MAAM,EAAE,QAAQ,WAAW,cAAc,iBAAiB,uBAAuB,KAAK;EAEtF,IAAI,yBAAY,IAAI,GAAG;GACnB,OAAO,KAAK,6EAAwD,IAAI,GAAG;GAC3E,OAAO;EACX;EAEA,IAAI;GACA,IAAI,sCAAwB,IAAI,CAAC,CAAC;GAElC,IAAI,QAAQ,IAAI,WAAW,QAAQ,WAAW,WAAW,KAAK,IAAI;GAGlE,MAAM,WAAY,MAAM,OAAO;GAE/B,KAAK,MAAM,OAAO,OAAO,OAAO,QAAQ,GACpC,IAAI,UAAU,GAAG,GAAG;IAChB,gBAAgB,KAAK,IAAI;IACzB,KAAK,aAAa,MAAM,GAAG;IAC3B,MAAM,OAAO,YAAY,KAAK,SAAS;IACvC,OAAO,KACH,GAAG,cAAM,KAAK,KAAK,UAAU,EAAE,GAAG,cAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,cAAM,yCAAoB,IAAI,CAAC,GACnG;GACJ,OAAO,IAAI,gBAAgB,sBAAsB,aAAa,GAAG,GAAG;IAChE,mBAAmB,KAAK,IAAI;IAC5B,KAAK,gBAAgB,MAAM,GAAG;IAC9B,MAAM,OAAO,YAAY,KAAK,YAAY;IAC1C,OAAO,KACH,GAAG,cAAM,KAAK,KAAK,UAAU,EAAE,GAAG,cAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,cAAM,yCAAoB,IAAI,CAAC,GACnG;GACJ;GAGJ,OAAO;EACX,SAAS,OAAO;GACZ,OAAO,MAAM,0BAA0B,QAAQ,KAAK;GACpD,OAAO;EACX;CACJ;CAGA,AAAQ,cAAc,MAAoE;EACtF,OAAO;GACH,UAAU,CAAC,GAAI,KAAK,MAAM,eAAe,IAAI,IAAI,KAAK,CAAC,CAAE;GACzD,aAAa,CAAC,GAAI,KAAK,MAAM,kBAAkB,IAAI,IAAI,KAAK,CAAC,CAAE;EACnE;CACJ;CAEA,AAAQ,aAAa,MAAc,UAAsE;EACrG,KAAK,MAAM,WAAW,SAAS,UAAU;GACrC,KAAK,QAAQ,gBAAgB,SAAS,IAAI;GAC1C,KAAK,aAAa,MAAM,OAAO;EACnC;EAEA,IAAI,KAAK,QAAQ,oBACb,KAAK,MAAM,cAAc,SAAS,aAAa;GAC3C,KAAK,QAAQ,mBAAmB,YAAY,IAAI;GAChD,KAAK,gBAAgB,MAAM,UAAU;EACzC;CAER;AACJ"}

package/dist/hmr.index.d.cts

@@ -0,0 +1 @@
+export type * from './hmr.index.d.mts'

package/dist/hmr.index.d.mts

@@ -0,0 +1,44 @@
+import { Logger } from "@seedcord/logger";
+import { HmrUpdateEvent } from "@seedcord/types";
+
+//#region src/hmr/HmrModuleHandler.d.ts
+interface HmrModuleHandlerOptions<THandler, TMiddleware = void, TArtifacts = unknown> {
+  handlersDir: string;
+  middlewaresDir?: string;
+  isHandler: (val: unknown) => val is THandler;
+  isMiddleware?: (val: unknown) => val is TMiddleware;
+  registerHandler: (handler: THandler, file: string) => void;
+  registerMiddleware?: (middleware: TMiddleware, file: string) => void;
+  unregisterHandler: (handler: THandler, artifacts?: TArtifacts) => void;
+  unregisterMiddleware?: (middleware: TMiddleware) => void;
+  /** Snapshotted per handler so a rollback re-registers with the same artifacts after the module re-imports. */
+  getArtifacts?: (handler: THandler) => TArtifacts;
+  logger: Logger;
+}
+/**
+ * Reloads THandler and optional TMiddleware modules on HMR updates.
+ *
+ * Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.
+ *
+ * This is only useful during development.
+ */
+declare class HmrModuleHandler<THandler, TMiddleware = void, TArtifacts = unknown> {
+  private readonly store;
+  private readonly options;
+  constructor(options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>);
+  /** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */
+  handle(event: HmrUpdateEvent): Promise<void>;
+  private reloadWithRollback;
+  /** Links the handler to its source file so a later update can unload it. */
+  trackHandler(file: string, handler: THandler): void;
+  /** Links the middleware to its source file so a later update can unload it. */
+  trackMiddleware(file: string, middleware: TMiddleware): void;
+  private isTracked;
+  private unload;
+  private reloadFile;
+  private snapshotUnits;
+  private restoreUnits;
+}
+//#endregion
+export { HmrModuleHandler };
+//# sourceMappingURL=hmr.index.d.mts.map

package/dist/hmr.index.mjs

@@ -0,0 +1,163 @@
+import { formatFilePath } from "@seedcord/utils";
+import chalk from "chalk";
+import { existsSync } from "node:fs";
+import { resolve, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+
+//#region src/hmr/HmrModuleHandler.ts
+const displayName = (unit, fallback) => unit.name ?? fallback;
+/**
+* Reloads THandler and optional TMiddleware modules on HMR updates.
+*
+* Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.
+*
+* This is only useful during development.
+*/
+var HmrModuleHandler = class {
+	store;
+	options;
+	constructor(options) {
+		this.options = {
+			...options,
+			logger: options.logger.inChannel("hmr")
+		};
+		this.store = {
+			fileToHandlers: /* @__PURE__ */ new Map(),
+			fileToMiddlewares: /* @__PURE__ */ new Map(),
+			handlerArtifacts: /* @__PURE__ */ new Map()
+		};
+	}
+	/** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */
+	async handle(event) {
+		const { file, affectedModules, type } = event;
+		const { logger, handlersDir, middlewaresDir } = this.options;
+		if (type === "delete" || type === "deleteDir") {
+			this.unload(file);
+			return;
+		}
+		if (type === "createDir") return;
+		if (type === "update" && !existsSync(file)) {
+			if (this.isTracked(file)) {
+				logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);
+				this.unload(file);
+			}
+			return;
+		}
+		const rollbackEnabled = event.rollback ?? true;
+		const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];
+		const absHandlersDir = resolve(process.cwd(), handlersDir);
+		const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;
+		for (const fileToReload of filesToReload) {
+			const isHandler = fileToReload.startsWith(absHandlersDir + sep);
+			const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;
+			if (!isHandler && !isMiddleware) continue;
+			await this.reloadWithRollback(fileToReload, rollbackEnabled);
+		}
+	}
+	async reloadWithRollback(file, rollbackEnabled) {
+		const { logger } = this.options;
+		const snapshot = this.snapshotUnits(file);
+		this.unload(file);
+		if (await this.reloadFile(file)) return;
+		this.unload(file);
+		if (!rollbackEnabled) return;
+		if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;
+		this.restoreUnits(file, snapshot);
+		logger.warn(`${chalk.yellow.bold("Rolled back")} ${chalk.gray(formatFilePath(file))} to the last-good version`);
+	}
+	/** Links the handler to its source file so a later update can unload it. */
+	trackHandler(file, handler) {
+		let set = this.store.fileToHandlers.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToHandlers.set(file, set);
+		}
+		set.add(handler);
+		if (this.options.getArtifacts) {
+			const artifacts = this.options.getArtifacts(handler);
+			this.store.handlerArtifacts.set(handler, artifacts);
+		}
+	}
+	/** Links the middleware to its source file so a later update can unload it. */
+	trackMiddleware(file, middleware) {
+		let set = this.store.fileToMiddlewares.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToMiddlewares.set(file, set);
+		}
+		set.add(middleware);
+	}
+	isTracked(file) {
+		return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);
+	}
+	unload(file) {
+		const { logger } = this.options;
+		const handlers = this.store.fileToHandlers.get(file);
+		if (handlers) {
+			for (const handler of handlers) {
+				const artifacts = this.store.handlerArtifacts.get(handler);
+				this.options.unregisterHandler(handler, artifacts);
+				this.store.handlerArtifacts.delete(handler);
+				const name = displayName(handler, "Handler");
+				logger.info(`${chalk.red.bold("Unloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			}
+			this.store.fileToHandlers.delete(file);
+		}
+		const middlewares = this.store.fileToMiddlewares.get(file);
+		if (middlewares) {
+			for (const middleware of middlewares) {
+				this.options.unregisterMiddleware?.(middleware);
+				const name = displayName(middleware, "Middleware");
+				logger.info(`${chalk.red.bold("Unloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			}
+			this.store.fileToMiddlewares.delete(file);
+		}
+	}
+	async reloadFile(file) {
+		const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;
+		if (!existsSync(file)) {
+			logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);
+			return false;
+		}
+		try {
+			let fileUrl = pathToFileURL(file).href;
+			if (process.env.VITEST === "true") fileUrl += `?update=${Date.now()}`;
+			const imported = await import(fileUrl);
+			for (const val of Object.values(imported)) if (isHandler(val)) {
+				registerHandler(val, file);
+				this.trackHandler(file, val);
+				const name = displayName(val, "Handler");
+				logger.info(`${chalk.blue.bold("Reloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			} else if (isMiddleware && registerMiddleware && isMiddleware(val)) {
+				registerMiddleware(val, file);
+				this.trackMiddleware(file, val);
+				const name = displayName(val, "Middleware");
+				logger.info(`${chalk.blue.bold("Reloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			}
+			return true;
+		} catch (error) {
+			logger.error(`Failed to reload file: ${file}`, error);
+			return false;
+		}
+	}
+	snapshotUnits(file) {
+		return {
+			handlers: [...this.store.fileToHandlers.get(file) ?? []],
+			middlewares: [...this.store.fileToMiddlewares.get(file) ?? []]
+		};
+	}
+	restoreUnits(file, snapshot) {
+		for (const handler of snapshot.handlers) {
+			this.options.registerHandler(handler, file);
+			this.trackHandler(file, handler);
+		}
+		if (this.options.registerMiddleware) for (const middleware of snapshot.middlewares) {
+			this.options.registerMiddleware(middleware, file);
+			this.trackMiddleware(file, middleware);
+		}
+	}
+};
+
+//#endregion
+export { HmrModuleHandler };
+//# sourceMappingURL=hmr.index.mjs.map

package/dist/hmr.index.mjs.map

@@ -0,0 +1 @@
+{"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/index.cjs

@@ -432,7 +432,7 @@ function paginate(items, page, perPage) {
 //#endregion
 //#region src/index.ts
 /** Package version */
-const version = "0.1.0-next.3";
+const version = "0.1.0-next.4";
 
 //#endregion
 exports.BuilderComponent = require_CustomId.BuilderComponent;

package/dist/index.mjs

@@ -431,7 +431,7 @@ function paginate(items, page, perPage) {
 //#endregion
 //#region src/index.ts
 /** Package version */
-const version = "0.1.0-next.3";
+const version = "0.1.0-next.4";
 
 //#endregion
 export { BuilderComponent, Cooldown, CustomId, DispatchContext, DmOnly, Fault, GuildOnly, Notice, OwnerOnly, RegisterCommand, RowComponent, Silence, and, defineEffectGate, defineGate, or, paginate, version };

package/dist/internal.index.cjs

@@ -1,5 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
 const require_CustomId = require('./CustomId-DV7daU7r.cjs');
+let _seedcord_utils = require("@seedcord/utils");
+let _seedcord_logger = require("@seedcord/logger");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk, 1);
+let envapt = require("envapt");
 
 //#region src/gates/runGates.ts
 function routeIdOf(handlerCtor) {
@@ -30,6 +36,72 @@ async function runHandlerGates(handlerCtor, ctx) {
 	});
 }
 
+//#endregion
+//#region src/hmr/devChannel.ts
+let channel;
+/** @internal */
+function setDevChannel(next) {
+	channel = next;
+}
+/** @internal */
+function getDevChannel() {
+	return channel;
+}
+
+//#endregion
+//#region src/hmr/wrapHot.ts
+/**
+* Wraps a raw vite hot object as a typed {@link DevChannel}.
+*
+* @internal
+*/
+function wrapHot(hot) {
+	return {
+		send: (event, data) => hot.send(event, data),
+		on: (event, cb) => hot.on(event, cb)
+	};
+}
+
+//#endregion
+//#region src/hmr/HmrManager.ts
+var HmrManager = class {
+	logger = new _seedcord_logger.Logger("HMR", { channel: "hmr" });
+	listeners = /* @__PURE__ */ new Set();
+	/** @internal */
+	init() {
+		if (!{}.hot) return;
+		const channel = wrapHot({}.hot);
+		setDevChannel(channel);
+		if (envapt.Envapter.isDevelopment || envapt.Envapter.isTest) {
+			this.logger.info("Enabled");
+			channel.on("seedcord:hmr", (payload) => {
+				const affected = payload.affectedModules?.length ?? 0;
+				this.logger.info(`${chalk.default.bold("1")} module changed, ${chalk.default.bold(affected)} affected modules`);
+				if (payload.affectedModules) this.logger.utils.list(payload.affectedModules.map((mod) => (0, _seedcord_utils.formatFilePath)(mod)), "Affected modules: ");
+				this.handleUpdate(payload);
+			});
+		}
+	}
+	/** @internal */
+	register(listener) {
+		this.listeners.add(listener);
+	}
+	/** @internal */
+	unregister(listener) {
+		this.listeners.delete(listener);
+	}
+	async handleUpdate(event) {
+		const promises = [...this.listeners].map(async (listener) => {
+			try {
+				await listener.onHmr(event);
+			} catch (error) {
+				this.logger.error(`Error handling HMR update in ${chalk.default.bold(listener.name)}: `, error);
+			}
+		});
+		await Promise.all(promises);
+	}
+};
+
 //#endregion
 //#region src/customId/routing.ts
 /**
@@ -55,6 +127,7 @@ exports.ComponentDefsKey = ComponentDefsKey;
 exports.EventMetadataKey = require_CustomId.EventMetadataKey;
 exports.GateNotice = require_CustomId.GateNotice;
 exports.GatedMetadataKey = require_CustomId.GatedMetadataKey;
+exports.HmrManager = HmrManager;
 exports.InteractionMetadataKey = require_CustomId.InteractionMetadataKey;
 exports.InteractionRouteKeys = require_CustomId.InteractionRouteKeys;
 exports.InteractionRoutes = require_CustomId.InteractionRoutes;
@@ -69,6 +142,7 @@ exports.OnCooldown = require_CustomId.OnCooldown;
 exports.PAGE_MAX = PAGE_MAX;
 exports.SubscribeMetadataKey = require_CustomId.SubscribeMetadataKey;
 exports.decodeFor = require_CustomId.decodeFor;
+exports.getDevChannel = getDevChannel;
 exports.pageCursor = pageCursor;
 exports.pickNotice = require_CustomId.pickNotice;
 exports.prefixOf = require_CustomId.prefixOf;
@@ -76,4 +150,6 @@ exports.routeIdOf = routeIdOf;
 exports.runGates = runGates;
 exports.runHandlerGates = runHandlerGates;
 exports.setBotColor = require_CustomId.setBotColor;
+exports.setDevChannel = setDevChannel;
+exports.wrapHot = wrapHot;
 //# sourceMappingURL=internal.index.cjs.map

package/dist/internal.index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.index.cjs","names":["InteractionRouteKeys","runCheck","runCommits","GatedMetadataKey","CustomId"],"sources":["../src/gates/runGates.ts","../src/customId/routing.ts","../src/pagination/cursor.ts"],"sourcesContent":["import { GatedMetadataKey, InteractionRouteKeys } from '@src/metadataKeys';\n\nimport { discardCommits, runCheck, runCommits } from './effects';\n\nimport type { Gate, GateContextBase } from './Gate';\n\n// the stable id a route decorator stored, e.g. slash:daily or button:confirm. null for a plain event handler.\nexport function routeIdOf(handlerCtor: object): string | null {\n    for (const [kind, key] of Object.entries(InteractionRouteKeys)) {\n        // justified: getMetadata returns any, this key only ever stores the route/prefix string array\n        const routes = Reflect.getMetadata(key, handlerCtor) as string[] | undefined;\n        if (routes?.length) return `${kind}:${routes.join(',')}`;\n    }\n    return null;\n}\n\n/**\n * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect\n * gate's commit runs once the whole set passes.\n */\nexport async function runGates(gates: readonly Gate<GateContextBase>[], ctx: GateContextBase): Promise<void> {\n    try {\n        for (const gate of gates) {\n            await runCheck(gate, ctx);\n        }\n        await runCommits(ctx);\n    } finally {\n        discardCommits(ctx);\n    }\n}\n\n// dispatchers call this before execute, inside the boundary, so a refusal renders or drops\nexport async function runHandlerGates(handlerCtor: object, ctx: GateContextBase): Promise<void> {\n    // justified: getMetadata returns any, and this key only ever stores the @Gated gate array\n    const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor) as readonly Gate<GateContextBase>[] | undefined;\n    if (!gates) return;\n    await runGates(gates, { ...ctx, routeId: routeIdOf(handlerCtor) });\n}\n","import type { AnyCustomId } from './CustomId';\n\n/**\n * The route decorators store a handler's customId definitions here so the component base can decode\n * against them at runtime.\n *\n * @internal\n */\nexport const ComponentDefsKey = Symbol('seedcord:customId:componentDefs');\n\n/**\n * The phantom a component handler base carries. A route decorator constrains its argument to this, so\n * passing different definitions to the decorator and the handler's generic is a compile error. Never set at runtime.\n *\n * @internal\n */\nexport interface HasComponentDefs<Defs extends readonly AnyCustomId[]> {\n    readonly __componentDefs?: Defs;\n}\n","import { CustomId } from '@customId/CustomId';\n\nimport type { CustomIdField } from '@customId/Field';\n\n// Included in the layout hash so it is fixed per prefix. Reducing it marks every active button as StaleCustomId.\n// @internal\nexport const PAGE_MAX = 1_000_000;\n\n// Discord rejects a message with duplicate custom_ids, and two controls can target the same page (first and\n// prev both hit 0), so each control uses a distinct slot.\n// @internal\nconst SLOT_MAX = 4;\n\n/** Page cursor for a paginator. */\nexport type PageCursor<Prefix extends string> = CustomId<\n    Prefix,\n    { page: CustomIdField<number>; slot: CustomIdField<number> }\n>;\n\n/** Build the page cursor for a paginator. */\nexport function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix> {\n    return new CustomId(prefix).int('page', 0, PAGE_MAX).int('slot', 0, SLOT_MAX);\n}\n"],"mappings":";;;;AAOA,SAAgB,UAAU,aAAoC;CAC1D,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQA,qCAAoB,GAAG;EAE5D,MAAM,SAAS,QAAQ,YAAY,KAAK,WAAW;EACnD,IAAI,QAAQ,QAAQ,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,GAAG;CACzD;CACA,OAAO;AACX;;;;;AAMA,eAAsB,SAAS,OAAyC,KAAqC;CACzG,IAAI;EACA,KAAK,MAAM,QAAQ,OACf,MAAMC,0BAAS,MAAM,GAAG;EAE5B,MAAMC,4BAAW,GAAG;CACxB,UAAU;EACN,gCAAe,GAAG;CACtB;AACJ;AAGA,eAAsB,gBAAgB,aAAqB,KAAqC;CAE5F,MAAM,QAAQ,QAAQ,YAAYC,mCAAkB,WAAW;CAC/D,IAAI,CAAC,OAAO;CACZ,MAAM,SAAS,OAAO;EAAE,GAAG;EAAK,SAAS,UAAU,WAAW;CAAE,CAAC;AACrE;;;;;;;;;;AC7BA,MAAa,mBAAmB,OAAO,iCAAiC;;;;ACFxE,MAAa,WAAW;AAKxB,MAAM,WAAW;;AASjB,SAAgB,WAAkC,QAAoC;CAClF,OAAO,IAAIC,0BAAS,MAAM,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ;AAChF"}
+{"version":3,"file":"internal.index.cjs","names":["InteractionRouteKeys","runCheck","runCommits","GatedMetadataKey","Logger","Envapter","CustomId"],"sources":["../src/gates/runGates.ts","../src/hmr/devChannel.ts","../src/hmr/wrapHot.ts","../src/hmr/HmrManager.ts","../src/customId/routing.ts","../src/pagination/cursor.ts"],"sourcesContent":["import { GatedMetadataKey, InteractionRouteKeys } from '@src/metadataKeys';\n\nimport { discardCommits, runCheck, runCommits } from './effects';\n\nimport type { Gate, GateContextBase } from './Gate';\n\n// the stable id a route decorator stored, e.g. slash:daily or button:confirm. null for a plain event handler.\nexport function routeIdOf(handlerCtor: object): string | null {\n    for (const [kind, key] of Object.entries(InteractionRouteKeys)) {\n        // justified: getMetadata returns any, this key only ever stores the route/prefix string array\n        const routes = Reflect.getMetadata(key, handlerCtor) as string[] | undefined;\n        if (routes?.length) return `${kind}:${routes.join(',')}`;\n    }\n    return null;\n}\n\n/**\n * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect\n * gate's commit runs once the whole set passes.\n */\nexport async function runGates(gates: readonly Gate<GateContextBase>[], ctx: GateContextBase): Promise<void> {\n    try {\n        for (const gate of gates) {\n            await runCheck(gate, ctx);\n        }\n        await runCommits(ctx);\n    } finally {\n        discardCommits(ctx);\n    }\n}\n\n// dispatchers call this before execute, inside the boundary, so a refusal renders or drops\nexport async function runHandlerGates(handlerCtor: object, ctx: GateContextBase): Promise<void> {\n    // justified: getMetadata returns any, and this key only ever stores the @Gated gate array\n    const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor) as readonly Gate<GateContextBase>[] | undefined;\n    if (!gates) return;\n    await runGates(gates, { ...ctx, routeId: routeIdOf(handlerCtor) });\n}\n","import type { DevChannel, SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\n// one module instance per process, the HmrManager write and every framework read share it\nlet channel: DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined;\n\n/** @internal */\nexport function setDevChannel(next: DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined): void {\n    channel = next;\n}\n\n/** @internal */\nexport function getDevChannel(): DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined {\n    return channel;\n}\n","import type { DevChannel } from '@seedcord/types/internal';\n\n// the minimal raw-hot shape, satisfied by both vite's `import.meta.hot` and the CLI's `NormalizedHotChannel`.\ninterface RawHot {\n    send(event: string, data?: unknown): void;\n    on(event: string, cb: (data: unknown) => void): void;\n}\n\n/**\n * Wraps a raw vite hot object as a typed {@link DevChannel}.\n *\n * @internal\n */\nexport function wrapHot<TSend, TRecv>(hot: RawHot): DevChannel<TSend, TRecv> {\n    return {\n        send: (event, data) => hot.send(event, data),\n        // justified: RawHot types every payload as unknown, the wire contract guarantees it matches TRecv[Key]\n        on: (event, cb) => hot.on(event, cb as (data: unknown) => void)\n    };\n}\n","// scoped here so import.meta.hot stays untyped in the rest of the package\n/// <reference types=\"vite/client\" />\nimport { Logger } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\nimport { Envapter } from 'envapt';\n\nimport { setDevChannel } from './devChannel';\nimport { wrapHot } from './wrapHot';\n\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\nexport class HmrManager {\n    private readonly logger = new Logger('HMR', { channel: 'hmr' });\n    private readonly listeners = new Set<HmrAware>();\n\n    /** @internal */\n    public init(): void {\n        if (!import.meta.hot) return;\n        // the only raw `import.meta.hot` read in the framework\n        const channel = wrapHot<SeedcordFrameworkEvents, SeedcordCliEvents>(import.meta.hot);\n        setDevChannel(channel);\n\n        if (Envapter.isDevelopment || Envapter.isTest) {\n            this.logger.info('Enabled');\n\n            channel.on('seedcord:hmr', (payload) => {\n                const affected = payload.affectedModules?.length ?? 0;\n                this.logger.info(`${chalk.bold('1')} module changed, ${chalk.bold(affected)} affected modules`);\n\n                if (payload.affectedModules) {\n                    this.logger.utils.list(\n                        payload.affectedModules.map((mod) => formatFilePath(mod)),\n                        'Affected modules: '\n                    );\n                }\n\n                void this.handleUpdate(payload);\n            });\n        }\n    }\n\n    /** @internal */\n    public register(listener: HmrAware): void {\n        this.listeners.add(listener);\n    }\n\n    /** @internal */\n    public unregister(listener: HmrAware): void {\n        this.listeners.delete(listener);\n    }\n\n    private async handleUpdate(event: HmrUpdateEvent): Promise<void> {\n        const promises = [...this.listeners].map(async (listener) => {\n            try {\n                await listener.onHmr(event);\n            } catch (error) {\n                this.logger.error(`Error handling HMR update in ${chalk.bold(listener.name)}: `, error);\n            }\n        });\n\n        await Promise.all(promises);\n    }\n}\n","import type { AnyCustomId } from './CustomId';\n\n/**\n * The route decorators store a handler's customId definitions here so the component base can decode\n * against them at runtime.\n *\n * @internal\n */\nexport const ComponentDefsKey = Symbol('seedcord:customId:componentDefs');\n\n/**\n * The phantom a component handler base carries. A route decorator constrains its argument to this, so\n * passing different definitions to the decorator and the handler's generic is a compile error. Never set at runtime.\n *\n * @internal\n */\nexport interface HasComponentDefs<Defs extends readonly AnyCustomId[]> {\n    readonly __componentDefs?: Defs;\n}\n","import { CustomId } from '@customId/CustomId';\n\nimport type { CustomIdField } from '@customId/Field';\n\n// Included in the layout hash so it is fixed per prefix. Reducing it marks every active button as StaleCustomId.\n// @internal\nexport const PAGE_MAX = 1_000_000;\n\n// Discord rejects a message with duplicate custom_ids, and two controls can target the same page (first and\n// prev both hit 0), so each control uses a distinct slot.\n// @internal\nconst SLOT_MAX = 4;\n\n/** Page cursor for a paginator. */\nexport type PageCursor<Prefix extends string> = CustomId<\n    Prefix,\n    { page: CustomIdField<number>; slot: CustomIdField<number> }\n>;\n\n/** Build the page cursor for a paginator. */\nexport function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix> {\n    return new CustomId(prefix).int('page', 0, PAGE_MAX).int('slot', 0, SLOT_MAX);\n}\n"],"mappings":";;;;;;;;;;AAOA,SAAgB,UAAU,aAAoC;CAC1D,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQA,qCAAoB,GAAG;EAE5D,MAAM,SAAS,QAAQ,YAAY,KAAK,WAAW;EACnD,IAAI,QAAQ,QAAQ,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,GAAG;CACzD;CACA,OAAO;AACX;;;;;AAMA,eAAsB,SAAS,OAAyC,KAAqC;CACzG,IAAI;EACA,KAAK,MAAM,QAAQ,OACf,MAAMC,0BAAS,MAAM,GAAG;EAE5B,MAAMC,4BAAW,GAAG;CACxB,UAAU;EACN,gCAAe,GAAG;CACtB;AACJ;AAGA,eAAsB,gBAAgB,aAAqB,KAAqC;CAE5F,MAAM,QAAQ,QAAQ,YAAYC,mCAAkB,WAAW;CAC/D,IAAI,CAAC,OAAO;CACZ,MAAM,SAAS,OAAO;EAAE,GAAG;EAAK,SAAS,UAAU,WAAW;CAAE,CAAC;AACrE;;;;AClCA,IAAI;;AAGJ,SAAgB,cAAc,MAAgF;CAC1G,UAAU;AACd;;AAGA,SAAgB,gBAAoF;CAChG,OAAO;AACX;;;;;;;;;ACAA,SAAgB,QAAsB,KAAuC;CACzE,OAAO;EACH,OAAO,OAAO,SAAS,IAAI,KAAK,OAAO,IAAI;EAE3C,KAAK,OAAO,OAAO,IAAI,GAAG,OAAO,EAA6B;CAClE;AACJ;;;;ACNA,IAAa,aAAb,MAAwB;CACpB,AAAiB,SAAS,IAAIC,wBAAO,OAAO,EAAE,SAAS,MAAM,CAAC;CAC9D,AAAiB,4BAAY,IAAI,IAAc;;CAG/C,AAAO,OAAa;EAChB,IAAI,IAAa,KAAK;EAEtB,MAAM,UAAU,WAAgE,GAAG;EACnF,cAAc,OAAO;EAErB,IAAIC,gBAAS,iBAAiBA,gBAAS,QAAQ;GAC3C,KAAK,OAAO,KAAK,SAAS;GAE1B,QAAQ,GAAG,iBAAiB,YAAY;IACpC,MAAM,WAAW,QAAQ,iBAAiB,UAAU;IACpD,KAAK,OAAO,KAAK,GAAG,cAAM,KAAK,GAAG,EAAE,mBAAmB,cAAM,KAAK,QAAQ,EAAE,kBAAkB;IAE9F,IAAI,QAAQ,iBACR,KAAK,OAAO,MAAM,KACd,QAAQ,gBAAgB,KAAK,4CAAuB,GAAG,CAAC,GACxD,oBACJ;IAGJ,AAAK,KAAK,aAAa,OAAO;GAClC,CAAC;EACL;CACJ;;CAGA,AAAO,SAAS,UAA0B;EACtC,KAAK,UAAU,IAAI,QAAQ;CAC/B;;CAGA,AAAO,WAAW,UAA0B;EACxC,KAAK,UAAU,OAAO,QAAQ;CAClC;CAEA,MAAc,aAAa,OAAsC;EAC7D,MAAM,WAAW,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,IAAI,OAAO,aAAa;GACzD,IAAI;IACA,MAAM,SAAS,MAAM,KAAK;GAC9B,SAAS,OAAO;IACZ,KAAK,OAAO,MAAM,gCAAgC,cAAM,KAAK,SAAS,IAAI,EAAE,KAAK,KAAK;GAC1F;EACJ,CAAC;EAED,MAAM,QAAQ,IAAI,QAAQ;CAC9B;AACJ;;;;;;;;;;ACxDA,MAAa,mBAAmB,OAAO,iCAAiC;;;;ACFxE,MAAa,WAAW;AAKxB,MAAM,WAAW;;AASjB,SAAgB,WAAkC,QAAoC;CAClF,OAAO,IAAIC,0BAAS,MAAM,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ;AAChF"}

package/dist/internal.index.d.mts

@@ -1,5 +1,6 @@
 import { C as BuilderComponent, a as CustomIdField, c as pickNotice, g as GateContextBase, h as Gate, i as prefixOf, l as GateFitsWith, n as CustomId, o as DecodedParams, p as Notice, r as decodeFor, t as AnyCustomId, x as CommandMeta } from "./CustomId--QizzBOn.mjs";
-import { BotColor, EpochMs, ReplyResponse } from "@seedcord/types";
+import { BotColor, EpochMs, HmrAware, ReplyResponse } from "@seedcord/types";
+import { DevChannel, SeedcordCliEvents, SeedcordFrameworkEvents } from "@seedcord/types/internal";
 
 //#region src/components/botColorHolder.d.ts
 declare function setBotColor(color: BotColor | undefined): void;
@@ -13,6 +14,37 @@ declare function routeIdOf(handlerCtor: object): string | null;
 declare function runGates(gates: readonly Gate<GateContextBase>[], ctx: GateContextBase): Promise<void>;
 declare function runHandlerGates(handlerCtor: object, ctx: GateContextBase): Promise<void>;
 //#endregion
+//#region src/hmr/devChannel.d.ts
+/** @internal */
+declare function setDevChannel(next: DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined): void;
+/** @internal */
+declare function getDevChannel(): DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined;
+//#endregion
+//#region src/hmr/HmrManager.d.ts
+declare class HmrManager {
+  private readonly logger;
+  private readonly listeners;
+  /** @internal */
+  init(): void;
+  /** @internal */
+  register(listener: HmrAware): void;
+  /** @internal */
+  unregister(listener: HmrAware): void;
+  private handleUpdate;
+}
+//#endregion
+//#region src/hmr/wrapHot.d.ts
+interface RawHot {
+  send(event: string, data?: unknown): void;
+  on(event: string, cb: (data: unknown) => void): void;
+}
+/**
+ * Wraps a raw vite hot object as a typed {@link DevChannel}.
+ *
+ * @internal
+ */
+declare function wrapHot<TSend, TRecv>(hot: RawHot): DevChannel<TSend, TRecv>;
+//#endregion
 //#region src/notices/index.d.ts
 declare abstract class GateNotice extends Notice {
   render(): ReplyResponse;
@@ -99,5 +131,5 @@ type PageCursor<Prefix extends string> = CustomId<Prefix, {
 /** Build the page cursor for a paginator. */
 declare function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix>;
 //#endregion
-export { type AnyCustomId, type CommandMeta, CommandMetadataKey, ComponentDefsKey, type DecodedParams, EventMetadataKey, type GateFitsWith, GateNotice, GatedMetadataKey, type HasComponentDefs, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, type PageCursor, SubscribeMetadataKey, decodeFor, pageCursor, pickNotice, prefixOf, routeIdOf, runGates, runHandlerGates, setBotColor };
+export { type AnyCustomId, type CommandMeta, CommandMetadataKey, ComponentDefsKey, type DecodedParams, EventMetadataKey, type GateFitsWith, GateNotice, GatedMetadataKey, type HasComponentDefs, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, type PageCursor, SubscribeMetadataKey, decodeFor, getDevChannel, pageCursor, pickNotice, prefixOf, routeIdOf, runGates, runHandlerGates, setBotColor, setDevChannel, wrapHot };
 //# sourceMappingURL=internal.index.d.mts.map

package/dist/internal.index.mjs

@@ -1,4 +1,8 @@
 import { C as EventMetadataKey, D as InteractionRoutes, E as InteractionRouteKeys, O as MiddlewareMetadataKey, S as CommandMetadataKey, T as InteractionMetadataKey, _ as NoticeCard, a as discardCommits, b as setBotColor, c as runCheck, d as NeedsAny, f as NotAllowed, g as OnCooldown, h as NotOwner, i as pickNotice, k as SubscribeMetadataKey, l as runCommits, m as NotInGuild, n as decodeFor, p as NotInDm, r as prefixOf, t as CustomId, u as GateNotice, w as GatedMetadataKey } from "./CustomId-epJayEGO.mjs";
+import { formatFilePath } from "@seedcord/utils";
+import { Logger } from "@seedcord/logger";
+import chalk from "chalk";
+import { Envapter } from "envapt";
 
 //#region src/gates/runGates.ts
 function routeIdOf(handlerCtor) {
@@ -29,6 +33,72 @@ async function runHandlerGates(handlerCtor, ctx) {
 	});
 }
 
+//#endregion
+//#region src/hmr/devChannel.ts
+let channel;
+/** @internal */
+function setDevChannel(next) {
+	channel = next;
+}
+/** @internal */
+function getDevChannel() {
+	return channel;
+}
+
+//#endregion
+//#region src/hmr/wrapHot.ts
+/**
+* Wraps a raw vite hot object as a typed {@link DevChannel}.
+*
+* @internal
+*/
+function wrapHot(hot) {
+	return {
+		send: (event, data) => hot.send(event, data),
+		on: (event, cb) => hot.on(event, cb)
+	};
+}
+
+//#endregion
+//#region src/hmr/HmrManager.ts
+var HmrManager = class {
+	logger = new Logger("HMR", { channel: "hmr" });
+	listeners = /* @__PURE__ */ new Set();
+	/** @internal */
+	init() {
+		if (!import.meta.hot) return;
+		const channel = wrapHot(import.meta.hot);
+		setDevChannel(channel);
+		if (Envapter.isDevelopment || Envapter.isTest) {
+			this.logger.info("Enabled");
+			channel.on("seedcord:hmr", (payload) => {
+				const affected = payload.affectedModules?.length ?? 0;
+				this.logger.info(`${chalk.bold("1")} module changed, ${chalk.bold(affected)} affected modules`);
+				if (payload.affectedModules) this.logger.utils.list(payload.affectedModules.map((mod) => formatFilePath(mod)), "Affected modules: ");
+				this.handleUpdate(payload);
+			});
+		}
+	}
+	/** @internal */
+	register(listener) {
+		this.listeners.add(listener);
+	}
+	/** @internal */
+	unregister(listener) {
+		this.listeners.delete(listener);
+	}
+	async handleUpdate(event) {
+		const promises = [...this.listeners].map(async (listener) => {
+			try {
+				await listener.onHmr(event);
+			} catch (error) {
+				this.logger.error(`Error handling HMR update in ${chalk.bold(listener.name)}: `, error);
+			}
+		});
+		await Promise.all(promises);
+	}
+};
+
 //#endregion
 //#region src/customId/routing.ts
 /**
@@ -49,5 +119,5 @@ function pageCursor(prefix) {
 }
 
 //#endregion
-export { CommandMetadataKey, ComponentDefsKey, EventMetadataKey, GateNotice, GatedMetadataKey, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, SubscribeMetadataKey, decodeFor, pageCursor, pickNotice, prefixOf, routeIdOf, runGates, runHandlerGates, setBotColor };
+export { CommandMetadataKey, ComponentDefsKey, EventMetadataKey, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, SubscribeMetadataKey, decodeFor, getDevChannel, pageCursor, pickNotice, prefixOf, routeIdOf, runGates, runHandlerGates, setBotColor, setDevChannel, wrapHot };
 //# sourceMappingURL=internal.index.mjs.map

package/dist/internal.index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.index.mjs","names":[],"sources":["../src/gates/runGates.ts","../src/customId/routing.ts","../src/pagination/cursor.ts"],"sourcesContent":["import { GatedMetadataKey, InteractionRouteKeys } from '@src/metadataKeys';\n\nimport { discardCommits, runCheck, runCommits } from './effects';\n\nimport type { Gate, GateContextBase } from './Gate';\n\n// the stable id a route decorator stored, e.g. slash:daily or button:confirm. null for a plain event handler.\nexport function routeIdOf(handlerCtor: object): string | null {\n    for (const [kind, key] of Object.entries(InteractionRouteKeys)) {\n        // justified: getMetadata returns any, this key only ever stores the route/prefix string array\n        const routes = Reflect.getMetadata(key, handlerCtor) as string[] | undefined;\n        if (routes?.length) return `${kind}:${routes.join(',')}`;\n    }\n    return null;\n}\n\n/**\n * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect\n * gate's commit runs once the whole set passes.\n */\nexport async function runGates(gates: readonly Gate<GateContextBase>[], ctx: GateContextBase): Promise<void> {\n    try {\n        for (const gate of gates) {\n            await runCheck(gate, ctx);\n        }\n        await runCommits(ctx);\n    } finally {\n        discardCommits(ctx);\n    }\n}\n\n// dispatchers call this before execute, inside the boundary, so a refusal renders or drops\nexport async function runHandlerGates(handlerCtor: object, ctx: GateContextBase): Promise<void> {\n    // justified: getMetadata returns any, and this key only ever stores the @Gated gate array\n    const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor) as readonly Gate<GateContextBase>[] | undefined;\n    if (!gates) return;\n    await runGates(gates, { ...ctx, routeId: routeIdOf(handlerCtor) });\n}\n","import type { AnyCustomId } from './CustomId';\n\n/**\n * The route decorators store a handler's customId definitions here so the component base can decode\n * against them at runtime.\n *\n * @internal\n */\nexport const ComponentDefsKey = Symbol('seedcord:customId:componentDefs');\n\n/**\n * The phantom a component handler base carries. A route decorator constrains its argument to this, so\n * passing different definitions to the decorator and the handler's generic is a compile error. Never set at runtime.\n *\n * @internal\n */\nexport interface HasComponentDefs<Defs extends readonly AnyCustomId[]> {\n    readonly __componentDefs?: Defs;\n}\n","import { CustomId } from '@customId/CustomId';\n\nimport type { CustomIdField } from '@customId/Field';\n\n// Included in the layout hash so it is fixed per prefix. Reducing it marks every active button as StaleCustomId.\n// @internal\nexport const PAGE_MAX = 1_000_000;\n\n// Discord rejects a message with duplicate custom_ids, and two controls can target the same page (first and\n// prev both hit 0), so each control uses a distinct slot.\n// @internal\nconst SLOT_MAX = 4;\n\n/** Page cursor for a paginator. */\nexport type PageCursor<Prefix extends string> = CustomId<\n    Prefix,\n    { page: CustomIdField<number>; slot: CustomIdField<number> }\n>;\n\n/** Build the page cursor for a paginator. */\nexport function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix> {\n    return new CustomId(prefix).int('page', 0, PAGE_MAX).int('slot', 0, SLOT_MAX);\n}\n"],"mappings":";;;AAOA,SAAgB,UAAU,aAAoC;CAC1D,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,oBAAoB,GAAG;EAE5D,MAAM,SAAS,QAAQ,YAAY,KAAK,WAAW;EACnD,IAAI,QAAQ,QAAQ,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,GAAG;CACzD;CACA,OAAO;AACX;;;;;AAMA,eAAsB,SAAS,OAAyC,KAAqC;CACzG,IAAI;EACA,KAAK,MAAM,QAAQ,OACf,MAAM,SAAS,MAAM,GAAG;EAE5B,MAAM,WAAW,GAAG;CACxB,UAAU;EACN,eAAe,GAAG;CACtB;AACJ;AAGA,eAAsB,gBAAgB,aAAqB,KAAqC;CAE5F,MAAM,QAAQ,QAAQ,YAAY,kBAAkB,WAAW;CAC/D,IAAI,CAAC,OAAO;CACZ,MAAM,SAAS,OAAO;EAAE,GAAG;EAAK,SAAS,UAAU,WAAW;CAAE,CAAC;AACrE;;;;;;;;;;AC7BA,MAAa,mBAAmB,OAAO,iCAAiC;;;;ACFxE,MAAa,WAAW;AAKxB,MAAM,WAAW;;AASjB,SAAgB,WAAkC,QAAoC;CAClF,OAAO,IAAI,SAAS,MAAM,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ;AAChF"}
+{"version":3,"file":"internal.index.mjs","names":[],"sources":["../src/gates/runGates.ts","../src/hmr/devChannel.ts","../src/hmr/wrapHot.ts","../src/hmr/HmrManager.ts","../src/customId/routing.ts","../src/pagination/cursor.ts"],"sourcesContent":["import { GatedMetadataKey, InteractionRouteKeys } from '@src/metadataKeys';\n\nimport { discardCommits, runCheck, runCommits } from './effects';\n\nimport type { Gate, GateContextBase } from './Gate';\n\n// the stable id a route decorator stored, e.g. slash:daily or button:confirm. null for a plain event handler.\nexport function routeIdOf(handlerCtor: object): string | null {\n    for (const [kind, key] of Object.entries(InteractionRouteKeys)) {\n        // justified: getMetadata returns any, this key only ever stores the route/prefix string array\n        const routes = Reflect.getMetadata(key, handlerCtor) as string[] | undefined;\n        if (routes?.length) return `${kind}:${routes.join(',')}`;\n    }\n    return null;\n}\n\n/**\n * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect\n * gate's commit runs once the whole set passes.\n */\nexport async function runGates(gates: readonly Gate<GateContextBase>[], ctx: GateContextBase): Promise<void> {\n    try {\n        for (const gate of gates) {\n            await runCheck(gate, ctx);\n        }\n        await runCommits(ctx);\n    } finally {\n        discardCommits(ctx);\n    }\n}\n\n// dispatchers call this before execute, inside the boundary, so a refusal renders or drops\nexport async function runHandlerGates(handlerCtor: object, ctx: GateContextBase): Promise<void> {\n    // justified: getMetadata returns any, and this key only ever stores the @Gated gate array\n    const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor) as readonly Gate<GateContextBase>[] | undefined;\n    if (!gates) return;\n    await runGates(gates, { ...ctx, routeId: routeIdOf(handlerCtor) });\n}\n","import type { DevChannel, SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\n// one module instance per process, the HmrManager write and every framework read share it\nlet channel: DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined;\n\n/** @internal */\nexport function setDevChannel(next: DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined): void {\n    channel = next;\n}\n\n/** @internal */\nexport function getDevChannel(): DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined {\n    return channel;\n}\n","import type { DevChannel } from '@seedcord/types/internal';\n\n// the minimal raw-hot shape, satisfied by both vite's `import.meta.hot` and the CLI's `NormalizedHotChannel`.\ninterface RawHot {\n    send(event: string, data?: unknown): void;\n    on(event: string, cb: (data: unknown) => void): void;\n}\n\n/**\n * Wraps a raw vite hot object as a typed {@link DevChannel}.\n *\n * @internal\n */\nexport function wrapHot<TSend, TRecv>(hot: RawHot): DevChannel<TSend, TRecv> {\n    return {\n        send: (event, data) => hot.send(event, data),\n        // justified: RawHot types every payload as unknown, the wire contract guarantees it matches TRecv[Key]\n        on: (event, cb) => hot.on(event, cb as (data: unknown) => void)\n    };\n}\n","// scoped here so import.meta.hot stays untyped in the rest of the package\n/// <reference types=\"vite/client\" />\nimport { Logger } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\nimport { Envapter } from 'envapt';\n\nimport { setDevChannel } from './devChannel';\nimport { wrapHot } from './wrapHot';\n\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\nexport class HmrManager {\n    private readonly logger = new Logger('HMR', { channel: 'hmr' });\n    private readonly listeners = new Set<HmrAware>();\n\n    /** @internal */\n    public init(): void {\n        if (!import.meta.hot) return;\n        // the only raw `import.meta.hot` read in the framework\n        const channel = wrapHot<SeedcordFrameworkEvents, SeedcordCliEvents>(import.meta.hot);\n        setDevChannel(channel);\n\n        if (Envapter.isDevelopment || Envapter.isTest) {\n            this.logger.info('Enabled');\n\n            channel.on('seedcord:hmr', (payload) => {\n                const affected = payload.affectedModules?.length ?? 0;\n                this.logger.info(`${chalk.bold('1')} module changed, ${chalk.bold(affected)} affected modules`);\n\n                if (payload.affectedModules) {\n                    this.logger.utils.list(\n                        payload.affectedModules.map((mod) => formatFilePath(mod)),\n                        'Affected modules: '\n                    );\n                }\n\n                void this.handleUpdate(payload);\n            });\n        }\n    }\n\n    /** @internal */\n    public register(listener: HmrAware): void {\n        this.listeners.add(listener);\n    }\n\n    /** @internal */\n    public unregister(listener: HmrAware): void {\n        this.listeners.delete(listener);\n    }\n\n    private async handleUpdate(event: HmrUpdateEvent): Promise<void> {\n        const promises = [...this.listeners].map(async (listener) => {\n            try {\n                await listener.onHmr(event);\n            } catch (error) {\n                this.logger.error(`Error handling HMR update in ${chalk.bold(listener.name)}: `, error);\n            }\n        });\n\n        await Promise.all(promises);\n    }\n}\n","import type { AnyCustomId } from './CustomId';\n\n/**\n * The route decorators store a handler's customId definitions here so the component base can decode\n * against them at runtime.\n *\n * @internal\n */\nexport const ComponentDefsKey = Symbol('seedcord:customId:componentDefs');\n\n/**\n * The phantom a component handler base carries. A route decorator constrains its argument to this, so\n * passing different definitions to the decorator and the handler's generic is a compile error. Never set at runtime.\n *\n * @internal\n */\nexport interface HasComponentDefs<Defs extends readonly AnyCustomId[]> {\n    readonly __componentDefs?: Defs;\n}\n","import { CustomId } from '@customId/CustomId';\n\nimport type { CustomIdField } from '@customId/Field';\n\n// Included in the layout hash so it is fixed per prefix. Reducing it marks every active button as StaleCustomId.\n// @internal\nexport const PAGE_MAX = 1_000_000;\n\n// Discord rejects a message with duplicate custom_ids, and two controls can target the same page (first and\n// prev both hit 0), so each control uses a distinct slot.\n// @internal\nconst SLOT_MAX = 4;\n\n/** Page cursor for a paginator. */\nexport type PageCursor<Prefix extends string> = CustomId<\n    Prefix,\n    { page: CustomIdField<number>; slot: CustomIdField<number> }\n>;\n\n/** Build the page cursor for a paginator. */\nexport function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix> {\n    return new CustomId(prefix).int('page', 0, PAGE_MAX).int('slot', 0, SLOT_MAX);\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,UAAU,aAAoC;CAC1D,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,oBAAoB,GAAG;EAE5D,MAAM,SAAS,QAAQ,YAAY,KAAK,WAAW;EACnD,IAAI,QAAQ,QAAQ,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,GAAG;CACzD;CACA,OAAO;AACX;;;;;AAMA,eAAsB,SAAS,OAAyC,KAAqC;CACzG,IAAI;EACA,KAAK,MAAM,QAAQ,OACf,MAAM,SAAS,MAAM,GAAG;EAE5B,MAAM,WAAW,GAAG;CACxB,UAAU;EACN,eAAe,GAAG;CACtB;AACJ;AAGA,eAAsB,gBAAgB,aAAqB,KAAqC;CAE5F,MAAM,QAAQ,QAAQ,YAAY,kBAAkB,WAAW;CAC/D,IAAI,CAAC,OAAO;CACZ,MAAM,SAAS,OAAO;EAAE,GAAG;EAAK,SAAS,UAAU,WAAW;CAAE,CAAC;AACrE;;;;AClCA,IAAI;;AAGJ,SAAgB,cAAc,MAAgF;CAC1G,UAAU;AACd;;AAGA,SAAgB,gBAAoF;CAChG,OAAO;AACX;;;;;;;;;ACAA,SAAgB,QAAsB,KAAuC;CACzE,OAAO;EACH,OAAO,OAAO,SAAS,IAAI,KAAK,OAAO,IAAI;EAE3C,KAAK,OAAO,OAAO,IAAI,GAAG,OAAO,EAA6B;CAClE;AACJ;;;;ACNA,IAAa,aAAb,MAAwB;CACpB,AAAiB,SAAS,IAAI,OAAO,OAAO,EAAE,SAAS,MAAM,CAAC;CAC9D,AAAiB,4BAAY,IAAI,IAAc;;CAG/C,AAAO,OAAa;EAChB,IAAI,CAAC,OAAO,KAAK,KAAK;EAEtB,MAAM,UAAU,QAAoD,OAAO,KAAK,GAAG;EACnF,cAAc,OAAO;EAErB,IAAI,SAAS,iBAAiB,SAAS,QAAQ;GAC3C,KAAK,OAAO,KAAK,SAAS;GAE1B,QAAQ,GAAG,iBAAiB,YAAY;IACpC,MAAM,WAAW,QAAQ,iBAAiB,UAAU;IACpD,KAAK,OAAO,KAAK,GAAG,MAAM,KAAK,GAAG,EAAE,mBAAmB,MAAM,KAAK,QAAQ,EAAE,kBAAkB;IAE9F,IAAI,QAAQ,iBACR,KAAK,OAAO,MAAM,KACd,QAAQ,gBAAgB,KAAK,QAAQ,eAAe,GAAG,CAAC,GACxD,oBACJ;IAGJ,AAAK,KAAK,aAAa,OAAO;GAClC,CAAC;EACL;CACJ;;CAGA,AAAO,SAAS,UAA0B;EACtC,KAAK,UAAU,IAAI,QAAQ;CAC/B;;CAGA,AAAO,WAAW,UAA0B;EACxC,KAAK,UAAU,OAAO,QAAQ;CAClC;CAEA,MAAc,aAAa,OAAsC;EAC7D,MAAM,WAAW,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,IAAI,OAAO,aAAa;GACzD,IAAI;IACA,MAAM,SAAS,MAAM,KAAK;GAC9B,SAAS,OAAO;IACZ,KAAK,OAAO,MAAM,gCAAgC,MAAM,KAAK,SAAS,IAAI,EAAE,KAAK,KAAK;GAC1F;EACJ,CAAC;EAED,MAAM,QAAQ,IAAI,QAAQ;CAC9B;AACJ;;;;;;;;;;ACxDA,MAAa,mBAAmB,OAAO,iCAAiC;;;;ACFxE,MAAa,WAAW;AAKxB,MAAM,WAAW;;AASjB,SAAgB,WAAkC,QAAoC;CAClF,OAAO,IAAI,SAAS,MAAM,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ;AAChF"}

package/dist/rolldown-runtime-C_NdSu1c.cjs

@@ -0,0 +1,34 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seedcord/core",
   "type": "module",
-  "version": "0.1.0-next.3",
+  "version": "0.1.0-next.4",
   "description": "Transport-agnostic core for Seedcord bots",
   "repository": {
     "type": "git",
@@ -29,6 +29,16 @@
         "types": "./dist/internal.index.d.cts",
         "default": "./dist/internal.index.cjs"
       }
+    },
+    "./hmr": {
+      "import": {
+        "types": "./dist/hmr.index.d.mts",
+        "default": "./dist/hmr.index.mjs"
+      },
+      "require": {
+        "types": "./dist/hmr.index.d.cts",
+        "default": "./dist/hmr.index.cjs"
+      }
     }
   },
   "files": [
@@ -43,16 +53,20 @@
   },
   "dependencies": {
     "@discordjs/builders": "^1.14.1",
+    "chalk": "^5.6.2",
     "discord-api-types": "^0.38.49",
+    "envapt": "^8.0.0",
     "@seedcord/errors": "0.3.0-next.3",
-    "@seedcord/types": "0.8.0-next.4",
-    "@seedcord/utils": "0.8.0-next.4"
+    "@seedcord/logger": "0.1.0-next.0",
+    "@seedcord/types": "0.8.0-next.5",
+    "@seedcord/utils": "0.8.0-next.5"
   },
   "devDependencies": {
     "reflect-metadata": "^0.2.2",
     "type-fest": "^5.7.0",
+    "vite": "^8.0.16",
     "@seedcord/eslint-config": "1.5.0-next.3",
-    "@seedcord/rate-limiter": "0.1.0-next.1",
+    "@seedcord/rate-limiter": "0.1.0-next.2",
     "@seedcord/tsconfig": "2.0.1",
     "@seedcord/tsdown-config": "2.0.1"
   },