platform-core/modules/routes/routeClickup.py

# Copyright (c) 2025 Patrick Motsch
# All rights reserved.
"""ClickUp API routes — lists and tasks (connection-scoped). OAuth lives under /api/clickup/auth/* in routeSecurityClickup."""

import logging
from typing import Any, Dict, Optional

from fastapi import APIRouter, Depends, HTTPException, Path, Query, Request, status
from modules.auth import getCurrentUser, limiter
from modules.datamodels.datamodelUam import AuthAuthority, User, UserConnection
from modules.interfaces.interfaceDbApp import getInterface
from modules.serviceHub import getInterface as getServices
from modules.shared.i18nRegistry import apiRouteContext

routeApiMsg = apiRouteContext("routeClickup")

logger = logging.getLogger(__name__)

router = APIRouter(
    prefix="/api/clickup",
    tags=["ClickUp"],
    responses={
        404: {"description": "Not found"},
        400: {"description": "Bad request"},
        401: {"description": "Unauthorized"},
        500: {"description": "Internal server error"},
    },
)


def _getUserConnection(interface, connection_id: str, user_id: str) -> Optional[UserConnection]:
    """Resolve by UUID or connection:authority:username (same as browse / workflow)."""
    try:
        if hasattr(interface, "getUserConnectionById"):
            conn = interface.getUserConnectionById(connection_id)
            if conn is not None:
                return conn
        connections = interface.getUserConnections(user_id)
        for conn in connections:
            if conn.id == connection_id:
                return conn
        return None
    except Exception as e:
        logger.error(f"Error getting user connection: {e}")
        return None


def _clickup_connection_or_404(interface, connection_id: str, user_id: str) -> UserConnection:
    connection = _getUserConnection(interface, connection_id, user_id)
    if not connection:
        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=routeApiMsg("Connection not found"))
    authority = connection.authority.value if hasattr(connection.authority, "value") else str(connection.authority)
    if authority.lower() != AuthAuthority.CLICKUP.value:
        raise HTTPException(
            status_code=status.HTTP_400_BAD_REQUEST,
            detail=routeApiMsg("Connection is not a ClickUp connection"),
        )
    return connection


def _svc_for_connection(current_user: User, connection: UserConnection):
    services = getServices(current_user, None)
    if not services.clickup.setAccessTokenFromConnection(connection):
        raise HTTPException(
            status_code=status.HTTP_502_BAD_GATEWAY,
            detail=routeApiMsg("Failed to set ClickUp access token. Connection may be expired or invalid."),
        )
    return services.clickup


@router.get("/{connectionId}/teams/{teamId}", response_model=Dict[str, Any])
@limiter.limit("60/minute")
async def get_team(
    request: Request,
    connectionId: str = Path(...),
    teamId: str = Path(...),
    currentUser: User = Depends(getCurrentUser),
) -> Dict[str, Any]:
    """Workspace/team details including members (for assignee pickers)."""
    interface = getInterface(currentUser)
    conn = _clickup_connection_or_404(interface, connectionId, currentUser.id)
    cu = _svc_for_connection(currentUser, conn)
    return await cu.getTeam(teamId)


@router.get("/{connectionId}/lists/{listId}", response_model=Dict[str, Any])
@limiter.limit("60/minute")
async def get_list(
    request: Request,
    connectionId: str = Path(...),
    listId: str = Path(...),
    currentUser: User = Depends(getCurrentUser),
) -> Dict[str, Any]:
    interface = getInterface(currentUser)
    conn = _clickup_connection_or_404(interface, connectionId, currentUser.id)
    cu = _svc_for_connection(currentUser, conn)
    return await cu.getList(listId)


@router.get("/{connectionId}/lists/{listId}/fields", response_model=Dict[str, Any])
@limiter.limit("60/minute")
async def get_list_fields(
    request: Request,
    connectionId: str = Path(...),
    listId: str = Path(...),
    currentUser: User = Depends(getCurrentUser),
) -> Dict[str, Any]:
    interface = getInterface(currentUser)
    conn = _clickup_connection_or_404(interface, connectionId, currentUser.id)
    cu = _svc_for_connection(currentUser, conn)
    return await cu.getListFields(listId)


@router.get("/{connectionId}/lists/{listId}/tasks", response_model=Dict[str, Any])
@limiter.limit("60/minute")
async def get_list_tasks(
    request: Request,
    connectionId: str = Path(...),
    listId: str = Path(...),
    page: int = Query(0),
    include_closed: bool = Query(False),
    currentUser: User = Depends(getCurrentUser),
) -> Dict[str, Any]:
    interface = getInterface(currentUser)
    conn = _clickup_connection_or_404(interface, connectionId, currentUser.id)
    cu = _svc_for_connection(currentUser, conn)
    return await cu.getTasksInList(listId, page=page, include_closed=include_closed)


@router.get("/{connectionId}/tasks/{taskId}", response_model=Dict[str, Any])
@limiter.limit("60/minute")
async def get_task(
    request: Request,
    connectionId: str = Path(...),
    taskId: str = Path(...),
    currentUser: User = Depends(getCurrentUser),
) -> Dict[str, Any]:
    interface = getInterface(currentUser)
    conn = _clickup_connection_or_404(interface, connectionId, currentUser.id)
    cu = _svc_for_connection(currentUser, conn)
    return await cu.getTask(taskId)