djs-builder 0.6.37 → 0.6.39

package/README.md

@@ -148,7 +148,7 @@ await starter(client, starterOptions);
 
 ## ⚙️ functions
 
-- **Easyest ✨** / **Fastest ⚡** /**Clear 🧵**
+- **Easiest ✨** / **Fastest ⚡** /**Clear 🧵**
 
 **Than the discord.js**
 
@@ -552,6 +552,10 @@ module.exports = {
 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**: You can get all data by requiring the **Level** module.
+
 ---
 
 ### 📦 Module Exports
@@ -704,6 +708,10 @@ module.exports = {
 
 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**: You can get all data by requiring the **giveaway** module.
+
 ---
 
 ### 📦 Module Exports
@@ -842,7 +850,7 @@ module.exports = {
 ---
 
 <details>
-<summary>⚠️ mportant Notes</summary>
+<summary>⚠️ Important Notes</summary>
 
 ### ⚠️ **Important Notes** – _Read Before Use\!_ 🚨
 
@@ -1190,7 +1198,7 @@ if (giveawayData) {
 
 📊 **`Gdata(messageId)`** – Returned Object Structure
 
-- it like :
+- Returns an object like:
 
 ```js
 {
@@ -1253,6 +1261,7 @@ const {
   SlashCommandBuilder,
   EmbedBuilder,
   AttachmentBuilder,
+  PermissionFlagsBits,
 } = require("discord.js");
 const ms = require("ms");
 
@@ -1260,6 +1269,7 @@ module.exports = {
   data: new SlashCommandBuilder()
     .setName("giveaway")
     .setDescription("Comprehensive giveaway system management")
+    .setDefaultMemberPermissions(PermissionFlagsBits.ManageGuild)
 
     // 🎬 /giveaway start
     .addSubcommand((subcommand) =>
@@ -1471,8 +1481,7 @@ module.exports = {
       const prize = interaction.options.getString("prize");
 
       const durationMs = ms(timeString);
-const endTimeMs = Date.now() + durationMs;
-
+      const endTimeMs = Date.now() + durationMs;
 
       if (!durationMs) {
         return interaction.editReply(
@@ -1535,7 +1544,6 @@ const endTimeMs = Date.now() + durationMs;
         giveaways.length
       } found)`;
 
-
       if (listContent.length <= MAX_MESSAGE_LENGTH) {
         // Output as a simple message (Under 2000 chars)
         return interaction.editReply({
@@ -1655,69 +1663,77 @@ const endTimeMs = Date.now() + durationMs;
     } else if (command === "data") {
       const id = interaction.options.getString("id");
       console.log(id);
-    const data = await Gdata(id);
-    if (data?.error)
+      const data = await Gdata(id);
+      if (data?.error)
         return interaction.editReply(`❌ **Error:** ${data.error}`);
 
-   
-    const giveawayEmbed = new EmbedBuilder()
+      const giveawayEmbed = new EmbedBuilder()
         .setTitle(`📊 Giveaway Data: ${id}`)
-        .setColor(data.ended ? 0xFF0000 : data.paused ? 0xFFC0CB : 0x00FF00) 
-        .setDescription(`**Jump to Message 🔗 ** : ${data.messageId ? `https://discord.com/channels/${data.guildId}/${data.channelId}/${data.messageId}` : 'N/A'}`)
-      
-
- 
-    giveawayEmbed.addFields(
-        { 
-            name: "✨ Status", 
-            value: data.ended ? "ENDED 🛑" : data.paused ? "PAUSED ⏸️" : "ACTIVE ✅", 
-            inline: true 
+        .setColor(data.ended ? 0xff0000 : data.paused ? 0xffc0cb : 0x00ff00)
+        .setDescription(
+          `**Jump to Message 🔗 ** : ${
+            data.messageId
+              ? `https://discord.com/channels/${data.guildId}/${data.channelId}/${data.messageId}`
+              : "N/A"
+          }`
+        );
+
+      giveawayEmbed.addFields(
+        {
+          name: "✨ Status",
+          value: data.ended
+            ? "ENDED 🛑"
+            : data.paused
+            ? "PAUSED ⏸️"
+            : "ACTIVE ✅",
+          inline: true,
         },
-        { 
-            name: "🏆 Winners", 
-            value: data.winwesNumber.toString(), 
-            inline: true 
+        {
+          name: "🏆 Winners",
+          value: data.winwesNumber.toString(),
+          inline: true,
         },
-        { 
-            name: "🙋‍♂️ Hoster", 
-            value: `<@${data.hoster}>`, 
-            inline: true 
+        {
+          name: "🙋‍♂️ Hoster",
+          value: `<@${data.hoster}>`,
+          inline: true,
         },
-       
-        { 
-            name: "⏳ Ends In", 
-            value: `<t:${Math.floor(data.endTime / 1000)}:R>`, 
-            inline: true 
+
+        {
+          name: "⏳ Ends In",
+          value: `<t:${Math.floor(data.endTime / 1000)}:R>`,
+          inline: true,
         },
-        { 
-            name: "🎟️ Entries", 
-            value: data.reaction === "button" ? data.users.length.toString() : "N/A (Reaction Type)", 
-            inline: true 
+        {
+          name: "🎟️ Entries",
+          value:
+            data.reaction === "button"
+              ? data.users.length.toString()
+              : "N/A (Reaction Type)",
+          inline: true,
         },
-        { 
-            name: "🖱️ Entry Type", 
-            value: data.reaction.toUpperCase(), 
-            inline: true 
+        {
+          name: "🖱️ Entry Type",
+          value: data.reaction.toUpperCase(),
+          inline: true,
         }
-    );
+      );
 
-   
-    if (data.ended && data.winers.length > 0) {
+      if (data.ended && data.winers.length > 0) {
         giveawayEmbed.addFields({
-            name: "🏅 Past Winners",
-            value: data.winers.map(u => `<@${u}>`).join(', ') || "N/A",
-            inline: false
+          name: "🏅 Past Winners",
+          value: data.winers.map((u) => `<@${u}>`).join(", ") || "N/A",
+          inline: false,
         });
-    }
+      }
 
-    return interaction.editReply({ 
-        embeds: [giveawayEmbed], 
-        content: `Data retrieved for giveaway \`${id}\`.`
-    });
-}
+      return interaction.editReply({
+        embeds: [giveawayEmbed],
+        content: `Data retrieved for giveaway \`${id}\`.`,
+      });
+    }
   },
 };
-
 ```
 
 ---
@@ -1756,6 +1772,77 @@ const endTimeMs = Date.now() + durationMs;
 
 ---
 
+<details>
+<summary>Hot Reloading 🔄</summary>
+
+**🔄 Hot Reloading – Update your bot without restarting!**
+
+`djs-builder` allows you to reload your **commands** and **events** instantly while the bot is running. This is perfect for rapid development and fixing bugs on the fly.
+
+---
+
+### 📌 Features
+
+- **Prefix Commands**: Reloads all prefix commands from disk.
+- **Slash Commands**: Reloads slash command logic (internal cache).
+- **Events**: Reloads event listeners (removes old ones, adds new ones).
+- **All**: Reloads everything at once.
+
+---
+
+### 📌 Example Usage (Slash Command)
+
+```js
+const { reload } = require("djs-builder");
+const { SlashCommandBuilder } = require("discord.js");
+
+module.exports = {
+  data: new SlashCommandBuilder()
+    .setName("reload")
+    .setDescription("Reload bot commands/events")
+    .addStringOption((option) =>
+      option
+        .setName("type")
+        .setDescription("What to reload?")
+        .setRequired(true)
+        .addChoices(
+          { name: "Prefix Commands", value: "prefix" },
+          { name: "Slash Commands", value: "slash" },
+          { name: "Events", value: "events" },
+          { name: "All", value: "all" }
+        )
+    ),
+  ownerOnly: true,
+  async run(interaction, client) {
+    // Check for owner permission (Recommended)
+
+    const type = interaction.options.getString("type");
+
+    try {
+      await interaction.deferReply();
+      await reload(client, type);
+      await interaction.editReply(`✅ Successfully reloaded **${type}**! 🚀`);
+    } catch (error) {
+      console.error(error);
+      await interaction.editReply(
+        "❌ Failed to reload. Check console for errors."
+      );
+    }
+  },
+};
+```
+
+---
+
+### 💡 Notes
+
+- **Slash Commands**: Reloading only updates the **code execution**. If you change the command name, description, or options, you still need to restart the bot to update Discord's API.
+- **Events**: Old event listeners are automatically removed before adding new ones to prevent duplicates.
+
+</details>
+
+---
+
 ## ⚡ Commands & Events
 
 **💡 Commands & Events made easy!**

package/function/giveaway.js

@@ -204,7 +204,7 @@ async function giveaway_end(client, g, type) {
       return;
     }
 
-    const winners = pickWinners(users_id, g.winersNumber);
+    const winners = pickWinners(users_id, g.winwesNumber);
 
     await message.edit({
       embeds: [g.endEmbed],
@@ -255,7 +255,7 @@ async function Greroll(client, messageId) {
       );
     }
 
-    const winners = pickWinners(users_id, g.winersNumber);
+    const winners = pickWinners(users_id, g.winwesNumber);
 
     await message.reply({
       content: `🔄️ **Giveaway Reroll!**\n> Winner(s):\n- <@${winners

package/function/level.js

@@ -73,4 +73,4 @@ async function leaderboard(guildId, type = "totalXP", limit = 10) {
     .limit(limit);
 }
 
-module.exports = { addXP, UserLevel, leaderboard };
+module.exports = { Level,addXP, UserLevel, leaderboard };

package/handler/starter.js

@@ -12,8 +12,135 @@ let termenal = {
   events: 0,
 };
 
+async function loadPrefix(client, path) {
+  const prefix_files = await readFile(path);
+  client.prefixCommands = new Map();
+
+  for (const file of prefix_files) {
+    delete require.cache[require.resolve(file.path)];
+    const command = require(file.path);
+
+    if (!command.name) continue;
+
+    const commandWithMeta = {
+      ...command,
+      file_path: file.path,
+    };
+
+    client.prefixCommands.set(command.name, commandWithMeta);
+
+    if (Array.isArray(command.aliases)) {
+      for (const alias of command.aliases) {
+        client.prefixCommands.set(alias, commandWithMeta);
+      }
+    }
+  }
+  termenal.prefix = client.prefixCommands.size;
+  return client.prefixCommands.size;
+}
+
+async function loadSlash(client, path) {
+  const slash_files = await readFile(path);
+  
+ 
+  for (const file of slash_files) {
+      delete require.cache[require.resolve(file.path)];
+  }
+
+  const validSlashCommands = slash_files
+    .map((f) => {
+        const cmd = require(f.path);
+        cmd.file_path = f.path;
+        return cmd;
+    })
+    .filter(
+      (cmd) =>
+        cmd.data &&
+        (typeof cmd.run === "function" || typeof cmd.execute === "function")
+    );
+
+  client.slashCommands = new Map(
+    validSlashCommands.map((cmd) => [cmd.data.name, cmd])
+  );
+  client.slashData = validSlashCommands.map((cmd) => cmd.data.toJSON());
+
+  termenal.slash = validSlashCommands.length;
+  return validSlashCommands.length;
+}
+
+async function loadEvents(client, path) {
+  const event_files = await readFile(path);
+  
+ 
+  if (!client.djsEventListeners) {
+      client.djsEventListeners = new Map();
+  }
+
+
+  for (const file of event_files) {
+      if (client.djsEventListeners.has(file.path)) {
+          const { name, listener } = client.djsEventListeners.get(file.path);
+          client.removeListener(name, listener);
+          client.djsEventListeners.delete(file.path);
+      }
+      delete require.cache[require.resolve(file.path)];
+  }
+
+  for (const file of event_files) {
+    const event = require(file.path);
+
+    if (!event.name || typeof event.run !== "function") continue;
+
+    let listener;
+    if (event.once) {
+      listener = (...args) => {
+        if (typeof event.run === "function") {
+          event.run(...args);
+        } else if (typeof event.execute === "function") {
+          event.execute(...args);
+        }
+      };
+      client.once(event.name, listener);
+    } else {
+      listener = (...args) => {
+        if (typeof event.run === "function") {
+          event.run(...args, client);
+        } else if (typeof event.execute === "function") {
+          event.execute(...args, client);
+        }
+      };
+      client.on(event.name, listener);
+    }
+    
+    client.djsEventListeners.set(file.path, { name: event.name, listener });
+    termenal.events++;
+  }
+  return termenal.events;
+}
+
+async function reload(client, type) {
+    if (!client.djsOptions) return console.error("❌ Options not found on client.");
+    
+    if (type === "prefix" && client.djsOptions.prefix) {
+        await loadPrefix(client, client.djsOptions.prefix.path);
+        console.log("✅ Prefix commands reloaded.");
+    } else if (type === "slash" && client.djsOptions.slash) {
+        await loadSlash(client, client.djsOptions.slash.path);
+        console.log("✅ Slash commands reloaded (Internal Cache).");
+    } else if (type === "events" && client.djsOptions.events) {
+        await loadEvents(client, client.djsOptions.events.path);
+        console.log("✅ Events reloaded.");
+    } else if (type === "all") {
+        if (client.djsOptions.prefix) await loadPrefix(client, client.djsOptions.prefix.path);
+        if (client.djsOptions.slash) await loadSlash(client, client.djsOptions.slash.path);
+        if (client.djsOptions.events) await loadEvents(client, client.djsOptions.events.path);
+        console.log("✅ All systems reloaded.");
+    }
+}
+
 async function starter(client, options) {
   //////////////////////////////////////////! mine data !////////////////////////////////////////////////////////
+  client.djsOptions = options;
   const token = options.bot.token;
   const ownerId = options.bot.ownerId;
   const Status = options.Status || null;
@@ -72,80 +199,19 @@ async function starter(client, options) {
   //////////////////////////////////////////? Prefix Loader ////////////////////////////////////////////////////////
 
   if (prefix) {
-    const prefix_files = await readFile(prefix.path);
-    client.prefixCommands = new Map();
-
-    for (const file of prefix_files) {
-      const command = require(file.path);
-
-      if (!command.name) continue;
-
-      const commandWithMeta = {
-        ...command,
-        file_path: file.path,
-      };
-
-      client.prefixCommands.set(command.name, commandWithMeta);
-
-      if (Array.isArray(command.aliases)) {
-        for (const alias of command.aliases) {
-          client.prefixCommands.set(alias, commandWithMeta);
-        }
-      }
-
-      termenal.prefix++;
-    }
+    await loadPrefix(client, prefix.path);
   }
 
   //////////////////////////////////////////? Slash Loader ////////////////////////////////////////////////////////
 
   if (slash) {
-    const slash_files = await readFile(slash.path);
-    const validSlashCommands = slash_files
-      .map((f) => require(f.path))
-      .filter(
-        (cmd) =>
-          cmd.data &&
-          (typeof cmd.run === "function" || typeof cmd.execute === "function")
-      );
-
-    client.slashCommands = new Map(
-      validSlashCommands.map((cmd) => [cmd.data.name, cmd])
-    );
-    client.slashData = validSlashCommands.map((cmd) => cmd.data.toJSON());
-
-    termenal.slash = validSlashCommands.length;
+    await loadSlash(client, slash.path);
   }
 
   //////////////////////////////////////////? Event Loader ////////////////////////////////////////////////////////
 
   if (events) {
-    const event_files = await readFile(events.path);
-    for (const file of event_files) {
-      const event = require(file.path);
-
-      if (!event.name || typeof event.run !== "function") continue;
-
-      if (event.once) {
-        client.once(event.name, (...args) => {
-          if (typeof event.run === "function") {
-            event.run(...args);
-          } else if (typeof event.execute === "function") {
-            event.execute(...args);
-          }
-        });
-      } else {
-        client.on(event.name, (...args) => {
-          if (typeof event.run === "function") {
-            event.run(...args, client);
-          } else if (typeof event.execute === "function") {
-            event.execute(...args, client);
-          }
-        });
-      }
-
-      termenal.events++;
-    }
+    await loadEvents(client, events.path);
   }
 
   //////////////////////////////////////////* prefix run !////////////////////////////////////////////////////////
@@ -194,8 +260,7 @@ async function starter(client, options) {
     if (command.dmOnly && message.guild) return;
     if (
       command.devOnly &&
-      client.ownerId &&
-      message.author.id !== client.ownerId
+      message.author.id !== client.owner.id
     )
       return;
     if (
@@ -260,8 +325,7 @@ async function starter(client, options) {
 
     if (
       command.devOnly &&
-      client.ownerId &&
-      interaction.user.id !== client.ownerId
+      interaction.user.id !== client.owner.id
     ) {
       return interaction.reply({
         content: "`❌` هذا الأمر محصور لصاحب البوت فقط!",
@@ -350,10 +414,11 @@ async function starter(client, options) {
 }
 
 const { Wait, CreateBar, CreateRow, GetUser } = require("../function/function");
-const { addXP, UserLevel, leaderboard } = require("../function/level");
+const { Level, addXP, UserLevel, leaderboard } = require("../function/level");
 const { log } = require("../function/log");
 
 const {
+  giveaway,
   Gstart,
   Gcheck,
   Greroll,
@@ -365,10 +430,14 @@ const {
   GremoveUser,
   GaddTime,
   GremoveTime,
+  Gdata
 } = require("../function/giveaway");
 
 module.exports = {
+  Level,
+  giveaway,
   starter,
+  reload,
   log,
   Wait,
   CreateBar,
@@ -388,4 +457,5 @@ module.exports = {
   GremoveUser,
   GaddTime,
   GremoveTime,
+  Gdata
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "djs-builder",
-  "version": "0.6.37",
-  "note": "🎉 Package Update! 🥏\n\n- Add Giveaway System 🎉 \n\n- 🛠 Fixes:\n- Minor bugs fixed\n- Improved stability and error handling\n\n🔗 Learn more on [NPM](https://www.npmjs.com/package/djs-builder)",
+  "version": "0.6.39",
+  "note": "🎉 Package Update! 🥏\n\n- 📚 Documentation: Added full guide for Giveaway System & Hot Reloading.\n- 🐛 Bug Fixes: Fixed critical issue in Giveaway winner selection.\n\n🔗 Learn more on [NPM](https://www.npmjs.com/package/djs-builder)",
   "description": "🎉 Package Update! 🥏",
   "main": "handler/starter.js",
   "dependencies": {