feat: add issueExtraDetails fetch

Part of #870

dashboard/src/api/issueExtras.ts

@@ -0,0 +1,72 @@
+import { useQuery, type UseQueryResult } from '@tanstack/react-query';
+
+import type {
+  IssueExtraDetailsResponse,
+  IssueKeyList,
+} from '@/types/issueExtras';
+
+import type { TIssue } from '@/types/issues';
+
+import { RequestData } from './commonRequest';
+
+const fetchIssueExtraDetailsData = async (
+  issueKeyList?: IssueKeyList,
+): Promise<IssueExtraDetailsResponse> => {
+  const body = {
+    issues: issueKeyList,
+  };
+
+  const data = await RequestData.post<IssueExtraDetailsResponse>(
+    `/api/issue/extras/`,
+    body,
+  );
+
+  return data;
+};
+
+export interface ITabsIssues {
+  buildIssues?: TIssue[];
+  bootIssues?: TIssue[];
+  testIssues?: TIssue[];
+}
+
+const makeIssueKeyList = ({
+  buildIssues,
+  bootIssues,
+  testIssues,
+}: ITabsIssues): IssueKeyList => {
+  const result: IssueKeyList = [];
+
+  buildIssues?.forEach(issue => {
+    result.push([issue.id, issue.version]);
+  });
+  bootIssues?.forEach(issue => {
+    result.push([issue.id, issue.version]);
+  });
+  testIssues?.forEach(issue => {
+    result.push([issue.id, issue.version]);
+  });
+
+  return result;
+};
+
+export const useIssueExtraDetails = ({
+  buildIssues,
+  bootIssues,
+  testIssues,
+  enabled = true,
+}: ITabsIssues & {
+  enabled: boolean;
+}): UseQueryResult<IssueExtraDetailsResponse> => {
+  const issueKeyList = makeIssueKeyList({
+    buildIssues,
+    bootIssues,
+    testIssues,
+  });
+
+  return useQuery({
+    queryKey: ['issueExtraData', issueKeyList],
+    queryFn: () => fetchIssueExtraDetailsData(issueKeyList),
+    enabled,
+  });
+};

dashboard/src/types/general.ts

@@ -37,18 +37,24 @@ interface IEnvironmentMisc {
   platform?: string;
 }
 
-export type TestHistory = {
+export type TreeBranchItem = {
+  tree_name?: string;
+  git_repository_branch?: string;
+};
+
+export type TestHistory = TreeBranchItem & {
   start_time: string;
   status: Status;
   path: string;
   id: string;
   duration?: number;
   environment_compatible?: string[];
   environment_misc?: IEnvironmentMisc;
-  tree_name?: string;
-  git_repository_branch?: string;
 };
 
+/**
+ * @deprecated Use a more generic approach to the misc field.
+ */
 interface ITreeDetailsMisc {
   kernel_type?: string;
   dtb?: string;

dashboard/src/types/issueExtras.ts

@@ -0,0 +1,21 @@
+import type { TreeBranchItem } from './general';
+import type { IssueKeys } from './issues';
+
+type PossibleIssueTags = 'mainline' | 'stable' | 'linux-next';
+
+type TIssueExtraDetails = IssueKeys & {
+  first_seen?: Date;
+  trees?: TreeBranchItem[];
+  tags?: PossibleIssueTags[];
+};
+
+export type IssueKeyList = [string, number][];
+
+export type IssueExtraDetailsDict = Record<
+  string,
+  Record<number, TIssueExtraDetails>
+>;
+
+export type IssueExtraDetailsResponse = {
+  issues: IssueExtraDetailsDict;
+};