commandkit 1.2.0-rc.13 → 1.2.0-rc.15

package/dist/EventsRouter-DZYIha6m.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EventsRouter-DZYIha6m.js","names":[],"sources":["../src/app/router/EventsRouter.ts"],"sourcesContent":["import { Collection } from 'discord.js';\nimport { existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\n/**\n * Configuration options for the EventsRouter\n * @interface EventsRouterOptions\n */\nexport interface EventsRouterOptions {\n  /** Root directory path where event handlers are located */\n  entrypoints: string[];\n}\n\n/**\n * Represents a parsed event with its handlers\n * @interface ParsedEvent\n */\nexport interface ParsedEvent {\n  /** Name of the event derived from directory name */\n  event: string;\n  /** Absolute path to the event directory */\n  path: string;\n  /** Array of file paths to event listener handlers */\n  listeners: string[];\n  /** Namespace of the event */\n  namespace: string | null;\n}\n\n/** Collection of event names to their parsed metadata */\nexport type EventsTree = Record<string, ParsedEvent>;\n\n/**\n * Router for discovering and managing event handler files in a directory structure.\n * Events are represented by directories, and handlers are files within those directories.\n */\nexport class EventsRouter {\n  /** Internal storage of parsed events */\n  private events = new Collection<string, ParsedEvent>();\n\n  /**\n   * Creates a new EventsRouter instance\n   * @param options - Configuration options for the router\n   * @throws Error if entrypoint is not provided\n   */\n  public constructor(private options: EventsRouterOptions) {\n    if (options.entrypoints) {\n      options.entrypoints = Array.from(new Set(options.entrypoints));\n    }\n\n    if (!options.entrypoints?.length) {\n      throw new Error('Entrypoint directory must be provided');\n    }\n  }\n\n  /**\n   * Adds new entrypoints to the router\n   * @param entrypoints - Array of new entrypoint paths\n   */\n  public addEntrypoints(entrypoints: string[]) {\n    this.options.entrypoints = Array.from(\n      new Set([...this.options.entrypoints, ...entrypoints]),\n    );\n  }\n\n  /**\n   * Find a parsed event by its name\n   * @param event - Name of the event to find\n   * @returns Parsed event metadata or null if not found\n   */\n  public match(event: string): ParsedEvent | null {\n    return this.events.get(event) ?? null;\n  }\n\n  /**\n   * Get the entrypoint directory path\n   * @returns Entrypoint directory path\n   */\n  public get entrypoints(): string[] {\n    return this.options.entrypoints;\n  }\n\n  /**\n   * Checks if the entrypoint path is valid\n   */\n  public isValidPath() {\n    return this.entrypoints.every((entrypoint) => existsSync(entrypoint));\n  }\n\n  /**\n   * Clear all parsed events\n   */\n  public clear() {\n    this.events.clear();\n  }\n\n  /**\n   * Reload and re-scan the entrypoint directory for events\n   * @returns Promise resolving to the updated events tree\n   */\n  public async reload() {\n    this.clear();\n    return this.scan();\n  }\n\n  /**\n   * Scan the entrypoint directory for events and their handlers\n   * @returns Promise resolving to the events tree\n   */\n  public async scan(): Promise<EventsTree> {\n    for (const entrypoint of this.entrypoints) {\n      const dirs = await readdir(entrypoint, { withFileTypes: true });\n\n      for (const dir of dirs) {\n        if (dir.isDirectory()) {\n          const path = join(entrypoint, dir.name);\n          await this.scanEvent(dir.name, path, null, [], true);\n        }\n      }\n    }\n\n    return Object.fromEntries(this.events);\n  }\n\n  /**\n   * Convert the internal events Collection to a plain object\n   * @returns Events tree as a plain object\n   */\n  public toJSON(): EventsTree {\n    return Object.fromEntries(this.events);\n  }\n\n  /**\n   * Recursively scan a directory for event handlers\n   * @param event - Name of the event\n   * @param path - Path to the event directory\n   * @param listeners - Array to collect listener file paths\n   * @returns Promise resolving to the parsed event metadata\n   */\n  private async scanEvent(\n    event: string,\n    path: string,\n    _namespace: string | null = null,\n    listeners: string[] = [],\n    isRoot = false,\n  ): Promise<void> {\n    const files = await readdir(path, { withFileTypes: true });\n    const isNamespace = isRoot && /^\\(.+\\)$/.test(event);\n\n    // if event = (something) pattern then namespace is something\n    const namespace = isNamespace ? event.slice(1, -1) : (_namespace ?? null);\n\n    files.sort((a, b) => a.name.localeCompare(b.name));\n\n    for (const file of files) {\n      if (file.name.startsWith('_')) continue;\n\n      if (file.isDirectory()) {\n        const nextPath = join(path, file.name);\n        await this.scanEvent(file.name, nextPath, namespace, listeners);\n        continue;\n      }\n\n      if (file.isFile() && /\\.(m|c)?(j|t)sx?$/.test(file.name)) {\n        listeners.push(join(file.parentPath, file.name));\n      }\n    }\n\n    if (!isNamespace) {\n      const existing = this.events.get(event);\n\n      if (existing) {\n        existing.listeners = Array.from(\n          new Set([...existing.listeners, ...listeners]),\n        );\n\n        return;\n      }\n\n      this.events.set(event, { event, path, listeners, namespace });\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAoCA,IAAa,eAAb,MAA0B;;CAExB,AAAQ,SAAS,IAAI,uBAAiC;;;;;;CAOtD,AAAO,YAAY,AAAQ,SAA8B;;EAA9B;AACzB,MAAI,QAAQ,YACV,SAAQ,cAAc,MAAM,KAAK,IAAI,IAAI,QAAQ,YAAY,CAAC;AAGhE,MAAI,0BAAC,QAAQ,yFAAa,QACxB,OAAM,IAAI,MAAM,wCAAwC;;;;;;CAQ5D,AAAO,eAAe,aAAuB;AAC3C,OAAK,QAAQ,cAAc,MAAM,KAC/B,IAAI,IAAI,CAAC,GAAG,KAAK,QAAQ,aAAa,GAAG,YAAY,CAAC,CACvD;;;;;;;CAQH,AAAO,MAAM,OAAmC;AAC9C,SAAO,KAAK,OAAO,IAAI,MAAM,IAAI;;;;;;CAOnC,IAAW,cAAwB;AACjC,SAAO,KAAK,QAAQ;;;;;CAMtB,AAAO,cAAc;AACnB,SAAO,KAAK,YAAY,OAAO,uCAA0B,WAAW,CAAC;;;;;CAMvE,AAAO,QAAQ;AACb,OAAK,OAAO,OAAO;;;;;;CAOrB,MAAa,SAAS;AACpB,OAAK,OAAO;AACZ,SAAO,KAAK,MAAM;;;;;;CAOpB,MAAa,OAA4B;AACvC,OAAK,MAAM,cAAc,KAAK,aAAa;GACzC,MAAM,OAAO,oCAAc,YAAY,EAAE,eAAe,MAAM,CAAC;AAE/D,QAAK,MAAM,OAAO,KAChB,KAAI,IAAI,aAAa,EAAE;IACrB,MAAM,2BAAY,YAAY,IAAI,KAAK;AACvC,UAAM,KAAK,UAAU,IAAI,MAAM,MAAM,MAAM,EAAE,EAAE,KAAK;;;AAK1D,SAAO,OAAO,YAAY,KAAK,OAAO;;;;;;CAOxC,AAAO,SAAqB;AAC1B,SAAO,OAAO,YAAY,KAAK,OAAO;;;;;;;;;CAUxC,MAAc,UACd,OACA,MACA,aAA4B,MAC5B,YAAsB,EAAE,EACxB,SAAS,OACO;EACd,MAAM,QAAQ,oCAAc,MAAM,EAAE,eAAe,MAAM,CAAC;EAC1D,MAAM,cAAc,UAAU,WAAW,KAAK,MAAM;EAGpD,MAAM,YAAY,cAAc,MAAM,MAAM,GAAG,GAAG,GAAG,cAAc;AAEnE,QAAM,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;AAElD,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,KAAK,KAAK,WAAW,IAAI,CAAE;AAE/B,OAAI,KAAK,aAAa,EAAE;IACtB,MAAM,+BAAgB,MAAM,KAAK,KAAK;AACtC,UAAM,KAAK,UAAU,KAAK,MAAM,UAAU,WAAW,UAAU;AAC/D;;AAGF,OAAI,KAAK,QAAQ,IAAI,oBAAoB,KAAK,KAAK,KAAK,CACtD,WAAU,yBAAU,KAAK,YAAY,KAAK,KAAK,CAAC;;AAIpD,MAAI,CAAC,aAAa;GAChB,MAAM,WAAW,KAAK,OAAO,IAAI,MAAM;AAEvC,OAAI,UAAU;AACZ,aAAS,YAAY,MAAM,KACzB,IAAI,IAAI,CAAC,GAAG,SAAS,WAAW,GAAG,UAAU,CAAC,CAC/C;AAED;;AAGF,QAAK,OAAO,IAAI,OAAO;IAAE;IAAO;IAAM;IAAW;IAAW,CAAC"}

package/dist/MessageCommandParser-Bs9fimmd.js

@@ -1,271 +0,0 @@
-const require_chunk = require('./chunk-kSYXY2_d.js');
-const require_error_codes = require('./error-codes-Ds0bnPvT.js');
-let discord_js = require("discord.js");
-
-//#region src/app/commands/MessageCommandParser.ts
-/**
-* Parses message content into structured command data with options and subcommands.
-*/
-var MessageCommandParser = class {
-	/**
-	* @private
-	* @internal
-	*/
-	#parsed = null;
-	/**
-	* @private
-	* @internal
-	*/
-	#options = null;
-	/**
-	* @private
-	* @internal
-	*/
-	#args = [];
-	/**
-	* Creates a new message command parser.
-	* @param message - The Discord message to parse
-	* @param prefix - Array of valid command prefixes or a regular expression
-	* @param schema - Function that returns the options schema for a command
-	*/
-	constructor(message, prefix, schema) {
-		this.message = message;
-		this.prefix = prefix;
-		this.schema = schema;
-	}
-	/**
-	* Gets the parsed command arguments.
-	* @returns Array of command arguments
-	*/
-	getArgs() {
-		this.parse();
-		return this.#args;
-	}
-	/**
-	* Gets the message command options object for easy access to typed option values.
-	*/
-	get options() {
-		if (!this.#options) this.#options = new MessageCommandOptions(this);
-		return this.#options;
-	}
-	/**
-	* Gets a specific option value by name.
-	* @param name - The option name
-	* @returns The option value or undefined if not found
-	*/
-	getOption(name) {
-		var _this$parse$options$f;
-		return (_this$parse$options$f = this.parse().options.find((o) => o.name === name)) === null || _this$parse$options$f === void 0 ? void 0 : _this$parse$options$f.value;
-	}
-	/**
-	* Gets the main command name.
-	* @returns The command name
-	*/
-	getCommand() {
-		return this.parse().command;
-	}
-	/**
-	* Gets the subcommand name if present.
-	* @returns The subcommand name or undefined
-	*/
-	getSubcommand() {
-		return this.parse().subcommand;
-	}
-	/**
-	* Gets the subcommand group name if present.
-	* @returns The subcommand group name or undefined
-	*/
-	getSubcommandGroup() {
-		return this.parse().subcommandGroup;
-	}
-	/**
-	* Gets the prefix used in the message.
-	* @returns The matched prefix or undefined
-	*/
-	getPrefix() {
-		if (this.prefix instanceof RegExp) {
-			const match = this.message.content.match(this.prefix);
-			return match === null || match === void 0 ? void 0 : match[0];
-		}
-		for (const p of this.prefix) if (this.message.content.startsWith(p)) return p;
-	}
-	/**
-	* Gets the full command including subcommand group and subcommand.
-	* @returns The complete command string
-	*/
-	getFullCommand() {
-		return [
-			this.getCommand(),
-			this.getSubcommandGroup(),
-			this.getSubcommand()
-		].filter((v) => v).join(" ");
-	}
-	/**
-	* Parses the message content into structured command data.
-	* @returns The parsed command data
-	*/
-	parse() {
-		if (this.#parsed) return this.#parsed;
-		const content = this.message.content;
-		const prefix = this.getPrefix();
-		if (!prefix) throw require_error_codes.createCommandKitError(require_error_codes.CommandKitErrorCodes.InvalidCommandPrefix);
-		const parts = content.slice(prefix.length).trim().split(" ");
-		const command = parts.shift();
-		this.#args = parts;
-		let subcommandGroup;
-		let subcommand;
-		if (command === null || command === void 0 ? void 0 : command.includes(":")) {
-			const [, group, cmd] = command.split(":");
-			if (!cmd && group) subcommand = group;
-			else if (cmd && group) {
-				subcommandGroup = group;
-				subcommand = cmd;
-			}
-		}
-		const schema = this.schema([
-			command,
-			subcommandGroup,
-			subcommand
-		].filter(Boolean).join(" ").trim());
-		this.#parsed = {
-			command,
-			options: parts.map((part) => {
-				try {
-					const [name, value] = part.split(":");
-					if (!(name in schema)) return null;
-					switch (schema[name]) {
-						case discord_js.ApplicationCommandOptionType.Boolean: return {
-							name,
-							value: value === "true"
-						};
-						case discord_js.ApplicationCommandOptionType.Integer: return {
-							name,
-							value: parseInt(value, 10)
-						};
-						case discord_js.ApplicationCommandOptionType.Number: return {
-							name,
-							value: parseFloat(value)
-						};
-						case discord_js.ApplicationCommandOptionType.String: return {
-							name,
-							value
-						};
-						case discord_js.ApplicationCommandOptionType.User: return {
-							name,
-							value: this.message.mentions.users.find((u) => {
-								return u.id === value.replace(/[<@!>]/g, "");
-							})
-						};
-						case discord_js.ApplicationCommandOptionType.Channel: return {
-							name,
-							value: this.message.mentions.channels.find((c) => {
-								return c.id === value.replace(/[<#>]/g, "");
-							})
-						};
-						case discord_js.ApplicationCommandOptionType.Role: return {
-							name,
-							value: this.message.mentions.roles.find((r) => {
-								return r.id === value.replace(/[<@&>]/g, "");
-							})
-						};
-						case discord_js.ApplicationCommandOptionType.Attachment: return {
-							name,
-							value: this.message.attachments.find((a) => {
-								return a.name === value;
-							})
-						};
-						default: return null;
-					}
-				} catch {
-					return null;
-				}
-			}).filter((v) => v !== null),
-			subcommand,
-			subcommandGroup
-		};
-		return this.#parsed;
-	}
-};
-/**
-* Provides typed access to message command options with methods similar to Discord.js interaction options.
-*/
-var MessageCommandOptions = class {
-	/**
-	* Creates a new message command options instance.
-	* @param parser - The message command parser instance
-	*/
-	constructor(parser) {
-		this.parser = parser;
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	assertOption(name, required = false) {
-		const option = this.parser.getOption(name);
-		if (required && option === void 0) throw new Error(`Option "${name}" is required.`);
-		return option ?? null;
-	}
-	getMember(name, required = false) {
-		var _this$parser$message$;
-		const user = this.assertOption(name, required);
-		const member = (_this$parser$message$ = this.parser.message.guild) === null || _this$parser$message$ === void 0 ? void 0 : _this$parser$message$.members.cache.get(user === null || user === void 0 ? void 0 : user.id);
-		if (required && !member) throw new Error(`Member "${name}" is required.`);
-		return member ?? null;
-	}
-	getAttachment(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getBoolean(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getNumber(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getString(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getInteger(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getUser(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getChannel(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getRole(name, required = false) {
-		return this.assertOption(name, required);
-	}
-	getMentionable(name, required = false) {
-		const target = this.assertOption(name, required);
-		if (target instanceof discord_js.GuildMember || target instanceof discord_js.User || target instanceof discord_js.Role) return target;
-		if (required) throw new Error(`Mentionable "${name}" is required.`);
-		return null;
-	}
-	getSubcommand(required = false) {
-		const sub = this.parser.getSubcommand();
-		if (required && sub === void 0) throw new Error("Subcommand is required.");
-		return sub ?? null;
-	}
-	getSubcommandGroup(required = false) {
-		const sub = this.parser.getSubcommandGroup();
-		if (required && sub === void 0) throw new Error("Subcommand group is required.");
-		return sub ?? null;
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'MessageCommandOptions', {
-  enumerable: true,
-  get: function () {
-    return MessageCommandOptions;
-  }
-});
-Object.defineProperty(exports, 'MessageCommandParser', {
-  enumerable: true,
-  get: function () {
-    return MessageCommandParser;
-  }
-});
-//# sourceMappingURL=MessageCommandParser-Bs9fimmd.js.map

package/dist/MessageCommandParser-Bs9fimmd.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MessageCommandParser-Bs9fimmd.js","names":[],"sources":["../src/app/commands/MessageCommandParser.ts"],"sourcesContent":["import { Channel } from 'diagnostics_channel';\nimport {\n  Message,\n  ApplicationCommandOptionType,\n  GuildMember,\n  Attachment,\n  User,\n  Role,\n  CommandInteractionOption,\n} from 'discord.js';\nimport {\n  CommandKitErrorCodes,\n  createCommandKitError,\n} from '../../utils/error-codes';\n\n/**\n * Represents a parsed message command with its components.\n */\nexport interface ParsedMessageCommand {\n  command: string;\n  options: { name: string; value: unknown }[];\n  subcommand?: string;\n  subcommandGroup?: string;\n}\n\n/**\n * Schema defining the types of options for a message command.\n */\nexport type MessageCommandOptionsSchema = Record<\n  string,\n  ApplicationCommandOptionType\n>;\n\n/**\n * Parses message content into structured command data with options and subcommands.\n */\nexport class MessageCommandParser {\n  /**\n   * @private\n   * @internal\n   */\n  #parsed: ParsedMessageCommand | null = null;\n\n  /**\n   * @private\n   * @internal\n   */\n  #options: MessageCommandOptions | null = null;\n\n  /**\n   * @private\n   * @internal\n   */\n  #args: string[] = [];\n\n  /**\n   * Creates a new message command parser.\n   * @param message - The Discord message to parse\n   * @param prefix - Array of valid command prefixes or a regular expression\n   * @param schema - Function that returns the options schema for a command\n   */\n  public constructor(\n    public message: Message,\n    private prefix: string[] | RegExp,\n    private schema: (command: string) => MessageCommandOptionsSchema,\n  ) {}\n\n  /**\n   * Gets the parsed command arguments.\n   * @returns Array of command arguments\n   */\n  public getArgs() {\n    void this.parse();\n    return this.#args;\n  }\n\n  /**\n   * Gets the message command options object for easy access to typed option values.\n   */\n  public get options() {\n    if (!this.#options) {\n      this.#options = new MessageCommandOptions(this);\n    }\n\n    return this.#options;\n  }\n\n  /**\n   * Gets a specific option value by name.\n   * @param name - The option name\n   * @returns The option value or undefined if not found\n   */\n  public getOption<T>(name: string): T | undefined {\n    return this.parse().options.find((o) => o.name === name)?.value as T;\n  }\n\n  /**\n   * Gets the main command name.\n   * @returns The command name\n   */\n  public getCommand(): string {\n    return this.parse().command;\n  }\n\n  /**\n   * Gets the subcommand name if present.\n   * @returns The subcommand name or undefined\n   */\n  public getSubcommand(): string | undefined {\n    return this.parse().subcommand;\n  }\n\n  /**\n   * Gets the subcommand group name if present.\n   * @returns The subcommand group name or undefined\n   */\n  public getSubcommandGroup(): string | undefined {\n    return this.parse().subcommandGroup;\n  }\n\n  /**\n   * Gets the prefix used in the message.\n   * @returns The matched prefix or undefined\n   */\n  public getPrefix() {\n    if (this.prefix instanceof RegExp) {\n      const match = this.message.content.match(this.prefix);\n      return match?.[0];\n    }\n\n    for (const p of this.prefix) {\n      if (this.message.content.startsWith(p)) {\n        return p;\n      }\n    }\n  }\n\n  /**\n   * Gets the full command including subcommand group and subcommand.\n   * @returns The complete command string\n   */\n  public getFullCommand() {\n    return [this.getCommand(), this.getSubcommandGroup(), this.getSubcommand()]\n      .filter((v) => v)\n      .join(' ');\n  }\n\n  /**\n   * Parses the message content into structured command data.\n   * @returns The parsed command data\n   */\n  public parse(): ParsedMessageCommand {\n    if (this.#parsed) {\n      return this.#parsed;\n    }\n\n    const content = this.message.content;\n\n    const prefix = this.getPrefix();\n\n    if (!prefix) {\n      throw createCommandKitError(CommandKitErrorCodes.InvalidCommandPrefix);\n    }\n\n    const parts = content.slice(prefix.length).trim().split(' ');\n    const command = parts.shift();\n\n    this.#args = parts;\n\n    let subcommandGroup: string | undefined;\n    let subcommand: string | undefined;\n\n    if (command?.includes(':')) {\n      const [, group, cmd] = command.split(':');\n\n      if (!cmd && group) {\n        subcommand = group;\n      } else if (cmd && group) {\n        subcommandGroup = group;\n        subcommand = cmd;\n      }\n    }\n\n    const schema = this.schema(\n      [command, subcommandGroup, subcommand].filter(Boolean).join(' ').trim(),\n    );\n\n    const options = parts\n      .map((part) => {\n        try {\n          const [name, value] = part.split(':');\n\n          if (!(name in schema)) return null;\n\n          switch (schema[name]) {\n            case ApplicationCommandOptionType.Boolean:\n              return { name, value: value === 'true' };\n            case ApplicationCommandOptionType.Integer:\n              return { name, value: parseInt(value, 10) };\n            case ApplicationCommandOptionType.Number:\n              return { name, value: parseFloat(value) };\n            case ApplicationCommandOptionType.String:\n              return { name, value };\n            case ApplicationCommandOptionType.User:\n              return {\n                name,\n                value: this.message.mentions.users.find((u) => {\n                  return u.id === value.replace(/[<@!>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Channel:\n              return {\n                name,\n                value: this.message.mentions.channels.find((c) => {\n                  return c.id === value.replace(/[<#>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Role:\n              return {\n                name,\n                value: this.message.mentions.roles.find((r) => {\n                  return r.id === value.replace(/[<@&>]/g, '');\n                }),\n              };\n            case ApplicationCommandOptionType.Attachment:\n              return {\n                name,\n                value: this.message.attachments.find((a) => {\n                  return a.name === value;\n                }),\n              };\n            default:\n              return null;\n          }\n        } catch {\n          // Invalid option\n          return null;\n        }\n      })\n      .filter((v) => v !== null);\n\n    this.#parsed = {\n      command: command!,\n      options,\n      subcommand,\n      subcommandGroup,\n    };\n\n    return this.#parsed;\n  }\n}\n\n/**\n * Provides typed access to message command options with methods similar to Discord.js interaction options.\n */\nexport class MessageCommandOptions {\n  /**\n   * Creates a new message command options instance.\n   * @param parser - The message command parser instance\n   */\n  public constructor(private parser: MessageCommandParser) {}\n\n  /**\n   * @private\n   * @internal\n   */\n  private assertOption<T>(name: string, required = false) {\n    const option = this.parser.getOption<T>(name);\n\n    if (required && option === undefined) {\n      throw new Error(`Option \"${name}\" is required.`);\n    }\n\n    return option ?? null;\n  }\n\n  /**\n   * Gets a guild member from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The guild member or null if not found\n   */\n  getMember(name: string): GuildMember | null;\n  getMember(name: string, required: true): GuildMember;\n  getMember(name: string, required = false) {\n    const user = this.assertOption<User>(name, required);\n    const member = this.parser.message.guild?.members.cache.get(user?.id!);\n\n    if (required && !member) {\n      throw new Error(`Member \"${name}\" is required.`);\n    }\n\n    return member ?? null;\n  }\n\n  /**\n   * Gets an attachment from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The attachment or null if not found\n   */\n  getAttachment(name: string): Attachment | null;\n  getAttachment(name: string, required: true): Attachment;\n  getAttachment(name: string, required = false) {\n    return this.assertOption<Attachment>(name, required);\n  }\n\n  /**\n   * Gets a boolean value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The boolean value or null if not found\n   */\n  getBoolean(name: string): boolean | null;\n  getBoolean(name: string, required: true): boolean;\n  getBoolean(name: string, required = false) {\n    return this.assertOption<boolean>(name, required);\n  }\n\n  /**\n   * Gets a number value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The number value or null if not found\n   */\n  getNumber(name: string): number | null;\n  getNumber(name: string, required: true): number;\n  getNumber(name: string, required = false) {\n    return this.assertOption<number>(name, required);\n  }\n\n  /**\n   * Gets a string value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The string value or null if not found\n   */\n  getString(name: string): string | null;\n  getString(name: string, required: true): string;\n  getString(name: string, required = false) {\n    return this.assertOption<string>(name, required);\n  }\n\n  /**\n   * Gets an integer value from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The integer value or null if not found\n   */\n  getInteger(name: string): number | null;\n  getInteger(name: string, required: true): number;\n  getInteger(name: string, required = false) {\n    return this.assertOption<number>(name, required);\n  }\n\n  /**\n   * Gets a user from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The user or null if not found\n   */\n  getUser(name: string): User | null;\n  getUser(name: string, required: true): User;\n  getUser(name: string, required = false) {\n    return this.assertOption<User>(name, required);\n  }\n\n  /**\n   * Gets a channel from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The channel or null if not found\n   */\n  getChannel(name: string): Channel | null;\n  getChannel(name: string, required: true): Channel;\n  getChannel(name: string, required = false) {\n    return this.assertOption<Channel>(name, required);\n  }\n\n  /**\n   * Gets a role from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The role or null if not found\n   */\n  getRole(name: string): Role | null;\n  getRole(name: string, required: true): Role;\n  getRole(name: string, required = false) {\n    return this.assertOption<Role>(name, required);\n  }\n\n  /**\n   * Gets a mentionable (user, member, or role) from the command options.\n   * @param name - The option name\n   * @param required - Whether the option is required\n   * @returns The mentionable or null if not found\n   */\n  getMentionable(\n    name: string,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null;\n  getMentionable(\n    name: string,\n    required: true,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']>;\n  getMentionable(\n    name: string,\n    required = false,\n  ): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null {\n    const target = this.assertOption(name, required);\n\n    if (\n      target instanceof GuildMember ||\n      target instanceof User ||\n      target instanceof Role\n    ) {\n      return target;\n    }\n\n    if (required) {\n      throw new Error(`Mentionable \"${name}\" is required.`);\n    }\n\n    return null;\n  }\n\n  /**\n   * Gets the subcommand name from the command.\n   * @param required - Whether the subcommand is required\n   * @returns The subcommand name or null if not found\n   */\n  getSubcommand(): string | null;\n  getSubcommand(required: true): string;\n  getSubcommand(required = false) {\n    const sub = this.parser.getSubcommand();\n\n    if (required && sub === undefined) {\n      throw new Error('Subcommand is required.');\n    }\n\n    return sub ?? null;\n  }\n\n  /**\n   * Gets the subcommand group name from the command.\n   * @param required - Whether the subcommand group is required\n   * @returns The subcommand group name or null if not found\n   */\n  getSubcommandGroup(): string | null;\n  getSubcommandGroup(required: true): string;\n  getSubcommandGroup(required = false) {\n    const sub = this.parser.getSubcommandGroup();\n\n    if (required && sub === undefined) {\n      throw new Error('Subcommand group is required.');\n    }\n\n    return sub ?? null;\n  }\n}\n"],"mappings":"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"}

package/dist/MessageCommandParser-q3dQcE5N.d.ts

@@ -1,194 +0,0 @@
-import { ApplicationCommandOptionType, Attachment, CommandInteractionOption, GuildMember, Message, Role, User } from "discord.js";
-import { Channel } from "diagnostics_channel";
-
-//#region src/app/commands/MessageCommandParser.d.ts
-/**
- * Represents a parsed message command with its components.
- */
-interface ParsedMessageCommand {
-  command: string;
-  options: {
-    name: string;
-    value: unknown;
-  }[];
-  subcommand?: string;
-  subcommandGroup?: string;
-}
-/**
- * Schema defining the types of options for a message command.
- */
-type MessageCommandOptionsSchema = Record<string, ApplicationCommandOptionType>;
-/**
- * Parses message content into structured command data with options and subcommands.
- */
-declare class MessageCommandParser {
-  #private;
-  message: Message;
-  private prefix;
-  private schema;
-  /**
-       * Creates a new message command parser.
-       * @param message - The Discord message to parse
-       * @param prefix - Array of valid command prefixes or a regular expression
-       * @param schema - Function that returns the options schema for a command
-       */
-  constructor(message: Message, prefix: string[] | RegExp, schema: (command: string) => MessageCommandOptionsSchema);
-  /**
-       * Gets the parsed command arguments.
-       * @returns Array of command arguments
-       */
-  getArgs(): string[];
-  /**
-       * Gets the message command options object for easy access to typed option values.
-       */
-  get options(): MessageCommandOptions;
-  /**
-       * Gets a specific option value by name.
-       * @param name - The option name
-       * @returns The option value or undefined if not found
-       */
-  getOption<T>(name: string): T | undefined;
-  /**
-       * Gets the main command name.
-       * @returns The command name
-       */
-  getCommand(): string;
-  /**
-       * Gets the subcommand name if present.
-       * @returns The subcommand name or undefined
-       */
-  getSubcommand(): string | undefined;
-  /**
-       * Gets the subcommand group name if present.
-       * @returns The subcommand group name or undefined
-       */
-  getSubcommandGroup(): string | undefined;
-  /**
-       * Gets the prefix used in the message.
-       * @returns The matched prefix or undefined
-       */
-  getPrefix(): string | undefined;
-  /**
-       * Gets the full command including subcommand group and subcommand.
-       * @returns The complete command string
-       */
-  getFullCommand(): string;
-  /**
-       * Parses the message content into structured command data.
-       * @returns The parsed command data
-       */
-  parse(): ParsedMessageCommand;
-}
-/**
- * Provides typed access to message command options with methods similar to Discord.js interaction options.
- */
-declare class MessageCommandOptions {
-  private parser;
-  /**
-       * Creates a new message command options instance.
-       * @param parser - The message command parser instance
-       */
-  constructor(parser: MessageCommandParser);
-  /**
-       * @private
-       * @internal
-       */
-  private assertOption;
-  /**
-       * Gets a guild member from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The guild member or null if not found
-       */
-  getMember(name: string): GuildMember | null;
-  getMember(name: string, required: true): GuildMember;
-  /**
-       * Gets an attachment from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The attachment or null if not found
-       */
-  getAttachment(name: string): Attachment | null;
-  getAttachment(name: string, required: true): Attachment;
-  /**
-       * Gets a boolean value from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The boolean value or null if not found
-       */
-  getBoolean(name: string): boolean | null;
-  getBoolean(name: string, required: true): boolean;
-  /**
-       * Gets a number value from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The number value or null if not found
-       */
-  getNumber(name: string): number | null;
-  getNumber(name: string, required: true): number;
-  /**
-       * Gets a string value from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The string value or null if not found
-       */
-  getString(name: string): string | null;
-  getString(name: string, required: true): string;
-  /**
-       * Gets an integer value from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The integer value or null if not found
-       */
-  getInteger(name: string): number | null;
-  getInteger(name: string, required: true): number;
-  /**
-       * Gets a user from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The user or null if not found
-       */
-  getUser(name: string): User | null;
-  getUser(name: string, required: true): User;
-  /**
-       * Gets a channel from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The channel or null if not found
-       */
-  getChannel(name: string): Channel | null;
-  getChannel(name: string, required: true): Channel;
-  /**
-       * Gets a role from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The role or null if not found
-       */
-  getRole(name: string): Role | null;
-  getRole(name: string, required: true): Role;
-  /**
-       * Gets a mentionable (user, member, or role) from the command options.
-       * @param name - The option name
-       * @param required - Whether the option is required
-       * @returns The mentionable or null if not found
-       */
-  getMentionable(name: string): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null;
-  getMentionable(name: string, required: true): NonNullable<CommandInteractionOption['member' | 'role' | 'user']>;
-  /**
-       * Gets the subcommand name from the command.
-       * @param required - Whether the subcommand is required
-       * @returns The subcommand name or null if not found
-       */
-  getSubcommand(): string | null;
-  getSubcommand(required: true): string;
-  /**
-       * Gets the subcommand group name from the command.
-       * @param required - Whether the subcommand group is required
-       * @returns The subcommand group name or null if not found
-       */
-  getSubcommandGroup(): string | null;
-  getSubcommandGroup(required: true): string;
-}
-//#endregion
-export { ParsedMessageCommand as i, MessageCommandOptionsSchema as n, MessageCommandParser as r, MessageCommandOptions as t };
-//# sourceMappingURL=MessageCommandParser-q3dQcE5N.d.ts.map

package/dist/PluginCommon-BLxWww5u.js

@@ -1,70 +0,0 @@
-const require_chunk = require('./chunk-kSYXY2_d.js');
-let node_crypto = require("node:crypto");
-
-//#region src/plugins/PluginCommon.ts
-/**
-* Enum representing the type of plugin.
-* - Compiler: A plugin that runs at compile time.
-* - Runtime: A plugin that runs at runtime.
-*/
-let PluginType = /* @__PURE__ */ function(PluginType) {
-	PluginType["Compiler"] = "compiler";
-	PluginType["Runtime"] = "runtime";
-	return PluginType;
-}({});
-/**
-* Base class for CommandKit plugins.
-*/
-var PluginCommon = class {
-	/**
-	* Unique identifier for the plugin instance.
-	*/
-	id = (0, node_crypto.randomUUID)();
-	/**
-	* The time when the plugin was loaded, in milliseconds since the Unix epoch.
-	*/
-	loadedAt = Date.now();
-	/**
-	* Creates a new instance of the plugin.
-	*/
-	constructor(options) {
-		this.options = options;
-	}
-	/**
-	* Called when this plugin is activated
-	*/
-	async activate(ctx) {}
-	/**
-	* Called when this plugin is deactivated
-	*/
-	async deactivate(ctx) {}
-};
-/**
-* Whether the given object is a CommandKit plugin.
-* @param plugin The object to check.
-* @returns Boolean indicating whether the object is a plugin.
-*/
-function isPlugin(plugin) {
-	return plugin instanceof PluginCommon;
-}
-
-//#endregion
-Object.defineProperty(exports, 'PluginCommon', {
-  enumerable: true,
-  get: function () {
-    return PluginCommon;
-  }
-});
-Object.defineProperty(exports, 'PluginType', {
-  enumerable: true,
-  get: function () {
-    return PluginType;
-  }
-});
-Object.defineProperty(exports, 'isPlugin', {
-  enumerable: true,
-  get: function () {
-    return isPlugin;
-  }
-});
-//# sourceMappingURL=PluginCommon-BLxWww5u.js.map

package/dist/PluginCommon-BLxWww5u.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginCommon-BLxWww5u.js","names":[],"sources":["../src/plugins/PluginCommon.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { CommonPluginRuntime } from './plugin-runtime/runtime';\n\n/**\n * The options for a CommandKit plugin.\n */\nexport type PluginOptions = Record<string, any>;\n\n/**\n * Enum representing the type of plugin.\n * - Compiler: A plugin that runs at compile time.\n * - Runtime: A plugin that runs at runtime.\n */\nexport enum PluginType {\n  Compiler = 'compiler',\n  Runtime = 'runtime',\n}\n\n/**\n * Base class for CommandKit plugins.\n */\nexport abstract class PluginCommon<\n  T extends PluginOptions = PluginOptions,\n  C extends CommonPluginRuntime = CommonPluginRuntime,\n> {\n  /**\n   * The type of the plugin, either Compiler or Runtime.\n   */\n  public abstract readonly type: PluginType;\n  /**\n   * Unique identifier for the plugin instance.\n   */\n  public readonly id = randomUUID();\n  /**\n   * The time when the plugin was loaded, in milliseconds since the Unix epoch.\n   */\n  public readonly loadedAt = Date.now();\n  /**\n   * The name of the plugin.\n   */\n  public abstract readonly name: string;\n\n  /**\n   * Creates a new instance of the plugin.\n   */\n  public constructor(protected readonly options: T) {}\n\n  /**\n   * Called when this plugin is activated\n   */\n  public async activate(ctx: C): Promise<void> {}\n\n  /**\n   * Called when this plugin is deactivated\n   */\n  public async deactivate(ctx: C): Promise<void> {}\n}\n\n/**\n * Whether the given object is a CommandKit plugin.\n * @param plugin The object to check.\n * @returns Boolean indicating whether the object is a plugin.\n */\nexport function isPlugin(\n  plugin: unknown,\n): plugin is PluginCommon<PluginOptions> {\n  return plugin instanceof PluginCommon;\n}\n"],"mappings":";;;;;;;;;AAaA,IAAY,kDAAL;AACL;AACA;;;;;;AAMF,IAAsB,eAAtB,MAGA;;;;CAQE,AAAgB,kCAAiB;;;;CAIjC,AAAgB,WAAW,KAAK,KAAK;;;;CASrC,AAAO,YAAY,AAAmB,SAAY;EAAZ;;;;;CAKtC,MAAa,SAAS,KAAuB;;;;CAK7C,MAAa,WAAW,KAAuB;;;;;;;AAQjD,SAAgB,SAChB,QACwC;AACtC,QAAO,kBAAkB"}