feat: add hardware tree selection flow on the frontend

Author: Gustavo Flores

dashboard/src/api/hardware.ts

@@ -5,7 +5,8 @@ import { useSearch } from '@tanstack/react-router';
 
 import type {
   HardwareListingResponse,
-  HardwareListingResponseV2,
+  HardwareRevisionSelection,
+  HardwareSelectorsResponse,
 } from '@/types/hardware';
 
 import type { HardwareListingRoutesMap } from '@/utils/constants/hardwareListing';
@@ -57,17 +58,13 @@ export const useHardwareListing = (
   });
 };
 
-const fetchHardwareListingV2 = async (
+const fetchHardwareSelectors = async (
   origin: string,
-  startTimestampInSeconds: number,
-  endTimestampInSeconds: number,
-): Promise<HardwareListingResponseV2> => {
-  const data = await RequestData.get<HardwareListingResponseV2>(
-    '/api/hardware-v2/',
+): Promise<HardwareSelectorsResponse> => {
+  const data = await RequestData.get<HardwareSelectorsResponse>(
+    '/api/hardware/selectors/',
     {
       params: {
-        startTimestampInSeconds,
-        endTimestampInSeconds,
         origin,
       },
     },
@@ -76,28 +73,68 @@ const fetchHardwareListingV2 = async (
   return data;
 };
 
-export const useHardwareListingV2 = (
-  startTimestampInSeconds: number,
-  endTimestampInSeconds: number,
+export const useHardwareSelectors = (
+  searchFrom: HardwareListingRoutesMap['v2']['search'],
+): UseQueryResult<HardwareSelectorsResponse> => {
+  const { origin } = useSearch({ from: searchFrom });
+
+  return useQuery({
+    queryKey: ['hardwareSelectors', origin],
+    queryFn: () => fetchHardwareSelectors(origin),
+    refetchOnWindowFocus: false,
+  });
+};
+
+const fetchHardwareListingByRevision = async (
+  selection: HardwareRevisionSelection,
+  origin: string,
+): Promise<HardwareListingResponse> => {
+  const data = await RequestData.get<HardwareListingResponse>(
+    '/api/hardware-by-revision/',
+    {
+      params: {
+        origin,
+        tree_name: selection.treeName,
+        git_repository_url: selection.gitRepositoryUrl,
+        git_repository_branch: selection.gitBranch,
+        git_commit_hash: selection.gitCommitHash,
+      },
+    },
+  );
+
+  return data;
+};
+
+export const useHardwareListingByRevision = (
+  selection: HardwareRevisionSelection | null,
   searchFrom: HardwareListingRoutesMap['v2']['search'],
-): UseQueryResult<HardwareListingResponseV2> => {
+): UseQueryResult<HardwareListingResponse> => {
   const { origin } = useSearch({ from: searchFrom });
 
   const queryKey = [
-    'hardwareListingV2',
-    startTimestampInSeconds,
-    endTimestampInSeconds,
+    'hardwareListingByRevision',
     origin,
+    selection?.treeName,
+    selection?.gitRepositoryUrl,
+    selection?.gitBranch,
+    selection?.gitCommitHash,
+    selection,
   ];
 
   return useQuery({
     queryKey,
-    queryFn: () =>
-      fetchHardwareListingV2(
-        origin,
-        startTimestampInSeconds,
-        endTimestampInSeconds,
-      ),
+    queryFn: () => {
+      if (selection === null) {
+        return { hardware: [] };
+      }
+      return fetchHardwareListingByRevision(selection, origin);
+    },
+    enabled: Boolean(
+      selection?.treeName &&
+        selection?.gitRepositoryUrl &&
+        selection?.gitBranch &&
+        selection?.gitCommitHash,
+    ),
     refetchOnWindowFocus: false,
   });
 };

dashboard/src/locales/messages/index.ts

@@ -214,9 +214,20 @@ export const messages = {
     'hardwareDetails.timeFrame':
       'Results from {startDate} and {startTime} to {endDate} {endTime}',
     'hardwareListing.bannerTitle': 'Hardware Listing',
+    'hardwareListing.branchSelectorLabel': 'Branch',
     'hardwareListing.description': 'List of hardware from kernel tests',
     'hardwareListing.notFound': 'No hardware information available',
+    'hardwareListing.revisionCapNote': 'Showing latest 50 revisions',
+    'hardwareListing.revisionEmpty':
+      'The selected revision has no hardware rows yet. Data ingestion may still be in progress.',
+    'hardwareListing.revisionSelectorLabel': 'Revision',
+    'hardwareListing.selectionResetDescription':
+      'The previous tree/branch/revision selection has no qualifying data for the selected origin and was reset to the latest available revision.',
+    'hardwareListing.selectionResetTitle': 'Hardware selection reset',
+    'hardwareListing.selectorsNoData':
+      'No qualifying hardware data is available for the selected origin yet.',
     'hardwareListing.title': 'Hardware Listing ― KCI Dashboard',
+    'hardwareListing.treeSelectorLabel': 'Tree',
     'issue.alsoPresentTooltip': 'Issue also present in {tree}',
     'issue.firstSeen': 'First seen',
     'issue.newIssue': 'New issue: This is the first time this issue was seen',