djs-builder 0.5.42 → 0.6.0

package/lib/discord/builder/system/Pagination.ts

@@ -1,374 +0,0 @@
-import {
-  ButtonBuilder,
-  ActionRowBuilder,
-  EmbedBuilder,
-  Message,
-  MessageComponentInteraction,
-  MessageActionRowComponentBuilder,
-  ButtonStyle,
-  StringSelectMenuBuilder,
-} from "discord.js";
-
-interface PagerOptions {
-  firstLast?: boolean;
-  deleteOption?: boolean;
-  otherComponents?: ActionRowBuilder<MessageActionRowComponentBuilder>[];
-  home?: {
-    home_Option?: boolean;
-    home_page?: number;
-  };
-  timeOption?: {
-    timeOut?: number;
-    disable?: boolean;
-    deletes?: boolean;
-    custom?: (() => void);
-  };
-  user_only?: {
-    user_status?: boolean;
-    reply?: string;
-  };
-  style?: {
-    nextAndBack?: ButtonStyle;
-    firstAndLast?: ButtonStyle;
-    homeStyle?: ButtonStyle;
-    deleteStyle?: ButtonStyle;
-  };
-  label?: {
-    labelNext?: string | null;
-    labelBack?: string | null;
-    labelFirst?: string | null;
-    labelLast?: string | null;
-    labelHome?: string | null;
-    labelDelete?: string | null;
-  };
-  emoji?: {
-    emojiNext?: string;
-    emojiBack?: string;
-    emojiFirst?: string;
-    emojiLast?: string;
-    emojiHome?: string;
-    emojiDelete?: string;
-  };
-  pages?: {
-    embeds?: EmbedBuilder[];
-    attachment?: (string | Buffer)[];
-    content?: string[];
-  };
-  navigationMenu?: {
-    enabled?: boolean;
-    placeHolder?: string;
-    selects?: string[];
-  };
-}
-
-const CUSTOM_IDS = {
-  NEXT: "next-discobase",
-  BACK: "back-discobase",
-  FIRST: "first-discobase",
-  LAST: "last-discobase",
-  DELETE: "delete-discobase",
-  HOME: "home-discobase",
-  SELECT: "select-discobase"
-};
-
-const VALID_BUTTON_STYLES = [
-  ButtonStyle.Primary,
-  ButtonStyle.Secondary,
-  ButtonStyle.Success,
-  ButtonStyle.Danger
-];
-
-const isValidEmoji = (emoji: string | undefined): boolean => {
-  if (!emoji) return true; // No emoji is valid.
-  
-  const unicodeEmojiPattern = /[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{1F700}-\u{1F77F}\u{1F780}-\u{1F7FF}\u{1F800}-\u{1F8FF}\u{1F900}-\u{1F9FF}\u{1FA00}-\u{1FA6F}\u{1FA70}-\u{1FAFF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}\u{2300}-\u{23FF}\u{2B50}\u{2934}\u{2935}\u{3030}\u{20E3}\u{FE0F}]/u;
-  const discordCustomEmojiPattern = /^<:[a-zA-Z0-9_]+:[0-9]+>$/;
-  return unicodeEmojiPattern.test(emoji) || discordCustomEmojiPattern.test(emoji);
-};
-
-export class Pagination {
-  private message: Message;
-  private options: Required<PagerOptions>;
-  private buttons: ButtonBuilder[];
-  private components: ActionRowBuilder<MessageActionRowComponentBuilder>[];
-  private naw_page: number = 0;
-
-  constructor(message: Message, options: PagerOptions) {
-    this.message = message;
-    this.options = {
-      firstLast: false,
-      deleteOption: false,
-      otherComponents: [],
-      home: { home_Option: false, home_page: 0 },
-      timeOption: { timeOut: 86400000, disable: false, deletes: false, custom: undefined },
-      user_only: { user_status: false, reply: "You are not the command owner" },
-      style: { nextAndBack: ButtonStyle.Primary, firstAndLast: ButtonStyle.Secondary, homeStyle: ButtonStyle.Success, deleteStyle: ButtonStyle.Danger },
-      label: {},
-      emoji: { emojiNext: "➡️", emojiBack: "⬅️", emojiFirst: "⏪", emojiLast: "⏩", emojiHome: "🏠", emojiDelete: "🗑️" },
-      pages: { embeds: [], attachment: [], content: [] },
-      navigationMenu: { enabled: false, placeHolder: "Choose a page", selects: [] },
-      ...options,
-    };
-
-    this.validateOptions();
-    this.buttons = this.createButtons();
-    this.components = this.createComponents();
-  }  
-
-  private validateOptions() {
-    const { emoji } = this.options;
-    const emojiValues = Object.values(emoji);
-    
-    if (emojiValues.some(e => e && !isValidEmoji(e))) {
-      throw new Error("Invalid emoji format. Must be Unicode emojis, valid emoji IDs, or empty.");
-    }
-
-    const { style } = this.options;
-    if (!Object.values(style).every(style => VALID_BUTTON_STYLES.includes(style))) {
-      throw new Error("Invalid button style. Must be one of the predefined ButtonStyle values.");
-    }
-
-    if (this.options.deleteOption && this.options.home?.home_Option) {
-      throw new Error("You can't use 'home' and 'delete' together.");
-    }
-
-    if (this.options.timeOption?.disable && this.options.timeOption?.deletes) {
-      throw new Error("You can't use 'disable' and 'deletes' together.");
-    }
-  }
-
-  private createButtons(): ButtonBuilder[] {
-    const {
-        nextAndBack,
-        firstAndLast,
-        homeStyle,
-        deleteStyle,
-    } = this.options.style;
-
-    const {
-        emojiNext,
-        emojiBack,
-        emojiFirst,
-        emojiLast,
-        emojiHome,
-        emojiDelete,
-    } = this.options.emoji;
-
-    const next = new ButtonBuilder().setCustomId(CUSTOM_IDS.NEXT).setStyle(nextAndBack!);
-    if (emojiNext) next.setEmoji(emojiNext);
-
-    const back = new ButtonBuilder().setCustomId(CUSTOM_IDS.BACK).setStyle(nextAndBack!);
-    if (emojiBack) back.setEmoji(emojiBack);
-
-    const first = new ButtonBuilder().setCustomId(CUSTOM_IDS.FIRST).setStyle(firstAndLast!);
-    if (emojiFirst) first.setEmoji(emojiFirst);
-
-    const last = new ButtonBuilder().setCustomId(CUSTOM_IDS.LAST).setStyle(firstAndLast!);
-    if (emojiLast) last.setEmoji(emojiLast);
-
-    const home = new ButtonBuilder().setCustomId(CUSTOM_IDS.HOME).setStyle(homeStyle!);
-    if (emojiHome) home.setEmoji(emojiHome);
-
-    const deleteBtn = new ButtonBuilder().setCustomId(CUSTOM_IDS.DELETE).setStyle(deleteStyle!);
-    if (emojiDelete) deleteBtn.setEmoji(emojiDelete);
-
-    const {
-        labelNext,
-        labelBack,
-        labelFirst,
-        labelLast,
-        labelHome,
-        labelDelete,
-    } = this.options.label;
-
-    if (labelNext) next.setLabel(labelNext);
-    if (labelBack) back.setLabel(labelBack);
-    if (labelFirst) first.setLabel(labelFirst);
-    if (labelLast) last.setLabel(labelLast);
-    if (labelHome) home.setLabel(labelHome);
-    if (labelDelete) deleteBtn.setLabel(labelDelete);
-
-    const buttons: ButtonBuilder[] = [];
-
-    if (this.options.firstLast) {
-        buttons.push(first); 
-    }
-
-    buttons.push(back); 
-
-    if (this.options.home?.home_Option) {
-        buttons.push(home); 
-        if (this.options.firstLast) {
-            buttons.push(next); 
-            buttons.push(last); 
-        } else {
-            buttons.push(next); 
-        }
-    } else {
-        if (this.options.deleteOption) {
-            buttons.push(deleteBtn); 
-        }
-        
-        buttons.push(next); 
-
-        if (this.options.firstLast) {
-            buttons.push(last);
-        }
-    }
-
-   
-    if (!this.options.firstLast) {
-        buttons.push(last);
-    }
-
-    return buttons;
-}
-
-
-  private createComponents(): ActionRowBuilder<MessageActionRowComponentBuilder>[] {
-    const actionRow = new ActionRowBuilder<MessageActionRowComponentBuilder>().addComponents(this.buttons);
-    const components = [actionRow, ...this.options.otherComponents];
-
-    if (this.options.navigationMenu?.enabled) {
-      const menuOptions = this.options.navigationMenu.selects!.map((select, index) => ({
-        label: `Page ${index + 1}`,
-        description: select,
-        value: `${index}`,
-      }));
-
-      const selectMenu = new StringSelectMenuBuilder()
-        .setCustomId(CUSTOM_IDS.SELECT)
-        .setPlaceholder(this.options.navigationMenu.placeHolder || "Select a page")
-        .addOptions(menuOptions);
-
-      const row = new ActionRowBuilder<StringSelectMenuBuilder>().addComponents(selectMenu);
-      components.push(row);
-    }
-
-    return components;
-  }
-
-  public async send() {
-    const { embeds = [], content = [], attachment = [] } = this.options.pages || {};
-  
-    const safeEmbeds = embeds ?? [];
-    
-    if (safeEmbeds.length === 0) {
-      throw new Error("No embeds provided.");
-    }
-  
-    try {
-      const msg = await this.message.reply({
-        embeds: [safeEmbeds[0]],
-        content: content[0] || "",
-        files: attachment[0] ? [attachment[0]] : undefined,
-        components: this.components,
-      });
-  
-      this.handleInteraction(msg);
-    } catch (error) {
-      console.error("Failed to send message:", error);
-    }
-  }
-  
-  
-
-  private async handleInteraction(msg: Message) {
-    const filter = (i: MessageComponentInteraction) => i.user.id === this.message.author.id;
-    
-    const collector = msg.createMessageComponentCollector({ filter, time: this.options.timeOption?.timeOut || 60000 });
-
-    collector.on("collect", async (interaction: MessageComponentInteraction) => {
-      try {
-        const embedsLength = this.options.pages.embeds?.length || 0;
-    
-        // Handle interaction based on its type
-        if (interaction.isButton()) {
-          switch (interaction.customId) {
-            case CUSTOM_IDS.NEXT:
-              this.naw_page = (this.naw_page + 1) % embedsLength;
-              break;
-            case CUSTOM_IDS.BACK:
-              this.naw_page = (this.naw_page - 1 + embedsLength) % embedsLength;
-              break;
-            case CUSTOM_IDS.FIRST:
-              this.naw_page = 0;
-              break;
-            case CUSTOM_IDS.LAST:
-              this.naw_page = embedsLength - 1;
-              break;
-            case CUSTOM_IDS.DELETE:
-              await interaction.deferUpdate();
-              await msg.delete();
-              collector.stop();
-              return;
-            case CUSTOM_IDS.HOME:
-              this.naw_page = this.options.home?.home_page || 0;
-              break;
-            default:
-              break;
-          }
-        } else if (interaction.isStringSelectMenu()) { 
-          if (interaction.customId === CUSTOM_IDS.SELECT) {
-            this.naw_page = Number(interaction.values[0]);
-          }
-        }
-    
-        await interaction.deferUpdate();
-        await this.updateMessage(msg);
-      } catch (error) {
-        console.error("Interaction error:", error);
-      }
-    });    
-
-    collector.on("end", async () => {
-      try {
-          const fetchedMsg = await this.message.channel.messages.fetch(msg.id);
-  
-          if (this.options.timeOption?.disable) {
-              const disabledButtons = this.buttons.map(button => 
-                  button.setDisabled(true)
-              );
-  
-              const menuOptions: { label: string; description?: string; value: string }[] = 
-                  this.options.navigationMenu?.selects?.map((select, index) => ({
-                      label: `Page ${index + 1}`,
-                      description: select,
-                      value: `${index}`,
-                  })) || [];
-  
-              const disabledComponents = new ActionRowBuilder<MessageActionRowComponentBuilder>().addComponents(disabledButtons);
-              const newComponents = [disabledComponents, ...this.options.otherComponents];
-  
-              if (this.options.navigationMenu?.enabled) {
-                  const selectMenu = new StringSelectMenuBuilder()
-                      .setCustomId(CUSTOM_IDS.SELECT)
-                      .setPlaceholder(this.options.navigationMenu.placeHolder || "Select a page")
-                      .addOptions(menuOptions)
-                      .setDisabled(true);
-  
-                  const row = new ActionRowBuilder<StringSelectMenuBuilder>().addComponents(selectMenu);
-                  newComponents.push(row);
-              }
-  
-              await fetchedMsg.edit({ components: newComponents }); 
-          }
-  
-          if (this.options.timeOption?.deletes) {
-              await fetchedMsg.delete();
-          }
-      } catch (error: any) {}
-  });
-}
-
-  private async updateMessage(msg: Message) {
-    const { embeds = [], content = [], attachment = [] } = this.options.pages || {};
-    
-    await msg.edit({
-      embeds: [embeds[this.naw_page]],
-      content: content[this.naw_page] || "",
-      files: attachment[this.naw_page] ? [attachment[this.naw_page]] : undefined,
-      components: this.components,
-    });
-  }
-}

package/lib/discord/builder/system/collectors.ts

@@ -1,197 +0,0 @@
-import {
-    Message,
-    Interaction,
-    MessageCollector,
-    InteractionCollector,
-    CollectorFilter,
-    Snowflake,
-    ReadonlyCollection,
-    CommandInteraction,
-    ButtonInteraction,
-    MessageReaction,
-    ModalSubmitInteraction,
-    StringSelectMenuInteraction,
-    UserSelectMenuInteraction,
-    RoleSelectMenuInteraction,
-    ContextMenuCommandInteraction,
-    Collector,
-} from 'discord.js';
-
-type EventSource = Message | CommandInteraction | ButtonInteraction | MessageReaction | Interaction;
-
-const collectorCache: Map<string, any> = new Map();
-
-/**
- * @param sources - The event source(s) (message, interaction, reaction, etc.) to collect from.
- * @param options - Custom options for collection (time, filter, max, idle).
- * @param events - Custom event handlers for `onCollect`, `onEnd`, `onError`, etc.
- */
-function Djs_Collectors<T extends EventSource>(
-    sources: T | T[],
-    options: {
-        time?: number; 
-        filter?: CollectorFilter<[T]>; 
-        max?: number; 
-        idle?: number; 
-        log?: boolean; 
-        throttle?: number; 
-        uniqueId?: string; 
-    },
-    events: {
-        onCollect: (collectedItem: T, meta?: Record<string, any>) => void; 
-        onEnd?: (collected: ReadonlyCollection<Snowflake, T>, reason: string) => void; 
-        onError?: (error: Error) => void; 
-        onDispose?: (disposedItem: T) => void; 
-        onTimeout?: () => void; 
-        onStart?: () => void; 
-    },
-    metadata?: Record<string, any> 
-): { stop: (reason?: string) => void } { 
-    const eventSources = Array.isArray(sources) ? sources : [sources];
-    const filter: CollectorFilter<[T]> = options.filter || (() => true);
-    const time: number = options.time || 60000; 
-
-    if (events.onStart) events.onStart();
-
-    if (options.uniqueId && collectorCache.has(options.uniqueId)) {
-        console.warn(`Collector with unique ID "${options.uniqueId}" is already active. Skipping creation.`);
-        return { stop: () => {} };
-    }
-
-    if (options.uniqueId) {
-        collectorCache.set(options.uniqueId, { sources: eventSources, time, max: options.max, idle: options.idle });
-    }
-
-    const collectors: any[] = []; 
-
-    for (const source of eventSources) {
-        if (source instanceof Message) {
-            const messageCollector = new MessageCollector(source.channel, {
-                filter: filter as CollectorFilter<[Message]>,
-                time,
-                max: options.max,
-                idle: options.idle,
-            });
-
-            collectors.push(messageCollector); // Store reference
-            handleCollector(messageCollector, events, options, metadata);
-
-        } else if (
-            source instanceof CommandInteraction ||
-            source instanceof ButtonInteraction ||
-            source instanceof StringSelectMenuInteraction ||
-            source instanceof UserSelectMenuInteraction ||
-            source instanceof RoleSelectMenuInteraction ||
-            source instanceof ContextMenuCommandInteraction ||
-            source instanceof ModalSubmitInteraction
-        ) {
-            if (!source.client.isReady()) {
-                throw new Error('Client is not ready. Please ensure the client is logged in and ready before creating a collector.');
-            }
-
-            const interactionCollector = new InteractionCollector(source.client, {
-                filter: filter as CollectorFilter<[Interaction]>,
-                time,
-                max: options.max,
-                idle: options.idle,
-            });
-
-            collectors.push(interactionCollector);
-            handleCollector(interactionCollector, events, options, metadata);
-
-        } else if (source instanceof MessageReaction) {
-            const reactionCollector = source.message.createReactionCollector({
-                filter: filter as CollectorFilter<[MessageReaction]>,
-                time,
-                max: options.max,
-                idle: options.idle,
-            });
-
-            collectors.push(reactionCollector);
-            handleCollector(reactionCollector, events, options, metadata);
-
-        } else {
-            throw new Error("Source must be either a Message, Interaction, or Reaction.");
-        }
-    }
-
-    return {
-        stop: (reason: string = 'manual') => {
-            if (options.uniqueId) {
-                const cached = collectorCache.get(options.uniqueId);
-                if (cached) {
-                    collectors.forEach((collector) => collector.stop(reason));
-                    collectorCache.delete(options.uniqueId);
-                    console.log(`Collector with unique ID "${options.uniqueId}" has been ended. Reason: ${reason}`);
-                } else {
-                    console.warn(`No collector found with unique ID "${options.uniqueId}".`);
-                }
-            } else {
-                collectors.forEach((collector) => collector.stop(reason)); 
-                console.log(`Collectors have been ended. Reason: ${reason}`);
-            }
-        },
-    };
-}
-
-/**
- * Generic function to handle a collector's events and lifecycle.
- * @param collector - The specific collector (MessageCollector, InteractionCollector, etc.).
- * @param events - The event handlers for collection lifecycle.
- * @param options - Additional collection options.
- * @param metadata - Optional metadata attached to each collected item.
- */
-function handleCollector<T>(
-    collector: any,
-    events: {
-        onCollect: (collectedItem: T, meta?: Record<string, any>) => void;
-        onEnd?: (collected: ReadonlyCollection<Snowflake, T>, reason: string) => void;
-        onError?: (error: Error) => void;
-        onDispose?: (disposedItem: T) => void;
-        onTimeout?: () => void;
-    },
-    options: { log?: boolean; throttle?: number; uniqueId?: string }, 
-    metadata?: Record<string, any>
-) {
-    let lastCollectedTime = 0; 
-
-    collector.on('collect', (collectedItem: T) => {
-        const now = Date.now();
-        if (options.throttle && now - lastCollectedTime < options.throttle) {
-            if (options.log) console.warn(`Throttled collect for ${collectedItem}`);
-            return; 
-        }
-        lastCollectedTime = now;
-
-        if (options.log) console.log('Collected item:', collectedItem);
-        events.onCollect(collectedItem, metadata);
-    });
-
-    collector.on('end', (collected: ReadonlyCollection<Snowflake, T>, reason: string) => {
-        if (options.log) console.log(`Collector ended. Reason: ${reason}`);
-        if (events.onEnd) events.onEnd(collected, reason);
-        if (reason === 'time' && events.onTimeout) {
-            events.onTimeout();
-        }
-
-        if (options.uniqueId) {
-            collectorCache.delete(options.uniqueId);
-        }
-    });
-
-    if (events.onError) {
-        collector.on('error', (error: Error) => {
-            if (options.log) console.error('Collector error:', error);
-            (events.onError as (error: Error) => void)(error);
-        });
-    }
-
-    if (events.onDispose) {
-        collector.on('dispose', (disposedItem: T) => {
-            if (options.log) console.log('Disposed item:', disposedItem);
-            (events.onDispose as (disposedItem: T) => void)(disposedItem);
-        });
-    }
-}
-
-export { Djs_Collectors };

package/lib/discord/builder/utils.ts

@@ -1,9 +0,0 @@
-import { ButtonManager } from './components/Buttons';
-import { MenuManager } from './components/Menus';
-import { PermissionChecker } from './permissions/perms';
-
-export {
-  ButtonManager,
-  MenuManager,
-  PermissionChecker
-};