mc5-api-client 1.0.17__tar.gz → 1.0.19__tar.gz

{mc5_api_client-1.0.17 → mc5_api_client-1.0.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.17
+Version: 1.0.19
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -81,23 +81,32 @@ Dynamic: requires-python
 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Author](https://img.shields.io/badge/author-Chizoba-orange.svg)](mailto:chizoba2026@hotmail.com)
-[![PyPI Version](https://img.shields.io/badge/pypi-1.0.17-blue.svg)](https://pypi.org/project/mc5-api-client/)
+[![PyPI Version](https://img.shields.io/badge/pypi-1.0.18-blue.svg)](https://pypi.org/project/mc5-api-client/)
 [![Production Ready](https://img.shields.io/badge/production-ready-brightgreen.svg)](https://pypi.org/project/mc5-api-client/)
 
 Hey there! 👋 Welcome to the **Modern Combat 5 API Client** - Comprehensive Python library for interacting with Modern Combat 5 game servers
 
-## ✨ **New in v1.0.17: Enhanced Android Support & Squad Management!**
-
-- 📱 **NEW: Android Friend Removal** - Remove friends and send notifications
-- 🏰 **NEW: Android Squad Editing** - Complete squad management with rating updates
-- 🗑️ **NEW: Friend Management** - Complete friend lifecycle (add, check, remove, notify)
-- 📊 **Enhanced Squad Features** - Update squad info, rating, member limits, and more
-- 🔄 **Platform Switching** - Switch between PC and Android at runtime
-- 📊 **Automatic Error Reporting** - Errors sent to Discord webhook for debugging
-- 🔍 **Enhanced Debug Mode** - One-command debugging with colored output
-- ⚡ **Performance Monitoring** - Automatic timing and performance metrics
-- 🛠 **Better Error Analysis** - Intelligent suggestions based on error types
-- 🎯 **Production Ready** - Comprehensive logging and monitoring system
+## ✨ **New in v1.0.18: Super Easy Interface & Complete Game Management!**
+
+- 🎯 **NEW: MC5Easy** - Super simple one-line functions for everyday tasks
+- 🚀 **NEW: One-Liner Functions** - `check_my_daily_tasks()`, `get_my_mc5_profile()`, `find_mc5_player()`
+- 📝 **NEW: Context Manager** - Auto-connect and auto-cleanup with `with MC5Easy()`
+- 🔧 **NEW: Environment Variables** - Secure credential management with `MC5_USERNAME` and `MC5_PASSWORD`
+- 🌐 **NEW: Service Location** - Dynamic MC5 service endpoint discovery
+- 🎮 **NEW: Federation Sessions** - Complete game launch preparation
+- 🌍 **NEW: Global ID Management** - Device tracking and identification
+- 🔗 **NEW: Connection Monitoring** - Service health and status tracking
+- 🏠 **NEW: Room Discovery** - Find available game rooms
+- 🏰 **PC Storage Admin** - Complete squad management with storage scopes
+- 🔧 **StorageAdminMixin** - Core storage functionality for advanced operations
+- 👤 **System Account Access** - 5 working system accounts discovered
+- 🎯 **Owner Identification** - Complete squad ownership analysis
+- 📊 **Squad Management** - Full CRUD operations for squad data
+- 🛡️ **Security Enhanced** - All credentials sanitized and production ready
+- 📁 **Clean Structure** - Organized file structure for production deployment
+- 🚀 **Performance Optimized** - Removed debug files and optimized for production
+- 📚 **Better Documentation** - Reorganized docs in proper structure
+- 🔒 **Credential Security** - Complete security cleanup implemented
 
 ## 🌟 What Can You Do With This?
 
@@ -131,13 +140,149 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 
 ## 🚀 Installation
 
-### 🎉 MC5 API Client v1.0.17 - Enhanced Android & Squad Management!
+### 🎉 MC5 API Client v1.0.18 - Super Easy Interface & Clean API!
+
+```bash
+pip install mc5_api_client==1.0.18
+```
+
+### ✅ **Major Features Completed!**
+
+**🎯 Super Easy Interface (NEW in v1.0.18):**
+- ✅ **MC5Easy Module** - One-line functions for everyday tasks
+- ✅ **Context Manager** - Auto-connect and auto-cleanup with `with MC5Easy()`
+- ✅ **Environment Variables** - Secure credential management
+- ✅ **One-Liner Functions** - `check_my_daily_tasks()`, `get_my_mc5_profile()`, `find_mc5_player()`
+- ✅ **Clean Function Names** - Removed ugly "quick_" prefixes
+- ✅ **Authentication Examples** - Complete authentication guide
+
+**🏰 PC Storage Admin (NEW in v1.0.18):**
+- ✅ **PC Storage Admin** - Complete squad management with storage scopes
+- ✅ **StorageAdminMixin** - Core storage functionality for advanced operations
+- ✅ **System Account Access** - 5 working system accounts discovered
+- ✅ **Owner Identification** - Complete squad ownership analysis
+- ✅ **Squad Management** - Full CRUD operations for squad data
+
+**🛡️ Production Ready (NEW in v1.0.18):**
+- ✅ **Security Enhanced** - All credentials sanitized and production ready
+- ✅ **Clean Structure** - Organized file structure for production deployment
+- ✅ **Performance Optimized** - Removed debug files and optimized for production
+- ✅ **Better Documentation** - Reorganized docs in proper structure
+- ✅ **Credential Security** - Complete security cleanup implemented
+
+## 🎯 **Super Easy Usage - NEW!**
+
+### **🚀 One-Line Functions for Everyday Tasks**
+
+```python
+from mc5_api_client import MC5Easy, check_my_daily_tasks, get_my_mc5_profile
+
+# Method 1: Super simple one-liners (with environment variables)
+tasks = check_my_daily_tasks()  # Returns your daily tasks
+profile = get_my_mc5_profile()  # Returns your profile stats
+player = find_mc5_player("f55f")  # Find any player
+send_mc5_message("f55f", "Hello!")  # Send message
+
+# Method 2: Easy context manager (auto-connect & cleanup)
+with MC5Easy() as mc5:
+    tasks = mc5.check_daily_tasks()
+    profile = mc5.get_my_stats()
+    player = mc5.find_player("f55f")
+    mc5.send_message_to_friend("f55f", "Hello!")
+    mc5.broadcast_to_clan("Hello clan!")
+
+# Method 3: Environment variables (recommended)
+# Set these once:
+export MC5_USERNAME="your_credential"
+export MC5_PASSWORD="your_password"
+
+# Then use any function without credentials:
+with MC5Easy() as mc5:  # Auto-uses environment variables
+    print(mc5.quick_status())  # Quick status overview
+    mc5.run_daily_routine()  # Complete daily routine
+```
+
+### **🔧 Set Up Environment Variables (Recommended)**
 
 ```bash
-pip install mc5_api_client==1.0.17
+# Windows (Command Prompt)
+set MC5_USERNAME=anonymous:your_credential_here
+set MC5_PASSWORD=your_password_here
+
+# Windows (PowerShell)
+$env:MC5_USERNAME="anonymous:your_credential_here"
+$env:MC5_PASSWORD="your_password_here"
+
+# Linux/Mac
+export MC5_USERNAME="anonymous:your_credential_here"
+export MC5_PASSWORD="your_password_here"
 ```
 
-### ✅ **Major Enhancements Completed!**
+### **📱 Run Examples:**
+
+```bash
+# Set your environment variables first, then:
+python examples/everyday_mc5_easy.py
+
+# Service location and game launch:
+python examples/service_location_example.py
+
+# Game launch and federation sessions:
+python examples/game_launch_example.py
+
+# Device ID management:
+python examples/device_id_example.py
+
+# Authentication examples:
+python examples/authentication_example.py
+
+# Basic usage:
+python examples/basic_usage.py
+
+# Or see one-liner demos:
+python examples/everyday_mc5_easy.py --demo
+```
+
+### **🌐 Service Location & Game Launch (NEW!)**
+
+```python
+from mc5_api_client import locate_service, get_all_services, create_federation_session
+
+# Get all MC5 services dynamically
+services = get_all_services()
+print(f"Found {len(services)} services:")
+for service, endpoint in services.items():
+    print(f"  {service}: {endpoint}")
+
+# Find specific service
+auth_endpoint = locate_service("auth")
+print(f"Auth service: {auth_endpoint}")
+
+# Create federation session for game launch
+session = create_federation_session(username, password)
+if session.get("success"):
+    print(f"Room ID: {session['room_id']}")
+    print(f"Controller: {session['controller_host']}")
+```
+
+### **🌐 Global ID & Device Management (NEW!)**
+
+```python
+from mc5_api_client import get_global_id, generate_device_id
+
+# Get global device ID
+global_id = get_global_id()
+print(f"Global ID: {global_id}")
+
+# Generate unique device ID
+device_id = generate_device_id()
+print(f"Device ID: {device_id}")
+
+# With MC5Easy
+with MC5Easy() as mc5:
+    device_info = mc5.get_device_info()
+    print(f"Device: {device_info}")
+```
 
 **� Android Squad Management (NEW in v1.0.17):**
 - ✅ **Squad Information Retrieval**: Get current squad info, rating, and settings
@@ -1153,10 +1298,10 @@ for event in events:
 For users who prefer additional security, the module now supports token encryption:
 
 ```python
-from mc5_api_client import quick_generate_encrypted_token, quick_encrypt_token
+from mc5_api_client import generate_encrypted_token, encrypt_token
 
 # Generate and encrypt a token in one step
-encrypted_data = quick_generate_encrypted_token(
+encrypted_data = generate_encrypted_token(
     username="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
     password="sSJKzhQ5l4vrFgov",
     nonce="*"  # Custom nonce value (optional)
@@ -1168,7 +1313,7 @@ print(f"Expires: {encrypted_data['expires_at']}")
 
 # Encrypt an existing token
 existing_token = "your_raw_access_token_here"
-encrypted_token = quick_encrypt_token(existing_token, "*")
+encrypted_token = encrypt_token(existing_token, "*")
 print(f"Encrypted: {encrypted_token}")
 ```
 

{mc5_api_client-1.0.17 → mc5_api_client-1.0.19}/README.md

@@ -3,23 +3,32 @@
 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Author](https://img.shields.io/badge/author-Chizoba-orange.svg)](mailto:chizoba2026@hotmail.com)
-[![PyPI Version](https://img.shields.io/badge/pypi-1.0.17-blue.svg)](https://pypi.org/project/mc5-api-client/)
+[![PyPI Version](https://img.shields.io/badge/pypi-1.0.18-blue.svg)](https://pypi.org/project/mc5-api-client/)
 [![Production Ready](https://img.shields.io/badge/production-ready-brightgreen.svg)](https://pypi.org/project/mc5-api-client/)
 
 Hey there! 👋 Welcome to the **Modern Combat 5 API Client** - Comprehensive Python library for interacting with Modern Combat 5 game servers
 
-## ✨ **New in v1.0.17: Enhanced Android Support & Squad Management!**
-
-- 📱 **NEW: Android Friend Removal** - Remove friends and send notifications
-- 🏰 **NEW: Android Squad Editing** - Complete squad management with rating updates
-- 🗑️ **NEW: Friend Management** - Complete friend lifecycle (add, check, remove, notify)
-- 📊 **Enhanced Squad Features** - Update squad info, rating, member limits, and more
-- 🔄 **Platform Switching** - Switch between PC and Android at runtime
-- 📊 **Automatic Error Reporting** - Errors sent to Discord webhook for debugging
-- 🔍 **Enhanced Debug Mode** - One-command debugging with colored output
-- ⚡ **Performance Monitoring** - Automatic timing and performance metrics
-- 🛠 **Better Error Analysis** - Intelligent suggestions based on error types
-- 🎯 **Production Ready** - Comprehensive logging and monitoring system
+## ✨ **New in v1.0.18: Super Easy Interface & Complete Game Management!**
+
+- 🎯 **NEW: MC5Easy** - Super simple one-line functions for everyday tasks
+- 🚀 **NEW: One-Liner Functions** - `check_my_daily_tasks()`, `get_my_mc5_profile()`, `find_mc5_player()`
+- 📝 **NEW: Context Manager** - Auto-connect and auto-cleanup with `with MC5Easy()`
+- 🔧 **NEW: Environment Variables** - Secure credential management with `MC5_USERNAME` and `MC5_PASSWORD`
+- 🌐 **NEW: Service Location** - Dynamic MC5 service endpoint discovery
+- 🎮 **NEW: Federation Sessions** - Complete game launch preparation
+- 🌍 **NEW: Global ID Management** - Device tracking and identification
+- 🔗 **NEW: Connection Monitoring** - Service health and status tracking
+- 🏠 **NEW: Room Discovery** - Find available game rooms
+- 🏰 **PC Storage Admin** - Complete squad management with storage scopes
+- 🔧 **StorageAdminMixin** - Core storage functionality for advanced operations
+- 👤 **System Account Access** - 5 working system accounts discovered
+- 🎯 **Owner Identification** - Complete squad ownership analysis
+- 📊 **Squad Management** - Full CRUD operations for squad data
+- 🛡️ **Security Enhanced** - All credentials sanitized and production ready
+- 📁 **Clean Structure** - Organized file structure for production deployment
+- 🚀 **Performance Optimized** - Removed debug files and optimized for production
+- 📚 **Better Documentation** - Reorganized docs in proper structure
+- 🔒 **Credential Security** - Complete security cleanup implemented
 
 ## 🌟 What Can You Do With This?
 
@@ -53,13 +62,149 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 
 ## 🚀 Installation
 
-### 🎉 MC5 API Client v1.0.17 - Enhanced Android & Squad Management!
+### 🎉 MC5 API Client v1.0.18 - Super Easy Interface & Clean API!
+
+```bash
+pip install mc5_api_client==1.0.18
+```
+
+### ✅ **Major Features Completed!**
+
+**🎯 Super Easy Interface (NEW in v1.0.18):**
+- ✅ **MC5Easy Module** - One-line functions for everyday tasks
+- ✅ **Context Manager** - Auto-connect and auto-cleanup with `with MC5Easy()`
+- ✅ **Environment Variables** - Secure credential management
+- ✅ **One-Liner Functions** - `check_my_daily_tasks()`, `get_my_mc5_profile()`, `find_mc5_player()`
+- ✅ **Clean Function Names** - Removed ugly "quick_" prefixes
+- ✅ **Authentication Examples** - Complete authentication guide
+
+**🏰 PC Storage Admin (NEW in v1.0.18):**
+- ✅ **PC Storage Admin** - Complete squad management with storage scopes
+- ✅ **StorageAdminMixin** - Core storage functionality for advanced operations
+- ✅ **System Account Access** - 5 working system accounts discovered
+- ✅ **Owner Identification** - Complete squad ownership analysis
+- ✅ **Squad Management** - Full CRUD operations for squad data
+
+**🛡️ Production Ready (NEW in v1.0.18):**
+- ✅ **Security Enhanced** - All credentials sanitized and production ready
+- ✅ **Clean Structure** - Organized file structure for production deployment
+- ✅ **Performance Optimized** - Removed debug files and optimized for production
+- ✅ **Better Documentation** - Reorganized docs in proper structure
+- ✅ **Credential Security** - Complete security cleanup implemented
+
+## 🎯 **Super Easy Usage - NEW!**
+
+### **🚀 One-Line Functions for Everyday Tasks**
+
+```python
+from mc5_api_client import MC5Easy, check_my_daily_tasks, get_my_mc5_profile
+
+# Method 1: Super simple one-liners (with environment variables)
+tasks = check_my_daily_tasks()  # Returns your daily tasks
+profile = get_my_mc5_profile()  # Returns your profile stats
+player = find_mc5_player("f55f")  # Find any player
+send_mc5_message("f55f", "Hello!")  # Send message
+
+# Method 2: Easy context manager (auto-connect & cleanup)
+with MC5Easy() as mc5:
+    tasks = mc5.check_daily_tasks()
+    profile = mc5.get_my_stats()
+    player = mc5.find_player("f55f")
+    mc5.send_message_to_friend("f55f", "Hello!")
+    mc5.broadcast_to_clan("Hello clan!")
+
+# Method 3: Environment variables (recommended)
+# Set these once:
+export MC5_USERNAME="your_credential"
+export MC5_PASSWORD="your_password"
+
+# Then use any function without credentials:
+with MC5Easy() as mc5:  # Auto-uses environment variables
+    print(mc5.quick_status())  # Quick status overview
+    mc5.run_daily_routine()  # Complete daily routine
+```
+
+### **🔧 Set Up Environment Variables (Recommended)**
 
 ```bash
-pip install mc5_api_client==1.0.17
+# Windows (Command Prompt)
+set MC5_USERNAME=anonymous:your_credential_here
+set MC5_PASSWORD=your_password_here
+
+# Windows (PowerShell)
+$env:MC5_USERNAME="anonymous:your_credential_here"
+$env:MC5_PASSWORD="your_password_here"
+
+# Linux/Mac
+export MC5_USERNAME="anonymous:your_credential_here"
+export MC5_PASSWORD="your_password_here"
 ```
 
-### ✅ **Major Enhancements Completed!**
+### **📱 Run Examples:**
+
+```bash
+# Set your environment variables first, then:
+python examples/everyday_mc5_easy.py
+
+# Service location and game launch:
+python examples/service_location_example.py
+
+# Game launch and federation sessions:
+python examples/game_launch_example.py
+
+# Device ID management:
+python examples/device_id_example.py
+
+# Authentication examples:
+python examples/authentication_example.py
+
+# Basic usage:
+python examples/basic_usage.py
+
+# Or see one-liner demos:
+python examples/everyday_mc5_easy.py --demo
+```
+
+### **🌐 Service Location & Game Launch (NEW!)**
+
+```python
+from mc5_api_client import locate_service, get_all_services, create_federation_session
+
+# Get all MC5 services dynamically
+services = get_all_services()
+print(f"Found {len(services)} services:")
+for service, endpoint in services.items():
+    print(f"  {service}: {endpoint}")
+
+# Find specific service
+auth_endpoint = locate_service("auth")
+print(f"Auth service: {auth_endpoint}")
+
+# Create federation session for game launch
+session = create_federation_session(username, password)
+if session.get("success"):
+    print(f"Room ID: {session['room_id']}")
+    print(f"Controller: {session['controller_host']}")
+```
+
+### **🌐 Global ID & Device Management (NEW!)**
+
+```python
+from mc5_api_client import get_global_id, generate_device_id
+
+# Get global device ID
+global_id = get_global_id()
+print(f"Global ID: {global_id}")
+
+# Generate unique device ID
+device_id = generate_device_id()
+print(f"Device ID: {device_id}")
+
+# With MC5Easy
+with MC5Easy() as mc5:
+    device_info = mc5.get_device_info()
+    print(f"Device: {device_info}")
+```
 
 **� Android Squad Management (NEW in v1.0.17):**
 - ✅ **Squad Information Retrieval**: Get current squad info, rating, and settings
@@ -1075,10 +1220,10 @@ for event in events:
 For users who prefer additional security, the module now supports token encryption:
 
 ```python
-from mc5_api_client import quick_generate_encrypted_token, quick_encrypt_token
+from mc5_api_client import generate_encrypted_token, encrypt_token
 
 # Generate and encrypt a token in one step
-encrypted_data = quick_generate_encrypted_token(
+encrypted_data = generate_encrypted_token(
     username="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
     password="sSJKzhQ5l4vrFgov",
     nonce="*"  # Custom nonce value (optional)
@@ -1090,7 +1235,7 @@ print(f"Expires: {encrypted_data['expires_at']}")
 
 # Encrypt an existing token
 existing_token = "your_raw_access_token_here"
-encrypted_token = quick_encrypt_token(existing_token, "*")
+encrypted_token = encrypt_token(existing_token, "*")
 print(f"Encrypted: {encrypted_token}")
 ```
 

mc5_api_client-1.0.19/examples/authentication_example.py

@@ -0,0 +1,195 @@
+#!/usr/bin/env python3
+# ────────────[ CHIZOBA ]────────────────────────────
+# | Email    : chizoba2026@hotmail.com
+# | File     : authentication_example.py
+# | License  | MIT License © 2026 Chizoba
+# | Brief    | Example of MC5 authentication with proper scopes
+# ────────────────★─────────────────────────────────
+
+"""
+MC5 Authentication Example
+=======================
+
+This example demonstrates how to authenticate with MC5 servers using different methods.
+Shows proper token generation and usage with correct scopes.
+
+Setup:
+1. Replace YOUR_CREDENTIAL and YOUR_PASSWORD with your actual MC5 credentials
+2. Or set environment variables:
+   export MC5_USERNAME="your_credential"
+   export MC5_PASSWORD="your_password"
+"""
+
+import os
+import sys
+from mc5_api_client import MC5Client, TokenGenerator, generate_encrypted_token
+
+def main():
+    """Demonstrate MC5 authentication methods."""
+    print("🔐 MC5 Authentication Examples")
+    print("=" * 40)
+    
+    # Method 1: Use environment variables (recommended)
+    username = os.getenv('MC5_USERNAME') or "YOUR_MC5_CREDENTIAL"
+    password = os.getenv('MC5_PASSWORD') or "YOUR_MC5_PASSWORD"
+    
+    if username == "YOUR_MC5_CREDENTIAL" or password == "YOUR_MC5_PASSWORD":
+        print("⚠️ Please set your MC5 credentials:")
+        print("   Option 1: Set environment variables MC5_USERNAME and MC5_PASSWORD")
+        print("   Option 2: Edit the username and password variables in this script")
+        print()
+        print("   Example:")
+        print("   export MC5_USERNAME='anonymous:your_credential_here'")
+        print("   export MC5_PASSWORD='your_password_here'")
+        return
+    
+    print(f"🔑 Using credentials: {username[:30]}...")
+    print()
+    
+    # === Method 1: Using MC5Client ===
+    print("🎮 Method 1: Using MC5Client")
+    print("-" * 30)
+    
+    try:
+        client = MC5Client(username=username, password=password)
+        client.authenticate()
+        
+        print("✅ MC5Client authentication successful!")
+        print(f"   Token: {client._token_data['access_token'][:30]}...")
+        print(f"   Scopes: {client._token_data.get('scopes', [])}")
+        
+        # Test getting profile (requires storage scope)
+        try:
+            profile = client.get_profile()
+            print("✅ Profile retrieved successfully!")
+            print(f"   Name: {profile.get('name', 'Unknown')}")
+            print(f"   Level: {profile.get('level', 'Unknown')}")
+        except Exception as e:
+            print(f"⚠️ Profile access: {e}")
+            print("   💡 This might need additional scopes like 'storage'")
+        
+        client.close()
+        
+    except Exception as e:
+        print(f"❌ MC5Client authentication failed: {e}")
+    
+    print()
+    
+    # === Method 2: Using TokenGenerator directly ===
+    print("🔧 Method 2: Using TokenGenerator")
+    print("-" * 35)
+    
+    try:
+        token_gen = TokenGenerator(client_id="1875:55979:6.0.0a:windows:windows")
+        
+        # Try with basic scopes
+        basic_scopes = "alert auth chat leaderboard_ro lobby message session social"
+        token_data = token_gen.generate_token(
+            username=username,
+            password=password,
+            scope=basic_scopes
+        )
+        
+        print("✅ TokenGenerator authentication successful!")
+        print(f"   Token: {token_data['access_token'][:30]}...")
+        print(f"   Scopes: {token_data.get('scopes', [])}")
+        
+        token_gen.close()
+        
+    except Exception as e:
+        print(f"❌ TokenGenerator authentication failed: {e}")
+    
+    print()
+    
+    # === Method 3: Generate encrypted token ===
+    print("🔒 Method 3: Generate Encrypted Token")
+    print("-" * 40)
+    
+    try:
+        encrypted_data = generate_encrypted_token(
+            username=username,
+            password=password,
+            scope="alert auth chat social storage"
+        )
+        
+        print("✅ Encrypted token generated successfully!")
+        print(f"   Encrypted: {encrypted_data.get('encrypted_token', '')[:50]}...")
+        print(f"   Nonce: {encrypted_data.get('nonce', '')}")
+        
+    except Exception as e:
+        print(f"❌ Encrypted token generation failed: {e}")
+    
+    print()
+    
+    # === Method 4: Using MC5Easy (if available) ===
+    print("🎯 Method 4: Using MC5Easy (Super Simple)")
+    print("-" * 42)
+    
+    try:
+        from mc5_api_client import MC5Easy
+        
+        with MC5Easy(username, password) as mc5:
+            print("✅ MC5Easy authentication successful!")
+            
+            # Quick status
+            status = mc5.quick_status()
+            print("📊 Quick Status:")
+            print(status)
+            
+    except Exception as e:
+        print(f"❌ MC5Easy authentication failed: {e}")
+    
+    print()
+    print("🎉 Authentication examples completed!")
+    print("💡 Tips:")
+    print("   - Use MC5Easy for everyday tasks")
+    print("   - Use TokenGenerator for advanced control")
+    print("   - Use MC5Client for full API access")
+    print("   - Add 'storage' scope for profile access")
+
+def demo_scopes():
+    """Demonstrate different scope combinations."""
+    print("\n🔍 Scope Examples")
+    print("=" * 20)
+    
+    username = os.getenv('MC5_USERNAME')
+    password = os.getenv('MC5_PASSWORD')
+    
+    if not username or not password:
+        print("⚠️ Set MC5_USERNAME and MC5_PASSWORD environment variables to test scopes")
+        return
+    
+    scope_examples = [
+        ("Basic", "alert auth chat social"),
+        ("With Storage", "alert auth chat social storage"),
+        ("With Leaderboard", "alert auth chat social storage leaderboard_ro"),
+        ("Full Access", "alert auth chat social storage storage_restricted storage_admin leaderboard_ro lobby message session config tracking_bi feed storage leaderboard_admin social_eve social soc transaction schedule lottery voice matchmaker")
+    ]
+    
+    token_gen = TokenGenerator(client_id="1875:55979:6.0.0a:windows:windows")
+    
+    try:
+        for name, scope in scope_examples:
+            print(f"\n🎯 {name} Scopes:")
+            print(f"   Scope: {scope}")
+            
+            try:
+                token_data = token_gen.generate_token(
+                    username=username,
+                    password=password,
+                    scope=scope
+                )
+                
+                print(f"   ✅ Success! Scopes: {token_data.get('scopes', [])}")
+                
+            except Exception as e:
+                print(f"   ❌ Failed: {e}")
+    
+    finally:
+        token_gen.close()
+
+if __name__ == "__main__":
+    main()
+    
+    # Uncomment to test different scopes
+    # demo_scopes()