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

django_cfg/apps/payments/services/types/responses.py

@@ -4,10 +4,11 @@ Response types for the Universal Payment System v2.0.
 Pydantic models for service layer responses and results.
 """
 
-from decimal import Decimal
-from typing import Optional, Dict, Any, List, Literal
-from pydantic import BaseModel, Field, ConfigDict
 from datetime import datetime
+from decimal import Decimal
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, ConfigDict, Field
 
 
 class ServiceOperationResult(BaseModel):
@@ -17,7 +18,7 @@ class ServiceOperationResult(BaseModel):
     Provides consistent success/error handling across services.
     """
     model_config = ConfigDict(validate_assignment=True)
-    
+
     success: bool = Field(description="Operation success status")
     message: Optional[str] = Field(None, description="Human-readable message")
     error_code: Optional[str] = Field(None, description="Machine-readable error code")
@@ -27,7 +28,7 @@ class ServiceOperationResult(BaseModel):
 
 class PaymentResult(ServiceOperationResult):
     """Result of payment operations."""
-    
+
     payment_id: Optional[str] = Field(None, description="Payment ID")
     status: Optional[str] = Field(None, description="Payment status")
     amount_usd: Optional[float] = Field(None, description="Payment amount in USD")
@@ -43,7 +44,7 @@ class PaymentResult(ServiceOperationResult):
 class ProviderResponse(BaseModel):
     """Response from payment provider."""
     model_config = ConfigDict(validate_assignment=True)
-    
+
     provider: str = Field(description="Provider name")
     success: bool = Field(description="Provider operation success")
     provider_payment_id: Optional[str] = Field(None, description="Provider payment ID")
@@ -60,7 +61,7 @@ class ProviderResponse(BaseModel):
 
 class BalanceResult(ServiceOperationResult):
     """Result of balance operations."""
-    
+
     user_id: Optional[int] = Field(None, description="User ID")
     balance_usd: Optional[float] = Field(None, description="Current balance in USD")
     transaction_id: Optional[str] = Field(None, description="Transaction ID")
@@ -70,7 +71,7 @@ class BalanceResult(ServiceOperationResult):
 
 class SubscriptionResult(ServiceOperationResult):
     """Result of subscription operations."""
-    
+
     subscription_id: Optional[str] = Field(None, description="Subscription ID")
     user_id: Optional[int] = Field(None, description="User ID")
     tier: Optional[str] = Field(None, description="Subscription tier")
@@ -81,7 +82,7 @@ class SubscriptionResult(ServiceOperationResult):
 
 class CurrencyConversionResult(ServiceOperationResult):
     """Result of currency conversion."""
-    
+
     amount: Optional[float] = Field(None, description="Original amount")
     from_currency: Optional[str] = Field(None, description="Source currency")
     to_currency: Optional[str] = Field(None, description="Target currency")
@@ -92,7 +93,7 @@ class CurrencyConversionResult(ServiceOperationResult):
 
 class APIKeyResult(ServiceOperationResult):
     """Result of API key operations."""
-    
+
     api_key_id: Optional[str] = Field(None, description="API key ID")
     key_value: Optional[str] = Field(None, description="API key value (only on creation)")
     name: Optional[str] = Field(None, description="API key name")
@@ -103,7 +104,7 @@ class APIKeyResult(ServiceOperationResult):
 
 class WebhookProcessingResult(ServiceOperationResult):
     """Result of webhook processing."""
-    
+
     webhook_id: Optional[str] = Field(None, description="Webhook ID")
     provider: Optional[str] = Field(None, description="Provider name")
     payment_id: Optional[str] = Field(None, description="Related payment ID")
@@ -113,7 +114,7 @@ class WebhookProcessingResult(ServiceOperationResult):
 
 class ProviderHealthResult(ServiceOperationResult):
     """Result of provider health check."""
-    
+
     provider: str = Field(description="Provider name")
     is_healthy: bool = Field(description="Provider health status")
     response_time_ms: Optional[int] = Field(None, description="Response time in milliseconds")
@@ -126,7 +127,7 @@ class ProviderHealthResult(ServiceOperationResult):
 class ServiceStats(BaseModel):
     """Service statistics."""
     model_config = ConfigDict(validate_assignment=True)
-    
+
     service_name: str = Field(description="Service name")
     total_operations: int = Field(default=0, description="Total operations")
     successful_operations: int = Field(default=0, description="Successful operations")
@@ -139,7 +140,7 @@ class ServiceStats(BaseModel):
 
 class BatchOperationResult(ServiceOperationResult):
     """Result of batch operations."""
-    
+
     total_items: int = Field(description="Total items processed")
     successful_items: int = Field(description="Successfully processed items")
     failed_items: int = Field(description="Failed items")
@@ -149,7 +150,7 @@ class BatchOperationResult(ServiceOperationResult):
 
 class CacheOperationResult(ServiceOperationResult):
     """Result of cache operations."""
-    
+
     cache_key: Optional[str] = Field(None, description="Cache key")
     cache_hit: Optional[bool] = Field(None, description="Whether cache was hit")
     ttl_seconds: Optional[int] = Field(None, description="TTL in seconds")

django_cfg/apps/payments/services/types/webhooks.py

@@ -4,16 +4,17 @@ Webhook types for the Universal Payment System v2.0.
 Pydantic models for webhook validation and processing.
 """
 
-from decimal import Decimal
-from typing import Optional, Dict, Any, Literal
-from pydantic import BaseModel, Field, ConfigDict, field_validator
 from datetime import datetime, timedelta
+from decimal import Decimal
+from typing import Any, Dict, Literal, Optional
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
 
 
 class WebhookData(BaseModel):
     """Base webhook data structure."""
     model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
+
     provider: str = Field(description="Provider name")
     payment_id: str = Field(description="Payment ID")
     status: str = Field(description="Payment status")
@@ -29,11 +30,11 @@ class NowPaymentsWebhook(BaseModel):
     Based on NowPayments IPN (Instant Payment Notification) format.
     """
     model_config = ConfigDict(validate_assignment=True, extra="allow")
-    
+
     # Required fields from NowPayments
     payment_id: str = Field(description="NowPayments payment ID")
     payment_status: Literal[
-        'waiting', 'confirming', 'confirmed', 'sending', 'partially_paid', 
+        'waiting', 'confirming', 'confirmed', 'sending', 'partially_paid',
         'finished', 'failed', 'refunded', 'expired'
     ] = Field(description="Payment status")
     pay_address: str = Field(description="Payment address")
@@ -43,25 +44,25 @@ class NowPaymentsWebhook(BaseModel):
     pay_currency: str = Field(description="Cryptocurrency code")
     order_id: Optional[str] = Field(None, description="Order ID")
     order_description: Optional[str] = Field(None, description="Order description")
-    
+
     # Optional fields
     actually_paid: Optional[Decimal] = Field(None, description="Actually paid amount")
     outcome_amount: Optional[Decimal] = Field(None, description="Outcome amount")
     outcome_currency: Optional[str] = Field(None, description="Outcome currency")
-    
+
     # Network information
     network: Optional[str] = Field(None, description="Blockchain network")
     txn_id: Optional[str] = Field(None, description="Transaction ID")
-    
+
     # Timestamps
     created_at: Optional[datetime] = Field(None, description="Creation timestamp")
     updated_at: Optional[datetime] = Field(None, description="Update timestamp")
-    
+
     # Additional data
     purchase_id: Optional[str] = Field(None, description="Purchase ID")
     smart_contract: Optional[str] = Field(None, description="Smart contract address")
     burning_percent: Optional[str] = Field(None, description="Burning percentage")
-    
+
     @field_validator('payment_status')
     @classmethod
     def validate_status(cls, v: str) -> str:
@@ -73,7 +74,7 @@ class NowPaymentsWebhook(BaseModel):
         if v not in valid_statuses:
             raise ValueError(f"Invalid payment status: {v}")
         return v
-    
+
     @field_validator('price_currency')
     @classmethod
     def validate_price_currency(cls, v: str) -> str:
@@ -81,7 +82,7 @@ class NowPaymentsWebhook(BaseModel):
         if v.upper() != 'USD':
             raise ValueError("Price currency must be USD")
         return v.upper()
-    
+
     def to_universal_status(self) -> str:
         """Convert NowPayments status to universal payment status."""
         status_mapping = {
@@ -96,12 +97,12 @@ class NowPaymentsWebhook(BaseModel):
             'expired': 'expired'
         }
         return status_mapping.get(self.payment_status, 'unknown')
-    
+
     def is_final_status(self) -> bool:
         """Check if payment status is final."""
         final_statuses = ['finished', 'failed', 'refunded', 'expired']
         return self.payment_status in final_statuses
-    
+
     def is_successful(self) -> bool:
         """Check if payment is successful."""
         return self.payment_status == 'finished'
@@ -110,7 +111,7 @@ class NowPaymentsWebhook(BaseModel):
 class WebhookProcessingResult(BaseModel):
     """Result of webhook processing."""
     model_config = ConfigDict(validate_assignment=True)
-    
+
     success: bool = Field(description="Processing success")
     webhook_id: Optional[str] = Field(None, description="Webhook ID")
     payment_id: Optional[str] = Field(None, description="Related payment ID")
@@ -129,7 +130,7 @@ class WebhookProcessingResult(BaseModel):
 class WebhookValidationResult(BaseModel):
     """Result of webhook validation."""
     model_config = ConfigDict(validate_assignment=True)
-    
+
     is_valid: bool = Field(description="Validation result")
     provider: str = Field(description="Provider name")
     signature_valid: Optional[bool] = Field(None, description="Signature validation result")
@@ -141,18 +142,18 @@ class WebhookValidationResult(BaseModel):
 class WebhookSignature(BaseModel):
     """Webhook signature validation data."""
     model_config = ConfigDict(validate_assignment=True)
-    
+
     provider: str = Field(description="Provider name")
     signature: str = Field(description="Webhook signature")
     payload: str = Field(description="Raw payload string")
     secret_key: str = Field(description="Secret key for validation")
     algorithm: str = Field(default="sha512", description="Signature algorithm")
-    
+
     def validate_signature(self) -> bool:
         """Validate webhook signature."""
-        import hmac
         import hashlib
-        
+        import hmac
+
         if self.algorithm == "sha512":
             expected = hmac.new(
                 self.secret_key.encode('utf-8'),
@@ -167,41 +168,40 @@ class WebhookSignature(BaseModel):
             ).hexdigest()
         else:
             raise ValueError(f"Unsupported algorithm: {self.algorithm}")
-        
+
         return hmac.compare_digest(expected, self.signature)
 
 
 class WebhookRetry(BaseModel):
     """Webhook retry configuration."""
     model_config = ConfigDict(validate_assignment=True)
-    
+
     webhook_id: str = Field(description="Webhook ID")
     attempt_number: int = Field(description="Retry attempt number")
     max_attempts: int = Field(default=3, description="Maximum retry attempts")
     delay_seconds: int = Field(default=60, description="Delay between retries")
     last_error: Optional[str] = Field(None, description="Last error message")
     next_retry_at: Optional[datetime] = Field(None, description="Next retry timestamp")
-    
+
     def should_retry(self) -> bool:
         """Check if webhook should be retried."""
         return self.attempt_number < self.max_attempts
-    
+
     def calculate_next_retry(self) -> datetime:
         """Calculate next retry timestamp with exponential backoff."""
-        import math
-        
+
         # Exponential backoff: delay * (2 ^ attempt_number)
         delay = self.delay_seconds * (2 ** self.attempt_number)
         # Cap at 1 hour
         delay = min(delay, 3600)
-        
+
         return datetime.utcnow() + timedelta(seconds=delay)
 
 
 class WebhookEvent(BaseModel):
     """Webhook event for logging and monitoring."""
     model_config = ConfigDict(validate_assignment=True)
-    
+
     event_id: str = Field(description="Event ID")
     webhook_id: str = Field(description="Webhook ID")
     provider: str = Field(description="Provider name")
@@ -215,7 +215,7 @@ class WebhookEvent(BaseModel):
     timestamp: datetime = Field(default_factory=datetime.utcnow, description="Event timestamp")
     ip_address: Optional[str] = Field(None, description="Source IP address")
     user_agent: Optional[str] = Field(None, description="User agent")
-    
+
     def to_log_entry(self) -> Dict[str, Any]:
         """Convert to structured log entry."""
         return {

django_cfg/apps/payments/signals/__init__.py

@@ -10,6 +10,7 @@ All business logic is in managers to avoid duplication.
 """
 
 from django.apps import apps
+
 from django_cfg.modules.django_logging import get_logger
 
 logger = get_logger("payment_signals")
@@ -23,13 +24,10 @@ def register_signals():
     """
     try:
         # Import signal modules to register them
-        from . import payment_signals
-        from . import balance_signals
-        from . import subscription_signals
-        from . import api_key_signals
-        
+        from . import api_key_signals, balance_signals, payment_signals, subscription_signals
+
         logger.info("Payment signals registered successfully")
-        
+
     except ImportError as e:
         logger.error(f"Failed to register payment signals: {e}")
 

django_cfg/apps/payments/signals/api_key_signals.py

@@ -5,14 +5,15 @@ Minimal signals focused on cache invalidation and security notifications.
 Business logic stays in APIKeyManager.
 """
 
-from django.db.models.signals import post_save, post_delete, pre_save
-from django.dispatch import receiver
 from django.core.cache import cache
+from django.db.models.signals import post_delete, post_save, pre_save
+from django.dispatch import receiver
 from django.utils import timezone
 
-from ..models import APIKey
 from django_cfg.modules.django_logging import get_logger
 
+from ..models import APIKey
+
 logger = get_logger("api_key_signals")
 
 
@@ -40,13 +41,13 @@ def handle_api_key_changes(sender, instance: APIKey, created: bool, **kwargs):
     Business logic (usage tracking, validation) stays in managers.
     """
     if created:
-        logger.info(f"New API key created", extra={
+        logger.info("New API key created", extra={
             'api_key_id': str(instance.id),
             'user_id': instance.user.id,
             'key_name': instance.name,
             'expires_at': instance.expires_at.isoformat() if instance.expires_at else None
         })
-        
+
         # Set creation notification in cache
         cache.set(
             f"api_key_created:{instance.user.id}:{instance.id}",
@@ -57,39 +58,39 @@ def handle_api_key_changes(sender, instance: APIKey, created: bool, **kwargs):
             },
             timeout=86400  # 24 hours
         )
-        
+
     else:
         # Check for status changes
         if hasattr(instance, '_original_is_active'):
             old_active = instance._original_is_active
             new_active = instance.is_active
-            
+
             if old_active != new_active:
                 if new_active:
                     _handle_api_key_activated(instance)
                 else:
                     _handle_api_key_deactivated(instance)
-        
+
         # Check for usage increases (security monitoring)
         if hasattr(instance, '_original_total_requests'):
             old_requests = instance._original_total_requests or 0
             new_requests = instance.total_requests
-            
+
             if new_requests > old_requests:
                 request_increase = new_requests - old_requests
-                
+
                 # Log high usage increases (potential security concern)
                 if request_increase > 100:  # More than 100 requests at once
-                    logger.warning(f"High API key usage increase", extra={
+                    logger.warning("High API key usage increase", extra={
                         'api_key_id': str(instance.id),
                         'user_id': instance.user.id,
                         'old_requests': old_requests,
                         'new_requests': new_requests,
                         'increase': request_increase
                     })
-                    
+
                     _handle_high_usage_alert(instance, request_increase)
-    
+
     # Clear API key-related caches
     _clear_api_key_caches(instance)
 
@@ -97,14 +98,14 @@ def handle_api_key_changes(sender, instance: APIKey, created: bool, **kwargs):
 @receiver(post_delete, sender=APIKey)
 def handle_api_key_deletion(sender, instance: APIKey, **kwargs):
     """Handle API key deletion."""
-    logger.warning(f"API key deleted", extra={
+    logger.warning("API key deleted", extra={
         'api_key_id': str(instance.id),
         'user_id': instance.user.id,
         'key_name': instance.name,
         'total_requests': instance.total_requests,
         'deletion_timestamp': timezone.now().isoformat()
     })
-    
+
     # Set deletion notification in cache
     cache.set(
         f"api_key_deleted:{instance.user.id}:{instance.id}",
@@ -116,7 +117,7 @@ def handle_api_key_deletion(sender, instance: APIKey, **kwargs):
         },
         timeout=86400 * 30  # 30 days for audit
     )
-    
+
     # Clear caches
     _clear_api_key_caches(instance)
 
@@ -126,12 +127,12 @@ def handle_api_key_deletion(sender, instance: APIKey, **kwargs):
 def _handle_api_key_activated(api_key: APIKey):
     """Handle API key activation (notification only)."""
     try:
-        logger.info(f"API key activated", extra={
+        logger.info("API key activated", extra={
             'api_key_id': str(api_key.id),
             'user_id': api_key.user.id,
             'key_name': api_key.name
         })
-        
+
         # Set activation notification in cache
         cache.set(
             f"api_key_activated:{api_key.user.id}:{api_key.id}",
@@ -142,7 +143,7 @@ def _handle_api_key_activated(api_key: APIKey):
             },
             timeout=86400  # 24 hours
         )
-        
+
     except Exception as e:
         logger.error(f"Failed to handle API key activation: {e}")
 
@@ -150,13 +151,13 @@ def _handle_api_key_activated(api_key: APIKey):
 def _handle_api_key_deactivated(api_key: APIKey):
     """Handle API key deactivation (security notification)."""
     try:
-        logger.warning(f"API key deactivated", extra={
+        logger.warning("API key deactivated", extra={
             'api_key_id': str(api_key.id),
             'user_id': api_key.user.id,
             'key_name': api_key.name,
             'total_requests': api_key.total_requests
         })
-        
+
         # Set deactivation notification in cache
         cache.set(
             f"api_key_deactivated:{api_key.user.id}:{api_key.id}",
@@ -168,7 +169,7 @@ def _handle_api_key_deactivated(api_key: APIKey):
             },
             timeout=86400 * 7  # 7 days
         )
-        
+
     except Exception as e:
         logger.error(f"Failed to handle API key deactivation: {e}")
 
@@ -176,13 +177,13 @@ def _handle_api_key_deactivated(api_key: APIKey):
 def _handle_high_usage_alert(api_key: APIKey, request_increase: int):
     """Handle high usage alert (security monitoring)."""
     try:
-        logger.warning(f"High API key usage detected", extra={
+        logger.warning("High API key usage detected", extra={
             'api_key_id': str(api_key.id),
             'user_id': api_key.user.id,
             'request_increase': request_increase,
             'total_requests': api_key.total_requests
         })
-        
+
         # Set high usage alert in cache
         cache.set(
             f"high_usage_alert:{api_key.user.id}:{api_key.id}",
@@ -194,15 +195,15 @@ def _handle_high_usage_alert(api_key: APIKey, request_increase: int):
             },
             timeout=86400  # 24 hours
         )
-        
+
         # Check if we should temporarily disable the key (security measure)
         if request_increase > 1000:  # More than 1000 requests at once
-            logger.critical(f"Extremely high API usage - potential abuse", extra={
+            logger.critical("Extremely high API usage - potential abuse", extra={
                 'api_key_id': str(api_key.id),
                 'user_id': api_key.user.id,
                 'request_increase': request_increase
             })
-            
+
             # Set critical alert flag
             cache.set(
                 f"critical_usage_alert:{api_key.user.id}:{api_key.id}",
@@ -214,7 +215,7 @@ def _handle_high_usage_alert(api_key: APIKey, request_increase: int):
                 },
                 timeout=86400 * 7  # 7 days
             )
-        
+
     except Exception as e:
         logger.error(f"Failed to handle high usage alert: {e}")
 
@@ -228,14 +229,14 @@ def _clear_api_key_caches(api_key: APIKey):
             f"api_key_stats:{api_key.user.id}",
             f"api_key_usage:{api_key.id}",
         ]
-        
+
         cache.delete_many(cache_keys)
-        
-        logger.debug(f"Cleared API key caches", extra={
+
+        logger.debug("Cleared API key caches", extra={
             'api_key_id': str(api_key.id),
             'user_id': api_key.user.id,
             'cache_keys_cleared': len(cache_keys)
         })
-        
+
     except Exception as e:
         logger.warning(f"Failed to clear API key caches: {e}")