"""ClinicalTrials.gov v2 async helper.
   Docs: https://clinicaltrials.gov/api/gui/ref/api_urls#v2
   Provides `search_trials_v2` which returns a list of study dicts.
"""

import httpx, asyncio
from typing import List, Dict

_BASE = "https://clinicaltrials.gov/api/v2/studies"

async def search_trials_v2(query: str, *, max_n: int = 20) -> List[Dict]:
    """Search CT.gov v2 endpoint and return list of studies."""
    params = {
        "query": query,
        "pageSize": max_n,
        "fields": "nctId,briefTitle,phase,status,startDate,conditions,interventions",
    }
    async with httpx.AsyncClient(timeout=15) as client:
        resp = await client.get(_BASE, params=params)
        resp.raise_for_status()
        return resp.json().get("studies", [])