@matter-server/dashboard 0.6.2 → 0.6.3

package/src/pages/network/network-types.ts

@@ -4,11 +4,18 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import type { BorderRouterEntry } from "@matter-server/ws-client";
+
 /**
  * Network type detected from NetworkCommissioning cluster feature map.
  */
 export type NetworkType = "thread" | "wifi" | "ethernet" | "unknown";
 
+/**
+ * Classification of a Thread mesh link based on RSSI/LQI.
+ */
+export type SignalLevel = "strong" | "medium" | "weak";
+
 /**
  * Thread routing role from ThreadNetworkDiagnostics cluster.
  * Attribute 0/53/1 (RoutingRole)
@@ -103,6 +110,8 @@ export interface ThreadConnection {
     fromNodeId: number | string;
     toNodeId: number | string;
     signalColor: string;
+    /** Undefined when link strength is unknown (e.g. route-table entry without LQI). */
+    signalLevel?: SignalLevel;
     lqi: number;
     rssi: number | null;
     /** Path cost from route table (1 = direct, higher = multi-hop). Only available for routers. */
@@ -113,10 +122,28 @@ export interface ThreadConnection {
     fromRouteTable?: boolean;
 }
 
+/**
+ * A pair of Thread nodes with their directional edge data.
+ * Each connected pair has 0-2 edges (one per neighbor/route table direction).
+ */
+export interface ThreadEdgePair {
+    /** Canonical pair key (sorted node IDs joined by "|") */
+    pairKey: string;
+    /** First node ID (lexicographically smaller) */
+    nodeA: string;
+    /** Second node ID (lexicographically larger) */
+    nodeB: string;
+    /** Edge where nodeA reports nodeB as neighbor */
+    edgeAB?: ThreadConnection;
+    /** Edge where nodeB reports nodeA as neighbor */
+    edgeBA?: ThreadConnection;
+}
+
 /**
  * Unknown Thread device seen in neighbor tables but not commissioned.
  */
 export interface UnknownThreadDevice {
+    kind: "unknown";
     /** Unique ID for the unknown device (prefixed with 'unknown_') */
     id: string;
     /** Extended address as hex string */
@@ -129,8 +156,46 @@ export interface UnknownThreadDevice {
     isRouter: boolean;
     /** Best signal strength seen */
     bestRssi: number | null;
+    /**
+     * Extended PAN ID (16-char uppercase hex) inherited from the commissioned node that
+     * reports this neighbor. All Thread neighbors share the observing node's network.
+     */
+    extendedPanIdHex?: string;
+    /**
+     * Friendly Thread network name resolved by joining {@link extendedPanIdHex} against the
+     * Border Router registry. Some BR vendors (e.g. Apple, Aqara) use a stable border-agent
+     * ID as the MeshCoP `xa` while the actual Thread radio MAC differs, so the BR can show
+     * up as both a known BR and an "unknown" router on the same network.
+     */
+    networkName?: string;
+}
+
+/**
+ * Thread Border Router enriched via mDNS.
+ *
+ * Same neighbor-table aggregate fields as UnknownThreadDevice (seenBy, isRouter, bestRssi),
+ * plus all BorderRouterEntry fields (network name, vendor, addresses, etc.).
+ */
+export interface KnownBorderRouter extends BorderRouterEntry {
+    kind: "br";
+    /** DOM/graph ID, formatted "br_<XAHEX>". */
+    id: string;
+    /** Convenience copy of extAddressHex as bigint, mirroring UnknownThreadDevice. */
+    extAddress: bigint;
+    /** Commissioned node IDs whose neighbor table sees this xa. */
+    seenBy: string[];
+    /** Inferred from neighbor entry. */
+    isRouter: boolean;
+    /** Best signal strength seen across observers. */
+    bestRssi: number | null;
 }
 
+/**
+ * External Thread device discriminated union — either a recognized Border Router
+ * or an unidentified neighbor.
+ */
+export type ThreadExternalDevice = KnownBorderRouter | UnknownThreadDevice;
+
 /**
  * Network graph node data for vis.js.
  */
@@ -147,6 +212,8 @@ export interface NetworkGraphNode {
     isUnknown?: boolean;
     /** Physics group: "connected" or "disconnected" */
     group?: "connected" | "disconnected";
+    /** Whether the node should be hidden */
+    hidden?: boolean;
 }
 
 /**
@@ -164,4 +231,13 @@ export interface NetworkGraphEdge {
     title?: string;
     /** Whether to show as dashed line */
     dashes?: boolean;
+    /** Whether the edge should be hidden */
+    hidden?: boolean;
+    /** vis.js arrow configuration: shorthand string ("to", "from", "") or
+     * object form for explicit head sizing on dashed edges. */
+    arrows?: string | { to?: { enabled: boolean; scaleFactor: number } };
+    /** The edge pair key this belongs to (Thread graph dedup/highlight) */
+    pairKey?: string;
+    /** Which node reported this connection from its neighbor/route table */
+    reportingNodeId?: number | string;
 }