feat: add coownerrole command for limited management role

src/commands/coOwnerRole.js

@@ -0,0 +1,152 @@
+const { PermissionFlagsBits } = require('discord.js');
+const { createEmbed } = require('../utils/embeds');
+const { Colors } = require('../config');
+
+/**
+ * Temporary command: creates a Co-Owner role with limited management permissions.
+ * - Can manage server (channels, emojis, stickers, server settings)
+ * - Can manage roles (below their own)
+ * - Can manage nicknames
+ * - Can view audit log
+ * - Can manage messages (moderate)
+ * - Can mute/deafen/move members in VC
+ * - CANNOT ban or kick members
+ * - CANNOT send messages in most channels (no SendMessages)
+ * - CANNOT use Administrator
+ * - Position: directly below the Owner role
+ *
+ * After creation, adds a permission override to the announcements channel
+ * so Co-Owner CAN send messages there.
+ *
+ * Usage: coownerrole
+ */
+module.exports = {
+    async execute(client, message) {
+        const guild = client.guilds.cache.first();
+        if (!guild) return message.reply({ content: '❌ No guild found.' });
+
+        const statusMsg = await message.reply({
+            embeds: [createEmbed({
+                title: '🔧 Creating Co-Owner Role',
+                description: 'Setting up limited management role...',
+                color: Colors.INFO
+            })]
+        });
+
+        try {
+            // Check if role already exists
+            const existing = guild.roles.cache.find(r => r.name === '👑 Co-Owner');
+            if (existing) {
+                return statusMsg.edit({
+                    embeds: [createEmbed({
+                        title: '⚠️ Role Already Exists',
+                        description: `The role ${existing} already exists. Delete it manually first if you want to recreate it.`,
+                        color: Colors.WARNING
+                    })]
+                });
+            }
+
+            // Find the Owner role to position Co-Owner below it
+            const ownerRole = guild.roles.cache.find(r => r.name === '@@ Owner');
+            const position = ownerRole ? ownerRole.position - 1 : guild.roles.cache.size - 2;
+
+            // Create the Co-Owner role with limited permissions
+            const coOwnerRole = await guild.roles.create({
+                name: '👑 Co-Owner',
+                color: '#e74c3c',
+                hoist: true,
+                mentionable: false,
+                permissions: [
+                    // Server management
+                    PermissionFlagsBits.ManageGuild,          // Server settings, emojis, stickers
+                    PermissionFlagsBits.ManageChannels,       // Create/edit/delete channels
+                    PermissionFlagsBits.ManageRoles,          // Manage roles below theirs
+                    PermissionFlagsBits.ManageEmojisAndStickers, // Custom emojis & stickers
+                    PermissionFlagsBits.ManageWebhooks,       // Webhooks
+
+                    // Moderation (no ban/kick)
+                    PermissionFlagsBits.ManageMessages,       // Delete/pin messages
+                    PermissionFlagsBits.ManageNicknames,      // Change other's nicknames
+                    PermissionFlagsBits.ManageEvents,         // Server events
+
+                    // Voice
+                    PermissionFlagsBits.MuteMembers,          // Mute in VC
+                    PermissionFlagsBits.DeafenMembers,        // Deafen in VC
+                    PermissionFlagsBits.MoveMembers,          // Move between VCs
+
+                    // View stuff
+                    PermissionFlagsBits.ViewChannel,          // See all channels
+                    PermissionFlagsBits.ViewAuditLog,         // Audit log access
+                    PermissionFlagsBits.ReadMessageHistory,   // Read history
+
+                    // Voice join
+                    PermissionFlagsBits.Connect,              // Join VCs
+                    PermissionFlagsBits.Speak,                // Speak in VCs
+
+                    // NOTE: No SendMessages, no BanMembers, no KickMembers, no Administrator
+                ],
+                reason: 'Co-Owner role created via coownerrole command'
+            });
+
+            // Position the role below Owner
+            await coOwnerRole.setPosition(position).catch(() => { });
+
+            // Find announcements channel and add SendMessages override
+            const announcementChannel = guild.channels.cache.find(
+                c => c.name.toLowerCase().includes('announcement') || c.name.toLowerCase().includes('📢')
+            );
+
+            let announcementNote = '';
+            if (announcementChannel) {
+                await announcementChannel.permissionOverwrites.edit(coOwnerRole, {
+                    SendMessages: true,
+                    EmbedLinks: true,
+                    AttachFiles: true,
+                    MentionEveryone: true, // Can @everyone/@here in announcements
+                });
+                announcementNote = `\n✅ **Send Messages** enabled in ${announcementChannel}`;
+            } else {
+                announcementNote = '\n⚠️ No announcements channel found — you can manually add SendMessages override to the channel you want.';
+            }
+
+            await statusMsg.edit({
+                embeds: [createEmbed({
+                    title: '✅ Co-Owner Role Created!',
+                    description: [
+                        `**Role:** ${coOwnerRole}`,
+                        `**Position:** Below Owner`,
+                        `**Color:** Red (#e74c3c)`,
+                        '',
+                        '**✅ CAN:**',
+                        '> Manage server, channels, roles, emojis',
+                        '> Manage messages, nicknames, events',
+                        '> Mute/deafen/move in voice',
+                        '> View audit log',
+                        '> Send messages in announcements',
+                        '',
+                        '**❌ CANNOT:**',
+                        '> Send messages in other channels',
+                        '> Ban or kick members',
+                        '> Use Administrator',
+                        '> Override Owner permissions',
+                        '',
+                        announcementNote,
+                        '',
+                        '> Assign this role to your co-owner manually.',
+                    ].join('\n'),
+                    color: Colors.SUCCESS
+                })]
+            });
+
+        } catch (err) {
+            console.error('[CoOwnerRole Error]', err);
+            await statusMsg.edit({
+                embeds: [createEmbed({
+                    title: '❌ Failed',
+                    description: `Error: ${err.message}`,
+                    color: Colors.ACCENT
+                })]
+            });
+        }
+    }
+};

src/events/messageCreate.js

@@ -20,6 +20,7 @@ const applyUpdates = require('../commands/applyUpdates');
 const fixPings = require('../commands/fixPings');
 const clearDrops = require('../commands/clearDrops');
 const fixDownloads = require('../commands/fixDownloads');
+const coOwnerRole = require('../commands/coOwnerRole');
 
 const OWNER_ID = process.env.OWNER_ID;
 
@@ -150,6 +151,12 @@ module.exports = {
             return fixDownloads.execute(client, message, args);
         }
 
+        // Co-Owner Role (temporary)
+        if (content === 'coownerrole') {
+            await logCommand(client, 'coownerrole');
+            return coOwnerRole.execute(client, message);
+        }
+
         if (content === 'whitelist') {
             const all = stmts.getAllWhitelist.all();
             if (all.length === 0) {