feat(user): support lookup favourite & most played beatmaps

app/models/user.py

@@ -86,3 +86,14 @@ class RankHistory(BaseModel):
 class Page(BaseModel):
     html: str = ""
     raw: str = ""
+
+
+class BeatmapsetType(str, Enum):
+    FAVOURITE = "favourite"
+    GRAVEYARD = "graveyard"
+    GUEST = "guest"
+    LOVED = "loved"
+    MOST_PLAYED = "most_played"
+    NOMINATED = "nominated"
+    PENDING = "pending"
+    RANKED = "ranked"

app/router/user.py

@@ -1,9 +1,17 @@
 from __future__ import annotations
 
-from app.database import User, UserResp
+from app.database import (
+    BeatmapPlaycounts,
+    BeatmapPlaycountsResp,
+    BeatmapsetResp,
+    User,
+    UserResp,
+)
 from app.database.lazer_user import SEARCH_INCLUDED
 from app.dependencies.database import get_db
+from app.dependencies.user import get_current_user
 from app.models.score import GameMode
+from app.models.user import BeatmapsetType
 
 from .api_router import router
 
@@ -69,3 +77,56 @@ async def get_user_info(
         include=SEARCH_INCLUDED,
         ruleset=ruleset,
     )
+
+
+@router.get(
+    "/users/{user_id}/beatmapsets/{type}",
+    response_model=list[BeatmapsetResp | BeatmapPlaycountsResp],
+)
+async def get_user_beatmapsets(
+    user_id: int,
+    type: BeatmapsetType,
+    current_user: User = Depends(get_current_user),
+    session: AsyncSession = Depends(get_db),
+    limit: int = Query(100, ge=1, le=1000),
+    offset: int = Query(0, ge=0),
+):
+    if type in {
+        BeatmapsetType.GRAVEYARD,
+        BeatmapsetType.GUEST,
+        BeatmapsetType.LOVED,
+        BeatmapsetType.NOMINATED,
+        BeatmapsetType.PENDING,
+        BeatmapsetType.RANKED,
+    }:
+        # TODO: mapping, modding
+        resp = []
+
+    elif type == BeatmapsetType.FAVOURITE:
+        user = await session.get(User, user_id)
+        if not user:
+            raise HTTPException(404, detail="User not found")
+        favourites = await user.awaitable_attrs.favourite_beatmapsets
+        resp = [
+            await BeatmapsetResp.from_db(
+                favourite.beatmapset, session=session, user=current_user
+            )
+            for favourite in favourites
+        ]
+
+    elif type == BeatmapsetType.MOST_PLAYED:
+        most_played = await session.exec(
+            select(BeatmapPlaycounts)
+            .where(BeatmapPlaycounts.user_id == user_id)
+            .order_by(col(BeatmapPlaycounts.playcount).desc())
+            .limit(limit)
+            .offset(offset)
+        )
+        resp = [
+            await BeatmapPlaycountsResp.from_db(most_played_beatmap)
+            for most_played_beatmap in most_played
+        ]
+    else:
+        raise HTTPException(400, detail="Invalid beatmapset type")
+
+    return resp