Welcome to the ultimate Discord Bot Utilities package! 🥏 Boost your Discord bot development with ease, speed, and all-in-one features.

📑 Table of Contents

1. 🎯 Starter – Initialize your bot with commands, events, presence, and more.
2. ⚙️ Functions – Utilities like CreateRow, CreateBar, Wait, and GetUser.
3. ⚡ Commands & Events – Easy setup with cooldowns, permissions, logging, and anti-crash.
4. 🌐 Dashboard – Web-based control panel for managing your bot.

🎯 STARTER

The starter function is the ultimate initializer for your Discord bot 🤖. It handles everything from logging in, loading commands/events, setting the bot presence, anti-crash protection, logging commands usage, and even checking for library updates.

Features:

• 🛠️ One-line loader for both Slash & Prefix commands 🔩
• 📜 Comprehensive terminal info display (commands, events, bot stats) 📊
• 🧰 Event handler loader in one line 🎉
• ⚠️ Anti-crash system with automatic webhook reporting 📃
• 🔋 MongoDB connection support 📥
• 📑 Command logger for both Slash and Prefix commands 🧭
• 💡 Supports custom prefixes per guild and cooldowns ⏳
• 🔼 Automatic update checker for djs-builder 📦

💡 Tip: Any option you don’t want, just remove it 🗑️.

const { starter } = require("djs-builder");
const { Client, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: Object.keys(GatewayIntentBits).map((a) => GatewayIntentBits[a]),
});

// Define starter options
const starterOptions = {
  bot: {
    token: "YOUR_BOT_TOKEN", // 🔑 Discord bot token
    ownerId: "YOUR_USER_ID", // 👤 Bot owner ID
  },
  terminal: true, // 🖥️ Show bot info in terminal

  Status: {
    status: "online", // ✅ Presence state: online, dnd, idle, offline
    activities: ["Game 1", "Game 2"], // 🎮 Multiple activities
    type: 0, // 🎭 Activity type: (0=PLAYING, 1=STREAMING, 2=LISTENING, 3=WATCHING)
    time: 60000, // ⏱️ Rotate activities every X ms
    url: "https://twitch.tv/example", // 🌐 Twitch URL (only required for streaming)
  },

  database: {
    url: "mongodb://localhost:27017", // 💾 MongoDB connection
    dbName: "yourDatabaseName", // 📁 Optional: Specify database name (default: "test")
  },

  anticrash: {
    url: "https://your.crash.webhook.url", // 🚨 Webhook for crash reports
    mention_id: "YOUR_USER_ID", // 📣 Optional: mention user on crash
  },

  // 🌐 Dashboard Configuration (Full docs at the end of this page)
  dashboard: {
    clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL (OPTINAL)
    sessionSecret: "your-super-secret-key", // 🔒 Session encryption secret
    port: 3000, // 🌍 Dashboard port (OPTINAL / default: 3000)
  },
};

// Start the bot
await starter(client, starterOptions);

📌 How Starter Works

1️⃣ Bot Login & Status

• Authenticates the bot using your token 🔑.
• Supports multiple rotating activities (e.g., Game 1 → Game 2 → …) ⏱️.
• Works with all Discord activity types: PLAYING, STREAMING, LISTENING, WATCHING 🎭.
• Twitch URL is supported for streaming mode 🌐.

2️⃣ Database Connection

• Connects automatically to MongoDB 💾.
• Useful for bots with persistent data storage.
• Specify the database name using the dbName option. If not specified, MongoDB uses "test" as the default database name.

3️⃣ Anticrash System

• Catches and logs:

  • unhandledRejection
  • uncaughtException
  • uncaughtExceptionMonitor
  • unhandledRejectionMonitor
  • warning ⚠️

• Sends error reports to a webhook 🚨.

• Optionally pings the owner 📣.

4️⃣ Terminal Info

• Displays colorful and structured information 🖥️:

  • Bot name, user, guild, and channel counts 📊.
  • Owner ID 👤.
  • Database connection status 💾.
  • Uptime ⏳.

• Powered by cli-table3 + chalk for a professional CLI look 🎨.

5️⃣ Auto Update Checker

• Monitors new versions of djs-builder automatically 🔄.
• Sends update notifications to the webhook 🎉.

6️⃣ Bot Files Information

• Access detailed stats about loaded files directly from the client:

  • Number of prefix commands ⚡.
  • Number of slash commands ⚔️.
  • Number of events 🎉.

• Available via client.files, useful for debugging or terminal display 🛠️.

7️⃣ Dashboard (Web Control Panel)

• Launches a modern web-based control panel for your bot 🌐.
• Supports Discord OAuth2 authentication 🔐.
• Manage servers, levels, giveaways, and blacklists from the browser 🎛️.

📖 Full Dashboard documentation available at the end of this page → 🌐 DASHBOARD

💡 Tips

• Flexible: Delete any section you don’t need (anticrash, database, etc.) 🗑️.
• Multi-Status: Add as many activities as you want and let them rotate 🎮.
• Safe by Default: Anticrash system ensures your bot won’t go down easily 🛡️.
• Always Up-to-Date: Automatic update checker keeps your bot running on the latest version ⬆️.
• Transparent: Quickly check how many files your bot has loaded anytime 📊.

⚙️ functions

• Easiest ✨ / Fastest ⚡ /Clear 🧵

Than the discord.js

🔵 CreateRow – Easily create Discord Action Rows with Buttons & Select Menus ✨

CreateRow is a powerful utility to build Discord Action Rows. It supports:

• Buttons ✅
• Select Menus 🎯 (string, role, user, channel)
• Advanced options like defaultValues and channelTypes.

📌 Example Usage:

const { CreateRow } = require("djs-builder");

const actionRow = new CreateRow([
  //// For each new row, use [] for buttons or {} for a select menu

  // 🔹 Row #1: Buttons
  [
    {
      id: "button1", // customId for the button
      style: 1, // Button styles: Primary(1), Secondary(2), Success(3), Danger(4), Link(5)
      label: "Primary Button", // Text shown on button
      emoji: "😃", // Emoji displayed
      disabled: false, // true = disabled
    },
    {
      id: "button2",
      style: 2,
      emoji: "🚀",
      disabled: true, // Button is disabled
    },
    {           
      style: 5,
      label: "link",
      emoji: "🔗" 
      url : "https://discord.gg/z9GpYsYF" // for url button
    }
  ],

  // 🔹 Row #2: Select Menu
  {
    type: "string", // Options: "string" | "role" | "user" | "channel"
    options: {
      id: "menu1", // customId for the select menu
      placeholder: "Select an option",
      min: 1, // Minimum selection
      max: 2, // Maximum selection

      // 🔸 Data for string select only
      data: [
        {
          name: "Option 1",
          id: "opt1",
          about: "First option",
          icon: "🌟",
          default: true,
        },
        { name: "Option 2", id: "opt2", about: "Second option", icon: "🚀" },
        { name: "Option 3", id: "opt3", about: "Third option", icon: "🔗" },
      ],

      // 🔸 Map keys
      label: "name", // Which field is the label
      value: "id", // Which field is the value
      description: "about", // Description for each option
      emoji: "icon", // Emoji for each option

      // 🔸 Extra options
      disabled: false, // Disable the entire menu
      defaultValues: [
        // For role/user/channel menus
        { id: "123456789012345678" }, // Pre-selected
      ],
      channelTypes: [0, 2], // Only for ChannelSelectMenu (0 = Text, 2 = Voice)
    },
  },
]);

📖 Explanation

🔹 Buttons

• id → customId for the button
• style → 1: Primary, 2: Secondary, 3: Success, 4: Danger, 5: Link
• label → Button text
• emoji → Displayed emoji
• disabled → true = button is unclickable
• url → requiier for like button (style : 5)

🔹 Select Menus

• type → "string" | "user" | "role" | "channel"

• id → customId for menu

• placeholder → Text shown before selection

• min / max → Min/Max selectable values

• data → Options array (for string select only)

  • label → Visible text
  • value → Internal value
  • description → Short description
  • emoji → Option emoji
  • default → Pre-selected option

• disabled → Disable menu completely

• defaultValues → Pre-selected user/role/channel options

• channelTypes → Restrict selectable channel types

🧾 CreateBar – Text-based Progress Bar for Discord ✨

CreateBar allows you to display a customizable progress bar with optional percentages and partial symbols. Perfect for showing progress, loading, or stats in messages.

📌 Basic Example:

const { CreateBar } = require("djs-builder");

const bar = new CreateBar(7, 10, {
  length: 20, // Total length of the bar
  fill: "💚", // Filled portion
  empty: "🖤", // Empty portion
  partialChar: "💛", // Partial fill
  showPercent: true, // Show percentage
  left: "❰", // Left bracket
  right: "❱", // Right bracket
});

console.log(bar);
// Output: ❰💚💚💚💚💚💚💚💛🖤🖤🖤🖤🖤🖤🖤🖤🖤🖤❱ 70%

📌 Another Example with different symbols:

console.log(
  CreateBar(3.7, 5, {
    fill: "🟦",
    empty: "⬛",
    partialChar: "🟨",
    length: 10,
    left: "❰",
    right: "❱",
    showPercent: true,
  })
);

// Output: ❰🟦🟦🟦🟨⬛⬛⬛⬛⬛⬛❱ 74%

📌 Minimalist example without percentage:

console.log(
  CreateBar(4, 8, {
    fill: "🔵",
    empty: "⚪",
    showPercent: false,
  })
);

// Output: 🔵🔵🔵🔵⚪⚪⚪⚪

📌 Fun Emoji example:

console.log(
  CreateBar(6, 10, {
    length: 12,
    fill: "🔥",
    empty: "❄️",
    partialChar: "🌟",
    showPercent: true,
    left: "«",
    right: "»",
  })
);

// Output: «🔥🔥🔥🔥🔥🔥🌟❄️❄️❄️❄️» 60%

🔹 Options Summary

• length → Total number of symbols
• fill → Symbol for filled portion
• empty → Symbol for empty portion
• partialChar → Symbol for partial fill (e.g., half-filled)
• showPercent → Show percentage at the end
• left / right → Brackets or edges for the bar

🔹 Notes

• Supports fractional values for partial fill
• Fully customizable with any emoji or character 🎨
• Great for progress, stats, experience bars, or loading indicators

🔳 CreateModal – Easily create Discord Modals with Text Inputs, Menus, Files, and Labels ✨

CreateModal is a powerful utility to build Discord Modals. It supports:

• Text Inputs 📝
• Select Menus 🎯 (string, role, user, channel)
• File Uploads 📎
• Text Displays 🏷️

📌 Example Usage:

const { CreateModal } = require("djs-builder");

const modal = CreateModal({
  id: "myModal",
  title: "User Information",
  components: [
    {
      type: "textInput",
      components: [
        {
          label: "Your Name",
          id: "name",
          style: 1, // 1: Short, 2: Paragraph
          placeholder: "Enter your name",
          required: true,
          minLength: 2,
          maxLength: 50,
        },
      ],
    },
    {
      type: "menu",
      components: {
        type: "string",
        options: {
          id: "favoriteColor",
          placeholder: "Choose your favorite color",
          min: 1,
          max: 1,
          data: [
            {
              label: "Red",
              value: "red",
              description: "A bold color",
              emoji: "🔴",
              default: false,
            },
            {
              label: "Blue",
              value: "blue",
              description: "A calm color",
              emoji: "🔵",
            },
          ],
          label: "label",
          value: "value",
          description: "description",
          emoji: "emoji",
          disabled: false,
        },
      },
    },
    {
      type: "file",
      components: {
        id: "avatar",
        label: "Upload Avatar",
        description: "Optional avatar image",
      },
    },
    {
      type: "label",
      components: {
        label: "Thank you for your input!",
      },
    },
  ],
});

// Show the modal
await interaction.showModal(modal);

📔 Examples for Each Component Type:

🔹 Text Input Example:

{
  type: "textInput",
  components: [
    {
      label: "Your Age",
      id: "age",
      style: 1, // Short input
      placeholder: "Enter your age",
      required: true,
      minLength: 1,
      maxLength: 3,
      value: "18", // Pre-filled
    },
  ],
},

🔹 Menu Example:

{
  type: "menu",
  components: {
    type: "string",
    options: {
      id: "country",
      placeholder: "Select your country",
      min: 1,
      max: 1,
      data: [
        {
          name: "USA",
          id: "usa",
          desc: "United States",
          icon: "🇺🇸",
          default: true, // This option is pre-selected
        },
        {
          name: "Canada",
          id: "canada",
          desc: "Canada",
          icon: "🇨🇦",
        },
      ],
      label: "name", // Maps to 'name' field in data
      value: "id",   // Maps to 'id' field in data
      description: "desc", // Maps to 'desc' field
      emoji: "icon", // Maps to 'icon' field
      disabled: false,
    },
  },
},

🔹 File Example:

{
  type: "file",
  components: {
    id: "document",
    label: "Upload Document",
    description: "Upload a PDF or image",
  },
},

🔹 Label Example:

{
  type: "label",
  components: {
    label: "Please fill out the form above.",
  },
},

�📖 Explanation

🔹 Text Input

• label → Label for the input field
• id → customId for the input
• style → 1: Short, 2: Paragraph
• placeholder → Placeholder text
• required → true/false
• minLength / maxLength → Min/Max characters
• value → Pre-filled value

🔹 Menu

Same as CreateRow select menus.

• type → "string" | "user" | "role" | "channel"

• id → customId for menu

• placeholder → Text shown before selection

• min / max → Min/Max selectable values

• data → Options array (for string select only)

  • label → Visible text (maps to the field specified in label key)
  • value → Internal value (maps to the field specified in value key)
  • description → Short description (maps to the field specified in description key)
  • emoji → Option emoji (maps to the field specified in emoji key)
  • default → Pre-selected option (true/false in data array)

• label → Key in data to use as label (e.g., "name")

• value → Key in data to use as value (e.g., "id")

• description → Key in data to use as description (e.g., "desc")

• emoji → Key in data to use as emoji (e.g., "icon")

• disabled → Disable menu completely

• defaultValues → Pre-selected user/role/channel options (for non-string menus)

• channelTypes → Restrict selectable channel types (for channel menu)

🔹 File

• id → customId for the file upload
• label → Label
• description → Description

🔹 Label

• label → Text to display

🔹 Notes

• Supports multiple components in one modal
• Fully customizable with Discord.js ModalBuilder

🧩 CreateComponents – Build Advanced Discord UI Components with Containers, Sections & Media ✨

CreateComponents is a powerful utility to build Discord's new UI components. It supports:

• Text Displays 📝
• Separators ➖
• Media Galleries 🖼️
• File Attachments 📎
• Buttons 🔘
• Select Menus 🎯 (string, role, user, channel)
• Sections with Accessories 📦 (Thumbnails & Buttons)
• Containers 📦 (Group all components together)

📌 Example Usage (Array Mode):

const { CreateComponents } = require("djs-builder");

const components = await CreateComponents("array", [
  {
    type: "text",
    content: "Welcome to our server! 🎉",
  },
  {
    type: "separator",
    divider: true,
    spacing: 1, // 1: Small, 2: Large
  },
  {
    type: "media",
    links: [
      "https://example.com/image1.png",
      {
        url: "https://example.com/image2.png",
        description: "A cool image",
        spoiler: true,
      },
    ],
  },
  {
    type: "button",
    components: [
      {
        id: "btn_1",
        style: 1, // 1: Primary, 2: Secondary, 3: Success, 4: Danger, 5: Link
        label: "Click Me!",
        emoji: "🚀",
      },
      {
        id: "btn_2",
        style: 3,
        label: "Confirm",
      },
    ],
  },
]);

// Send the components
await channel.send({ components });

📌 Example Usage (Container Mode):

const { CreateComponents } = require("djs-builder");

const components = await CreateComponents("container", [
  {
    type: "text",
    content: "# 📢 Server Announcement\nWelcome everyone!",
  },
  {
    type: "separator",
    divider: true,
  },
  {
    type: "section",
    content: "Check out our latest updates and news!",
    accessory: {
      type: "thumbnail",
      url: "https://example.com/thumbnail.png",
      description: "News Image",
    },
  },
  {
    type: "section",
    content: "**Click below to get your roles!**",
    accessory: {
      type: "button",
      id: "get_roles",
      style: 1,
      label: "Get Roles",
      emoji: "🎭",
    },
  },
  {
    type: "media",
    links: ["https://example.com/banner.png"],
  },
  {
    type: "button",
    components: [
      { id: "rules", style: 2, label: "📜 Rules", emoji: "📜" },
      { id: "help", style: 2, label: "❓ Help", emoji: "❓" },
      { style: 5, label: "🌐 Website", url: "https://example.com" },
    ],
  },
]);

// Send with container
await channel.send({ components, flags: 32768 }); // flags for components v2

📜 Examples for Each Component Type:

📌 Simple Text:

{
  type: "text",
  content: "Hello World! 👋",
}

📌 Text with Markdown:

{
  type: "text",
  content: "# 📢 Announcement\n**Important:** Server maintenance tonight!",
}

📌 Text with Multiple Lines:

{
  type: "text",
  content: `## 🎮 Game Stats
  
**Player:** Ahmed
**Level:** 50
**XP:** 12,500 / 15,000
**Rank:** Diamond 💎`,
}

📌 Text with Emojis & Formatting:

{
  type: "text",
  content: ">>> 💡 **Tip:** Use `/help` to see all commands!\n\n*This message will auto-delete in 30 seconds*",
}

➖ Separator – Add spacing and dividers between components

The separator component allows you to add visual breaks between other components with customizable spacing and divider lines.

📖 Separator Options

| Option | Type | Default | Description | | --------- | --------- | ------- | -------------------------------------------------- | | type | string | — | Must be "separator" | | divider | boolean | false | Show a horizontal dividing line | | spacing | number | 1 | Spacing size: 1 (Small) or 2 (Large) |

📌 Simple Divider Line:

{
  type: "separator",
  divider: true,
}

Result: A thin horizontal line appears between components.

📌 Separator without Line (Spacing Only):

{
  type: "separator",
  divider: false,
  spacing: 2, // Large spacing
}

Result: Empty space without any visible line - useful for visual grouping.

📌 Small Spacing with Divider:

{
  type: "separator",
  divider: true,
  spacing: 1, // Small spacing (default)
}

Result: A divider line with minimal padding above and below.

📌 Large Spacing with Divider:

{
  type: "separator",
  divider: true,
  spacing: 2, // Large spacing
}

Result: A divider line with more padding - creates stronger visual separation.

💡 When to Use Each Option:

| Scenario | divider | spacing | | ------------------------------------- | --------- | --------- | | Separate major sections | true | 2 | | Separate sub-sections | true | 1 | | Group related items visually | false | 1 | | Create breathing room between content | false | 2 | | Minimal separation | false | 1 |

🖼️ Media Gallery – Display images in a beautiful gallery format

The media component creates an image gallery that can display one or multiple images. Each image can be a simple URL string or a detailed object with additional options.

📌 Format 1: Simple String URLs

The simplest way - just pass image URLs as strings:

{
  type: "media",
  links: ["https://example.com/image.png"],
}

📌 Format 2: Object with Full Options

For more control, use objects with url, description, and spoiler:

{
  type: "media",
  links: [
    {
      url: "https://example.com/image.png",
      description: "A beautiful sunset",
      spoiler: false,
    },
  ],
}

📌 Single Image with Spoiler:

{
  type: "media",
  links: [
    {
      url: "https://example.com/spoiler.png",
      description: "⚠️ Spoiler Alert!",
      spoiler: true,
    },
  ],
}

📌 Multiple Images (Simple Strings):

{
  type: "media",
  links: [
    "https://example.com/image1.png",
    "https://example.com/image2.png",
    "https://example.com/image3.png",
    "https://example.com/image4.png",
  ],
}

Result: A 2x2 gallery grid of images.

📌 Mixed Format (Strings + Objects):

You can mix simple strings with detailed objects in the same array:

{
  type: "media",
  links: [
    // Simple string - just the URL
    "https://example.com/public-image.png",
    
    // Object with description
    {
      url: "https://example.com/special-image.png",
      description: "Limited Edition Art",
    },
    
    // Object with spoiler
    {
      url: "https://example.com/secret-image.png",
      description: "Secret Content",
      spoiler: true,
    },
    
    // Another simple string
    "https://example.com/another-image.png",
  ],
}

📌 Meme/Artwork Gallery with Spoilers:

{
  type: "media",
  links: [
    {
      url: "https://example.com/meme1.png",
      description: "Funny meme #1",
      spoiler: false,
    },
    {
      url: "https://example.com/meme2.png",
      description: "Funny meme #2",
      spoiler: false,
    },
    {
      url: "https://example.com/nsfw-meme.png",
      description: "⚠️ Slightly inappropriate",
      spoiler: true, // Hidden behind blur
    },
  ],
}

💡 Tips for Media Galleries:

| Images Count | Display Layout | | ------------ | ---------------------- | | 1 image | Full width single image | | 2 images | Side by side | | 3 images | 1 large + 2 small | | 4+ images | Grid layout |

• Use description for accessibility and context
• Use spoiler: true for sensitive/spoiler content
• Mix formats freely - strings for quick images, objects for detailed ones
• Images are displayed in the order provided

📌 Simple File Attachment:

{
  type: "file",
  url: "attachment://document.pdf",
}

📌 Full Example with File:

const { CreateComponents } = require("djs-builder");
const { AttachmentBuilder } = require("discord.js");

const file = new AttachmentBuilder("./myfile.txt", { name: "myfile.txt" });

const components = await CreateComponents("container", [
  {
    type: "text",
    content: "📄 **Here is your requested file:**",
  },
  {
    type: "file",
    url: "attachment://myfile.txt",
  },
]);

await channel.send({ components, files: [file], flags: 32768 });

📌 Button with Emoji:

{
  type: "button",
  components: [
    {
      id: "like_btn",
      style: 3, // Success (Green)
      label: "Like",
      emoji: "👍",
    },
  ],
}

📌 Multiple Buttons in Row:

{
  type: "button",
  components: [
    { id: "btn_yes", style: 3, label: "Yes", emoji: "✅" },
    { id: "btn_no", style: 4, label: "No", emoji: "❌" },
    { id: "btn_maybe", style: 2, label: "Maybe", emoji: "🤔" },
  ],
}

📌 All Button Styles:

{
  type: "button",
  components: [
    { id: "primary", style: 1, label: "Primary", emoji: "🔵" },    // Blue
    { id: "secondary", style: 2, label: "Secondary", emoji: "⚪" }, // Gray
    { id: "success", style: 3, label: "Success", emoji: "🟢" },    // Green
    { id: "danger", style: 4, label: "Danger", emoji: "🔴" },      // Red
    { style: 5, label: "Link", emoji: "🔗", url: "https://discord.com" }, // Link
  ],
}

📌 String Select Menu (Basic):

{
  type: "menu",
  components: {
    type: "string",
    options: {
      id: "color_select",
      placeholder: "🎨 Choose a color",
      data: [
        { name: "Red", id: "red", icon: "🔴" },
        { name: "Blue", id: "blue", icon: "🔵" },
        { name: "Green", id: "green", icon: "🟢" },
      ],
      label: "name",
      value: "id",
      emoji: "icon",
    },
  },
}

📌 String Select with Description:

{
  type: "menu",
  components: {
    type: "string",
    options: {
      id: "role_select",
      placeholder: "🎭 Select your role",
      data: [
        { name: "Gamer", id: "gamer", desc: "For gaming enthusiasts", icon: "🎮" },
        { name: "Artist", id: "artist", desc: "For creative people", icon: "🎨" },
        { name: "Developer", id: "dev", desc: "For coders & programmers", icon: "💻" },
        { name: "Music Lover", id: "music", desc: "For music fans", icon: "🎵" },
      ],
      label: "name",
      value: "id",
      description: "desc",
      emoji: "icon",
    },
  },
}

📌 String Select with Min/Max:

{
  type: "menu",
  components: {
    type: "string",
    options: {
      id: "games_select",
      placeholder: "🎮 Select your favorite games (2-4)",
      min: 2,
      max: 4,
      data: [
        { name: "Minecraft", id: "mc", icon: "⛏️" },
        { name: "Fortnite", id: "fn", icon: "🔫" },
        { name: "Valorant", id: "val", icon: "🎯" },
        { name: "League of Legends", id: "lol", icon: "⚔️" },
        { name: "Rocket League", id: "rl", icon: "🚗" },
      ],
      label: "name",
      value: "id",
      emoji: "icon",
    },
  },
}

📌 User Select (Multiple):

{
  type: "menu",
  components: {
    type: "user",
    options: {
      id: "users_select",
      placeholder: "👥 Select users to invite (1-5)",
      min: 1,
      max: 5,
    },
  },
}

📌 Role Select Menu:

{
  type: "menu",
  components: {
    type: "role",
    options: {
      id: "role_select",
      placeholder: "🎭 Select a role",
      min: 1,
      max: 1,
    },
  },
}

📌 Channel Select Menu:

{
  type: "menu",
  components: {
    type: "channel",
    options: {
      id: "channel_select",
      placeholder: "📢 Select a channel",
      min: 1,
      max: 1,
    },
  },
}

📌 Channel Select with Type Filter:

const { ChannelType } = require("discord.js");

{
  type: "menu",
  components: {
    type: "channel",
    options: {
      id: "text_channel_select",
      placeholder: "💬 Select a text channel",
      channelTypes: [ChannelType.GuildText, ChannelType.GuildAnnouncement],
    },
  },
}

📌 Menu with Default Values (User/Role/Channel):

{
  type: "menu",
  components: {
    type: "user",
    options: {
      id: "user_select_default",
      placeholder: "👤 Select users",
      min: 1,
      max: 3,
      defaultValues: [
        { id: "123456789012345678", type: "user" },
        { id: "987654321098765432", type: "user" },
      ],
    },
  },
}

📌 Section with Thumbnail (Product):

{
  type: "section",
  content: "🛒 **iPhone 15 Pro**\n💰 Price: $999\n⭐ Rating: 4.8/5\n📦 In Stock: Yes",
  accessory: {
    type: "thumbnail",
    url: "https://example.com/iphone.png",
    description: "iPhone 15 Pro Image",
  },
}

📌 Section with Button :

{
  type: "section",
  content: "🎁 **Daily Reward**\nClick to claim your daily reward!\n💎 **+100 Coins**",
  accessory: {
    type: "button",
    id: "claim_daily",
    style: 3, 
    label: "Claim",
    emoji: "🎁",
  },
}

📖 Component Types Explanation

🔹 Text

• type → "text"
• content → The text content to display (supports Markdown)

🔹 Separator

• type → "separator"
• divider → Show a dividing line (true/false)
• spacing → Spacing size (1: Small, 2: Large)

🔹 Media Gallery

• type → "media"
• links → Array of image URLs or objects with:
  • url → Image URL
  • description → Alt text for the image
  • spoiler → Hide behind spoiler (true/false)

🔹 File

• type → "file"
• url → File URL or attachment reference
• spoiler → Hide behind spoiler (true/false)

🔹 Button

• type → "button"
• components → Array of button objects:
  • id → customId (required for non-link buttons)
  • style → 1: Primary, 2: Secondary, 3: Success, 4: Danger, 5: Link
  • label → Button text
  • emoji → Button emoji
  • disabled → Disable button (true/false)
  • url → URL for link buttons (style: 5)

🔹 Menu

• type → "menu"
• components → Object containing:
  • type → "string" | "user" | "role" | "channel"
  • options → Menu configuration:
    • id → customId
    • placeholder → Placeholder text
    • min / max → Min/Max selectable values
    • data → Options array (for string select)
    • label → Key in data for label
    • value → Key in data for value
    • emoji → Key in data for emoji
    • description → Key in data for description
    • channelTypes → Channel types filter (for channel menu)
    • defaultValues → Pre-selected values

🔹 Section

• type → "section"
• content → Text content for the section
• accessory → Side component:
  • Button Accessory:
    • type → "button"
    • id → customId
    • style → Button style
    • label → Button text
    • emoji → Button emoji
    • url → URL (for link buttons)
  • Thumbnail Accessory:
    • type → "thumbnail"
    • url → Image URL
    • description → Image description

🔹 Mode Differences

| Feature | "array" Mode | "container" Mode | | ---------------- | ----------------------- | ------------------------- | | Return Type | Array of components | Single ContainerBuilder | | Usage | Standard messages | Components V2 messages | | Sections Support | ✅ | ✅ | | Grouping | Individual components | All grouped in container | | Flags Required | ❌ | ✅ (flags: 32768) |

🔹 Notes

• Use "container" mode for Discord's Components V2 (newer UI)
• Use "array" mode for standard component arrays
• Sections can have either a button or thumbnail as accessory, not both
• Media galleries support multiple images in a single component
• All components are fully customizable 🎨

⏰ Wait – Await messages, buttons, select menus or modals easily ✨

Wait is a replacement for traditional collectors. It supports:

• Awaiting messages 📝
• Awaiting interactions (buttons / select menus) 🎛️
• Awaiting modal submissions 📋
• Filtering by user and timeout

📌 Example Usage:

const { Wait } = require("djs-builder");

const response = await Wait({
  context: message, // Message or Interaction object
  userId: message.author.id, // Optional: filter by user
  type: "both", // "message" | "interaction" | "both"
  time: 30000, // Time in ms
  message_Wait: message, // Required if waiting for buttons/selects
});

if (!response) return console.log("⏱️ Timeout!");
console.log("✅ Collected:", response);

🔹 Options

• context → The message or interaction context
• userId → Only collect from this user (optional)
• type → "message" | "interaction" | "both"
• time → Timeout in milliseconds
• message_Wait → Message containing buttons/select menus (for interaction/both type)

🔹 Notes

• Supports automatic cleanup of collectors after completion
• Can return Message, Interaction, or ModalSubmitInteraction

👤 GetUser – Fetch a GuildMember easily from a message ✨

GetUser helps to detect a target member in multiple ways:

1. Mention (@User)
2. User ID (123456789012345678)
3. Reply to another message

📌 Example Usage:

const { GetUser } = require("djs-builder");

const data = await GetUser(message);

if (!data) return message.reply("❌ Could not find the user.");

const member = data.user; // GuildMember object
const args = data.args; // Remaining arguments
const reason = args.join(" ") || "No reason provided";

await member.ban({ reason });
message.reply(`🚫 ${member.user.tag} was banned for: ${reason}`);

🔹 Returns

{
  user: <GuildMember>,  // Targeted member
  args: [ "arg1", "arg2" ] // Remaining message arguments
}

🔹 Detection Methods

• Mention: !ban @Ahmed Spamming
• User ID: !ban 123456789012345678 Spamming
• Reply: Reply to user's message with !ban

🔹 Notes

• Automatically handles missing users
• Returns null if user not found
• Works in any text channel of the guild

🛡️ Logging System – Track Everything in Your Server

The Logging System is a powerful feature that keeps track of almost everything happening inside your Discord server 🔍.
From messages 📝 to channels 📂, roles 🎭, invites 🔗, and even voice state changes 🎙️ – nothing goes unnoticed!

Note 1: Using database: true requires a MongoDB connection. | Note 2: You can import the Log model for direct database access 💾.

📦 Module Exports

const { log, Log } = require("djs-builder");

• log(client, options) → Start the logging system with your configuration 🚀.
• Log → The Mongoose model for direct database access and custom modifications 💾.

📋 Simple Example

const { log } = require("djs-builder");

module.exports = {
  name: "clientReady",
  async run(client) {
    const logData = [
      {
        guildId: "999888777666555444",
        channelId: "444555666777888999",
      },

          {
        guildId: "999888777666555444",
        channelId: "444555666777888999",
      },
    ];

    // Start logging with custom data
    await log(client, {
      Data: logData, // 📊 Your configurations
    });

    console.log("✅ Logging system started with custom data!");
  },
};

✨ Features

• 📝 Messages – Deleted & edited messages are logged with details.
• 📂 Channels – Creation, deletion, and updates are tracked.
• 🎭 Roles – Created, deleted, and updated roles, including member role changes.
• 🎙️ Voice State – Joins, leaves, and moves between channels.
• 🔗 Invites – Created invites & usage tracking.
• 😀 Emojis & Stickers – Added, removed, or updated.
• 👤 Members – Join, leave, kick, ban, and unban events.
• 🚨 Audit Log Integration – Fetches the executor (who did what).
• 🎨 Beautiful Embeds – Every log is shown in a clean, styled embed with timestamps.
• 🗄️ Caching System – Fast performance with built-in data caching.

📊 Database Schema

The logging system uses the following data structure:

{
  guildId: String,      // 🏠 Server ID (required)
  channelId: String,    // 📢 Default log channel ID
  channels: Object,     // 📂 Custom channels per event type (optional)
  colors: Object,       // 🎨 Custom colors per event type (optional)
  disable: Array,       // 🚫 Array of disabled event types (optional)
}

📋 Supported Event Types

| Event Type | Description | | ------------------- | ------------------------- | | messageDelete | Message deleted 📝 | | messageUpdate | Message edited ✏️ | | channelCreate | Channel created 📁 | | channelDelete | Channel deleted 🗑️ | | channelUpdate | Channel updated ⚙️ | | guildMemberAdd | Member joined 🎉 | | guildMemberRemove | Member left/kicked 🚪 | | guildBanAdd | Member banned 🔨 | | guildBanRemove | Member unbanned 🤗 | | roleCreate | Role created 🏅 | | roleDelete | Role deleted ❌ | | roleUpdate | Role updated 🔄 | | guildMemberUpdate | Member roles changed 👤 | | voiceStateUpdate | Voice channel activity 🎤 | | inviteCreate | Invite created 🔗 | | emojiCreate | Emoji added 😀 | | emojiDelete | Emoji removed 🚫 | | emojiUpdate | Emoji updated 🔄 | | stickerCreate | Sticker added ✨ | | stickerDelete | Sticker removed 🗑️ | | stickerUpdate | Sticker updated 🌀 |

🗄️ Using MongoDB Database

This method stores log configuration in MongoDB, allowing dynamic management via commands.

⚡ Setup in clientReady Event:

const { log } = require("djs-builder");

module.exports = {
  name: "clientReady",
  async run(client) {
    // Start logging with database mode
    await log(client, {
      database: true, // 🗄️ Uses MongoDB to store/fetch config
    });

    console.log("✅ Logging system started with database mode!");
  },
};

💡 How It Works

• ✅ The system automatically fetches log configuration for each guild from MongoDB.
• 🛠️ You can manage settings via slash commands (see management command below).
• 🎨 Supports per-guild customization for channels, colors, and disabled events.
• 📖 Important: If you use database mode, see the Log Management Command below to edit data.

📋 Using Custom Data Array

This method uses a predefined array of configurations – perfect for simple setups or testing.

⚡ Setup in clientReady Event:

const { log } = require("djs-builder");

module.exports = {
  name: "clientReady",
  async run(client) {
    // Define your log configurations
    const logData = [
      {
        guildId: "123456789012345678", // 🏠 Server ID
        channelId: "987654321098765432", // 📢 Default log channel
        channels: {
          // 📂 Custom channels (optional)
          messageDelete: "111111111111111111",
          voiceStateUpdate: "222222222222222222",
        },
        colors: {
          // 🎨 Custom colors (optional)
          messageDelete: "DarkRed",
          channelCreate: "DarkGreen",
        },
        disable: ["inviteCreate"], // 🚫 Disabled events (optional)
      },
      // Add more guild configurations...
      {
        guildId: "999888777666555444",
        channelId: "444555666777888999",
      },
    ];

    // Start logging with custom data
    await log(client, {
      database: false, // 📋 Uses custom array
      Data: logData, // 📊 Your configurations
    });

    console.log("✅ Logging system started with custom data!");
  },
};

🎨 Supported Colors

Default, White, Aqua, Green, Blue, Yellow, Purple, LuminousVividPink, Fuchsia, Gold, Orange, Red, Grey, Navy, DarkAqua, DarkGreen, DarkBlue, DarkPurple, DarkVividPink, DarkGold, DarkOrange, DarkRed, DarkGrey, DarkerGrey, LightGrey, DarkNavy, Blurple, Greyple, DarkButNotBlack, NotQuiteBlack, Random, or any Hex Color like #FF5733.

🌐 Multi-Guild Support

💡 Tip: You can add configurations for multiple guilds in the same array. Each guild can have its own unique settings for channels, colors, and disabled events!

💾 Using the Log Model Directly

You can import the Log Mongoose model to create, update, or delete log configurations programmatically.

📥 Import the Model:

const { Log } = require("djs-builder");

➕ Create New Configuration:

const { Log } = require("djs-builder");

// Create a new log configuration for a guild
const newConfig = await Log.create({
  guildId: "123456789012345678",
  channelId: "987654321098765432",
  channels: {
    messageDelete: "111111111111111111",
  },
  colors: {
    messageDelete: "Red",
  },
  disable: [],
});

console.log("✅ Log configuration created!", newConfig);

✏️ Update Existing Configuration:

const { Log } = require("djs-builder");

// Update log channel
await Log.findOneAndUpdate(
  { guildId: "123456789012345678" },
  { channelId: "NEW_CHANNEL_ID" },
  { upsert: true } // Create if doesn't exist
);

// Add event to disable list
await Log.findOneAndUpdate(
  { guildId: "123456789012345678" },
  { $push: { disable: "voiceStateUpdate" } }
);

// Remove event from disable list
await Log.findOneAndUpdate(
  { guildId: "123456789012345678" },
  { $pull: { disable: "voiceStateUpdate" } }
);

// Update specific channel for an event
await Log.findOneAndUpdate(
  { guildId: "123456789012345678" },
  { $set: { "channels.messageDelete": "NEW_CHANNEL_ID" } }
);

// Update specific color for an event
await Log.findOneAndUpdate(
  { guildId: "123456789012345678" },
  { $set: { "colors.messageDelete": "DarkRed" } }
);

🗑️ Delete Configuration:

const { Log } = require("djs-builder");

await Log.findOneAndDelete({ guildId: "123456789012345678" });
console.log("🗑️ Log configuration deleted!");

📊 Fetch Configuration:

const { Log } = require("djs-builder");

const config = await Log.findOne({ guildId: "123456789012345678" });
if (config) {
  console.log("📢 Log Channel:", config.channelId);
  console.log("📂 Custom Channels:", config.channels);
  console.log("🎨 Custom Colors:", config.colors);
  console.log("🚫 Disabled Events:", config.disable);
}

🖥️ Web Dashboard for Log Management

When you use database mode (database: true), you can manage the logging system directly from the djs-builder Dashboard! 🎛️

✨ Dashboard Features for Logs

| Feature | Description | | ---------------------- | -------------------------------------------- | | 📢 Default Channel | Set the main channel for all logs | | 📂 Custom Channels | Assign specific channels for each event type | | 🎨 Custom Colors | Choose embed colors for each event type | | 🔄 Toggle Events | Enable/Disable specific event types | | 📊 Statistics | View enabled/disabled events count | | 🗑️ Reset | Clear all log settings with one click |

🚀 How to Access

1. Navigate to your dashboard (e.g., http://localhost:3000)
2. Log in with Discord OAuth2
3. Select a server
4. Click on "سجلات المراقبة" (Logs) in the sidebar

⚠️ Important Notes

When database: true:

• ✅ Full editing capabilities from dashboard
• ✅ Changes are saved automatically to MongoDB
• ✅ Real-time updates

When database: false (Custom Data Array):

• ⚠️ Dashboard shows read-only mode
• ⚠️ A warning banner appears at the top
• ⚠️ You must edit settings in your code

🛠️ Complete Log Management Slash Command

This command allows server administrators to manage the logging system via Discord.

⚠️ Important: This command requires database: true mode to work properly.

const { Log, getLogConfigData } = require("djs-builder");
const {
  SlashCommandBuilder,
  PermissionFlagsBits,
  EmbedBuilder,
  ChannelType,
} = require("discord.js");

// All supported event types (21 events)
const EVENT_TYPES = [
  { name: "Message Delete", value: "messageDelete" },
  { name: "Message Update", value: "messageUpdate" },
  { name: "Channel Create", value: "channelCreate" },
  { name: "Channel Delete", value: "channelDelete" },
  { name: "Channel Update", value: "channelUpdate" },
  { name: "Member Join", value: "guildMemberAdd" },
  { name: "Member Leave", value: "guildMemberRemove" },
  { name: "Member Ban", value: "guildBanAdd" },
  { name: "Member Unban", value: "guildBanRemove" },
  { name: "Role Create", value: "roleCreate" },
  { name: "Role Delete", value: "roleDelete" },
  { name: "Role Update", value: "roleUpdate" },
  { name: "Member Role Update", value: "guildMemberUpdate" },
  { name: "Voice State", value: "voiceStateUpdate" },
  { name: "Invite Create", value: "inviteCreate" },
  { name: "Emoji Create", value: "emojiCreate" },
  { name: "Emoji Delete", value: "emojiDelete" },
  { name: "Emoji Update", value: "emojiUpdate" },
  { name: "Sticker Create", value: "stickerCreate" },
  { name: "Sticker Delete", value: "stickerDelete" },
  { name: "Sticker Update", value: "stickerUpdate" },
];

// Helper function to clear cache after updates
function clearLogCache(guildId) {
  const logData = getLogConfigData();
  if (logData.clearCache) logData.clearCache(guildId);
}

module.exports = {
  data: new SlashCommandBuilder()
    .setName("logs")
    .setDescription("🛡️ Manage the server logging system")
    .setDefaultMemberPermissions(PermissionFlagsBits.Administrator)
    .addSubcommand((sub) =>
      sub
        .setName("setup")
        .setDescription("📢 Set up the default log channel")
        .addChannelOption((opt) =>
          opt
            .setName("channel")
            .setDescription("The channel to send logs to")
            .addChannelTypes(ChannelType.GuildText)
            .setRequired(true)
        )
    )
    .addSubcommand((sub) =>
      sub
        .setName("channel")
        .setDescription("📂 Set a specific channel for an event type")
        .addStringOption((opt) =>
          opt
            .setName("event")
            .setDescription("The event type")
            .setRequired(true)
            .addChoices(...EVENT_TYPES)
        )
        .addChannelOption((opt) =>
          opt
            .setName("channel")
            .setDescription("The channel for this event")
            .addChannelTypes(ChannelType.GuildText)
            .setRequired(true)
        )
    )
    .addSubcommand((sub) =>
      sub
        .setName("color")
        .setDescription("🎨 Set a custom color for an event type")
        .addStringOption((opt) =>
          opt
            .setName("event")
            .setDescription("The event type")
            .setRequired(true)
            .addChoices(...EVENT_TYPES)
        )
        .addStringOption((opt) =>
          opt
            .setName("color")
            .setDescription("Color name or hex code (e.g., Red, #FF5733)")
            .setRequired(true)
        )
    )
    .addSubcommand((sub) =>
      sub
        .setName("toggle")
        .setDescription("🔄 Enable or disable an event type")
        .addStringOption((opt) =>
          opt
            .setName("event")
            .setDescription("The event type")
            .setRequired(true)
            .addChoices(...EVENT_TYPES)
        )
        .addStringOption((opt) =>
          opt
            .setName("action")
            .setDescription("Enable or disable")
            .setRequired(true)
            .addChoices(
              { name: "Enable", value: "enable" },
              { name: "Disable", value: "disable" }
            )
        )
    )
    .addSubcommand((sub) =>
      sub.setName("view").setDescription("📊 View current log configuration")
    )
    .addSubcommand((sub) =>
      sub
        .setName("reset")
        .setDescription("🗑️ Reset all log settings for this server")
    ),

  async run(client, interaction) {
    await interaction.deferReply({ ephemeral: true });

    const subcommand = interaction.options.getSubcommand();
    const guildId = interaction.guild.id;

    // ═══════════════════════════════════════════════════════
    // 📢 SETUP - Set default log channel
    // ═══════════════════════════════════════════════════════
    if (subcommand === "setup") {
      const channel = interaction.options.getChannel("channel");

      await Log.findOneAndUpdate(
        { guildId },
        { guildId, channelId: channel.id },
        { upsert: true, new: true }
      );

      clearLogCache(guildId); // Clear cache to apply changes immediately

      const embed = new EmbedBuilder()
        .setTitle("✅ Logging System Setup")
        .setDescription(`Logs will now be sent to ${channel}`)
        .setColor("Green")
        .setTimestamp();

      return interaction.editReply({ embeds: [embed] });
    }

    // ═══════════════════════════════════════════════════════
    // 📂 CHANNEL - Set specific channel for event
    // ═══════════════════════════════════════════════════════
    if (subcommand === "channel") {
      const event = interaction.options.getString("event");
      const channel = interaction.options.getChannel("channel");

      await Log.findOneAndUpdate(
        { guildId },
        { $set: { [`channels.${event}`]: channel.id } },
        { upsert: true }
      );

      clearLogCache(guildId);

      const eventName =
        EVENT_TYPES.find((e) => e.value === event)?.name || event;
      const embed = new EmbedBuilder()
        .setTitle("📂 Event Channel Updated")
        .setDescription(`**${eventName}** logs will now be sent to ${channel}`)
        .setColor("Blue")
        .setTimestamp();

      return interaction.editReply({ embeds: [embed] });
    }

    // ═══════════════════════════════════════════════════════
    // 🎨 COLOR - Set custom color for event
    // ═══════════════════════════════════════════════════════
    if (subcommand === "color") {
      const event = interaction.options.getString("event");
      const color = interaction.options.getString("color");

      await Log.findOneAndUpdate(
        { guildId },
        { $set: { [`colors.${event}`]: color } },
        { upsert: true }
      );

      clearLogCache(guildId);

      const eventName =
        EVENT_TYPES.find((e) => e.value === event)?.name || event;
      
      // Try to use the color, fallback to Blue if invalid
      let embedColor;
      try {
        embedColor = color;
      } catch {
        embedColor = "Blue";
      }

      const embed = new EmbedBuilder()
        .setTitle("🎨 Event Color Updated")
        .setDescription(
          `**${eventName}** embeds will now use color: \`${color}\``
        )
        .setColor(embedColor)
        .setTimestamp();

      return interaction.editReply({ embeds: [embed] });
    }

    // ═══════════════════════════════════════════════════════
    // 🔄 TOGGLE - Enable/Disable event
    // ═══════════════════════════════════════════════════════
    if (subcommand === "toggle") {
      const event = interaction.options.getString("event");
      const action = interaction.options.getString("action");

      if (action === "disable") {
        await Log.findOneAndUpdate(
          { guildId },
          { $addToSet: { disable: event } },
          { upsert: true }
        );
      } else {
        await Log.findOneAndUpdate(
          { guildId },
          { $pull: { disable: event } },
          { upsert: true }
        );
      }

      clearLogCache(guildId);

      const eventName =
        EVENT_TYPES.find((e) => e.value === event)?.name || event;
      const embed = new EmbedBuilder()
        .setTitle(
          action === "disable" ? "🚫 Event Disabled" : "✅ Event Enabled"
        )
        .setDescription(`**${eventName}** logging has been ${action}d`)
        .setColor(action === "disable" ? "Red" : "Green")
        .setTimestamp();

      return interaction.editReply({ embeds: [embed] });
    }

    // ═══════════════════════════════════════════════════════
    // 📊 VIEW - Show current configuration
    // ═══════════════════════════════════════════════════════
    if (subcommand === "view") {
      const config = await Log.findOne({ guildId });

      if (!config) {
        return interaction.editReply({
          content:
            "❌ No logging configuration found for this server. Use `/logs setup` first!",
        });
      }

      const channelsList = config.channels
        ? Object.entries(config.channels)
            .map(([k, v]) => {
              const eventName = EVENT_TYPES.find((e) => e.value === k)?.name || k;
              return `• **${eventName}**: <#${v}>`;
            })
            .join("\n") || "None"
        : "None";

      const colorsList = config.colors
        ? Object.entries(config.colors)
            .map(([k, v]) => {
              const eventName = EVENT_TYPES.find((e) => e.value === k)?.name || k;
              return `• **${eventName}**: \`${v}\``;
            })
            .join("\n") || "None"
        : "None";

      const disabledList =
        config.disable?.length > 0
          ? config.disable.map((e) => {
              const eventName = EVENT_TYPES.find((ev) => ev.value === e)?.name || e;
              return `• ${eventName}`;
            }).join("\n")
          : "None";

      const enabledCount = EVENT_TYPES.length - (config.disable?.length || 0);

      const embed = new EmbedBuilder()
        .setTitle("📊 Log Configuration")
        .setDescription(`**${enabledCount}/${EVENT_TYPES.length}** events are enabled`)
        .setColor("Blue")
        .addFields(
          {
            name: "📢 Default Channel",
            value: config.channelId ? `<#${config.channelId}>` : "Not set",
            inline: true,
          },
          {
            name: "📂 Custom Channels",
            value: channelsList.slice(0, 1024) || "None",
            inline: false,
          },
          {
            name: "🎨 Custom Colors",
            value: colorsList.slice(0, 1024) || "None",
            inline: false,
          },
          {
            name: "🚫 Disabled Events",
            value: disabledList.slice(0, 1024) || "None",
            inline: false,
          }
        )
        .setFooter({ text: `Guild ID: ${guildId}` })
        .setTimestamp();

      return interaction.editReply({ embeds: [embed] });
    }

    // ═══════════════════════════════════════════════════════
    // 🗑️ RESET - Delete all configuration
    // ═══════════════════════════════════════════════════════
    if (subcommand === "reset") {
      await Log.findOneAndDelete({ guildId });
      
      clearLogCache(guildId);

      const embed = new EmbedBuilder()
        .setTitle("🗑️ Configuration Reset")
        .setDescription(
          "All logging settings have been deleted for this server."
        )
        .setColor("Red")
        .setTimestamp();

      return interaction.editReply({ embeds: [embed] });
    }
  },
};

💡 Tips & Notes

• 🔄 Caching: The system caches guild configurations for better performance.
• 🔐 Permissions: Make sure your bot has View Audit Log permission for full functionality.
• 📢 Invite Tracking: Uses discord-inviter package for accurate invite tracking.
• 🎨 Default Colors: Each event type has sensible default colors if not customized.
• 🚫 Disabled Events: Events in the disable array will be completely ignored.
• 📂 Channel Fallback: If no specific channel is set for an event, it uses channelId.
• 💾 Database Mode: Recommended for multi-server bots with dynamic configuration needs.
• 🌐 Dashboard Integration: When using database mode, you can manage logs via the web dashboard!

🏆 Level System – XP, Levels & Leaderboard

The Level System module lets you track user experience points (XP) in text 💬 and voice 🎙️, handle level-ups ⬆️, and display leaderboards 🏅. Perfect for gamifying your Discord server! 🎮✨

Note: To use this module, you MUST have DATABASE conection. | Note 2: You can get all data by requiring the Level module.

📦 Module Exports

const { addXP, UserLevel, leaderboard } = require("djs-builder");

• addXP(userId, guildId, options) → Adds XP for a user and handles level-ups 🎲.
• UserLevel(userId, guildId) → Fetch a user's XP and level 👤.
• leaderboard(guildId, type, limit) → Get top users 🏅.

🎲 addXP – Add Experience Points

Adds XP to a user and automatically handles level-ups.

const result = await addXP("USER_ID", "GUILD_ID", {
  type: "text", // "text" 💬 | "voice" 🎙️
  minXP: 5, // Minimum random XP 🟢
  maxXP: 15, // Maximum random XP 🔵
  amount_add: 10, // Optional: fixed XP 💎
  level_add: 1, // Optional: direct level boost ⬆️
});

console.log(result);
/* Example output:
{
  newLevel: 3,
  oldLevel: 2,
  totalXP: 250,
  leveledUp: true
}
*/

🧑‍🤝‍🧑 UserLevel – Fetch User Data

Fetch a user's text XP, voice XP, total XP, and current level.

const data = await UserLevel("USER_ID", "GUILD_ID");
console.log(data);
/* Example output:
{
  text: 120 💬,
  voice: 50 🎙️,
  totalXP: 170 ⭐,
  level: 2 ⬆️
}
*/

Returns default values if the user is not found.

🏅 Leaderboard – Top Users

Get a sorted list of users based on XP or level.

const topUsers = await leaderboard("GUILD_ID", "totalXP", 5);
console.log(topUsers);
/* Example output:
[
  { userId: "123", totalXP: 500, level: 5 },
  { userId: "456", totalXP: 400, level: 4 },
  ...
]
*/

Parameters:

• guildId → Server ID 🏠
• type → "totalXP", "text" 💬, "voice" 🎙️, or "level" ⬆️. Default = "totalXP"
• limit → Number of top users to return 🔢. Default = 10

⚡ Practical Example: messageCreate Event

const { addXP, UserLevel, leaderboard } = require("djs-builder");

module.exports = {
  name: "messageCreate",
  run: async (msg, client) => {
    if (msg.author.bot) return;

    // 🎲 Add XP on every message
    const result = await addXP(msg.author.id, msg.guild.id, {
      type: "text",
      minXP: 5,
      maxXP: 15,
    });

    // 🎉 Level-up notification
    if (result.leveledUp) {
      msg.channel.send(`🎊 ${msg.author} new level **${result.newLevel}** ⬆️`);
    }

    // 📊 Check your rank
    if (msg.content === "!rank") {
      const data = await UserLevel(msg.author.id, msg.guild.id);
      msg.reply(`📈 **level ** ${data.level} ⬆️ – **XP:** ${data.totalXP} ⭐`);
    }

    // 🏅 Display top users
    if (msg.content === "!top") {
      const lb = await leaderboard(msg.guild.id, "totalXP", 5);
      msg.reply(
        lb
          .map(
            (u, i) =>
              `#${i + 1} <@${u.userId}> – Lv.${u.level} ⬆️ (${u.totalXP} ⭐)`
          )
          .join("\n")
      );
    }
  },
};

💡 Notes & Tips

• 💬 Text XP – Add XP for messages automatically.
• 🎙️ Voice XP – Add XP for voice activity.
• ⬆️ Level Up – Trigger notifications when leveling up.
• 🏅 Leaderboard – Display the top users in server using embeds for better look.
• 🎮 Gamify your server easily with XP rewards, mini-games, and custom commands.

🎉 Giveaway System – All-in-One Contest Management 🏆✨

This module provides a robust and feature-rich suite of functions to effortlessly launch, monitor, manage, and conclude Giveaways on your Discord server. It fully supports both Reactions and Buttons for entry, featuring advanced controls like pausing, resuming, and rerolling winners. It is highly recommended to read the Important Notes section below. 🚨

Note: To use this module, you MUST have DATABASE conection. | Note 2: You can get all data by requiring the giveaway module.

📦 Module Exports

const {
  Gstart,
  Gcheck,
  Greroll,
  Glist,
  Gpause,
  Gresume,
  Gdelete,
  GaddUser,
  GremoveUser,
  GaddTime,
  GremoveTime,
  Gdata,
} = require("djs-builder");

🎬 Gstart – Launch a Brand New Giveaway! 🚀

This is the primary function to kick off a new giveaway. It handles creating the Discord message and persists all necessary data in the database (MongoDB). This function offers deep customization for embeds and entry methods. 🎨

⚙️ Essential Options:

• context: The Message or Interaction object that triggered the command.
• endTime: The duration until the giveaway ends (in milliseconds ⏱️).
• winers: The number of winners for the contest. 🏅
• channelId: The ID of the channel where the giveaway message will be posted. 📢
• embed / endEmbed: Options to fully customize the starting message and the final end message.
• reaction: To specify the entry method (button or reaction). 🖱️

⚡ Simple Usage Example (Basic Requirements Only):

This example provides a fast and minimalist way to start a giveaway with default embed colors, a simple title, and the default reaction entry type (if the reaction object is omitted or set to reaction).

const { Gstart } = require("djs-builder");

module.exports = {
  name: "gstart",
  description: "Starts a new simple giveaway.",
  run: async (client, message, args) => {
    // ⏰ Giveaway ends in 1 hour
    const oneHour = 60 * 60 * 1000;
    const channelId = message.channel.id;

    await Gstart({
      context: message,
      endTime: oneHour,
      winers: 1,
      channelId: channelId,

      embed: {
        title: "🎉 Simple Test Giveaway",
        description: "React to enter! Prize: Discord Nitro.",
      },
    });
    message.reply("🎉 Simple Giveaway starte