homeio

1import { Preferences } from "@capacitor/preferences";
2
3/**
4 * A Homeio server the user has added. We persist the reachable address and an
5 * optional username for convenience. We deliberately do NOT persist passwords:
6 * the user authenticates on the server's own first-party `/login` page (where
7 * the device password manager can offer to save it). Silent auto-login is a
8 * documented Phase 2 enhancement (see doc/modules/mobile-app.md).
9 */
10export type SavedServer = {
11  id: string;
12  label: string;
13  /** Normalized origin, e.g. "http://homeio.tailnet-name.ts.net:3000". */
14  address: string;
15  username?: string;
16  lastConnectedAt?: number;
17};
18
19const SERVERS_KEY = "homeio.servers";
20
21export async function loadServers(): Promise<SavedServer[]> {
22  const { value } = await Preferences.get({ key: SERVERS_KEY });
23  if (!value) return [];
24  try {
25    const parsed = JSON.parse(value) as unknown;
26    if (!Array.isArray(parsed)) return [];
27    return parsed.filter(isSavedServer);
28  } catch {
29    return [];
30  }
31}
32
33async function saveServers(servers: SavedServer[]): Promise<void> {
34  await Preferences.set({ key: SERVERS_KEY, value: JSON.stringify(servers) });
35}
36
37export async function upsertServer(server: SavedServer): Promise<SavedServer[]> {
38  const servers = await loadServers();
39  const existingIndex = servers.findIndex(
40    (s) => s.id === server.id || s.address === server.address,
41  );
42  if (existingIndex >= 0) {
43    servers[existingIndex] = { ...servers[existingIndex], ...server };
44  } else {
45    servers.push(server);
46  }
47  await saveServers(servers);
48  return servers;
49}
50
51export async function removeServer(id: string): Promise<SavedServer[]> {
52  const servers = (await loadServers()).filter((s) => s.id !== id);
53  await saveServers(servers);
54  return servers;
55}
56
57export async function markConnected(id: string): Promise<void> {
58  const servers = await loadServers();
59  const server = servers.find((s) => s.id === id);
60  if (!server) return;
61  server.lastConnectedAt = Date.now();
62  await saveServers(servers);
63}
64
65export function newServerId(): string {
66  return `srv_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
67}
68
69function isSavedServer(value: unknown): value is SavedServer {
70  return (
71    typeof value === "object" &&
72    value !== null &&
73    typeof (value as SavedServer).id === "string" &&
74    typeof (value as SavedServer).address === "string"
75  );
76}
77