"""
Triple Store Methods Module

This module provides all triple store methods as simple, reusable functions for
registering stores, adding triples, querying, and managing triple stores. It supports
multiple approaches and integrates with the method registry for extensibility.

Supported Methods:

Store Registration:
    - "default": Default store registration using TripleManager
    - "blazegraph": Blazegraph-specific registration
    - "jena": Jena-specific registration
    - "rdf4j": RDF4J-specific registration
    - "virtuoso": Virtuoso-specific registration

Triple Addition:
    - "default": Default triple addition
    - "single": Single triple addition
    - "batch": Batch triple addition
    - "bulk": Bulk triple addition

Triple Retrieval:
    - "default": Default triple retrieval
    - "pattern": Pattern-based retrieval
    - "sparql": SPARQL-based retrieval

Triple Deletion:
    - "default": Default triple deletion
    - "single": Single triple deletion
    - "batch": Batch triple deletion

Triple Update:
    - "default": Default triple update (delete-then-add)
    - "atomic": Atomic update (when supported)

SPARQL Query:
    - "default": Default SPARQL query execution
    - "optimized": Optimized query execution
    - "cached": Cached query execution

Query Optimization:
    - "default": Default query optimization
    - "basic": Basic optimization (whitespace, LIMIT)
    - "advanced": Advanced optimization (cost-based)

Bulk Loading:
    - "default": Default bulk loading
    - "batch": Batch-based bulk loading
    - "stream": Stream-based bulk loading

Validation:
    - "default": Default validation
    - "triple": Triple structure validation
    - "pre_load": Pre-load validation

Algorithms Used:

Store Registration:
    - Store Type Detection: Backend type identification, adapter factory pattern
    - Configuration Management: Store configuration storage, default store selection
    - Adapter Instantiation: Backend-specific adapter creation, connection initialization

Triple Operations:
    - Triple Validation: Required field checking, confidence validation, URI validation
    - Batch Processing: Chunking algorithm, batch size optimization
    - Pattern Matching: Subject/predicate/object filtering, SPARQL query construction

SPARQL Query:
    - Query Validation: Syntax checking, query type detection
    - Query Optimization: Whitespace normalization, LIMIT injection, cost estimation
    - Query Caching: MD5-based cache key generation, LRU-style eviction
    - Result Processing: Binding extraction, variable extraction

Bulk Loading:
    - Progress Tracking: Load percentage calculation, elapsed time tracking, throughput calculation
    - Retry Mechanism: Exponential backoff, max retry limit
    - Stream Processing: Iterator-based processing, incremental batch collection

Key Features:
    - Multiple triple store operation methods
    - Store registration with method dispatch
    - Method dispatchers with registry support
    - Custom method registration capability
    - Consistent interface across all methods

Main Functions:
    - register_store: Store registration wrapper
    - add_triple: Triple addition wrapper
    - add_triples: Multiple triple addition wrapper
    - get_triples: Triple retrieval wrapper
    - delete_triple: Triple deletion wrapper
    - update_triple: Triple update wrapper
    - execute_query: SPARQL query execution wrapper
    - optimize_query: Query optimization wrapper
    - bulk_load: Bulk loading wrapper
    - validate_triples: Triple validation wrapper
    - get_triple_store_method: Get triple store method by task and name
    - list_available_methods: List registered methods

Example Usage:
    >>> from semantica.triple_store.methods import register_store, add_triple, execute_query
    >>> store = register_store("main", "blazegraph", "http://localhost:9999/blazegraph", method="default")
    >>> result = add_triple(triple, store_id="main", method="default")
    >>> query_result = execute_query(sparql_query, store_adapter, method="default")
"""

from typing import Any, Dict, List, Optional, Union
from ..semantic_extract.triple_extractor import Triple
from .triple_manager import TripleManager, TripleStore
from .query_engine import QueryEngine, QueryResult, QueryPlan
from .bulk_loader import BulkLoader, LoadProgress
from .registry import method_registry
from .config import triple_store_config

# Global manager instances
_global_manager: Optional[TripleManager] = None
_global_query_engine: Optional[QueryEngine] = None
_global_bulk_loader: Optional[BulkLoader] = None


def _get_manager() -> TripleManager:
    """Get or create global TripleManager instance."""
    global _global_manager
    if _global_manager is None:
        config = triple_store_config.get_all()
        _global_manager = TripleManager(config=config)
    return _global_manager


def _get_query_engine() -> QueryEngine:
    """Get or create global QueryEngine instance."""
    global _global_query_engine
    if _global_query_engine is None:
        config = triple_store_config.get_all()
        _global_query_engine = QueryEngine(config=config)
    return _global_query_engine


def _get_bulk_loader() -> BulkLoader:
    """Get or create global BulkLoader instance."""
    global _global_bulk_loader
    if _global_bulk_loader is None:
        config = triple_store_config.get_all()
        _global_bulk_loader = BulkLoader(config=config)
    return _global_bulk_loader


def register_store(
    store_id: str,
    store_type: str,
    endpoint: str,
    method: str = "default",
    **options
) -> TripleStore:
    """
    Register a triple store.
    
    Args:
        store_id: Store identifier
        store_type: Store type (blazegraph, jena, rdf4j, virtuoso)
        endpoint: Store endpoint URL
        method: Registration method name (default: "default")
        **options: Additional options
    
    Returns:
        Registered store
    """
    # Check registry for custom method
    custom_method = method_registry.get("register", method)
    if custom_method:
        return custom_method(store_id, store_type, endpoint, **options)
    
    # Default implementation
    manager = _get_manager()
    return manager.register_store(store_id, store_type, endpoint, **options)


def add_triple(
    triple: Triple,
    store_id: Optional[str] = None,
    method: str = "default",
    **options
) -> Dict[str, Any]:
    """
    Add single triple to store.
    
    Args:
        triple: Triple to add
        store_id: Store identifier (uses default if not provided)
        method: Addition method name (default: "default")
        **options: Additional options
    
    Returns:
        Operation result
    """
    # Check registry for custom method
    custom_method = method_registry.get("add", method)
    if custom_method:
        return custom_method(triple, store_id=store_id, **options)
    
    # Default implementation
    manager = _get_manager()
    return manager.add_triple(triple, store_id=store_id, **options)


def add_triples(
    triples: List[Triple],
    store_id: Optional[str] = None,
    method: str = "default",
    **options
) -> Dict[str, Any]:
    """
    Add multiple triples to store.
    
    Args:
        triples: List of triples to add
        store_id: Store identifier
        method: Addition method name (default: "default")
        **options: Additional options
    
    Returns:
        Operation result
    """
    # Check registry for custom method
    custom_method = method_registry.get("add", method)
    if custom_method:
        return custom_method(triples, store_id=store_id, **options)
    
    # Default implementation
    manager = _get_manager()
    return manager.add_triples(triples, store_id=store_id, **options)


def get_triples(
    subject: Optional[str] = None,
    predicate: Optional[str] = None,
    object: Optional[str] = None,
    store_id: Optional[str] = None,
    method: str = "default",
    **options
) -> List[Triple]:
    """
    Get triples matching criteria.
    
    Args:
        subject: Optional subject URI
        predicate: Optional predicate URI
        object: Optional object URI
        store_id: Store identifier
        method: Retrieval method name (default: "default")
        **options: Additional options
    
    Returns:
        List of matching triples
    """
    # Check registry for custom method
    custom_method = method_registry.get("get", method)
    if custom_method:
        return custom_method(subject, predicate, object, store_id=store_id, **options)
    
    # Default implementation
    manager = _get_manager()
    return manager.get_triple(subject, predicate, object, store_id=store_id, **options)


def delete_triple(
    triple: Triple,
    store_id: Optional[str] = None,
    method: str = "default",
    **options
) -> Dict[str, Any]:
    """
    Delete triple from store.
    
    Args:
        triple: Triple to delete
        store_id: Store identifier
        method: Deletion method name (default: "default")
        **options: Additional options
    
    Returns:
        Operation result
    """
    # Check registry for custom method
    custom_method = method_registry.get("delete", method)
    if custom_method:
        return custom_method(triple, store_id=store_id, **options)
    
    # Default implementation
    manager = _get_manager()
    return manager.delete_triple(triple, store_id=store_id, **options)


def update_triple(
    old_triple: Triple,
    new_triple: Triple,
    store_id: Optional[str] = None,
    method: str = "default",
    **options
) -> Dict[str, Any]:
    """
    Update triple in store.
    
    Args:
        old_triple: Original triple
        new_triple: Updated triple
        store_id: Store identifier
        method: Update method name (default: "default")
        **options: Additional options
    
    Returns:
        Operation result
    """
    # Check registry for custom method
    custom_method = method_registry.get("update", method)
    if custom_method:
        return custom_method(old_triple, new_triple, store_id=store_id, **options)
    
    # Default implementation
    manager = _get_manager()
    return manager.update_triple(old_triple, new_triple, store_id=store_id, **options)


def execute_query(
    query: str,
    store_adapter: Any,
    method: str = "default",
    **options
) -> QueryResult:
    """
    Execute SPARQL query.
    
    Args:
        query: SPARQL query string
        store_adapter: Triple store adapter instance
        method: Query method name (default: "default")
        **options: Additional options
    
    Returns:
        Query result
    """
    # Check registry for custom method
    custom_method = method_registry.get("query", method)
    if custom_method:
        return custom_method(query, store_adapter, **options)
    
    # Default implementation
    engine = _get_query_engine()
    return engine.execute_query(query, store_adapter, **options)


def optimize_query(
    query: str,
    method: str = "default",
    **options
) -> str:
    """
    Optimize SPARQL query.
    
    Args:
        query: Original SPARQL query
        method: Optimization method name (default: "default")
        **options: Additional options
    
    Returns:
        Optimized query
    """
    # Check registry for custom method
    custom_method = method_registry.get("optimize", method)
    if custom_method:
        return custom_method(query, **options)
    
    # Default implementation
    engine = _get_query_engine()
    return engine.optimize_query(query, **options)


def plan_query(
    query: str,
    **options
) -> QueryPlan:
    """
    Create query execution plan.
    
    Args:
        query: SPARQL query
        **options: Planning options
    
    Returns:
        Query execution plan
    """
    engine = _get_query_engine()
    return engine.plan_query(query, **options)


def bulk_load(
    triples: List[Triple],
    store_adapter: Any,
    method: str = "default",
    **options
) -> LoadProgress:
    """
    Load triples in bulk.
    
    Args:
        triples: List of triples to load
        store_adapter: Triple store adapter instance
        method: Loading method name (default: "default")
        **options: Additional options
    
    Returns:
        Load progress information
    """
    # Check registry for custom method
    custom_method = method_registry.get("bulk_load", method)
    if custom_method:
        return custom_method(triples, store_adapter, **options)
    
    # Default implementation
    loader = _get_bulk_loader()
    return loader.load_triples(triples, store_adapter, **options)


def validate_triples(
    triples: List[Triple],
    method: str = "default",
    **options
) -> Dict[str, Any]:
    """
    Validate triples before loading.
    
    Args:
        triples: List of triples to validate
        method: Validation method name (default: "default")
        **options: Validation options
    
    Returns:
        Validation results
    """
    # Check registry for custom method
    custom_method = method_registry.get("validate", method)
    if custom_method:
        return custom_method(triples, **options)
    
    # Default implementation
    loader = _get_bulk_loader()
    return loader.validate_before_load(triples, **options)


def get_triple_store_method(task: str, method_name: str) -> Optional[Any]:
    """
    Get triple store method by task and name.
    
    Args:
        task: Task type (register, add, get, delete, update, query, optimize, bulk_load, validate)
        method_name: Method name
    
    Returns:
        Method function or None if not found
    """
    return method_registry.get(task, method_name)


def list_available_methods(task: Optional[str] = None) -> Dict[str, List[str]]:
    """
    List all available triple store methods.
    
    Args:
        task: Optional task type to filter by
    
    Returns:
        Dictionary mapping task types to lists of method names
    """
    return method_registry.list_all(task)

