feat(launchpad): create size analysis download endpoint (#95089)

<!-- Describe your PR here. -->

<!--

  Sentry employees and contractors can delete or ignore the following.

-->

### Legal Boilerplate

Look, I get it. The entity doing business as "Sentry" was incorporated
in the State of Delaware in 2015 as Functional Software, Inc. and is
gonna need some rights from me in order to utilize my contributions in
this here PR. So here's the deal: I retain all rights, title and
interest in and to my contributions, and by keeping this boilerplate
intact I confirm that Sentry can use, modify, copy, and redistribute my
contributions, under Sentry's choice of terms.

Author: NicoHinderling

src/sentry/preprod/analytics.py

@@ -29,6 +29,18 @@ class PreprodArtifactApiAssembleGenericEvent(analytics.Event):
     )
 
 
+class PreprodArtifactApiSizeAnalysisDownloadEvent(analytics.Event):
+    type = "preprod_artifact.api.size_analysis_download"
+
+    attributes = (
+        analytics.Attribute("organization_id"),
+        analytics.Attribute("project_id"),
+        analytics.Attribute("user_id", required=False),
+        analytics.Attribute("artifact_id"),
+    )
+
+
 analytics.register(PreprodArtifactApiAssembleEvent)
 analytics.register(PreprodArtifactApiUpdateEvent)
 analytics.register(PreprodArtifactApiAssembleGenericEvent)
+analytics.register(PreprodArtifactApiSizeAnalysisDownloadEvent)

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

@@ -0,0 +1,95 @@
+from django.conf import settings
+from django.http.response import FileResponse, HttpResponseBase
+from rest_framework.request import Request
+from rest_framework.response import Response
+
+from sentry import analytics, features
+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
+from sentry.models.files.file import File
+from sentry.preprod.models import PreprodArtifactSizeMetrics
+
+
+@region_silo_endpoint
+class ProjectPreprodArtifactSizeAnalysisDownloadEndpoint(ProjectEndpoint):
+    owner = ApiOwner.EMERGE_TOOLS
+    publish_status = {
+        "GET": ApiPublishStatus.EXPERIMENTAL,
+    }
+
+    def get(self, request: Request, project, artifact_id) -> HttpResponseBase:
+        """
+        Download size analysis results for a preprod artifact
+        ````````````````````````````````````````````````````
+
+        Download the size analysis results for a preprod artifact.
+
+        :pparam string organization_id_or_slug: the id or slug of the organization the
+                                          artifact belongs to.
+        :pparam string project_id_or_slug: the id or slug of the project to retrieve the
+                                     artifact from.
+        :pparam string artifact_id: the ID of the preprod artifact to download size analysis for.
+        :auth: required
+        """
+
+        analytics.record(
+            "preprod_artifact.api.size_analysis_download",
+            organization_id=project.organization_id,
+            project_id=project.id,
+            user_id=request.user.id,
+            artifact_id=artifact_id,
+        )
+
+        if not settings.IS_DEV and not features.has(
+            "organizations:preprod-artifact-assemble", project.organization, actor=request.user
+        ):
+            return Response({"error": "Feature not enabled"}, status=403)
+
+        try:
+            size_metrics_qs = PreprodArtifactSizeMetrics.objects.select_related(
+                "preprod_artifact"
+            ).filter(
+                preprod_artifact__project=project,
+                preprod_artifact__id=artifact_id,
+            )
+            size_metrics_count = size_metrics_qs.count()
+            if size_metrics_count == 0:
+                return Response(
+                    {"error": "Preprod artifact not found or size analysis results not available"},
+                    status=404,
+                )
+            elif size_metrics_count > 1:
+                return Response(
+                    {"error": "Multiple size analysis results found for this artifact"},
+                    status=409,
+                )
+            size_metrics = size_metrics_qs.first()
+        except Exception:
+            return Response(
+                {"error": "Failed to retrieve size analysis results"},
+                status=500,
+            )
+
+        if size_metrics is None or size_metrics.analysis_file_id is None:
+            return Response(
+                {"error": "Size analysis file not available for this artifact"}, status=404
+            )
+
+        try:
+            file_obj = File.objects.get(id=size_metrics.analysis_file_id)
+        except File.DoesNotExist:
+            return Response({"error": "Size analysis file not found"}, status=404)
+
+        try:
+            fp = file_obj.getfile()
+        except Exception:
+            return Response({"error": "Failed to retrieve size analysis file"}, status=500)
+
+        response = FileResponse(
+            fp,
+            content_type="application/json",
+        )
+        response["Content-Length"] = file_obj.size
+        return response

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

@@ -3,6 +3,9 @@
 from .organization_preprod_artifact_assemble import ProjectPreprodArtifactAssembleEndpoint
 from .project_preprod_artifact_assemble_generic import ProjectPreprodArtifactAssembleGenericEndpoint
 from .project_preprod_artifact_download import ProjectPreprodArtifactDownloadEndpoint
+from .project_preprod_artifact_size_analysis_download import (
+    ProjectPreprodArtifactSizeAnalysisDownloadEndpoint,
+)
 from .project_preprod_artifact_update import ProjectPreprodArtifactUpdateEndpoint
 
 preprod_urlpatterns = [
@@ -11,6 +14,11 @@
         ProjectPreprodArtifactAssembleEndpoint.as_view(),
         name="sentry-api-0-assemble-preprod-artifact-files",
     ),
+    re_path(
+        r"^(?P<organization_id_or_slug>[^/]+)/(?P<project_id_or_slug>[^/]+)/files/preprodartifacts/(?P<artifact_id>[^/]+)/size-analysis/$",
+        ProjectPreprodArtifactSizeAnalysisDownloadEndpoint.as_view(),
+        name="sentry-api-0-project-preprod-artifact-size-analysis-download",
+    ),
 ]
 
 preprod_internal_urlpatterns = [