django-cfg 1.4.21__py3-none-any.whl → 1.4.24__py3-none-any.whl

django_cfg/apps/payments/views/serializers/__init__.py

@@ -5,69 +5,68 @@ Django REST Framework serializers with Pydantic integration and service layer va
 """
 
 # Payment serializers
-from .payments import (
-    PaymentSerializer,
-    PaymentCreateSerializer,
-    PaymentListSerializer,
-    PaymentStatusSerializer,
+# API Key serializers
+from .api_keys import (
+    APIKeyActionSerializer,
+    APIKeyCreateSerializer,
+    APIKeyDetailSerializer,
+    APIKeyListSerializer,
+    APIKeyStatsSerializer,
+    APIKeyUpdateSerializer,
+    APIKeyValidationSerializer,
 )
 
 # Balance serializers
 from .balances import (
-    UserBalanceSerializer,
-    TransactionSerializer,
     BalanceUpdateSerializer,
-)
-
-# Subscription serializers
-from .subscriptions import (
-    SubscriptionSerializer,
-    SubscriptionCreateSerializer,
-    SubscriptionListSerializer,
-    SubscriptionUpdateSerializer,
-    SubscriptionUsageSerializer,
-    SubscriptionStatsSerializer,
-    EndpointGroupSerializer,
-    TariffSerializer,
+    TransactionSerializer,
+    UserBalanceSerializer,
 )
 
 # Currency serializers
 from .currencies import (
+    CurrencyConversionSerializer,
     CurrencySerializer,
     NetworkSerializer,
     ProviderCurrencySerializer,
-    CurrencyConversionSerializer,
+)
+from .payments import (
+    PaymentCreateSerializer,
+    PaymentListSerializer,
+    PaymentSerializer,
+    PaymentStatusSerializer,
 )
 
-# API Key serializers
-from .api_keys import (
-    APIKeyDetailSerializer,
-    APIKeyCreateSerializer,
-    APIKeyListSerializer,
-    APIKeyUpdateSerializer,
-    APIKeyActionSerializer,
-    APIKeyValidationSerializer,
-    APIKeyStatsSerializer,
+# Subscription serializers
+from .subscriptions import (
+    EndpointGroupSerializer,
+    SubscriptionCreateSerializer,
+    SubscriptionListSerializer,
+    SubscriptionSerializer,
+    SubscriptionStatsSerializer,
+    SubscriptionUpdateSerializer,
+    SubscriptionUsageSerializer,
+    TariffSerializer,
 )
 
 # Webhook serializers
 from .webhooks import (
-    WebhookSerializer,
     NowPaymentsWebhookSerializer,
+    WebhookSerializer,
 )
 
 __all__ = [
     # Payment serializers
     'PaymentSerializer',
-    'PaymentCreateSerializer', 
+    'PaymentCreateSerializer',
     'PaymentListSerializer',
     'PaymentStatusSerializer',
-    
+
     # Balance serializers
     'UserBalanceSerializer',
     'TransactionSerializer',
     'BalanceUpdateSerializer',
-    
+
     # Subscription serializers
     'SubscriptionSerializer',
     'SubscriptionCreateSerializer',
@@ -77,13 +76,13 @@ __all__ = [
     'SubscriptionStatsSerializer',
     'EndpointGroupSerializer',
     'TariffSerializer',
-    
+
     # Currency serializers
     'CurrencySerializer',
     'NetworkSerializer',
     'ProviderCurrencySerializer',
     'CurrencyConversionSerializer',
-    
+
     # API Key serializers
     'APIKeyDetailSerializer',
     'APIKeyCreateSerializer',
@@ -92,7 +91,7 @@ __all__ = [
     'APIKeyActionSerializer',
     'APIKeyValidationSerializer',
     'APIKeyStatsSerializer',
-    
+
     # Webhook serializers
     'WebhookSerializer',
     'NowPaymentsWebhookSerializer',

django_cfg/apps/payments/views/serializers/api_keys.py

@@ -4,14 +4,15 @@ API Key serializers for the Universal Payment System v2.0.
 DRF serializers for API key operations with service integration.
 """
 
-from rest_framework import serializers
-from typing import Dict, Any
+from typing import Any, Dict
+
 from django.contrib.auth import get_user_model
-from drf_spectacular.utils import extend_schema_serializer, extend_schema_field, OpenApiTypes
+from rest_framework import serializers
 
-from ...models import APIKey
 from django_cfg.modules.django_logging import get_logger
 
+from ...models import APIKey
+
 User = get_user_model()
 logger = get_logger("api_key_serializers")
 
@@ -22,11 +23,11 @@ class APIKeyListSerializer(serializers.ModelSerializer):
     
     Optimized for API key lists with minimal data (no key value).
     """
-    
+
     user = serializers.StringRelatedField(read_only=True)
     is_expired = serializers.BooleanField(read_only=True)
     is_valid = serializers.BooleanField(read_only=True)
-    
+
     class Meta:
         model = APIKey
         fields = [
@@ -83,7 +84,7 @@ class APIKeyCreateSerializer(serializers.Serializer):
     
     Creates new API keys and returns the full key value (only once).
     """
-    
+
     name = serializers.CharField(
         max_length=100,
         help_text="Descriptive name for the API key"
@@ -95,38 +96,38 @@ class APIKeyCreateSerializer(serializers.Serializer):
         max_value=365,
         help_text="Expiration in days (optional, null for no expiration)"
     )
-    
+
     def validate_name(self, value: str) -> str:
         """Validate API key name is unique for user."""
         user = self.context['request'].user
         user_id = self.context.get('user_pk', user.id)
-        
+
         if APIKey.objects.filter(user_id=user_id, name=value).exists():
             raise serializers.ValidationError(f"API key with name '{value}' already exists")
-        
+
         return value
-    
+
     def create(self, validated_data: Dict[str, Any]) -> APIKey:
         """Create API key using APIKey manager."""
         try:
             user = self.context['request'].user
             user_id = self.context.get('user_pk', user.id)
-            
+
             # Get user object if creating for different user (admin only)
             if str(user_id) != str(user.id):
                 if not user.is_staff:
                     raise serializers.ValidationError("Only staff can create API keys for other users")
                 user = User.objects.get(id=user_id)
-            
+
             # Create API key using manager
             api_key = APIKey.create_for_user(
                 user=user,
                 name=validated_data['name'],
                 expires_in_days=validated_data.get('expires_in_days')
             )
-            
+
             if api_key:
-                logger.info(f"API key created successfully", extra={
+                logger.info("API key created successfully", extra={
                     'api_key_id': str(api_key.id),
                     'user_id': user.id,
                     'name': validated_data['name']
@@ -134,21 +135,21 @@ class APIKeyCreateSerializer(serializers.Serializer):
                 return api_key
             else:
                 raise serializers.ValidationError("Failed to create API key")
-                
+
         except User.DoesNotExist:
             raise serializers.ValidationError(f"User {user_id} not found")
         except Exception as e:
             logger.error(f"API key creation error: {e}")
             raise serializers.ValidationError(f"API key creation failed: {e}")
-    
+
     def to_representation(self, instance: APIKey) -> Dict[str, Any]:
         """Return API key data with full key value (only on creation)."""
         data = APIKeyDetailSerializer(instance, context=self.context).data
-        
+
         # Add full key value only on creation (security: shown only once)
         data['key'] = instance.key
         data['warning'] = "This is the only time the full API key will be shown. Please save it securely."
-        
+
         return data
 
 
@@ -158,46 +159,46 @@ class APIKeyUpdateSerializer(serializers.ModelSerializer):
     
     Allows updating name and active status only.
     """
-    
+
     class Meta:
         model = APIKey
         fields = ['name', 'is_active']
-    
+
     def validate_name(self, value: str) -> str:
         """Validate API key name is unique for user."""
         user_id = self.instance.user_id
-        
+
         # Check if another API key with same name exists for this user
         existing = APIKey.objects.filter(
             user_id=user_id,
             name=value
         ).exclude(id=self.instance.id)
-        
+
         if existing.exists():
             raise serializers.ValidationError(f"API key with name '{value}' already exists")
-        
+
         return value
-    
+
     def update(self, instance: APIKey, validated_data: Dict[str, Any]) -> APIKey:
         """Update API key with logging."""
         old_name = instance.name
         old_active = instance.is_active
-        
+
         instance = super().update(instance, validated_data)
-        
+
         # Log changes
         changes = []
         if instance.name != old_name:
             changes.append(f"name: {old_name} → {instance.name}")
         if instance.is_active != old_active:
             changes.append(f"active: {old_active} → {instance.is_active}")
-        
+
         if changes:
             logger.info(f"API key updated: {', '.join(changes)}", extra={
                 'api_key_id': str(instance.id),
                 'user_id': instance.user_id
             })
-        
+
         return instance
 
 
@@ -207,7 +208,7 @@ class APIKeyActionSerializer(serializers.Serializer):
     
     Handles deactivation, extension, and usage increment.
     """
-    
+
     action = serializers.ChoiceField(
         choices=[
             ('deactivate', 'Deactivate'),
@@ -233,48 +234,48 @@ class APIKeyActionSerializer(serializers.Serializer):
         allow_null=True,
         help_text="IP address for usage tracking"
     )
-    
+
     def validate(self, attrs: Dict[str, Any]) -> Dict[str, Any]:
         """Validate action-specific requirements."""
         action = attrs.get('action')
-        
+
         if action == 'extend' and not attrs.get('days'):
             raise serializers.ValidationError("days is required for extend action")
-        
+
         return attrs
-    
+
     def save(self) -> Dict[str, Any]:
         """Perform API key action."""
         try:
             api_key_id = self.context.get('api_key_id')
             if not api_key_id:
                 raise serializers.ValidationError("API key ID is required")
-            
+
             api_key = APIKey.objects.get(id=api_key_id)
             action = self.validated_data['action']
-            
+
             if action == 'deactivate':
                 reason = self.validated_data.get('reason')
                 success = api_key.deactivate(reason=reason)
-                message = f"API key deactivated successfully"
-                
+                message = "API key deactivated successfully"
+
             elif action == 'extend':
                 days = self.validated_data['days']
                 success = api_key.extend_expiry(days=days)
                 message = f"API key expiration extended by {days} days"
-                
+
             elif action == 'increment_usage':
                 ip_address = self.validated_data.get('ip_address')
                 success = api_key.increment_usage(ip_address=ip_address)
-                message = f"API key usage incremented"
-                
+                message = "API key usage incremented"
+
             else:
                 raise serializers.ValidationError(f"Unknown action: {action}")
-            
+
             if success:
                 # Refresh from database
                 api_key.refresh_from_db()
-                
+
                 return {
                     'success': True,
                     'message': message,
@@ -286,7 +287,7 @@ class APIKeyActionSerializer(serializers.Serializer):
                     'error': f"Failed to {action} API key",
                     'error_code': f'{action}_failed'
                 }
-                
+
         except APIKey.DoesNotExist:
             return {
                 'success': False,
@@ -308,25 +309,25 @@ class APIKeyValidationSerializer(serializers.Serializer):
     
     Validates API key and returns key information.
     """
-    
+
     key = serializers.CharField(
         min_length=32,
         max_length=64,
         help_text="API key to validate"
     )
-    
+
     def validate_key(self, value: str) -> str:
         """Validate API key format."""
         if not value.startswith('pk_'):
             raise serializers.ValidationError("Invalid API key format")
         return value
-    
+
     def save(self) -> Dict[str, Any]:
         """Validate API key and return information."""
         try:
             key_value = self.validated_data['key']
             api_key = APIKey.get_valid_key(key_value)
-            
+
             if api_key:
                 return {
                     'success': True,
@@ -341,7 +342,7 @@ class APIKeyValidationSerializer(serializers.Serializer):
                     'api_key': None,
                     'message': 'API key is invalid or expired'
                 }
-                
+
         except Exception as e:
             logger.error(f"API key validation error: {e}")
             return {
@@ -371,31 +372,32 @@ class APIKeyStatsSerializer(serializers.Serializer):
     
     Used for API key analytics and reporting.
     """
-    
+
     days = serializers.IntegerField(
         default=30,
         min_value=1,
         max_value=365,
         help_text="Number of days to analyze"
     )
-    
+
     def save(self) -> Dict[str, Any]:
         """Get API key statistics."""
         try:
+            from datetime import timedelta
+
             from django.db import models
             from django.utils import timezone
-            from datetime import timedelta
-            
+
             days = self.validated_data['days']
             since_date = timezone.now() - timedelta(days=days)
-            
+
             # Get user-specific stats if user context provided
             user_id = self.context.get('user_pk')
             if user_id:
                 queryset = APIKey.objects.filter(user_id=user_id)
             else:
                 queryset = APIKey.objects.all()
-            
+
             stats = queryset.aggregate(
                 total_keys=models.Count('id'),
                 active_keys=models.Count('id', filter=models.Q(is_active=True)),
@@ -406,7 +408,7 @@ class APIKeyStatsSerializer(serializers.Serializer):
                     filter=models.Q(last_used_at__gte=since_date)
                 ),
             )
-            
+
             return {
                 'success': True,
                 'stats': {
@@ -418,7 +420,7 @@ class APIKeyStatsSerializer(serializers.Serializer):
                 'period_days': days,
                 'generated_at': timezone.now().isoformat()
             }
-            
+
         except Exception as e:
             logger.error(f"API key stats error: {e}")
             return {

django_cfg/apps/payments/views/serializers/balances.py

@@ -4,15 +4,16 @@ Balance serializers for the Universal Payment System v2.0.
 DRF serializers for balance and transaction operations with service integration.
 """
 
-from rest_framework import serializers
-from decimal import Decimal
-from typing import Dict, Any
+from typing import Any, Dict
+
 from django.contrib.auth import get_user_model
+from rest_framework import serializers
 
-from ...models import UserBalance, Transaction
-from ...services import get_balance_service, BalanceUpdateRequest
 from django_cfg.modules.django_logging import get_logger
 
+from ...models import Transaction, UserBalance
+from ...services import BalanceUpdateRequest, get_balance_service
+
 User = get_user_model()
 logger = get_logger("balance_serializers")
 
@@ -23,9 +24,9 @@ class UserBalanceSerializer(serializers.ModelSerializer):
     
     Provides balance information with display helpers.
     """
-    
+
     user = serializers.StringRelatedField(read_only=True)
-    
+
     class Meta:
         model = UserBalance
         fields = [
@@ -46,13 +47,13 @@ class TransactionSerializer(serializers.ModelSerializer):
     
     Used for transaction history and details.
     """
-    
+
     user = serializers.StringRelatedField(read_only=True)
     amount_display = serializers.CharField(read_only=True)
     type_color = serializers.CharField(read_only=True)
     is_credit = serializers.BooleanField(read_only=True)
     is_debit = serializers.BooleanField(read_only=True)
-    
+
     class Meta:
         model = Transaction
         fields = [
@@ -78,7 +79,7 @@ class BalanceUpdateSerializer(serializers.Serializer):
     
     Validates and processes balance updates through BalanceService.
     """
-    
+
     amount = serializers.FloatField(
         help_text="Amount to add (positive) or subtract (negative)"
     )
@@ -110,46 +111,46 @@ class BalanceUpdateSerializer(serializers.Serializer):
         default=dict,
         help_text="Additional metadata"
     )
-    
+
     def validate_amount(self, value: float) -> float:
         """Validate amount is not zero."""
         if value == 0:
             raise serializers.ValidationError("Amount cannot be zero")
         return value
-    
+
     def validate(self, attrs: Dict[str, Any]) -> Dict[str, Any]:
         """Validate balance update data."""
         try:
             # Get user from context
             user_id = self.context.get('user_pk') or self.context['request'].user.id
-            
+
             # Create Pydantic request for validation
             request = BalanceUpdateRequest(
                 user_id=user_id,
                 **attrs
             )
-            
+
             # Store validated request for save method
             self._validated_request = request
             return attrs
-            
+
         except Exception as e:
             logger.error(f"Balance update validation failed: {e}")
             raise serializers.ValidationError(f"Invalid balance update data: {e}")
-    
+
     def save(self) -> Dict[str, Any]:
         """Update balance using BalanceService."""
         try:
             balance_service = get_balance_service()
             result = balance_service.update_balance(self._validated_request)
-            
+
             if result.success:
-                logger.info(f"Balance updated successfully", extra={
+                logger.info("Balance updated successfully", extra={
                     'user_id': self._validated_request.user_id,
                     'amount': self._validated_request.amount,
                     'transaction_id': result.transaction_id
                 })
-                
+
                 return {
                     'success': True,
                     'message': result.message,
@@ -167,7 +168,7 @@ class BalanceUpdateSerializer(serializers.Serializer):
                     'error': result.message,
                     'error_code': result.error_code
                 }
-                
+
         except Exception as e:
             logger.error(f"Balance update error: {e}")
             return {
@@ -183,7 +184,7 @@ class FundsTransferSerializer(serializers.Serializer):
     
     Handles user-to-user fund transfers through BalanceService.
     """
-    
+
     to_user_id = serializers.IntegerField(
         min_value=1,
         help_text="Destination user ID"
@@ -198,23 +199,23 @@ class FundsTransferSerializer(serializers.Serializer):
         max_length=500,
         help_text="Transfer description"
     )
-    
+
     def validate_to_user_id(self, value: int) -> int:
         """Validate destination user exists."""
         if not User.objects.filter(id=value).exists():
             raise serializers.ValidationError(f"User {value} not found")
         return value
-    
+
     def validate(self, attrs: Dict[str, Any]) -> Dict[str, Any]:
         """Validate transfer data."""
         from_user_id = self.context['request'].user.id
         to_user_id = attrs['to_user_id']
-        
+
         if from_user_id == to_user_id:
             raise serializers.ValidationError("Cannot transfer to yourself")
-        
+
         return attrs
-    
+
     def save(self) -> Dict[str, Any]:
         """Execute transfer using BalanceService."""
         try:
@@ -222,7 +223,7 @@ class FundsTransferSerializer(serializers.Serializer):
             to_user_id = self.validated_data['to_user_id']
             amount = self.validated_data['amount']
             description = self.validated_data.get('description')
-            
+
             balance_service = get_balance_service()
             result = balance_service.transfer_funds(
                 from_user_id=from_user_id,
@@ -230,7 +231,7 @@ class FundsTransferSerializer(serializers.Serializer):
                 amount=amount,
                 description=description
             )
-            
+
             if result.success:
                 return {
                     'success': True,
@@ -243,7 +244,7 @@ class FundsTransferSerializer(serializers.Serializer):
                     'error': result.message,
                     'error_code': result.error_code
                 }
-                
+
         except Exception as e:
             logger.error(f"Funds transfer error: {e}")
             return {
@@ -259,14 +260,14 @@ class BalanceStatsSerializer(serializers.Serializer):
     
     Used for balance analytics and reporting.
     """
-    
+
     days = serializers.IntegerField(
         default=30,
         min_value=1,
         max_value=365,
         help_text="Number of days to analyze"
     )
-    
+
     def save(self) -> Dict[str, Any]:
         """Get balance statistics using BalanceService."""
         try:
@@ -274,7 +275,7 @@ class BalanceStatsSerializer(serializers.Serializer):
             result = balance_service.get_balance_stats(
                 days=self.validated_data['days']
             )
-            
+
             if result.success:
                 return {
                     'success': True,
@@ -287,7 +288,7 @@ class BalanceStatsSerializer(serializers.Serializer):
                     'error': result.message,
                     'error_code': result.error_code
                 }
-                
+
         except Exception as e:
             logger.error(f"Balance stats error: {e}")
             return {