""" Data models for the Image Search SDK. """ from dataclasses import dataclass, field from typing import List, Optional, Dict, Any, Union from datetime import datetime @dataclass class Product: """Product model for indexing and search results.""" id: str title: str image_url: Optional[str] = None image_path: Optional[str] = None category: Optional[str] = None brand: Optional[str] = None price: Optional[float] = None rating: Optional[float] = None description: Optional[str] = None metadata: Dict[str, Any] = field(default_factory=dict) def to_dict(self) -> Dict[str, Any]: """Convert to dictionary for API requests.""" return { 'id': self.id, 'title': self.title, 'image_url': self.image_url, 'image_path': self.image_path, 'category': self.category, 'brand': self.brand, 'price': self.price, 'rating': self.rating, 'description': self.description, 'metadata': self.metadata } @classmethod def from_dict(cls, data: Dict[str, Any]) -> 'Product': """Create Product from dictionary.""" return cls(**data) @dataclass class SearchResult: """Search result model.""" product: Product similarity_score: float rank: int search_time_ms: int def to_dict(self) -> Dict[str, Any]: """Convert to dictionary.""" return { 'product': self.product.to_dict(), 'similarity_score': self.similarity_score, 'rank': self.rank, 'search_time_ms': self.search_time_ms } @dataclass class SearchOptions: """Search options and filters.""" top_k: int = 10 min_price: Optional[float] = None max_price: Optional[float] = None category: Optional[str] = None brand: Optional[str] = None title_substring: Optional[str] = None min_similarity: float = 0.0 def to_dict(self) -> Dict[str, Any]: """Convert to dictionary for API requests.""" return { 'top_k': self.top_k, 'min_price': self.min_price, 'max_price': self.max_price, 'category': self.category, 'brand': self.brand, 'title_substring': self.title_substring, 'min_similarity': self.min_similarity } @dataclass class IndexingStatus: """Indexing operation status.""" total_products: int indexed_products: int failed_products: int is_complete: bool start_time: datetime end_time: Optional[datetime] = None errors: List[str] = field(default_factory=list) @property def progress_percentage(self) -> float: """Get indexing progress as percentage.""" if self.total_products == 0: return 0.0 return (self.indexed_products / self.total_products) * 100 @property def success_rate(self) -> float: """Get success rate as percentage.""" if self.total_products == 0: return 0.0 return (self.indexed_products / self.total_products) * 100 @dataclass class SystemStatus: """System health and status information.""" is_healthy: bool total_products: int indexed_products: int last_indexing_time: Optional[datetime] search_latency_ms: float memory_usage_mb: float version: str uptime_seconds: int def to_dict(self) -> Dict[str, Any]: """Convert to dictionary.""" return { 'is_healthy': self.is_healthy, 'total_products': self.total_products, 'indexed_products': self.indexed_products, 'last_indexing_time': self.last_indexing_time.isoformat() if self.last_indexing_time else None, 'search_latency_ms': self.search_latency_ms, 'memory_usage_mb': self.memory_usage_mb, 'version': self.version, 'uptime_seconds': self.uptime_seconds } @dataclass class DatabaseConfig: """Database connection configuration.""" connection_string: str table_name: str = "products" id_column: str = "id" title_column: str = "title" image_url_column: str = "image_url" category_column: Optional[str] = None brand_column: Optional[str] = None price_column: Optional[str] = None rating_column: Optional[str] = None description_column: Optional[str] = None def to_dict(self) -> Dict[str, Any]: """Convert to dictionary.""" return { 'connection_string': self.connection_string, 'table_name': self.table_name, 'id_column': self.id_column, 'title_column': self.title_column, 'image_url_column': self.image_url_column, 'category_column': self.category_column, 'brand_column': self.brand_column, 'price_column': self.price_column, 'rating_column': self.rating_column, 'description_column': self.description_column }