vimcord 1.0.37 → 1.0.39

package/dist/index.cjs

@@ -69,6 +69,7 @@ __export(index_exports, {
   StatusType: () => StatusType,
   Vimcord: () => Vimcord,
   VimcordCLI: () => VimcordCLI,
+  VimcordErrorHandler: () => VimcordErrorHandler,
   __zero: () => __zero,
   cleanMention: () => cleanMention,
   clientLoggerFactory: () => clientLoggerFactory,
@@ -85,6 +86,7 @@ __export(index_exports, {
   createStaffConfig: () => createStaffConfig,
   createToolsConfig: () => createToolsConfig,
   createVimcordStatusConfig: () => createVimcordStatusConfig,
+  deepMerge: () => deepMerge,
   defineClientOptions: () => defineClientOptions,
   defineGlobalToolsConfig: () => defineGlobalToolsConfig,
   defineVimcordConfig: () => defineVimcordConfig,
@@ -100,7 +102,6 @@ __export(index_exports, {
   getFirstMentionId: () => getFirstMentionId,
   getMessageMention: () => getMessageMention,
   getPackageJson: () => getPackageJson,
-  getProcessDir: () => getProcessDir,
   globalToolsConfig: () => globalToolsConfig,
   importModulesFromDir: () => importModulesFromDir,
   isMentionOrSnowflake: () => isMentionOrSnowflake,
@@ -244,8 +245,30 @@ function validateCommandPermissions(permissions, client, user, command) {
   return { validated: true };
 }
 
+// src/utils/mergeUtils.ts
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) return false;
+  if (Array.isArray(value)) return false;
+  return Object.prototype.toString.call(value) === "[object Object]";
+}
+function deepMerge(target, ...sources) {
+  for (const source of sources) {
+    if (!source) continue;
+    for (const key in source) {
+      if (!Object.prototype.hasOwnProperty.call(source, key)) continue;
+      const sourceValue = source[key];
+      const targetValue = target[key];
+      if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+        deepMerge(targetValue, sourceValue);
+      } else if (sourceValue !== void 0) {
+        target[key] = sourceValue;
+      }
+    }
+  }
+  return target;
+}
+
 // src/builders/baseCommand.builder.ts
-var import_lodash = __toESM(require("lodash"));
 var import_node_crypto = require("crypto");
 var BaseCommandBuilder = class {
   uuid = (0, import_node_crypto.randomUUID)();
@@ -259,8 +282,7 @@ var BaseCommandBuilder = class {
     [1 /* Guild */]: /* @__PURE__ */ new Map(),
     [2 /* Channel */]: /* @__PURE__ */ new Map()
   };
-  /** * Mapping of CommandTypes to their respective config keys in the Vimcord client
-   */
+  /** Mapping of CommandTypes to their respective config keys in the Vimcord client */
   typeConfigMapping = {
     [0 /* Slash */]: "slashCommands",
     [1 /* Prefix */]: "prefixCommands",
@@ -285,7 +307,7 @@ var BaseCommandBuilder = class {
   resolveConfig(client) {
     const typeKey = this.typeConfigMapping[this.commandType];
     const typeSpecificGlobals = client.config?.[typeKey] || {};
-    return import_lodash.default.merge({}, typeSpecificGlobals, this.options);
+    return deepMerge({}, typeSpecificGlobals, this.options);
   }
   /**
    * Executes the command lifecycle.
@@ -403,12 +425,12 @@ var BaseCommandBuilder = class {
   }
   /** Merge new permission requirements into the existing ones */
   setPermissions(perms) {
-    this.options.permissions = import_lodash.default.merge(this.options.permissions || {}, perms);
+    this.options.permissions = deepMerge(this.options.permissions || {}, perms);
     return this;
   }
-  /** Add custom logic checks that run before execution */
-  addConditions(...conditions) {
-    this.options.conditions = [...this.options.conditions || [], ...conditions];
+  /** Set the custom conditions that must be met for this command to execute */
+  setConditions(conditions) {
+    this.options.conditions = conditions;
     return this;
   }
   /** Set the primary command execution logic */
@@ -416,79 +438,21 @@ var BaseCommandBuilder = class {
     this.options.execute = fn;
     return this;
   }
-  /** * Set the custom conditions that must be met for this command to execute
-   */
-  setConditions(conditions) {
-    this.options.conditions = conditions;
-    return this;
-  }
-  /** * Set the command metadata configuration
-   */
+  /** Set the command metadata configuration */
   setMetadata(metadata) {
-    this.options.metadata = import_lodash.default.merge(this.options.metadata || {}, metadata);
+    this.options.metadata = deepMerge(this.options.metadata || {}, metadata);
     return this;
   }
-  /** * Set the rate limiting options for this command
-   */
+  /** Set the rate limiting options for this command */
   setRateLimit(options) {
     this.options.rateLimit = options;
     this.validateBaseConfig();
     return this;
   }
-  /** * Set whether to log whenever this command is executed
-   * @defaultValue true
-   */
-  setLogExecution(log) {
-    this.options.logExecution = log;
-    return this;
-  }
-  /** * Set the function to execute before the main command logic
-   */
-  setBeforeExecute(callback) {
-    this.options.beforeExecute = callback;
-    return this;
-  }
-  /** * Set the function to execute after successful command execution
-   */
-  setAfterExecute(callback) {
-    this.options.afterExecute = callback;
-    return this;
-  }
-  /** * Set the function to execute when the required permissions are not met
-   */
-  setOnMissingPermissions(callback) {
-    this.options.onMissingPermissions = callback;
-    return this;
-  }
-  /** * Set the function to execute when the required conditions are not met
-   */
-  setOnConditionsNotMet(callback) {
-    this.options.onConditionsNotMet = callback;
-    return this;
-  }
-  /** * Set the function to execute when this command is used when its disabled
-   */
-  setOnUsedWhenDisabled(callback) {
-    this.options.onUsedWhenDisabled = callback;
-    return this;
-  }
-  /** * Set the function to execute when the rate limit is hit
-   */
-  setOnRateLimit(callback) {
-    this.options.onRateLimit = callback;
-    return this;
-  }
-  /** * Set a custom error handler for this command
-   */
-  setOnError(callback) {
-    this.options.onError = callback;
-    return this;
-  }
 };
 
 // src/builders/contextCommand.builder.ts
 var import_discord2 = require("discord.js");
-var import_lodash2 = __toESM(require("lodash"));
 var ContextCommandBuilder = class extends BaseCommandBuilder {
   builder;
   constructor(config) {
@@ -516,14 +480,6 @@ var ContextCommandBuilder = class extends BaseCommandBuilder {
     this.validateBuilder();
     return this;
   }
-  setDeferReply(defer) {
-    this.options.deferReply = defer;
-    return this;
-  }
-  setDeployment(deployment) {
-    this.options.deployment = import_lodash2.default.merge(this.options.deployment || {}, deployment);
-    return this;
-  }
   setExecute(fn) {
     const originalExecute = fn;
     this.options.execute = async (client, interaction) => {
@@ -538,7 +494,6 @@ var ContextCommandBuilder = class extends BaseCommandBuilder {
 
 // src/builders/event.builder.ts
 var import_node_crypto2 = require("crypto");
-var import_lodash3 = __toESM(require("lodash"));
 
 // src/tools/Logger.ts
 var import_chalk = __toESM(require("chalk"));
@@ -799,77 +754,14 @@ var EventBuilder = class _EventBuilder {
       onError: this.onError
     };
   }
-  setEvent(event) {
-    this.event = event;
-    return this;
-  }
-  setName(name) {
-    this.name = name;
-    return this;
-  }
   setEnabled(enabled) {
     this.enabled = enabled;
     return this;
   }
-  enable() {
-    return this.setEnabled(true);
-  }
-  disable() {
-    return this.setEnabled(false);
-  }
-  setOnce(once = true) {
-    this.once = once;
-    return this;
-  }
-  setPriority(priority) {
-    this.priority = priority;
-    return this;
-  }
-  addCondition(condition) {
-    if (!this.conditions) this.conditions = [];
-    this.conditions.push(condition);
-    return this;
-  }
-  setConditions(conditions) {
-    this.conditions = conditions;
-    return this;
-  }
-  setMetadata(metadata) {
-    this.metadata = import_lodash3.default.merge(this.metadata, metadata);
-    return this;
-  }
-  setDeployment(deployment) {
-    this.deployment = import_lodash3.default.merge(this.deployment, deployment);
-    return this;
-  }
-  setRateLimit(options) {
-    this.rateLimit = options;
-    return this;
-  }
-  setBeforeExecute(beforeExecute) {
-    this.beforeExecute = beforeExecute;
-    return this;
-  }
   setExecute(execute) {
     this.execute = execute;
     return this;
   }
-  setAfterExecute(afterExecute) {
-    this.afterExecute = afterExecute;
-    return this;
-  }
-  setOnError(onError) {
-    this.onError = onError;
-    return this;
-  }
-  getRateLimitInfo() {
-    if (!this.rateLimit) return null;
-    return { ...this.rateLimitData, isLimited: this.isRateLimited(false) };
-  }
-  resetRateLimit() {
-    this.rateLimitData = { executions: 0, timestamp: 0 };
-    return this;
-  }
   isRateLimited(updateExecutions = true) {
     if (!this.rateLimit) return false;
     const now = Date.now();
@@ -942,39 +834,9 @@ var PrefixCommandBuilder = class extends BaseCommandBuilder {
       throw new Error(`[Vimcord] PrefixCommandBuilder: Command name is required.`);
     }
   }
-  // --- Fluent API (Prefix Specific Only) ---
-  /**
-   * Set the primary name of the command.
-   */
-  setName(name) {
-    this.options.name = name;
-    return this;
-  }
-  /**
-   * Set or replace the command aliases.
-   */
-  setAliases(aliases) {
-    this.options.aliases = aliases;
-    return this;
-  }
-  /**
-   * Add additional aliases without clearing existing ones.
-   */
-  addAliases(...aliases) {
-    this.options.aliases = [...this.options.aliases || [], ...aliases];
-    return this;
-  }
-  /**
-   * Set the command description.
-   */
-  setDescription(description) {
-    this.options.description = description;
-    return this;
-  }
   // --- Overrides ---
   /**
    * Override setExecute to ensure handleExecution remains the entry point.
-   * This is the only base method we need to redefine.
    */
   setExecute(fn) {
     const originalExecute = fn;
@@ -995,7 +857,6 @@ var PrefixCommandBuilder = class extends BaseCommandBuilder {
 
 // src/builders/slashCommand.builder.ts
 var import_discord3 = require("discord.js");
-var import_lodash4 = __toESM(require("lodash"));
 var SlashCommandBuilder = class extends BaseCommandBuilder {
   builder;
   routes = /* @__PURE__ */ new Map();
@@ -1036,19 +897,6 @@ var SlashCommandBuilder = class extends BaseCommandBuilder {
     this.validateBuilder();
     return this;
   }
-  setDeferReply(defer) {
-    this.options.deferReply = defer;
-    return this;
-  }
-  setDeployment(deployment) {
-    this.options.deployment = import_lodash4.default.merge(this.options.deployment || {}, deployment);
-    return this;
-  }
-  setRoutes(...routes) {
-    this.routes.clear();
-    this.addRoutes(...routes);
-    return this;
-  }
   addRoutes(...routes) {
     if (!this.options.routes) this.options.routes = [];
     for (const route of routes) {
@@ -1060,10 +908,6 @@ var SlashCommandBuilder = class extends BaseCommandBuilder {
     }
     return this;
   }
-  setUnknownRouteHandler(handler) {
-    this.options.onUnknownRouteHandler = handler;
-    return this;
-  }
   setExecute(fn) {
     const originalExecute = fn;
     this.options.execute = async (client, interaction) => {
@@ -1080,7 +924,7 @@ var SlashCommandBuilder = class extends BaseCommandBuilder {
   }
 };
 
-// src/modules/builtins/context-command.builtins.ts
+// src/modules/builtins/contextCommand.builtin.ts
 var contextCommandHandler = new EventBuilder({
   event: "interactionCreate",
   name: "ContextCommandHandler",
@@ -1102,7 +946,7 @@ var contextCommandHandler = new EventBuilder({
   }
 });
 
-// src/modules/builtins/prefix-command.builtins.ts
+// src/modules/builtins/prefixCommand.builtin.ts
 var import_discord4 = require("discord.js");
 var prefixCommandHandler = new EventBuilder({
   event: "messageCreate",
@@ -1144,7 +988,7 @@ var prefixCommandHandler = new EventBuilder({
   }
 });
 
-// src/modules/builtins/slash-command.builtins.ts
+// src/modules/builtins/slashCommand.builtin.ts
 var slashCommandHandler = new EventBuilder({
   event: "interactionCreate",
   name: "SlashCommandHandler",
@@ -1166,14 +1010,204 @@ var slashCommandHandler = new EventBuilder({
   }
 });
 
+// src/client/vimcord.cli.ts
+var import_node_readline = require("readline");
+var import_qznt = require("qznt");
+var VimcordCLI = class _VimcordCLI {
+  static mode = "off";
+  static setMode(mode) {
+    if (_VimcordCLI.mode === mode) return;
+    _VimcordCLI.mode = mode;
+    if (mode === "on") {
+      CLI.logger.log(`~ Type ${CLI.options.prefix}help to view available commands`);
+    } else {
+      CLI.logger.log(`~ [MODE] Now set to "${mode}"`);
+    }
+  }
+  rl;
+  options;
+  commands = /* @__PURE__ */ new Map();
+  logger = new Logger({ prefixEmoji: "\u{1F680}", prefix: "CLI", showTimestamp: false });
+  constructor(options) {
+    this.options = options;
+    this.rl = (0, import_node_readline.createInterface)({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false
+    });
+    this.rl.on("line", (line) => {
+      if (_VimcordCLI.mode !== "on") return;
+      const { isCommand, commandName, content, args } = this.parseLine(line);
+      if (!isCommand) return;
+      const command = this.commands.get(commandName);
+      if (!command) {
+        const nearestMatches = Array.from(this.commands.keys()).filter(
+          (cmd) => cmd.toLowerCase().includes(commandName.toLowerCase())
+        );
+        return this.logger.error(
+          `Unknown command '${commandName}'${nearestMatches.length ? `. Did you mean ${nearestMatches.length > 1 ? `[${nearestMatches.map((m) => `'${this.options.prefix}${m}'`).join(", ")}]` : `'${this.options.prefix}${nearestMatches[0]}'`}?` : ""}`
+        );
+      }
+      command.fn(args, content);
+    });
+  }
+  parseLine(line) {
+    if (line.startsWith(this.options.prefix)) {
+      line = line.slice(this.options.prefix.length);
+    } else {
+      return { isCommand: false };
+    }
+    const args = line.split(" ").map((s) => s.trim());
+    const commandName = args.shift();
+    return { isCommand: true, commandName, content: args.join(" "), args };
+  }
+  getClientInstance(line) {
+    const clientIndex = import_qznt.$.str.getFlag(line, "--client", 1) || import_qznt.$.str.getFlag(line, "-c", 1);
+    if (clientIndex) {
+      const idx = Number(clientIndex);
+      if (isNaN(idx)) {
+        CLI.logger.error(`'${clientIndex}' is not a valid number`);
+        return void 0;
+      }
+      const client = useClient(idx);
+      if (!client) {
+        CLI.logger.error("Client instance not found");
+        return void 0;
+      }
+      return client;
+    } else {
+      const client = useClient(0);
+      if (!client) {
+        CLI.logger.error("Client instance not found");
+        return void 0;
+      }
+      return client;
+    }
+  }
+  addCommand(commandName, description, fn) {
+    this.commands.set(commandName, { description, fn });
+  }
+  removeCommand(commandName) {
+    if (!this.commands.has(commandName)) return false;
+    this.commands.delete(commandName);
+    return true;
+  }
+};
+var CLI = new VimcordCLI({ prefix: "/" });
+CLI.addCommand("help", "View information about a command, or the available CLI options", (args) => {
+  const prefix = CLI.options.prefix;
+  const helpList = {};
+  for (const cmd of CLI.commands.entries()) {
+    const commandName = cmd[0];
+    const commandDescription = cmd[1].description;
+    helpList[`${prefix}${commandName}`] = `~ ${commandDescription}`;
+  }
+  CLI.logger.table("(help)", helpList);
+});
+CLI.addCommand("register", "Register app commands (slash & context) globally, or per guild", async (args, content) => {
+  const client = CLI.getClientInstance(content);
+  if (!client) return;
+  const mode = args[0]?.toLowerCase() || "";
+  if (!["guild", "global"].includes(mode)) {
+    return CLI.logger.error(`'${mode}' is not a valid option. Your options are [guild|global]`);
+  }
+  let guildIds = (import_qznt.$.str.getFlag(content, "--guilds", 1) || import_qznt.$.str.getFlag(content, "-g", 1) || "").replaceAll(/["']/g, "").split(" ").filter(Boolean).map((s) => s.replaceAll(",", "").trim());
+  if (!guildIds.length) guildIds = client.guilds.cache.map((g) => g.id);
+  switch (mode) {
+    case "guild":
+      CLI.logger.info("Registering guild commands...");
+      await client.commands.registerGuild({ guilds: guildIds });
+      break;
+    case "global":
+      CLI.logger.info("Registering global commands...");
+      await client.commands.registerGlobal();
+      break;
+  }
+});
+CLI.addCommand("unregister", "Unregister app commands globally, or per guild", async (args, content) => {
+  const client = CLI.getClientInstance(content);
+  if (!client) return;
+  const mode = args[0]?.toLowerCase() || "";
+  if (!["guild", "global"].includes(mode)) {
+    return CLI.logger.error(`'${mode}' is not a valid option. Your options are [guild|global]`);
+  }
+  let guildIds = (import_qznt.$.str.getFlag(content, "--guilds", 1) || import_qznt.$.str.getFlag(content, "-g", 1) || "").replaceAll(/["']/g, "").split(" ").filter(Boolean).map((s) => s.replaceAll(",", "").trim());
+  if (!guildIds.length) guildIds = client.guilds.cache.map((g) => g.id);
+  switch (mode) {
+    case "guild":
+      CLI.logger.info("Unregistering guild commands...");
+      await client.commands.unregisterGuild({ guilds: guildIds });
+      break;
+    case "global":
+      CLI.logger.info("Unregistering global commands...");
+      await client.commands.unregisterGlobal();
+      break;
+  }
+});
+CLI.addCommand("stats", "View statistics about a client instance", (args, content) => {
+  const client = CLI.getClientInstance(content);
+  if (!client) return;
+  CLI.logger.table(`(stats) ~ ${client.config.app.name}`, {
+    "Guilds:": import_qznt.$.format.number(client.guilds.cache.size),
+    "Ping:": `${client.ws.ping || 0}ms`,
+    "Uptime:": `${import_qznt.$.math.secs(client.uptime || 0)}s`,
+    "Process Uptime:": `${Math.floor(process.uptime())}s`,
+    "Memory Usage:": `${(process.memoryUsage().rss / 1024 / 1024).toFixed(2)} MB`
+  });
+});
+CLI.addCommand("cmds", "List the loaded commands", async (args, content) => {
+  const client = CLI.getClientInstance(content);
+  if (!client) return;
+  const mode = (args[0] || "slash").toLowerCase();
+  switch (mode) {
+    case "slash": {
+      const commands = Array.from(client.commands.slash.commands.values());
+      commands.sort((a, b) => a.builder.name.localeCompare(b.builder.name));
+      const tableData = {};
+      for (const cmd of commands) {
+        tableData[`/${cmd.builder.name}`] = `~ ${cmd.builder.description || "No description"}`;
+      }
+      return CLI.logger.table(`(cmds) ~ slash (${import_qznt.$.format.number(commands.length)})`, tableData);
+    }
+    case "prefix": {
+      const commands = Array.from(client.commands.prefix.commands.values());
+      commands.sort((a, b) => {
+        const nameA = a.toConfig().name;
+        const nameB = b.toConfig().name;
+        return nameA.localeCompare(nameB);
+      });
+      const tableData = {};
+      const defaultPrefix = client.config.prefixCommands.defaultPrefix;
+      for (const cmd of commands) {
+        const config = cmd.toConfig();
+        const aliasIndicator = config.aliases?.length ? ` [${config.aliases.join(", ")}]` : "";
+        tableData[`${defaultPrefix}${config.name}${aliasIndicator}`] = `~ ${config.description || "No description"}`;
+      }
+      return CLI.logger.table(`(cmds) ~ prefix (${import_qznt.$.format.number(commands.length)})`, tableData);
+    }
+    case "ctx": {
+      const commands = Array.from(client.commands.context.commands.values());
+      commands.sort((a, b) => a.builder.name.localeCompare(b.builder.name));
+      const tableData = {};
+      for (const cmd of commands) {
+        const type = cmd.builder.type === 2 ? "User" : "Msg";
+        tableData[`[${type}] ${cmd.builder.name}`] = "";
+      }
+      return CLI.logger.table(`(cmds) ~ ctx (${import_qznt.$.format.number(commands.length)})`, tableData);
+    }
+    default:
+      return CLI.logger.error(`'${mode}' is not a valid option. Valid options: [slash|prefix|ctx]`);
+  }
+});
+
 // src/tools/BetterEmbed.ts
 var import_discord6 = require("discord.js");
 
-// src/utils/config.factory.ts
-var import_lodash5 = __toESM(require("lodash"));
+// src/utils/configFactory.ts
 function createConfigFactory(defaultConfig6, validate) {
   return (options = {}, existing) => {
-    const result = import_lodash5.default.merge({}, defaultConfig6, existing, options);
+    const base = existing ? { ...existing } : { ...defaultConfig6 };
+    const result = deepMerge(base, options);
     validate?.(result);
     return result;
   };
@@ -1667,7 +1701,7 @@ var BetterEmbed = class _BetterEmbed {
   }
 };
 
-// src/utils/command-error.utils.ts
+// src/modules/builtins/commandError.builtin.ts
 var import_discord7 = require("discord.js");
 async function sendCommandErrorEmbed(client, error, guild, messageOrInteraction) {
   if (!client.features.enableCommandErrorMessage) return null;
@@ -1724,8 +1758,8 @@ ${error.stack}`), {
   return msg;
 }
 
-// src/client/error-handler.ts
-var ErrorHandler = class {
+// src/client/vimcord.errorHandler.ts
+var VimcordErrorHandler = class {
   client;
   constructor(client) {
     this.client = client;
@@ -1753,7 +1787,7 @@ var ErrorHandler = class {
 var import_chalk2 = __toESM(require("chalk"));
 
 // package.json
-var version = "1.0.37";
+var version = "1.0.38";
 
 // src/client/vimcord.logger.ts
 var clientLoggerFactory = (client) => new Logger({ prefixEmoji: "\u26A1", prefix: `vimcord (i${client.clientId})` }).extend({
@@ -1818,7 +1852,7 @@ var clientLoggerFactory = (client) => new Logger({ prefixEmoji: "\u26A1", prefix
   }
 });
 
-// src/utils/process.utils.ts
+// src/utils/processUtils.ts
 var import_node_fs = require("fs");
 var import_node_path = require("path");
 function getPackageJson() {
@@ -1861,6 +1895,7 @@ var createPrefixCommandConfig = createConfigFactory(defaultConfig3);
 
 // src/configs/slashCommand.config.ts
 var defaultConfig4 = {
+  enabled: true,
   logExecution: true
 };
 var createSlashCommandConfig = createConfigFactory(defaultConfig4);
@@ -1896,31 +1931,31 @@ var configSetters = {
   app: createAppConfig,
   staff: createStaffConfig,
   slashCommands: createSlashCommandConfig,
-  prefixCommands: createPrefixCommandConfig,
-  contextCommands: createContextCommandConfig
+  contextCommands: createContextCommandConfig,
+  prefixCommands: createPrefixCommandConfig
 };
 var moduleImporters = {
   slashCommands: (client, options, set) => {
     const opt = options;
-    const dir = Array.isArray(options) ? options : opt?.dir ?? [];
+    const dir = Array.isArray(options) ? options : typeof options === "string" ? options : options?.dir ?? [];
     const suffix = Array.isArray(options) ? DEFAULT_MODULE_SUFFIXES.slashCommands : opt?.suffix ?? DEFAULT_MODULE_SUFFIXES.slashCommands;
     return client.commands.slash.importFrom(dir, set, suffix);
   },
   contextCommands: (client, options, set) => {
     const opt = options;
-    const dir = Array.isArray(options) ? options : opt?.dir ?? [];
+    const dir = Array.isArray(options) ? options : typeof options === "string" ? options : options?.dir ?? [];
     const suffix = Array.isArray(options) ? DEFAULT_MODULE_SUFFIXES.contextCommands : opt?.suffix ?? DEFAULT_MODULE_SUFFIXES.contextCommands;
     return client.commands.context.importFrom(dir, set, suffix);
   },
   prefixCommands: (client, options, set) => {
     const opt = options;
-    const dir = Array.isArray(options) ? options : opt?.dir ?? [];
+    const dir = Array.isArray(options) ? options : typeof options === "string" ? options : options?.dir ?? [];
     const suffix = Array.isArray(options) ? DEFAULT_MODULE_SUFFIXES.prefixCommands : opt?.suffix ?? DEFAULT_MODULE_SUFFIXES.prefixCommands;
     return client.commands.prefix.importFrom(dir, set, suffix);
   },
   events: (client, options, set) => {
     const opt = options;
-    const dir = Array.isArray(options) ? options : opt?.dir ?? [];
+    const dir = Array.isArray(options) ? options : typeof options === "string" ? options : options?.dir ?? [];
     const suffix = Array.isArray(options) ? DEFAULT_MODULE_SUFFIXES.events : opt?.suffix ?? DEFAULT_MODULE_SUFFIXES.events;
     return client.events.importFrom(dir, set, suffix);
   }
@@ -1940,29 +1975,41 @@ function defineVimcordConfig(config) {
     contextCommands: createContextCommandConfig(config.contextCommands)
   };
 }
-var useClient = Vimcord.getInstance;
-var useReadyClient = Vimcord.getReadyInstance;
-var createClient = Vimcord.create;
+function useClient(clientId) {
+  return Vimcord.getInstance(clientId);
+}
+function useReadyClient(clientId, timeoutMs) {
+  return Vimcord.getReadyInstance(clientId, timeoutMs);
+}
+function createClient(options, features, config) {
+  return Vimcord.create(options, features, config);
+}
 
 // src/modules/command.manager.ts
 var import_discord8 = require("discord.js");
 
-// src/utils/import.utils.ts
+// src/utils/importUtils.ts
 var import_node_path2 = __toESM(require("path"));
-var import_qznt = require("qznt");
+var import_qznt2 = require("qznt");
 function getProcessDir() {
   const mainPath = process.argv[1];
   if (!mainPath) return "";
   return import_node_path2.default.dirname(mainPath);
 }
+function testFilenameSuffix(filename, suffix) {
+  if (!suffix) return filename.endsWith(".ts") || filename.endsWith(".js");
+  if (Array.isArray(suffix)) {
+    return suffix.some((s) => filename.endsWith(`${s}.ts`) || filename.endsWith(`${s}.js`));
+  } else {
+    return filename.endsWith(`${suffix}.ts`) || filename.endsWith(`${suffix}.js`);
+  }
+}
 async function importModulesFromDir(dir, suffix) {
   const cwd = getProcessDir();
   const MODULE_RELATIVE_PATH = import_node_path2.default.join(cwd, dir);
   const MODULE_LOG_PATH = dir;
-  const files = import_qznt.$.fs.readDir(MODULE_RELATIVE_PATH).filter((fn) => fn.endsWith(`${suffix ? `.${suffix}` : ""}.js`) || fn.endsWith(`${suffix ? `.${suffix}` : ""}.ts`));
-  if (!files.length) {
-    return [];
-  }
+  const files = import_qznt2.$.fs.readDir(MODULE_RELATIVE_PATH).filter((filename) => testFilenameSuffix(filename, suffix));
+  if (!files.length) return [];
   const modules = await Promise.all(
     files.map(async (fn) => {
       let _path = import_node_path2.default.join(MODULE_RELATIVE_PATH, fn);
@@ -1985,7 +2032,7 @@ async function importModulesFromDir(dir, suffix) {
   return filteredModules;
 }
 
-// src/modules/base-module.importer.ts
+// src/modules/importers/baseModule.importer.ts
 var ModuleImporter = class {
   client;
   constructor(client) {
@@ -1995,9 +2042,8 @@ var ModuleImporter = class {
     if (set) this.items.clear();
     const dirs = Array.isArray(dir) ? dir : [dir];
     const modules = [];
-    const effectiveSuffix = Array.isArray(suffix) ? suffix[0] : suffix ?? this.itemSuffix;
     for (const _dir of dirs) {
-      const results = await importModulesFromDir(_dir, effectiveSuffix ?? void 0);
+      const results = await importModulesFromDir(_dir, suffix ?? this.itemSuffix);
       modules.push(...results.map(({ module: module2 }) => module2.default));
     }
     for (const module2 of modules) {
@@ -2446,7 +2492,6 @@ async function fetchRole(guild, roleId) {
 
 // src/types/status.ts
 var import_discord10 = require("discord.js");
-var import_lodash6 = __toESM(require("lodash"));
 var StatusType = /* @__PURE__ */ ((StatusType2) => {
   StatusType2["DND"] = "dnd";
   StatusType2["Idle"] = "idle";
@@ -2469,12 +2514,12 @@ var defaultPresence = {
   }
 };
 function createVimcordStatusConfig(options = {}) {
-  return import_lodash6.default.merge(defaultPresence, options);
+  return deepMerge({ ...defaultPresence }, options);
 }
 
 // src/modules/status.manager.ts
 var import_node_events = __toESM(require("events"));
-var import_qznt2 = require("qznt");
+var import_qznt3 = require("qznt");
 var StatusManager = class {
   client;
   logger;
@@ -2509,14 +2554,14 @@ var StatusManager = class {
     return client;
   }
   async formatActivityName(name) {
-    name = name.replace("$USER_COUNT", import_qznt2.$.format.number(this.client.users.cache.size)).replace("$GUILD_COUNT", import_qznt2.$.format.number(this.client.guilds.cache.size)).replace(
+    name = name.replace("$USER_COUNT", import_qznt3.$.format.number(this.client.users.cache.size)).replace("$GUILD_COUNT", import_qznt3.$.format.number(this.client.guilds.cache.size)).replace(
       "$INVITE",
       this.client.config.staff.guild.inviteUrl ? this.client.config.staff.guild.inviteUrl : "<STAFF_INVITE_URL_NOT_SET>"
     );
     if (name.includes("$STAFF_GUILD_MEMBER_COUNT")) {
       await fetchGuild(this.client, this.client.config.staff.guild.id).then((guild) => {
         if (!guild) return name = name.replace("$STAFF_GUILD_MEMBER_COUNT", "<STAFF_GUILD_NOT_FOUND>");
-        name = name.replace("$STAFF_GUILD_MEMBER_COUNT", import_qznt2.$.format.number(guild.members.cache.size));
+        name = name.replace("$STAFF_GUILD_MEMBER_COUNT", import_qznt3.$.format.number(guild.members.cache.size));
       }).catch((err) => this.logger.error("Failed to fetch the staff guild", err));
     }
     return name;
@@ -2531,7 +2576,7 @@ var StatusManager = class {
   async statusRotationTask(clientStatus) {
     let activity;
     if (clientStatus.randomize && Array.isArray(clientStatus.activity)) {
-      activity = import_qznt2.$.rnd.choice(clientStatus.activity, { not: this.lastActivity });
+      activity = import_qznt3.$.rnd.choice(clientStatus.activity, { not: this.lastActivity });
       this.lastActivity = activity;
     } else {
       const activityIndex = (this.lastActivityIndex + 1) % clientStatus.activity.length;
@@ -2545,7 +2590,7 @@ var StatusManager = class {
     if (!clientStatus.interval) throw new Error("Cannot create client activity interval without interval time");
     this.task?.stop();
     this.task = null;
-    this.task = new import_qznt2.$.Loop(() => this.statusRotationTask(clientStatus), import_qznt2.$.math.ms(clientStatus.interval), true);
+    this.task = new import_qznt3.$.Loop(() => this.statusRotationTask(clientStatus), import_qznt3.$.math.ms(clientStatus.interval), true);
     this.start();
   }
   start() {
@@ -2595,196 +2640,6 @@ var StatusManager = class {
   }
 };
 
-// src/utils/vimcord.cli.ts
-var import_node_readline = require("readline");
-var import_qznt3 = require("qznt");
-var VimcordCLI = class _VimcordCLI {
-  static mode = "off";
-  static setMode(mode) {
-    if (_VimcordCLI.mode === mode) return;
-    _VimcordCLI.mode = mode;
-    if (mode === "on") {
-      CLI.logger.log(`~ Type ${CLI.options.prefix}help to view available commands`);
-    } else {
-      CLI.logger.log(`~ [MODE] Now set to "${mode}"`);
-    }
-  }
-  rl;
-  options;
-  commands = /* @__PURE__ */ new Map();
-  logger = new Logger({ prefixEmoji: "\u{1F680}", prefix: "CLI", showTimestamp: false });
-  constructor(options) {
-    this.options = options;
-    this.rl = (0, import_node_readline.createInterface)({
-      input: process.stdin,
-      output: process.stdout,
-      terminal: false
-    });
-    this.rl.on("line", (line) => {
-      if (_VimcordCLI.mode !== "on") return;
-      const { isCommand, commandName, content, args } = this.parseLine(line);
-      if (!isCommand) return;
-      const command = this.commands.get(commandName);
-      if (!command) {
-        const nearestMatches = Array.from(this.commands.keys()).filter(
-          (cmd) => cmd.toLowerCase().includes(commandName.toLowerCase())
-        );
-        return this.logger.error(
-          `Unknown command '${commandName}'${nearestMatches.length ? `. Did you mean ${nearestMatches.length > 1 ? `[${nearestMatches.map((m) => `'${this.options.prefix}${m}'`).join(", ")}]` : `'${this.options.prefix}${nearestMatches[0]}'`}?` : ""}`
-        );
-      }
-      command.fn(args, content);
-    });
-  }
-  parseLine(line) {
-    if (line.startsWith(this.options.prefix)) {
-      line = line.slice(this.options.prefix.length);
-    } else {
-      return { isCommand: false };
-    }
-    const args = line.split(" ").map((s) => s.trim());
-    const commandName = args.shift();
-    return { isCommand: true, commandName, content: args.join(" "), args };
-  }
-  getClientInstance(line) {
-    const clientIndex = import_qznt3.$.str.getFlag(line, "--client", 1) || import_qznt3.$.str.getFlag(line, "-c", 1);
-    if (clientIndex) {
-      const idx = Number(clientIndex);
-      if (isNaN(idx)) {
-        CLI.logger.error(`'${clientIndex}' is not a valid number`);
-        return void 0;
-      }
-      const client = useClient(idx);
-      if (!client) {
-        CLI.logger.error("Client instance not found");
-        return void 0;
-      }
-      return client;
-    } else {
-      const client = useClient(0);
-      if (!client) {
-        CLI.logger.error("Client instance not found");
-        return void 0;
-      }
-      return client;
-    }
-  }
-  addCommand(commandName, description, fn) {
-    this.commands.set(commandName, { description, fn });
-  }
-  removeCommand(commandName) {
-    if (!this.commands.has(commandName)) return false;
-    this.commands.delete(commandName);
-    return true;
-  }
-};
-var CLI = new VimcordCLI({ prefix: "/" });
-CLI.addCommand("help", "View information about a command, or the available CLI options", (args) => {
-  const prefix = CLI.options.prefix;
-  const helpList = {};
-  for (const cmd of CLI.commands.entries()) {
-    const commandName = cmd[0];
-    const commandDescription = cmd[1].description;
-    helpList[`${prefix}${commandName}`] = `~ ${commandDescription}`;
-  }
-  CLI.logger.table("(help)", helpList);
-});
-CLI.addCommand("register", "Register app commands (slash & context) globally, or per guild", async (args, content) => {
-  const client = CLI.getClientInstance(content);
-  if (!client) return;
-  const mode = args[0]?.toLowerCase() || "";
-  if (!["guild", "global"].includes(mode)) {
-    return CLI.logger.error(`'${mode}' is not a valid option. Your options are [guild|global]`);
-  }
-  let guildIds = (import_qznt3.$.str.getFlag(content, "--guilds", 1) || import_qznt3.$.str.getFlag(content, "-g", 1) || "").replaceAll(/["']/g, "").split(" ").filter(Boolean).map((s) => s.replaceAll(",", "").trim());
-  if (!guildIds.length) guildIds = client.guilds.cache.map((g) => g.id);
-  switch (mode) {
-    case "guild":
-      CLI.logger.info("Registering guild commands...");
-      await client.commands.registerGuild({ guilds: guildIds });
-      break;
-    case "global":
-      CLI.logger.info("Registering global commands...");
-      await client.commands.registerGlobal();
-      break;
-  }
-});
-CLI.addCommand("unregister", "Unregister app commands globally, or per guild", async (args, content) => {
-  const client = CLI.getClientInstance(content);
-  if (!client) return;
-  const mode = args[0]?.toLowerCase() || "";
-  if (!["guild", "global"].includes(mode)) {
-    return CLI.logger.error(`'${mode}' is not a valid option. Your options are [guild|global]`);
-  }
-  let guildIds = (import_qznt3.$.str.getFlag(content, "--guilds", 1) || import_qznt3.$.str.getFlag(content, "-g", 1) || "").replaceAll(/["']/g, "").split(" ").filter(Boolean).map((s) => s.replaceAll(",", "").trim());
-  if (!guildIds.length) guildIds = client.guilds.cache.map((g) => g.id);
-  switch (mode) {
-    case "guild":
-      CLI.logger.info("Unregistering guild commands...");
-      await client.commands.unregisterGuild({ guilds: guildIds });
-      break;
-    case "global":
-      CLI.logger.info("Unregistering global commands...");
-      await client.commands.unregisterGlobal();
-      break;
-  }
-});
-CLI.addCommand("stats", "View statistics about a client instance", (args, content) => {
-  const client = CLI.getClientInstance(content);
-  if (!client) return;
-  CLI.logger.table(`(stats) ~ ${client.config.app.name}`, {
-    "Guilds:": import_qznt3.$.format.number(client.guilds.cache.size),
-    "Ping:": `${client.ws.ping || 0}ms`,
-    "Uptime:": `${import_qznt3.$.math.secs(client.uptime || 0)}s`,
-    "Process Uptime:": `${Math.floor(process.uptime())}s`,
-    "Memory Usage:": `${(process.memoryUsage().rss / 1024 / 1024).toFixed(2)} MB`
-  });
-});
-CLI.addCommand("cmds", "List the loaded commands", async (args, content) => {
-  const client = CLI.getClientInstance(content);
-  if (!client) return;
-  const mode = (args[0] || "slash").toLowerCase();
-  switch (mode) {
-    case "slash": {
-      const commands = Array.from(client.commands.slash.commands.values());
-      commands.sort((a, b) => a.builder.name.localeCompare(b.builder.name));
-      const tableData = {};
-      for (const cmd of commands) {
-        tableData[`/${cmd.builder.name}`] = `~ ${cmd.builder.description || "No description"}`;
-      }
-      return CLI.logger.table(`(cmds) ~ slash (${import_qznt3.$.format.number(commands.length)})`, tableData);
-    }
-    case "prefix": {
-      const commands = Array.from(client.commands.prefix.commands.values());
-      commands.sort((a, b) => {
-        const nameA = a.toConfig().name;
-        const nameB = b.toConfig().name;
-        return nameA.localeCompare(nameB);
-      });
-      const tableData = {};
-      const defaultPrefix = client.config.prefixCommands.defaultPrefix;
-      for (const cmd of commands) {
-        const config = cmd.toConfig();
-        const aliasIndicator = config.aliases?.length ? ` [${config.aliases.join(", ")}]` : "";
-        tableData[`${defaultPrefix}${config.name}${aliasIndicator}`] = `~ ${config.description || "No description"}`;
-      }
-      return CLI.logger.table(`(cmds) ~ prefix (${import_qznt3.$.format.number(commands.length)})`, tableData);
-    }
-    case "ctx": {
-      const commands = Array.from(client.commands.context.commands.values());
-      commands.sort((a, b) => a.builder.name.localeCompare(b.builder.name));
-      const tableData = {};
-      for (const cmd of commands) {
-        const type = cmd.builder.type === 2 ? "User" : "Msg";
-        tableData[`[${type}] ${cmd.builder.name}`] = "";
-      }
-      return CLI.logger.table(`(cmds) ~ ctx (${import_qznt3.$.format.number(commands.length)})`, tableData);
-    }
-    default:
-      return CLI.logger.error(`'${mode}' is not a valid option. Valid options: [slash|prefix|ctx]`);
-  }
-});
-
 // src/client/Vimcord.ts
 var import_discord11 = require("discord.js");
 var import_dotenv = require("dotenv");
@@ -2875,7 +2730,7 @@ var Vimcord = class _Vimcord extends import_discord11.Client {
     this.clientOptions = options;
     this.features = features;
     this.config = defineVimcordConfig(config);
-    this.error = new ErrorHandler(this);
+    this.error = new VimcordErrorHandler(this);
     if (this.features.useGlobalErrorHandlers) {
       this.error.setupGlobalHandlers();
     }
@@ -3061,10 +2916,30 @@ var Vimcord = class _Vimcord extends import_discord11.Client {
   }
 };
 
-// src/db/mongo/mongo-schema.builder.ts
-var import_mongoose2 = require("mongoose");
-var import_node_crypto4 = require("crypto");
-var import_qznt6 = require("qznt");
+// src/client/error.handler.ts
+var ErrorHandler = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /** Handles command errors - sends error embed to user, then rethrows. */
+  async handleCommandError(error, guild, messageOrInteraction) {
+    await sendCommandErrorEmbed(this.client, error, guild, messageOrInteraction);
+    throw error;
+  }
+  /** Handles internal Vimcord errors - logs with [Vimcord] prefix. */
+  handleVimcordError(error, context) {
+    this.client.logger.error(`[Vimcord] [${context}]`, error);
+  }
+  /** Sets up global process error handlers. */
+  setupGlobalHandlers() {
+    process.on("uncaughtException", (err) => this.handleVimcordError(err, "Uncaught Exception"));
+    process.on("unhandledRejection", (err) => this.handleVimcordError(err, "Unhandled Rejection"));
+    process.on("exit", (code) => this.client.logger.debug(`Process exited with code ${code}`));
+    this.client.on("error", (err) => this.handleVimcordError(err, "Client Error"));
+    this.client.on("shardError", (err) => this.handleVimcordError(err, "Client Shard Error"));
+  }
+};
 
 // src/db/mongo/mongo.database.ts
 var import_mongoose = __toESM(require("mongoose"));
@@ -3195,7 +3070,10 @@ var MongoDatabase = class _MongoDatabase {
   }
 };
 
-// src/db/mongo/mongo-schema.builder.ts
+// src/db/mongo/mongoSchema.builder.ts
+var import_mongoose2 = require("mongoose");
+var import_node_crypto4 = require("crypto");
+var import_qznt6 = require("qznt");
 try {
   import("mongoose");
 } catch {
@@ -4589,6 +4467,7 @@ async function prompt(handler, options, sendOptions) {
   StatusType,
   Vimcord,
   VimcordCLI,
+  VimcordErrorHandler,
   __zero,
   cleanMention,
   clientLoggerFactory,
@@ -4605,6 +4484,7 @@ async function prompt(handler, options, sendOptions) {
   createStaffConfig,
   createToolsConfig,
   createVimcordStatusConfig,
+  deepMerge,
   defineClientOptions,
   defineGlobalToolsConfig,
   defineVimcordConfig,
@@ -4620,7 +4500,6 @@ async function prompt(handler, options, sendOptions) {
   getFirstMentionId,
   getMessageMention,
   getPackageJson,
-  getProcessDir,
   globalToolsConfig,
   importModulesFromDir,
   isMentionOrSnowflake,