vimcord 1.0.1 → 1.0.2

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 import * as discord_js from 'discord.js';
-import { SlashCommandBuilder as SlashCommandBuilder$1, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandSubcommandGroupBuilder, PermissionResolvable, ActivityType, ContextMenuCommandBuilder, ChatInputCommandInteraction, REST, ClientEvents, CommandInteraction, RepliableInteraction, TextBasedChannel, Message, GuildMember, User, EmbedBuilder, DMChannel, TextChannel, NewsChannel, ThreadChannel, ColorResolvable, ButtonComponentData, APIThumbnailComponent, ActionRowBuilder, MessageActionRowComponentBuilder, ContainerBuilder, BaseMessageOptions, StickerResolvable, PollData, InteractionReplyOptions, MessageMentionOptions, ReplyOptions, ForwardOptions, Client, APIEmbedField, APIEmbed, ClientOptions, Guild, ContextMenuCommandInteraction, MessageComponentType, UserResolvable as UserResolvable$1, InteractionCollector, MappedInteractionTypes, APITextInputComponent, APIStringSelectComponent, APIChannelSelectComponent, APIUserSelectComponent, APIRoleSelectComponent, APIMentionableSelectComponent, APIFileUploadComponent, ModalSubmitInteraction, APIModalInteractionResponseCallbackData, ModalBuilder, Interaction, AwaitModalSubmitOptions, AttachmentBuilder, SelectMenuComponentOptionData, StringSelectMenuOptionBuilder, StringSelectMenuInteraction, ButtonInteraction, MessageReaction, StringSelectMenuBuilder, ButtonBuilder, ReactionCollector, APIButtonComponent, ChannelType, PartialGroupDMChannel, PartialDMChannel, GuildBasedChannel, AnyThreadChannel, VoiceBasedChannel, CategoryChannel, Channel, Role, GuildTextBasedChannel } from 'discord.js';
+import { SlashCommandBuilder as SlashCommandBuilder$1, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandSubcommandGroupBuilder, PermissionResolvable, ActivityType, ContextMenuCommandBuilder, ChatInputCommandInteraction, REST, ClientEvents, CommandInteraction, RepliableInteraction, TextBasedChannel, Message, GuildMember, User, EmbedBuilder, DMChannel, TextChannel, NewsChannel, ThreadChannel, ColorResolvable, ButtonComponentData, APIThumbnailComponent, ActionRowBuilder, MessageActionRowComponentBuilder, ContainerBuilder, BaseMessageOptions, StickerResolvable, PollData, InteractionReplyOptions, MessageMentionOptions, ReplyOptions, ForwardOptions, Client, APIEmbedField, APIEmbed, ClientOptions, Guild, ContextMenuCommandInteraction, MessageComponentType, UserResolvable as UserResolvable$1, MappedInteractionTypes, InteractionCollector, APITextInputComponent, APIStringSelectComponent, APIChannelSelectComponent, APIUserSelectComponent, APIRoleSelectComponent, APIMentionableSelectComponent, APIFileUploadComponent, ModalSubmitInteraction, APIModalInteractionResponseCallbackData, ModalBuilder, Interaction, AwaitModalSubmitOptions, AttachmentBuilder, SelectMenuComponentOptionData, StringSelectMenuOptionBuilder, StringSelectMenuInteraction, ButtonInteraction, MessageReaction, StringSelectMenuBuilder, ButtonBuilder, ReactionCollector, APIButtonComponent, ChannelType, PartialGroupDMChannel, PartialDMChannel, GuildBasedChannel, AnyThreadChannel, VoiceBasedChannel, CategoryChannel, Channel, Role, GuildTextBasedChannel } from 'discord.js';
 import { DotenvConfigOptions } from 'dotenv';
 import mongoose, { ClientSessionOptions, QueryOptions, HydratedDocument, Require_id, SchemaDefinition, Schema, Model, RootFilterQuery, mongo, MongooseBaseQueryOptions, CreateOptions, ProjectionType, UpdateQuery, MongooseUpdateQueryOptions, PipelineStage, AggregateOptions } from 'mongoose';
 import { PartialDeep } from 'type-fest';
-import { ScheduledTask } from 'node-cron';
 import EventEmitter from 'node:events';
+import { Loop } from 'qznt';
 import { Interface } from 'node:readline';
 
 type AnySlashCommandBuilder = SlashCommandBuilder$1 | SlashCommandOptionsOnlyBuilder | SlashCommandSubcommandBuilder | SlashCommandSubcommandsOnlyBuilder | SlashCommandSubcommandGroupBuilder;
@@ -249,9 +249,9 @@ type VimcordStatusManagerEvents = {
     changed: [ClientActivity];
     cleared: [];
     rotation: [ClientActivity];
-    rotationPaused: [ScheduledTask];
-    rotationStarted: [ScheduledTask];
-    rotationDestroyed: [];
+    paused: [Loop];
+    started: [Loop];
+    destroyed: [];
 };
 declare class VimcordStatusManager {
     client: Vimcord;
@@ -1173,12 +1173,13 @@ interface BetterCollectorOptions<T extends MessageComponentType> {
     onTimeout?: CollectorTimeoutType;
     config?: VimcordToolsConfig;
 }
-interface ListenerOptions {
+interface ListenerOptions<ComponentType extends MessageComponentType = MessageComponentType, InGuild extends boolean = boolean> {
     participants?: UserResolvable$1[];
     defer?: boolean | {
         update?: boolean;
         ephemeral?: boolean;
     };
+    finally?: (arg: MappedInteractionTypes<InGuild>[ComponentType]) => any;
 }
 declare enum CollectorTimeoutType {
     DisableComponents = 0,
@@ -1200,9 +1201,9 @@ declare class BetterCollector<ComponentType extends MessageComponentType, InGuil
     private handleListenerError;
     constructor(message: Message | undefined | null, options?: BetterCollectorOptions<ComponentType>);
     /** Triggers on any interaction */
-    on(fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions): this;
+    on(fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions<ComponentType, InGuild>): this;
     /** Triggers when the interaction's customId matches */
-    on(customId: string, fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions): this;
+    on(customId: string, fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions<ComponentType, InGuild>): this;
     onEnd(fn: (collected: MappedInteractionTypes<InGuild>[ComponentType][], reason: string) => any, options?: ListenerOptions): this;
     /** Manually stop the collector and trigger cleanup */
     stop(reason?: string): void;
@@ -1430,6 +1431,7 @@ interface PromptOptions {
     content?: string;
     embed?: EmbedResolvable;
     container?: ContainerBuilder | BetterContainer;
+    textOnly?: boolean;
     buttons?: {
         confirm?: ButtonBuilder | ((builder: ButtonBuilder) => ButtonBuilder) | Partial<APIButtonComponent>;
         reject?: ButtonBuilder | ((builder: ButtonBuilder) => ButtonBuilder) | Partial<APIButtonComponent>;
@@ -1451,6 +1453,7 @@ declare class Prompt {
     readonly content?: string;
     readonly embed: EmbedResolvable;
     readonly container?: ContainerBuilder | BetterContainer;
+    readonly textOnly?: boolean;
     readonly buttons: {
         confirm: ButtonBuilder;
         reject: ButtonBuilder;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import * as discord_js from 'discord.js';
-import { SlashCommandBuilder as SlashCommandBuilder$1, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandSubcommandGroupBuilder, PermissionResolvable, ActivityType, ContextMenuCommandBuilder, ChatInputCommandInteraction, REST, ClientEvents, CommandInteraction, RepliableInteraction, TextBasedChannel, Message, GuildMember, User, EmbedBuilder, DMChannel, TextChannel, NewsChannel, ThreadChannel, ColorResolvable, ButtonComponentData, APIThumbnailComponent, ActionRowBuilder, MessageActionRowComponentBuilder, ContainerBuilder, BaseMessageOptions, StickerResolvable, PollData, InteractionReplyOptions, MessageMentionOptions, ReplyOptions, ForwardOptions, Client, APIEmbedField, APIEmbed, ClientOptions, Guild, ContextMenuCommandInteraction, MessageComponentType, UserResolvable as UserResolvable$1, InteractionCollector, MappedInteractionTypes, APITextInputComponent, APIStringSelectComponent, APIChannelSelectComponent, APIUserSelectComponent, APIRoleSelectComponent, APIMentionableSelectComponent, APIFileUploadComponent, ModalSubmitInteraction, APIModalInteractionResponseCallbackData, ModalBuilder, Interaction, AwaitModalSubmitOptions, AttachmentBuilder, SelectMenuComponentOptionData, StringSelectMenuOptionBuilder, StringSelectMenuInteraction, ButtonInteraction, MessageReaction, StringSelectMenuBuilder, ButtonBuilder, ReactionCollector, APIButtonComponent, ChannelType, PartialGroupDMChannel, PartialDMChannel, GuildBasedChannel, AnyThreadChannel, VoiceBasedChannel, CategoryChannel, Channel, Role, GuildTextBasedChannel } from 'discord.js';
+import { SlashCommandBuilder as SlashCommandBuilder$1, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandSubcommandGroupBuilder, PermissionResolvable, ActivityType, ContextMenuCommandBuilder, ChatInputCommandInteraction, REST, ClientEvents, CommandInteraction, RepliableInteraction, TextBasedChannel, Message, GuildMember, User, EmbedBuilder, DMChannel, TextChannel, NewsChannel, ThreadChannel, ColorResolvable, ButtonComponentData, APIThumbnailComponent, ActionRowBuilder, MessageActionRowComponentBuilder, ContainerBuilder, BaseMessageOptions, StickerResolvable, PollData, InteractionReplyOptions, MessageMentionOptions, ReplyOptions, ForwardOptions, Client, APIEmbedField, APIEmbed, ClientOptions, Guild, ContextMenuCommandInteraction, MessageComponentType, UserResolvable as UserResolvable$1, MappedInteractionTypes, InteractionCollector, APITextInputComponent, APIStringSelectComponent, APIChannelSelectComponent, APIUserSelectComponent, APIRoleSelectComponent, APIMentionableSelectComponent, APIFileUploadComponent, ModalSubmitInteraction, APIModalInteractionResponseCallbackData, ModalBuilder, Interaction, AwaitModalSubmitOptions, AttachmentBuilder, SelectMenuComponentOptionData, StringSelectMenuOptionBuilder, StringSelectMenuInteraction, ButtonInteraction, MessageReaction, StringSelectMenuBuilder, ButtonBuilder, ReactionCollector, APIButtonComponent, ChannelType, PartialGroupDMChannel, PartialDMChannel, GuildBasedChannel, AnyThreadChannel, VoiceBasedChannel, CategoryChannel, Channel, Role, GuildTextBasedChannel } from 'discord.js';
 import { DotenvConfigOptions } from 'dotenv';
 import mongoose, { ClientSessionOptions, QueryOptions, HydratedDocument, Require_id, SchemaDefinition, Schema, Model, RootFilterQuery, mongo, MongooseBaseQueryOptions, CreateOptions, ProjectionType, UpdateQuery, MongooseUpdateQueryOptions, PipelineStage, AggregateOptions } from 'mongoose';
 import { PartialDeep } from 'type-fest';
-import { ScheduledTask } from 'node-cron';
 import EventEmitter from 'node:events';
+import { Loop } from 'qznt';
 import { Interface } from 'node:readline';
 
 type AnySlashCommandBuilder = SlashCommandBuilder$1 | SlashCommandOptionsOnlyBuilder | SlashCommandSubcommandBuilder | SlashCommandSubcommandsOnlyBuilder | SlashCommandSubcommandGroupBuilder;
@@ -249,9 +249,9 @@ type VimcordStatusManagerEvents = {
     changed: [ClientActivity];
     cleared: [];
     rotation: [ClientActivity];
-    rotationPaused: [ScheduledTask];
-    rotationStarted: [ScheduledTask];
-    rotationDestroyed: [];
+    paused: [Loop];
+    started: [Loop];
+    destroyed: [];
 };
 declare class VimcordStatusManager {
     client: Vimcord;
@@ -1173,12 +1173,13 @@ interface BetterCollectorOptions<T extends MessageComponentType> {
     onTimeout?: CollectorTimeoutType;
     config?: VimcordToolsConfig;
 }
-interface ListenerOptions {
+interface ListenerOptions<ComponentType extends MessageComponentType = MessageComponentType, InGuild extends boolean = boolean> {
     participants?: UserResolvable$1[];
     defer?: boolean | {
         update?: boolean;
         ephemeral?: boolean;
     };
+    finally?: (arg: MappedInteractionTypes<InGuild>[ComponentType]) => any;
 }
 declare enum CollectorTimeoutType {
     DisableComponents = 0,
@@ -1200,9 +1201,9 @@ declare class BetterCollector<ComponentType extends MessageComponentType, InGuil
     private handleListenerError;
     constructor(message: Message | undefined | null, options?: BetterCollectorOptions<ComponentType>);
     /** Triggers on any interaction */
-    on(fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions): this;
+    on(fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions<ComponentType, InGuild>): this;
     /** Triggers when the interaction's customId matches */
-    on(customId: string, fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions): this;
+    on(customId: string, fn: (interaction: MappedInteractionTypes<InGuild>[ComponentType]) => any, options?: ListenerOptions<ComponentType, InGuild>): this;
     onEnd(fn: (collected: MappedInteractionTypes<InGuild>[ComponentType][], reason: string) => any, options?: ListenerOptions): this;
     /** Manually stop the collector and trigger cleanup */
     stop(reason?: string): void;
@@ -1430,6 +1431,7 @@ interface PromptOptions {
     content?: string;
     embed?: EmbedResolvable;
     container?: ContainerBuilder | BetterContainer;
+    textOnly?: boolean;
     buttons?: {
         confirm?: ButtonBuilder | ((builder: ButtonBuilder) => ButtonBuilder) | Partial<APIButtonComponent>;
         reject?: ButtonBuilder | ((builder: ButtonBuilder) => ButtonBuilder) | Partial<APIButtonComponent>;
@@ -1451,6 +1453,7 @@ declare class Prompt {
     readonly content?: string;
     readonly embed: EmbedResolvable;
     readonly container?: ContainerBuilder | BetterContainer;
+    readonly textOnly?: boolean;
     readonly buttons: {
         confirm: ButtonBuilder;
         reject: ButtonBuilder;

package/dist/index.js

@@ -421,8 +421,8 @@ var ContextCommandBuilder = class extends BaseCommandBuilder {
 };
 
 // src/utils/dir.ts
-import jsTools from "jstools";
 import path from "path";
+import { $ } from "qznt";
 function getProcessDir() {
   const mainPath = process.argv[1];
   if (!mainPath) return "";
@@ -432,7 +432,7 @@ async function importModulesFromDir(dir, fnPrefix) {
   const cwd = getProcessDir();
   const MODULE_RELATIVE_PATH = path.join(cwd, dir);
   const MODULE_LOG_PATH = dir;
-  const files = jsTools.readDir(MODULE_RELATIVE_PATH, { recursive: true }).filter(
+  const files = $.fs.readDir(MODULE_RELATIVE_PATH).filter(
     (fn) => fn.endsWith(`${fnPrefix ? `.${fnPrefix}` : ""}.js`) || fn.endsWith(`${fnPrefix ? `.${fnPrefix}` : ""}.ts`)
   );
   if (!files.length) {
@@ -1237,28 +1237,9 @@ function formatThousands(num, sep = ",") {
   return `${num}`.replace(/\B(?<!\.\d*)(?=(\d{3})+(?!\d))/g, sep);
 }
 
-// src/utils/random.ts
-function pickRandom(arr, options) {
-  const _rnd = () => {
-    return arr[Math.floor(Math.random() * arr.length)];
-  };
-  let att = 0;
-  let candidate = _rnd();
-  if (options?.notEqualTo !== void 0 && arr.length > 1) {
-    while (candidate === options.notEqualTo) {
-      if (att < (options?.maxRerollAttempts ?? 100)) {
-        throw new Error(`pickRandom reached max reroll attempts (${options?.maxRerollAttempts ?? 100})`);
-      }
-      candidate = _rnd();
-      att++;
-    }
-  }
-  return options?.clone ? structuredClone(candidate) : candidate;
-}
-
 // src/modules/status.manager.ts
-import cron from "node-cron";
 import EventEmitter from "events";
+import { $ as $2 } from "qznt";
 var VimcordStatusManager = class {
   client;
   logger;
@@ -1279,24 +1260,9 @@ var VimcordStatusManager = class {
         this.logger.debug("Status cleared");
       }
     });
-    this.emitter.on("rotation", () => {
-      if (this.client.config.app.verbose) {
-        this.logger.debug("Status rotated");
-      }
-    });
-    this.emitter.on("rotationStarted", () => {
-      if (this.client.config.app.verbose) {
-        this.logger.debug("Status rotation resumed \u25B6\uFE0F");
-      }
-    });
-    this.emitter.on("rotationPaused", () => {
-      if (this.client.config.app.verbose) {
-        this.logger.debug("Status rotation paused \u23F8\uFE0F");
-      }
-    });
   }
   clearData() {
-    this.task?.destroy();
+    this.task?.stop();
     this.task = null;
     this.lastActivity = null;
     this.lastActivityIndex = 0;
@@ -1329,11 +1295,8 @@ var VimcordStatusManager = class {
   }
   async statusRotationTask(clientStatus) {
     let activity;
-    if (clientStatus.randomize) {
-      activity = pickRandom(clientStatus.activity, {
-        notEqualTo: this.lastActivity,
-        clone: true
-      });
+    if (clientStatus.randomize && Array.isArray(clientStatus.activity)) {
+      activity = $2.rnd.choice(clientStatus.activity, { not: this.lastActivity });
       this.lastActivity = activity;
     } else {
       const activityIndex = (this.lastActivityIndex + 1) % clientStatus.activity.length;
@@ -1345,34 +1308,22 @@ var VimcordStatusManager = class {
   }
   async scheduleStatusRotation(clientStatus) {
     if (!clientStatus.interval) throw new Error("Cannot create client activity interval without interval time");
-    this.task?.destroy();
+    this.task?.stop();
     this.task = null;
-    await this.statusRotationTask(clientStatus);
-    this.task = cron.createTask(
-      `*/${clientStatus.interval} * * * * *`,
-      async () => await this.statusRotationTask(clientStatus),
-      { noOverlap: true }
-    );
+    this.task = new $2.Loop(() => this.statusRotationTask(clientStatus), $2.math.ms(clientStatus.interval), true);
     this.start();
-    this.emitter.emit("rotationStarted", this.task);
   }
   start() {
     if (this.task) {
       this.task.start();
-      this.emitter.emit("rotationStarted", this.task);
-      if (this.client.config.app.verbose) {
-        this.logger.debug("Status rotation started");
-      }
+      this.emitter.emit("started", this.task);
     }
     return this;
   }
   pause() {
     if (this.task) {
       this.task.stop();
-      this.emitter.emit("rotationPaused", this.task);
-      if (this.client.config.app.verbose) {
-        this.logger.debug("Status rotation paused");
-      }
+      this.emitter.emit("paused", this.task);
     }
     return this;
   }
@@ -1386,21 +1337,16 @@ var VimcordStatusManager = class {
     }
     if (!clientStatus.interval) {
       await this.setActivity(Array.isArray(clientStatus.activity) ? clientStatus.activity[0] : clientStatus.activity);
-      return this;
-    }
-    if (clientStatus.interval) {
+    } else {
       await this.scheduleStatusRotation(clientStatus);
     }
     return this;
   }
   async destroy() {
     if (this.task) {
-      this.task.destroy();
+      this.task.stop();
       this.task = null;
-      this.emitter.emit("rotationDestroyed");
-      if (this.client.config.app.verbose) {
-        this.logger.debug("Status rotation destroyed");
-      }
+      this.emitter.emit("destroyed");
       await this.clear();
     }
     return this;
@@ -1410,9 +1356,6 @@ var VimcordStatusManager = class {
     this.clearData();
     client.user.setActivity({ name: "" });
     this.emitter.emit("cleared");
-    if (this.client.config.app.verbose) {
-      this.logger.debug("Status cleared");
-    }
     return this;
   }
 };
@@ -2962,7 +2905,7 @@ var BetterCollector = class _BetterCollector {
             if (shouldBeDeferred.update) {
               await interaction.deferUpdate().catch(Boolean);
             } else {
-              await interaction.deferReply({ ephemeral: shouldBeDeferred.ephemeral }).catch(Boolean);
+              await interaction.deferReply({ flags: shouldBeDeferred.ephemeral ? "Ephemeral" : void 0 }).catch(Boolean);
             }
           } else {
             await interaction.deferReply().catch(Boolean);
@@ -2973,7 +2916,7 @@ var BetterCollector = class _BetterCollector {
             try {
               const isAllowed = await this.validateParticipant(interaction, listener.options?.participants);
               if (!isAllowed) return;
-              await listener.fn(interaction);
+              await listener.fn(interaction).finally(() => listener.options?.finally?.(interaction));
             } catch (err) {
               this.handleListenerError(err);
             }
@@ -2983,7 +2926,7 @@ var BetterCollector = class _BetterCollector {
             allListeners.map((l) => {
               const isAllowed = this.validateParticipant(interaction, l.options?.participants);
               if (!isAllowed) return;
-              return l.fn(interaction).catch(this.handleListenerError);
+              return l.fn(interaction).catch(this.handleListenerError).finally(() => l.options?.finally?.(interaction));
             })
           );
         }
@@ -3862,6 +3805,7 @@ var Prompt = class {
   content;
   embed;
   container;
+  textOnly;
   buttons;
   customButtons;
   onResolve;
@@ -3875,6 +3819,7 @@ var Prompt = class {
     this.content = options.content;
     this.embed = options.embed ?? this.createDefaultForm();
     this.container = options?.container;
+    this.textOnly = options.textOnly;
     this.buttons = this.createButtons(options.buttons);
     this.customButtons = this.createCustomButtons(options.customButtons);
     this.onResolve = options.onResolve ?? [3 /* DeleteOnConfirm */, 4 /* DeleteOnReject */];
@@ -3954,7 +3899,7 @@ var Prompt = class {
   }
   buildSendOptions(options) {
     const sendData = { ...options };
-    if (this.container) {
+    if (!this.textOnly && this.container) {
       sendData.components = Array.isArray(sendData.components) ? [...sendData.components, this.container] : [this.container];
       const existingFlags = sendData.flags ? Array.isArray(sendData.flags) ? sendData.flags : [sendData.flags] : [];
       if (!existingFlags.includes("IsComponentsV2")) {
@@ -3963,7 +3908,9 @@ var Prompt = class {
         sendData.flags = existingFlags;
       }
     } else {
-      sendData.embeds = Array.isArray(sendData.embeds) ? [this.embed, ...sendData.embeds] : [this.embed];
+      if (!this.textOnly) {
+        sendData.embeds = Array.isArray(sendData.embeds) ? [this.embed, ...sendData.embeds] : [this.embed];
+      }
     }
     if (this.content) {
       sendData.content = this.content;
@@ -4049,7 +3996,7 @@ async function prompt(handler, options, sendOptions) {
 
 // src/utils/VimcordCLI.ts
 import { createInterface } from "readline";
-import jsTools2 from "jstools";
+import { $ as $3 } from "qznt";
 var VimcordCLI = class {
   rl;
   options;
@@ -4088,7 +4035,7 @@ var VimcordCLI = class {
     return { isCommand: true, commandName, content: args.join(" "), args };
   }
   getClientInstance(line) {
-    const clientIndex = jsTools2.getFlagSubstring(line, "--client", 1) || jsTools2.getFlagSubstring(line, "-c", 1);
+    const clientIndex = $3.str.getFlag(line, "--client", 1) || $3.str.getFlag(line, "-c", 1);
     if (clientIndex) {
       const idx = Number(clientIndex);
       if (isNaN(idx)) {
@@ -4138,7 +4085,7 @@ CLI.addCommand("register", "Register app commands (slash & context) globally, or
   if (!["guild", "global"].includes(mode)) {
     return CLI.logger.error(`'${mode}' is not a valid option. Your options are [guild|global]`);
   }
-  let guildIds = (jsTools2.getFlagSubstring(content, "--guilds", 1) || jsTools2.getFlagSubstring(content, "-g", 1) || "").replaceAll(/["']/g, "").split(" ").filter(Boolean).map((s) => s.replaceAll(",", "").trim());
+  let guildIds = ($3.str.getFlag(content, "--guilds", 1) || $3.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":
@@ -4160,7 +4107,7 @@ CLI.addCommand("unregister", "Unregister app commands globally, or per guild", a
   if (!["guild", "global"].includes(mode)) {
     return CLI.logger.error(`'${mode}' is not a valid option. Your options are [guild|global]`);
   }
-  let guildIds = (jsTools2.getFlagSubstring(content, "--guilds", 1) || jsTools2.getFlagSubstring(content, "-g", 1) || "").replaceAll(/["']/g, "").split(" ").filter(Boolean).map((s) => s.replaceAll(",", "").trim());
+  let guildIds = ($3.str.getFlag(content, "--guilds", 1) || $3.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":
@@ -4179,9 +4126,9 @@ CLI.addCommand("stats", "View statistics about a client instance", (args, conten
   const client = CLI.getClientInstance(content);
   if (!client) return;
   CLI.logger.table(`(stats) ~ ${client.config.app.name}`, {
-    "Guilds:": jsTools2.formatThousands(client.guilds.cache.size),
+    "Guilds:": $3.format.number(client.guilds.cache.size),
     "Ping:": `${client.ws.ping || 0}ms`,
-    "Uptime:": `${jsTools2.msToSec(client.uptime || 0)}s`,
+    "Uptime:": `${$3.math.secs(client.uptime || 0)}s`,
     "Process Uptime:": `${Math.floor(process.uptime())}s`,
     "Memory Usage:": `${(process.memoryUsage().rss / 1024 / 1024).toFixed(2)} MB`
   });
@@ -4198,7 +4145,7 @@ CLI.addCommand("cmds", "List the loaded commands", async (args, content) => {
       for (const cmd of commands) {
         tableData[`/${cmd.builder.name}`] = `~ ${cmd.builder.description || "No description"}`;
       }
-      return CLI.logger.table(`(cmds) ~ slash (${jsTools2.formatThousands(commands.length)})`, tableData);
+      return CLI.logger.table(`(cmds) ~ slash (${$3.format.number(commands.length)})`, tableData);
     }
     case "prefix": {
       const commands = Array.from(client.commands.prefix.commands.values());
@@ -4214,7 +4161,7 @@ CLI.addCommand("cmds", "List the loaded commands", async (args, content) => {
         const aliasIndicator = config.aliases?.length ? ` [${config.aliases.join(", ")}]` : "";
         tableData[`${defaultPrefix}${config.name}${aliasIndicator}`] = `~ ${config.description || "No description"}`;
       }
-      return CLI.logger.table(`(cmds) ~ prefix (${jsTools2.formatThousands(commands.length)})`, tableData);
+      return CLI.logger.table(`(cmds) ~ prefix (${$3.format.number(commands.length)})`, tableData);
     }
     case "ctx": {
       const commands = Array.from(client.commands.context.commands.values());
@@ -4224,7 +4171,7 @@ CLI.addCommand("cmds", "List the loaded commands", async (args, content) => {
         const type = cmd.builder.type === 2 ? "User" : "Msg";
         tableData[`[${type}] ${cmd.builder.name}`] = "";
       }
-      return CLI.logger.table(`(cmds) ~ ctx (${jsTools2.formatThousands(commands.length)})`, tableData);
+      return CLI.logger.table(`(cmds) ~ ctx (${$3.format.number(commands.length)})`, tableData);
     }
     default:
       return CLI.logger.error(`'${mode}' is not a valid option. Valid options: [slash|prefix|ctx]`);
@@ -4251,6 +4198,25 @@ function createClient(options, features = {}, config = {}) {
 function getClientInstances() {
   return clientInstances;
 }
+
+// src/utils/random.ts
+function pickRandom(arr, options) {
+  const _rnd = () => {
+    return arr[Math.floor(Math.random() * arr.length)];
+  };
+  let att = 0;
+  let candidate = _rnd();
+  if (options?.notEqualTo !== void 0 && arr.length > 1) {
+    while (candidate === options.notEqualTo) {
+      if (att < (options?.maxRerollAttempts ?? 100)) {
+        throw new Error(`pickRandom reached max reroll attempts (${options?.maxRerollAttempts ?? 100})`);
+      }
+      candidate = _rnd();
+      att++;
+    }
+  }
+  return options?.clone ? structuredClone(candidate) : candidate;
+}
 export {
   BaseCommandBuilder,
   BetterCollector,