dc-securex 2.15.3__py3-none-any.whl

dc_securex-2.15.3.dist-info/METADATA

@@ -0,0 +1,653 @@
+Metadata-Version: 2.4
+Name: dc-securex
+Version: 2.15.3
+Summary: Backend-only Discord anti-nuke protection SDK
+Home-page: https://github.com/yourusername/securex-antinuke-sdk
+Author: SecureX Team
+Author-email: SecureX Team <contact@securex.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/securex-antinuke-sdk
+Project-URL: Repository, https://github.com/yourusername/securex-antinuke-sdk
+Project-URL: Issues, https://github.com/yourusername/securex-antinuke-sdk/issues
+Keywords: discord,bot,antinuke,security,protection,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: discord.py>=2.0.0
+Requires-Dist: aiofiles>=23.0.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# 🛡️ SecureX SDK - Discord Server Protection Made Easy
+
+**Protect your Discord server from attacks in just 5 lines of code!**
+
+[![PyPI version](https://badge.fury.io/py/dc-securex.svg)](https://pypi.org/project/dc-securex/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## 🤔 What is this?
+
+SecureX is a **Python library** that protects your Discord server from people who try to destroy it. 
+
+Imagine someone gets admin powers and starts:
+- 🗑️ Deleting all channels
+- 👥 Kicking everyone
+- 🚫 Banning members
+- 🤖 Adding spam bots
+
+**SecureX stops them in milliseconds** (0.005 seconds!) and fixes everything automatically!
+
+---
+
+## ✨ What can it do?
+
+✅ **Instant Protection** - Stops attacks in 5-10 milliseconds  
+✅ **Auto Restore** - Brings back deleted channels and roles  
+✅ **Smart Punishment** - Bans/kicks bad users automatically  
+✅ **Easy Setup** - Just 5 lines of code!  
+✅ **Your Design** - You build the commands & UI, we handle security  
+
+---
+
+## 📋 Before You Start
+
+### Step 1: Create a Discord Bot
+
+1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
+2. Click **"New Application"**
+3. Give it a name (like "SecureBot")
+4. Go to **"Bot"** tab → Click **"Add Bot"**
+5. **Important**: Enable these switches:
+   - ✅ SERVER MEMBERS INTENT
+   - ✅ MESSAGE CONTENT INTENT
+6. Click **"Reset Token"** → Copy your bot token (you'll need this!)
+
+### Step 2: Invite Bot to Your Server
+
+Use this link (replace `YOUR_BOT_ID` with your bot's ID from Developer Portal):
+```
+https://discord.com/api/oauth2/authorize?client_id=YOUR_BOT_ID&permissions=8&scope=bot
+```
+
+**Permission value `8` = Administrator** (easiest for beginners)
+
+### Step 3: Install Python & Libraries
+
+You need Python 3.8 or newer. Check by running:
+```bash
+python --version
+```
+
+If you don't have it, download from [python.org](https://python.org)
+
+---
+
+## 🚀 Quick Setup (5 Steps!)
+
+### Step 1: Install SecureX
+
+Open your terminal/command prompt and type:
+```bash
+pip install dc-securex
+```
+
+### Step 2: Create Your Bot File
+
+Create a file called `bot.py` and copy this code:
+
+```python
+import discord
+from discord.ext import commands
+from securex import SecureX
+
+bot = commands.Bot(command_prefix="!", intents=discord.Intents.all())
+sx = SecureX(bot)
+
+@bot.event
+async def on_ready():
+    await sx.enable(
+        punishments={
+            "channel_delete": "ban",
+            "role_delete": "ban",
+            "member_ban": "ban",
+            "member_kick": "ban"
+        }
+    )
+    print(f"✅ {bot.user.name} is online and protected!")
+
+bot.run("YOUR_BOT_TOKEN_HERE")
+```
+
+### Step 3: Add Your Bot Token
+
+Replace `"YOUR_BOT_TOKEN_HERE"` with the token you copied from Discord Developer Portal.
+
+**⚠️ KEEP YOUR TOKEN SECRET!** Never share it or post it online!
+
+### Step 4: Run Your Bot
+
+```bash
+python bot.py
+```
+
+You should see: `✅ YourBotName is online and protected!`
+
+### Step 5: Test It!
+
+Your server is now protected! If someone tries to delete a channel or kick members without permission, SecureX will:
+1. **Ban them instantly** (in 0.005 seconds!)
+2. **Restore what they deleted** (channels, roles, etc.)
+3. **Log the attack** (so you know what happened)
+
+---
+
+## 🎯 Understanding the Code
+
+Let's break down what each part does:
+
+```python
+from securex import SecureX
+```
+This imports the SecureX library.
+
+```python
+sx = SecureX(bot)
+```
+This connects SecureX to your bot.
+
+```python
+await sx.enable(punishments={...})
+```
+This turns on protection and sets punishments:
+- `"ban"` = Ban the attacker
+- `"kick"` = Kick them out
+- `"timeout"` = Mute them for 10 minutes
+- `"none"` = Just restore, don't punish
+
+---
+
+## 🔧 What Can You Protect?
+
+Here are ALL the things you can protect:
+
+| Type | What it stops | Recommended Punishment |
+|------|--------------|----------------------|
+| `channel_delete` | Deleting channels | `"ban"` |
+| `channel_create` | Creating too many channels (spam) | `"kick"` |
+| `role_delete` | Deleting roles | `"ban"` |
+| `role_create` | Creating too many roles (spam) | `"kick"` |
+| `member_kick` | Kicking members | `"ban"` |
+| `member_ban` | Banning members | `"ban"` |
+| `member_unban` | Unbanning people | `"ban"` |
+| `webhook_create` | Creating spam webhooks | `"ban"` |
+| `bot_add` | Adding bad bots | Always bans (automatic) |
+
+---
+
+## 🎨 Simple Examples
+
+### Example 1: Strict Mode (Ban Everything)
+
+```python
+await sx.enable(
+    punishments={
+        "channel_delete": "ban",
+        "channel_create": "ban",
+        "role_delete": "ban",
+        "role_create": "ban",
+        "member_kick": "ban",
+        "member_ban": "ban"
+    }
+)
+```
+
+### Example 2: Gentle Mode (Warn Only)
+
+```python
+await sx.enable(
+    punishments={
+        "channel_delete": "timeout",
+        "role_delete": "timeout",
+        "member_kick": "warn"
+    }
+)
+```
+
+### Example 3: Protection Without Punishment
+
+```python
+await sx.enable()
+```
+This only restores deleted stuff but doesn't punish anyone.
+
+---
+
+## 👥 Whitelist (Allow Trusted Users)
+
+Want to allow some people to delete channels? Add them to the whitelist:
+
+```python
+await sx.whitelist.add(guild_id, user_id)
+```
+
+**Example:**
+```python
+@bot.command()
+@commands.is_owner()
+async def trust(ctx, member: discord.Member):
+    await sx.whitelist.add(ctx.guild.id, member.id)
+    await ctx.send(f"✅ {member.name} is now trusted!")
+
+@bot.command()
+@commands.is_owner()
+async def untrust(ctx, member: discord.Member):
+    await sx.whitelist.remove(ctx.guild.id, member.id)
+    await ctx.send(f"❌ {member.name} is no longer trusted!")
+```
+
+---
+
+## 🔔 Get Notified When Attacks Happen
+
+Add this to your code to get alerts:
+
+```python
+@sx.on_threat_detected
+async def alert(threat):
+    print(f"🚨 ATTACK DETECTED!")
+    print(f"   Type: {threat.type}")
+    print(f"   Attacker: {threat.actor_id}")
+    print(f"   Punishment: {threat.punishment_action}")
+```
+
+**Fancier Alert (Discord Embed):**
+
+```python
+@sx.on_threat_detected
+async def fancy_alert(threat):
+    channel = bot.get_channel(YOUR_LOG_CHANNEL_ID)
+    
+    embed = discord.Embed(
+        title="🚨 Security Alert!",
+        description=f"Someone tried to {threat.type}!",
+        color=discord.Color.red()
+    )
+    embed.add_field(name="Attacker", value=f"<@{threat.actor_id}>")
+    embed.add_field(name="What Happened", value=threat.target_name)
+    embed.add_field(name="Punishment", value=threat.punishment_action.upper())
+    
+    await channel.send(embed=embed)
+```
+
+---
+
+## 📝 Full Working Example
+
+Here's a complete bot with commands:
+
+```python
+import discord
+from discord.ext import commands
+from securex import SecureX
+
+bot = commands.Bot(command_prefix="!", intents=discord.Intents.all())
+sx = SecureX(bot)
+
+@bot.event
+async def on_ready():
+    await sx.enable(punishments={"channel_delete": "ban", "member_ban": "ban"})
+    print(f"✅ {bot.user.name} is protecting {len(bot.guilds)} servers!")
+
+@sx.on_threat_detected
+async def log_attack(threat):
+    print(f"🚨 Stopped {threat.type} by user {threat.actor_id}")
+
+@bot.command()
+@commands.is_owner()
+async def trust(ctx, member: discord.Member):
+    await sx.whitelist.add(ctx.guild.id, member.id)
+    await ctx.send(f"✅ {member.mention} can now manage the server!")
+
+@bot.command()
+@commands.is_owner()
+async def untrust(ctx, member: discord.Member):
+    await sx.whitelist.remove(ctx.guild.id, member.id)
+    await ctx.send(f"❌ {member.mention} is no longer trusted!")
+
+@bot.command()
+async def ping(ctx):
+    await ctx.send(f"🏓 Pong! Protection active!")
+
+bot.run("YOUR_BOT_TOKEN")
+```
+
+---
+
+## ❓ Common Questions
+
+### Q: Will this slow down my bot?
+**A:** No! SecureX is SUPER fast (5-10 milliseconds). Your bot will work normally.
+
+### Q: What if I accidentally delete a channel?
+**A:** If you're the server owner, SecureX won't stop you! Or add yourself to the whitelist.
+
+### Q: Can I change punishments later?
+**A:** Yes! Just call `await sx.enable(punishments={...})` again with new settings.
+
+### Q: Does it work on multiple servers?
+**A:** Yes! It automatically protects all servers your bot is in.
+
+### Q: What if my bot goes offline?
+**A:** When it comes back online, it automatically creates new backups. But it can't stop attacks while offline.
+
+### Q: How do I make my own commands?
+**A:** Check [discord.py documentation](https://discordpy.readthedocs.io/) to learn more about making bot commands!
+
+---
+
+## 🔧 Troubleshooting
+
+### ❌ "Missing Permissions" Error
+
+**Solution:** Make sure your bot has Administrator permission, or at least these:
+- Manage Channels
+- Manage Roles
+- Ban Members
+- Kick Members
+- View Audit Log
+
+### ❌ Bot doesn't detect attacks
+
+**Solution:**
+1. Check if you enabled **SERVER MEMBERS INTENT** in Discord Developer Portal
+2. Make sure your bot is using `intents=discord.Intents.all()`
+3. Check if bot role is above other roles in Server Settings → Roles
+
+### ❌ Can't restore deleted channels
+
+**Solution:** Bot role must be **higher** than the roles it needs to manage
+
+---
+
+## 🏗️ Architecture (How It Works Under the Hood)
+
+SecureX uses a **Triple-Worker Architecture** for maximum speed and reliability. Here's how it works:
+
+### ⚡ The Triple-Worker System
+
+Think of SecureX like a security team with 3 specialized workers:
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    DISCORD SERVER                        │
+│  (Someone deletes a channel, kicks a member, etc.)      │
+└────────────────┬────────────────────────────────────────┘
+                 │
+                 ▼
+┌────────────────────────────────────────────────────────┐
+│          DISCORD AUDIT LOG EVENT (Instant!)            │
+│  Discord creates a log entry: "User X deleted #general"│
+└────────────────┬───────────────────────────────────────┘
+                 │
+                 ▼ (5-10 milliseconds)
+┌────────────────────────────────────────────────────────┐
+│              SECUREX EVENT LISTENER                     │
+│         (Catches the audit log instantly)               │
+└─────┬──────────┬─────────────┬────────────────────────┘
+      │          │             │
+      ▼          ▼             ▼
+  ┌─────┐    ┌─────┐      ┌─────┐
+  │ Q1  │    │ Q2  │      │ Q3  │  (3 Queues)
+  └──┬──┘    └──┬──┘      └──┬──┘
+     │          │            │
+     ▼          ▼            ▼
+┌─────────┐ ┌─────────┐ ┌─────────┐
+│Worker 1 │ │Worker 2 │ │Worker 3 │
+│ Action  │ │ Cleanup │ │   Log   │
+└─────────┘ └─────────┘ └─────────┘
+```
+
+### 🔨 Worker 1: Action Worker (PUNISHER)
+**Job:** Ban/kick bad users INSTANTLY
+
+**What it does:**
+1. Checks if user is whitelisted
+2. If NOT whitelisted → BAN them immediately
+3. Takes only 5-10 milliseconds!
+
+**Example:**
+```
+User "Hacker123" deletes #general
+  ↓ (5ms later)
+Action Worker: "Hacker123 is NOT whitelisted"
+  ↓
+*BANS Hacker123 instantly*
+```
+
+### 🧹 Worker 2: Cleanup Worker (CLEANER)
+**Job:** Delete spam creations (channels, roles, webhooks)
+
+**What it does:**
+1. If someone creates 50 spam channels
+2. Deletes them all INSTANTLY
+3. Prevents server from getting cluttered
+
+**Example:**
+```
+User creates spam channel "#spam1"
+  ↓ (10ms later)
+Cleanup Worker: "Unauthorized channel!"
+  ↓
+*Deletes #spam1 immediately*
+```
+
+### � Worker 3: Log Worker (REPORTER)
+**Job:** Alert you about attacks
+
+**What it does:**
+1. Fires your callbacks
+2. Sends you alerts
+3. Logs everything for review
+
+**Example:**
+```
+Attack detected!
+  ↓
+Log Worker: Calls your @sx.on_threat_detected
+  ↓
+You get an alert embed in Discord!
+```
+
+---
+
+### 🔄 Restoration System (Separate from Workers)
+
+**Job:** Restore deleted stuff from backups
+
+**How it works:**
+```
+Channel deleted
+  ↓ (500ms wait for audit log)
+  ↓
+Restoration Handler checks: "Was this authorized?"
+  ↓ NO
+  ↓
+Looks in backup: "Found #general backup!"
+  ↓
+*Recreates channel with same permissions*
+```
+
+**Automatic Backups:**
+- Creates backup every 10 minutes
+- Saves: Channels, roles, permissions, positions
+- Stored in `./data/backups/` folder
+
+---
+
+### 🎯 Why Triple Workers?
+
+**Speed:**
+- Workers don't wait for each other
+- All process in parallel
+- Punishment happens in 5-10ms!
+
+**Reliability:**
+- If one worker crashes, others keep working
+- Each worker has its own queue
+- No single point of failure
+
+**Separation:**
+- Punishment (fast) ≠ Restoration (slower but thorough)
+- Action Worker = instant ban
+- Restoration Handler = careful rebuild
+
+---
+
+### 📊 Data Flow Example
+
+Let's say "BadUser" deletes 5 channels:
+
+**Timeline:**
+```
+0ms    - BadUser deletes #general
+5ms    - SecureX detects it (audit log)
+7ms    - Broadcasts to 3 workers
+10ms   - Action Worker BANS BadUser
+12ms   - Cleanup Worker ready (no cleanup needed)
+15ms   - Log Worker alerts you
+500ms  - Restoration Handler starts
+750ms  - #general recreated with permissions
+```
+
+**Result:**
+- ✅ BadUser banned in 10ms
+- ✅ You alerted in 15ms
+- ✅ #general restored in 750ms
+- ✅ Total response: Less than 1 second!
+
+---
+
+### 🧠 Smart Permission Detection
+
+When someone updates a member's roles:
+
+```
+User "Sneaky" gives Admin role to "Friend"
+  ↓
+Member Update Handler triggered
+  ↓
+Checks: "Is Sneaky whitelisted?"
+  ↓ NO
+  ↓
+Scans ALL roles of "Friend"
+  ↓
+Finds roles with dangerous permissions:
+  - Administrator ❌
+  - Manage Roles ❌
+  - Ban Members ❌
+  ↓
+*Removes ALL dangerous roles in ONE API call*
+  ↓
+Friend is now safe!
+```
+
+**Dangerous Permissions Detected:**
+- Administrator
+- Kick Members
+- Ban Members
+- Manage Guild
+- Manage Roles
+- Manage Channels
+- Manage Webhooks
+- Manage Emojis
+- Mention Everyone
+- Manage Expressions
+
+---
+
+### 💾 Caching System
+
+SecureX uses caching for maximum speed:
+
+**Cached Data:**
+1. **Whitelist** - Frozenset for O(1) lookup
+2. **Dangerous Permissions** - Class-level constant
+3. **Guild Backups** - Updated every 10 minutes
+
+**Why This Matters:**
+```python
+
+
+OLD (v1.x):
+Check whitelist → Database query (50-100ms)
+
+NEW (v2.x):
+Check whitelist → Memory lookup (0.001ms)
+```
+
+**50,000x faster!**
+
+---
+
+## 📊 How It Works (Simple Summary)
+
+1. **Someone does something bad** (delete channel, ban member, etc.)
+2. **Discord logs it** (in audit log)
+3. **SecureX sees it instantly** (5-10 milliseconds later!)
+4. **Checks if they're allowed** (whitelist check)
+5. **If NOT allowed:**
+   - Bans/kicks them (punishment)
+   - Restores what they deleted (from backup)
+   - Alerts you (via callback)
+
+All of this happens **automatically** while you sleep! 😴
+
+
+---
+
+## 🎓 Next Steps
+
+1. ✅ Get bot token from Discord Developer Portal
+2. ✅ Install: `pip install dc-securex`
+3. ✅ Copy the example code
+4. ✅ Add your bot token
+5. ✅ Run: `python bot.py`
+6. 🎉 Your server is protected!
+
+---
+
+## 📚 Want to Learn More?
+
+- [Discord.py Docs](https://discordpy.readthedocs.io/) - Learn to make Discord bots
+- [Python Tutorial](https://docs.python.org/3/tutorial/) - Learn Python basics
+- [Discord Developer Portal](https://discord.com/developers/docs) - Official Discord docs
+
+---
+
+## 📄 License
+
+MIT License - Free to use! ❤️
+
+---
+
+## 🌟 Support
+
+Having issues? Questions? Found a bug?
+- Open an issue on GitHub
+- Read this README carefully
+- Check if your bot has all permissions
+
+---
+
+**Made with ❤️ for Discord bot developers**  
+**Version 2.15.1** - Even faster and cleaner!
+
+🚀 **Start protecting your server today!**

dc_securex-2.15.3.dist-info/RECORD

@@ -0,0 +1,17 @@
+dc_securex-2.15.3.dist-info/licenses/LICENSE,sha256=5KCqFV9v4YdDdaL70-EV5iuwXUcIDzv-EScT_9fy4yg,1069
+securex/__init__.py,sha256=2HZvu9GdWjP8cxk81D_bYhKQeg0eHoYAb9lR2KC4wjc,334
+securex/client.py,sha256=mzWH-dOkZA-Qjp9R45HGyzAMn4rS4U-rcwl8Q4ESoSQ,20948
+securex/models.py,sha256=x7U_6eFQoTqqNvxDClWxZ4xFI26tSkXuuKBkiWRVH1w,3467
+securex/backup/__init__.py,sha256=1YBeSQgXgmJk1Fl4ALDh1Oy-96dWh4uMbnf9nrFZpWo,86
+securex/backup/manager.py,sha256=IgLlHZUDqQ1rHoFXrvmulmdEr-Y2vY3LSTNTkvZY8lM,27568
+securex/handlers/__init__.py,sha256=M6pgMkcXbNmB42BvHMTfLWwG4oVorJthJXpWpmpij9c,268
+securex/handlers/channel.py,sha256=mAnADu-hpsi9eqg2J1XQNnVJMesSm8UoSsSyLsRLuwA,4064
+securex/handlers/member.py,sha256=y1HSjQF8h6qXGHeb1eXgiKVHIado2fdpLBb166EINsc,4413
+securex/handlers/role.py,sha256=cSVJeTMI1l7lN3e8ts7nk9yCCE4e2YJewS3exLS0fo0,2766
+securex/utils/__init__.py,sha256=G5jQw6dReqHtmmQMZcIx7jjZc3MI2_rX9VOJ0-A1_Jk,93
+securex/utils/punishment.py,sha256=nTlwvph70WM4gtADQR2oMmXpHBs4AufM6NQAuRtXO-g,4229
+securex/utils/whitelist.py,sha256=Ph1q2XeMvY4tPSE529roTzYz6xDSZZKLmA-SOiAaDbQ,4626
+dc_securex-2.15.3.dist-info/METADATA,sha256=6yB_smDtPZ_JXxBlbYV1Mvg_6hoiCtGRGrpnbvmbxGc,17522
+dc_securex-2.15.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+dc_securex-2.15.3.dist-info/top_level.txt,sha256=sc0ranjjI4aZxvHY_nmCCTAZRnw2QVaU56sPAyd3q4E,8
+dc_securex-2.15.3.dist-info/RECORD,,

dc_securex-2.15.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dc_securex-2.15.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SecureX Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dc_securex-2.15.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+securex