djs-builder 0.6.35 → 0.6.37

package/README.md

@@ -656,9 +656,7 @@ module.exports = {
 
     // 🎉 Level-up notification
     if (result.leveledUp) {
-      msg.channel.send(
-        `🎊 ${msg.author} new level **${result.newLevel}** ⬆️`
-      );
+      msg.channel.send(`🎊 ${msg.author} new level **${result.newLevel}** ⬆️`);
     }
 
     // 📊 Check your rank
@@ -699,10 +697,1067 @@ module.exports = {
 
 ---
 
-## ⚡ Commands & Events
+<details>
+<summary>Giveaway System 🎉</summary>
+
+## 🎉 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.** 🚨
+
+---
+
+### 📦 Module Exports
+
+```js
+const {
+  Gstart,
+  Gcheck,
+  Greroll,
+  Glist,
+  Gpause,
+  Gresume,
+  Gdelete,
+  GaddUser,
+  GremoveUser,
+  GaddTime,
+  GremoveTime,
+  Gdata,
+} = require("djs-builder");
+```
+
+---
+
+<details>
+<summary>🎬 Gstart – Launch a Brand New Giveaway</summary>
+
+### 🎬 **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`).
+
+```js
+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 started successfully!");
+  },
+};
+```
+
+> 💡 **Tip:** This example provides a fast and minimalist way to start a giveaway with the default reaction type (emoji reaction).
 
 ---
 
+**⚡ Full Customization Example (Demonstrating all options):**
+
+This example showcases all available configuration options for deep customization of the embeds and the button entry method.
+
+```js
+const { Gstart } = require("djs-builder");
+const { EmbedBuilder } = require("discord.js");
+
+module.exports = {
+  name: "gstart",
+  description: "Starts a new highly-customized giveaway.",
+  run: async (client, message, args) => {
+    // ⏰ Giveaway ends in 48 hours
+    const twoDays = 48 * 60 * 60 * 1000;
+    const channelId = 'YOUR_GIVEAWAY_CHANNEL_ID'; // 📢 Target Channel
+
+    await Gstart({
+      context: message,
+      endTime: twoDays,
+      winers: 5, // 5 lucky winners! 🏆
+      channelId: channelId,
+
+      // 🎨 Customization for the STARTING EMBED
+      embed: {
+
+            custom: new EmbedBuilder().setTitle("Raw Embed").toJSON(),// 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
+            title: "🎉 **HUGE SERVER BOOST GIVEAWAY!**",
+            description: "Click the button below to enter for a chance to win a free server boost!",
+            color: "Blue", // Any valid Discord color
+            image: "https://yourimage.com/banner.png", 🖼️
+            thumbnail: message.guild.iconURL(),
+      },
+
+      // 🛑 Customization for the ENDED EMBED
+      endEmbed: {
+            custom: new EmbedBuilder().setTitle("Raw Embed").toJSON(),// 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
+            title: "🛑 Giveaway Has Concluded!",
+            description: "Congratulations to the winners! Check the message below.",
+            color: "Green",
+            // Eimage and Ethumbnail can also be set here
+      },
+
+      // 🖱️ Button Entry Method
+      reaction: {
+        type: "button", // Use 'reaction' for an emoji reaction
+        emoji: "✅", // The emoji displayed on the button
+        label: "Enter Giveaway!", // The text label
+        style: 3, // Button style: Primary(1), Secondary(2), Success(3), Danger(4)
+        id: "giveaway", // Custom ID for the button
+
+      },
+    });
+    message.reply("🎉 Giveaway started successfully!");
+  },
+};
+```
+
+> 💡 **Flexibility Tip:** You can safely remove any option you do not wish to use (e.g., remove `endEmbed` entirely if you are happy with the default end message structure). 🗑️
+
+</details>
+
+---
+
+<details>
+<summary>⚠️ mportant Notes</summary>
+
+### ⚠️ **Important Notes** – _Read Before Use\!_ 🚨
+
+This module requires specific setup steps to function correctly. Pay attention to the following crucial points:
+
+- **1. The Gcheck Requirement (Monitor):**
+
+  - The **`Gcheck(client)`** function is responsible for **monitoring** and **ending** the giveaways once their time runs out.
+  - **Failure to call `Gcheck(client)`** when your bot starts (e.g., in the `clientReady` event) will result in **giveaways never ending automatically\!** 🛑
+
+- **2. Button Entry vs. InteractionCreate:**
+
+  - If you set `reaction.type` to **`button`** in `Gstart`, the system will create the button but **will NOT automatically register the participants.**
+  - You **MUST** manually implement a listener for the **`interactionCreate`** event and use the **`GaddUser`** function to register the user entry when the button is clicked. 🖱️
+  - _See the `GaddUser` section for a detailed code example._
+
+</details>
+
+---
+
+<details>
+<summary>📆 Gcheck – Monitor and End Time-Expired Giveaways</summary>
+
+### 📆 **Gcheck** – Monitor and End Time-Expired Giveaways 🔎
+
+This function runs periodically (every 10 seconds ⏱️) to check all active, non-paused giveaways. It automatically concludes contests that have passed their `endTime`. **_This function must be called once when the bot starts up._** 🚀
+
+**⚡ Simple Example (in your `clientReady` event):**
+
+```js
+const { Gcheck } = require("djs-builder");
+
+module.exports = {
+  name: "clientReady",
+  once: true,
+  run: (client) => {
+    console.log(`🤖 Bot is ready and monitoring giveaways...`);
+    Gcheck(client); // 👈 Start the continuous check loop!
+  },
+};
+```
+
+</details>
+
+---
+
+<details>
+<summary>🔄 Greroll – Redraw Winners for an Ended Contest</summary>
+
+### 🔄 **Greroll** – Redraw Winners for an Ended Contest 🎲
+
+Used to redraw one or more new winners for a **completed** giveaway. It sends a new announcement message with the updated winners.
+
+**⚙️ Options:**
+
+- `client`: The Discord Client object. 🤖
+- `messageId`: The Message ID of the giveaway post. 🆔
+
+**⚡ Simple Example:**
+
+```js
+const { Greroll } = require("djs-builder");
+
+module.exports = {
+  name: "reroll",
+  description: "Redraws winners for an ended giveaway.",
+  Permissions: ["MANAGE_MESSAGES"], // 🛡️ Permission check
+  run: async (client, message, args) => {
+    const id = args[0];
+    if (!id)
+      return message.reply(
+        "❌ **Error:** Please provide the Giveaway Message ID."
+      );
+    const result = await Greroll(client, id);
+    if (result?.error) {
+      return message.reply(`⚠️ **Reroll Failed:** ${result.error}`);
+    } else {
+      message.reply(`✅ **Success!** Reroll initiated for giveaway \`${id}\`.`);
+    }
+  },
+};
+```
+
+</details>
+
+---
+
+<details>
+<summary>📜 Glist – Retrieve List of Giveaways</summary>
+
+### 📜 **Glist** – Retrieve List of Giveaways 📋
+
+Fetches a list of all saved giveaways based on their current status.
+
+**⚙️ Options:**
+
+- `type`: Can be **`ended`**, **`active`**, **`paused`**, or **`all`**. 🌐
+
+**⚡ Simple Example:**
+
+```js
+const { Glist } = require("djs-builder");
+
+// Retrieve all currently active (non-paused, non-ended) giveaways
+const activeGiveaways = await Glist("active");
+
+if (activeGiveaways.length > 0) {
+  console.log(`✅ Found ${activeGiveaways.length} Active Giveaways.`); // ... You can format and display this list to the user
+} else {
+  console.log("No active giveaways found.");
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>⏸️ Gpause &▶️ Gresume – Stop and Continue Contests</summary>
+
+### ⏸️ **Gpause** & ▶️ **Gresume** – Stop and Continue Contests 🛑
+
+Allows you to temporarily halt an ongoing giveaway, preserving the remaining time, and then resume it later. The message embed is automatically updated to reflect the pause/resume status.
+
+**⚙️ Options:**
+
+- `client`: The Discord Client object. 🤖
+- `messageId`: The Message ID of the giveaway post. 🆔
+
+**⚡ Simple Example (for a management command):**
+
+```js
+const { Gpause, Gresume } = require("djs-builder");
+
+module.exports = {
+  name: "g_manage",
+  description: "Pause or resume a giveaway.",
+  devOnly: true, // 👑 Developer only access
+  run: async (client, message, args) => {
+    const [action, id] = args;
+    if (!action || !id) return message.reply("⚠️ Missing action or ID.");
+
+    if (action === "pause") {
+      const result = await Gpause(client, id);
+      if (result?.error) return message.reply(`❌ ${result.error}`);
+      message.reply("⏸️ Giveaway successfully **paused**!");
+    } else if (action === "resume") {
+      const result = await Gresume(client, id);
+      if (result?.error) return message.reply(`❌ ${result.error}`);
+      message.reply("▶️ Giveaway successfully **resumed**!");
+    }
+  },
+};
+```
+
+</details>
+
+---
+
+<details>
+<summary>🗑️ Gdelete – Permanently Remove Giveaway Data</summary>
+
+### 🗑️ **Gdelete** – Permanently Remove Giveaway Data 🗄️
+
+Deletes the giveaway record entirely from the database. _Note: This does not delete the Discord message itself, only the data._
+
+**⚙️ Options:**
+
+- `messageId`: The Message ID of the giveaway post. 🆔
+
+**⚡ Simple Example:**
+
+```js
+const { Gdelete } = require("djs-builder");
+
+module.exports = {
+  name: "gdelete",
+  run: async (client, message, args) => {
+    const messageId = args[0];
+    const result = await Gdelete(messageId);
+    if (result?.delete) {
+      message.reply(
+        `✅ **Success:** Giveaway data for \`${messageId}\` has been permanently deleted.`
+      );
+    } else {
+      message.reply(
+        `❌ **Error:** ${result?.error || "Could not delete giveaway data."}`
+      );
+    }
+  },
+};
+```
+
+</details>
+
+---
+
+<details>
+<summary>👤 GaddUser & GremoveUser – Manual Participant Control</summary>
+
+### ➕ **GaddUser** & ➖ **GremoveUser** – Manual Participant Control 🧑‍🤝‍🧑
+
+These functions allow you to manually add or remove user IDs from the participant list. This is **crucial** when setting the giveaway `reaction` type to **`button`**.
+
+**⚙️ Options:**
+
+- `messageId`: The Message ID of the giveaway. 🆔
+- `userId`: The ID of the user to add/remove. 👤
+
+---
+
+#### 💡 **InteractionCreate Setup (for Button Entry)** 🖱️
+
+When using the `button` type, you **MUST** implement the following listener to handle join/leave actions dynamically.
+
+**⚡ Example Code for Dynamic Join/Leave in `interactionCreate` Event:**
+
+```js
+const { GaddUser, GremoveUser, CreateRow } = require("djs-builder");
+
+module.exports = {
+  name: "interactionCreate",
+  run: async (interaction) => {
+    // 1. Handle Join/Entry Button Click
+    if (interaction.customId === "djs-builder-giveaway") {
+      const result = await GaddUser(
+        interaction.message.id,
+        interaction.user.id
+      );
+
+      if (result?.error === "❌ User Already Joined") {
+        // User already joined, offer a 'Leave' button dynamically
+        const row = await CreateRow([
+          [
+            {
+              label: "Leave Giveaway",
+              id: "djs-builder-giveaway-leave-" + interaction.message.id, // Dynamic ID
+              style: 4, // Danger Red
+            },
+          ],
+        ]);
+        return interaction.reply({
+          content:
+            "⚠️ You have **already joined** this giveaway! You can **leave** by clicking the button below.",
+          components: row,
+          flags: 64, // Ephemeral reply
+        });
+      }
+
+      await interaction.reply({
+        content: "🎉 **Success!** Your entry has been registered!",
+        flags: 64,
+      });
+    }
+
+    // 2. Handle Leave Button Click (Dynamically Generated ID)
+    if (
+      interaction.customId &&
+      interaction.customId.startsWith("djs-builder-giveaway-leave-")
+    ) {
+      const id = interaction.customId.split("-")[4]; // Extract message ID
+      const result = await GremoveUser(id, interaction.user.id);
+
+      // Note: The error message should ideally reflect the module's logic (User Not Joined)
+      if (result?.error && result.error.includes("User Not Joined")) {
+        return interaction.reply({
+          content: "⚠️ You have **already left** this giveaway!",
+          flags: 64,
+        });
+      }
+
+      await interaction.reply({
+        content: "🎉 **Success!** Your entry has been removed!",
+        flags: 64,
+      });
+    }
+  },
+};
+```
+
+</details>
+
+---
+
+<details>
+<summary>⏰ GaddTime & GremoveTime – Adjust the End Time</summary>
+
+### ➕ **GaddTime** & ➖ **GremoveTime** – Adjust the End Time 🕰️
+
+Allows you to extend or shorten the duration of an active giveaway.
+
+**⚙️ Options:**
+
+- `messageId`: The Message ID of the giveaway. 🆔
+- `client`: The Discord Client object. 🤖
+- `time`: The amount of time (in **milliseconds** ⏳) to add or remove.
+
+**⚡ Simple Example (Extending the Giveaway):**
+
+```js
+const { GaddTime } = require("djs-builder");
+
+// Extend the contest by 30 minutes (1,800,000 MS)
+const halfHour = 30 * 60 * 1000;
+const result = await GaddTime(messageId, client, halfHour);
+
+if (result?.error) {
+  console.log(`Error adding time: ${result.error}`);
+} else {
+  console.log("Time successfully added!");
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>📊 Gdata – Retrieve Giveaway Data</summary>
+
+### 📊 **Gdata** – Retrieve Giveaway Data 💾
+
+Fetches all saved data for a specific giveaway message.
+
+**⚙️ Options:**
+
+- `messageId`: The Message ID of the giveaway. 🆔
+
+**⚡ Simple Example:**
+
+```js
+const { Gdata } = require("djs-builder");
+
+const giveawayData = await Gdata(messageId);
+
+if (giveawayData) {
+  console.log(`Giveaway hosted by: <@${giveawayData.hoster}>`);
+  console.log(`Current status: ${giveawayData.ended ? "Ended" : "Active"}`);
+} else {
+  console.log("No data found for this message ID.");
+}
+```
+
+---
+
+📊 **`Gdata(messageId)`** – Returned Object Structure
+
+- it like :
+
+```js
+{
+  "_id": "651234567890abcdef12345678", // 🔑 MongoDB unique ID
+  "ended": false, // 💡 Current status of the giveaway
+  "guildId": "123456789012345678", // 🏠 Server ID
+  "channelId": "876543210987654321", // 📢 Channel ID
+  "messageId": "987654321098765432", // 💬 Message ID of the giveaway post
+  "hoster": "112233445566778899", // 👤 User ID of the giveaway host
+  "winwesNumber": 1, // 🔢 Number of winners set
+  "winers": [], // 🏆 Array of user IDs who won (empty if not ended)
+  "paused": false, // ⏸️ True if the giveaway is paused
+  "pausedTime": [], // ⏱️ Array of saved remaining times (used for resume)
+  "endTime": "1730995200000", // 📅 Timestamp (MS) of when the giveaway should end
+  "endType": "Time End", // 📝 How the giveaway ended (e.g., Time End, Reroll: 1 time(s))
+  "reaction": "button", // 🖱️ Entry method: "reaction" or "button"
+  "users": ["111111111111111111", "222222222222222222"], // 🧑‍🤝‍🧑 Array of user IDs who entered (used for button type)
+  "endEmbed": {
+    "title": "🛑 Giveaway Has Concluded!",
+    "description": "Congratulations to the winners!",
+    "color": 3066993, // Green color code
+    "fields": [
+      {
+        "name": "🎉 Giveaway",
+        "value": "- Winer(s): 1\n- Time : <t:1730995200:R>\n- Hosted By : <@112233445566778899>",
+        "inline": true
+      }
+    ]
+  },
+  "__v": 0 // 🌐 Mongoose version key (internal)
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>✨ General Code Example</summary>
+
+### 💡 General Code Example – The All-in-One `/giveaway` Command 🛠️
+
+This complete example demonstrates how to integrate **all** functions of the Giveaway System into a single Discord Slash Command, `/giveaway`, using subcommands for clean management.
+
+```js
+const {
+  Gstart,
+  Greroll,
+  Glist,
+  Gpause,
+  Gresume,
+  Gdelete,
+  GaddUser,
+  GremoveUser,
+  GaddTime,
+  GremoveTime,
+  Gdata,
+} = require("djs-builder");
+const {
+  SlashCommandBuilder,
+  EmbedBuilder,
+  AttachmentBuilder,
+} = require("discord.js");
+const ms = require("ms");
+
+module.exports = {
+  data: new SlashCommandBuilder()
+    .setName("giveaway")
+    .setDescription("Comprehensive giveaway system management")
+
+    // 🎬 /giveaway start
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("start")
+        .setDescription("Starts a new giveaway")
+        .addStringOption((option) =>
+          option
+            .setName("prize")
+            .setDescription("The prize for the winner(s)")
+            .setRequired(true)
+        )
+        .addStringOption((option) =>
+          option
+            .setName("time")
+            .setDescription("Duration (e.g., 1h, 30m, 7d)")
+            .setRequired(true)
+        )
+        .addStringOption((option) =>
+          option
+            .setName("winner")
+            .setDescription("Number of winners (e.g., 1, 3)")
+            .setRequired(true)
+        )
+        .addChannelOption((option) =>
+          option
+            .setName("channel")
+            .setDescription("The channel to post the giveaway in")
+        )
+        .addStringOption((option) =>
+          option
+            .setName("description")
+            .setDescription("Custom description for the giveaway embed")
+        )
+        .addStringOption((option) =>
+          option
+            .setName("image")
+            .setDescription("Image URL for the embed banner")
+        )
+        .addStringOption((option) =>
+          option
+            .setName("thumbnail")
+            .setDescription("Thumbnail URL for the embed")
+        )
+    )
+
+    // 🔄 Management Commands: /giveaway reroll, pause, resume, delete, data
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("reroll")
+        .setDescription("Redraw winners for an ended giveaway")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("pause")
+        .setDescription("Pause an active giveaway")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("resume")
+        .setDescription("Resume a paused giveaway")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("delete")
+        .setDescription("Delete a giveaway's data")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("data")
+        .setDescription("Get raw data for a giveaway")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+    )
+
+    // 🧑‍🤝‍🧑 User Entry Management: /giveaway adduser, removeuser
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("adduser")
+        .setDescription("Manually add user to giveaway (button entry only)")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+        .addUserOption((option) =>
+          option.setName("user").setDescription("User to add").setRequired(true)
+        )
+    )
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("removeuser")
+        .setDescription(
+          "Manually remove user from giveaway (button entry only)"
+        )
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+        .addUserOption((option) =>
+          option
+            .setName("user")
+            .setDescription("User to remove")
+            .setRequired(true)
+        )
+    )
+
+    // ⏱️ Time Modification: /giveaway addtime, removetime
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("addtime")
+        .setDescription("Add time to an active giveaway")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+        .addStringOption((option) =>
+          option
+            .setName("time")
+            .setDescription("Time to add (e.g., 30m, 1h)")
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("removetime")
+        .setDescription("Remove time from an active giveaway")
+        .addStringOption((option) =>
+          option
+            .setName("id")
+            .setDescription("Giveaway message ID")
+            .setRequired(true)
+        )
+        .addStringOption((option) =>
+          option
+            .setName("time")
+            .setDescription("Time to remove (e.g., 10m)")
+            .setRequired(true)
+        )
+    )
+    // 📜 giveaways list
+    .addSubcommand((subcommand) =>
+      subcommand
+        .setName("list")
+        .setDescription("List giveaways")
+        .addStringOption((option) =>
+          option
+            .setName("type")
+            .setDescription("Type of giveaways to list")
+            .setRequired(true)
+            .addChoices(
+              { name: "Ended", value: "ended" },
+              { name: "Active", value: "active" },
+              { name: "Paused", value: "paused" },
+              { name: "All", value: "all" }
+            )
+        )
+    ),
+
+  // ⚙️ Command Execution
+  run: async (interaction, client) => {
+    await interaction.deferReply({ flags: 64 }); // Acknowledge command immediately
+
+    const command = interaction.options.getSubcommand();
+    const id = interaction.options.getString("id");
+
+    if (command === "start") {
+      // 🚀 START LOGIC
+      const channel =
+        interaction.options.getChannel("channel") || interaction.channel;
+      const description = interaction.options.getString("description");
+      const image = interaction.options.getString("image");
+      const thumbnail = interaction.options.getString("thumbnail");
+      const timeString = interaction.options.getString("time");
+      const winnerCount = parseInt(interaction.options.getString("winner"));
+      const prize = interaction.options.getString("prize");
+
+      const durationMs = ms(timeString);
+const endTimeMs = Date.now() + durationMs;
+
+
+      if (!durationMs) {
+        return interaction.editReply(
+          "❌ **Error:** Invalid time format provided (e.g., 1h, 30m)."
+        );
+      }
+      if (isNaN(winnerCount) || winnerCount < 1) {
+        return interaction.editReply(
+          "❌ **Error:** Winner count must be a number greater than 0."
+        );
+      }
+
+      const giveaway = await Gstart({
+        context: interaction,
+        channelId: channel.id,
+        winers: winnerCount,
+        endTime: endTimeMs,
+        embed: {
+          title: `🎉 ${prize} Giveaway!`,
+          image: image,
+          thumbnail: thumbnail,
+          description: description,
+        },
+        reaction: {
+          type: "button",
+          label: "Enter Giveaway",
+          style: 1,
+          emoji: "🎉",
+        },
+      });
+
+      if (giveaway?.error) {
+        return interaction.editReply(`❌ **Error:** ${giveaway.error}`);
+      }
+
+      return interaction.editReply(
+        `✅ **Success!** Giveaway for **${prize}** has been started in ${channel}!`
+      );
+    } else if (command === "list") {
+      // 📜 LIST LOGIC
+      const type = interaction.options.getString("type");
+      const giveaways = await Glist(type);
+      const MAX_EMBED_LENGTH = 4000;
+      const MAX_MESSAGE_LENGTH = 2000;
+
+      if (!giveaways || giveaways.length === 0) {
+        return interaction.editReply(`❌ No **${type}** giveaways found.`);
+      }
+
+      const listContent = giveaways
+        .map(
+          (g, i) =>
+            `**#${i + 1}** | ID: \`${g.messageId}\` | Hoster: <@${
+              g.hoster
+            }> | End: <t:${Math.floor(g.endTime / 1000)}:R>`
+        )
+        .join("\n");
+
+      const title = `📜 **${type.toUpperCase()} Giveaways:** (${
+        giveaways.length
+      } found)`;
+
+
+      if (listContent.length <= MAX_MESSAGE_LENGTH) {
+        // Output as a simple message (Under 2000 chars)
+        return interaction.editReply({
+          content: `${title}\n\n${listContent}`,
+        });
+      } else if (listContent.length <= MAX_EMBED_LENGTH) {
+        // Output as an Embed (Over 2000, under 4096)
+        const embed = new EmbedBuilder()
+          .setTitle(title.replace(/\*\*/g, ""))
+          .setDescription(listContent)
+          .setColor("Blue");
+
+        return interaction.editReply({
+          content: `Too many results for a single message, displaying via Embed.`,
+          embeds: [embed],
+        });
+      } else {
+        // Output as an attachment/JSON file (Over 4096 chars)
+        const jsonFile = new AttachmentBuilder(
+          Buffer.from(JSON.stringify(giveaways, null, 2)),
+          { name: `${type}_giveaways_list.json` }
+        );
+
+        return interaction.editReply({
+          content: `⚠️ **Warning:** The list is too long! Sending ${giveaways.length} results in a JSON file.`,
+          files: [jsonFile],
+        });
+      }
+    } else if (command === "pause") {
+      // ⏸️ PAUSE LOGIC
+      const result = await Gpause(client, id);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `⏸️ Giveaway \`${id}\` paused successfully!`
+      );
+    } else if (command === "resume") {
+      // ▶️ RESUME LOGIC
+      const result = await Gresume(client, id);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `▶️ Giveaway \`${id}\` resumed successfully!`
+      );
+    } else if (command === "reroll") {
+      // 🔄 REROLL LOGIC
+      const result = await Greroll(client, id);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `🔄 Reroll command sent for giveaway \`${id}\`! Check the channel for the new winner.`
+      );
+    } else if (command === "delete") {
+      // 🗑️ DELETE LOGIC
+      const result = await Gdelete(id);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `🗑️ Giveaway data for \`${id}\` deleted successfully!`
+      );
+
+      // ➕ USER MANAGEMENT LOGIC
+    } else if (command === "adduser") {
+      const user = interaction.options.getUser("user");
+      const result = await GaddUser(id, user.id);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `➕ User **${user.tag}** added to giveaway \`${id}\`.`
+      );
+    } else if (command === "removeuser") {
+      // ➖ REMOVE USER LOGIC
+      const user = interaction.options.getUser("user");
+      const result = await GremoveUser(id, user.id);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `➖ User **${user.tag}** removed from giveaway \`${id}\`.`
+      );
+
+      // ⏳ TIME MANAGEMENT LOGIC
+    } else if (command === "addtime") {
+      const timeString = interaction.options.getString("time");
+      const timeMs = ms(timeString);
+
+      if (!timeMs) {
+        return interaction.editReply(
+          "❌ **Error:** Invalid time format provided (e.g., 1h, 30m)."
+        );
+      }
+
+      const result = await GaddTime(id, client, timeMs);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `⏱️ Added ${timeString} to giveaway \`${id}\`.`
+      );
+    } else if (command === "removetime") {
+      // ⏪ REMOVE TIME LOGIC
+      const timeString = interaction.options.getString("time");
+      const timeMs = ms(timeString);
+
+      if (!timeMs) {
+        return interaction.editReply(
+          "❌ **Error:** Invalid time format provided (e.g., 1h, 30m)."
+        );
+      }
+
+      const result = await GremoveTime(id, client, timeMs);
+      if (result?.error)
+        return interaction.editReply(`❌ **Error:** ${result.error}`);
+      return interaction.editReply(
+        `⏱️ Removed ${timeString} from giveaway \`${id}\`.`
+      );
+
+      // 📊 DATA LOGIC
+    } else if (command === "data") {
+      const id = interaction.options.getString("id");
+      console.log(id);
+    const data = await Gdata(id);
+    if (data?.error)
+        return interaction.editReply(`❌ **Error:** ${data.error}`);
+
+   
+    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 
+        },
+        { 
+            name: "🏆 Winners", 
+            value: data.winwesNumber.toString(), 
+            inline: true 
+        },
+        { 
+            name: "🙋‍♂️ Hoster", 
+            value: `<@${data.hoster}>`, 
+            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: "🖱️ Entry Type", 
+            value: data.reaction.toUpperCase(), 
+            inline: true 
+        }
+    );
+
+   
+    if (data.ended && data.winers.length > 0) {
+        giveawayEmbed.addFields({
+            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}\`.`
+    });
+}
+  },
+};
+
+```
+
+---
+
+<summary>📝 Final Improvements and Notes: ✨🚀</summary>
+
+### 📝 Final Improvements and Notes: ✨🚀
+
+- **1. Time Parsing via `ms`:** ⏰⏳
+
+  - for time inputs (e.g., `1h`, `30m`) to be correctly converted into milliseconds.
+
+- **2. List Command Robustness:** 📜🛡️
+
+  - The **`list`** command logic handles large result sets automatically to avoid the Discord 2000-character limit error:
+    - Under 2000 characters: Sent as a direct, formatted message.
+    - Between 2000 and 4000 characters: Sent inside an **EmbedBuilder**.
+    - Over 4000 characters: Sent as a **JSON attachment**, preventing API errors.
+
+- **3. Function Call Integrity:** ⚙️✅
+
+  - The **`client`** object is correctly passed to **`GaddTime`** and **`GremoveTime`** (`id, client, timeMs`), meeting the module's requirements for management functions.
+
+- **4. Enhanced User Experience (UX):** 🎯🌟
+
+  - The `channel` option uses **`.addChannelOption()`** for a native Discord selector.
+  - Validation is included for **`winnerCount`** and time formats. 🚫
+
+- **5. Private and Immediate Feedback:** 🔒💬
+
+  - Uses **`interaction.deferReply({ flags: 64 })`** (ephemeral/private) and **`interaction.editReply()`** for fast, clean, and non-intrusive status updates.
+
+</details>
+
+</details>
+
+---
+
+## ⚡ Commands & Events
+
 **💡 Commands & Events made easy!**
 With `djs-builder`, handling **commands** and **events** is smooth, fast, and fully customizable.
 You get built-in features like: