commandkit 1.2.0-rc.1 → 1.2.0-rc.11

package/dist/{commandkit-DMEW0kJg.js → commandkit-ZoBBh0Q_.js}

@@ -1,30 +1,38 @@
 const require_chunk = require('./chunk-nOFOJqeH.js');
-const require_colors = require('./colors-Cd4Oz-r-.js');
-const require_error_codes = require('./error-codes-C-ViHyu-.js');
+const require_colors = require('./colors-DL3ucTiT.js');
+const require_error_codes = require('./error-codes-Ds0bnPvT.js');
 const require_element = require('./element-Bak9llw_.js');
-const require_EventInterceptor = require('./EventInterceptor-CQ4PBpBJ.js');
+const require_EventInterceptor = require('./EventInterceptor-CQEXyUTp.js');
 const require_constants = require('./constants-B5_Ta7PR.js');
-const require_CompilerPlugin = require('./CompilerPlugin-CjoZAAR8.js');
-const require_RuntimePlugin = require('./RuntimePlugin-CBgBLXTG.js');
-const require_utils = require('./utils-BnXM4eKk.js');
-const require_resolve_file_url = require('./resolve-file-url-DHTQj2mU.js');
-const require_types_package = require('./types-package-DrnIdWLg.js');
-const require_EventWorkerContext = require('./EventWorkerContext-CSlD9rbx.js');
-const require_signals = require('./signals-DHdYrd-n.js');
-const require_constants$1 = require('./constants-CUND8XkG.js');
-const require_MessageCommandParser = require('./MessageCommandParser-B_BEQ3p8.js');
-const require_CommandsRouter = require('./CommandsRouter-Ci1Pe8Vd.js');
-const require_EventsRouter = require('./EventsRouter-C_J0M3uO.js');
-const require_common = require('./common-DNADUU3_.js');
-const require_CommandKitEventsChannel = require('./CommandKitEventsChannel-Bgw0XCOl.js');
-const require_store = require('./store-CiqLHedg.js');
-const node_events = require_chunk.__toESM(require("node:events"));
-const discord_js = require_chunk.__toESM(require("discord.js"));
-const node_async_hooks = require_chunk.__toESM(require("node:async_hooks"));
-const node_fs = require_chunk.__toESM(require("node:fs"));
-const node_path = require_chunk.__toESM(require("node:path"));
-const node_crypto = require_chunk.__toESM(require("node:crypto"));
-const __rollup_plugin_json = require_chunk.__toESM(require("@rollup/plugin-json"));
+const require_CompilerPlugin = require('./CompilerPlugin-M8r3yNAl.js');
+const require_RuntimePlugin = require('./RuntimePlugin-BUecuBIU.js');
+const require_resolve_file_url = require('./resolve-file-url-ChIyw-Vf.js');
+const require_utils = require('./utils-KsNof0Xz.js');
+const require_types_package = require('./types-package-BWArjyBF.js');
+const require_constants$1 = require('./constants-BOOGN85p.js');
+const require_EventWorkerContext = require('./EventWorkerContext-Dq29tieI.js');
+const require_signals = require('./signals-ChFMD7mB.js');
+const require_helpers = require('./helpers-Dl8wW6aO.js');
+const require_MessageCommandParser = require('./MessageCommandParser-Dl0xxtdr.js');
+const require_CommandsRouter = require('./CommandsRouter-Dmzw-ikm.js');
+const require_EventsRouter = require('./EventsRouter-3Gygh-km.js');
+const require_common = require('./common-CrqwC-sx.js');
+const require_CommandKitEventsChannel = require('./CommandKitEventsChannel-BtRzr3Tz.js');
+const require_store = require('./store-CM6pWVZh.js');
+let node_events = require("node:events");
+node_events = require_chunk.__toESM(node_events);
+let discord_js = require("discord.js");
+discord_js = require_chunk.__toESM(discord_js);
+let node_async_hooks = require("node:async_hooks");
+node_async_hooks = require_chunk.__toESM(node_async_hooks);
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path);
+let node_crypto = require("node:crypto");
+node_crypto = require_chunk.__toESM(node_crypto);
+let util = require("util");
+util = require_chunk.__toESM(util);
 
 //#region src/context/async-context.ts
 const kCommandWorker = Symbol("commandkitCommandWorker");
@@ -61,10 +69,10 @@ function makeContextAwareFunction(env, fn, finalizer) {
 	const _fn = (...args) => {
 		return provideContext(env, async () => {
 			try {
-				const result = await fn(...args);
-				return result;
+				return await fn(...args);
 			} catch (e) {
 				if (!require_error_codes.isCommandKitError(e)) env.setExecutionError(e);
+				else throw e;
 			} finally {
 				if (typeof finalizer === "function") setImmediate(async () => {
 					try {
@@ -87,8 +95,7 @@ function getCommandKit(strict = false) {
 * @internal
 */
 function getContext() {
-	const ctx = context.getStore();
-	return ctx;
+	return context.getStore();
 }
 /**
 * Use current commandkit context. Throws an error if no context is found.
@@ -98,6 +105,12 @@ function useEnvironment() {
 	if (!ctx) throw new Error("No commandkit environment found. Please make sure you are inside commandkit handler.");
 	return ctx;
 }
+/**
+* Use the shared data store in the current environment. Throws an error if no context is found.
+*/
+function useStore() {
+	return useEnvironment().store;
+}
 
 //#endregion
 //#region src/components/v1/button/ButtonKit.ts
@@ -194,15 +207,13 @@ var ButtonKit = class extends discord_js.ButtonBuilder {
 	}
 	#setupInteractionCollector() {
 		if (this.data.style === discord_js.ButtonStyle.Link || !this.#contextData || !this.#onClickHandler) return;
-		const myCustomId = this.customId ?? null;
-		if (myCustomId === null) throw new TypeError("Cannot setup \"onClick\" handler on a button without a custom id.");
-		const interceptor = this.#getEventInterceptor();
-		this.#unsub = interceptor.subscribe(discord_js.Events.InteractionCreate, async (interaction) => {
+		if ((this.customId ?? null) === null) throw new TypeError("Cannot setup \"onClick\" handler on a button without a custom id.");
+		this.#unsub = this.#getEventInterceptor().subscribe(discord_js.Events.InteractionCreate, async (interaction) => {
 			var _this$contextData5, _this$unsub;
 			if (!interaction.isButton()) return;
-			const myCustomId$1 = this.customId ?? null;
+			const myCustomId = this.customId ?? null;
 			const interactionCustomId = interaction.customId;
-			if (myCustomId$1 && interactionCustomId !== myCustomId$1) return;
+			if (myCustomId && interactionCustomId !== myCustomId) return;
 			const filter = (_this$contextData5 = this.#contextData) === null || _this$contextData5 === void 0 ? void 0 : _this$contextData5.filter;
 			if (filter && !await filter(interaction)) return;
 			const handler = this.#onClickHandler;
@@ -1277,55 +1288,63 @@ var DefaultLogger = class {
 				break;
 			default: label = "[LOG]";
 		}
-		const coloredLabel = TextBgColorMap[level](require_colors.colors_default.whiteBright(` ${label} `));
-		return `${coloredLabel}   `;
+		return `${TextBgColorMap[level](require_colors.colors_default.whiteBright(` ${label} `))}   `;
 	}
 	_getPrefix(level) {
 		const timestamp = this._formatTime(/* @__PURE__ */ new Date());
-		const label = this._getLevelLabel(level);
-		return `${label}${require_colors.colors_default.dim(BoxChars.vertical)} ${require_colors.colors_default.dim(timestamp)}`;
+		return `${this._getLevelLabel(level)}${require_colors.colors_default.dim(BoxChars.vertical)} ${require_colors.colors_default.dim(timestamp)}`;
 	}
-	_log(level, ...args) {
+	_log(level, message) {
 		const prefix = this._getPrefix(level);
 		const context$1 = this._getContext();
 		const colorFn = TextColorMap[level];
-		if (context$1) this.logger.log(`${prefix}\n${context$1} ${require_colors.colors_default.dim(BoxChars.corner)}`, ...args.map((arg) => colorFn(arg)));
-		else this.logger.log(`${prefix} ${require_colors.colors_default.dim(BoxChars.corner)}`, ...args.map((arg) => colorFn(arg)));
+		let processedMessage = message;
+		if (message instanceof Error) processedMessage = `${message.message}\n${message.stack}`;
+		if (context$1) this.logger.log(`${prefix}\n${context$1} ${require_colors.colors_default.dim(BoxChars.corner)}`, colorFn(processedMessage));
+		else this.logger.log(`${prefix} ${require_colors.colors_default.dim(BoxChars.corner)}`, colorFn(processedMessage));
 	}
-	/**
-	* Logs a debug message.
-	* @param args The message arguments to log.
-	*/
-	debug(...args) {
-		this._log(LogLevel.DEBUG, ...args);
+	_logTemplate(level, strings, ...values) {
+		const prefix = this._getPrefix(level);
+		const context$1 = this._getContext();
+		const colorFn = TextColorMap[level];
+		let result = "";
+		for (let i = 0; i < strings.length; i++) {
+			result += strings[i];
+			if (i < values.length) {
+				const value = values[i];
+				if (value instanceof Error) result += `${value.message}\n${value.stack}`;
+				else if (value !== null && typeof value === "object") result += (0, util.inspect)(value, {
+					colors: true,
+					depth: 2
+				});
+				else result += value;
+			}
+		}
+		if (context$1) this.logger.log(`${prefix}\n${context$1} ${require_colors.colors_default.dim(BoxChars.corner)}`, colorFn(result));
+		else this.logger.log(`${prefix} ${require_colors.colors_default.dim(BoxChars.corner)}`, colorFn(result));
 	}
-	/**
-	* Logs an error message.
-	* @param args The message arguments to log.
-	*/
-	error(...args) {
-		this._log(LogLevel.ERROR, ...args);
+	debug(messageOrStrings, ...values) {
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.DEBUG, messageOrStrings, ...values);
+		else this._log(LogLevel.DEBUG, messageOrStrings);
 	}
-	/**
-	* Logs a default message.
-	* @param args The message arguments to log.
-	*/
-	log(...args) {
-		this._log(LogLevel.DEFAULT, ...args);
+	error(messageOrStrings, ...values) {
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.ERROR, messageOrStrings, ...values);
+		else this._log(LogLevel.ERROR, messageOrStrings);
 	}
-	/**
-	* Logs an info message.
-	* @param args The message arguments to log.
-	*/
-	info(...args) {
-		this._log(LogLevel.INFO, ...args);
+	log(messageOrStrings, ...values) {
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.DEFAULT, messageOrStrings, ...values);
+		else this._log(LogLevel.DEFAULT, messageOrStrings);
 	}
-	/**
-	* Logs a warning message.
-	* @param args The message arguments to log.
-	*/
-	warn(...args) {
-		this._log(LogLevel.WARN, ...args);
+	info(messageOrStrings, ...values) {
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.INFO, messageOrStrings, ...values);
+		else this._log(LogLevel.INFO, messageOrStrings);
+	}
+	warn(messageOrStrings, ...values) {
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.WARN, messageOrStrings, ...values);
+		else this._log(LogLevel.WARN, messageOrStrings);
+	}
+	_isTemplateStringsArray(value) {
+		return Array.isArray(value) && "raw" in value && Array.isArray(value.raw);
 	}
 };
 
@@ -1349,8 +1368,8 @@ function createLogger(options) {
 	const impl = { configure(options$1) {
 		opt = options$1;
 	} };
-	for (const method of methods) impl[method] = (...args) => {
-		opt.provider[method](...args);
+	for (const method of methods) impl[method] = (...message) => {
+		opt.provider[method](...message);
 	};
 	return impl;
 }
@@ -1394,8 +1413,14 @@ var CommandKitPluginRuntime = class {
 	* @param plugin The plugin to be fetched.
 	*/
 	get(plugin) {
-		const p = this.plugins.find((p$1) => p$1 instanceof plugin) ?? null;
-		return p;
+		return this.plugins.find((p) => p instanceof plugin) ?? null;
+	}
+	/**
+	* Pre-loads the specified entrypoints for the given plugin.
+	* @param plugin The plugin to pre-load.
+	*/
+	async preload(plugin) {
+		for (const entrypoint of plugin.preload) await import(require_resolve_file_url.toFileURL(`${getCurrentDirectory()}/${entrypoint}`));
 	}
 	/**
 	* Soft registers a plugin in the runtime.
@@ -1405,9 +1430,11 @@ var CommandKitPluginRuntime = class {
 		const pluginName = plugin.name;
 		if (this.plugins.has(pluginName)) return;
 		try {
+			await this.preload(plugin);
 			await plugin.activate(this);
 			this.plugins.set(pluginName, plugin);
 		} catch (e) {
+			this.plugins.delete(pluginName);
 			throw new Error(`Failed to activate plugin "${pluginName}": ${(e === null || e === void 0 ? void 0 : e.stack) || e}`);
 		}
 	}
@@ -1420,9 +1447,11 @@ var CommandKitPluginRuntime = class {
 		const pluginName = plugin.name;
 		if (this.plugins.has(pluginName)) throw new Error(`Plugin with name "${pluginName}" already exists.`);
 		try {
+			await this.preload(plugin);
 			await plugin.activate(this);
 			this.plugins.set(pluginName, plugin);
 		} catch (e) {
+			this.plugins.delete(pluginName);
 			throw new Error(`Failed to activate plugin "${pluginName}": ${(e === null || e === void 0 ? void 0 : e.stack) || e}`);
 		}
 	}
@@ -1464,7 +1493,7 @@ var CommandKitPluginRuntime = class {
 			result = await f(this, plugin);
 		} catch (e) {
 			if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.PluginCaptureHandle)) return true;
-			Logger.error(`Plugin "${plugin.name}" failed`, (e === null || e === void 0 ? void 0 : e.stack) || e);
+			Logger.error`Plugin "${plugin.name}" failed: ${(e === null || e === void 0 ? void 0 : e.stack) || e}`;
 		}
 		return result;
 	}
@@ -1602,7 +1631,7 @@ var CompilerPluginRuntime = class {
 				await ((_plugin$activate = plugin.activate) === null || _plugin$activate === void 0 ? void 0 : _plugin$activate.call(plugin, this));
 			});
 		} catch (e) {
-			console.error(`Plugin ${plugin.name} failed to activate with ${(e === null || e === void 0 ? void 0 : e.stack) || e}`);
+			Logger.error`Plugin ${plugin.name} failed to activate with ${e}`;
 		}
 		this.initialized = true;
 	}
@@ -1621,7 +1650,7 @@ var CompilerPluginRuntime = class {
 				await ((_plugin$deactivate = plugin.deactivate) === null || _plugin$deactivate === void 0 ? void 0 : _plugin$deactivate.call(plugin, this));
 			});
 		} catch (e) {
-			console.error(`Plugin ${plugin.name} failed to deactivate with ${(e === null || e === void 0 ? void 0 : e.stack) || e}`);
+			Logger.error`Plugin ${plugin.name} failed to deactivate with ${e}`;
 		}
 		this.initialized = false;
 	}
@@ -1656,9 +1685,8 @@ var CommonDirectiveTransformer = class extends require_CompilerPlugin.CompilerPl
 		if (!this.options.enabled) return null;
 		if (!this.transformer) return null;
 		if (/\.json$/.test(params.id)) return null;
-		const result = await this.transformer(params.code.toString(), params.id);
 		return {
-			code: result.contents,
+			code: (await this.transformer(params.code.toString(), params.id)).contents,
 			map: null
 		};
 	}
@@ -1682,8 +1710,7 @@ var MacroPlugin = class extends require_CompilerPlugin.CompilerPlugin {
 	name = "MacroPlugin";
 	macroTransformer;
 	async activate() {
-		const transform = await import("use-macro");
-		this.macroTransformer = new transform.MacroTransformer();
+		this.macroTransformer = new (await (import("use-macro"))).MacroTransformer();
 	}
 	async deactivate() {
 		this.macroTransformer = null;
@@ -1706,7 +1733,7 @@ var MacroPlugin = class extends require_CompilerPlugin.CompilerPlugin {
 */
 const defaultConfig = {
 	plugins: [new MacroPlugin({ enabled: true })],
-	rolldownPlugins: [(0, __rollup_plugin_json.default)()],
+	rolldownPlugins: [],
 	compilerOptions: {
 		macro: { development: false },
 		tsdown: {},
@@ -1723,6 +1750,7 @@ const defaultConfig = {
 	},
 	typedCommands: true,
 	disablePrefixCommands: false,
+	disablePermissionsMiddleware: false,
 	showUnknownPrefixCommandsWarning: true,
 	antiCrashScript: {
 		development: true,
@@ -1781,7 +1809,8 @@ function defineConfig(config = {}) {
 		antiCrashScript: {
 			...defaultConfig.antiCrashScript,
 			...config.antiCrashScript
-		}
+		},
+		disablePermissionsMiddleware: config.disablePermissionsMiddleware ?? defaultConfig.disablePermissionsMiddleware
 	};
 	return defined;
 }
@@ -1813,13 +1842,11 @@ function getCurrentDirectory() {
 * @returns An array of possible source directories.
 */
 function getSourceDirectories() {
-	const dist = getConfig().distDir;
-	const locations = [
+	return [
 		"src",
 		".commandkit",
-		dist
+		getConfig().distDir
 	].map((dir) => (0, node_path.join)(require_constants.COMMANDKIT_CWD, dir));
-	return locations;
 }
 /**
 * Returns the path to the app directory.
@@ -1923,49 +1950,48 @@ function devOnly(fn) {
 */
 function createProxy(target) {
 	let _target = target;
-	const proxy = new Proxy(_target, {
-		get(target$1, prop, receiver) {
-			return Reflect.get(_target, prop, receiver);
-		},
-		set(target$1, prop, value, receiver) {
-			return Reflect.set(_target, prop, value, receiver);
-		},
-		deleteProperty(target$1, prop) {
-			return Reflect.deleteProperty(_target, prop);
-		},
-		has(target$1, prop) {
-			return Reflect.has(_target, prop);
-		},
-		ownKeys(target$1) {
-			return Reflect.ownKeys(_target);
-		},
-		getOwnPropertyDescriptor(target$1, prop) {
-			return Reflect.getOwnPropertyDescriptor(_target, prop);
-		},
-		defineProperty(target$1, prop, attributes) {
-			return Reflect.defineProperty(_target, prop, attributes);
-		},
-		getPrototypeOf(target$1) {
-			return Reflect.getPrototypeOf(_target);
-		},
-		setPrototypeOf(target$1, proto) {
-			return Reflect.setPrototypeOf(_target, proto);
-		},
-		isExtensible(target$1) {
-			return Reflect.isExtensible(_target);
-		},
-		preventExtensions(target$1) {
-			return Reflect.preventExtensions(_target);
-		},
-		apply(target$1, thisArg, args) {
-			return Reflect.apply(_target, thisArg, args);
-		},
-		construct(target$1, args, newTarget) {
-			return Reflect.construct(_target, args, newTarget);
-		}
-	});
 	return {
-		proxy,
+		proxy: new Proxy(_target, {
+			get(target$1, prop, receiver) {
+				return Reflect.get(_target, prop, receiver);
+			},
+			set(target$1, prop, value, receiver) {
+				return Reflect.set(_target, prop, value, receiver);
+			},
+			deleteProperty(target$1, prop) {
+				return Reflect.deleteProperty(_target, prop);
+			},
+			has(target$1, prop) {
+				return Reflect.has(_target, prop);
+			},
+			ownKeys(target$1) {
+				return Reflect.ownKeys(_target);
+			},
+			getOwnPropertyDescriptor(target$1, prop) {
+				return Reflect.getOwnPropertyDescriptor(_target, prop);
+			},
+			defineProperty(target$1, prop, attributes) {
+				return Reflect.defineProperty(_target, prop, attributes);
+			},
+			getPrototypeOf(target$1) {
+				return Reflect.getPrototypeOf(_target);
+			},
+			setPrototypeOf(target$1, proto) {
+				return Reflect.setPrototypeOf(_target, proto);
+			},
+			isExtensible(target$1) {
+				return Reflect.isExtensible(_target);
+			},
+			preventExtensions(target$1) {
+				return Reflect.preventExtensions(_target);
+			},
+			apply(target$1, thisArg, args) {
+				return Reflect.apply(_target, thisArg, args);
+			},
+			construct(target$1, args, newTarget) {
+				return Reflect.construct(_target, args, newTarget);
+			}
+		}),
 		setTarget(newTarget) {
 			_target = newTarget;
 		}
@@ -1986,7 +2012,8 @@ var CommandKitEnvironment = class {
 		marker: "",
 		markStart: 0,
 		markEnd: 0,
-		context: null
+		context: null,
+		store: new discord_js.Collection()
 	};
 	/**
 	* Creates the commandkit execution environment.
@@ -2048,6 +2075,12 @@ var CommandKitEnvironment = class {
 		return this.#data.variables;
 	}
 	/**
+	* The shared store for this environment
+	*/
+	get store() {
+		return this.#data.store;
+	}
+	/**
 	* Register a deferred function.
 	* @param fn - The deferred function to register.
 	* @returns The deferred function id.
@@ -2226,12 +2259,13 @@ var Context = class Context {
 	* @param config The context parameters.
 	*/
 	constructor(commandkit$1, config) {
+		var _config$environment;
 		this.commandkit = commandkit$1;
 		this.config = config;
 		this.interaction = config.interaction;
 		this.message = config.message;
 		this.client = commandkit$1.client;
-		this.#store = config.store ?? /* @__PURE__ */ new Map();
+		this.#store = ((_config$environment = config.environment) === null || _config$environment === void 0 ? void 0 : _config$environment.store) ?? config.store ?? new discord_js.Collection();
 		this.command = config.command;
 		if (config.interaction) {
 			this.guild = config.interaction.guild;
@@ -2252,7 +2286,8 @@ var Context = class Context {
 	* This store is shared across all contexts in the same command execution, including the cloned contexts and middleware contexts.
 	*/
 	get store() {
-		return this.#store;
+		var _this$config$environm;
+		return ((_this$config$environm = this.config.environment) === null || _this$config$environm === void 0 ? void 0 : _this$config$environm.store) ?? this.#store;
 	}
 	/**
 	* Gets the name of the current command.
@@ -2265,13 +2300,8 @@ var Context = class Context {
 	* Gets the command options based on the execution mode.
 	*/
 	get options() {
-		if (this.isMessage()) {
-			const parser = this.config.messageCommandParser;
-			return parser.options;
-		} else {
-			const interaction = this.interaction;
-			return interaction.options;
-		}
+		if (this.isMessage()) return this.config.messageCommandParser.options;
+		else return this.interaction.options;
 	}
 	/**
 	* Whether this context was forwarded from another context. This happens when a command forwards its context to another command.
@@ -2394,12 +2424,11 @@ var Context = class Context {
 	*/
 	clone(config) {
 		if (!config) return new Context(this.commandkit, this.config);
-		const ctx = new Context(this.commandkit, {
+		return new Context(this.commandkit, {
 			...this.config,
 			...config,
 			store: this.#store
 		});
-		return ctx;
 	}
 	/**
 	* Checks if this context is a middleware context.
@@ -2415,37 +2444,11 @@ var Context = class Context {
 		if (this.isMessage()) return this.config.messageCommandParser.getArgs();
 		return [];
 	}
-	/**
-	* Stops upcoming middleware or current command execution.
-	* If this is called inside pre-stage middleware, the next run will be the actual command, skipping all other pre-stage middlewares.
-	* If this is called inside a command itself, it will skip all post-stage middlewares.
-	* If this is called inside post-stage middleware, it will skip all other post-stage middlewares.
-	*/
-	exit() {
-		require_signals.exitMiddleware();
-	}
 };
 /**
 * Extended context class for middleware execution with additional control methods.
 */
 var MiddlewareContext = class extends Context {
-	/**
-	* @private
-	* @internal
-	*/
-	#cancel = false;
-	/**
-	* Whether the command execution was cancelled.
-	*/
-	get cancelled() {
-		return this.#cancel;
-	}
-	/**
-	* Cancels the command execution.
-	*/
-	cancel() {
-		this.#cancel = true;
-	}
 	/**
 	* Sets command runner function to wrap the command execution.
 	* @param fn The function to set.
@@ -2480,6 +2483,7 @@ var AppCommandRunner = class {
 	* Handles the complete command lifecycle including before/after middleware execution.
 	* @param prepared - The prepared command execution data
 	* @param source - The source interaction or message that triggered the command
+	* @param options - The options for running the command
 	*/
 	async runCommand(prepared, source, options) {
 		const { commandkit: commandkit$1 } = this.handler;
@@ -2492,119 +2496,124 @@ var AppCommandRunner = class {
 		env.variables.set("currentCommandName", prepared.command.command.name);
 		env.variables.set("execHandlerKind", executionMode);
 		env.variables.set("customHandler", (options === null || options === void 0 ? void 0 : options.handler) ?? null);
-		const ctx = new MiddlewareContext(commandkit$1, {
-			command: prepared.command,
-			environment: env,
-			executionMode,
-			interaction: !(source instanceof discord_js.Message) ? source : null,
-			message: source instanceof discord_js.Message ? source : null,
-			forwarded: false,
-			customArgs: { setCommandRunner: (fn) => {
-				runCommand = fn;
-			} },
-			messageCommandParser: prepared.messageCommandParser
-		});
-		let middlewaresCanceled = false;
-		if (prepared.middlewares.length) await provideContext(env, async () => {
-			for (const middleware of prepared.middlewares) {
-				if (!middleware.data.beforeExecute) continue;
-				try {
-					await middleware.data.beforeExecute(ctx);
+		try {
+			const middlewareCtx = new MiddlewareContext(commandkit$1, {
+				command: prepared.command,
+				environment: env,
+				executionMode,
+				interaction: !(source instanceof discord_js.Message) ? source : null,
+				message: source instanceof discord_js.Message ? source : null,
+				forwarded: false,
+				customArgs: { setCommandRunner: (fn) => {
+					runCommand = fn;
+				} },
+				messageCommandParser: prepared.messageCommandParser
+			});
+			const beforeMiddlewares = prepared.middlewares.filter((m) => m.data.beforeExecute);
+			let beforeMiddlewaresStopped = false;
+			if (beforeMiddlewares.length) await provideContext(env, async () => {
+				for (const middleware of beforeMiddlewares) try {
+					await middleware.data.beforeExecute(middlewareCtx);
 				} catch (e) {
-					if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.ExitMiddleware)) {
-						middlewaresCanceled = true;
-						return;
+					if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.StopMiddlewares)) {
+						beforeMiddlewaresStopped = true;
+						Logger.debug(`Middleware propagation stopped for command "${middlewareCtx.commandName}". stopMiddlewares() was called inside a beforeExecute function at "${middleware.middleware.relativePath}"`);
+						break;
 					}
 					if (require_error_codes.isErrorType(e, [require_error_codes.CommandKitErrorCodes.ForwardedCommand, require_error_codes.CommandKitErrorCodes.InvalidCommandPrefix])) continue;
 					throw e;
 				}
-			}
-		});
-		let result;
-		if (!ctx.cancelled) {
-			const targetData = prepared.command.data;
-			const fn = targetData[(options === null || options === void 0 ? void 0 : options.handler) || executionMode];
-			if (!fn) Logger.warn(`Command ${prepared.command.command.name} has no handler for ${executionMode}`);
-			const analytics = commandkit$1.analytics;
-			if (fn) try {
-				const _executeCommand = makeContextAwareFunction(env, async () => {
-					env.registerDeferredFunction(async (env$1) => {
-						var _prepared$command2;
-						env$1.markEnd();
-						const error = env$1.getExecutionError();
-						const marker = env$1.getMarker();
-						const time = `${env$1.getExecutionTime().toFixed(2)}ms`;
-						if (error) {
-							var _prepared$command;
-							Logger.error(`[${marker} - ${time}] Error executing command: ${error.stack || error}`);
-							const commandName$1 = ((_prepared$command = prepared.command) === null || _prepared$command === void 0 || (_prepared$command = _prepared$command.data) === null || _prepared$command === void 0 || (_prepared$command = _prepared$command.command) === null || _prepared$command === void 0 ? void 0 : _prepared$command.name) ?? prepared.command.command.name;
+			});
+			let result;
+			let stopMiddlewaresCalledInCmd = false;
+			if (!beforeMiddlewaresStopped) {
+				const fn = prepared.command.data[(options === null || options === void 0 ? void 0 : options.handler) || executionMode];
+				if (!fn) Logger.warn(`Command ${prepared.command.command.name} has no handler for ${executionMode}`);
+				const analytics = commandkit$1.analytics;
+				if (fn) try {
+					const _executeCommand = makeContextAwareFunction(env, async () => {
+						env.registerDeferredFunction(async (env$1) => {
+							var _prepared$command2;
+							env$1.markEnd();
+							const error = env$1.getExecutionError();
+							const marker = env$1.getMarker();
+							const time = `${env$1.getExecutionTime().toFixed(2)}ms`;
+							if (error) {
+								var _prepared$command;
+								Logger.error`[${marker} - ${time}] Error executing command: ${error}`;
+								const commandName$1 = ((_prepared$command = prepared.command) === null || _prepared$command === void 0 || (_prepared$command = _prepared$command.data) === null || _prepared$command === void 0 || (_prepared$command = _prepared$command.command) === null || _prepared$command === void 0 ? void 0 : _prepared$command.name) ?? prepared.command.command.name;
+								await analytics.track({
+									name: require_constants$1.AnalyticsEvents.COMMAND_EXECUTION,
+									id: commandName$1,
+									data: {
+										error: true,
+										executionTime: env$1.getExecutionTime().toFixed(2),
+										type: executionMode,
+										command: commandName$1
+									}
+								});
+								return;
+							}
+							Logger.info(`[${marker} - ${time}] Command executed successfully`);
+							const commandName = ((_prepared$command2 = prepared.command) === null || _prepared$command2 === void 0 || (_prepared$command2 = _prepared$command2.data) === null || _prepared$command2 === void 0 || (_prepared$command2 = _prepared$command2.command) === null || _prepared$command2 === void 0 ? void 0 : _prepared$command2.name) ?? prepared.command.command.name;
 							await analytics.track({
 								name: require_constants$1.AnalyticsEvents.COMMAND_EXECUTION,
-								id: commandName$1,
+								id: commandName,
 								data: {
-									error: true,
+									error: false,
 									executionTime: env$1.getExecutionTime().toFixed(2),
 									type: executionMode,
-									command: commandName$1
+									command: commandName
 								}
 							});
-							return;
-						}
-						Logger.info(`[${marker} - ${time}] Command executed successfully`);
-						const commandName = ((_prepared$command2 = prepared.command) === null || _prepared$command2 === void 0 || (_prepared$command2 = _prepared$command2.data) === null || _prepared$command2 === void 0 || (_prepared$command2 = _prepared$command2.command) === null || _prepared$command2 === void 0 ? void 0 : _prepared$command2.name) ?? prepared.command.command.name;
-						await analytics.track({
-							name: require_constants$1.AnalyticsEvents.COMMAND_EXECUTION,
-							id: commandName,
-							data: {
-								error: false,
-								executionTime: env$1.getExecutionTime().toFixed(2),
-								type: executionMode,
-								command: commandName
-							}
 						});
-					});
-					return fn(ctx.clone());
-				}, this.#finalizer.bind(this));
-				const executeCommand = runCommand != null ? runCommand(_executeCommand) : _executeCommand;
-				env.markStart(prepared.command.data.command.name);
-				const res = await commandkit$1.plugins.execute(async (ctx$1, plugin) => {
-					return plugin.executeCommand(ctx$1, env, source, prepared, executeCommand);
-				});
-				if (!res) result = await executeCommand();
-			} catch (e) {
-				if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.ExitMiddleware)) middlewaresCanceled = true;
-				if (!require_error_codes.isErrorType(e, [require_error_codes.CommandKitErrorCodes.ForwardedCommand, require_error_codes.CommandKitErrorCodes.ExitMiddleware])) {
-					if (shouldThrowOnError) throw e;
-					Logger.error(e);
+						return fn(middlewareCtx.clone());
+					}, this.#finalizer.bind(this));
+					const executeCommand = runCommand != null ? runCommand(_executeCommand) : _executeCommand;
+					env.markStart(prepared.command.data.command.name);
+					if (!await commandkit$1.plugins.execute(async (ctx, plugin) => {
+						return plugin.executeCommand(ctx, env, source, prepared, executeCommand);
+					})) result = await executeCommand();
+				} catch (e) {
+					if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.StopMiddlewares)) {
+						stopMiddlewaresCalledInCmd = true;
+						Logger.debug(`Middleware propagation stopped for command "${middlewareCtx.commandName}". stopMiddlewares() was called by the command itself`);
+					} else if (!require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.ForwardedCommand)) {
+						if (shouldThrowOnError) throw e;
+						Logger.error`${e}`;
+					}
 				}
-			}
-		} else result = {
-			error: true,
-			message: "Command execution was cancelled by the middleware."
-		};
-		if (!middlewaresCanceled && prepared.middlewares.length) await provideContext(env, async () => {
-			for (const middleware of prepared.middlewares) {
-				if (!middleware.data.afterExecute) continue;
-				try {
-					await middleware.data.afterExecute(ctx);
+			} else result = {
+				error: true,
+				message: "Command execution was cancelled by a beforeExecute middleware."
+			};
+			const afterMiddlewares = prepared.middlewares.filter((m) => m.data.afterExecute);
+			if (!beforeMiddlewaresStopped && !stopMiddlewaresCalledInCmd && afterMiddlewares.length) await provideContext(env, async () => {
+				for (const middleware of afterMiddlewares) try {
+					await middleware.data.afterExecute(middlewareCtx);
 				} catch (e) {
-					if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.ExitMiddleware)) return;
+					if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.StopMiddlewares)) {
+						Logger.debug(`Middleware propagation stopped for command "${middlewareCtx.commandName}". stopMiddlewares() was called inside an afterExecute function at "${middleware.middleware.relativePath}"`);
+						break;
+					}
 					throw e;
 				}
-			}
-		});
-		return result;
+			});
+			return result;
+		} finally {
+			await this.#finalizer(env, false);
+		}
 	}
 	/**
 	* @private
 	* @internal
 	* Finalizes command execution by running deferred functions and plugin cleanup.
 	*/
-	async #finalizer() {
-		const env = useEnvironment();
+	async #finalizer(env, runPlugins = true) {
+		env ??= useEnvironment();
 		await env.runDeferredFunctions();
 		env.clearAllDeferredFunctions();
-		await this.handler.commandkit.plugins.execute(async (ctx, plugin) => {
+		if (runPlugins) await this.handler.commandkit.plugins.execute(async (ctx, plugin) => {
 			await plugin.onAfterCommand(ctx, env);
 		});
 	}
@@ -2623,6 +2632,81 @@ var AppCommandRunner = class {
 	}
 };
 
+//#endregion
+//#region src/app/middlewares/permissions.ts
+const middlewareId = crypto.randomUUID();
+/**
+* @private
+* @ignore
+*/
+async function beforeExecute(ctx) {
+	var _interaction$channel, _message$channel, _message$member, _command$metadata, _interaction$guild, _message$guild, _command$metadata2;
+	if (getConfig().disablePermissionsMiddleware) return;
+	const { interaction, message, command } = ctx;
+	if (interaction && !interaction.isCommand()) return;
+	if (interaction && ((_interaction$channel = interaction.channel) === null || _interaction$channel === void 0 ? void 0 : _interaction$channel.isDMBased()) || message && ((_message$channel = message.channel) === null || _message$channel === void 0 ? void 0 : _message$channel.isDMBased())) {
+		const channel = (interaction === null || interaction === void 0 ? void 0 : interaction.channel) ?? (message === null || message === void 0 ? void 0 : message.channel);
+		const embed$1 = new discord_js.EmbedBuilder().setTitle(":x: Server-only command!").setDescription("This command can only be used in a server.").setColor("Red");
+		try {
+			if (channel === null || channel === void 0 ? void 0 : channel.isSendable()) if (interaction && interaction.isRepliable()) await interaction.reply({
+				embeds: [embed$1],
+				flags: discord_js.MessageFlags.Ephemeral
+			});
+			else await message.reply({ embeds: [embed$1] });
+		} catch (error) {
+			Logger.error`Could not send 'Server-only command' DM to user ${(interaction === null || interaction === void 0 ? void 0 : interaction.user.id) ?? (message === null || message === void 0 ? void 0 : message.author.id)} for command ${command.command.name}: ${error}`;
+		}
+		require_signals.stopMiddlewares();
+	}
+	const userPermissions = (interaction === null || interaction === void 0 ? void 0 : interaction.memberPermissions) ?? (message === null || message === void 0 || (_message$member = message.member) === null || _message$member === void 0 ? void 0 : _message$member.permissions);
+	let userPermissionsRequired = ((_command$metadata = command.metadata) === null || _command$metadata === void 0 ? void 0 : _command$metadata.userPermissions) ?? [];
+	let missingUserPermissions = [];
+	if (typeof userPermissionsRequired === "string") userPermissionsRequired = [userPermissionsRequired];
+	const botPermissions = (interaction === null || interaction === void 0 || (_interaction$guild = interaction.guild) === null || _interaction$guild === void 0 || (_interaction$guild = _interaction$guild.members.me) === null || _interaction$guild === void 0 ? void 0 : _interaction$guild.permissions) ?? (message === null || message === void 0 || (_message$guild = message.guild) === null || _message$guild === void 0 || (_message$guild = _message$guild.members.me) === null || _message$guild === void 0 ? void 0 : _message$guild.permissions);
+	let botPermissionsRequired = ((_command$metadata2 = command.metadata) === null || _command$metadata2 === void 0 ? void 0 : _command$metadata2.botPermissions) ?? [];
+	let missingBotPermissions = [];
+	if (typeof botPermissionsRequired === "string") botPermissionsRequired = [botPermissionsRequired];
+	if (!userPermissionsRequired.length && !botPermissionsRequired.length) return;
+	if (userPermissionsRequired.length) {
+		for (const permission of userPermissionsRequired) if (!(userPermissions === null || userPermissions === void 0 ? void 0 : userPermissions.has(permission))) missingUserPermissions.push(permission);
+	}
+	if (botPermissionsRequired.length) {
+		for (const permission of botPermissionsRequired) if (!(botPermissions === null || botPermissions === void 0 ? void 0 : botPermissions.has(permission))) missingBotPermissions.push(permission);
+	}
+	if (!missingUserPermissions.length && !missingBotPermissions.length) return;
+	const pattern = /([a-z])([A-Z])|([A-Z]+)([A-Z][a-z])/g;
+	missingUserPermissions = missingUserPermissions.map((str) => str.replace(pattern, "$1$3 $2$4"));
+	missingBotPermissions = missingBotPermissions.map((str) => str.replace(pattern, "$1$3 $2$4"));
+	let embedDescription = "";
+	const formatter = new Intl.ListFormat("en", {
+		style: "long",
+		type: "conjunction"
+	});
+	const getPermissionWord = (permissions) => permissions.length === 1 ? "permission" : "permissions";
+	if (missingUserPermissions.length) {
+		const formattedPermissions = missingUserPermissions.map((p) => `\`${p}\``);
+		const permissionsString = formatter.format(formattedPermissions);
+		embedDescription += `- You must have the ${permissionsString} ${getPermissionWord(missingUserPermissions)} to be able to run this command.\n`;
+	}
+	if (missingBotPermissions.length) {
+		const formattedPermissions = missingBotPermissions.map((p) => `\`${p}\``);
+		const permissionsString = formatter.format(formattedPermissions);
+		embedDescription += `- I must have the ${permissionsString} ${getPermissionWord(missingBotPermissions)} to be able to execute this command.\n`;
+	}
+	const embed = new discord_js.EmbedBuilder().setTitle(`:x: Missing permissions!`).setDescription(embedDescription).setColor("Red");
+	try {
+		var _message$channel2;
+		if (interaction && interaction.isRepliable()) await interaction.reply({
+			embeds: [embed],
+			flags: discord_js.MessageFlags.Ephemeral
+		});
+		else if (message && ((_message$channel2 = message.channel) === null || _message$channel2 === void 0 ? void 0 : _message$channel2.isSendable())) await message.reply({ embeds: [embed] });
+	} catch (error) {
+		Logger.error`Could not send 'Not enough permissions' reply to user ${(interaction === null || interaction === void 0 ? void 0 : interaction.user.id) ?? (message === null || message === void 0 ? void 0 : message.author.id)} for command ${command.command.name}: ${error}`;
+	}
+	require_signals.stopMiddlewares();
+}
+
 //#endregion
 //#region src/app/register/CommandRegistrar.ts
 /**
@@ -2646,25 +2730,40 @@ var CommandRegistrar = class {
 	* Gets the commands data.
 	*/
 	getCommandsData() {
-		const handler = this.commandkit.commandHandler;
-		const commands = handler.getCommandsArray();
-		return commands.flatMap((cmd) => {
-			const json$1 = "toJSON" in cmd.data.command ? cmd.data.command.toJSON() : cmd.data.command;
-			const collections = [json$1];
-			if (cmd.data.userContextMenu && json$1.type !== discord_js.ApplicationCommandType.User) collections.push({
-				...json$1,
-				type: discord_js.ApplicationCommandType.User,
-				options: void 0,
-				description_localizations: void 0,
-				description: void 0
-			});
-			if (cmd.data.messageContextMenu && json$1.type !== discord_js.ApplicationCommandType.Message) collections.push({
-				...json$1,
-				type: discord_js.ApplicationCommandType.Message,
-				description_localizations: void 0,
-				description: void 0,
-				options: void 0
+		return this.commandkit.commandHandler.getCommandsArray().flatMap((cmd) => {
+			const json = "toJSON" in cmd.data.command ? cmd.data.command.toJSON() : cmd.data.command;
+			const __metadata = cmd.metadata ?? cmd.data.metadata;
+			const collections = [];
+			if (cmd.data.chatInput) collections.push({
+				...json,
+				type: discord_js.ApplicationCommandType.ChatInput,
+				description: json.description ?? "No command description set.",
+				__metadata
 			});
+			if (cmd.data.userContextMenu) {
+				var _metadata$nameAliases;
+				collections.push({
+					...json,
+					name: (__metadata === null || __metadata === void 0 || (_metadata$nameAliases = __metadata.nameAliases) === null || _metadata$nameAliases === void 0 ? void 0 : _metadata$nameAliases.user) ?? json.name,
+					type: discord_js.ApplicationCommandType.User,
+					options: void 0,
+					description_localizations: void 0,
+					description: void 0,
+					__metadata
+				});
+			}
+			if (cmd.data.messageContextMenu) {
+				var _metadata$nameAliases2;
+				collections.push({
+					...json,
+					name: (__metadata === null || __metadata === void 0 || (_metadata$nameAliases2 = __metadata.nameAliases) === null || _metadata$nameAliases2 === void 0 ? void 0 : _metadata$nameAliases2.message) ?? json.name,
+					type: discord_js.ApplicationCommandType.Message,
+					description_localizations: void 0,
+					description: void 0,
+					options: void 0,
+					__metadata
+				});
+			}
 			return collections;
 		});
 	}
@@ -2687,18 +2786,18 @@ var CommandRegistrar = class {
 		if (preRegistrationPrevented) return;
 		if (!this.commandkit.client.isReady()) throw new Error("Cannot register commands before the client is ready");
 		const guildCommands = commands.filter((command) => {
-			var _command$guilds;
-			return (_command$guilds = command.guilds) === null || _command$guilds === void 0 ? void 0 : _command$guilds.filter(Boolean).length;
+			var _command$__metadata;
+			return (_command$__metadata = command.__metadata) === null || _command$__metadata === void 0 || (_command$__metadata = _command$__metadata.guilds) === null || _command$__metadata === void 0 ? void 0 : _command$__metadata.filter(Boolean).length;
 		}).map((c) => {
-			var _c$guilds;
+			var _c$__metadata;
 			return {
 				...c,
-				guilds: Array.from(new Set((_c$guilds = c.guilds) === null || _c$guilds === void 0 ? void 0 : _c$guilds.filter(Boolean)))
+				guilds: Array.from(new Set((_c$__metadata = c.__metadata) === null || _c$__metadata === void 0 || (_c$__metadata = _c$__metadata.guilds) === null || _c$__metadata === void 0 ? void 0 : _c$__metadata.filter(Boolean)))
 			};
 		});
 		const globalCommands = commands.filter((command) => {
-			var _command$guilds2;
-			return !((_command$guilds2 = command.guilds) === null || _command$guilds2 === void 0 ? void 0 : _command$guilds2.filter(Boolean).length);
+			var _command$__metadata2;
+			return !((_command$__metadata2 = command.__metadata) === null || _command$__metadata2 === void 0 || (_command$__metadata2 = _command$__metadata2.guilds) === null || _command$__metadata2 === void 0 ? void 0 : _command$__metadata2.filter(Boolean).length);
 		});
 		await this.updateGlobalCommands(globalCommands);
 		await this.updateGuildCommands(guildCommands);
@@ -2722,11 +2821,11 @@ var CommandRegistrar = class {
 		try {
 			const data = await this.api.put(discord_js.Routes.applicationCommands(this.commandkit.client.user.id), { body: commands.map((c) => ({
 				...c,
-				guilds: void 0
+				__metadata: void 0
 			})) });
 			Logger.info(`✨ Refreshed ${data.length} global application (/) commands`);
 		} catch (e) {
-			Logger.error("Failed to update global application (/) commands", e);
+			Logger.error`Failed to update global application (/) commands: ${e}`;
 		}
 	}
 	/**
@@ -2749,9 +2848,9 @@ var CommandRegistrar = class {
 		try {
 			const guildCommandsMap = /* @__PURE__ */ new Map();
 			commands.forEach((command) => {
-				var _command$guilds3;
-				if (!((_command$guilds3 = command.guilds) === null || _command$guilds3 === void 0 ? void 0 : _command$guilds3.length)) return;
-				command.guilds.forEach((guild) => {
+				var _command$__metadata3, _command$__metadata4;
+				if (!((_command$__metadata3 = command.__metadata) === null || _command$__metadata3 === void 0 || (_command$__metadata3 = _command$__metadata3.guilds) === null || _command$__metadata3 === void 0 ? void 0 : _command$__metadata3.length)) return;
+				(_command$__metadata4 = command.__metadata) === null || _command$__metadata4 === void 0 || (_command$__metadata4 = _command$__metadata4.guilds) === null || _command$__metadata4 === void 0 || _command$__metadata4.forEach((guild) => {
 					if (!guildCommandsMap.has(guild)) guildCommandsMap.set(guild, []);
 					guildCommandsMap.get(guild).push(command);
 				});
@@ -2773,19 +2872,25 @@ var CommandRegistrar = class {
 				if (prevented$1) continue;
 				const data = await this.api.put(discord_js.Routes.applicationGuildCommands(this.commandkit.client.user.id, guild), { body: guildCommands.map((b) => ({
 					...b,
-					guilds: void 0
+					__metadata: void 0
 				})) });
 				count += data.length;
 			}
 			Logger.info(`✨ Refreshed ${count} guild application (/) commands`);
 		} catch (e) {
-			Logger.error("Failed to update guild application (/) commands", e);
+			Logger.error`Failed to update guild application (/) commands: ${e}`;
 		}
 	}
 };
 
 //#endregion
 //#region src/app/handlers/AppCommandHandler.ts
+const KNOWN_NON_HANDLER_KEYS = [
+	"command",
+	"generateMetadata",
+	"metadata",
+	"aiConfig"
+];
 /**
 * @private
 * @internal
@@ -2900,12 +3005,10 @@ var AppCommandHandler = class {
 				console.log(require_colors.colors_default.cyan(`${indent}${thisPrefix} ${require_colors.colors_default.bold(displayName)}`));
 			}
 			commands.forEach((cmd, cmdIndex) => {
-				const cmdIsLast = cmdIndex === commands.length - 1 && !hasChildren;
-				const cmdPrefix = cmdIsLast ? "└─" : "├─";
+				const cmdPrefix = cmdIndex === commands.length - 1 && !hasChildren ? "└─" : "├─";
 				const cmdIndent = category !== uncategorized ? childIndent : indent;
 				const name = cmd.data.command.name;
-				const hasMw = cmd.command.middlewares.length > 0;
-				const middlewareIcon = hasMw ? require_colors.colors_default.magenta(" (λ)") : "";
+				const middlewareIcon = cmd.command.middlewares.length > 0 ? require_colors.colors_default.magenta(" (λ)") : "";
 				console.log(`${require_colors.colors_default.green(`${cmdIndent}${cmdPrefix}`)} ${require_colors.colors_default.yellow(name)}${middlewareIcon}`);
 			});
 			if (hasChildren) {
@@ -2945,21 +3048,18 @@ var AppCommandHandler = class {
 	*/
 	registerCommandHandler() {
 		this.onInteraction ??= async (interaction) => {
-			const success = await this.commandkit.plugins.execute(async (ctx, plugin) => {
+			if (await this.commandkit.plugins.execute(async (ctx, plugin) => {
 				return plugin.onBeforeInteraction(ctx, interaction);
-			});
-			if (success) return;
-			const isCommandLike = interaction.isCommand() || interaction.isAutocomplete() || interaction.isUserContextMenuCommand() || interaction.isMessageContextMenuCommand();
-			if (!isCommandLike) return;
+			})) return;
+			if (!(interaction.isCommand() || interaction.isAutocomplete() || interaction.isUserContextMenuCommand() || interaction.isMessageContextMenuCommand())) return;
 			const prepared = await this.prepareCommandRun(interaction);
 			if (!prepared) return;
 			return this.commandRunner.runCommand(prepared, interaction);
 		};
 		this.onMessageCreate ??= async (message) => {
-			const success = await this.commandkit.plugins.execute(async (ctx, plugin) => {
+			if (await this.commandkit.plugins.execute(async (ctx, plugin) => {
 				return plugin.onBeforeMessageCommand(ctx, message);
-			});
-			if (success) return;
+			})) return;
 			if (message.author.bot) return;
 			const prepared = await this.prepareCommandRun(message);
 			if (!prepared) return;
@@ -2975,50 +3075,63 @@ var AppCommandHandler = class {
 	* @returns Prepared command execution data or null if command not found
 	*/
 	async prepareCommandRun(source, cmdName) {
-		var _loadedCommand$guilds2;
-		const config = getConfig();
-		if (config.disablePrefixCommands && source instanceof discord_js.Message) return null;
+		var _loadedCommand$metada3, _loadedCommand$metada4;
+		if (getConfig().disablePrefixCommands && source instanceof discord_js.Message) return null;
 		let parser;
 		if (!cmdName) if (source instanceof discord_js.Message) {
 			if (source.author.bot) return null;
 			const prefix = await this.commandkit.appConfig.getMessageCommandPrefix(source);
-			if (!prefix || !prefix.length) return null;
-			parser = new require_MessageCommandParser.MessageCommandParser(source, Array.isArray(prefix) ? prefix : [prefix], (command) => {
-				var _loadedCommand$guilds, _json$options;
+			if (!prefix || (typeof prefix === "string" || Array.isArray(prefix)) && !prefix.length) return null;
+			parser = new require_MessageCommandParser.MessageCommandParser(source, prefix instanceof RegExp ? prefix : Array.isArray(prefix) ? prefix : [prefix], (command) => {
+				var _loadedCommand$metada, _loadedCommand$metada2, _json$options;
 				const loadedCommand$1 = this.findCommandByName(command);
 				if (!loadedCommand$1) {
-					if (require_constants.COMMANDKIT_IS_DEV && this.commandkit.config.showUnknownPrefixCommandsWarning) Logger.error(`Prefix command "${command}" was not found.\nNote: This warning is only shown in development mode as an alert to help you find the command. If you wish to remove this warning, set \`showUnknownPrefixCommandsWarning\` to \`false\` in your commandkit config.`);
+					if (require_constants.COMMANDKIT_IS_DEV && this.commandkit.config.showUnknownPrefixCommandsWarning) Logger.error`Prefix command "${command}" was not found.\nNote: This warning is only shown in development mode as an alert to help you find the command. If you wish to remove this warning, set \`showUnknownPrefixCommandsWarning\` to \`false\` in your commandkit config.`;
 					return null;
 				}
-				if (source.guildId && ((_loadedCommand$guilds = loadedCommand$1.guilds) === null || _loadedCommand$guilds === void 0 ? void 0 : _loadedCommand$guilds.length) && !loadedCommand$1.guilds.includes(source.guildId)) return null;
-				const json$1 = "toJSON" in loadedCommand$1.data.command ? loadedCommand$1.data.command.toJSON() : loadedCommand$1.data.command;
-				return ((_json$options = json$1.options) === null || _json$options === void 0 ? void 0 : _json$options.reduce((acc, opt) => {
+				if (source.guildId && ((_loadedCommand$metada = loadedCommand$1.metadata) === null || _loadedCommand$metada === void 0 || (_loadedCommand$metada = _loadedCommand$metada.guilds) === null || _loadedCommand$metada === void 0 ? void 0 : _loadedCommand$metada.length) && !((_loadedCommand$metada2 = loadedCommand$1.metadata) === null || _loadedCommand$metada2 === void 0 ? void 0 : _loadedCommand$metada2.guilds.includes(source.guildId))) return null;
+				return ((_json$options = ("toJSON" in loadedCommand$1.data.command ? loadedCommand$1.data.command.toJSON() : loadedCommand$1.data.command).options) === null || _json$options === void 0 ? void 0 : _json$options.reduce((acc, opt) => {
 					acc[opt.name] = opt.type;
 					return acc;
 				}, {})) ?? {};
 			});
 			try {
-				const fullCommand = parser.getFullCommand();
-				const parts = fullCommand.split(" ");
-				cmdName = parts[0];
+				cmdName = parser.getFullCommand().split(" ")[0];
 			} catch (e) {
 				if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.InvalidCommandPrefix)) return null;
-				Logger.error(e);
+				Logger.error`${e}`;
 				return null;
 			}
 		} else {
-			const isAnyCommand = source.isChatInputCommand() || source.isAutocomplete() || source.isContextMenuCommand();
-			if (!isAnyCommand) return null;
+			if (!(source.isChatInputCommand() || source.isAutocomplete() || source.isContextMenuCommand())) return null;
 			cmdName = source.commandName;
 		}
-		const loadedCommand = this.findCommandByName(cmdName);
+		const hint = require_helpers.isInteractionSource(source) ? source.isUserContextMenuCommand() ? "user" : source.isMessageContextMenuCommand() ? "message" : void 0 : void 0;
+		const loadedCommand = this.findCommandByName(cmdName, hint);
 		if (!loadedCommand) return null;
-		if ((source instanceof discord_js.CommandInteraction || source instanceof discord_js.AutocompleteInteraction) && source.guildId && ((_loadedCommand$guilds2 = loadedCommand.guilds) === null || _loadedCommand$guilds2 === void 0 ? void 0 : _loadedCommand$guilds2.length) && !loadedCommand.guilds.includes(source.guildId)) return null;
+		if ((source instanceof discord_js.CommandInteraction || source instanceof discord_js.AutocompleteInteraction) && source.guildId && ((_loadedCommand$metada3 = loadedCommand.metadata) === null || _loadedCommand$metada3 === void 0 || (_loadedCommand$metada3 = _loadedCommand$metada3.guilds) === null || _loadedCommand$metada3 === void 0 ? void 0 : _loadedCommand$metada3.length) && !((_loadedCommand$metada4 = loadedCommand.metadata) === null || _loadedCommand$metada4 === void 0 ? void 0 : _loadedCommand$metada4.guilds.includes(source.guildId))) return null;
+		if (source instanceof discord_js.Message) {
+			var _loadedCommand$metada5;
+			if (!source.guildId) return null;
+			if (((_loadedCommand$metada5 = loadedCommand.metadata) === null || _loadedCommand$metada5 === void 0 || (_loadedCommand$metada5 = _loadedCommand$metada5.guilds) === null || _loadedCommand$metada5 === void 0 ? void 0 : _loadedCommand$metada5.length) && !loadedCommand.metadata.guilds.includes(source.guildId)) return null;
+		}
 		const middlewares = [];
-		for (const middlewareId of loadedCommand.command.middlewares) {
-			const middleware = this.loadedMiddlewares.get(middlewareId);
+		for (const middlewareId$1 of loadedCommand.command.middlewares) {
+			const middleware = this.loadedMiddlewares.get(middlewareId$1);
 			if (middleware) middlewares.push(middleware);
 		}
+		if (!getConfig().disablePermissionsMiddleware) middlewares.push({
+			data: { beforeExecute },
+			middleware: {
+				command: null,
+				global: true,
+				id: middlewareId,
+				name: "permissions",
+				parentPath: "",
+				path: "",
+				relativePath: ""
+			}
+		});
 		return {
 			command: loadedCommand,
 			middlewares,
@@ -3028,12 +3141,19 @@ var AppCommandHandler = class {
 	/**
 	* Finds a command by name.
 	* @param name - The command name to search for
+	* @param hint - The hint for the command type (user or message)
 	* @returns The loaded command or null if not found
 	*/
-	findCommandByName(name) {
+	findCommandByName(name, hint) {
 		for (const [, loadedCommand] of this.loadedCommands) {
+			var _loadedCommand$data$m2;
+			if (hint) {
+				var _loadedCommand$data$m;
+				const nameAliases = (_loadedCommand$data$m = loadedCommand.data.metadata) === null || _loadedCommand$data$m === void 0 ? void 0 : _loadedCommand$data$m.nameAliases;
+				if (nameAliases && nameAliases[hint] === name) return loadedCommand;
+			}
 			if (loadedCommand.data.command.name === name) return loadedCommand;
-			const aliases = loadedCommand.data.command.aliases;
+			const aliases = (_loadedCommand$data$m2 = loadedCommand.data.metadata) === null || _loadedCommand$data$m2 === void 0 ? void 0 : _loadedCommand$data$m2.aliases;
 			if (aliases && Array.isArray(aliases) && aliases.includes(name)) return loadedCommand;
 		}
 		return null;
@@ -3098,7 +3218,7 @@ var AppCommandHandler = class {
 		for (const [id, command] of combinedCommands) await this.loadCommand(id, command);
 		if (require_constants.COMMANDKIT_IS_DEV) {
 			const commandNames = Array.from(this.loadedCommands.values()).map((v) => v.data.command.name);
-			const aliases = Array.from(this.loadedCommands.values()).flatMap((v) => v.data.command.aliases || []);
+			const aliases = Array.from(this.loadedCommands.values()).flatMap((v) => v.metadata.aliases || []);
 			const allNames = [...commandNames, ...aliases];
 			await require_types_package.rewriteCommandDeclaration(`type CommandTypeData = ${allNames.map((name) => JSON.stringify(name)).join(" | ")}`);
 		}
@@ -3124,7 +3244,7 @@ var AppCommandHandler = class {
 				data
 			});
 		} catch (error) {
-			Logger.error(`Failed to load middleware ${id}`, error);
+			Logger.error`Failed to load middleware ${id}: ${error}`;
 		}
 	}
 	/**
@@ -3136,30 +3256,41 @@ var AppCommandHandler = class {
 			if (command.path === null) {
 				this.loadedCommands.set(id, {
 					command,
-					data: { command: {
-						name: command.name,
-						description: `${command.name} command`,
-						type: 1
-					} }
+					metadata: {
+						guilds: [],
+						aliases: [],
+						userPermissions: [],
+						botPermissions: []
+					},
+					data: { command: { name: command.name } }
 				});
 				return;
 			}
 			const commandFileData = await import(`${require_resolve_file_url.toFileURL(command.path)}?t=${Date.now()}`);
 			if (!commandFileData.command) throw new Error(`Invalid export for command ${command.name}: no command definition found`);
+			const metadataFunc = commandFileData.generateMetadata;
+			const metadataObj = commandFileData.metadata;
+			if (metadataFunc && metadataObj) throw new Error("A command may only export either `generateMetadata` or `metadata`, not both");
+			const metadata = (metadataFunc ? await metadataFunc() : metadataObj) ?? {
+				aliases: [],
+				guilds: [],
+				userPermissions: [],
+				botPermissions: []
+			};
 			const commandName = commandFileData.command.name || command.name;
-			const commandDescription = commandFileData.command.description || `${commandName} command`;
+			let commandDescription = commandFileData.command.description;
+			if (!commandDescription && commandFileData.chatInput) commandDescription = "No command description set.";
 			const updatedCommandData = {
 				...commandFileData.command,
 				name: commandName,
-				description: commandDescription,
-				aliases: commandFileData.command.aliases
+				description: commandDescription
 			};
 			let handlerCount = 0;
 			for (const [key, propValidator] of Object.entries(commandDataSchema)) {
 				const exportedProp = commandFileData[key];
 				if (exportedProp) {
 					if (!await propValidator(exportedProp)) throw new Error(`Invalid export for command ${command.name}: ${key} does not match expected value`);
-					if (key !== "command") handlerCount++;
+					if (!KNOWN_NON_HANDLER_KEYS.includes(key)) handlerCount++;
 				}
 			}
 			if (handlerCount === 0) throw new Error(`Invalid export for command ${command.name}: at least one handler function must be provided`);
@@ -3168,18 +3299,45 @@ var AppCommandHandler = class {
 				const res = await plugin.prepareCommand(ctx, lastUpdated);
 				if (res) lastUpdated = res;
 			});
+			const commandJson = "toJSON" in lastUpdated && typeof lastUpdated.toJSON === "function" ? lastUpdated.toJSON() : lastUpdated;
+			if ("guilds" in commandJson || "aliases" in commandJson) Logger.warn(`Command \`${command.name}\` uses deprecated metadata properties. Please update to use the new \`metadata\` object or \`generateMetadata\` function.`);
 			this.loadedCommands.set(id, {
 				command,
-				guilds: commandFileData.command.guilds,
+				metadata: {
+					guilds: commandJson.guilds,
+					aliases: commandJson.aliases,
+					...metadata
+				},
 				data: {
 					...commandFileData,
-					command: "toJSON" in lastUpdated && typeof lastUpdated.toJSON === "function" ? lastUpdated.toJSON() : lastUpdated
+					metadata: {
+						guilds: commandJson.guilds,
+						aliases: commandJson.aliases,
+						...metadata
+					},
+					command: commandJson
 				}
 			});
 		} catch (error) {
-			Logger.error(`Failed to load command ${command.name} (${id})`, error);
+			Logger.error`Failed to load command ${command.name} (${id}): ${error}`;
 		}
 	}
+	/**
+	* Gets the metadata for a command.
+	* @param command - The command name to get metadata for
+	* @param hint - The hint for the command type (user or message)
+	* @returns The command metadata or null if not found
+	*/
+	getMetadataFor(command, hint) {
+		const loadedCommand = this.findCommandByName(command, hint);
+		if (!loadedCommand) return null;
+		return loadedCommand.metadata ??= {
+			aliases: [],
+			guilds: [],
+			userPermissions: [],
+			botPermissions: []
+		};
+	}
 };
 
 //#endregion
@@ -3206,8 +3364,7 @@ var AppEventsHandler = class {
 	*/
 	getEvents() {
 		if (this.loadedEvents.size === 0) return [];
-		const events = this.loadedEvents.toJSON();
-		return events.map((event) => ({
+		return this.loadedEvents.toJSON().map((event) => ({
 			name: event.name,
 			namespace: event.namespace,
 			onceListeners: event.listeners.filter((listener) => listener.once).length,
@@ -3229,13 +3386,12 @@ var AppEventsHandler = class {
 		await this.commandkit.plugins.execute((ctx, plugin) => {
 			return plugin.onBeforeEventsLoad(ctx);
 		});
-		const router = this.commandkit.eventsRouter;
-		const events = await router.scan();
+		const events = await this.commandkit.eventsRouter.scan();
 		for (const event of Object.values(events)) {
 			const listeners = [];
 			for (const listener of event.listeners) {
 				const handler = await import(require_resolve_file_url.toFileURL(listener, true));
-				if (!handler.default || typeof handler.default !== "function") Logger.error(`Event handler for ${event.event}${event.namespace ? ` of namespace ${event.namespace}` : ""} does not have a default export or is not a function`);
+				if (!handler.default || typeof handler.default !== "function") Logger.error`Event handler for ${event.event}${event.namespace ? ` of namespace ${event.namespace}` : ""} does not have a default export or is not a function`;
 				listeners.push({
 					handler: handler.default,
 					once: !!handler.once
@@ -3301,13 +3457,13 @@ var AppEventsHandler = class {
 					variables: /* @__PURE__ */ new Map()
 				}, async () => {
 					for (const listener of onListeners) try {
-						await listener.handler(...args);
+						await listener.handler(...args, client, this.commandkit);
 					} catch (e) {
 						if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.StopEvents)) {
 							Logger.debug(`Event propagation stopped for ${name}${namespace ? ` of namespace ${namespace}` : ""}`);
 							break;
 						}
-						Logger.error(`Error handling event ${name}${namespace ? ` of namespace ${namespace}` : ""}`, e);
+						Logger.error`Error handling event ${name}${namespace ? ` of namespace ${namespace}` : ""}: ${e}`;
 					}
 				});
 			};
@@ -3342,14 +3498,14 @@ var AppEventsHandler = class {
 					}, async () => {
 						try {
 							if (executedOnceListeners.has(listener.handler)) return;
-							await listener.handler(...args);
+							await listener.handler(...args, client, this.commandkit);
 							executedOnceListeners.add(listener.handler);
 						} catch (e) {
 							if (require_error_codes.isErrorType(e, require_error_codes.CommandKitErrorCodes.StopEvents)) {
 								Logger.debug(`Event propagation stopped for ${name}${namespace ? ` of namespace ${namespace}` : ""}`);
 								broken = true;
 							}
-							Logger.error(`Error handling event ${name}${namespace ? ` of namespace ${namespace}` : ""}`, e);
+							Logger.error`Error handling event ${name}${namespace ? ` of namespace ${namespace}` : ""}: ${e}`;
 						}
 					});
 				}
@@ -3495,8 +3651,7 @@ function registerDevHooks(commandkit$1) {
 function getVariableStore() {
 	const ctx = getContext();
 	if (!ctx) try {
-		const eventContext = require_EventWorkerContext.getEventWorkerContext();
-		return eventContext.variables;
+		return require_EventWorkerContext.getEventWorkerContext().variables;
 	} catch {
 		return null;
 	}
@@ -3585,7 +3740,7 @@ var AnalyticsEngine = class {
 			var _identify, _ref;
 			await ((_identify = (_ref = this.#provider).identify) === null || _identify === void 0 ? void 0 : _identify.call(_ref, this, event));
 		} catch (error) {
-			Logger.error(`Error identifying with provider ${this.#provider.name}`, error);
+			Logger.error`Error identifying with provider ${this.#provider.name}: ${error}`;
 		}
 	}
 	/**
@@ -3600,12 +3755,11 @@ var AnalyticsEngine = class {
 			if (await this.#doNotTrack(event)) return;
 			await this.#provider.track(this, event);
 		} catch (error) {
-			Logger.error(`Error tracking ${event.name} event with provider ${this.#provider.name}`, error);
+			Logger.error`Error tracking ${event.name} event with provider ${this.#provider.name}: ${error}`;
 		}
 	}
 	async #doNotTrack(event) {
-		const dnt = getDoNotTrack();
-		if (dnt) return true;
+		if (getDoNotTrack()) return true;
 		if (this.#filter) return !this.#filter(this, event);
 		return false;
 	}
@@ -3723,7 +3877,6 @@ var CommandKit = class CommandKit extends node_events.default {
 	/**
 	* Create a new command and event handler with CommandKit.
 	* @param options - The default CommandKit configuration.
-	* @see {@link https://commandkit.js.org/docs/guide/commandkit-setup}
 	*/
 	constructor(options = {}) {
 		if (CommandKit.instance) process.emitWarning("CommandKit instance already exists. Having multiple instance in same project is discouraged and it may lead to unexpected behavior.", { code: "MultiInstanceWarning" });
@@ -3739,7 +3892,7 @@ var CommandKit = class CommandKit extends node_events.default {
 		for (const hook of bootstrapHooks) try {
 			await hook(this);
 		} catch (e) {
-			Logger.error("Error while executing bootstrap hook: ", e);
+			Logger.error`Error while executing bootstrap hook: ${e}`;
 		} finally {
 			bootstrapHooks.delete(hook);
 		}
@@ -3749,7 +3902,7 @@ var CommandKit = class CommandKit extends node_events.default {
 		for (const hook of onApplicationBootstrapHooks) try {
 			await hook(this);
 		} catch (e) {
-			Logger.error("Error while executing application bootstrap hook: ", e);
+			Logger.error`Error while executing application bootstrap hook: ${e}`;
 		} finally {
 			onApplicationBootstrapHooks.delete(hook);
 		}
@@ -3767,7 +3920,7 @@ var CommandKit = class CommandKit extends node_events.default {
 			registerDevHooks(this);
 			await require_types_package.generateTypesPackage();
 		} catch (e) {
-			if (process.env.COMMANDKIT_DEBUG_TYPEGEN) Logger.error(e);
+			if (process.env.COMMANDKIT_DEBUG_TYPEGEN) Logger.error`${e}`;
 		}
 		await this.loadPlugins();
 		await this.#init();
@@ -3795,8 +3948,7 @@ var CommandKit = class CommandKit extends node_events.default {
 	* Loads all the plugins.
 	*/
 	async loadPlugins() {
-		const config = await loadConfigFile();
-		const plugins = config.plugins.flat(2).filter((p) => require_RuntimePlugin.isRuntimePlugin(p));
+		const plugins = (await loadConfigFile()).plugins.flat(2).filter((p) => require_RuntimePlugin.isRuntimePlugin(p));
 		if (!plugins.length) return;
 		for (const plugin of plugins) await this.plugins.softRegisterPlugin(plugin);
 	}
@@ -3844,8 +3996,7 @@ var CommandKit = class CommandKit extends node_events.default {
 		return this;
 	}
 	async #init() {
-		const appDir$1 = this.getAppDirectory();
-		if (!appDir$1) return;
+		if (!this.getAppDirectory()) throw new Error("CommandKit could not determine the application directory. This issue is common when you are not using the `commandkit dev` command to start the project. You can either use `commandkit dev` to start the project, or set the `COMMANDKIT_IS_CLI=true` environment variable (Note that adding this to `.env` file may not work). If you are trying to start the production build, make sure your current working directory is the directory where `commandkit.config.ts` file is located.");
 		const commandsPath = this.getPath("commands");
 		const events = this.getPath("events");
 		this.commandHandler = new AppCommandHandler(this);
@@ -4150,6 +4301,12 @@ Object.defineProperty(exports, 'after', {
     return after;
   }
 });
+Object.defineProperty(exports, 'beforeExecute', {
+  enumerable: true,
+  get: function () {
+    return beforeExecute;
+  }
+});
 Object.defineProperty(exports, 'cancelAfter', {
   enumerable: true,
   get: function () {
@@ -4276,6 +4433,12 @@ Object.defineProperty(exports, 'makeContextAwareFunction', {
     return makeContextAwareFunction;
   }
 });
+Object.defineProperty(exports, 'middlewareId', {
+  enumerable: true,
+  get: function () {
+    return middlewareId;
+  }
+});
 Object.defineProperty(exports, 'noAnalytics', {
   enumerable: true,
   get: function () {
@@ -4312,4 +4475,10 @@ Object.defineProperty(exports, 'useEnvironment', {
     return useEnvironment;
   }
 });
-//# sourceMappingURL=commandkit-DMEW0kJg.js.map
+Object.defineProperty(exports, 'useStore', {
+  enumerable: true,
+  get: function () {
+    return useStore;
+  }
+});
+//# sourceMappingURL=commandkit-ZoBBh0Q_.js.map