commandkit 1.2.0-rc.3 → 1.2.0-rc.4

package/dist/{commandkit-5VMG2thU.js → commandkit-c0sAaK0G.js}

@@ -1,6 +1,6 @@
 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_error_codes = require('./error-codes-Ds0bnPvT.js');
 const require_element = require('./element-Bak9llw_.js');
 const require_EventInterceptor = require('./EventInterceptor-CQ4PBpBJ.js');
 const require_constants = require('./constants-B5_Ta7PR.js');
@@ -9,10 +9,10 @@ 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_constants$1 = require('./constants-DxfYtA6t.js');
+const require_EventWorkerContext = require('./EventWorkerContext-TZIKxVCu.js');
+const require_signals = require('./signals-r7qPAvOR.js');
+const require_MessageCommandParser = require('./MessageCommandParser-TPEPhjvx.js');
 const require_CommandsRouter = require('./CommandsRouter-tMAivEfv.js');
 const require_EventsRouter = require('./EventsRouter-C_J0M3uO.js');
 const require_common = require('./common-DNADUU3_.js');
@@ -24,6 +24,7 @@ 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 util = require_chunk.__toESM(require("util"));
 const __rollup_plugin_json = require_chunk.__toESM(require("@rollup/plugin-json"));
 
 //#region src/context/async-context.ts
@@ -65,6 +66,7 @@ function makeContextAwareFunction(env, fn, finalizer) {
 				return result;
 			} catch (e) {
 				if (!require_error_codes.isCommandKitError(e)) env.setExecutionError(e);
+				else throw e;
 			} finally {
 				if (typeof finalizer === "function") setImmediate(async () => {
 					try {
@@ -1285,47 +1287,57 @@ var DefaultLogger = class {
 		const label = this._getLevelLabel(level);
 		return `${label}${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 +1361,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;
 }
@@ -1464,7 +1476,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 +1614,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 +1633,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;
 	}
@@ -1723,6 +1735,7 @@ const defaultConfig = {
 	},
 	typedCommands: true,
 	disablePrefixCommands: false,
+	disablePermissionsMiddleware: false,
 	showUnknownPrefixCommandsWarning: true,
 	antiCrashScript: {
 		development: true,
@@ -1781,7 +1794,8 @@ function defineConfig(config = {}) {
 		antiCrashScript: {
 			...defaultConfig.antiCrashScript,
 			...config.antiCrashScript
-		}
+		},
+		disablePermissionsMiddleware: config.disablePermissionsMiddleware ?? defaultConfig.disablePermissionsMiddleware
 	};
 	return defined;
 }
@@ -2415,37 +2429,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 +2468,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 +2481,126 @@ 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 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}`;
+								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(middlewareCtx.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, plugin) => {
+						return plugin.executeCommand(ctx, env, source, prepared, executeCommand);
 					});
-					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);
+					if (!res) 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);
 		});
 	}
@@ -2650,20 +2646,26 @@ var CommandRegistrar = class {
 		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];
+			const __metadata = cmd.metadata ?? cmd.data.metadata;
+			const collections = [{
+				...json$1,
+				__metadata
+			}];
 			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
+				description: void 0,
+				__metadata
 			});
 			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
+				options: void 0,
+				__metadata
 			});
 			return collections;
 		});
@@ -2687,18 +2689,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 +2724,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 +2751,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 +2775,102 @@ 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/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) {
+		const hasPermission = userPermissions === null || userPermissions === void 0 ? void 0 : userPermissions.has(permission);
+		if (!hasPermission) missingUserPermissions.push(permission);
+	}
+	if (botPermissionsRequired.length) for (const permission of botPermissionsRequired) {
+		const hasPermission = botPermissions === null || botPermissions === void 0 ? void 0 : botPermissions.has(permission);
+		if (!hasPermission) 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/handlers/AppCommandHandler.ts
+const KNOWN_NON_HANDLER_KEYS = [
+	"command",
+	"generateMetadata",
+	"metadata",
+	"aiConfig"
+];
 /**
 * @private
 * @internal
@@ -2975,7 +3060,7 @@ var AppCommandHandler = class {
 	* @returns Prepared command execution data or null if command not found
 	*/
 	async prepareCommandRun(source, cmdName) {
-		var _loadedCommand$guilds2;
+		var _loadedCommand$metada3, _loadedCommand$metada4;
 		const config = getConfig();
 		if (config.disablePrefixCommands && source instanceof discord_js.Message) return null;
 		let parser;
@@ -2984,13 +3069,13 @@ var AppCommandHandler = class {
 			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;
+				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;
+				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;
 				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) => {
 					acc[opt.name] = opt.type;
@@ -3003,7 +3088,7 @@ var AppCommandHandler = class {
 				cmdName = parts[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 {
@@ -3013,12 +3098,24 @@ var AppCommandHandler = class {
 		}
 		const loadedCommand = this.findCommandByName(cmdName);
 		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;
 		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,
@@ -3032,8 +3129,9 @@ var AppCommandHandler = class {
 	*/
 	findCommandByName(name) {
 		for (const [, loadedCommand] of this.loadedCommands) {
+			var _loadedCommand$data$m;
 			if (loadedCommand.data.command.name === name) return loadedCommand;
-			const aliases = loadedCommand.data.command.aliases;
+			const aliases = (_loadedCommand$data$m = loadedCommand.data.metadata) === null || _loadedCommand$data$m === void 0 ? void 0 : _loadedCommand$data$m.aliases;
 			if (aliases && Array.isArray(aliases) && aliases.includes(name)) return loadedCommand;
 		}
 		return null;
@@ -3098,7 +3196,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 +3222,7 @@ var AppCommandHandler = class {
 				data
 			});
 		} catch (error) {
-			Logger.error(`Failed to load middleware ${id}`, error);
+			Logger.error`Failed to load middleware ${id}: ${error}`;
 		}
 	}
 	/**
@@ -3136,6 +3234,12 @@ var AppCommandHandler = class {
 			if (command.path === null) {
 				this.loadedCommands.set(id, {
 					command,
+					metadata: {
+						guilds: [],
+						aliases: [],
+						userPermissions: [],
+						botPermissions: []
+					},
 					data: { command: {
 						name: command.name,
 						description: `${command.name} command`,
@@ -3146,20 +3250,28 @@ var AppCommandHandler = class {
 			}
 			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`;
 			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 +3280,44 @@ 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
+	* @returns The command metadata or null if not found
+	*/
+	getMetadataFor(command) {
+		const loadedCommand = this.findCommandByName(command);
+		if (!loadedCommand) return null;
+		return loadedCommand.metadata ??= {
+			aliases: [],
+			guilds: [],
+			userPermissions: [],
+			botPermissions: []
+		};
+	}
 };
 
 //#endregion
@@ -3235,7 +3373,7 @@ var AppEventsHandler = class {
 			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
@@ -3307,7 +3445,7 @@ var AppEventsHandler = class {
 							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}`;
 					}
 				});
 			};
@@ -3349,7 +3487,7 @@ var AppEventsHandler = class {
 								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}`;
 						}
 					});
 				}
@@ -3585,7 +3723,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,7 +3738,7 @@ 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) {
@@ -3739,7 +3877,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 +3887,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 +3905,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();
@@ -4150,6 +4288,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 +4420,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 +4462,4 @@ Object.defineProperty(exports, 'useEnvironment', {
     return useEnvironment;
   }
 });
-//# sourceMappingURL=commandkit-5VMG2thU.js.map
+//# sourceMappingURL=commandkit-c0sAaK0G.js.map