homeio

1/**
2 * Address normalization + reachability probing for the Connect screen.
3 *
4 * The probe hits the server's existing unauthenticated `GET /api/health`
5 * endpoint so we can show a clear "can't reach server" error instead of
6 * navigating the WebView into a blank page.
7 */
8
9const DEFAULT_PORT = "3000";
10
11export type NormalizeResult =
12  | { ok: true; origin: string; host: string }
13  | { ok: false; error: string };
14
15/**
16 * Accepts forms like:
17 *   homeio.tailnet-name.ts.net
18 *   homeio.tailnet-name.ts.net:3000
19 *   100.101.102.103
20 *   http://100.101.102.103:3000
21 * and returns a normalized origin ("scheme://host:port", no trailing slash).
22 */
23export function normalizeAddress(raw: string): NormalizeResult {
24  const trimmed = raw.trim();
25  if (!trimmed) return { ok: false, error: "Enter a server address." };
26
27  const withScheme = /^https?:\/\//i.test(trimmed) ? trimmed : `http://${trimmed}`;
28
29  let url: URL;
30  try {
31    url = new URL(withScheme);
32  } catch {
33    return { ok: false, error: "That doesn't look like a valid address." };
34  }
35
36  if (!url.hostname) return { ok: false, error: "Missing host in address." };
37  if (!url.port && url.protocol === "http:") url.port = DEFAULT_PORT;
38
39  // Strip any path/query the user may have pasted — we want the origin only.
40  const origin = `${url.protocol}//${url.host}`;
41  return { ok: true, origin, host: url.host };
42}
43
44export type ProbeResult =
45  | { ok: true }
46  | { ok: false; error: string };
47
48/**
49 * Probe `<origin>/api/health`. A reachable Homeio server answers 200.
50 * Network failures almost always mean Tailscale isn't connected / the address
51 * is wrong, so we surface a Tailscale-aware hint.
52 */
53export async function probeServer(
54  origin: string,
55  timeoutMs = 6000,
56): Promise<ProbeResult> {
57  const controller = new AbortController();
58  const timer = setTimeout(() => controller.abort(), timeoutMs);
59  try {
60    const res = await fetch(`${origin}/api/health`, {
61      method: "GET",
62      signal: controller.signal,
63      // We only need reachability + status; we don't read cookies here.
64      cache: "no-store",
65    });
66    if (res.ok) return { ok: true };
67    return {
68      ok: false,
69      error: `Server responded with ${res.status}. Is this a Homeio server?`,
70    };
71  } catch (err) {
72    if (err instanceof DOMException && err.name === "AbortError") {
73      return { ok: false, error: "Timed out reaching the server." };
74    }
75    return {
76      ok: false,
77      error:
78        "Couldn't reach the server. Make sure the Tailscale app is connected " +
79        "and the address is correct.",
80    };
81  } finally {
82    clearTimeout(timer);
83  }
84}
85