feat: most used apps hook

src/api/apps.ts

@@ -2,7 +2,11 @@ import { App, UUID } from '@graasp/sdk';
 
 import { PartialQueryConfigForApi } from '../types.js';
 import { verifyAuthentication } from './axios.js';
-import { buildAppListRoute, buildGetApiAccessTokenRoute } from './routes.js';
+import {
+  buildAppListRoute,
+  buildGetApiAccessTokenRoute,
+  buildMostUsedAppListRoute,
+} from './routes.js';
 
 export const getApps = async ({ API_HOST, axios }: PartialQueryConfigForApi) =>
   verifyAuthentication(() =>
@@ -11,6 +15,18 @@ export const getApps = async ({ API_HOST, axios }: PartialQueryConfigForApi) =>
       .then(({ data }) => data),
   );
 
+export const getMostUsedApps = async ({
+  API_HOST,
+  axios,
+}: PartialQueryConfigForApi) =>
+  verifyAuthentication(() =>
+    axios
+      .get<
+        { url: string; name: string; count: number }[]
+      >(`${API_HOST}/${buildMostUsedAppListRoute}`)
+      .then(({ data }) => data),
+  );
+
 export const requestApiAccessToken = async (
   args: {
     id: UUID;

src/api/routes.ts

@@ -32,6 +32,7 @@ export const CATEGORIES_ROUTE = `${ITEMS_ROUTE}/categories`;
 export const ETHERPAD_ROUTE = `${ITEMS_ROUTE}/etherpad`;
 export const COLLECTIONS_ROUTE = `collections`;
 export const buildAppListRoute = `${APPS_ROUTE}/list`;
+export const buildMostUsedAppListRoute = `${APPS_ROUTE}/most-used`;
 export const SHORT_LINKS_ROUTE = `${ITEMS_ROUTE}/short-links`;
 export const SHORT_LINKS_LIST_ROUTE = `${SHORT_LINKS_ROUTE}/list`;
 export const EMBEDDED_LINKS_ROUTE = `${ITEMS_ROUTE}/embedded-links/metadata`;

src/config/keys.ts

@@ -245,6 +245,9 @@ export const memberKeys = {
 
       // subscription plan for the current member
       subscription: [...currentBaseKey, 'subscription'] as const,
+
+      // apps used mostly by the member
+      mostUsedApps: [...currentBaseKey, 'mostUsedApps'] as const,
     };
   },
 };

src/hooks/apps.ts

@@ -2,7 +2,7 @@ import { useQuery } from '@tanstack/react-query';
 
 import * as Api from '../api/apps.js';
 import { CONSTANT_KEY_STALE_TIME_MILLISECONDS } from '../config/constants.js';
-import { APPS_KEY } from '../config/keys.js';
+import { APPS_KEY, memberKeys } from '../config/keys.js';
 import { QueryClientConfig } from '../types.js';
 
 export default (queryConfig: QueryClientConfig) => {
@@ -16,5 +16,11 @@ export default (queryConfig: QueryClientConfig) => {
         ...defaultQueryOptions,
         staleTime: CONSTANT_KEY_STALE_TIME_MILLISECONDS,
       }),
+    useMostUsedApps: () =>
+      useQuery({
+        queryKey: memberKeys.current().mostUsedApps,
+        queryFn: () => Api.getMostUsedApps(queryConfig),
+        ...defaultQueryOptions,
+      }),
   };
 };