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

unrealon_sdk/src/core/metadata.py

@@ -1,191 +0,0 @@
-"""
-Structured metadata models for UnrealOn SDK v1.0
-
-These Pydantic v2 models replace ALL Dict[str, Any] usage throughout the SDK,
-ensuring 100% type safety and validation for metadata objects.
-
-CRITICAL: These models are mandatory - NO raw dictionaries allowed!
-"""
-
-from datetime import datetime
-from typing import Optional, List, Dict, Union
-from enum import Enum
-
-from pydantic import BaseModel, Field, ConfigDict
-
-
-class SDKMetadata(BaseModel):
-    """Base metadata model for SDK components."""
-    
-    model_config = ConfigDict(
-        validate_assignment=True,
-        extra="forbid",
-        frozen=True
-    )
-    
-    sdk_version: str = Field(default="1.0.0", description="SDK version")
-    timestamp: datetime = Field(default_factory=datetime.utcnow, description="Creation timestamp")
-    correlation_id: Optional[str] = Field(default=None, description="Request correlation ID")
-
-
-class RegistrationMetadata(SDKMetadata):
-    """Metadata for parser registration operations."""
-    
-    parser_id: str = Field(..., description="Unique parser identifier")
-    parser_name: str = Field(..., description="Human-readable parser name")
-    parser_type: str = Field(..., description="Type of parser")
-    environment: str = Field(..., description="Environment (development, staging, production)")
-    features_enabled: List[str] = Field(default_factory=list, description="List of enabled features")
-
-
-class CommandExecutionMetadata(SDKMetadata):
-    """Metadata for command execution operations."""
-    
-    command_id: str = Field(..., description="Unique command identifier")
-    command_type: str = Field(..., description="Type of command being executed")
-    parser_id: str = Field(..., description="Parser handling the command")
-    execution_start: datetime = Field(default_factory=datetime.utcnow, description="Execution start time")
-    timeout_ms: int = Field(default=30000, ge=1000, description="Command timeout in milliseconds")
-
-
-class LoggingContextMetadata(SDKMetadata):
-    """Metadata for logging context."""
-    
-    component_name: str = Field(..., description="Component generating the log")
-    log_level: str = Field(..., description="Log level")
-    function_name: Optional[str] = Field(default=None, description="Function name")
-    operation_type: Optional[str] = Field(default=None, description="Type of operation")
-
-
-class EnvironmentMetadata(SDKMetadata):
-    """Metadata about the runtime environment."""
-    
-    environment: str = Field(..., description="Environment name (development, staging, production)")
-    python_version: str = Field(..., description="Python version")
-    platform: str = Field(..., description="Operating system platform")
-    architecture: str = Field(..., description="System architecture")
-
-
-class ProxyOperationMetadata(SDKMetadata):
-    """Metadata for proxy operations."""
-    
-    proxy_id: str = Field(..., description="Unique proxy identifier")
-    proxy_identifier: str = Field(..., description="Human-readable proxy identifier")
-    operation_type: str = Field(..., description="Type of proxy operation")
-    region: Optional[str] = Field(default=None, description="Proxy region/location")
-
-
-class ExecutionInfo(BaseModel):
-    """Information about command execution."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    command_id: str = Field(..., description="Command identifier")
-    command_type: str = Field(..., description="Command type")
-    status: str = Field(..., description="Execution status")
-    start_time: datetime = Field(..., description="Execution start time")
-    duration_ms: Optional[float] = Field(default=None, description="Execution duration")
-
-
-class RouterStatistics(BaseModel):
-    """Command router statistics."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    total_commands: int = Field(..., ge=0, description="Total commands processed")
-    successful_commands: int = Field(..., ge=0, description="Successful commands")
-    failed_commands: int = Field(..., ge=0, description="Failed commands")
-    average_execution_time_ms: float = Field(..., ge=0, description="Average execution time")
-    active_executions: int = Field(..., ge=0, description="Currently executing commands")
-    success_rate: float = Field(..., ge=0, le=100, description="Success rate percentage")
-
-
-class DevelopmentLoggerStatistics(BaseModel):
-    """Development logger statistics."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    total_events: int = Field(..., ge=0, description="Total events logged")
-    events_by_type: Dict[str, int] = Field(default_factory=dict, description="Events count by type")
-    events_by_severity: Dict[str, int] = Field(default_factory=dict, description="Events count by severity")
-    buffer_size: int = Field(..., ge=0, description="Current buffer size")
-    websocket_connected: bool = Field(..., description="WebSocket connection status")
-    startup_time: datetime = Field(..., description="Logger startup time")
-
-
-class LoggingServiceStatistics(BaseModel):
-    """Logging service statistics."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    total_logs: int = Field(..., ge=0, description="Total logs processed")
-    logs_by_level: Dict[str, int] = Field(default_factory=dict, description="Logs count by level")
-    websocket_logs: int = Field(..., ge=0, description="WebSocket logs sent")
-    buffer_size: int = Field(..., ge=0, description="Current buffer size")
-    failed_sends: int = Field(..., ge=0, description="Failed WebSocket sends")
-    last_flush: datetime = Field(..., description="Last buffer flush time")
-
-
-class HTTPClientStatistics(BaseModel):
-    """HTTP client statistics."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    total_requests: int = Field(..., ge=0, description="Total HTTP requests made")
-    successful_requests: int = Field(..., ge=0, description="Successful requests")
-    failed_requests: int = Field(..., ge=0, description="Failed requests")
-    average_response_time_ms: float = Field(..., ge=0, description="Average response time")
-    success_rate: float = Field(..., ge=0, le=100, description="Success rate percentage")
-
-
-class WebSocketClientStatistics(BaseModel):
-    """WebSocket client statistics."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    connection_state: str = Field(..., description="Current connection state")
-    total_messages: int = Field(..., ge=0, description="Total messages sent/received")
-    reconnect_count: int = Field(..., ge=0, description="Number of reconnections")
-    last_ping_ms: Optional[float] = Field(default=None, description="Last ping response time")
-    uptime_seconds: float = Field(..., ge=0, description="Connection uptime in seconds")
-
-
-class WebSocketHealthInfo(BaseModel):
-    """WebSocket client health information."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    connected: bool = Field(..., description="Is currently connected")
-    reconnect_count: int = Field(..., ge=0, description="Number of reconnections")
-    last_ping: Optional[str] = Field(default=None, description="Last ping timestamp")
-    connection_state: 'WebSocketConnectionState' = Field(..., description="Detailed connection state")
-
-
-class WebSocketConnectionState(BaseModel):
-    """WebSocket connection state details."""
-    
-    model_config = ConfigDict(validate_assignment=True, extra="forbid", frozen=True)
-    
-    connected: bool = Field(..., description="Connection established")
-    connecting: bool = Field(..., description="Currently connecting")
-    error: Optional[str] = Field(default=None, description="Connection error if any")
-    last_connected: Optional[str] = Field(default=None, description="Last connection timestamp")
-    reconnect_count: int = Field(..., ge=0, description="Reconnection attempts")
-
-
-__all__ = [
-    "SDKMetadata",
-    "RegistrationMetadata", 
-    "CommandExecutionMetadata",
-    "LoggingContextMetadata",
-    "EnvironmentMetadata",
-    "ProxyOperationMetadata",
-    "ExecutionInfo",
-    "RouterStatistics",
-    "DevelopmentLoggerStatistics",
-    "LoggingServiceStatistics",
-    "HTTPClientStatistics",
-    "WebSocketClientStatistics",
-    "WebSocketHealthInfo",
-    "WebSocketConnectionState",
-]

unrealon_sdk/src/core/models.py

@@ -1,142 +0,0 @@
-"""
-Core data models for UnrealOn SDK.
-
-This module provides the foundational Pydantic models that form the backbone
-of the SDK's type-safe architecture. All models use Pydantic v2 with strict
-validation and zero tolerance for Dict[str, Any] patterns.
-
-CRITICAL REQUIREMENTS COMPLIANCE:
-- NO relative imports (absolute imports only)
-- NO Dict[str, Any] usage (Pydantic models only)
-- NO Python 3.10+ union syntax (Union[X, Y] only)
-- 100% type annotation coverage
-- Strict Pydantic v2 compliance
-
-NOTE: Some models have been moved to /dto/ for better organization.
-This module focuses on core SDK models, while /dto/ contains specialized DTOs.
-"""
-
-from typing import Dict, Optional, Union, Any, List
-from pydantic import BaseModel, Field, ConfigDict
-
-# Import DTO models for backward compatibility
-from unrealon_sdk.src.dto.health import ConnectionHealthStatus as DTOConnectionHealthStatus
-from unrealon_sdk.src.dto.health import ComponentStatus as DTOComponentStatus
-
-
-class AdapterStatus(BaseModel):
-    """
-    Current operational status of the adapter.
-
-    This model tracks the adapter's connection state, session information,
-    and health metrics in a type-safe manner.
-    """
-
-    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True, extra="forbid")
-
-    is_connected: bool = Field(
-        False, description="Whether the adapter is currently connected to UnrealOn services."
-    )
-    session_id: Optional[str] = Field(None, description="Current session ID if connected.")
-    last_error: Optional[str] = Field(None, description="Last error message encountered.")
-    connection_attempts: int = Field(0, description="Number of connection attempts made.")
-
-
-class CommandMetadata(BaseModel):
-    """
-    Metadata for parser commands with strict type validation.
-
-    Replaces any Dict[str, Any] usage with properly typed fields.
-    """
-
-    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True, extra="forbid")
-
-    command_id: str = Field(..., description="Unique command identifier")
-    timestamp: str = Field(..., description="ISO 8601 timestamp")
-    source: str = Field(..., description="Command source identifier")
-    priority: int = Field(default=0, description="Command priority level")
-    retry_count: int = Field(default=0, description="Number of retry attempts")
-
-
-class ErrorDetails(BaseModel):
-    """
-    Structured error information replacing Dict[str, Any] patterns.
-    """
-
-    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True, extra="forbid")
-
-    error_code: str = Field(..., description="Error classification code")
-    message: str = Field(..., description="Human-readable error message")
-    context: Optional[str] = Field(None, description="Additional error context")
-    is_recoverable: bool = Field(True, description="Whether error is recoverable")
-    suggested_action: Optional[str] = Field(None, description="Suggested recovery action")
-
-
-class HealthCheckResult(BaseModel):
-    """
-    Health check response model with strict typing.
-    """
-
-    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True, extra="forbid")
-
-    status: str = Field(..., description="Health status: 'healthy', 'degraded', or 'unhealthy'")
-    timestamp: str = Field(..., description="ISO 8601 timestamp of check")
-    response_time_ms: float = Field(..., description="Response time in milliseconds")
-    services: List[str] = Field(default_factory=list, description="List of healthy services")
-    errors: List[ErrorDetails] = Field(default_factory=list, description="Any detected errors")
-
-
-class WebSocketEventBase(BaseModel):
-    """
-    Base model for all WebSocket events with strict validation.
-    """
-
-    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True, extra="forbid")
-
-    event_type: str = Field(..., description="Type of WebSocket event")
-    timestamp: str = Field(..., description="ISO 8601 timestamp")
-    session_id: Optional[str] = Field(None, description="Associated session ID")
-    metadata: Optional[CommandMetadata] = Field(None, description="Event metadata")
-
-
-class ConnectionHealthStatus(BaseModel):
-    """
-    Connection health status model with strict validation.
-    """
-
-    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True, extra="forbid")
-
-    is_healthy: bool = Field(..., description="Overall health status")
-    connection_quality: float = Field(..., ge=0.0, le=1.0, description="Connection quality (0-1)")
-    latency_ms: float = Field(..., ge=0.0, description="Connection latency in milliseconds")
-    uptime_seconds: float = Field(..., ge=0.0, description="Connection uptime in seconds")
-    last_heartbeat: str = Field(..., description="ISO 8601 timestamp of last heartbeat")
-
-
-class ComponentStatus(BaseModel):
-    """
-    Individual component status with strict typing.
-    """
-
-    model_config = ConfigDict(str_strip_whitespace=True, validate_assignment=True, extra="forbid")
-
-    component_name: str = Field(..., description="Name of the component")
-    status: str = Field(..., description="Status: 'active', 'inactive', 'error', 'degraded'")
-    last_update: str = Field(..., description="ISO 8601 timestamp of last status update")
-    error_details: Optional[ErrorDetails] = Field(
-        None, description="Error information if status is 'error'"
-    )
-    metrics: Optional[Dict[str, Union[int, float, str]]] = Field(
-        None, description="Component-specific metrics"
-    )
-
-
-# Migration aliases - Use DTO models instead of duplicating here
-# These provide backward compatibility while encouraging DTO usage
-
-# Alias to DTO model for new code
-ConnectionHealthStatusDTO = DTOConnectionHealthStatus
-ComponentStatusDTO = DTOComponentStatus
-
-# Note: For new development, import directly from unrealon_sdk.src.dto.health
-# This ensures proper separation of concerns and avoids model duplication

unrealon_sdk/src/core/types.py

@@ -1,68 +0,0 @@
-"""
-Core type definitions for UnrealOn SDK v1.0
-
-Contains basic types and enums used throughout the SDK.
-For API-specific types, use auto-generated models from clients.
-"""
-
-from typing import Optional
-from datetime import datetime
-from dataclasses import dataclass
-
-from unrealon_sdk.src.core.metadata import SDKMetadata
-
-
-@dataclass
-class ConnectionState:
-    """
-    Tracks the connection state of the SDK.
-
-    This is for internal SDK state management only.
-    For API communication, use auto-generated models.
-    """
-
-    connected: bool = False
-    connecting: bool = False
-    last_connected: Optional[datetime] = None
-    last_disconnected: Optional[datetime] = None
-    reconnect_count: int = 0
-    error: Optional[str] = None
-    session_id: Optional[str] = None
-    metadata: Optional[SDKMetadata] = None
-
-    def reset(self) -> None:
-        """Reset connection state to initial values."""
-        self.connected = False
-        self.connecting = False
-        self.reconnect_count = 0
-        self.error = None
-        self.session_id = None
-        self.metadata = None
-
-    def mark_connected(self, session_id: Optional[str] = None) -> None:
-        """Mark as connected."""
-        self.connected = True
-        self.connecting = False
-        self.last_connected = datetime.utcnow()
-        self.error = None
-        if session_id:
-            self.session_id = session_id
-
-    def mark_disconnected(self, error: Optional[str] = None) -> None:
-        """Mark as disconnected."""
-        self.connected = False
-        self.connecting = False
-        self.last_disconnected = datetime.utcnow()
-        if error:
-            self.error = error
-
-    def mark_connecting(self) -> None:
-        """Mark as connecting."""
-        self.connecting = True
-        self.error = None
-
-    def mark_reconnecting(self) -> None:
-        """Mark as reconnecting."""
-        self.reconnect_count += 1
-        self.connecting = True
-        self.connected = False

unrealon_sdk/src/dto/__init__.py

@@ -1,268 +0,0 @@
-"""
-UnrealOn SDK Data Transfer Objects (DTOs)
-
-Custom Pydantic models for type-safe data transfer within the SDK.
-These models complement auto-generated client models with SDK-specific functionality.
-
-Architecture:
-- /clients/     - Auto-generated models (DO NOT EDIT)
-- /core/models/ - Core SDK models (base functionality)
-- /dto/         - Custom DTO models (SDK-specific data structures)
-
-All models follow CRITICAL_REQUIREMENTS.md:
-- 100% Pydantic v2 with strict validation
-- No Dict[str, Any] usage - type-safe models only
-- Full type annotations for all fields
-- Python 3.9+ compatibility (no X | Y syntax)
-"""
-
-# Event-related DTOs
-from .events import (
-    EventMetadata,
-    EventSubscriptionFilter,
-    EventDeliveryResult,
-    EventStatistics,
-)
-
-# WebSocket connection DTOs
-from .websocket import (
-    WebSocketConnectionState,
-)
-
-# Health and monitoring DTOs
-from .health import (
-    ComponentStatus,
-    HealthCheckType,
-    AlertSeverity,
-    HealthCheckFrequency,
-    ConnectionHealthStatus,
-    ComponentHealth,
-    HealthCheckConfig,
-    HealthAlert,
-    SystemHealthSummary,
-    HealthCheckResult,
-    HealthTrend,
-)
-
-# Authentication DTOs
-from .authentication import (
-    AuthenticationStatus,
-    SecurityEventType,
-    AuthenticationContext,
-    SecurityEvent,
-    RateLimitConfig,
-)
-
-# Logging DTOs (development logging)
-from .logging import (
-    LogDestination,
-    SDKEventType,
-    SDKSeverity,
-    SDKContext,
-    SDKDevelopmentEvent,
-)
-
-# Structured Logging DTOs (enterprise logging service)
-from .structured_logging import (
-    LogBuffer,
-)
-
-# Performance Monitoring DTOs
-from .performance import (
-    MetricType,
-    AlertSeverity,
-    MetricUnit,
-    MetricValue,
-    MetricThreshold,
-    PerformanceMetric,
-    PerformanceAlert,
-    PerformanceReport,
-)
-
-# Cache Management DTOs
-from .cache import (
-    CachePolicy,
-    CacheLevel,
-    CacheEventType,
-    CacheEntry,
-    CacheStatistics,
-    CacheConfig,
-    CacheOperation,
-    CacheMetrics,
-)
-
-# Rate Limiting DTOs
-from .rate_limiting import (
-    RateLimitStrategy,
-    BackoffStrategy,
-    RateLimitScope,
-    RateLimitStatus,
-    RateLimitEventType,
-    RateLimitConfig,
-    RateLimitQuota,
-    RateLimitRequest,
-    RateLimitStatistics,
-    BackoffState,
-)
-
-# Concurrency & Threading DTOs
-from .concurrency import (
-    ThreadPoolStrategy,
-    LoadBalancingStrategy,
-    TaskPriority,
-    TaskStatus,
-    ResourceType,
-    ResourceStatus,
-    ConcurrencyEventType,
-    ThreadPoolConfig,
-    ThreadInfo,
-    Task,
-    ResourcePool,
-    ConcurrencyMetrics,
-    LoadBalancingDecision,
-    DeadlockDetection,
-)
-
-# Task Scheduling DTOs
-from .task_scheduling import (
-    ScheduleType,
-    TaskSchedulerStrategy,
-    ScheduleInfo,
-    TaskDependency,
-    TaskProgress,
-    TaskSchedulerConfig,
-)
-
-# Resource Pooling DTOs
-from .resource_pooling import (
-    ResourceLifecycleState,
-    PoolScalingStrategy,
-    ResourceMetadata,
-    PoolConfig,
-)
-
-# Load Balancing DTOs
-from .load_balancing import (
-    LoadBalancingAlgorithm,
-    NodeHealthStatus,
-    TrafficDirection,
-    FailoverStrategy,
-    CircuitBreakerState,
-    LoadBalancerNode,
-    LoadBalancingRule,
-    LoadBalancingDecisionRequest,
-    LoadBalancingDecisionResult,
-    LoadBalancerStatistics,
-    HealthCheckConfig,
-    LoadBalancingSession,
-)
-
-# Common utility DTOs
-# from .common import (
-#     # Will be added as needed
-# )
-
-__all__ = [
-    # Events
-    "EventMetadata",
-    "EventSubscriptionFilter",
-    "EventDeliveryResult",
-    "EventStatistics",
-    # WebSocket
-    "WebSocketConnectionState",
-    # Health
-    "ComponentStatus",
-    "HealthCheckType",
-    "AlertSeverity",
-    "HealthCheckFrequency",
-    "ConnectionHealthStatus",
-    "ComponentHealth",
-    "HealthCheckConfig",
-    "HealthAlert",
-    "SystemHealthSummary",
-    "HealthCheckResult",
-    "HealthTrend",
-    # Authentication
-    "AuthenticationStatus",
-    "SecurityEventType",
-    "AuthenticationContext",
-    "SecurityEvent",
-    "RateLimitConfig",
-    # Logging (development)
-    "LogDestination",
-    "SDKEventType",
-    "SDKSeverity",
-    "SDKContext",
-    "SDKDevelopmentEvent",
-    # Structured Logging (enterprise service)
-    "LogBuffer",
-    # Performance Monitoring
-    "MetricType",
-    "AlertSeverity",
-    "MetricUnit",
-    "MetricValue",
-    "MetricThreshold",
-    "PerformanceMetric",
-    "PerformanceAlert",
-    "PerformanceReport",
-    # Cache Management
-    "CachePolicy",
-    "CacheLevel",
-    "CacheEventType",
-    "CacheEntry",
-    "CacheStatistics",
-    "CacheConfig",
-    "CacheOperation",
-    "CacheMetrics",
-    # Rate Limiting
-    "RateLimitStrategy",
-    "BackoffStrategy",
-    "RateLimitScope",
-    "RateLimitStatus",
-    "RateLimitEventType",
-    "RateLimitConfig",
-    "RateLimitQuota",
-    "RateLimitRequest",
-    "RateLimitStatistics",
-    "BackoffState",
-    # Concurrency & Threading
-    "ThreadPoolStrategy",
-    "LoadBalancingStrategy",
-    "TaskPriority",
-    "TaskStatus",
-    "ResourceType",
-    "ResourceStatus",
-    "ConcurrencyEventType",
-    "ThreadPoolConfig",
-    "ThreadInfo",
-    "Task",
-    "ResourcePool",
-    "ConcurrencyMetrics",
-    "LoadBalancingDecision",
-    "DeadlockDetection",
-    # Task Scheduling
-    "ScheduleType",
-    "TaskSchedulerStrategy",
-    "ScheduleInfo",
-    "TaskDependency",
-    "TaskProgress",
-    "TaskSchedulerConfig",
-    # Resource Pooling
-    "ResourceLifecycleState",
-    "PoolScalingStrategy",
-    "ResourceMetadata",
-    "PoolConfig",
-    # Load Balancing
-    "LoadBalancingAlgorithm",
-    "NodeHealthStatus",
-    "TrafficDirection",
-    "FailoverStrategy",
-    "CircuitBreakerState",
-    "LoadBalancerNode",
-    "LoadBalancingRule",
-    "LoadBalancingDecisionRequest",
-    "LoadBalancingDecisionResult",
-    "LoadBalancerStatistics",
-    "HealthCheckConfig",
-    "LoadBalancingSession",
-]