blackroad-operating-system/backend/app/routers/twilio.py

"""
Twilio API Integration Router

Provides endpoints for SMS, voice calls, and WhatsApp messaging.
Twilio is a cloud communications platform.
"""

from fastapi import APIRouter, HTTPException, status
from pydantic import BaseModel
from typing import Optional, Dict, Any
from datetime import datetime
import httpx
import base64
import os
import logging

from app.utils import utc_now

logger = logging.getLogger(__name__)

router = APIRouter(prefix="/api/twilio", tags=["twilio"])

# Twilio API configuration
TWILIO_ACCOUNT_SID = os.getenv("TWILIO_ACCOUNT_SID")
TWILIO_AUTH_TOKEN = os.getenv("TWILIO_AUTH_TOKEN")
TWILIO_PHONE_NUMBER = os.getenv("TWILIO_PHONE_NUMBER")


class SMSMessage(BaseModel):
    """SMS message model"""
    to: str
    message: str
    from_number: Optional[str] = None


class WhatsAppMessage(BaseModel):
    """WhatsApp message model"""
    to: str
    message: str


class TwilioClient:
    """Twilio REST API client"""

    def __init__(
        self,
        account_sid: Optional[str] = None,
        auth_token: Optional[str] = None,
        phone_number: Optional[str] = None
    ):
        self.account_sid = account_sid or TWILIO_ACCOUNT_SID
        self.auth_token = auth_token or TWILIO_AUTH_TOKEN
        self.phone_number = phone_number or TWILIO_PHONE_NUMBER
        self.base_url = f"https://api.twilio.com/2010-04-01/Accounts/{self.account_sid}"

    def _get_headers(self) -> Dict[str, str]:
        """Get API request headers with basic auth"""
        if not self.account_sid or not self.auth_token:
            raise HTTPException(
                status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
                detail="Twilio credentials not configured"
            )

        # Create basic auth header
        credentials = f"{self.account_sid}:{self.auth_token}"
        encoded = base64.b64encode(credentials.encode()).decode()

        return {
            "Authorization": f"Basic {encoded}",
            "Content-Type": "application/x-www-form-urlencoded"
        }

    async def _request(
        self,
        method: str,
        endpoint: str,
        data: Optional[Dict] = None
    ) -> Dict[str, Any]:
        """Make API request"""
        headers = self._get_headers()
        url = f"{self.base_url}{endpoint}"

        async with httpx.AsyncClient() as client:
            try:
                response = await client.request(
                    method,
                    url,
                    headers=headers,
                    data=data,
                    timeout=30.0
                )
                response.raise_for_status()
                return response.json()

            except httpx.HTTPStatusError as e:
                logger.error(f"Twilio API error: {e.response.text}")
                raise HTTPException(
                    status_code=e.response.status_code,
                    detail=f"Twilio API error: {e.response.text}"
                )
            except httpx.HTTPError as e:
                logger.error(f"Twilio API request failed: {e}")
                raise HTTPException(
                    status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
                    detail=f"Twilio API request failed: {str(e)}"
                )

    async def send_sms(
        self,
        to: str,
        body: str,
        from_: Optional[str] = None
    ) -> Dict[str, Any]:
        """Send SMS message"""
        data = {
            "To": to,
            "From": from_ or self.phone_number,
            "Body": body
        }

        if not data["From"]:
            raise HTTPException(
                status_code=status.HTTP_400_BAD_REQUEST,
                detail="Twilio phone number not configured"
            )

        return await self._request("POST", "/Messages.json", data=data)

    async def send_whatsapp(
        self,
        to: str,
        body: str
    ) -> Dict[str, Any]:
        """Send WhatsApp message"""
        data = {
            "To": f"whatsapp:{to}",
            "From": f"whatsapp:{self.phone_number}",
            "Body": body
        }

        if not self.phone_number:
            raise HTTPException(
                status_code=status.HTTP_400_BAD_REQUEST,
                detail="Twilio phone number not configured"
            )

        return await self._request("POST", "/Messages.json", data=data)

    async def get_message(self, message_sid: str) -> Dict[str, Any]:
        """Get message details"""
        return await self._request("GET", f"/Messages/{message_sid}.json")

    async def list_messages(self, limit: int = 20) -> Dict[str, Any]:
        """List messages"""
        data = {"PageSize": limit}
        return await self._request("GET", "/Messages.json", data=data)


# Initialize client
twilio_client = TwilioClient()


@router.get("/status")
async def get_twilio_status():
    """Get Twilio API connection status"""
    if not TWILIO_ACCOUNT_SID or not TWILIO_AUTH_TOKEN:
        return {
            "connected": False,
            "message": "Twilio credentials not configured. Set TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN."
        }

    try:
        # Try to list messages as a health check
        await twilio_client.list_messages(limit=1)
        return {
            "connected": True,
            "message": "Twilio API connected successfully",
            "phone_number_configured": bool(TWILIO_PHONE_NUMBER)
        }
    except Exception as e:
        return {
            "connected": False,
            "message": f"Twilio API connection failed: {str(e)}"
        }


@router.post("/sms")
async def send_sms(message: SMSMessage):
    """Send SMS message"""
    try:
        result = await twilio_client.send_sms(
            to=message.to,
            body=message.message,
            from_=message.from_number
        )
        return {
            "success": True,
            "message": result,
            "sid": result.get("sid")
        }
    except HTTPException:
        raise
    except Exception as e:
        logger.error(f"Error sending SMS: {e}")
        raise HTTPException(
            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
            detail=f"Failed to send SMS: {str(e)}"
        )


@router.post("/whatsapp")
async def send_whatsapp(message: WhatsAppMessage):
    """Send WhatsApp message"""
    try:
        result = await twilio_client.send_whatsapp(
            to=message.to,
            body=message.message
        )
        return {
            "success": True,
            "message": result,
            "sid": result.get("sid")
        }
    except HTTPException:
        raise
    except Exception as e:
        logger.error(f"Error sending WhatsApp: {e}")
        raise HTTPException(
            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
            detail=f"Failed to send WhatsApp: {str(e)}"
        )


@router.get("/messages/{message_sid}")
async def get_message(message_sid: str):
    """Get message details"""
    try:
        message = await twilio_client.get_message(message_sid)
        return message
    except HTTPException:
        raise


@router.get("/messages")
async def list_messages(limit: int = 20):
    """List messages"""
    try:
        result = await twilio_client.list_messages(limit)
        return result
    except HTTPException:
        raise


@router.get("/health")
async def twilio_health_check():
    """Twilio API health check endpoint"""
    return {
        "service": "twilio",
        "status": "operational" if (TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN) else "not_configured",
        "timestamp": utc_now().isoformat()
    }