Dolibarr MCP Server

"""Configuration management for Dolibarr MCP Server."""

import os
import sys

from pydantic import AliasChoices, Field, field_validator
from pydantic_settings import BaseSettings, SettingsConfigDict
from dotenv import load_dotenv

# Load environment variables from .env file
load_dotenv()


class Config(BaseSettings):
    """Configuration for Dolibarr MCP Server."""

    model_config = SettingsConfigDict(
        env_file=".env",
        env_file_encoding="utf-8",
        case_sensitive=False,
        validate_assignment=True,
        extra="ignore",
    )

    dolibarr_url: str = Field(
        description="Dolibarr API URL",
        default="",
    )

    dolibarr_api_key: str = Field(
        description="Dolibarr API key",
        default="",
        validation_alias=AliasChoices("dolibarr_api_key", "api_key"),
    )

    log_level: str = Field(
        description="Logging level",
        default="INFO",
    )

    mcp_transport: str = Field(
        description="Transport for MCP server (stdio or http)",
        default="stdio",
    )

    mcp_http_host: str = Field(
        description="HTTP host/interface for MCP server",
        default="0.0.0.0",
    )

    mcp_http_port: int = Field(
        description="HTTP port for MCP server",
        default=8080,
    )

    allow_ref_autogen: bool = Field(
        description="Allow automatic generation of reference fields when missing",
        default=False,
    )

    ref_autogen_prefix: str = Field(
        description="Prefix to use when auto-generating references",
        default="AUTO",
    )

    debug_mode: bool = Field(
        description="Enable verbose debug logging without exposing secrets",
        default=False,
    )

    max_retries: int = Field(
        description="Maximum retries for transient HTTP errors (502, 503, 504)",
        default=3,
    )

    retry_backoff_seconds: float = Field(
        description="Base backoff (seconds) for retry strategy with exponential backoff",
        default=1.0,
    )

    request_timeout: int = Field(
        description="Request timeout in seconds",
        default=60,
    )

    @field_validator("dolibarr_url")
    @classmethod
    def validate_dolibarr_url(cls, v: str) -> str:
        """Validate Dolibarr URL."""
        if not v:
            v = (
                os.getenv("DOLIBARR_URL")
                or os.getenv("DOLIBARR_BASE_URL")
                or os.getenv("DOLIBARR_SHOP_URL")
                or ""
            )
            if not v:
                # Print warning but don't fail
                print(
                    "⚠️ DOLIBARR_URL/DOLIBARR_BASE_URL not configured - API calls will fail",
                    file=sys.stderr,
                )
                return "https://your-dolibarr-instance.com/api/index.php"

        if not v.startswith(("http://", "https://")):
            raise ValueError("DOLIBARR_URL must start with http:// or https://")

        # Remove trailing slash if present
        v = v.rstrip("/")

        # Ensure it ends with the proper API path
        if not v.endswith("/api/index.php"):
            if "/api" in v:
                if not v.endswith("/index.php"):
                    if v.endswith("/index.php/"):
                        v = v[:-1]
                    elif not v.endswith("/index.php"):
                        v = v + "/index.php"
            else:
                v = v + "/api/index.php"

        return v

    @field_validator("dolibarr_api_key")
    @classmethod
    def validate_api_key(cls, v: str) -> str:
        """Validate API key."""
        if not v:
            v = os.getenv("DOLIBARR_API_KEY", "")
            if not v:
                print(
                    "⚠️ DOLIBARR_API_KEY not configured - API authentication will fail",
                    file=sys.stderr,
                )
                print(
                    "📝 Please set DOLIBARR_API_KEY in your .env file or Claude configuration",
                    file=sys.stderr,
                )
                return "placeholder_api_key"

        if v == "your_dolibarr_api_key_here":
            print(
                "⚠️ Using placeholder API key - please configure a real API key",
                file=sys.stderr,
            )

        return v

    @field_validator("log_level")
    @classmethod
    def validate_log_level(cls, v: str) -> str:
        """Validate log level."""
        if not v:
            v = os.getenv("LOG_LEVEL", "INFO")

        valid_levels = {"DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"}
        if v.upper() not in valid_levels:
            print(f"⚠️ Invalid LOG_LEVEL '{v}', using INFO", file=sys.stderr)
            return "INFO"
        return v.upper()

    @field_validator("mcp_transport")
    @classmethod
    def validate_transport(cls, v: str) -> str:
        """Validate MCP transport selection."""
        if not v:
            v = os.getenv("MCP_TRANSPORT", "stdio")
        normalized = v.lower()
        if normalized not in {"stdio", "http"}:
            print(f"⚠️ Invalid MCP_TRANSPORT '{v}', defaulting to stdio", file=sys.stderr)
            return "stdio"
        return normalized

    @field_validator("mcp_http_host")
    @classmethod
    def validate_http_host(cls, v: str) -> str:
        """Validate HTTP host."""
        return v or os.getenv("MCP_HTTP_HOST", "0.0.0.0")

    @field_validator("mcp_http_port")
    @classmethod
    def validate_http_port(cls, v: int) -> int:
        """Validate HTTP port."""
        try:
            port = int(v)
        except Exception as exc:
            raise ValueError(f"Invalid MCP_HTTP_PORT '{v}': {exc}") from exc
        if not 1 <= port <= 65535:
            raise ValueError("MCP_HTTP_PORT must be between 1 and 65535")
        return port

    @classmethod
    def from_env(cls) -> "Config":
        """Create configuration from environment variables with validation."""
        try:
            config = cls(
                dolibarr_url=(
                    os.getenv("DOLIBARR_URL")
                    or os.getenv("DOLIBARR_BASE_URL")
                    or os.getenv("DOLIBARR_SHOP_URL")
                    or ""
                ),
                dolibarr_api_key=os.getenv("DOLIBARR_API_KEY", ""),
                log_level=os.getenv("LOG_LEVEL", "INFO"),
            )
            if os.getenv("DEBUG_CONFIG"):
                print(f"✅ Config loaded:", file=sys.stderr)
                print(f"   URL: {config.dolibarr_url}", file=sys.stderr)
                print(
                    f"   API Key: {'*' * 10 if config.dolibarr_api_key else 'NOT SET'}",
                    file=sys.stderr,
                )
            return config
        except Exception as e:
            print(f"❌ Configuration Error: {e}", file=sys.stderr)
            print(file=sys.stderr)
            print("💡 Quick Setup Guide:", file=sys.stderr)
            print("1. Copy .env.example to .env", file=sys.stderr)
            print("2. Edit .env with your Dolibarr details:", file=sys.stderr)
            print(
                "   DOLIBARR_URL=https://your-dolibarr-instance.com",
                file=sys.stderr,
            )
            print(
                "   (or DOLIBARR_BASE_URL=https://your-dolibarr-instance.com/api/index.php/)",
                file=sys.stderr,
            )
            print("   DOLIBARR_API_KEY=your_api_key_here", file=sys.stderr)
            print(file=sys.stderr)
            print("🔧 Dolibarr API Key Setup:", file=sys.stderr)
            print("   1. Login to Dolibarr as admin", file=sys.stderr)
            print("   2. Go to: Home → Setup → Modules", file=sys.stderr)
            print("   3. Enable: 'Web Services API REST (developer)'", file=sys.stderr)
            print("   4. Go to: Home → Setup → API/Web services", file=sys.stderr)
            print("   5. Create a new API key", file=sys.stderr)
            print(file=sys.stderr)
            raise

    def validate_config(self) -> None:
        """Validate current configuration values."""
        self.dolibarr_url = type(self).validate_dolibarr_url(self.dolibarr_url)
        self.dolibarr_api_key = type(self).validate_api_key(self.dolibarr_api_key)
        self.log_level = type(self).validate_log_level(self.log_level)

        if self.dolibarr_url.endswith('your-dolibarr-instance.com/api/index.php') or self.dolibarr_api_key in {'', 'placeholder_api_key', 'your_dolibarr_api_key_here'}:
            raise ValueError('Dolibarr configuration is incomplete')

    @property
    def api_key(self) -> str:
        """Backward compatibility for api_key property."""
        return self.dolibarr_api_key

    @api_key.setter
    def api_key(self, value: str) -> None:
        """Allow updating the API key via legacy attribute."""
        self.dolibarr_api_key = value