unrealon 1.0.9__py3-none-any.whl → 1.1.0__py3-none-any.whl

unrealon_sdk/src/dto/authentication.py

@@ -1,108 +0,0 @@
-"""
-Authentication-related Data Transfer Objects
-
-Custom DTO models for enterprise authentication system functionality.
-These models provide type-safe authentication state and security tracking.
-"""
-
-from datetime import datetime, timezone
-from typing import Dict, List, Optional, Any
-from enum import Enum
-
-from pydantic import BaseModel, Field, ConfigDict
-
-
-class AuthenticationStatus(str, Enum):
-    """Authentication status states."""
-    
-    UNAUTHENTICATED = "unauthenticated"
-    AUTHENTICATING = "authenticating"
-    AUTHENTICATED = "authenticated"
-    EXPIRED = "expired"
-    FAILED = "failed"
-    LOCKED = "locked"
-
-
-class SecurityEventType(str, Enum):
-    """Security event types for monitoring."""
-    
-    LOGIN_SUCCESS = "login_success"
-    LOGIN_FAILURE = "login_failure"
-    TOKEN_REFRESH = "token_refresh"
-    API_KEY_VALIDATION = "api_key_validation"
-    RATE_LIMIT_EXCEEDED = "rate_limit_exceeded"
-    SECURITY_BREACH = "security_breach"
-    ACCOUNT_LOCKED = "account_locked"
-    SUSPICIOUS_ACTIVITY = "suspicious_activity"
-
-
-class AuthenticationContext(BaseModel):
-    """
-    Type-safe authentication context.
-    
-    Tracks current authentication state and security metrics
-    using Pydantic validation instead of Dict[str, Any].
-    """
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
-    # Authentication state
-    status: AuthenticationStatus = Field(default=AuthenticationStatus.UNAUTHENTICATED)
-    api_key: Optional[str] = Field(None, description="Masked API key for logging")
-    access_token: Optional[str] = Field(None, description="Current access token")
-    
-    # Session information
-    session_id: Optional[str] = Field(None, description="Authentication session ID")
-    parser_id: Optional[str] = Field(None, description="Registered parser ID")
-    authenticated_at: Optional[datetime] = Field(None, description="Authentication timestamp")
-    expires_at: Optional[datetime] = Field(None, description="Token expiration time")
-    
-    # Security metrics
-    login_attempts: int = Field(default=0, description="Number of login attempts")
-    failed_attempts: int = Field(default=0, description="Number of failed attempts")
-    last_login_attempt: Optional[datetime] = Field(None, description="Last login attempt time")
-    rate_limit_reset_time: Optional[datetime] = Field(None, description="Rate limit reset time")
-    
-    # Environment context
-    environment: str = Field(default="dev", description="API environment (dev/prod)")
-    client_info: Dict[str, str] = Field(default_factory=dict, description="Client metadata")
-
-
-class SecurityEvent(BaseModel):
-    """Security event for audit trails and monitoring."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
-    event_id: str = Field(..., description="Unique event identifier")
-    event_type: SecurityEventType = Field(..., description="Type of security event")
-    timestamp: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-    session_id: Optional[str] = Field(None, description="Associated session ID")
-    api_key_hash: Optional[str] = Field(None, description="Hashed API key for privacy")
-    ip_address: Optional[str] = Field(None, description="Client IP address")
-    user_agent: Optional[str] = Field(None, description="Client user agent")
-    success: bool = Field(..., description="Whether the operation succeeded")
-    error_message: Optional[str] = Field(None, description="Error message if failed")
-    metadata: Dict[str, Any] = Field(default_factory=dict, description="Additional event data")
-
-
-class RateLimitConfig(BaseModel):
-    """Rate limiting configuration."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid")
-    
-    max_attempts: int = Field(default=5, description="Maximum attempts per window")
-    window_seconds: int = Field(default=300, description="Rate limit window in seconds")
-    lockout_duration_seconds: int = Field(default=900, description="Lockout duration")
-    progressive_delay: bool = Field(default=True, description="Enable progressive delay")
-
-
-__all__ = [
-    # Enums
-    "AuthenticationStatus",
-    "SecurityEventType",
-    
-    # Models
-    "AuthenticationContext",
-    "SecurityEvent", 
-    "RateLimitConfig",
-]

unrealon_sdk/src/dto/cache.py

@@ -1,208 +0,0 @@
-"""
-Cache Management DTOs - Data Transfer Objects for caching system.
-
-This module contains all Pydantic models and enums related to cache management,
-separated from business logic for clean architecture and reusability.
-
-Components:
-- Cache policies and configuration models
-- Cache entry and statistics models  
-- Cache event types and storage levels
-- Performance and analytics data structures
-"""
-
-import uuid
-from datetime import datetime, timezone
-from typing import Dict, List, Optional, Any, TypeVar, Generic
-from enum import Enum
-from dataclasses import dataclass, field
-
-from pydantic import BaseModel, Field, ConfigDict
-
-T = TypeVar("T")
-
-
-class CachePolicy(str, Enum):
-    """Cache eviction policies."""
-
-    LRU = "lru"  # Least Recently Used
-    LFU = "lfu"  # Least Frequently Used
-    FIFO = "fifo"  # First In First Out
-    TTL_ONLY = "ttl_only"  # Only TTL-based expiration
-    SIZE_ONLY = "size_only"  # Only size-based eviction
-
-
-class CacheLevel(str, Enum):
-    """Cache storage levels."""
-
-    MEMORY = "memory"  # In-memory cache (fastest)
-    PERSISTENT = "persistent"  # Disk-based cache (slower but persistent)
-    DISTRIBUTED = "distributed"  # Network-distributed cache
-
-
-class CacheEventType(str, Enum):
-    """Cache-specific event types."""
-
-    CACHE_HIT = "cache_hit"
-    CACHE_MISS = "cache_miss"
-    CACHE_SET = "cache_set"
-    CACHE_DELETE = "cache_delete"
-    CACHE_EXPIRE = "cache_expire"
-    CACHE_EVICT = "cache_evict"
-    CACHE_CLEAR = "cache_clear"
-    CACHE_WARM = "cache_warm"
-
-
-@dataclass
-class CacheEntry(Generic[T]):
-    """Individual cache entry with metadata."""
-
-    key: str
-    value: T
-    created_at: datetime
-    last_accessed: datetime
-    access_count: int = 0
-    ttl_seconds: Optional[float] = None
-    compressed: bool = False
-    size_bytes: int = 0
-
-    def is_expired(self) -> bool:
-        """Check if cache entry is expired."""
-        if self.ttl_seconds is None:
-            return False
-
-        age = (datetime.now(timezone.utc) - self.created_at).total_seconds()
-        return age > self.ttl_seconds
-
-    def touch(self) -> None:
-        """Update access time and count."""
-        self.last_accessed = datetime.now(timezone.utc)
-        self.access_count += 1
-
-
-class CacheStatistics(BaseModel):
-    """Cache performance statistics."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Basic stats
-    total_requests: int = Field(default=0, description="Total cache requests")
-    cache_hits: int = Field(default=0, description="Number of cache hits")
-    cache_misses: int = Field(default=0, description="Number of cache misses")
-
-    # Performance metrics
-    hit_rate_percent: float = Field(default=0.0, description="Cache hit rate percentage")
-    avg_access_time_ms: float = Field(default=0.0, description="Average access time")
-
-    # Storage stats
-    current_size: int = Field(default=0, description="Current number of entries")
-    max_size: int = Field(default=0, description="Maximum cache size")
-    memory_usage_bytes: int = Field(default=0, description="Memory usage in bytes")
-
-    # Lifecycle stats
-    total_sets: int = Field(default=0, description="Total cache sets")
-    total_deletes: int = Field(default=0, description="Total cache deletes")
-    total_evictions: int = Field(default=0, description="Total evictions")
-    total_expirations: int = Field(default=0, description="Total expirations")
-
-    # Time-based metrics
-    created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-    last_reset: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-
-
-class CacheConfig(BaseModel):
-    """Cache configuration model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Size limits
-    max_entries: int = Field(default=10000, description="Maximum number of cache entries")
-    max_memory_mb: int = Field(default=100, description="Maximum memory usage in MB")
-
-    # TTL settings
-    default_ttl_seconds: float = Field(default=3600.0, description="Default TTL in seconds")
-    max_ttl_seconds: float = Field(default=86400.0, description="Maximum TTL in seconds")
-
-    # Eviction policy
-    eviction_policy: CachePolicy = Field(
-        default=CachePolicy.LRU, description="Cache eviction policy"
-    )
-    eviction_threshold: float = Field(default=0.8, description="Threshold for eviction (0.0-1.0)")
-
-    # Cleanup settings
-    cleanup_interval_seconds: float = Field(default=300.0, description="Cleanup interval")
-    compression_enabled: bool = Field(
-        default=True, description="Enable compression for large objects"
-    )
-    compression_threshold_bytes: int = Field(
-        default=1024, description="Size threshold for compression"
-    )
-
-    # Performance settings
-    enable_statistics: bool = Field(default=True, description="Enable cache statistics")
-    warm_cache_on_startup: bool = Field(default=False, description="Warm cache on startup")
-
-
-class CacheOperation(BaseModel):
-    """Cache operation tracking model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    operation_id: str = Field(default_factory=lambda: str(uuid.uuid4()))
-    operation_type: CacheEventType = Field(..., description="Type of cache operation")
-    cache_key: str = Field(..., description="Cache key involved")
-    timestamp: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-    duration_ms: Optional[float] = Field(
-        default=None, description="Operation duration in milliseconds"
-    )
-    success: bool = Field(default=True, description="Whether operation was successful")
-    error_message: Optional[str] = Field(default=None, description="Error message if failed")
-    details: Dict[str, Any] = Field(
-        default_factory=dict, description="Additional operation details"
-    )
-
-
-class CacheMetrics(BaseModel):
-    """Real-time cache metrics model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Performance metrics
-    avg_get_time_ms: float = Field(default=0.0, description="Average GET operation time")
-    avg_set_time_ms: float = Field(default=0.0, description="Average SET operation time")
-    peak_memory_usage_bytes: int = Field(default=0, description="Peak memory usage")
-
-    # Efficiency metrics
-    hit_rate_last_hour: float = Field(default=0.0, description="Hit rate in last hour")
-    eviction_rate_per_hour: float = Field(default=0.0, description="Evictions per hour")
-    compression_ratio: float = Field(default=1.0, description="Average compression ratio")
-
-    # Capacity metrics
-    memory_utilization_percent: float = Field(
-        default=0.0, description="Memory utilization percentage"
-    )
-    entry_utilization_percent: float = Field(
-        default=0.0, description="Entry count utilization percentage"
-    )
-
-    # Recent activity (last 5 minutes)
-    recent_operations: int = Field(default=0, description="Operations in last 5 minutes")
-    recent_hits: int = Field(default=0, description="Cache hits in last 5 minutes")
-    recent_misses: int = Field(default=0, description="Cache misses in last 5 minutes")
-
-    # Timestamp
-    collected_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-
-
-__all__ = [
-    # Enums
-    "CachePolicy",
-    "CacheLevel",
-    "CacheEventType",
-    # Data models
-    "CacheEntry",
-    "CacheStatistics",
-    "CacheConfig",
-    "CacheOperation",
-    "CacheMetrics",
-]

unrealon_sdk/src/dto/common.py

@@ -1,19 +0,0 @@
-"""
-Common Data Transfer Objects
-
-Shared DTO models used across multiple SDK components.
-These are utility DTOs that don't fit into specific categories.
-"""
-
-from datetime import datetime
-from typing import Any, Dict, List, Optional
-
-from pydantic import BaseModel, Field, ConfigDict
-
-
-# Placeholder for future common DTOs
-# Will be expanded as needed
-
-__all__: List[str] = [
-    # Will be populated as common DTOs are added
-]