// network.js — pure iwd D-Bus (busctl --json) shaping. NO I/O. // Dual-mode: node `require` (tests) + QML import ("network.js" as Network). // Same pattern as audio.js / brightness.js / clip.js. No `.pragma library`. // // iwd exposes a full D-Bus API (net.connman.iwd). `busctl --json=short` emits // structured JSON, so there is NO text/ANSI parsing — we JSON.parse two calls: // ObjectManager.GetManagedObjects -> devices, stations, networks, known nets // Station.GetOrderedNetworks -> [path, signalStrength] strongest-first // Network names arrive already decoded; signal is int dBm*100 (e.g. -6800). // --- busctl JSON helpers --------------------------------------------------- // busctl --json wraps a reply as { "type": "...", "data": [ ] }. // Unwrap to the single payload value. Accepts a raw string or a parsed object. // A failed call (no iwd) leaves empty or non-JSON stdout: that is no data. function unwrap(raw) { if (raw === undefined || raw === null) return null; var obj = raw; if (typeof raw === "string") { if (raw.trim() === "") return null; try { obj = JSON.parse(raw); } catch (e) { return null; } } if (obj && Object.prototype.hasOwnProperty.call(obj, "data") && Array.isArray(obj.data)) { return obj.data.length > 0 ? obj.data[0] : null; } return obj; } // A D-Bus property value is { "type": "x", "data": }. Pull data or fb. function prop(iface, name, fb) { if (iface && iface[name] && iface[name].data !== undefined) return iface[name].data; return fb; } // --- Signal ----------------------------------------------------------------- // signalBars(centiDbm) — iwd reports signal as dBm*100. Map to 0..4 bars using // the same thresholds iwctl itself renders. Non-finite => 0. function signalBars(centiDbm) { var v = Number(centiDbm); if (!isFinite(v)) return 0; if (v >= -6000) return 4; if (v >= -6700) return 3; if (v >= -7400) return 2; return 1; } // dbmFromCenti(centiDbm) — iwd's dBm*100 -> rounded dBm. Non-finite => null. function dbmFromCenti(centiDbm) { var v = Number(centiDbm); if (!isFinite(v)) return null; return Math.round(v / 100); } // --- Parsers (JSON -> plain data) ------------------------------------------ // parseManaged(rawGmo) -> { // devicePath, device:{name,powered,mode}|null, // station:{state,scanning,connectedNetwork}|null, // networks: { : {ssid,security,connected,known} }, // knownBySsid: { : } } // Picks the FIRST station-mode device. function parseManaged(rawGmo) { var d = unwrap(rawGmo) || {}; var out = { devicePath: "", device: null, station: null, networks: {}, knownBySsid: {} }; for (var path in d) { if (!Object.prototype.hasOwnProperty.call(d, path)) continue; var ifaces = d[path]; var dev = ifaces["net.connman.iwd.Device"]; if (dev && prop(dev, "Mode", "") === "station" && out.devicePath === "") { out.devicePath = path; out.device = { name: prop(dev, "Name", ""), powered: !!prop(dev, "Powered", false), mode: "station" }; var st = ifaces["net.connman.iwd.Station"]; if (st) { out.station = { state: prop(st, "State", ""), scanning: !!prop(st, "Scanning", false), connectedNetwork: prop(st, "ConnectedNetwork", "") }; } } var net = ifaces["net.connman.iwd.Network"]; if (net) { out.networks[path] = { ssid: prop(net, "Name", ""), security: prop(net, "Type", ""), connected: !!prop(net, "Connected", false), // iwd exposes a KnownNetwork property ONLY when the net is known. known: Object.prototype.hasOwnProperty.call(net, "KnownNetwork") }; } var kn = ifaces["net.connman.iwd.KnownNetwork"]; if (kn) { var kssid = prop(kn, "Name", ""); if (kssid !== "") out.knownBySsid[kssid] = path; } } return out; } // parseOrdered(rawGon) -> [{ path, signal:centiDbm }] in iwd order (the API // already lists the connected network first, then by descending strength). function parseOrdered(rawGon) { var arr = unwrap(rawGon); var out = []; if (!Array.isArray(arr)) return out; for (var i = 0; i < arr.length; i++) { var pair = arr[i]; if (!Array.isArray(pair) || pair.length < 2) continue; out.push({ path: pair[0], signal: pair[1] }); } return out; } // networkRows(managed, ordered) -> view rows, in iwd order, joining the signal // (from ordered) with name/type/known/connected (from managed). Carries the // D-Bus object `path` so the service can call Connect on the right object. // [{ id, ssid, security, signal:0..4, connected, known, needsPassphrase, path }] function networkRows(managed, ordered) { var nets = (managed && managed.networks) ? managed.networks : {}; var list = Array.isArray(ordered) ? ordered : []; var rows = []; var used = {}; function identity(net) { return String(net.ssid || "") + "\u0000" + String(net.security || ""); } function append(path, net, rawSignal, atFront) { if (!net || used[path]) return; var row = { id: networkId(net.ssid), ssid: net.ssid, security: net.security, signal: rawSignal === null ? 0 : signalBars(rawSignal), signalDbm: rawSignal === null ? null : dbmFromCenti(rawSignal), connected: net.connected, known: net.known, needsPassphrase: needsPassphrase(net.security, net.known), path: path }; used[path] = true; if (atFront) rows.unshift(row); else rows.push(row); } for (var i = 0; i < list.length; i++) { var orderedRow = list[i]; var path = orderedRow.path; var net = nets[path]; if (!net && (orderedRow.ssid || orderedRow.security)) { var wanted = identity(orderedRow); for (var candidate in nets) { if (!used[candidate] && identity(nets[candidate]) === wanted) { path = candidate; net = nets[candidate]; break; } } } append(path, net, orderedRow.signal, false); } // ObjectManager and Station snapshots can race. Retain unmatched managed // rows rather than flashing an empty model; a missing connected row leads. for (var managedPath in nets) if (!used[managedPath] && nets[managedPath].connected) append(managedPath, nets[managedPath], null, true); for (var fallbackPath in nets) if (!used[fallbackPath]) append(fallbackPath, nets[fallbackPath], null, false); return rows; } // --- Shaping / view helpers ------------------------------------------------ // needsPassphrase(security, known) — secured AND iwd has no stored secret. function needsPassphrase(security, known) { return security !== "open" && !known; } // signalRole(bars) — theme token; weak/medium/strong. function signalRole(bars) { if (bars <= 1) return "ui.minor"; if (bars <= 3) return "ui.accent"; return "content.accent"; } // --- Nerd Font md-wifi_strength glyphs (astral codepoints). Built from // codepoints to avoid hand-written surrogate pairs. --- function fromCodePoint(n) { if (n < 0x10000) return String.fromCharCode(n); var c = n - 0x10000; return String.fromCharCode(0xD800 + (c >> 10), 0xDC00 + (c & 0x3FF)); } var WIFI_GLYPHS = [ fromCodePoint(0xF092F), // 0: wifi-strength-outline fromCodePoint(0xF091F), // 1 fromCodePoint(0xF0922), // 2 fromCodePoint(0xF0925), // 3 fromCodePoint(0xF0928) // 4 ]; // signalGlyph(bars) — nerd-font wifi glyph by strength. function signalGlyph(bars) { var b = bars; if (b < 0) b = 0; if (b > 4) b = 4; return WIFI_GLYPHS[b]; } // securityLabel(sec) — plain words for the security token; the token itself // (psk, sae, wep) is protocol detail nobody needs to read. function securityLabel(sec) { if (sec === "open") return "open"; if (sec === "8021x") return "enterprise"; return sec ? "secured" : ""; } // signalLabel(bars) — plain words for 0..4 bars; 0 means iwd sent no signal. function signalLabel(bars) { if (bars >= 4) return "strong signal"; if (bars === 3) return "good signal"; if (bars === 2) return "fair signal"; if (bars === 1) return "weak signal"; return "signal unknown"; } // --- Feedback --------------------------------------------------------------- // One line under the wireless header: what runs, or what failed and what to // do next. `action` is the service's lastAction ({kind, ssid|id, enabled}); // `secured` says whether the failed network still asks for a passphrase. function pendingText(action) { var kind = action ? action.kind : ""; var name = action ? String(action.ssid || action.id || "") : ""; if (kind === "connect") return name ? "joining " + name + "…" : "joining…"; if (kind === "disconnect") return "disconnecting…"; if (kind === "forget") return name ? "forgetting " + name + "…" : "forgetting…"; if (kind === "toggle-wifi") return action.enabled ? "turning wireless on…" : "turning wireless off…"; return "working…"; } function failureText(error, action, secured) { if (!error || error === "no-wifi-device") return ""; if (error === "scan-failed") return "scan failed · scan again"; var kind = action ? action.kind : ""; var name = action ? String(action.ssid || action.id || "") : ""; var unavailable = error === "action-unavailable"; if (kind === "connect") { if (unavailable) return name + " is out of reach · scan again"; return secured ? "could not join " + name + " · check the passphrase" : "could not join " + name + " · try again"; } if (kind === "forget") return unavailable ? name + " is not saved" : "could not forget " + name + " · try again"; if (kind === "disconnect") return "could not disconnect · try again"; if (kind === "toggle-wifi") return (action.enabled ? "could not turn wireless on" : "could not turn wireless off") + " · try again"; return "network action failed · try again"; } // --- Wired links (`ip -j -d link show`, sysfs uevent) ----------------------- // iwd never sees Ethernet; these three decide whether a cable carries a link. // wiredPorts(rawLinks) -> [{ name, up }] for every physical Ethernet-type // link: link type ether without a virtual kind (veth, bridge, tun, dummy, …; // a bridge or bond port keeps only info_slave_kind and stays a port). `up` // means carrier (LOWER_UP) on a link the kernel reports up or unknown. // Wireless devices are ether too; typedLinks() lets the caller drop them. function wiredPorts(rawLinks) { var links; try { links = JSON.parse(String(rawLinks || "")); } catch (e) { return []; } if (!Array.isArray(links)) return []; var out = []; for (var i = 0; i < links.length; i++) { var link = links[i]; if (!link || link.link_type !== "ether" || !link.ifname) continue; if (link.linkinfo && link.linkinfo.info_kind) continue; var flags = Array.isArray(link.flags) ? link.flags : []; out.push({ name: String(link.ifname), up: flags.indexOf("LOWER_UP") >= 0 && (link.operstate === "UP" || link.operstate === "UNKNOWN") }); } return out; } // typedLinks(rawGrep) -> { : } from `grep -H ^DEVTYPE=` // over /sys/class/net//uevent: wlan, wwan, … Plain Ethernet has none. function typedLinks(rawGrep) { var out = {}; var lines = String(rawGrep || "").split("\n"); for (var i = 0; i < lines.length; i++) { var m = /^\/sys\/class\/net\/([^\/]+)\/uevent:DEVTYPE=(.+)$/.exec(lines[i]); if (m) out[m[1]] = m[2]; } return out; } // wiredState(ports, typed) -> "connected" while any untyped port has carrier, // "unplugged" while untyped ports exist without one, "" without any. function wiredState(ports, typed) { var list = Array.isArray(ports) ? ports : []; var kinds = typed || {}; var state = ""; for (var i = 0; i < list.length; i++) { if (kinds[list[i].name]) continue; if (list[i].up) return "connected"; state = "unplugged"; } return state; } // networkId(ssid) — stable id (ssid itself; never empty). function networkId(ssid) { var s = (ssid === undefined || ssid === null) ? "" : String(ssid); return s.length > 0 ? s : "hidden-network"; } // --- Connection detail (StationDiagnostic.GetDiagnostics) ------------------ // Only the CONNECTED network has these; iwd exposes no per-BSS detail for // other scanned networks. The expand drawer shows bars/security for any row // and these extra fields only for the connected one. // bandLabel(freqMHz) — Wi-Fi band from centre frequency. "" if unknown. function bandLabel(freqMHz) { var f = Number(freqMHz); if (!isFinite(f) || f <= 0) return ""; if (f >= 5925) return "6 GHz"; if (f >= 4900) return "5 GHz"; if (f >= 2400) return "2.4 GHz"; return ""; } // rateLabel(raw) — iwd Rx/TxBitrate is in units of 100 kbit/s. -> "135 Mbps". // "" for missing/zero so the view can omit it. function rateLabel(raw) { var v = Number(raw); if (!isFinite(v) || v <= 0) return ""; return Math.round(v / 10) + " Mbps"; } // connectionDetail(rawDiag) -> { bssid, band, channel, rssi, rxRate, txRate, // mode } | null. rawDiag is the StationDiagnostic.GetDiagnostics a{sv} reply. // Returns null when there is no connected BSS (disconnected / no diagnostics). function connectionDetail(rawDiag) { var d = unwrap(rawDiag); if (!d || typeof d !== "object") return null; var bssid = prop(d, "ConnectedBss", ""); if (!bssid) return null; return { bssid: String(bssid), band: bandLabel(prop(d, "Frequency", 0)), channel: Number(prop(d, "Channel", 0)) || null, rssi: Number(prop(d, "RSSI", 0)) || null, rxRate: rateLabel(prop(d, "RxBitrate", 0)), txRate: rateLabel(prop(d, "TxBitrate", 0)), mode: String(prop(d, "RxMode", "") || "") }; } if (typeof module !== 'undefined' && module.exports) { module.exports = { unwrap: unwrap, prop: prop, signalBars: signalBars, dbmFromCenti: dbmFromCenti, parseManaged: parseManaged, parseOrdered: parseOrdered, networkRows: networkRows, needsPassphrase: needsPassphrase, signalRole: signalRole, signalGlyph: signalGlyph, securityLabel: securityLabel, signalLabel: signalLabel, pendingText: pendingText, failureText: failureText, networkId: networkId, wiredPorts: wiredPorts, typedLinks: typedLinks, wiredState: wiredState, bandLabel: bandLabel, rateLabel: rateLabel, connectionDetail: connectionDetail }; }