interloper-api 0.68.0__tar.gz → 0.69.0__tar.gz

{interloper_api-0.68.0 → interloper_api-0.69.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: interloper-api
-Version: 0.68.0
+Version: 0.69.0
 Summary: Interloper FastAPI routes
 Author: Guillaume Onfroy
 Author-email: Guillaume Onfroy <guillaume@digitlcloud.com>

{interloper_api-0.68.0 → interloper_api-0.69.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "interloper-api"
-version = "0.68.0"
+version = "0.69.0"
 description = "Interloper FastAPI routes"
 readme = "README.md"
 requires-python = ">=3.10"

{interloper_api-0.68.0 → interloper_api-0.69.0}/pyproject.toml.orig

@@ -3,7 +3,7 @@
 # ###############
 [project]
 name = "interloper-api"
-version = "0.68.0"
+version = "0.69.0"
 description = "Interloper FastAPI routes"
 readme = "README.md"
 authors = [{ name = "Guillaume Onfroy", email = "guillaume@digitlcloud.com" }]

{interloper_api-0.68.0 → interloper_api-0.69.0}/src/interloper_api/routes/backfills.py

@@ -36,11 +36,19 @@ class BackfillCreateRequest(BaseModel):
 
 
 class BackfillResponse(BaseModel):
-    """Response body for a backfill."""
+    """Response body for a backfill.
+
+    The target component's identity is resolved server-side, same contract
+    as ``RunResponse``: the ``component_*`` identity fields are ``None``
+    exactly when the target was deleted.
+    """
 
     id: UUID
     org_id: UUID
     component_id: UUID | None
+    component_kind: str | None = None
+    component_key: str | None = None
+    component_name: str | None = None
     status: str
     start_key: str
     end_key: str
@@ -56,7 +64,7 @@ class BackfillResponse(BaseModel):
         """Convert a DB Backfill to a BackfillResponse.
 
         Args:
-            backfill: The DB Backfill row.
+            backfill: The DB Backfill row, with its ``target`` relationship loaded.
 
         Returns:
             The response model.
@@ -65,6 +73,9 @@ class BackfillResponse(BaseModel):
             id=backfill.id,
             org_id=backfill.org_id,
             component_id=backfill.component_id,
+            component_kind=backfill.target.kind if backfill.target else None,
+            component_key=backfill.target.key if backfill.target else None,
+            component_name=backfill.target.name if backfill.target else None,
             status=backfill.status,
             start_key=backfill.start_key,
             end_key=backfill.end_key,

{interloper_api-0.68.0 → interloper_api-0.69.0}/src/interloper_api/routes/runs.py

@@ -33,11 +33,21 @@ MAX_EVENTS_PAGE_SIZE = 1000
 
 
 class RunResponse(BaseModel):
-    """Response body for a run."""
+    """Response body for a run.
+
+    The target component's identity is resolved server-side (the row is
+    eagerly joined), so clients never need a second lookup — including for
+    target kinds they do not know about. All three ``component_*`` identity
+    fields are ``None`` exactly when the target was deleted
+    (``component_id`` nulls on deletion).
+    """
 
     id: UUID
     org_id: UUID
     component_id: UUID | None
+    component_kind: str | None = None
+    component_key: str | None = None
+    component_name: str | None = None
     backfill_id: UUID | None
     partition_key: str | None
     status: str
@@ -53,7 +63,7 @@ class RunResponse(BaseModel):
         """Convert a DB Run to a RunResponse.
 
         Args:
-            run: The DB Run row.
+            run: The DB Run row, with its ``target`` relationship loaded.
 
         Returns:
             The response model.
@@ -62,6 +72,9 @@ class RunResponse(BaseModel):
             id=run.id,
             org_id=run.org_id,
             component_id=run.component_id,
+            component_kind=run.target.kind if run.target else None,
+            component_key=run.target.key if run.target else None,
+            component_name=run.target.name if run.target else None,
             backfill_id=run.backfill_id,
             partition_key=run.partition_key,
             status=run.status,