mc5-api-client 1.0.16__py3-none-any.whl → 1.0.18__py3-none-any.whl

{mc5_api_client-1.0.16.dist-info → mc5_api_client-1.0.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.16
+Version: 1.0.18
 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,10 +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.8-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** - your friendly Python library for connecting to the MC5 game API. Whether you want to automate your clan management, check your daily tasks, or just explore the game's data, this library makes it super easy!
+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.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?
 
@@ -97,9 +119,11 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 - 💬 **Complete Communication System**: Private messages, squad wall posts, and alerts
 - 🎯 **Kill Signature Management**: Update player kill signatures and colors
 - 📊 **Statistics & Analytics**: Track squad performance, member activity, and progress
-- 🎮 **Friend Management**: Send friend requests and manage connections
+- 🎮 **Friend Management**: Send friend requests, accept requests, and manage connections
 - 📅 **Daily Tasks & Events**: Never miss your daily rewards and special events
 - 🏆 **Leaderboards**: See how you rank against other players
+- 🎯 **Event Management**: Sign up for events and track your rankings
+- 👥 **Squad Invitations**: Accept or decline squad invitations
 - 🎮 **Game Data**: Access weapons, items, and game configuration
 - 🖥️ **Modern CLI**: A beautiful command-line tool with colors and emojis
 - 🔄 **Auto-Refresh**: Tokens refresh automatically - no interruptions!
@@ -111,16 +135,170 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 - 🎯 **NEW: Player Score Updates**: Update any player's score, XP, and kill signatures!
 - 🛡️ **NEW: Built-in Help System**: Comprehensive help commands and examples!
 - 🔐 **NEW: Encrypted Token Support**: Generate and encrypt tokens for additional security!
+- 📱 **NEW: Android Platform Support**: Full Android API compatibility with proper client IDs!
+- 🔄 **NEW: Platform Switching**: Switch between PC and Android at runtime!
 
 ## 🚀 Installation
 
-### 🎉 MC5 API Client v1.0.8 - Advanced Automation & Admin Features!
+### 🎉 MC5 API Client v1.0.18 - Super Easy Interface & Clean API!
 
 ```bash
-pip install mc5_api_client==1.0.8
+pip install mc5_api_client==1.0.18
 ```
 
-### ✅ **Major Enhancements Completed!**
+### ✅ **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
+# 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"
+```
+
+### **📱 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
+- ✅ **Squad Editing**: Update squad rating, name, description, member limits
+- ✅ **Friend Removal**: Remove friends and send notification messages
+- ✅ **Complete Friend Lifecycle**: Add, check, remove, and notify friends
+- ✅ **Enhanced Chat Features**: Squad messages, global chat, private messages
+- ✅ **Batch Profiles**: Get multiple player profiles in single request
+
+**�🎯 Event & Squad Management (NEW in v1.0.16):**
+- ✅ **Event Signups**: Sign up for events and track participation
+- ✅ **Event Leaderboards**: Get event rankings and your position
+- ✅ **Squad Invitations**: Accept or decline squad invitations automatically
+- ✅ **Friend Request Acceptance**: Accept incoming friend requests
+- ✅ **Complete Friend Management**: Send, accept, check status, and remove friends
+- ✅ **Message Cleanup**: Automatic invitation message deletion
 
 **🚀 Advanced Automation Features (NEW in v1.0.8+):**
 - ✅ **AdminMC5Client**: Enhanced client with admin privileges
@@ -168,7 +346,271 @@ pip install mc5_api_client==1.0.8
 pip install mc5_api_client
 ```
 
-✅ **Published and Available!** The MC5 API Client v1.0.8 is now live on PyPI with advanced automation features and admin capabilities!
+✅ **Published and Available!** The MC5 API Client v1.0.17 is now live on PyPI with enhanced Android support and squad management features!
+
+## 📱 **Android Platform Support (Enhanced in v1.0.17)**
+
+### **⭐ PC & Android Platforms:**
+```python
+from mc5_api_client import MC5Client, Platform
+
+# PC Client (Default)
+pc_client = MC5Client()
+
+# Android Client
+android_client = MC5Client(platform=Platform.ANDROID)
+
+# Show platform info
+info = android_client.get_platform_info()
+print(f"Platform: {info['platform']}")
+print(f"Client ID: {info['client_id']}")
+print(f"Device Model: {info['device_info']['device_model']}")
+```
+
+### **⭐ Platform Switching:**
+```python
+# Start with PC
+client = MC5Client()
+print(f"Platform: {client.get_platform_info()['platform']}")
+
+# Switch to Android
+client.switch_platform(Platform.ANDROID)
+print(f"New Platform: {client.get_platform_info()['platform']}")
+```
+
+### **⭐ Android Authentication:**
+```python
+from mc5_api_client import MC5Client, Platform, get_android_anonymous_credential
+
+# Generate Android credential
+android_credential = get_android_anonymous_credential()
+
+# Create Android client and authenticate
+android_client = MC5Client(platform=Platform.ANDROID)
+token_data = android_client.authenticate(android_credential, "YOUR_PASSWORD_HERE")
+```
+
+### **⭐ Android Chat & Messaging:**
+```python
+from mc5_api_client import MC5Client, Platform
+
+# Android client for chat features
+android_client = MC5Client(platform=Platform.ANDROID)
+android_client.authenticate(android_credential, android_password)
+
+# Subscribe to chat room
+room_id = "0ab3827a-012e-11f1-bd7d-b8ca3a709038"
+chat_subscription = android_client.subscribe_to_chat_room(room_id, language="en")
+print(f"Chat URL: {chat_subscription['listen_url']}")
+
+# Send message to squad
+squad_message = android_client.send_squad_message(
+    room_id, 
+    "hi squad", 
+    kill_sign="default_killsig_03",
+    kill_sign_color="1212155"
+)
+
+# Send global chat message
+global_message = android_client.send_global_message(
+    "hi", 
+    nickname="Falcon",
+    kill_sign="default_killsig_03"
+)
+
+# Get squad wall posts
+wall_posts = android_client.get_squad_wall(
+    room_id,
+    limit=20,
+    include_fields=["actor", "creation", "id", "text"]
+)
+```
+
+### **⭐ Android Private Messaging:**
+```python
+# Send private message
+pm_result = android_client.send_private_message(
+    target_credential="anonymous:YW5kcm9pZF92Ml9BTk1QLkdsb2Z0TTVITV8xNzcwMTM2NzkxX0zMRc+hRRtDwFLgohGRt0A=",
+    message=".",
+    from_name="Falcon",
+    kill_sign="default_killsig_03",
+    kill_sign_color="1212155"
+)
+
+# Check friend connection
+friend_status = android_client.check_friend_connection(
+    target_credential="anonymous:TARGET_CREDENTIAL_HERE"
+)
+
+# Remove friend
+remove_result = android_client.remove_friend(
+    target_credential="anonymous:TARGET_CREDENTIAL_HERE"
+)
+
+# Send friend removed notification
+removed_message = android_client.send_friend_removed_message(
+    target_credential="anonymous:TARGET_CREDENTIAL_HERE",
+    message="removed",
+    from_name="Falcon",
+    kill_sign="default_killsig_03",
+    kill_sign_color="1212155"
+)
+```
+
+### **⭐ Android Squad Editing:**
+```python
+# Get current squad info
+clan_id = "7c219936-d85e-11f0-be62-b8ca3a7095d0"
+squad_info = android_client.get_squad_info(clan_id)
+print(f"Current score: {squad_info.get('score', 0)}")
+print(f"Current rating: {squad_info.get('_rating', 'N/A')}")
+
+# Update squad information
+update_result = android_client.update_squad_info(
+    clan_id=clan_id,
+    rating=1411,
+    score=5000,
+    name="the pro warrior1",
+    description="Hellllo",
+    member_count=2,
+    member_limit=300,
+    membership="owner_approved",
+    logo="1",
+    logo_color_primary=12722475,
+    logo_color_secondary=16777215,
+    min_join_value=996699,
+    currency=10000,
+    active_clan_label=True
+)
+
+if update_result:
+    print("✅ Squad updated successfully!")
+    
+    # Verify update
+    updated_info = android_client.get_squad_info(clan_id)
+    print(f"Updated rating: {updated_info.get('_rating', 'N/A')}")
+    print(f"Updated name: {updated_info.get('name', 'N/A')}")
+```
+```
+
+### **⭐ Android Squad Wall Posts:**
+```python
+# Post to squad wall
+wall_post = android_client.post_to_squad_wall(
+    room_id,
+    message="hi",
+    kill_sign="default_killsig_03",
+    kill_sign_color=1212155,
+    language="en"
+)
+print(f"Wall post ID: {wall_post['id']}")
+```
+
+### **⭐ Android Game Alias:**
+```python
+# Get game alias
+alias_info = android_client.get_game_alias()
+print(f"Game Alias: {alias_info['alias']}")
+```
+
+### **⭐ Android Batch Profiles:**
+```python
+# Get batch profiles for multiple players
+credentials = [
+    "fed_id:EXAMPLE_PLAYER_ID_1",
+    "fed_id:EXAMPLE_PLAYER_ID_2"
+]
+
+batch_profiles = android_client.get_batch_profiles(
+    credentials,
+    include_fields=["_game_save", "inventory"]
+)
+
+# Process batch results
+for credential, profile_data in batch_profiles.items():
+    if profile_data and "_game_save" in profile_data:
+        game_save = profile_data["_game_save"]
+        inventory = profile_data.get("inventory", {})
+        
+        print(f"Player: {credential}")
+        print(f"  Rating: {game_save.get('rating', 0)}")
+        print(f"  XP: {inventory.get('xp', 0)}")
+        print(f"  Weapons: {len(game_save.get('inventory', {}).get('weapons', {}))}")
+        
+        # Get loadouts
+        loadouts = game_save.get('loadouts', [])
+        print(f"  Loadouts: {len(loadouts)}")
+        
+        # Get statistics
+        stats = game_save.get('statistics', {})
+        if stats:
+            mp_stats = stats.get('mp', {})
+            sp_stats = stats.get('sp', {})
+            print(f"  MP Kills: {mp_stats.get('kill.total', 0)}")
+            print(f"  SP Kills: {sp_stats.get('kill.total', 0)}")
+```
+
+## 🎯 **Event Management (NEW in v1.0.16)**
+
+### **⭐ Event Signups & Leaderboards:**
+```python
+from mc5_api_client import quick_sign_up_for_event, quick_get_event_leaderboard, quick_get_my_event_rank
+
+# Sign up for an event
+event_id = "0c646c6a-e61c-11f0-be58-b8ca3a634708"
+success = quick_sign_up_for_event(event_id, "username", "password")
+
+# Get event leaderboard
+leaderboard = quick_get_event_leaderboard(event_id, "username", "password", limit=10)
+if leaderboard:
+    print(f"Top players: {len(leaderboard['data'])} entries")
+    for player in leaderboard['data'][:3]:
+        print(f"{player['display_name']}: {player['score']} points")
+
+# Get your event rank
+my_rank = quick_get_my_event_rank(event_id, "username", "password")
+if my_rank:
+    print(f"Your rank: {my_rank['my_entry']['rank']}, Score: {my_rank['my_entry']['score']}")
+```
+
+## 👥 **Squad & Friend Management (NEW in v1.0.16)**
+
+### **⭐ Squad Invitations:**
+```python
+from mc5_api_client import quick_get_squad_invitations, quick_accept_squad_invitation, quick_decline_squad_invitation
+
+# Get squad invitations
+invitations = quick_get_squad_invitations("username", "password")
+for invite in invitations:
+    squad_name = invite['group']['name']
+    requester = invite['requester']['name']
+    print(f"Invitation to {squad_name} from {requester}")
+    
+    # Accept invitation
+    success = quick_accept_squad_invitation(invite, "username", "password")
+    
+    # Or decline invitation
+    # success = quick_decline_squad_invitation(invite, "username", "password")
+```
+
+### **⭐ Friend Request Management:**
+```python
+from mc5_api_client import quick_send_friend_request, quick_accept_friend_request, quick_check_friend_status
+
+# Send friend request
+success = quick_send_friend_request("target_user_id", "username", "password")
+
+# Accept incoming friend request
+request_id = "57f0e450-010c-11f1-bffe-b8ca3a709038"
+result = quick_accept_friend_request(request_id, "username", "password")
+if result:
+    print(f"Accepted friend request from {result['requester']['name']}")
+
+# Check friend status
+status = quick_check_friend_status("target_user_id", "username", "password")
+if status:
+    print(f"Friend status: {status.get('type', 'Unknown')}")
+```
 
 ## 🚀 **Admin Features & Squad Management**
 
@@ -856,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)
@@ -871,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}")
 ```
 
@@ -1558,6 +2000,51 @@ client.close()
 - ✅ Background task support
 - ✅ Scheduled operations
 
+## 📋 **Changelog**
+
+### **v1.0.16 - Event & Squad Management (Latest)**
+- ✅ **Event Management**: Sign up for events, get leaderboards, track rankings
+- ✅ **Squad Invitations**: Accept or decline squad invitations automatically
+- ✅ **Friend Request Acceptance**: Accept incoming friend requests
+- ✅ **Complete Friend Management**: Send, accept, check status, and remove friends
+- ✅ **Message Cleanup**: Automatic invitation message deletion
+- ✅ **Real API Testing**: All features tested with actual MC5 game data
+- ✅ **Production Ready**: Thoroughly tested and verified
+
+### **v1.0.15 - Friend Management System**
+- ✅ **Friend Requests**: Send friend requests to other players
+- ✅ **Friend Status**: Check connection status with friends
+- ✅ **Friend Removal**: Remove friends with notifications
+- ✅ **Connection Management**: Complete friend relationship handling
+
+### **v1.0.14 - Help System & Documentation**
+- ✅ **Built-in Help**: Comprehensive help commands and examples
+- ✅ **Quick Reference**: Easy access to common operations
+- ✅ **Usage Examples**: Real-world code examples
+- ✅ **API Documentation**: Complete method documentation
+
+### **v1.0.13 - Enhanced Security**
+- ✅ **Encrypted Tokens**: Generate and encrypt tokens for security
+- ✅ **Token Management**: Advanced token handling capabilities
+- ✅ **Security Features**: Additional authentication options
+
+### **v1.0.12 - Admin Capabilities**
+- ✅ **AdminMC5Client**: Enhanced client with admin privileges
+- ✅ **Player Score Updates**: Update any player's score, XP, and kill signatures
+- ✅ **Advanced Squad Management**: Admin-level squad operations
+
+### **v1.0.11 - Automation Features**
+- ✅ **Batch Processing**: Search multiple players with loops
+- ✅ **Real-time Monitoring**: Continuous activity tracking
+- ✅ **Smart Clan Cleanup**: Intelligent member management
+- ✅ **Production Ready**: Thoroughly tested features
+
+### **v1.0.10 - Core Features**
+- ✅ **Basic Clan Management**: Create and manage clans
+- ✅ **Player Profiles**: Check stats and update profiles
+- ✅ **Communication**: Private messages and squad wall posts
+- ✅ **Authentication**: Secure login system
+
 ## 🧪 For Developers
 
 Want to contribute or modify the library?
@@ -1672,6 +2159,238 @@ mc5 --help  # See all commands!
 
 ---
 
+## 🌐 **Federation & Session Management (NEW in v1.0.16)**
+
+### **⭐ Active Session Tracking:**
+```python
+from mc5_api_client import quick_get_active_sessions, quick_get_session_statistics
+
+# Get all active sessions
+sessions = quick_get_active_sessions(username, password)
+print(f"Found {sessions.get('total_count', 0)} active sessions")
+
+# Get session statistics
+stats = quick_get_session_statistics(username, password)
+print(f"Server distribution: {stats.get('server_type_distribution', {})}")
+
+# Filter by server type
+ts_sessions = quick_get_server_type_sessions(username, password, "ts")
+print(f"Found {ts_sessions.get('total_count', 0)} team server sessions")
+```
+
+### **⭐ User Session Management:**
+```python
+from mc5_api_client import quick_get_my_sessions, quick_check_session_status
+
+# Get current user's sessions
+my_sessions = quick_get_my_sessions(username, password)
+print(f"You have {my_sessions.get('total_count', 0)} active sessions")
+
+# Check specific session status
+status = quick_check_session_status(username, password, fed_id)
+if status.get('found'):
+    print(f"Session is active: {status.get('status')}")
+```
+
+### **⭐ Activity Analysis:**
+```python
+from mc5_api_client import quick_analyze_session_activity
+
+# Analyze overall activity
+analysis = quick_analyze_session_activity(username, password)
+print(f"Most active server: {analysis.get('most_active_server_type')}")
+print(f"Most active country: {analysis.get('most_active_country')}")
+```
+
+## 📝 **Squad Wall Messages (NEW in v1.0.16)**
+
+### **⭐ Wall Message Posting:**
+```python
+from mc5_api_client import quick_post_squad_wall_message
+
+# Post message to squad wall
+message_id = quick_post_squad_wall_message(
+    username, password, squad_id, 
+    "Welcome to the squad! 🎮",
+    player_killsig="default_killsig_42",
+    player_killsig_color=-974646126
+)
+
+if message_id:
+    print(f"Message posted! ID: {message_id}")
+```
+
+### **⭐ Advanced Wall Posting:**
+```python
+from mc5_api_client import SimpleMC5Client
+
+with SimpleMC5Client(username, password) as client:
+    if client.connect():
+        # Post with custom settings
+        result = client.client.post_squad_wall_message(
+            squad_id=squad_id,
+            message="Victory! Great teamwork! 🎉",
+            player_killsig="default_killsig_80",
+            player_killsig_color=16777215,  # White
+            language="en"
+        )
+        
+        message_id = result.get('id')
+        print(f"Posted with ID: {message_id}")
+```
+
+## Account Management (NEW in v1.0.16)
+
+### Comprehensive Account Information:
+```python
+from mc5_api_client import quick_get_account_info, quick_get_account_overview
+
+# Get complete account information
+account_info = quick_get_account_info(username, password)
+print(f"Account ID: {account_info['account_data']['account']}")
+print(f"Credentials: {len(account_info['account_data']['credentials'])}")
+print(f"Installations: {len(account_info['account_data']['installations'])}")
+
+# Get complete account overview
+overview = quick_get_account_overview(username, password)
+print(f"Security Score: {overview['security_summary']['security_score']}/100")
+print(f"Total Devices: {overview['device_summary']['total_devices']}")
+```
+
+### **⭐ Device History Analysis:**
+```python
+from mc5_api_client import quick_get_device_history
+
+# Get device installation history
+device_history = quick_get_device_history(username, password)
+timeline = device_history['device_timeline']
+
+for device in timeline[-5:]:  # Last 5 devices
+    print(f"Device: {device['model']} ({device['country']})")
+    print(f"  Resolution: {device['resolution']}")
+    print(f"  Firmware: {device['firmware']}")
+```
+
+### **⭐ Credential Management:**
+```python
+from mc5_api_client import quick_get_credential_summary
+
+# Get credential summary
+credentials = quick_get_credential_summary(username, password)
+print(f"Total credentials: {credentials['credential_count']}")
+print(f"Types: {', '.join(credentials['credential_types'])}")
+
+# Analyze credential types
+for cred in credentials['credential_details'][:5]:
+    print(f"{cred['type']}: {cred['value']}")
+```
+
+### **⭐ Security Analysis:**
+```python
+from mc5_api_client import quick_analyze_account_security
+
+# Analyze account security
+security = quick_analyze_account_security(username, password)
+print(f"Security Score: {security['security_score']}/100")
+print(f"Risk Level: {security['risk_level']}")
+
+if security['security_issues']:
+    print("Security Issues:")
+    for issue in security['security_issues']:
+        print(f"  • {issue}")
+```
+
+### **⭐ Data Export:**
+```python
+from mc5_api_client import quick_export_account_data
+
+# Export complete account data
+success = quick_export_account_data(username, password, "my_account.json")
+if success:
+    print("Account data exported successfully!")
+```
+
+## �🔍 **Enhanced Debugging & Telemetry (NEW in v1.0.16)**
+
+### **⭐ Enhanced Debug Mode:**
+```python
+from mc5_api_client import debug_mode, telemetry, debug_print
+
+# Enable debug mode (enables telemetry + debugging)
+debug_mode(True)
+
+# Enable/disable telemetry separately
+telemetry(True)  # Enable error reporting
+telemetry(False)  # Disable error reporting
+
+# Print debug messages
+debug_print("This is a debug message", "info")
+debug_print("This is a warning", "warning")
+debug_print("This is an error", "error")
+debug_print("This is success", "success")
+```
+
+### **⭐ Function Debugging:**
+```python
+from mc5_api_client import debug_function
+
+# Add debugging to any function
+@debug_function
+def my_function():
+    # This will automatically track performance and errors
+    pass
+
+# Enhanced SimpleMC5Client with debugging
+from mc5_api_client import SimpleMC5Client, debug_mode
+
+debug_mode(True)  # Enable debug mode
+client = SimpleMC5Client(username, password)
+if client.connect():
+    # All operations will be logged with timing
+    profile = client.client.get_profile()
+    invitations = client.get_squad_invitations()
+```
+
+### **⭐ Automatic Error Reporting:**
+When telemetry is enabled, errors are automatically sent to Discord webhook with:
+- 🎨 **Beautiful Discord Embeds** with colored formatting
+- 📊 **System Information** (Python version, platform, architecture)
+- ⏱️ **Performance Data** (request duration, response size)
+- 🎯 **Context Information** (function name, parameters)
+- 💡 **Error Analysis** with intelligent suggestions
+
+### **⭐ Debug Output Examples:**
+```
+[17:14:16] 🔍 Debug: Making GET request to accounts/me
+[17:14:16] ✅ Debug: GET request successful (0.43s)
+[17:14:16] ❌ Debug: Authentication failed (0.12s)
+[17:14:16] ❌ Error Analysis: AuthenticationError
+[17:14:16] ❌ Suggestions:
+   1. Check your username and password
+   2. Verify your account is not banned
+   3. Try re-authenticating with a fresh token
+```
+
+### **⭐ Performance Monitoring:**
+```
+🔍 Debug: Starting my_function
+🔍 Debug: Parameters: {"args": ["test"], "kwargs": {"count": 5}}
+✅ Debug: my_function completed successfully (0.25s)
+```
+
+### **⭐ Debug Report:**
+```python
+from mc5_api_client.debug import create_debug_report, print_debug_report
+
+# Print comprehensive debug report
+print_debug_report()
+
+# Save debug report to file
+report = create_debug_report()
+```
+
+---
+
 ## 🎉 **Production Status: READY!**
 
 ✅ **All Tests Passed**: 9/9 production readiness tests successful