git list refactor

backend/src/core/superset_client.py

@@ -108,6 +108,41 @@ class SupersetClient:
             return total_count, paginated_data
     # [/DEF:get_dashboards:Function]
 
+    # [DEF:get_dashboards_page:Function]
+    # @PURPOSE: Fetches a single dashboards page from Superset without iterating all pages.
+    # @PARAM: query (Optional[Dict]) - Query with page/page_size and optional columns.
+    # @PRE: Client is authenticated.
+    # @POST: Returns total count and one page of dashboards.
+    # @RETURN: Tuple[int, List[Dict]]
+    def get_dashboards_page(self, query: Optional[Dict] = None) -> Tuple[int, List[Dict]]:
+        with belief_scope("get_dashboards_page"):
+            validated_query = self._validate_query_params(query or {})
+            if "columns" not in validated_query:
+                validated_query["columns"] = [
+                    "slug",
+                    "id",
+                    "changed_on_utc",
+                    "dashboard_title",
+                    "published",
+                    "created_by",
+                    "changed_by",
+                    "changed_by_name",
+                    "owners",
+                ]
+
+            response_json = cast(
+                Dict[str, Any],
+                self.network.request(
+                    method="GET",
+                    endpoint="/dashboard/",
+                    params={"q": json.dumps(validated_query)},
+                ),
+            )
+            result = response_json.get("result", [])
+            total_count = response_json.get("count", len(result))
+            return total_count, result
+    # [/DEF:get_dashboards_page:Function]
+
     # [DEF:get_dashboards_summary:Function]
     # @PURPOSE: Fetches dashboard metadata optimized for the grid.
     # @PRE: Client is authenticated.
@@ -148,6 +183,65 @@ class SupersetClient:
             return result
     # [/DEF:get_dashboards_summary:Function]
 
+    # [DEF:get_dashboards_summary_page:Function]
+    # @PURPOSE: Fetches one page of dashboard metadata optimized for the grid.
+    # @PARAM: page (int) - 1-based page number from API route contract.
+    # @PARAM: page_size (int) - Number of items per page.
+    # @PRE: page >= 1 and page_size > 0.
+    # @POST: Returns mapped summaries and total dashboard count.
+    # @RETURN: Tuple[int, List[Dict]]
+    def get_dashboards_summary_page(
+        self,
+        page: int,
+        page_size: int,
+        search: Optional[str] = None,
+    ) -> Tuple[int, List[Dict]]:
+        with belief_scope("SupersetClient.get_dashboards_summary_page"):
+            query: Dict[str, Any] = {
+                "page": max(page - 1, 0),
+                "page_size": page_size,
+            }
+            normalized_search = (search or "").strip()
+            if normalized_search:
+                # Superset list API supports filter objects with `opr` operator.
+                # `ct` -> contains (ILIKE on most Superset backends).
+                query["filters"] = [
+                    {
+                        "col": "dashboard_title",
+                        "opr": "ct",
+                        "value": normalized_search,
+                    }
+                ]
+
+            total_count, dashboards = self.get_dashboards_page(query=query)
+
+            result = []
+            for dash in dashboards:
+                owners = self._extract_owner_labels(dash.get("owners"))
+                if not owners:
+                    owners = self._extract_owner_labels(
+                        [dash.get("created_by"), dash.get("changed_by")],
+                    )
+
+                result.append({
+                    "id": dash.get("id"),
+                    "title": dash.get("dashboard_title"),
+                    "last_modified": dash.get("changed_on_utc"),
+                    "status": "published" if dash.get("published") else "draft",
+                    "created_by": self._extract_user_display(
+                        None,
+                        dash.get("created_by"),
+                    ),
+                    "modified_by": self._extract_user_display(
+                        dash.get("changed_by_name"),
+                        dash.get("changed_by"),
+                    ),
+                    "owners": owners,
+                })
+
+            return total_count, result
+    # [/DEF:get_dashboards_summary_page:Function]
+
     # [DEF:_extract_owner_labels:Function]
     # @PURPOSE: Normalize dashboard owners payload to stable display labels.
     # @PRE: owners payload can be scalar, object or list.