django-cfg 1.2.29__py3-none-any.whl → 1.3.1__py3-none-any.whl

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

@@ -0,0 +1,177 @@
+"""
+Data types for the Universal Payment System v2.0.
+
+Pydantic models for internal data representation and transfer.
+"""
+
+from decimal import Decimal
+from typing import Optional, Dict, Any, List, Literal
+from pydantic import BaseModel, Field, ConfigDict
+from datetime import datetime
+
+
+class PaymentData(BaseModel):
+    """Internal payment data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    id: str = Field(description="Payment ID")
+    user_id: int = Field(description="User ID")
+    amount_usd: float = Field(description="Amount in USD")
+    crypto_amount: Optional[Decimal] = Field(None, description="Cryptocurrency amount")
+    currency_code: str = Field(description="Cryptocurrency code")
+    provider: str = Field(description="Payment provider")
+    status: str = Field(description="Payment status")
+    provider_payment_id: Optional[str] = Field(None, description="Provider payment ID")
+    payment_url: Optional[str] = Field(None, description="Payment URL")
+    qr_code_url: Optional[str] = Field(None, description="QR code URL")
+    wallet_address: Optional[str] = Field(None, description="Wallet address")
+    callback_url: Optional[str] = Field(None, description="Success callback URL")
+    cancel_url: Optional[str] = Field(None, description="Cancel URL")
+    description: Optional[str] = Field(None, description="Payment description")
+    metadata: Dict[str, Any] = Field(default_factory=dict, description="Additional metadata")
+    created_at: datetime = Field(description="Creation timestamp")
+    updated_at: datetime = Field(description="Last update timestamp")
+    expires_at: Optional[datetime] = Field(None, description="Payment expiration")
+    completed_at: Optional[datetime] = Field(None, description="Completion timestamp")
+
+
+class BalanceData(BaseModel):
+    """Internal balance data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    user_id: int = Field(description="User ID")
+    balance_usd: float = Field(description="Balance in USD")
+    created_at: datetime = Field(description="Creation timestamp")
+    updated_at: datetime = Field(description="Last update timestamp")
+
+
+class TransactionData(BaseModel):
+    """Internal transaction data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    id: str = Field(description="Transaction ID")
+    user_id: int = Field(description="User ID")
+    amount: float = Field(description="Transaction amount")
+    transaction_type: str = Field(description="Transaction type")
+    description: Optional[str] = Field(None, description="Transaction description")
+    payment_id: Optional[str] = Field(None, description="Related payment ID")
+    metadata: Dict[str, Any] = Field(default_factory=dict, description="Additional metadata")
+    created_at: datetime = Field(description="Creation timestamp")
+
+
+class SubscriptionData(BaseModel):
+    """Internal subscription data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    id: str = Field(description="Subscription ID")
+    user_id: int = Field(description="User ID")
+    tier: str = Field(description="Subscription tier")
+    status: str = Field(description="Subscription status")
+    requests_per_hour: int = Field(description="Requests per hour limit")
+    requests_per_day: int = Field(description="Requests per day limit")
+    total_requests: int = Field(default=0, description="Total requests made")
+    monthly_cost_usd: float = Field(description="Monthly cost in USD")
+    auto_renew: bool = Field(default=False, description="Auto-renewal enabled")
+    created_at: datetime = Field(description="Creation timestamp")
+    updated_at: datetime = Field(description="Last update timestamp")
+    expires_at: Optional[datetime] = Field(None, description="Subscription expiration")
+    last_request_at: Optional[datetime] = Field(None, description="Last request timestamp")
+    endpoint_groups: List[str] = Field(default_factory=list, description="Allowed endpoint groups")
+
+
+class CurrencyData(BaseModel):
+    """Internal currency data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    code: str = Field(description="Currency code")
+    name: str = Field(description="Currency name")
+    currency_type: str = Field(description="Currency type (fiat/crypto)")
+    symbol: Optional[str] = Field(None, description="Currency symbol")
+    decimal_places: int = Field(default=8, description="Decimal places")
+    is_enabled: bool = Field(default=True, description="Currency enabled status")
+    min_amount: Optional[Decimal] = Field(None, description="Minimum amount")
+    max_amount: Optional[Decimal] = Field(None, description="Maximum amount")
+    network_fee: Optional[Decimal] = Field(None, description="Network fee")
+    created_at: datetime = Field(description="Creation timestamp")
+    updated_at: datetime = Field(description="Last update timestamp")
+
+
+class ProviderData(BaseModel):
+    """Internal provider data representation."""
+    model_config = ConfigDict(validate_assignment=True)
+    
+    name: str = Field(description="Provider name")
+    display_name: str = Field(description="Provider display name")
+    is_enabled: bool = Field(default=True, description="Provider enabled status")
+    api_url: str = Field(description="Provider API URL")
+    supported_currencies: List[str] = Field(default_factory=list, description="Supported currencies")
+    min_amount_usd: float = Field(default=1.0, description="Minimum amount in USD")
+    max_amount_usd: float = Field(default=50000.0, description="Maximum amount in USD")
+    fee_percentage: float = Field(default=0.0, description="Provider fee percentage")
+    confirmation_blocks: Dict[str, int] = Field(default_factory=dict, description="Confirmation blocks per currency")
+    webhook_url: Optional[str] = Field(None, description="Webhook URL")
+    is_healthy: bool = Field(default=True, description="Provider health status")
+    last_health_check: Optional[datetime] = Field(None, description="Last health check")
+    response_time_ms: Optional[int] = Field(None, description="Average response time")
+
+
+class APIKeyData(BaseModel):
+    """Internal API key data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    id: str = Field(description="API key ID")
+    user_id: int = Field(description="User ID")
+    name: str = Field(description="API key name")
+    key_prefix: str = Field(description="Key prefix for display")
+    is_active: bool = Field(default=True, description="API key active status")
+    total_requests: int = Field(default=0, description="Total requests made")
+    allowed_ips: Optional[str] = Field(None, description="Allowed IP addresses")
+    created_at: datetime = Field(description="Creation timestamp")
+    updated_at: datetime = Field(description="Last update timestamp")
+    expires_at: Optional[datetime] = Field(None, description="Expiration timestamp")
+    last_used_at: Optional[datetime] = Field(None, description="Last used timestamp")
+
+
+class NetworkData(BaseModel):
+    """Internal network data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    code: str = Field(description="Network code")
+    name: str = Field(description="Network name")
+    currency_code: str = Field(description="Base currency code")
+    is_testnet: bool = Field(default=False, description="Is testnet")
+    confirmation_blocks: int = Field(default=1, description="Required confirmation blocks")
+    block_time_seconds: int = Field(default=600, description="Average block time")
+    is_enabled: bool = Field(default=True, description="Network enabled status")
+
+
+class TariffData(BaseModel):
+    """Internal tariff data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    id: str = Field(description="Tariff ID")
+    name: str = Field(description="Tariff name")
+    tier: str = Field(description="Subscription tier")
+    monthly_price_usd: float = Field(description="Monthly price in USD")
+    yearly_price_usd: Optional[float] = Field(None, description="Yearly price in USD")
+    requests_per_hour: int = Field(description="Requests per hour limit")
+    requests_per_day: int = Field(description="Requests per day limit")
+    features: List[str] = Field(default_factory=list, description="Included features")
+    is_active: bool = Field(default=True, description="Tariff active status")
+    sort_order: int = Field(default=0, description="Display sort order")
+    created_at: datetime = Field(description="Creation timestamp")
+    updated_at: datetime = Field(description="Last update timestamp")
+
+
+class EndpointGroupData(BaseModel):
+    """Internal endpoint group data representation."""
+    model_config = ConfigDict(validate_assignment=True, from_attributes=True)
+    
+    code: str = Field(description="Endpoint group code")
+    name: str = Field(description="Endpoint group name")
+    description: Optional[str] = Field(None, description="Group description")
+    rate_limit_per_hour: Optional[int] = Field(None, description="Rate limit per hour")
+    is_enabled: bool = Field(default=True, description="Group enabled status")
+    endpoints: List[str] = Field(default_factory=list, description="Included endpoints")
+    created_at: datetime = Field(description="Creation timestamp")
+    updated_at: datetime = Field(description="Last update timestamp")

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

@@ -0,0 +1,150 @@
+"""
+Request types for the Universal Payment System v2.0.
+
+Pydantic models for validating incoming service requests.
+"""
+
+from decimal import Decimal
+from typing import Optional, Dict, Any, Literal
+from pydantic import BaseModel, Field, ConfigDict, field_validator
+from datetime import datetime
+
+
+class PaymentCreateRequest(BaseModel):
+    """
+    Type-safe payment creation request.
+    
+    Used for validating payment creation across all service layers.
+    """
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="forbid",
+        str_strip_whitespace=True
+    )
+    
+    user_id: int = Field(gt=0, description="User ID")
+    amount_usd: float = Field(gt=1.0, le=50000.0, description="Amount in USD")
+    currency_code: Literal['BTC', 'ETH', 'LTC', 'XMR', 'USDT', 'USDC', 'ADA', 'DOT'] = Field(
+        description="Cryptocurrency code"
+    )
+    provider: Literal['nowpayments'] = Field(default='nowpayments', description="Payment provider")
+    callback_url: Optional[str] = Field(None, description="Success callback URL")
+    cancel_url: Optional[str] = Field(None, description="Cancellation URL") 
+    description: Optional[str] = Field(None, max_length=500, description="Payment description")
+    metadata: Dict[str, Any] = Field(default_factory=dict, description="Additional metadata")
+    
+    @field_validator('currency_code')
+    @classmethod
+    def validate_currency(cls, v: str) -> str:
+        """Validate currency is supported."""
+        supported = ['BTC', 'ETH', 'LTC', 'XMR', 'USDT', 'USDC', 'ADA', 'DOT']
+        if v.upper() not in supported:
+            raise ValueError(f"Currency {v} not supported. Supported: {', '.join(supported)}")
+        return v.upper()
+    
+    @field_validator('callback_url', 'cancel_url')
+    @classmethod
+    def validate_urls(cls, v: Optional[str]) -> Optional[str]:
+        """Validate URLs if provided."""
+        if v and not v.startswith(('http://', 'https://')):
+            raise ValueError("URLs must start with http:// or https://")
+        return v
+
+
+class PaymentStatusRequest(BaseModel):
+    """Request for checking payment status."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    payment_id: str = Field(description="Payment ID to check")
+    user_id: Optional[int] = Field(None, description="User ID for authorization")
+    force_provider_check: bool = Field(default=False, description="Force check with provider")
+
+
+class BalanceUpdateRequest(BaseModel):
+    """Request for updating user balance."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    user_id: int = Field(gt=0, description="User ID")
+    amount: float = Field(description="Amount to add/subtract (positive=add, negative=subtract)")
+    transaction_type: Literal['deposit', 'withdrawal', 'payment', 'refund', 'fee', 'bonus', 'adjustment'] = Field(
+        description="Type of transaction"
+    )
+    description: Optional[str] = Field(None, description="Transaction description")
+    payment_id: Optional[str] = Field(None, description="Related payment ID")
+    metadata: Dict[str, Any] = Field(default_factory=dict, description="Additional metadata")
+    
+    @field_validator('amount')
+    @classmethod
+    def validate_amount(cls, v: float) -> float:
+        """Validate amount is not zero."""
+        if v == 0:
+            raise ValueError("Amount cannot be zero")
+        return v
+
+
+class SubscriptionCreateRequest(BaseModel):
+    """Request for creating subscription."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    user_id: int = Field(gt=0, description="User ID")
+    tier: Literal['free', 'basic', 'pro', 'enterprise'] = Field(description="Subscription tier")
+    duration_days: int = Field(default=30, gt=0, le=365, description="Subscription duration in days")
+    auto_renew: bool = Field(default=False, description="Enable auto-renewal")
+    endpoint_groups: list[str] = Field(default_factory=list, description="Endpoint group codes")
+
+
+class SubscriptionUpdateRequest(BaseModel):
+    """Request for updating subscription."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    subscription_id: int = Field(gt=0, description="Subscription ID")
+    tier: Optional[Literal['free', 'basic', 'pro', 'enterprise']] = Field(None, description="New subscription tier")
+    duration_days: Optional[int] = Field(None, gt=0, le=365, description="New duration in days")
+    auto_renew: Optional[bool] = Field(None, description="Enable/disable auto-renewal")
+    endpoint_groups: Optional[list[str]] = Field(None, description="New endpoint group codes")
+
+
+class CurrencyConversionRequest(BaseModel):
+    """Request for currency conversion."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    amount: float = Field(gt=0, description="Amount to convert")
+    from_currency: str = Field(min_length=3, max_length=10, description="Source currency code")
+    to_currency: str = Field(min_length=3, max_length=10, description="Target currency code")
+    
+    @field_validator('from_currency', 'to_currency')
+    @classmethod
+    def validate_currency_codes(cls, v: str) -> str:
+        """Normalize currency codes."""
+        return v.upper().strip()
+
+
+class APIKeyCreateRequest(BaseModel):
+    """Request for creating API key."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    user_id: int = Field(gt=0, description="User ID")
+    name: str = Field(min_length=1, max_length=100, description="API key name")
+    expires_in_days: Optional[int] = Field(None, gt=0, le=365, description="Days until expiration")
+    allowed_ips: Optional[str] = Field(None, description="Comma-separated allowed IP addresses")
+
+
+class WebhookValidationRequest(BaseModel):
+    """Request for webhook validation."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    provider: str = Field(description="Provider name")
+    payload: Dict[str, Any] = Field(description="Webhook payload")
+    signature: Optional[str] = Field(None, description="Webhook signature")
+    headers: Dict[str, str] = Field(default_factory=dict, description="Request headers")
+    timestamp: Optional[str] = Field(None, description="Request timestamp")
+    request_id: Optional[str] = Field(None, description="Request ID for tracking")
+    
+    
+class ProviderHealthCheckRequest(BaseModel):
+    """Request for provider health check."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    provider: str = Field(description="Provider name to check")
+    include_rates: bool = Field(default=False, description="Include currency rates in check")
+    timeout: int = Field(default=30, gt=0, le=300, description="Timeout in seconds")

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

@@ -0,0 +1,156 @@
+"""
+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
+
+
+class ServiceOperationResult(BaseModel):
+    """
+    Base result type for all service operations.
+    
+    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")
+    data: Optional[Dict[str, Any]] = Field(None, description="Additional result data")
+    timestamp: datetime = Field(default_factory=datetime.utcnow, description="Operation timestamp")
+
+
+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")
+    crypto_amount: Optional[Decimal] = Field(None, description="Crypto amount")
+    currency_code: Optional[str] = Field(None, description="Cryptocurrency code")
+    provider_payment_id: Optional[str] = Field(None, description="Provider payment ID")
+    payment_url: Optional[str] = Field(None, description="Payment URL")
+    qr_code_url: Optional[str] = Field(None, description="QR code URL")
+    wallet_address: Optional[str] = Field(None, description="Wallet address")
+    expires_at: Optional[datetime] = Field(None, description="Payment expiration")
+
+
+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")
+    status: Optional[str] = Field(None, description="Provider status")
+    amount: Optional[Decimal] = Field(None, description="Amount from provider")
+    currency: Optional[str] = Field(None, description="Currency from provider")
+    payment_url: Optional[str] = Field(None, description="Payment URL")
+    wallet_address: Optional[str] = Field(None, description="Wallet address")
+    qr_code_url: Optional[str] = Field(None, description="QR code URL")
+    expires_at: Optional[datetime] = Field(None, description="Payment expiration")
+    error_message: Optional[str] = Field(None, description="Error message")
+    raw_response: Dict[str, Any] = Field(default_factory=dict, description="Raw provider response")
+
+
+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")
+    transaction_amount: Optional[float] = Field(None, description="Transaction amount")
+    transaction_type: Optional[str] = Field(None, description="Transaction type")
+
+
+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")
+    status: Optional[str] = Field(None, description="Subscription status")
+    expires_at: Optional[datetime] = Field(None, description="Subscription expiration")
+    requests_remaining: Optional[int] = Field(None, description="Requests remaining today")
+
+
+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")
+    converted_amount: Optional[float] = Field(None, description="Converted amount")
+    exchange_rate: Optional[float] = Field(None, description="Exchange rate used")
+    rate_timestamp: Optional[datetime] = Field(None, description="Rate timestamp")
+
+
+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")
+    is_active: Optional[bool] = Field(None, description="API key active status")
+    expires_at: Optional[datetime] = Field(None, description="API key expiration")
+    total_requests: Optional[int] = Field(None, description="Total requests made")
+
+
+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")
+    processed: bool = Field(default=False, description="Whether webhook was processed")
+    actions_taken: List[str] = Field(default_factory=list, description="Actions taken during processing")
+
+
+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")
+    api_status: Optional[str] = Field(None, description="API status")
+    rates_available: Optional[bool] = Field(None, description="Currency rates availability")
+    last_successful_call: Optional[datetime] = Field(None, description="Last successful API call")
+    error_details: Optional[str] = Field(None, description="Error details if unhealthy")
+
+
+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")
+    failed_operations: int = Field(default=0, description="Failed operations")
+    success_rate: float = Field(default=0.0, description="Success rate percentage")
+    avg_response_time_ms: Optional[float] = Field(None, description="Average response time")
+    last_operation: Optional[datetime] = Field(None, description="Last operation timestamp")
+    uptime_seconds: Optional[int] = Field(None, description="Service uptime in seconds")
+
+
+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")
+    results: List[ServiceOperationResult] = Field(default_factory=list, description="Individual results")
+    processing_time_ms: Optional[int] = Field(None, description="Total processing time")
+
+
+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")
+    data_size_bytes: Optional[int] = Field(None, description="Data size in bytes")