definite-sdk 0.1.16__tar.gz → 0.1.17__tar.gz

{definite_sdk-0.1.16 → definite_sdk-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: definite-sdk
-Version: 0.1.16
+Version: 0.1.17
 Summary: Definite SDK for Python
 License: MIT
 License-File: LICENSE

{definite_sdk-0.1.16 → definite_sdk-0.1.17}/definite_sdk/integration.py

@@ -128,3 +128,63 @@ class DefiniteIntegrationStore:
             raise Exception("Integration with type `duckdb` not found")
         integration = integrations[0]
         return integration.get("details", {})
+
+    def get_syncs(
+        self,
+        integration_id: str,
+        *,
+        limit: int = 50,
+        offset: int = 0,
+        desc: bool = True,
+        status: Optional[str] = None,
+    ) -> List[Dict]:
+        """
+        Retrieves sync runs (DAG runs) for an integration.
+
+        Args:
+            integration_id (str): The ID of the integration.
+            limit (int): Maximum number of results to return (default: 50, max: 100).
+            offset (int): Number of results to skip for pagination (default: 0).
+            desc (bool): Sort by created_at descending if True (default: True).
+            status (str): Optional filter by status ("STARTED", "SUCCESS", "FAILED").
+
+        Returns:
+            List[Dict]: List of DAG run records with keys:
+                - dag_name: Name of the DAG
+                - run_id: Unique ID for this run
+                - created_at: ISO datetime when created
+                - updated_at: ISO datetime when updated
+                - src_integration_id: Source integration UUID
+                - dst_integration_id: Destination integration UUID
+                - status: Run status (STARTED, SUCCESS, FAILED)
+                - details: Additional run details
+        """
+        params: Dict = {
+            "limit": limit,
+            "offset": offset,
+            "desc": str(desc).lower(),
+        }
+        if status:
+            params["status"] = status
+
+        response = requests.get(
+            f"{self._integrations_url}/{integration_id}/syncs",
+            params=params,
+            headers={"Authorization": "Bearer " + self._api_key},
+        )
+        response.raise_for_status()
+        cursor_page = response.json()
+        return cast(List[Dict], cursor_page.get("data", []))
+
+    def get_latest_sync(self, integration_id: str) -> Optional[Dict]:
+        """
+        Retrieves the most recent sync run for an integration.
+
+        Args:
+            integration_id (str): The ID of the integration.
+
+        Returns:
+            Optional[Dict]: The most recent DAG run, or None if no syncs exist.
+        """
+        syncs = self.get_syncs(integration_id, limit=1, desc=True)
+        return syncs[0] if syncs else None

{definite_sdk-0.1.16 → definite_sdk-0.1.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "definite-sdk"
-version = "0.1.16"
+version = "0.1.17"
 description = "Definite SDK for Python"
 authors = ["Definite <hello@definite.app>"]
 license = "MIT"