mc5-api-client 1.0.10__py3-none-any.whl → 1.0.11__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.11"
 __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.11", "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.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.10
+Version: 1.0.11
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -413,15 +413,16 @@ try: except MC5APIError:
 ### **🚀 Install from PyPI (Recommended)**
 
 ```bash
-pip install mc5_api_client==1.0.8
+pip install mc5_api_client==1.0.10
 ```
 
-✅ **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.10 is now live on PyPI with advanced automation features and admin capabilities!
 
 ### **� 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 +810,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.11.dist-info}/RECORD

@@ -1,15 +1,15 @@
-mc5_api_client/__init__.py,sha256=Tdr0ZbZ85zqOOl7OF0mCs9Lycurv6mOuS9YZfvdc2WM,1712
+mc5_api_client/__init__.py,sha256=vJQmJ58TMBZ6Qeko7J9mQJht_71bwc7obVQtNrvkFQY,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=D5RTwRQJz86xf8Ocqj0Zr4O3BjPIj6_kbChEeF-ha5g,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.11.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
+mc5_api_client-1.0.11.dist-info/METADATA,sha256=q6squlB7kiIgfioZBPKfPWniTFXoV8I-2rTKgZQyX6k,54718
+mc5_api_client-1.0.11.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mc5_api_client-1.0.11.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
+mc5_api_client-1.0.11.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
+mc5_api_client-1.0.11.dist-info/RECORD,,