143 lines
5.4 KiB
Python
143 lines
5.4 KiB
Python
# Copyright (c) 2026 PowerOn AG
|
|
# 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.serviceCenter import getService
|
|
from modules.serviceCenter.context import ServiceCenterContext
|
|
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):
|
|
ctx = ServiceCenterContext(user=current_user)
|
|
clickupService = getService("clickup", ctx)
|
|
if not clickupService.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 clickupService
|
|
|
|
|
|
@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)
|