feat: add api and mcp

backend/src/api/routers/peers.py

@@ -0,0 +1,42 @@
+from typing import Annotated
+
+import asyncpg
+from dishka.integrations.fastapi import DishkaRoute, FromDishka
+from fastapi import APIRouter, HTTPException, Query
+
+from utils.read import peers
+from utils.read.models import DEFAULT_LIMIT, Page, PeerHistoryView, PeerView, StoryView
+
+router = APIRouter(prefix="/api", tags=["peers"], route_class=DishkaRoute)
+
+AccountId = Annotated[int, Query()]
+
+
+@router.get("/peers/{peer_id}")
+async def get_peer(
+    pool: FromDishka[asyncpg.Pool], peer_id: int, account_id: AccountId
+) -> PeerView:
+    peer = await peers.get_peer(pool, account_id, peer_id)
+    if peer is None:
+        raise HTTPException(status_code=404, detail="peer not found")
+    return peer
+
+
+@router.get("/peers/{peer_id}/history")
+async def peer_history(
+    pool: FromDishka[asyncpg.Pool], peer_id: int, account_id: AccountId
+) -> list[PeerHistoryView]:
+    return await peers.get_peer_history(pool, account_id, peer_id)
+
+
+@router.get("/stories")
+async def stories(
+    pool: FromDishka[asyncpg.Pool],
+    account_id: AccountId,
+    peer_id: Annotated[int | None, Query()] = None,
+    limit: Annotated[int, Query()] = DEFAULT_LIMIT,
+    offset: Annotated[int, Query()] = 0,
+) -> list[StoryView]:
+    return await peers.get_stories(
+        pool, account_id, Page(limit=limit, offset=offset), peer_id=peer_id
+    )