Implement Backend API to List Packages within a Project

backend/app/routes.py

@@ -13,7 +13,8 @@ from .storage import get_storage, S3Storage, MULTIPART_CHUNK_SIZE
 from .models import Project, Package, Artifact, Tag, Upload, Consumer
 from .schemas import (
     ProjectCreate, ProjectResponse,
-    PackageCreate, PackageResponse,
+    PackageCreate, PackageResponse, PackageDetailResponse, TagSummary,
+    PACKAGE_FORMATS, PACKAGE_PLATFORMS,
     ArtifactResponse,
     TagCreate, TagResponse,
     UploadResponse,
@@ -119,14 +120,210 @@ def get_project(project_name: str, db: Session = Depends(get_db)):
 
 
 # Package routes
-@router.get("/api/v1/project/{project_name}/packages", response_model=List[PackageResponse])
-def list_packages(project_name: str, db: Session = Depends(get_db)):
+@router.get("/api/v1/project/{project_name}/packages", response_model=PaginatedResponse[PackageDetailResponse])
+def list_packages(
+    project_name: str,
+    page: int = Query(default=1, ge=1, description="Page number"),
+    limit: int = Query(default=20, ge=1, le=100, description="Items per page"),
+    search: Optional[str] = Query(default=None, description="Search by name or description"),
+    sort: str = Query(default="name", description="Sort field (name, created_at, updated_at)"),
+    order: str = Query(default="asc", description="Sort order (asc, desc)"),
+    format: Optional[str] = Query(default=None, description="Filter by package format"),
+    platform: Optional[str] = Query(default=None, description="Filter by platform"),
+    db: Session = Depends(get_db),
+):
     project = db.query(Project).filter(Project.name == project_name).first()
     if not project:
         raise HTTPException(status_code=404, detail="Project not found")
 
-    packages = db.query(Package).filter(Package.project_id == project.id).order_by(Package.name).all()
-    return packages
+    # Validate sort field
+    valid_sort_fields = {"name": Package.name, "created_at": Package.created_at, "updated_at": Package.updated_at}
+    if sort not in valid_sort_fields:
+        raise HTTPException(status_code=400, detail=f"Invalid sort field. Must be one of: {', '.join(valid_sort_fields.keys())}")
+
+    # Validate order
+    if order not in ("asc", "desc"):
+        raise HTTPException(status_code=400, detail="Invalid order. Must be 'asc' or 'desc'")
+
+    # Validate format filter
+    if format and format not in PACKAGE_FORMATS:
+        raise HTTPException(status_code=400, detail=f"Invalid format. Must be one of: {', '.join(PACKAGE_FORMATS)}")
+
+    # Validate platform filter
+    if platform and platform not in PACKAGE_PLATFORMS:
+        raise HTTPException(status_code=400, detail=f"Invalid platform. Must be one of: {', '.join(PACKAGE_PLATFORMS)}")
+
+    # Base query
+    query = db.query(Package).filter(Package.project_id == project.id)
+
+    # Apply search filter (case-insensitive on name and description)
+    if search:
+        search_lower = search.lower()
+        query = query.filter(
+            or_(
+                func.lower(Package.name).contains(search_lower),
+                func.lower(Package.description).contains(search_lower)
+            )
+        )
+
+    # Apply format filter
+    if format:
+        query = query.filter(Package.format == format)
+
+    # Apply platform filter
+    if platform:
+        query = query.filter(Package.platform == platform)
+
+    # Get total count before pagination
+    total = query.count()
+
+    # Apply sorting
+    sort_column = valid_sort_fields[sort]
+    if order == "desc":
+        query = query.order_by(sort_column.desc())
+    else:
+        query = query.order_by(sort_column.asc())
+
+    # Apply pagination
+    offset = (page - 1) * limit
+    packages = query.offset(offset).limit(limit).all()
+
+    # Calculate total pages
+    total_pages = math.ceil(total / limit) if total > 0 else 1
+
+    # Build detailed responses with aggregated data
+    detailed_packages = []
+    for pkg in packages:
+        # Get tag count
+        tag_count = db.query(func.count(Tag.id)).filter(Tag.package_id == pkg.id).scalar() or 0
+
+        # Get unique artifact count and total size via uploads
+        artifact_stats = db.query(
+            func.count(func.distinct(Upload.artifact_id)),
+            func.coalesce(func.sum(Artifact.size), 0)
+        ).join(Artifact, Upload.artifact_id == Artifact.id).filter(
+            Upload.package_id == pkg.id
+        ).first()
+        artifact_count = artifact_stats[0] if artifact_stats else 0
+        total_size = artifact_stats[1] if artifact_stats else 0
+
+        # Get latest tag
+        latest_tag_obj = db.query(Tag).filter(
+            Tag.package_id == pkg.id
+        ).order_by(Tag.created_at.desc()).first()
+        latest_tag = latest_tag_obj.name if latest_tag_obj else None
+
+        # Get latest upload timestamp
+        latest_upload = db.query(func.max(Upload.uploaded_at)).filter(
+            Upload.package_id == pkg.id
+        ).scalar()
+
+        # Get recent tags (limit 5)
+        recent_tags_objs = db.query(Tag).filter(
+            Tag.package_id == pkg.id
+        ).order_by(Tag.created_at.desc()).limit(5).all()
+        recent_tags = [
+            TagSummary(name=t.name, artifact_id=t.artifact_id, created_at=t.created_at)
+            for t in recent_tags_objs
+        ]
+
+        detailed_packages.append(PackageDetailResponse(
+            id=pkg.id,
+            project_id=pkg.project_id,
+            name=pkg.name,
+            description=pkg.description,
+            format=pkg.format,
+            platform=pkg.platform,
+            created_at=pkg.created_at,
+            updated_at=pkg.updated_at,
+            tag_count=tag_count,
+            artifact_count=artifact_count,
+            total_size=total_size,
+            latest_tag=latest_tag,
+            latest_upload_at=latest_upload,
+            recent_tags=recent_tags,
+        ))
+
+    return PaginatedResponse(
+        items=detailed_packages,
+        pagination=PaginationMeta(
+            page=page,
+            limit=limit,
+            total=total,
+            total_pages=total_pages,
+        ),
+    )
+
+
+@router.get("/api/v1/project/{project_name}/packages/{package_name}", response_model=PackageDetailResponse)
+def get_package(
+    project_name: str,
+    package_name: str,
+    include_tags: bool = Query(default=False, description="Include all tags (not just recent 5)"),
+    db: Session = Depends(get_db),
+):
+    """Get a single package with full metadata"""
+    project = db.query(Project).filter(Project.name == project_name).first()
+    if not project:
+        raise HTTPException(status_code=404, detail="Project not found")
+
+    pkg = db.query(Package).filter(
+        Package.project_id == project.id,
+        Package.name == package_name
+    ).first()
+    if not pkg:
+        raise HTTPException(status_code=404, detail="Package not found")
+
+    # Get tag count
+    tag_count = db.query(func.count(Tag.id)).filter(Tag.package_id == pkg.id).scalar() or 0
+
+    # Get unique artifact count and total size via uploads
+    artifact_stats = db.query(
+        func.count(func.distinct(Upload.artifact_id)),
+        func.coalesce(func.sum(Artifact.size), 0)
+    ).join(Artifact, Upload.artifact_id == Artifact.id).filter(
+        Upload.package_id == pkg.id
+    ).first()
+    artifact_count = artifact_stats[0] if artifact_stats else 0
+    total_size = artifact_stats[1] if artifact_stats else 0
+
+    # Get latest tag
+    latest_tag_obj = db.query(Tag).filter(
+        Tag.package_id == pkg.id
+    ).order_by(Tag.created_at.desc()).first()
+    latest_tag = latest_tag_obj.name if latest_tag_obj else None
+
+    # Get latest upload timestamp
+    latest_upload = db.query(func.max(Upload.uploaded_at)).filter(
+        Upload.package_id == pkg.id
+    ).scalar()
+
+    # Get tags (all if include_tags=true, else limit 5)
+    tags_query = db.query(Tag).filter(Tag.package_id == pkg.id).order_by(Tag.created_at.desc())
+    if not include_tags:
+        tags_query = tags_query.limit(5)
+    tags_objs = tags_query.all()
+    recent_tags = [
+        TagSummary(name=t.name, artifact_id=t.artifact_id, created_at=t.created_at)
+        for t in tags_objs
+    ]
+
+    return PackageDetailResponse(
+        id=pkg.id,
+        project_id=pkg.project_id,
+        name=pkg.name,
+        description=pkg.description,
+        format=pkg.format,
+        platform=pkg.platform,
+        created_at=pkg.created_at,
+        updated_at=pkg.updated_at,
+        tag_count=tag_count,
+        artifact_count=artifact_count,
+        total_size=total_size,
+        latest_tag=latest_tag,
+        latest_upload_at=latest_upload,
+        recent_tags=recent_tags,
+    )
 
 
 @router.post("/api/v1/project/{project_name}/packages", response_model=PackageResponse)
@@ -135,6 +332,14 @@ def create_package(project_name: str, package: PackageCreate, db: Session = Depe
     if not project:
         raise HTTPException(status_code=404, detail="Project not found")
 
+    # Validate format
+    if package.format not in PACKAGE_FORMATS:
+        raise HTTPException(status_code=400, detail=f"Invalid format. Must be one of: {', '.join(PACKAGE_FORMATS)}")
+
+    # Validate platform
+    if package.platform not in PACKAGE_PLATFORMS:
+        raise HTTPException(status_code=400, detail=f"Invalid platform. Must be one of: {', '.join(PACKAGE_PLATFORMS)}")
+
     existing = db.query(Package).filter(Package.project_id == project.id, Package.name == package.name).first()
     if existing:
         raise HTTPException(status_code=400, detail="Package already exists in this project")
@@ -143,6 +348,8 @@ def create_package(project_name: str, package: PackageCreate, db: Session = Depe
         project_id=project.id,
         name=package.name,
         description=package.description,
+        format=package.format,
+        platform=package.platform,
     )
     db.add(db_package)
     db.commit()