app/routers/readability.py

# app/routers/readability.py
import logging
from fastapi import APIRouter, Depends, HTTPException, status # Import HTTPException and status for validation

from app.schemas.base import TextOnlyRequest
from app.services.readability import ReadabilityScorer # Import the service class
from app.core.security import verify_api_key
from app.core.config import APP_NAME # For logger naming
from app.core.exceptions import ServiceError # For re-raising internal errors

logger = logging.getLogger(f"{APP_NAME}.routers.readability")

router = APIRouter(prefix="/readability", tags=["Readability"])

# Initialize service instance once per application lifecycle
readability_scorer_service = ReadabilityScorer()


@router.post("/score", dependencies=[Depends(verify_api_key)]) # Added /score path for clarity
async def readability_score_endpoint(payload: TextOnlyRequest):
    """
    Computes various readability scores for the provided text.
    """
    text = payload.text.strip()
    if not text:
        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Input text cannot be empty.")

    logger.info(f"Received readability scoring request for text (first 50 chars): '{text[:50]}...'")

    try:
        # Directly call the async service method
        result = await readability_scorer_service.compute(text)

        logger.info(f"Readability scoring successful for text (first 50 chars): '{text[:50]}...'")
        return {"readability_scores": result}

    except ServiceError as e:
        # Re-raise ServiceError. It will be caught by the global exception handler.
        raise e
    except Exception as e:
        # Catch any unexpected exceptions and re-raise as a generic ServiceError
        logger.exception(f"Unhandled error in readability scoring endpoint for text: '{text[:50]}...'")
        raise ServiceError(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail="An unexpected error occurred during readability scoring.") from e