feat(preprod): Add check for updates API (#96950)

Adds API for getting the latest app update, most of the endpoint logic
needs to be filled in, this is just the endpoint scaffolding

Author: noahsmartin

src/sentry/preprod/api/endpoints/project_preprod_check_for_updates.py

@@ -0,0 +1,67 @@
+import logging
+
+from pydantic import BaseModel
+from rest_framework.request import Request
+from rest_framework.response import Response
+
+from sentry.api.api_owners import ApiOwner
+from sentry.api.api_publish_status import ApiPublishStatus
+from sentry.api.base import region_silo_endpoint
+from sentry.api.bases.project import ProjectEndpoint, ProjectReleasePermission
+from sentry.preprod.models import PreprodArtifact
+from sentry.types.ratelimit import RateLimit, RateLimitCategory
+
+logger = logging.getLogger(__name__)
+
+
+class InstallableBuildDetails(BaseModel):
+    build_version: str
+    build_number: int
+
+
+class CheckForUpdatesApiResponse(BaseModel):
+    update: InstallableBuildDetails | None = None
+    current: InstallableBuildDetails | None = None
+
+
+@region_silo_endpoint
+class ProjectPreprodArtifactCheckForUpdatesEndpoint(ProjectEndpoint):
+    owner = ApiOwner.EMERGE_TOOLS
+    publish_status = {
+        "GET": ApiPublishStatus.EXPERIMENTAL,
+    }
+    permission_classes = (ProjectReleasePermission,)
+
+    enforce_rate_limit = True
+    rate_limits = {
+        "GET": {
+            RateLimitCategory.ORGANIZATION: RateLimit(
+                limit=100, window=60
+            ),  # 100 requests per minute per org
+        }
+    }
+
+    def get(self, request: Request, project) -> Response:
+        """
+        Check for updates for a preprod artifact
+        """
+        main_binary_identifier = request.GET.get("main_binary_identifier")
+        if not main_binary_identifier:
+            # Not implemented yet
+            return Response(CheckForUpdatesApiResponse().dict())
+
+        try:
+            preprod_artifact = PreprodArtifact.objects.filter(
+                project=project, main_binary_identifier=main_binary_identifier
+            ).latest("date_added")
+        except PreprodArtifact.DoesNotExist:
+            return Response({"error": "Not found"}, status=404)
+
+        if preprod_artifact.build_version and preprod_artifact.build_number:
+            current = InstallableBuildDetails(
+                build_version=preprod_artifact.build_version,
+                build_number=preprod_artifact.build_number,
+            )
+        else:
+            current = None
+        return Response(CheckForUpdatesApiResponse(current=current).dict())

src/sentry/preprod/api/endpoints/urls.py

@@ -12,13 +12,19 @@
 )
 from .project_preprod_artifact_update import ProjectPreprodArtifactUpdateEndpoint
 from .project_preprod_build_details import ProjectPreprodBuildDetailsEndpoint
+from .project_preprod_check_for_updates import ProjectPreprodArtifactCheckForUpdatesEndpoint
 
 preprod_urlpatterns = [
     re_path(
         r"^(?P<organization_id_or_slug>[^/]+)/(?P<project_id_or_slug>[^/]+)/files/preprodartifacts/assemble/$",
         ProjectPreprodArtifactAssembleEndpoint.as_view(),
         name="sentry-api-0-assemble-preprod-artifact-files",
     ),
+    re_path(
+        r"^(?P<organization_id_or_slug>[^/]+)/(?P<project_id_or_slug>[^/]+)/preprodartifacts/check-for-updates/$",
+        ProjectPreprodArtifactCheckForUpdatesEndpoint.as_view(),
+        name="sentry-api-0-project-preprod-check-for-updates",
+    ),
     re_path(
         r"^(?P<organization_id_or_slug>[^/]+)/(?P<project_id_or_slug>[^/]+)/files/preprodartifacts/(?P<artifact_id>[^/]+)/size-analysis/$",
         ProjectPreprodArtifactSizeAnalysisDownloadEndpoint.as_view(),