homeio

1import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
3const { siMock, readFileMock } = vi.hoisted(() => ({
4  siMock: {
5    networkInterfaces: vi.fn(),
6    networkStats: vi.fn(),
7    networkGatewayDefault: vi.fn(),
8  },
9  readFileMock: vi.fn(),
10}));
11
12vi.mock("systeminformation", () => ({ default: siMock }));
13vi.mock("node:fs/promises", () => ({ readFile: readFileMock }));
14vi.mock("@/lib/server/modules/system/update-service", () => ({ isContainerRuntime: () => false }));
15
16import { getNetworkOverview, parseNameservers } from "@/lib/server/modules/network/overview-service";
17
18function iface(name: string, extra: Record<string, unknown> = {}) {
19  return { iface: name, internal: false, operstate: "up", type: "wired", ip4: "", mac: "", speed: -1, default: false, dhcp: false, ...extra };
20}
21
22describe("network overview", () => {
23  let minute = 0;
24
25  beforeEach(() => {
26    // A minute apart per test, so the service's 2 s cache never carries over.
27    vi.useFakeTimers();
28    minute += 1;
29    vi.setSystemTime(Date.UTC(2026, 8, 27, 12, minute));
30    siMock.networkInterfaces.mockReset();
31    siMock.networkStats.mockReset();
32    siMock.networkGatewayDefault.mockReset();
33    readFileMock.mockReset();
34  });
35
36  afterEach(() => {
37    vi.useRealTimers();
38  });
39
40  it("lists real interfaces with their traffic, default first, and hides container plumbing", async () => {
41    siMock.networkInterfaces.mockResolvedValue([
42      iface("lo", { internal: true }),
43      iface("docker0"),
44      iface("veth12ab"),
45      iface("br-5f2c"),
46      iface("wlan0", { type: "wireless", operstate: "down" }),
47      iface("tailscale0", { type: "virtual", ip4: "100.113.171.79" }),
48      iface("eth0", { default: true, ip4: "192.168.1.43", ip4subnet: "255.255.255.0", mac: "aa:bb", speed: 1000, duplex: "full", dhcp: true }),
49    ]);
50    siMock.networkStats.mockResolvedValue([
51      { iface: "eth0", rx_bytes: 5_000_000, tx_bytes: 1_000_000, rx_sec: 125_000, tx_sec: 12_500, rx_errors: 0, tx_errors: 2, rx_dropped: 0, tx_dropped: 0 },
52      { iface: "tailscale0", rx_bytes: 10, tx_bytes: 20, rx_sec: null, tx_sec: -1, rx_errors: 0, tx_errors: 0, rx_dropped: 0, tx_dropped: 0 },
53    ]);
54    siMock.networkGatewayDefault.mockResolvedValue("192.168.1.1");
55    readFileMock.mockImplementation(async (file: string) => {
56      if (file === "/run/systemd/resolve/resolv.conf") return "nameserver 1.1.1.1\nnameserver 9.9.9.9\n";
57      return "nameserver 127.0.0.53\n";
58    });
59
60    const overview = await getNetworkOverview();
61
62    expect(overview.interfaces.map((i) => [i.iface, i.kind, i.up])).toEqual([
63      ["eth0", "wired", true],
64      ["tailscale0", "vpn", true],
65      ["wlan0", "wireless", false],
66    ]);
67    const eth0 = overview.interfaces[0];
68    expect(eth0).toMatchObject({
69      isDefault: true,
70      ip4: "192.168.1.43",
71      speedMbps: 1000,
72      dhcp: true,
73      rxBytes: 5_000_000,
74      downloadMbps: 1,
75      uploadMbps: 0.1,
76      txErrors: 2,
77    });
78    expect(overview.interfaces[1]).toMatchObject({ downloadMbps: null, uploadMbps: null, ip4: "100.113.171.79" });
79    expect(overview.gateway).toBe("192.168.1.1");
80    expect(overview.inContainer).toBe(false);
81    expect(overview.dnsServers).toEqual(["1.1.1.1", "9.9.9.9"]);
82  });
83
84  it("falls back to /etc/resolv.conf and reports no gateway as null", async () => {
85    siMock.networkInterfaces.mockResolvedValue([iface("en0", { default: true })]);
86    siMock.networkStats.mockResolvedValue([]);
87    siMock.networkGatewayDefault.mockResolvedValue("");
88    readFileMock.mockImplementation(async (file: string) => {
89      if (file === "/run/systemd/resolve/resolv.conf") throw new Error("ENOENT");
90      return "# generated\nnameserver 192.168.1.1\n";
91    });
92
93    const overview = await getNetworkOverview();
94
95    expect(overview.gateway).toBeNull();
96    expect(overview.dnsServers).toEqual(["192.168.1.1"]);
97    expect(overview.interfaces[0]).toMatchObject({ iface: "en0", rxBytes: null, downloadMbps: null });
98  });
99
100  it("reads nameserver lines once each", () => {
101    expect(parseNameservers("search lan\nnameserver 1.1.1.1\n  nameserver 1.1.1.1\nnameserver ::1\n")).toEqual([
102      "1.1.1.1",
103      "::1",
104    ]);
105  });
106});
107