feat: Implement pagination for extractions and playlists with total count in responses

app/api/v1/extractions.py

@@ -94,14 +94,18 @@ async def get_all_extractions(
     sort_by: Annotated[str, Query(description="Sort by field")] = "created_at",
     sort_order: Annotated[str, Query(description="Sort order (asc/desc)")] = "desc",
     status_filter: Annotated[str | None, Query(description="Filter by status")] = None,
-) -> dict[str, list[ExtractionInfo]]:
+    page: Annotated[int, Query(description="Page number", ge=1)] = 1,
+    limit: Annotated[int, Query(description="Items per page", ge=1, le=100)] = 50,
+) -> dict:
     """Get all extractions with optional filtering, search, and sorting."""
     try:
-        extractions = await extraction_service.get_all_extractions(
+        result = await extraction_service.get_all_extractions(
             search=search,
             sort_by=sort_by,
             sort_order=sort_order,
             status_filter=status_filter,
+            page=page,
+            limit=limit,
         )
 
     except Exception as e:
@@ -110,9 +114,7 @@ async def get_all_extractions(
             detail=f"Failed to get extractions: {e!s}",
         ) from e
     else:
-        return {
-            "extractions": extractions,
-        }
+        return result
 
 
 @router.get("/user")
@@ -123,7 +125,9 @@ async def get_user_extractions(
     sort_by: Annotated[str, Query(description="Sort by field")] = "created_at",
     sort_order: Annotated[str, Query(description="Sort order (asc/desc)")] = "desc",
     status_filter: Annotated[str | None, Query(description="Filter by status")] = None,
-) -> dict[str, list[ExtractionInfo]]:
+    page: Annotated[int, Query(description="Page number", ge=1)] = 1,
+    limit: Annotated[int, Query(description="Items per page", ge=1, le=100)] = 50,
+) -> dict:
     """Get all extractions for the current user."""
     try:
         if current_user.id is None:
@@ -132,12 +136,14 @@ async def get_user_extractions(
                 detail="User ID not available",
             )
 
-        extractions = await extraction_service.get_user_extractions(
+        result = await extraction_service.get_user_extractions(
             user_id=current_user.id,
             search=search,
             sort_by=sort_by,
             sort_order=sort_order,
             status_filter=status_filter,
+            page=page,
+            limit=limit,
         )
 
     except Exception as e:
@@ -146,6 +152,4 @@ async def get_user_extractions(
             detail=f"Failed to get extractions: {e!s}",
         ) from e
     else:
-        return {
-            "extractions": extractions,
-        }
+        return result

app/api/v1/playlists.py

@@ -1,6 +1,6 @@
 """Playlist management API endpoints."""
 
-from typing import Annotated
+from typing import Annotated, Any
 
 from fastapi import APIRouter, Depends, HTTPException, Query, status
 from sqlmodel.ext.asyncio.session import AsyncSession
@@ -55,35 +55,29 @@ async def get_all_playlists(  # noqa: PLR0913
         SortOrder,
         Query(description="Sort order (asc or desc)"),
     ] = SortOrder.ASC,
-    limit: Annotated[
-        int | None,
-        Query(description="Maximum number of results", ge=1, le=1000),
-    ] = None,
-    offset: Annotated[
-        int,
-        Query(description="Number of results to skip", ge=0),
-    ] = 0,
+    page: Annotated[int, Query(description="Page number", ge=1)] = 1,
+    limit: Annotated[int, Query(description="Items per page", ge=1, le=100)] = 50,
     favorites_only: Annotated[
         bool,
         Query(description="Show only favorited playlists"),
     ] = False,
-) -> list[PlaylistResponse]:
+) -> dict[str, Any]:
     """Get all playlists from all users with search and sorting."""
-    playlists = await playlist_service.search_and_sort_playlists(
+    result = await playlist_service.search_and_sort_playlists_paginated(
         search_query=search,
         sort_by=sort_by,
         sort_order=sort_order,
         user_id=None,
         include_stats=True,
+        page=page,
         limit=limit,
-        offset=offset,
         favorites_only=favorites_only,
         current_user_id=current_user.id,
     )
 
     # Convert to PlaylistResponse with favorite indicators
     playlist_responses = []
-    for playlist_dict in playlists:
+    for playlist_dict in result["playlists"]:
         # The playlist service returns dict, need to create playlist object-like structure
         is_favorited = await favorite_service.is_playlist_favorited(current_user.id, playlist_dict["id"])
         favorite_count = await favorite_service.get_playlist_favorite_count(playlist_dict["id"])
@@ -98,7 +92,13 @@ async def get_all_playlists(  # noqa: PLR0913
         }
         playlist_responses.append(playlist_response)
 
-    return playlist_responses
+    return {
+        "playlists": playlist_responses,
+        "total": result["total"],
+        "page": result["page"],
+        "limit": result["limit"],
+        "total_pages": result["total_pages"],
+    }
 
 
 @router.get("/user")