mc5-api-client 1.0.10__py3-none-any.whl → 1.0.12__py3-none-any.whl

mc5_api_client/__init__.py

@@ -13,7 +13,9 @@ Provides easy access to authentication, profile management, clan operations,
 messaging, and more.
 """
 
-__version__ = "1.0.10"
+from typing import Optional, Dict, Any
+
+__version__ = "1.0.12"
 __author__ = "Chizoba"
 __email__ = "chizoba2026@hotmail.com"
 __license__ = "MIT"
@@ -38,6 +40,57 @@ from .admin_client import (
     quick_update_player_score
 )
 
+# Encrypted token convenience functions
+from .auth import TokenGenerator
+
+def quick_generate_encrypted_token(
+    username: str,
+    password: str,
+    device_id: Optional[str] = None,
+    scope: str = "alert auth chat leaderboard_ro lobby message session social config storage_ro tracking_bi feed storage leaderboard_admin social_eve social soc transaction schedule lottery voice matchmaker",
+    nonce: str = "*"
+) -> Dict[str, Any]:
+    """
+    Quick function to generate and encrypt an access token.
+    
+    Args:
+        username: MC5 username
+        password: Account password
+        device_id: Device ID (generated if not provided)
+        scope: Permission scopes
+        nonce: Nonce value for encryption
+        
+    Returns:
+        Dictionary containing encrypted token information
+    """
+    token_gen = TokenGenerator()
+    try:
+        result = token_gen.generate_encrypted_token(username, password, device_id, scope, nonce)
+        return result
+    finally:
+        token_gen.close()
+
+def quick_encrypt_token(
+    access_token: str,
+    nonce: str = "*"
+) -> str:
+    """
+    Quick function to encrypt an existing access token.
+    
+    Args:
+        access_token: Raw access token string
+        nonce: Nonce value for encryption
+        
+    Returns:
+        Encrypted token string
+    """
+    token_gen = TokenGenerator()
+    try:
+        result = token_gen.encrypt_token(access_token, nonce)
+        return result
+    finally:
+        token_gen.close()
+
 __all__ = [
     "MC5Client",
     "SimpleMC5Client",
@@ -57,5 +110,7 @@ __all__ = [
     "RateLimitError",
     "help",
     "examples",
-    "quick_reference"
+    "quick_reference",
+    "quick_generate_encrypted_token",
+    "quick_encrypt_token"
 ]

mc5_api_client/auth.py

@@ -38,6 +38,7 @@ class TokenGenerator:
         self,
         client_id: str = "1875:55979:6.0.0a:windows:windows",
         auth_url: str = "https://eur-janus.gameloft.com:443/authorize",
+        encrypt_url: str = "https://eur-janus.gameloft.com/encrypt_token",
         timeout: int = 30,
         max_retries: int = 3
     ):
@@ -47,11 +48,13 @@ class TokenGenerator:
         Args:
             client_id: Game client identifier
             auth_url: Authentication endpoint URL
+            encrypt_url: Token encryption endpoint URL
             timeout: Request timeout in seconds
             max_retries: Maximum number of retry attempts
         """
         self.client_id = client_id
         self.auth_url = auth_url
+        self.encrypt_url = encrypt_url
         self.timeout = timeout
         self.max_retries = max_retries
         
@@ -275,6 +278,95 @@ class TokenGenerator:
             "signature": parts[6] if len(parts) > 6 else None
         }
     
+    def encrypt_token(
+        self,
+        access_token: str,
+        nonce: str = "*"
+    ) -> str:
+        """
+        Encrypt an access token for additional security.
+        
+        Args:
+            access_token: Raw access token string
+            nonce: Nonce value for encryption (default: "*")
+            
+        Returns:
+            Encrypted token string
+            
+        Raises:
+            AuthenticationError: If encryption fails
+            NetworkError: If network issues occur
+        """
+        payload = {
+            "access_token": access_token,
+            "nonce": nonce
+        }
+        
+        try:
+            print("🔐 Encrypting token...")
+            response = self.session.post(
+                self.encrypt_url,
+                data=payload,
+                timeout=self.timeout
+            )
+            
+            if response.status_code == 200:
+                encrypted_token = response.text.strip()
+                if encrypted_token:
+                    print("✅ Token encrypted successfully")
+                    return encrypted_token
+                else:
+                    raise AuthenticationError("Empty encrypted token response")
+            else:
+                raise AuthenticationError(
+                    f"Token encryption failed with status {response.status_code}: {response.text}"
+                )
+                
+        except requests.exceptions.Timeout:
+            raise NetworkError("Token encryption request timed out")
+        except requests.exceptions.ConnectionError:
+            raise NetworkError("Failed to connect to encryption server")
+        except requests.exceptions.RequestException as e:
+            raise NetworkError(f"Network error during token encryption: {e}")
+    
+    def generate_encrypted_token(
+        self,
+        username: str,
+        password: str,
+        device_id: Optional[str] = None,
+        scope: str = "alert auth chat leaderboard_ro lobby message session social config storage_ro tracking_bi feed storage leaderboard_admin social_eve social soc transaction schedule lottery voice matchmaker",
+        nonce: str = "*"
+    ) -> Dict[str, Any]:
+        """
+        Generate and encrypt an access token in one step.
+        
+        Args:
+            username: MC5 username
+            password: Account password
+            device_id: Device ID (generated if not provided)
+            scope: Space-separated list of permission scopes
+            nonce: Nonce value for encryption (default: "*")
+            
+        Returns:
+            Dictionary containing encrypted token information
+            
+        Raises:
+            InvalidCredentialsError: If credentials are invalid
+            AuthenticationError: If authentication or encryption fails
+            NetworkError: If network issues occur
+        """
+        # First generate regular token
+        token_data = self.generate_token(username, password, device_id, scope)
+        
+        # Then encrypt it
+        encrypted_token = self.encrypt_token(token_data["access_token"], nonce)
+        
+        # Add encrypted token to result
+        token_data["encrypted_token"] = encrypted_token
+        token_data["nonce"] = nonce
+        
+        return token_data
+    
     def close(self):
         """Close the HTTP session."""
         if self.session:

mc5_api_client/cli.py

@@ -447,7 +447,7 @@ class MC5CLI:
     
     def _print_version(self):
         """Print version information."""
-        self._print("MC5 API Client v1.0.10", "cyan")
+        self._print("MC5 API Client v1.0.12", "cyan")
         self._print("The ultimate Modern Combat 5 API library", "green")
         self._print("Author: Chizoba", "blue")
         self._print("Email: chizoba2026@hotmail.com", "blue")

{mc5_api_client-1.0.10.dist-info → mc5_api_client-1.0.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.10
+Version: 1.0.12
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -108,9 +108,9 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 - ⚡ **One-Liner Functions**: Quick search and kick operations!
 - 🎯 **User-Friendly**: Designed for beginners and clan leaders!
 - 🚀 **NEW: Admin Capabilities**: Use admin credentials for enhanced squad management!
-- ⭐ **NEW: Squad Rating**: Add 5200+ rating to your squad with admin privileges!
 - 🎯 **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!
 
 ## 🚀 Installation
 
@@ -122,14 +122,14 @@ pip install mc5_api_client==1.0.8
 
 ### ✅ **Major Enhancements Completed!**
 
-**🚀 Advanced Automation Features (NEW in v1.0.8):**
+**🚀 Advanced Automation Features (NEW in v1.0.8+):**
 - ✅ **AdminMC5Client**: Enhanced client with admin privileges
-- ✅ **Squad Rating Management**: Add 5200+ rating to any squad
-- ✅ **Player Score Updates**: Update any player's score, XP, and kill signatures
+- ✅ **Player Score Management**: Update individual player scores, XP, and kill signatures
 - ✅ **Batch Processing**: Search multiple players with loops and conditionals
 - ✅ **Real-time Monitoring**: Continuous activity tracking with while loops
 - ✅ **Smart Clan Cleanup**: Intelligent member management with safety features
 - ✅ **Built-in Help System**: Comprehensive help commands and examples
+- ✅ **Encrypted Token Support**: Generate and encrypt tokens for additional security
 - ✅ **Production Ready**: Thoroughly tested and verified for production use
 
 **🎮 Revolutionary Simple Interface (from v1.0.7):**
@@ -174,12 +174,11 @@ pip install mc5_api_client
 
 New in v1.0.8! Powerful admin capabilities for enhanced squad management:
 
-### **⭐ Add 5200+ Rating to Your Squad**
-
+### **⭐ Update Player Scores (Admin Only):**
 ```python
 from mc5_api_client import quick_update_player_score
 
-# Add 5200 rating to your squad by updating your player score
+# Update any player's score, XP, and kill signature
 result = quick_update_player_score(
     target_user_id="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
     score=5200,
@@ -188,48 +187,47 @@ result = quick_update_player_score(
     killsig_id="default_killsig_80"
 )
 
-print(f"✅ Success! Score updated: {result['score_updated']}")
+if result.get('success'):
+    print("✅ Player score updated successfully!")
+    print(f"New score: {result.get('score')}")
+    print(f"New XP: {result.get('xp')}")
 ```
 
-### **🛡️ Admin Client Usage**
-
+### **� Admin Client Usage:**
 ```python
 from mc5_api_client import create_admin_client
 
-# Create admin client with enhanced privileges
+# Create admin client with elevated privileges
 client = create_admin_client()
 client.connect()
 
-# Update any player's score
+# Update player information
 result = client.update_player_score(
     target_user_id="player_user_id",
     score=10000,
-    xp=5000000
+    xp=5000000,
+    killsig_color="16777215",
+    killsig_id="default_killsig_42"
 )
 
-# Get squad members
+# Get squad members (if you have access)
 members = client.get_squad_members()
-print(f"Squad has {len(members)} members")
+print(f"Found {len(members)} squad members")
+
+# Kick members (if you have permissions)
+# client.kick_member("member_user_id", "Reason for kick")
 
 client.close()
 ```
 
-### **🎯 Quick Squad Rating**
+### **⚠️ Important Admin Limitations:**
+- ✅ **Can Update**: Individual player scores, XP, kill signatures
+- ✅ **Can Kick**: Squad members (with proper permissions)
+- ❌ **Cannot Edit**: Squad rating directly (requires squad ownership)
+- ❌ **Cannot Modify**: Squad settings (requires squad ownership)
 
-```python
-from mc5_api_client import quick_add_squad_rating
-
-# Add rating using admin credentials
-result = quick_add_squad_rating(
-    username="game:mc5_system",
-    password="admin",
-    rating=5200,
-    use_admin=True
-)
-
-if 'error' not in result:
-    print("✅ 5200 rating added to squad!")
-```
+### **🔧 How It Actually Works:**
+Admin privileges allow you to modify individual player data within a squad, which indirectly affects the squad's overall rating through the sum of member scores, but you cannot directly set the squad's rating value.
 
 ## 🎮 **Simple Usage for Non-Developers**
 
@@ -400,8 +398,7 @@ client.connect()
 player = client.search_player('f55f')
 
 # 🔹 Admin Operations
-quick_update_player_score('user_id', 5200)
-quick_add_squad_rating('admin', 'admin', 5200, use_admin=True)
+quick_update_player_score('user_id', 5200, xp=2037745)
 
 # 🔹 Error Handling
 try: except AuthenticationError:
@@ -413,15 +410,16 @@ try: except MC5APIError:
 ### **🚀 Install from PyPI (Recommended)**
 
 ```bash
-pip install mc5_api_client==1.0.8
+pip install mc5_api_client==1.0.12
 ```
 
-✅ **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.12 is now live on PyPI with accurate admin capabilities, encrypted token support, and corrected documentation!
 
 ### **� Install from Local Package**
 
 ```bash
 # Install the wheel file you just created
+pip install dist/mc5_api_client-1.0.10-py3-none-any.whl
 pip install dist/mc5_api_client-1.0.8-py3-none-any.whl
 
 # Or install from source
@@ -809,7 +807,65 @@ for event in events:
             print(f"      Task {i+1}: {points} points")
 ```
 
-### 🏆 Checking Leaderboards
+### 🔐 **Encrypted Token Support**
+
+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
+
+# Generate and encrypt a token in one step
+encrypted_data = quick_generate_encrypted_token(
+    username="anonymous:d2luOF92M18xNzcwMDUxNjkwXy7H33aeTVB4YZictyDq48c=",
+    password="sSJKzhQ5l4vrFgov",
+    nonce="*"  # Custom nonce value (optional)
+)
+
+print(f"Token ID: {encrypted_data['token_id']}")
+print(f"Encrypted Token: {encrypted_data['encrypted_token']}")
+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, "*")
+print(f"Encrypted: {encrypted_token}")
+```
+
+**Advanced TokenGenerator Usage:**
+
+```python
+from mc5_api_client import TokenGenerator
+
+# Create token generator with custom settings
+token_gen = TokenGenerator(
+    encrypt_url="https://eur-janus.gameloft.com/encrypt_token"
+)
+
+try:
+    # Generate encrypted token
+    result = token_gen.generate_encrypted_token(
+        username="anonymous:credential",
+        password="password",
+        nonce="custom_nonce"
+    )
+    
+    # Or encrypt existing token
+    encrypted = token_gen.encrypt_token(
+        access_token="raw_token",
+        nonce="custom_nonce"
+    )
+    
+finally:
+    token_gen.close()  # Always close the session
+```
+
+**Security Benefits:**
+- ✅ **Additional Layer**: Tokens are encrypted before transmission
+- ✅ **Custom Nonce**: Support for custom nonce values
+- ✅ **Backward Compatible**: Works with existing authentication flow
+- ✅ **Error Handling**: Proper validation and error recovery
+
+### 🏆 **Checking Leaderboards**
 
 See how you stack up:
 

{mc5_api_client-1.0.10.dist-info → mc5_api_client-1.0.12.dist-info}/RECORD

@@ -1,15 +1,15 @@
-mc5_api_client/__init__.py,sha256=Tdr0ZbZ85zqOOl7OF0mCs9Lycurv6mOuS9YZfvdc2WM,1712
+mc5_api_client/__init__.py,sha256=Fez2LJHEpim5fUuHFiWa7IdM_nENxWAns6_pVL_k2m8,3296
 mc5_api_client/admin_client.py,sha256=527aavolxVhY2M5ceFxVbbE5YTczU9Z86Fdt1UzdRZM,15220
-mc5_api_client/auth.py,sha256=Yj_6s8KmtbswWbR6q816d8soIirUF2aD_KWxg-jNqR0,9978
-mc5_api_client/cli.py,sha256=7_IGHBJmvJPZ3sYpBQK_mqHigGhzW-V4NWKrIpUTAc0,17255
+mc5_api_client/auth.py,sha256=z8vmyQIHUdAzk0pUyKCesT8gTv4jboLIFGBxAu1v_-8,13396
+mc5_api_client/cli.py,sha256=W7d_B8P_7qvvnAe-P3PQ-O6nW0ca7ADV3e9GLgEVylM,17255
 mc5_api_client/client.py,sha256=q5PkdpTXjWCXdLFiK1-zqa7fThJGE4Z99A3ccMfwJIY,79239
 mc5_api_client/exceptions.py,sha256=o7od4GrEIlgq6xSNUjZdh74xoDTytF3PLcMq5ewRiJw,2683
 mc5_api_client/help.py,sha256=sqf3R6VHQuSYLvAMzh8nXAgCX5URsvXydvw8P0ATabg,7246
 mc5_api_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mc5_api_client/simple_client.py,sha256=31JI2rURHIXKcnDXQYJNpr-gypweO56ANFdhD-Z4Ft0,20241
-mc5_api_client-1.0.10.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
-mc5_api_client-1.0.10.dist-info/METADATA,sha256=a9EbVzcyxNtu2sFJJFzkmnRZ3v9NPvleNyrHcKKiTeg,52876
-mc5_api_client-1.0.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mc5_api_client-1.0.10.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
-mc5_api_client-1.0.10.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
-mc5_api_client-1.0.10.dist-info/RECORD,,
+mc5_api_client-1.0.12.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
+mc5_api_client-1.0.12.dist-info/METADATA,sha256=pG3KizNZF1p2VlhGUn9a0k1E0-TrpSrrgSMsjmJ22po,55250
+mc5_api_client-1.0.12.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mc5_api_client-1.0.12.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
+mc5_api_client-1.0.12.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
+mc5_api_client-1.0.12.dist-info/RECORD,,