mc5-api-client 1.0.17__py3-none-any.whl → 1.0.19__py3-none-any.whl

mc5_api_client/pc_storage_client.py

@@ -0,0 +1,229 @@
+# ────────────[ CHIZOBA ]────────────────────────────
+# | Email    : chizoba2026@hotmail.com
+# | File     : pc_storage_client.py
+# | License  : MIT License © 2026 Chizoba
+# | Brief    | PC storage admin client for MC5 API
+# ────────────────★─────────────────────────────────
+
+"""
+PC Storage Admin Client for MC5 API with storage, storage_restricted, and storage_admin scopes.
+Provides advanced squad management capabilities for PC platform.
+"""
+
+from typing import Optional, Dict, Any, List
+from .client import MC5Client
+from .platform import Platform
+from .storage_admin import StorageAdminMixin
+from .auth import TokenGenerator
+from .exceptions import MC5APIError
+
+
+class PCStorageClient(MC5Client, StorageAdminMixin):
+    """
+    PC Storage Admin Client with advanced squad management capabilities.
+    
+    This client uses storage scopes to provide admin-level squad management
+    including deletion, comprehensive updates, and audit capabilities.
+    """
+    
+    def __init__(
+        self,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        device_id: Optional[str] = None,
+        scope: str = "alert auth chat leaderboard_ro lobby message session social config storage storage_restricted storage_admin tracking_bi feed storage leaderboard_admin social_eve social soc transaction schedule lottery voice matchmaker",
+        auto_refresh: bool = True,
+        timeout: int = 30
+    ):
+        """
+        Initialize PC Storage Admin Client.
+        
+        Args:
+            username: MC5 username (default: game:mc5_system)
+            password: Account password (default: admin)
+            device_id: Device ID (generated if not provided)
+            scope: Permission scopes with storage capabilities
+            auto_refresh: Whether to auto-refresh tokens
+            timeout: Request timeout in seconds
+            debug_mode: Enable debug mode
+        """
+        # Default to game:mc5_system for storage admin
+        if username is None:
+            username = "game:mc5_system"
+        if password is None:
+            password = "admin"
+        
+        # Set storage-specific attributes before calling parent constructor
+        self._storage_scope = scope
+        self._device_id = device_id or ""
+        self._username = username
+        self._password = password
+        
+        # Initialize with PC platform
+        super().__init__(
+            username=username,
+            password=password,
+            platform=Platform.PC,
+            client_id="1875:55979:6.0.0a:windows:windows",
+            auto_refresh=auto_refresh,
+            timeout=timeout
+        )
+        
+        # Override token generation for storage admin
+        self.token_generator = TokenGenerator()
+        
+        # Set storage base URL
+        self._storage_base_url = "https://eur-seshat.gameloft.com"
+    
+    def authenticate(
+        self, 
+        username: Optional[str] = None, 
+        password: Optional[str] = None, 
+        device_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """
+        Authenticate with storage admin scopes.
+        
+        Args:
+            username: Username (uses instance default if None)
+            password: Password (uses instance default if None)
+            device_id: Device ID (uses instance default if None)
+            
+        Returns:
+            Authentication response with storage scopes
+        """
+        username = username or self._username
+        password = password or self._password
+        device_id = device_id or self._device_id
+        
+        try:
+            token_data = self.token_generator.generate_token(
+                username=username,
+                password=password,
+                device_id=device_id,
+                scope=self._storage_scope
+            )
+            
+            self._token_data = token_data
+            self._username = username
+            
+            # Update session headers
+            self.session.headers.update({
+                "User-Agent": f"MC5-PC-Storage-Admin/1.0.17",
+                "Accept": "application/json",
+                "Content-Type": "application/json"
+            })
+            
+            return token_data
+            
+        except Exception as e:
+            raise MC5APIError(f"Storage admin authentication failed: {e}")
+    
+    def get_storage_info(self) -> Dict[str, Any]:
+        """
+        Get current storage admin information.
+        
+        Returns:
+            Storage admin information including scopes and capabilities
+        """
+        if not self._token_data:
+            return {"error": "Not authenticated"}
+        
+        return {
+            "username": self._username,
+            "platform": self.get_platform_info()["platform"],
+            "scopes": self._token_data.get("scopes", []),
+            "client_id": self.client_id,
+            "has_storage": "storage" in self._token_data.get("scopes", []),
+            "has_storage_restricted": "storage_restricted" in self._token_data.get("scopes", []),
+            "has_storage_admin": "storage_admin" in self._token_data.get("scopes", []),
+            "capabilities": self._get_storage_capabilities()
+        }
+    
+    def _get_storage_capabilities(self) -> List[str]:
+        """Get available storage capabilities based on scopes."""
+        scopes = self._token_data.get("scopes", [])
+        capabilities = []
+        
+        if "storage" in scopes:
+            capabilities.extend([
+                "read_squad_info",
+                "update_squad_info",
+                "get_all_squads",
+                "get_squad_audit_log"
+            ])
+        
+        if "storage_restricted" in scopes:
+            capabilities.extend([
+                "limited_squad_updates",
+                "read_squad_audit_log"
+            ])
+        
+        if "storage_admin" in scopes:
+            capabilities.extend([
+                "delete_squad",
+                "batch_delete_squads",
+                "transfer_squad_ownership",
+                "full_squad_management",
+                "admin_audit_access"
+            ])
+        
+        return capabilities
+    
+    def quick_squad_management_report(self, squad_id: str) -> Dict[str, Any]:
+        """
+        Generate a comprehensive squad management report.
+        
+        Args:
+            squad_id: Squad ID to analyze
+            
+        Returns:
+            Comprehensive squad report
+        """
+        try:
+            # Get squad info
+            squad_info = self.get_squad_storage_info(squad_id)
+            
+            # Get audit log if available
+            audit_log = None
+            if self._has_storage_capability("get_squad_audit_log"):
+                try:
+                    audit_log = self.get_squad_audit_log(squad_id, limit=10)
+                except:
+                    audit_log = {"error": "Audit log not available"}
+            
+            return {
+                "squad_id": squad_id,
+                "squad_info": squad_info,
+                "audit_log": audit_log,
+                "storage_capabilities": self._get_storage_capabilities(),
+                "available_actions": self._get_available_actions(squad_id)
+            }
+            
+        except Exception as e:
+            return {"error": f"Failed to generate report: {e}"}
+    
+    def _has_storage_capability(self, capability: str) -> bool:
+        """Check if a specific storage capability is available."""
+        return capability in self._get_storage_capabilities()
+    
+    def _get_available_actions(self, squad_id: str) -> List[str]:
+        """Get available actions for a squad based on storage capabilities."""
+        actions = []
+        
+        if self._has_storage_capability("read_squad_info"):
+            actions.append("read_info")
+        
+        if self._has_storage_capability("update_squad_info"):
+            actions.append("update_info")
+        
+        if self._has_storage_capability("delete_squad"):
+            actions.append("delete")
+        
+        if self._has_storage_capability("transfer_squad_ownership"):
+            actions.append("transfer_ownership")
+        
+        if self._has_storage_capability("get_squad_audit_log"):
+            actions.append("view_audit_log")
+        
+        return actions

mc5_api_client/pc_storage_quick.py

@@ -0,0 +1,234 @@
+# ────────────[ CHIZOBA ]────────────────────────────
+# | Email    : chizoba2026@hotmail.com
+# | File     : pc_storage_quick.py
+# | License  : MIT License © 2026 Chizoba
+# | Brief    | Quick functions for PC storage admin
+# ────────────────★─────────────────────────────────
+
+"""
+Quick functions for PC Storage Admin operations.
+Provides simple one-liner functions for common storage admin tasks.
+"""
+
+from typing import Optional, Dict, Any, List
+from .pc_storage_client import PCStorageClient
+
+
+def quick_get_squad_storage_info(squad_id: str) -> Optional[Dict[str, Any]]:
+    """
+    Quick function to get squad storage information.
+    
+    Args:
+        squad_id: Squad ID to retrieve
+        
+    Returns:
+        Squad storage information or None if failed
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        return client.get_squad_storage_info(squad_id)
+    except Exception:
+        return None
+
+
+def quick_update_squad_storage(
+    squad_id: str,
+    name: Optional[str] = None,
+    description: Optional[str] = None,
+    rating: Optional[int] = None,
+    member_limit: Optional[int] = None,
+    privacy: Optional[str] = None
+) -> bool:
+    """
+    Quick function to update squad storage information.
+    
+    Args:
+        squad_id: Squad ID to update
+        name: New squad name
+        description: New squad description
+        rating: New squad rating
+        member_limit: New member limit
+        privacy: Privacy settings
+        
+    Returns:
+        True if successful, False otherwise
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        result = client.update_squad_storage(
+            squad_id=squad_id,
+            name=name,
+            description=description,
+            rating=rating,
+            member_limit=member_limit,
+            privacy=privacy
+        )
+        return True
+    except Exception:
+        return False
+
+
+def quick_delete_squad(squad_id: str) -> bool:
+    """
+    Quick function to delete a squad (requires storage_admin scope).
+    
+    Args:
+        squad_id: Squad ID to delete
+        
+    Returns:
+        True if successful, False otherwise
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        result = client.delete_squad(squad_id)
+        return True
+    except Exception:
+        return False
+
+
+def quick_get_all_squads(limit: int = 50) -> Optional[List[Dict[str, Any]]]:
+    """
+    Quick function to get all squads.
+    
+    Args:
+        limit: Number of squads to retrieve
+        
+    Returns:
+        List of squads or None if failed
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        result = client.get_all_squads(limit=limit)
+        return result.get('squads', []) if isinstance(result, dict) else result
+    except Exception:
+        return None
+
+
+def quick_batch_delete_squads(squad_ids: List[str]) -> Dict[str, Any]:
+    """
+    Quick function to delete multiple squads.
+    
+    Args:
+        squad_ids: List of squad IDs to delete
+        
+    Returns:
+        Batch deletion results
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        return client.batch_delete_squads(squad_ids)
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def quick_transfer_squad_ownership(
+    squad_id: str,
+    new_owner_credential: str
+) -> bool:
+    """
+    Quick function to transfer squad ownership.
+    
+    Args:
+        squad_id: Squad ID to transfer
+        new_owner_credential: New owner's credential
+        
+    Returns:
+        True if successful, False otherwise
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        result = client.transfer_squad_ownership(squad_id, new_owner_credential)
+        return True
+    except Exception:
+        return False
+
+
+def quick_get_squad_audit_log(squad_id: str, limit: int = 20) -> Optional[List[Dict[str, Any]]]:
+    """
+    Quick function to get squad audit log.
+    
+    Args:
+        squad_id: Squad ID to get audit log for
+        limit: Number of audit entries to retrieve
+        
+    Returns:
+        Audit log entries or None if failed
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        result = client.get_squad_audit_log(squad_id, limit=limit)
+        return result.get('entries', []) if isinstance(result, dict) else result
+    except Exception:
+        return None
+
+
+def quick_squad_management_report(squad_id: str) -> Optional[Dict[str, Any]]:
+    """
+    Quick function to generate comprehensive squad management report.
+    
+    Args:
+        squad_id: Squad ID to analyze
+        
+    Returns:
+        Comprehensive squad report or None if failed
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        return client.quick_squad_management_report(squad_id)
+    except Exception:
+        return None
+
+
+def quick_check_storage_capabilities() -> Optional[Dict[str, Any]]:
+    """
+    Quick function to check current storage capabilities.
+    
+    Returns:
+        Storage capabilities information or None if failed
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        return client.get_storage_info()
+    except Exception:
+        return None
+
+
+def quick_analyze_squad(squad_id: str) -> Optional[Dict[str, Any]]:
+    """
+    Quick function to analyze squad with all available storage data.
+    
+    Args:
+        squad_id: Squad ID to analyze
+        
+    Returns:
+        Squad analysis results or None if failed
+    """
+    try:
+        client = PCStorageClient()
+        client.authenticate()
+        
+        # Get comprehensive squad data
+        squad_info = client.get_squad_storage_info(squad_id)
+        audit_log = client.get_squad_audit_log(squad_id, limit=10)
+        
+        return {
+            "squad_id": squad_id,
+            "squad_info": squad_info,
+            "audit_log": audit_log,
+            "analysis": {
+                "has_data": bool(squad_info),
+                "has_audit_log": bool(audit_log),
+                "available_actions": client._get_available_actions(squad_id)
+            }
+        }
+    except Exception:
+        return None

mc5_api_client/platform.py

@@ -1,9 +1,8 @@
 #!/usr/bin/env python3
-# ────────────[ KAKUZU ]────────────────────────────
-# | Discord  : kakuzu_f0
-# | Telegram : kakuzu_f0
+# ────────────[ CHIZOBA ]────────────────────────────
+# | Email    : chizoba2026@hotmail.com
 # | File     : platform.py
-# | License  : MIT License © 2026 Kakuzu
+# | License  : MIT License  2026 Chizoba
 # | Brief    : Platform support for MC5 API Client (PC & Android)
 # ────────────────★─────────────────────────────────