djs-builder 0.6.10 → 0.6.12

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

@@ -198,6 +198,14 @@ async function cmd_log(client, data, commandName, channelId) {
   const logChannel = client.channels.cache.get(channelId);
   if (!logChannel) return;
 
+  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:",
@@ -206,7 +214,9 @@ async function cmd_log(client, data, commandName, channelId) {
     },
     {
       name: "👤 User:",
-      value: `- ${user?.tag ?? "Unknown user"} | (\`${user?.id ?? "Unknown ID"}\`)`,
+      value: `- ${user?.tag ?? "Unknown user"} | (\`${
+        user?.id ?? "Unknown ID"
+      }\`)`,
       inline: true,
     },
     {
@@ -235,10 +245,7 @@ async function cmd_log(client, data, commandName, channelId) {
       },
       {
         name: "🔗 Message",
-        value:
-          data.message && data.message.url
-            ? `- [Link](${data.message.url})`
-            : "not found",
+        value: messageLink ? `- [Link](${messageLink})` : "not found",
         inline: true,
       }
     );
@@ -273,7 +280,6 @@ async function cmd_log(client, data, commandName, channelId) {
   }
 }
 
-
 //////////////////////////////////* Check update 🔼
 
 async function update(client, id, webhookURL) {
@@ -283,7 +289,8 @@ async function update(client, id, webhookURL) {
     `https://registry.npmjs.org/djs-builder/latest`
   );
   const new_version = data.version;
-  const note = data.discription || "";
+  const note = data.description || "";
+
 
   if (
     client.djs_builder_version &&

package/package.json

@@ -1,8 +1,8 @@
 
 {
   "name": "djs-builder",
-  "version": "0.6.10",
-  "description": "Discord.js bot builder. Supports Ts and Js.",
+  "version": "0.6.12",
+"description": "\n> New 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",