homeio

1"use client";
2
3import { useQuery } from "@tanstack/react-query";
4import type {
5  StoreAppSummary,
6  StoreCatalogSource,
7} from "@/lib/shared/contracts/apps";
8import { queryKeys } from "@/lib/shared/query-keys";
9
10type StoreCatalogCategory = {
11  id: string;
12  name: string;
13  description: string;
14  appCount: number;
15};
16
17type StoreCatalogResponse = {
18  data: StoreAppSummary[];
19  meta: {
20    count: number;
21    categories: StoreCatalogCategory[];
22    featuredAppIds: string[];
23    recommendedAppIds: string[];
24    sourcePath: string;
25    sources: StoreCatalogSource[];
26  };
27};
28
29export type StoreCatalogResult = {
30  apps: StoreAppSummary[];
31  categories: StoreCatalogCategory[];
32  featuredAppIds: string[];
33  recommendedAppIds: string[];
34  sourcePath: string;
35  sources: StoreCatalogSource[];
36};
37
38type UseStoreCatalogOptions = {
39  category?: string;
40  search?: string;
41  installedOnly?: boolean;
42  updatesOnly?: boolean;
43};
44
45function buildCatalogUrl(options?: UseStoreCatalogOptions) {
46  const params = new URLSearchParams();
47
48  if (options?.category) params.set("category", options.category);
49  if (options?.search) params.set("search", options.search);
50  if (options?.installedOnly) params.set("installedOnly", "true");
51  if (options?.updatesOnly) params.set("updatesOnly", "true");
52
53  const query = params.toString();
54  return query.length > 0 ? `/api/v1/store/apps?${query}` : "/api/v1/store/apps";
55}
56
57async function fetchStoreCatalog(options?: UseStoreCatalogOptions): Promise<StoreCatalogResult> {
58  const endpoint = buildCatalogUrl(options);
59
60  const response = await fetch(endpoint, {
61    cache: "no-store",
62  });
63
64  if (!response.ok) {
65    throw new Error(`Failed to fetch store catalog (${response.status})`);
66  }
67
68  const json = (await response.json()) as StoreCatalogResponse;
69  return {
70    apps: json.data,
71    categories: json.meta.categories,
72    featuredAppIds: json.meta.featuredAppIds,
73    recommendedAppIds: json.meta.recommendedAppIds,
74    sourcePath: json.meta.sourcePath,
75    sources: json.meta.sources,
76  };
77}
78
79export function useStoreCatalog(options?: UseStoreCatalogOptions) {
80  return useQuery({
81    queryKey: [...queryKeys.storeCatalog, options ?? {}] as const,
82    queryFn: () => fetchStoreCatalog(options),
83    staleTime: 60_000,
84    refetchOnMount: false,
85    refetchOnReconnect: false,
86    refetchOnWindowFocus: false,
87    placeholderData: (previousData) => previousData,
88  });
89}
90