homeio

1import { beforeEach, describe, expect, it, vi } from "vitest";
2import { mkdtemp, rm, writeFile } from "node:fs/promises";
3import os from "node:os";
4import path from "node:path";
5
6vi.mock("@/lib/server/modules/store/catalog", () => ({
7  findStoreCatalogTemplateByAppId: vi.fn(),
8  getStoreCatalogSnapshot: vi.fn(),
9}));
10
11vi.mock("@/lib/server/modules/store/custom-apps", () => ({
12  findCustomStoreTemplateByAppId: vi.fn(),
13  listCustomStoreTemplates: vi.fn(),
14}));
15
16vi.mock("@/lib/server/modules/apps/stacks-repository", () => ({
17  findInstalledStackByAppId: vi.fn(),
18  listInstalledStacksFromDb: vi.fn(),
19  patchInstalledStackMeta: vi.fn(),
20}));
21
22vi.mock("@/lib/server/modules/apps/operations", () => ({
23  startStoreOperation: vi.fn(),
24}));
25
26import {
27  findStoreCatalogTemplateByAppId,
28  getStoreCatalogSnapshot,
29} from "@/lib/server/modules/store/catalog";
30import {
31  findCustomStoreTemplateByAppId,
32  listCustomStoreTemplates,
33} from "@/lib/server/modules/store/custom-apps";
34import { startStoreOperation } from "@/lib/server/modules/apps/operations";
35import {
36  findInstalledStackByAppId,
37  listInstalledStacksFromDb,
38} from "@/lib/server/modules/apps/stacks-repository";
39import {
40  getStoreAppDetail,
41  getStoreCatalogView,
42  startAppLifecycleAction,
43} from "@/lib/server/modules/store/service";
44
45function createCatalogApp(overrides: Partial<Awaited<ReturnType<typeof getStoreCatalogSnapshot>>["apps"][number]> = {}) {
46  return {
47    appId: "adguard-home",
48    templateName: "adguard-home",
49    name: "AdGuard Home",
50    description: "DNS",
51    platform: "Docker Compose",
52    note: "note",
53    categories: ["Network"],
54    logoUrl: null,
55    repositoryUrl: "https://github.com/IceWhaleTech/CasaOS-AppStore",
56    stackFile: "Apps/AdGuardHome/docker-compose.yml",
57    composePath: "/tmp/CasaOS-AppStore/Apps/AdGuardHome/docker-compose.yml",
58    env: [],
59    screenshots: [],
60    image: "adguard/adguardhome:v1",
61    volumes: [],
62    port: 3001,
63    scheme: "http",
64    index: "/",
65    mainServiceName: "adguard-home",
66    sourceId: "official-casaos",
67    sourceName: "Official CasaOS",
68    sourceKind: "official" as const,
69    ...overrides,
70  };
71}
72
73function createInstalledStack(overrides: Partial<Awaited<ReturnType<typeof listInstalledStacksFromDb>>[number]> = {}) {
74  return {
75    appId: "adguard-home",
76    templateName: "adguard-home",
77    stackName: "adguard-home",
78    composePath: "/tmp/compose.yml",
79    status: "installed" as const,
80    webUiPort: 3001,
81    webUiUrl: null,
82    tunnelSubdomain: null,
83    env: {},
84    displayName: null,
85    iconUrl: null,
86    installedAt: "2026-02-23T00:00:00.000Z",
87    updatedAt: "2026-02-23T00:00:00.000Z",
88    isUpToDate: true,
89    lastUpdateCheck: null,
90    localDigest: "sha256:aaa",
91    remoteDigest: "sha256:aaa",
92    ...overrides,
93  };
94}
95
96describe("store service", () => {
97  beforeEach(() => {
98    vi.mocked(findStoreCatalogTemplateByAppId).mockReset();
99    vi.mocked(getStoreCatalogSnapshot).mockReset();
100    vi.mocked(findCustomStoreTemplateByAppId).mockReset();
101    vi.mocked(listCustomStoreTemplates).mockReset();
102    vi.mocked(findInstalledStackByAppId).mockReset();
103    vi.mocked(listInstalledStacksFromDb).mockReset();
104    vi.mocked(startStoreOperation).mockReset();
105    vi.mocked(listCustomStoreTemplates).mockResolvedValue([]);
106    vi.mocked(findCustomStoreTemplateByAppId).mockResolvedValue(null);
107    vi.mocked(getStoreCatalogSnapshot).mockResolvedValue({
108      apps: [createCatalogApp()],
109      categories: [{ id: "network", name: "Network", description: "Network apps", appCount: 1 }],
110      featuredAppIds: ["adguard-home"],
111      recommendedAppIds: ["adguard-home"],
112      sourcePath: "/DATA/AppStore/CasaOS-AppStore",
113      sources: [
114        {
115          id: "official-casaos",
116          name: "Official CasaOS",
117          url: "https://github.com/IceWhaleTech/CasaOS-AppStore",
118          kind: "official",
119          enabled: true,
120          status: "ready",
121          sourcePath: "/DATA/AppStore/CasaOS-AppStore",
122          suppressedAppIds: [],
123          addedAt: "2026-02-23T00:00:00.000Z",
124          updatedAt: "2026-02-23T00:00:00.000Z",
125          lastSyncedAt: "2026-02-23T00:00:00.000Z",
126          lastError: null,
127        },
128      ],
129    });
130  });
131
132  it("merges catalog with installed stack state and exposes catalog meta", async () => {
133    const tempDir = await mkdtemp(path.join(os.tmpdir(), "store-service-installed-image-"));
134    const composePath = path.join(tempDir, "docker-compose.yml");
135    await writeFile(
136      composePath,
137      "services:\n  adguard-home:\n    image: adguard/adguardhome:v0.107.0\n",
138      "utf8",
139    );
140    vi.mocked(listInstalledStacksFromDb).mockResolvedValueOnce([
141      createInstalledStack({ composePath }),
142    ]);
143    vi.mocked(getStoreCatalogSnapshot).mockResolvedValueOnce({
144      apps: [
145        createCatalogApp({
146          description: "A".repeat(400),
147        }),
148      ],
149      categories: [{ id: "network", name: "Network", description: "Network apps", appCount: 1 }],
150      featuredAppIds: ["adguard-home"],
151      recommendedAppIds: ["adguard-home"],
152      sourcePath: "/DATA/AppStore/CasaOS-AppStore",
153      sources: [],
154    });
155
156    const result = await getStoreCatalogView({ installedOnly: true });
157
158    expect(result.apps).toEqual([
159      expect.objectContaining({
160        id: "adguard-home",
161        status: "installed",
162        webUiPort: 3001,
163        updateAvailable: false,
164        installedImage: "adguard/adguardhome:v0.107.0",
165        description: `${"A".repeat(219)}…`,
166      }),
167    ]);
168    expect(result.categories[0]?.name).toBe("Network");
169    expect(result.featuredAppIds).toContain("adguard-home");
170    await rm(tempDir, { recursive: true, force: true });
171  });
172
173  it("returns detail or null", async () => {
174    vi.mocked(findStoreCatalogTemplateByAppId).mockResolvedValueOnce(createCatalogApp({ appId: "homepage", templateName: "homepage", name: "Homepage" }));
175    vi.mocked(findInstalledStackByAppId).mockResolvedValueOnce(null);
176
177    const detail = await getStoreAppDetail("homepage");
178    expect(detail?.id).toBe("homepage");
179    expect(detail?.description).toBe("DNS");
180    expect(detail?.screenshots).toEqual([]);
181
182    vi.mocked(findStoreCatalogTemplateByAppId).mockResolvedValueOnce(null);
183    const missing = await getStoreAppDetail("missing");
184    expect(missing).toBeNull();
185  });
186
187  it("proxies lifecycle action start", async () => {
188    vi.mocked(startStoreOperation).mockResolvedValueOnce({
189      operationId: "11111111-1111-1111-1111-111111111111",
190    });
191
192    const result = await startAppLifecycleAction({
193      appId: "homepage",
194      action: "redeploy",
195      webUiPort: 3100,
196    });
197
198    expect(result).toEqual({
199      operationId: "11111111-1111-1111-1111-111111111111",
200    });
201    expect(startStoreOperation).toHaveBeenCalledWith({
202      appId: "homepage",
203      action: "redeploy",
204      displayName: undefined,
205      env: undefined,
206      webUiPort: 3100,
207      composeSource: undefined,
208      removeVolumes: undefined,
209      resetToCatalog: undefined,
210    });
211  });
212});
213