djs-builder 0.7.2 → 0.7.4

package/README.md

@@ -73,11 +73,10 @@ const starterOptions = {
 
   // 🌐 Dashboard Configuration (Full docs at the end of this page)
   dashboard: {
-    clientID: "YOUR_DISCORD_CLIENT_ID",        // 🔑 Discord Application Client ID
     clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
-    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL
-    sessionSecret: "your-super-secret-key",    // 🔒 Session encryption secret
-    port: 3000,                                 // 🌍 Dashboard port (default: 3000)
+    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)
   },
 };
 
@@ -507,11 +506,26 @@ message.reply(`🚫 ${member.user.tag} was banned for: ${reason}`);
 ---
 
 <details>
-  <summary>Logging System 🛡️</summary>
+<summary>Logging System 🛡️</summary>
+
+## 🛡️ 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
+
+```js
+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 💾.
+
 ---
 
 ### ✨ Features
@@ -522,15 +536,70 @@ From **messages** 📝 to **channels** 📂, **roles** 🎭, **invites** 🔗, a
 - 🎙️ **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:
+
+```js
+{
+  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)
+}
+```
 
 ---
 
-### ⚙️ Setup Example
+<details>
+<summary>📋 Supported Event Types</summary>
+
+### 📋 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 🌀        |
+
+</details>
+
+---
 
-Using the `log` function is very simple ⚡.  
-Just place this code inside an event (like `clientReady`) to start logging:
+<details>
+<summary>⚡ Method Using Database (Recommended) 🗄️</summary>
+
+### 🗄️ Using MongoDB Database
+
+This method stores log configuration in MongoDB, allowing dynamic management via commands.
+
+**⚡ Setup in `clientReady` Event:**
 
 ```js
 const { log } = require("djs-builder");
@@ -538,11 +607,12 @@ const { log } = require("djs-builder");
 module.exports = {
   name: "clientReady",
   async run(client) {
-    await log(
-      client,
-      "GUILD_ID", // 🏠 Guild ID (server)
-      "CHANNEL_ID" // 📢 Channel ID for logs
-    );
+    // Start logging with database mode
+    await log(client, {
+      database: true, // 🗄️ Uses MongoDB to store/fetch config
+    });
+
+    console.log("✅ Logging system started with database mode!");
   },
 };
 ```
@@ -551,9 +621,601 @@ module.exports = {
 
 ### 💡 How It Works
 
-- ✅ Pass your **Client**, **Guild ID**, and **Log Channel ID**.
-- 🔔 Instantly starts tracking events and sending them to the log channel.
-- 🧰 No extra setup required – plug and play!
+- ✅ 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](#-slash-command-for-log-management-) below to edit data.
+
+</details>
+
+---
+
+<details>
+<summary>⚡ Method Using Custom Data Array 📋</summary>
+
+### 📋 Using Custom Data Array
+
+This method uses a predefined array of configurations – perfect for simple setups or testing.
+
+**⚡ Setup in `clientReady` Event:**
+
+```js
+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!
+
+</details>
+
+---
+
+<details>
+<summary>🔧 Direct Database Access with Log Model 💾</summary>
+
+### 💾 Using the Log Model Directly
+
+You can import the `Log` Mongoose model to create, update, or delete log configurations programmatically.
+
+**📥 Import the Model:**
+
+```js
+const { Log } = require("djs-builder");
+```
+
+**➕ Create New Configuration:**
+
+```js
+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:**
+
+```js
+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:**
+
+```js
+const { Log } = require("djs-builder");
+
+await Log.findOneAndDelete({ guildId: "123456789012345678" });
+console.log("🗑️ Log configuration deleted!");
+```
+
+**📊 Fetch Configuration:**
+
+```js
+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);
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>🌐 Dashboard Integration – Manage Logs from Web Panel 🖥️</summary>
+
+### 🖥️ 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
+
+</details>
+
+---
+
+<details>
+<summary>🎮 Slash Command for Log Management 🛠️</summary>
+
+### 🛠️ 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.
+
+```js
+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] });
+    }
+  },
+};
+```
+
+</details>
+
+---
+
+### 💡 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!
+
+---
 
 </details>
 
@@ -809,55 +1471,54 @@ 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 = Date.now() + (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,
+  name: "gstart",
+  description: "Starts a new highly-customized giveaway.",
+  run: async (client, message, args) => {
+    // ⏰ Giveaway ends in 48 hours
+    const twoDays = Date.now() + 48 * 60 * 60 * 1000;
+    const channelId = "YOUR_GIVEAWAY_CHANNEL_ID"; // 📢 Target Channel
 
-      // 🎨 Customization for the STARTING EMBED
-      embed: {
+    await Gstart({
+      context: message,
+      endTime: twoDays,
+      winers: 5, // 5 lucky winners! 🏆
+      channelId: channelId,
 
-            custom: new EmbedBuilder().setTitle("Raw Embed"),// 💡 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", // image URL
-            thumbnail: message.guild.iconURL(),
-      },
+      // 🎨 Customization for the STARTING EMBED
+      embed: {
+        custom: new EmbedBuilder().setTitle("Raw Embed"), // 💡 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", // image URL
+        thumbnail: message.guild.iconURL(),
+      },
 
       // 🛑 Customization for the ENDED EMBED
-      endEmbed: {
-            custom: new EmbedBuilder().setTitle("Raw Embed"),// 💡 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
-      },
+      endEmbed: {
+        custom: new EmbedBuilder().setTitle("Raw Embed"), // 💡 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: "djs-builder-giveaway", // Custom ID for the button
-      },
+      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: "djs-builder-giveaway", // Custom ID for the button
+      },
 
       // 🔒 Requirements (Optional)
       requirements: {
         requiredRoles: ["123456789012345678"], // 🛡️ User MUST have this role to join (Button Only)
       },
-    });
-    message.reply("🎉 Giveaway started successfully!");
-  },
+    });
+    message.reply("🎉 Giveaway started successfully!");
+  },
 };
 ```
 
@@ -1103,14 +1764,14 @@ module.exports = {
       const result = await GaddUser(
         interaction.message.id,
         interaction.user.id,
-        interaction.guild 
+        interaction.guild
       );
 
       if (result?.error) {
         // Handles both "User Already Joined" and "Missing Roles" errors
         if (result.error === "❌ User Already Joined") {
-           // ... (Leave button logic)
-           const row = await CreateRow([
+          // ... (Leave button logic)
+          const row = await CreateRow([
             [
               {
                 label: "Leave Giveaway",
@@ -1120,16 +1781,17 @@ module.exports = {
             ],
           ]);
           return interaction.reply({
-            content: "⚠️ You have **already joined** this giveaway! You can **leave** by clicking the button below.",
+            content:
+              "⚠️ You have **already joined** this giveaway! You can **leave** by clicking the button below.",
             components: row,
-            flags: 64, 
+            flags: 64,
           });
         }
-        
+
         // Show error (e.g. Missing Role)
         return interaction.reply({
-            content: result.error,
-            flags: 64
+          content: result.error,
+          flags: 64,
         });
       }
 
@@ -1139,7 +1801,6 @@ module.exports = {
       });
     }
 
-
     // 2. Handle Leave Button Click (Dynamically Generated ID)
     if (
       interaction.customId &&
@@ -1534,7 +2195,7 @@ module.exports = {
         channelId: channel.id,
         winers: winnerCount,
         endTime: endTimeMs,
-        prize : prize,
+        prize: prize,
         embed: {
           title: `🎉 ${prize} Giveaway!`,
           image: image,
@@ -1810,7 +2471,6 @@ module.exports = {
 
 ---
 
-
 <details>
 <summary>Blacklist System 🚫</summary>
 
@@ -1882,10 +2542,12 @@ console.log("Role unblacklisted! 🔓");
 Returns an array of blacklisted items for a guild. You can optionally filter by type (`user`, `role`, `channel`).
 
 **Parameters:**
+
 - `guildId` (String): The ID of the guild.
 - `type` (String, optional): The type to filter by (`user`, `role`, `channel`).
 
 **Example:**
+
 ```js
 // Get all blacklisted items
 const allBlacklisted = await getBlacklist("GUILD_ID");
@@ -1910,35 +2572,80 @@ Output:
 You can create a slash command to manage the blacklist easily.
 
 ```js
-const { addToBlacklist, removeFromBlacklist, isBlacklisted, getBlacklist } = require("djs-builder");
-const { SlashCommandBuilder, PermissionFlagsBits, EmbedBuilder } = require("discord.js");
+const {
+  addToBlacklist,
+  removeFromBlacklist,
+  isBlacklisted,
+  getBlacklist,
+} = require("djs-builder");
+const {
+  SlashCommandBuilder,
+  PermissionFlagsBits,
+  EmbedBuilder,
+} = require("discord.js");
 
 module.exports = {
   data: new SlashCommandBuilder()
     .setName("blacklist")
     .setDescription("Manage the blacklist")
     .setDefaultMemberPermissions(PermissionFlagsBits.Administrator)
-    .addSubcommand(sub =>
-      sub.setName("add").setDescription("Add to blacklist")
-        .addUserOption(opt => opt.setName("user").setDescription("User to blacklist"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to blacklist"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to blacklist"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("add")
+        .setDescription("Add to blacklist")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to blacklist")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to blacklist")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to blacklist")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("remove").setDescription("Remove from blacklist")
-        .addUserOption(opt => opt.setName("user").setDescription("User to remove"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to remove"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to remove"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("remove")
+        .setDescription("Remove from blacklist")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to remove")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to remove")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to remove")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("check").setDescription("Check if a target is blacklisted")
-        .addUserOption(opt => opt.setName("user").setDescription("User to check"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to check"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to check"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("check")
+        .setDescription("Check if a target is blacklisted")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to check")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to check")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to check")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("list").setDescription("List all blacklisted items")
-        .addStringOption(opt => opt.setName("type").setDescription("Filter by type").addChoices({ name: "User", value: "user" }, { name: "Role", value: "role" }, { name: "Channel", value: "channel" } , { name: "All", value: "all" }))
+    .addSubcommand((sub) =>
+      sub
+        .setName("list")
+        .setDescription("List all blacklisted items")
+        .addStringOption((opt) =>
+          opt
+            .setName("type")
+            .setDescription("Filter by type")
+            .addChoices(
+              { name: "User", value: "user" },
+              { name: "Role", value: "role" },
+              { name: "Channel", value: "channel" },
+              { name: "All", value: "all" }
+            )
+        )
     ),
   async run(interaction) {
     const sub = interaction.options.getSubcommand();
@@ -1948,54 +2655,95 @@ module.exports = {
     const guildId = interaction.guild.id;
 
     if (sub === "list") {
-        const type = interaction.options.getString("type");
-        if (type !== "all") {
+      const type = interaction.options.getString("type");
+      if (type !== "all") {
         const list = await getBlacklist(guildId, type);
 
-        if (!list.length) return interaction.reply({ content: "✅ No blacklisted items found.", flags : 64 });
+        if (!list.length)
+          return interaction.reply({
+            content: "✅ No blacklisted items found.",
+            flags: 64,
+          });
 
         const embed = new EmbedBuilder()
-            .setTitle("🚫 Blacklist")
-            .setColor("Red")
-            .setDescription(list.map(item => `• **${item.type.toUpperCase()}**: <${item.type === 'channel' ? '#' : item.type === 'role' ? '@&' : '@'}${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-
-        return interaction.reply({ embeds: [embed], flags : 64 });
-        } else {
+          .setTitle("🚫 Blacklist")
+          .setColor("Red")
+          .setDescription(
+            list
+              .map(
+                (item) =>
+                  `• **${item.type.toUpperCase()}**: <${
+                    item.type === "channel"
+                      ? "#"
+                      : item.type === "role"
+                      ? "@&"
+                      : "@"
+                  }${item.id}> (\`${item.id}\`)`
+              )
+              .join("\n")
+              .slice(0, 4000)
+          );
+
+        return interaction.reply({ embeds: [embed], flags: 64 });
+      } else {
         const list = await getBlacklist(guildId);
-        if (!list.length) return interaction.reply({ content: "✅ No blacklisted items found.", flags : 64 });
+        if (!list.length)
+          return interaction.reply({
+            content: "✅ No blacklisted items found.",
+            flags: 64,
+          });
 
         const embeds = [];
-        const roles = list.filter(i => i.type === "role");
-        const users = list.filter(i => i.type === "user");
-        const channels = list.filter(i => i.type === "channel");
+        const roles = list.filter((i) => i.type === "role");
+        const users = list.filter((i) => i.type === "user");
+        const channels = list.filter((i) => i.type === "channel");
 
         if (users.length) {
-            const userEmbed = new EmbedBuilder()
+          const userEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Users")
             .setColor("Red")
-            .setDescription(users.map(item => `• <@${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-            embeds.push(userEmbed);
+            .setDescription(
+              users
+                .map((item) => `• <@${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(userEmbed);
         }
-        if( roles.length) {
-            const roleEmbed = new EmbedBuilder()
+        if (roles.length) {
+          const roleEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Roles")
             .setColor("Red")
-            .setDescription(roles.map(item => `• <@&${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-            embeds.push(roleEmbed);
+            .setDescription(
+              roles
+                .map((item) => `• <@&${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(roleEmbed);
         }
-        if( channels.length) {
-            const channelEmbed = new EmbedBuilder()
+        if (channels.length) {
+          const channelEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Channels")
             .setColor("Red")
-            .setDescription(channels.map(item => `• <#${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-            embeds.push(channelEmbed);
+            .setDescription(
+              channels
+                .map((item) => `• <#${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(channelEmbed);
         }
-        return interaction.reply({ embeds, flags : 64 });
+        return interaction.reply({ embeds, flags: 64 });
+      }
     }
-  }
-  
+
     if (!user && !role && !channel) {
-      return interaction.reply({ content: "⚠️ You must provide at least one option (User, Role, or Channel).", flags : 64 });
+      return interaction.reply({
+        content:
+          "⚠️ You must provide at least one option (User, Role, or Channel).",
+        flags: 64,
+      });
     }
     const target = user || role || channel;
     const type = user ? "user" : role ? "role" : "channel";
@@ -2003,18 +2751,25 @@ module.exports = {
 
     if (sub === "add") {
       const success = await addToBlacklist(guildId, type, id);
-      if (success) interaction.reply(`✅ Added **${type}** ${target} to blacklist.`);
-      else interaction.reply(`⚠️ **${type}** ${target} is already blacklisted.`);
+      if (success)
+        interaction.reply(`✅ Added **${type}** ${target} to blacklist.`);
+      else
+        interaction.reply(`⚠️ **${type}** ${target} is already blacklisted.`);
     } else if (sub === "remove") {
       const success = await removeFromBlacklist(guildId, type, id);
-      if (success) interaction.reply(`✅ Removed **${type}** ${target} from blacklist.`);
+      if (success)
+        interaction.reply(`✅ Removed **${type}** ${target} from blacklist.`);
       else interaction.reply(`⚠️ **${type}** ${target} is not blacklisted.`);
     } else if (sub === "check") {
       const isBlocked = await isBlacklisted(guildId, type, id);
-      if (isBlocked) interaction.reply(`🚫 **${type}** ${target} is currently **blacklisted**.`);
-      else interaction.reply(`✅ **${type}** ${target} is **not** blacklisted.`);
+      if (isBlocked)
+        interaction.reply(
+          `🚫 **${type}** ${target} is currently **blacklisted**.`
+        );
+      else
+        interaction.reply(`✅ **${type}** ${target} is **not** blacklisted.`);
     }
-  }
+  },
 };
 ```
 
@@ -2160,6 +2915,7 @@ The **Dashboard System** is a modern, lightweight web-based control panel for yo
 - 📜 **Commands Viewer** – Browse all slash and prefix commands.
 - 🏆 **Level System Management** – View leaderboards, manage user XP and levels.
 - 🎉 **Giveaway Control** – Pause, resume, end, reroll, or delete giveaways.
+- 🦾 **Logging System Control** – Manage log channels, colors, and event toggles.
 - 🚫 **Blacklist Management** – Add/remove users, roles, or channels from blacklist.
 - 🎨 **Modern UI** – Beautiful, responsive design with dark mode support.
 
@@ -2191,11 +2947,10 @@ const starterOptions = {
 
   // 🌐 Dashboard Configuration
   dashboard: {
-    clientID: "YOUR_DISCORD_CLIENT_ID",        // 🔑 Discord Application Client ID
     clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
-    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL
-    sessionSecret: "your-super-secret-key",    // 🔒 Session encryption secret
-    port: 3000,                                 // 🌍 Dashboard port (default: 3000)
+    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)
   },
 
   // ... other options (Status, database, anticrash, etc.)
@@ -2229,11 +2984,10 @@ client.once("ready", () => {
 
   // 🌐 Start the Dashboard
   dashboard(client, {
-    clientID: "YOUR_DISCORD_CLIENT_ID",        // 🔑 Discord Application Client ID
     clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
-    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL
-    sessionSecret: "your-super-secret-key",    // 🔒 Session encryption secret
-    port: 3000,                                 // 🌍 Dashboard port (default: 3000)
+    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)
   });
 });
 ```
@@ -2249,15 +3003,16 @@ client.once("ready", () => {
 
 ### 📌 Dashboard Routes
 
-| Route | Description |
-|-------|-------------|
-| `/` | 🏠 Homepage with bot stats |
-| `/login` | 🔐 Login page |
-| `/dashboard` | 📊 Server selection |
-| `/dashboard/:guildId` | 🏠 Server overview |
-| `/dashboard/:guildId/commands` | 📜 Commands list |
-| `/dashboard/:guildId/levels` | 🏆 Level leaderboard |
-| `/dashboard/:guildId/giveaways` | 🎉 Giveaway management |
+| Route                           | Description                  |
+| ------------------------------- | ---------------------------- |
+| `/`                             | 🏠 Homepage with bot stats   |
+| `/login`                        | 🔐 Login page                |
+| `/dashboard`                    | 📊 Server selection          |
+| `/dashboard/:guildId`           | 🏠 Server overview           |
+| `/dashboard/:guildId/commands`  | 📜 Commands list             |
+| `/dashboard/:guildId/levels`    | 🏆 Level leaderboard         |
+| `/dashboard/:guildId/giveaways` | 🎉 Giveaway management       |
+| `/dashboard/:guildId/logs`      | 🛡️ Logging system management |
 
 ---
 
@@ -2290,7 +3045,13 @@ POST /api/:guildId/giveaway/end
 POST /api/:guildId/giveaway/reroll
 POST /api/:guildId/giveaway/delete
 
-// 🚫 Blacklist management
+// �️ Logging system management
+POST /api/:guildId/logs/channel    // Set default log channel
+POST /api/:guildId/logs/toggle     // Enable/disable event type
+POST /api/:guildId/logs/event      // Update event settings (channel, color)
+POST /api/:guildId/logs/reset      // Reset all log settings
+
+// �🚫 Blacklist management
 POST /api/guild/:guildId/blacklist    // Add to blacklist
 DELETE /api/guild/:guildId/blacklist  // Remove from blacklist
 ```
@@ -2304,13 +3065,12 @@ DELETE /api/guild/:guildId/blacklist  // Remove from blacklist
 
 ### 🔧 Configuration Options
 
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `clientID` | `string` | ✅ | 🔑 Your Discord Application Client ID |
-| `clientSecret` | `string` | ✅ | 🔐 Your Discord Application Client Secret |
-| `callbackURL` | `string` | ✅ | 🔗 OAuth2 redirect URL (must match Discord settings) |
-| `sessionSecret` | `string` | ✅ | 🔒 Secret key for session encryption |
-| `port` | `number` | ❌ | 🌍 Port to run the dashboard (default: 3000) |
+| Option          | Type     | Required | Description                                          |
+| --------------- | -------- | -------- | ---------------------------------------------------- |
+| `clientSecret`  | `string` | ✅       | 🔐 Your Discord Application Client Secret            |
+| `callbackURL`   | `string` | ✅       | 🔗 OAuth2 redirect URL (must match Discord settings) |
+| `sessionSecret` | `string` | ✅       | 🔒 Secret key for session encryption                 |
+| `port`          | `number` | ❌       | 🌍 Port to run the dashboard (default: 3000)         |
 
 ---
 
@@ -2318,16 +3078,17 @@ DELETE /api/guild/:guildId/blacklist  // Remove from blacklist
 
 The dashboard uses **EJS** templates located in the `views` folder:
 
-| File | Description |
-|------|-------------|
-| `index.ejs` | 🏠 Homepage |
-| `login.ejs` | 🔐 Login page |
-| `dashboard.ejs` | 📊 Server selection |
-| `guild.ejs` | 🏠 Server overview |
-| `commands.ejs` | 📜 Commands list |
-| `levels.ejs` | 🏆 Level management |
-| `giveaways.ejs` | 🎉 Giveaway management |
-| `404.ejs` | ❌ Not found page |
+| File            | Description                  |
+| --------------- | ---------------------------- |
+| `index.ejs`     | 🏠 Homepage                  |
+| `login.ejs`     | 🔐 Login page                |
+| `dashboard.ejs` | 📊 Server selection          |
+| `guild.ejs`     | 🏠 Server overview           |
+| `commands.ejs`  | 📜 Commands list             |
+| `levels.ejs`    | 🏆 Level management          |
+| `giveaways.ejs` | 🎉 Giveaway management       |
+| `logs.ejs`      | 🛡️ Logging system management |
+| `404.ejs`       | ❌ Not found page            |
 
 </details>