djs-builder 0.6.9 → 0.6.11

package/README.md

@@ -127,8 +127,8 @@ const actionRow = new CreateRow([
           { name: 'Option 3', id: 'option3', about: 'Description for Option 3', icon: '🔗' },
         ],  //// is should not look like this ,you selecit it in next step
         value: "id", // here you can set the value of the selected option ( defult the value is will be index (0,1,2 .....) )
-        description: "about" // here you can set the description of the selected option ( defult the description not work )
-        label: "name" // here you can set the label of the selected option ( defult the label is (Option 1 , Option 2 , Option 3) )
+        description: "about", // here you can set the description of the selected option ( defult the description not work )
+        label: "name", // here you can set the label of the selected option ( defult the label is (Option 1 , Option 2 , Option 3) )
         emoji: "icon" // here you can set the emoji of the selected option ( defult the emoji not work )
 
     }
@@ -230,24 +230,68 @@ module.exports = {
 
 </details>
 
-## 🔧 Commands
 
-- **Slash 🔧** and **Prefix 📨** Have Same Options
 <details>
-<summary>Options</summary>
+    <summary>GetUser 👤</summary>
+
+**👤 Utility function to get a member from a message ✨.**
+
+```js
+const data = await GetUser(message);
+```
+
+---
+
+### 📦 What does it return?
+
+```js
+{
+  user: <GuildMember>,        // 🎯 The targeted member
+  args: [ "word1", "word2" ]  // ✍️ Remaining args after mention/ID
+}
+```
+
+---
+
+### 📌 How does it detect the user?
+
+1. **Mention** inside the message
+
+   > Example: `!ban @Ahmed Breaking rules`.
+
+2. **User ID** directly
+
+   > Example: `!ban 123456789012345678 Spamming`.
+
+3. **Reply** to someone’s message
+
+   > Reply to a user’s message with: `!ban`.
+
+---
+
+### 🛠️ Example usage (ban command) 🚫
 
 ```js
-cooldown : 5, /// cooldown in seconds
-fastUse : true, /// fast use command without prefix
-permissions : ["ADMINISTRATOR"], /// permission for slash command
-ownerOnly : true ,/// only owner can use slash command
-devOnly : true /// only dev can use slash command
-guildOnly : true /// only guild can use slash command
-dmOnly : true /// only dm can use slash command
+client.on("messageCreate", async (message) => {
+  if (!message.content.startsWith("!ban")) return;
+
+  const data = await GetUser(message);
+  if (!data) return message.reply("❌ Couldn't find this user.");
+
+  const member = data.user;
+  const reason = data.args.join(" ") || "No reason provided";
+
+  await member.ban({ reason });
+  message.reply(`🚫 ${member.user.tag} has been banned for: ${reason}`);
+});
 ```
 
+---
+
 </details>
 
+
+
 ## Contributions
 
 Contributions are welcome! If you have any suggestions, bug reports, or feature requests, feel free to contact us on discord.

package/function/function.js

@@ -61,12 +61,16 @@ async function Wait({
   if (!channel) throw new Error("context must contain a valid channel.");
 
   if (type === "message") {
-    const collected = await channel.awaitMessages({
-      filter: (m) => !userId || m.author.id === userId,
-      time,
-      max: 1,
-    });
-    return collected.first() || null;
+    try {
+      const collected = await channel.awaitMessages({
+        filter: (m) => !userId || m.author.id === userId,
+        time,
+        max: 1,
+      });
+      return collected.first() || null;
+    } catch {
+      return null;
+    }
   }
 
   if (type === "button") {
@@ -76,13 +80,15 @@ async function Wait({
         "You must provide messageWithButtons when using type 'button'."
       );
 
-    const collected = await message.awaitMessageComponent({
-      filter: (i) => !userId || i.user.id === userId,
-      time,
-    });
-    if (!collected) return null;
-
-    return collected;
+    try {
+      const collected = await message.awaitMessageComponent({
+        filter: (i) => !userId || i.user.id === userId,
+        time,
+      });
+      return collected ?? null;
+    } catch {
+      return null;
+    }
   }
 
   if (type === "both") {
@@ -106,13 +112,13 @@ async function Wait({
       });
       collectors.push(msgCollector);
 
-      const btnCollector = messageWithButtons.createMessageComponentCollector({
+      const btnCollector = message_Wait.createMessageComponentCollector({
         filter: (i) => !userId || i.user.id === userId,
         max: 1,
         time,
       });
 
-      btnCollector.on("collect", async (i) => {
+      btnCollector.on("collect", (i) => {
         stop();
         resolve({ type: "button", data: i });
       });
@@ -163,7 +169,7 @@ function CreateRow(components) {
           but.setDisabled(buttonConfig.disabled);
         }
 
-        if(buttonConfig.style === 5 && buttonConfig.url) {
+        if (buttonConfig.style === 5 && buttonConfig.url) {
           but.setURL(buttonConfig.url);
         }
 
@@ -204,17 +210,15 @@ function CreateRow(components) {
         selectMenu = new ChannelSelectMenuBuilder();
       }
 
-
       selectMenu.setCustomId(id || "selectMenu");
       selectMenu.setPlaceholder(placeholder);
-if (min) {
-    const minValue = Math.min(min, data.length);
-    selectMenu.setMinValues(minValue);
-    selectMenu.setMaxValues(data.length);
-}
+      if (min) {
+        const minValue = Math.min(min, data.length);
+        selectMenu.setMinValues(minValue);
+        selectMenu.setMaxValues(data.length);
+      }
 
-if(max) selectMenu.setMaxValues(max);
-      
+      if (max) selectMenu.setMaxValues(max);
 
       if (type === "string") {
         selectMenu.addOptions(selectOptions);
@@ -229,8 +233,38 @@ if(max) selectMenu.setMaxValues(max);
   return actionRows;
 }
 
+//////////////////////////////////* Get User 👀
+
+async function GetUser(message) {
+  const args = message.content.split(/\s+/).slice(1);
+  let user = message.mentions.members.first();
+  let new_args = args;
+
+  // إذا ماكو منشن → جرب الـ ID
+  if (!user && args[0]) {
+    const userId = args[0];
+    user = await message.guild.members.fetch(userId).catch(() => null);
+    new_args = args.slice(1);
+  }
 
+  // إذا ماكو منشن ولا ID → جرب الرد
+  if (!user && message.reference) {
+    const repliedMessage = await message.channel.messages
+      .fetch(message.reference.messageId)
+      .catch(() => null);
 
+    if (repliedMessage) {
+      user = await message.guild.members.fetch(repliedMessage.author.id).catch(() => null);
+    }
+  }
+
+  if (!user) return null;
+
+  return {
+    user,
+    args: new_args,
+  };
+}
 
 
-module.exports = { Wait, CreateBar, CreateRow };
+module.exports = { Wait, CreateBar, CreateRow , GetUser};

package/handler/helper.js

@@ -194,38 +194,90 @@ async function set_anticrash(data) {
 async function cmd_log(client, data, commandName, channelId) {
   const isSlash = !!data.user;
   const user = isSlash ? data.user : data.author;
-  const channel = data.guild ? `Channel: ${data.channel.name} | ${data.channel} (${data.channel.id})\n Guild: ${data.guild.name} | (${data.guild.id})` : "DM";
-  const messageUrl = data.message?.url || "`not found`";
 
   const logChannel = client.channels.cache.get(channelId);
   if (!logChannel) return;
 
-  const embed = new EmbedBuilder()
-    .setTitle(isSlash ? "📘 Slash Command Log" : "📗 Prefix Command Log")
-    .setColor(isSlash ? "Green" : "Blue")
-    .addFields(
-      { name: "📝 Command", value: `\`${commandName}\`` },
+  let messageLink;
+  if (interaction.channel) {
+    messageLink = `https://discord.com/channels/${interaction.guild.id}/${interaction.channel.id}/${interaction.id}`;
+  } else {
+    messageLink = "Unknown";
+  }
+
+
+  const field = [
+    {
+      name: "📧 Cmd:",
+      value: `- ${commandName}`,
+      inline: true,
+    },
+    {
+      name: "👤 User:",
+      value: `- ${user?.tag ?? "Unknown user"} | (\`${
+        user?.id ?? "Unknown ID"
+      }\`)`,
+      inline: true,
+    },
+    {
+      name: "\u200B",
+      value: "\u200B",
+      inline: true,
+    },
+  ];
+
+  if (data.guild && data.channel) {
+    field.push(
       {
-        name: "👤 User",
-        value: `${user.tag || user.username} | ${user} (${user.id})`,
-      
+        name: "🏠 Server:",
+        value: `- ${data.guild.name} | (\`${data.guild.id}\`)`,
+        inline: true,
+      },
+      {
+        name: "💬 Channel",
+        value: `- ${data.channel.name} | (\`${data.channel.id}\`)`,
+        inline: true,
       },
-      { name: "💬 Channel", value: `${channel}` },
-      { name: "🔗 Message", value: `[Link](${messageUrl})` },
       {
-        name: "🕒 Date",
-        value: `<t:${Math.floor(Date.now() / 1000)}:F>`,
+        name: "\u200B",
+        value: "\u200B",
+        inline: true,
+      },
+      {
+        name: "🔗 Message",
+        value: messageLink ? `- [Link](${messageLink})` : "not found",
         inline: true,
       }
-    )
+    );
+  } else if (!data.guild) {
+    field.push({
+      name: "👀 DM Message",
+      value: `${user?.tag ?? "Unknown user"}`,
+      inline: true,
+    });
+  }
+
+  field.push({
+    name: "⏳ Date:",
+    value: `<t:${Math.floor(Date.now() / 1000)}:F>`,
+  });
+
+  const embed = new EmbedBuilder()
+    .setTitle(isSlash ? "📘 Slash Command Log" : "📗 Prefix Command Log")
+    .setColor(isSlash ? "Green" : "Blue")
+    .addFields(...field)
     .setThumbnail(client.user.displayAvatarURL({ dynamic: true }))
     .setAuthor({
-      name : `${user.tag} || ${user.username}`,
-      iconURL: user.displayAvatarURL({ dynamic: true }),
+      name: `${user?.tag ?? "Unknown user"} || ${user?.username ?? "Unknown"}`,
+      iconURL: user?.displayAvatarURL({ dynamic: true }),
     })
     .setTimestamp();
 
-  logChannel.send({ embeds: [embed] }).catch(console.error);
+  try {
+    await logChannel.send({ embeds: [embed] });
+  } catch (error) {
+    console.error("Error sending log embed:", error);
+  }
 }
 
 //////////////////////////////////* Check update 🔼

package/handler/starter.js

@@ -4,7 +4,7 @@ const {
   terminalInfo,
   set_anticrash,
   cmd_log,
-  update
+  update,
 } = require("./helper");
 let termenal = {
   prefix: 0,
@@ -103,14 +103,16 @@ async function starter(client, options) {
     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());
-
+      .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;
   }
@@ -149,7 +151,6 @@ client.slashData = validSlashCommands.map(cmd => cmd.data.toJSON());
   //////////////////////////////////////////* prefix run !////////////////////////////////////////////////////////
 
   client.on("messageCreate", async (message) => {
-  
     if (message.author.bot) return;
 
     const content = message.content.trim();
@@ -209,7 +210,7 @@ client.slashData = validSlashCommands.map(cmd => cmd.data.toJSON());
 
     try {
       if (typeof command.run === "function") {
-        await command.run(client ,message, args);
+        await command.run(client, message, args);
       } else if (typeof command.execute === "function") {
         await command.execute(client, message, args);
       }
@@ -286,7 +287,12 @@ client.slashData = validSlashCommands.map(cmd => cmd.data.toJSON());
     }
 
     if (options.slash.log) {
-      await cmd_log(client, interaction, interaction.commandName, options.slash.log);
+      await cmd_log(
+        client,
+        interaction,
+        interaction.commandName,
+        options.slash.log
+      );
     }
     try {
       if (typeof command.run === "function") {
@@ -316,26 +322,21 @@ client.slashData = validSlashCommands.map(cmd => cmd.data.toJSON());
 
   client.once("ready", async () => {
     if (ownerId) client.owner = await client.users.fetch(ownerId);
-if (client.slashData?.length) {
-  await client.application.commands.set(client.slashData);
-}
+    if (client.slashData?.length) {
+      await client.application.commands.set(client.slashData);
+    }
 
     if (terminal_info) {
       await terminalInfo(client, options, termenal);
     }
   });
 
-
-
-setInterval(() => {
-  update(client,ownerId, anticrash.url);
-}, 1000 * 60 * 60);
-
-
-
+  setInterval(() => {
+    update(client, ownerId, anticrash.url);
+  }, 1000 * 60 * 60);
 }
 
 const { Wait, CreateBar, CreateRow } = require("../function/function");
 const { log } = require("../function/log");
 
-module.exports = { starter , log, Wait, CreateBar, CreateRow };
+module.exports = { starter, log, Wait, CreateBar, CreateRow };

package/package.json

@@ -1,8 +1,8 @@
 
 {
   "name": "djs-builder",
-  "version": "0.6.9",
-  "description": "Discord.js bot builder. Supports Ts and Js.",
+  "version": "0.6.11",
+"description": "🎉 Package Update! 🥏\nNew features added:\n- `GetUser`: Easily fetch a user from **ID**, **mention**, or even from a **reply**.\n\n🛠 Fixes:\n- Minor bugs fixed\n- Improved stability and error handling\n",
   "main": "handler/starter.js",
   "dependencies": {
     "axios": "^1.11.0",