homeio

1import { useQuery } from "@tanstack/react-query";
2import { queryKeys } from "@/lib/shared/query-keys";
3
4export type AppComposeData = {
5  image?: string;
6  ports?: string[];
7  environment?: Record<string, string>;
8  volumes?: string[];
9  networkMode?: string;
10  restart?: string;
11  privileged?: boolean;
12  capAdd?: string[];
13  hostname?: string;
14  devices?: string[];
15  command?: string | string[];
16};
17
18export type AppComposeResponse = {
19  compose: string;
20  primary: AppComposeData;
21  primaryServiceName: string;
22};
23
24const APP_COMPOSE_REQUEST_TIMEOUT_MS = 10_000;
25
26/**
27 * Fetch and parse the docker-compose.yml for an app from its GitHub repository.
28 * Used to pre-fill the app settings dialog with default values.
29 */
30export function useAppCompose(
31  appId: string | undefined,
32  enabled = true,
33  source: "catalog" | "installed" = "catalog",
34) {
35  return useQuery({
36    queryKey: queryKeys.appCompose(appId ?? "", source),
37    queryFn: async () => {
38      if (!appId) throw new Error("App ID is required");
39
40      const controller = new AbortController();
41      const timeout = setTimeout(() => {
42        controller.abort();
43      }, APP_COMPOSE_REQUEST_TIMEOUT_MS);
44
45      let response: Response;
46      try {
47        response = await fetch(
48          `/api/v1/store/apps/${appId}/compose?source=${encodeURIComponent(source)}`,
49          {
50            signal: controller.signal,
51          },
52        );
53      } catch (error) {
54        if (error instanceof Error && error.name === "AbortError") {
55          throw new Error("Failed to fetch compose file (request timeout)");
56        }
57        throw error;
58      } finally {
59        clearTimeout(timeout);
60      }
61
62      if (!response.ok) {
63        const payload = await response.json().catch(() => null) as
64          | { error?: string; code?: string }
65          | null;
66        const message = payload?.error?.trim() || "Failed to fetch compose file";
67        const code = payload?.code?.trim();
68        throw new Error(code ? `${message} [${code}]` : message);
69      }
70
71      const json = await response.json();
72      return json.data as AppComposeResponse;
73    },
74    enabled: enabled && !!appId,
75    staleTime: 5 * 60 * 1000, // 5 minutes
76  });
77}
78