homeio

1import { describe, expectTypeOf, it } from "vitest";
2import type {
3  DockerPullProgressDetail,
4  InstalledApp,
5  InstalledStackConfig,
6  StoreAppDetail,
7  StoreAppSummary,
8  StoreOperation,
9  StoreOperationEvent,
10} from "@/lib/shared/contracts/apps";
11import type {
12  CreateLocalFolderShareRequest,
13  CreateNetworkShareRequest,
14  DiscoverServersResponse,
15  DiscoverSharesRequest,
16  DiscoverSharesResponse,
17  FileListEntry,
18  FileReadResponse,
19  FileServiceErrorCode,
20  NetworkShare,
21  NetworkShareStatus,
22  TrashMoveRequest,
23  TrashMoveResponse,
24  TrashRestoreRequest,
25  TrashRestoreResponse,
26  FileWriteRequest,
27  FileWriteResponse,
28  LocalFolderShareStatus,
29} from "@/lib/shared/contracts/files";
30import type { SystemMetricsSnapshot } from "@/lib/shared/contracts/system";
31import type { WeatherSnapshot } from "@/lib/shared/contracts/weather";
32import type {
33  ConnectNetworkRequest,
34  NetworkEvent,
35  NetworkStatus,
36  WifiAccessPoint,
37} from "@/lib/shared/contracts/network";
38import type {
39  TerminalExecuteRequest,
40  TerminalExecuteResult,
41} from "@/lib/shared/contracts/terminal";
42
43describe("shared contracts", () => {
44  it("exposes typed runtime contracts", () => {
45    expectTypeOf<InstalledApp>().toMatchTypeOf<{
46      id: string;
47      name: string;
48      status: "running" | "paused" | "stopped" | "unknown";
49      activeOperation:
50        | {
51            action:
52              | "install"
53              | "update"
54              | "redeploy"
55              | "uninstall"
56              | "start"
57              | "stop"
58              | "restart"
59              | "check-updates";
60          }
61        | null
62        | undefined;
63      updatedAt: string;
64    }>();
65
66    expectTypeOf<StoreAppSummary>().toMatchTypeOf<{
67      id: string;
68      platform: string;
69      status:
70        | "installed"
71        | "not_installed"
72        | "installing"
73        | "error"
74        | "updating"
75        | "uninstalling";
76      webUiPort: number | null;
77      updateAvailable: boolean;
78      localDigest: string | null;
79      remoteDigest: string | null;
80    }>();
81
82    expectTypeOf<StoreAppDetail>().toMatchTypeOf<{
83      env: Array<{
84        name: string;
85      }>;
86      installedConfig: InstalledStackConfig | null;
87    }>();
88
89    expectTypeOf<DockerPullProgressDetail>().toMatchTypeOf<{
90      current: number;
91      total: number;
92      percent: number | null;
93    }>();
94
95    expectTypeOf<StoreOperation>().toMatchTypeOf<{
96      id: string;
97      action:
98        | "install"
99        | "update"
100        | "redeploy"
101        | "uninstall"
102        | "start"
103        | "stop"
104        | "restart"
105        | "check-updates";
106      status: "queued" | "running" | "success" | "error";
107      progressPercent: number;
108    }>();
109
110    expectTypeOf<StoreOperationEvent>().toMatchTypeOf<{
111      type:
112        | "operation.started"
113        | "operation.step"
114        | "operation.pull.progress"
115        | "operation.completed"
116        | "operation.failed";
117      operationId: string;
118      step: string;
119    }>();
120
121    expectTypeOf<SystemMetricsSnapshot>().toMatchTypeOf<{
122      timestamp: string;
123      hostname: string;
124      platform: string;
125      uptimeSeconds: number;
126      temperature: {
127        mainCelsius: number | null;
128      };
129      battery: {
130        hasBattery: boolean;
131      };
132      wifi: {
133        connected: boolean;
134      };
135    }>();
136
137    expectTypeOf<WeatherSnapshot>().toMatchTypeOf<{
138      source: "navigator";
139      location: {
140        label: string;
141      };
142      current: {
143        condition: string;
144      };
145    }>();
146
147    expectTypeOf<NetworkStatus>().toMatchTypeOf<{
148      connected: boolean;
149      iface: string | null;
150      ssid: string | null;
151      ipv4: string | null;
152      signalPercent: number | null;
153    }>();
154
155    expectTypeOf<WifiAccessPoint>().toMatchTypeOf<{
156      ssid: string;
157      bssid: string | null;
158      security: string | null;
159    }>();
160
161    expectTypeOf<ConnectNetworkRequest>().toMatchTypeOf<{
162      ssid: string;
163      password?: string;
164    }>();
165
166    expectTypeOf<NetworkEvent>().toMatchTypeOf<{
167      type: "network.connection.changed" | "network.device.state.changed";
168      connected: boolean;
169      timestamp: string;
170    }>();
171
172    expectTypeOf<TerminalExecuteRequest>().toMatchTypeOf<{
173      command: string;
174      cwd?: string;
175      history?: string[];
176    }>();
177
178    expectTypeOf<TerminalExecuteResult>().toMatchTypeOf<{
179      cwd: string;
180      lines: Array<{
181        type: "output" | "error" | "info";
182        content: string;
183      }>;
184      exitCode: number | null;
185    }>();
186
187    expectTypeOf<FileListEntry>().toMatchTypeOf<{
188      path: string;
189      type: "folder" | "file";
190      sizeBytes: number | null;
191    }>();
192
193    expectTypeOf<FileReadResponse>().toMatchTypeOf<{
194      mode: "text" | "image" | "pdf" | "binary_unsupported" | "too_large";
195      content: string | null;
196      mimeType: string | null;
197    }>();
198
199    expectTypeOf<FileWriteRequest>().toMatchTypeOf<{
200      path: string;
201      content: string;
202      expectedMtimeMs?: number;
203    }>();
204
205    expectTypeOf<FileWriteResponse>().toMatchTypeOf<{
206      sizeBytes: number;
207      modifiedAt: string;
208      mtimeMs: number;
209    }>();
210
211    expectTypeOf<NetworkShare>().toMatchTypeOf<{
212      id: string;
213      host: string;
214      share: string;
215      username: string;
216      mountPath: string;
217    }>();
218
219    expectTypeOf<NetworkShareStatus>().toMatchTypeOf<{
220      isMounted: boolean;
221    }>();
222
223    expectTypeOf<CreateNetworkShareRequest>().toMatchTypeOf<{
224      host: string;
225      share: string;
226      username: string;
227      password: string;
228    }>();
229
230    expectTypeOf<CreateLocalFolderShareRequest>().toMatchTypeOf<{
231      path: string;
232      name?: string;
233    }>();
234
235    expectTypeOf<LocalFolderShareStatus>().toMatchTypeOf<{
236      id: string;
237      shareName: string;
238      sourcePath: string;
239      sharedPath: string;
240      isMounted: boolean;
241      isExported: boolean;
242    }>();
243
244    expectTypeOf<DiscoverServersResponse>().toMatchTypeOf<{
245      servers: string[];
246    }>();
247
248    expectTypeOf<DiscoverSharesRequest>().toMatchTypeOf<{
249      host: string;
250      username: string;
251      password: string;
252    }>();
253
254    expectTypeOf<DiscoverSharesResponse>().toMatchTypeOf<{
255      shares: string[];
256    }>();
257
258    expectTypeOf<TrashMoveRequest>().toMatchTypeOf<{
259      path: string;
260    }>();
261
262    expectTypeOf<TrashMoveResponse>().toMatchTypeOf<{
263      trashPath: string;
264      originalPath: string;
265    }>();
266
267    expectTypeOf<TrashRestoreRequest>().toMatchTypeOf<{
268      path: string;
269      collision?: "keep-both" | "replace" | "fail";
270    }>();
271
272    expectTypeOf<TrashRestoreResponse>().toMatchTypeOf<{
273      restoredPath: string;
274      sourceTrashPath: string;
275    }>();
276
277    expectTypeOf<FileServiceErrorCode>().toMatchTypeOf<
278      | "invalid_path"
279      | "path_outside_root"
280      | "not_found"
281      | "not_a_file"
282      | "not_a_directory"
283      | "hidden_blocked"
284      | "symlink_blocked"
285      | "permission_denied"
286      | "operation_conflict"
287      | "container_not_found"
288      | "unsupported_file"
289      | "payload_too_large"
290      | "write_conflict"
291      | "share_exists"
292      | "share_not_found"
293      | "mount_failed"
294      | "unmount_failed"
295      | "trash_meta_missing"
296      | "destination_exists"
297      | "internal_error"
298    >();
299  });
300});
301