homeio

1import { describe, expect, it, vi } from "vitest";
2
3vi.mock("server-only", () => ({}));
4
5import {
6  buildTunnelUrl,
7  resolveOriginHost,
8  toSubdomain,
9} from "@/lib/server/modules/integrations/cloudflare-tunnel-exposure";
10
11describe("cloudflare tunnel exposure", () => {
12  it("turns app names into DNS labels", () => {
13    expect(toSubdomain("Home Assistant")).toBe("home-assistant");
14    expect(toSubdomain("  Nextcloud!  ")).toBe("nextcloud");
15    expect(toSubdomain("2FAuth")).toBe("2fauth");
16    expect(toSubdomain("--weird--name--")).toBe("weird-name");
17    expect(toSubdomain("-")).toBe("");
18    expect(toSubdomain("!!!")).toBe("");
19    expect(toSubdomain("-".repeat(50_000) + "x")).toBe("x");
20  });
21
22  it("keeps labels within the 63 character DNS limit", () => {
23    expect(toSubdomain("a".repeat(100))).toHaveLength(63);
24  });
25
26  it("builds the public address without a port", () => {
27    // A tunnel serves on 443, so appending the app's port would break the link.
28    expect(buildTunnelUrl("jellyfin", "example.com")).toBe("https://jellyfin.example.com");
29  });
30
31  it("has no address until both parts are known", () => {
32    expect(buildTunnelUrl("", "example.com")).toBeNull();
33    expect(buildTunnelUrl("jellyfin", "")).toBeNull();
34  });
35
36  it("prefers a reachable address over localhost for the tunnel origin", () => {
37    // A connector on another machine resolves localhost to itself and answers
38    // 502, so the origin has to be an address every connector can reach.
39    expect(resolveOriginHost()).not.toBe("localhost");
40  });
41
42  it("lets the operator override the origin host", () => {
43    const previous = process.env.HOMEIO_TUNNEL_ORIGIN_HOST;
44    process.env.HOMEIO_TUNNEL_ORIGIN_HOST = "10.0.0.5";
45    try {
46      expect(resolveOriginHost()).toBe("10.0.0.5");
47    } finally {
48      if (previous === undefined) delete process.env.HOMEIO_TUNNEL_ORIGIN_HOST;
49      else process.env.HOMEIO_TUNNEL_ORIGIN_HOST = previous;
50    }
51  });
52});
53