Self-hosted homelab infrastructure visualizer — interactive network diagram with live status monitoring
TypeScript diagramhomelabhomelab-infrastructure-observabilitynetworkproxmox-veself-hostedzigbeezwavezwave-js
/** Discovery-source bucketing for pending inventory devices.
*
* A device may be observed by more than one discovery path (e.g. an IP scan and
* a Proxmox import); `discovery_sources` holds every one. These helpers map that
* raw list to the UI's filter/badge buckets so a merged device shows under each
* matching filter and renders one badge per source.
*/
import type { InventoryEntry } from '@/components/modals/InventoryDeviceModal'
export type SourceBucket = 'ip' | 'zigbee' | 'zwave' | 'proxmox' | 'unraid' | 'unifi' | 'rack' | 'canvas'
export const SOURCE_META: Record<SourceBucket, { color: string; label: string }> = {
zigbee: { color: '#00d4ff', label: 'ZIGBEE' },
zwave: { color: '#ff6e00', label: 'Z-WAVE' },
proxmox: { color: '#e57000', label: 'PROXMOX' },
unraid: { color: '#e22828', label: 'UNRAID' },
unifi: { color: '#0559c9', label: 'UNIFI' },
ip: { color: '#a855f7', label: 'IP' },
rack: { color: '#39d353', label: 'RACK' },
// Documented straight on a canvas — no scan ever saw it.
canvas: { color: '#8b949e', label: 'CANVAS' },
}
// Stable badge order (IP first — it's the primary discovery path).
const SOURCE_ORDER: SourceBucket[] = ['ip', 'proxmox', 'unraid', 'unifi', 'zigbee', 'zwave', 'rack', 'canvas']
/** Every source bucket that has observed this device. A device found by both an
* IP scan and a Proxmox import returns {ip, proxmox}. */
export function sourceBuckets(d: InventoryEntry): Set<SourceBucket> {
const raw = d.discovery_sources && d.discovery_sources.length > 0
? d.discovery_sources
: d.discovery_source ? [d.discovery_source] : []
const buckets = new Set<SourceBucket>()
for (const s of raw) {
if (s === 'zwave') buckets.add('zwave')
else if (s === 'zigbee') buckets.add('zigbee')
else if (s === 'proxmox') buckets.add('proxmox')
else if (s === 'unraid') buckets.add('unraid')
// UniFi infrastructure ('unifi') and clients ('unifi-client') share one
// bucket — the type filter already separates ap/switch/router from hosts.
else if (s === 'unifi' || s === 'unifi-client') buckets.add('unifi')
// Created from a rack canvas: inventory gear that never lands on a
// logical canvas.
else if (s === 'rack') buckets.add('rack')
// Drawn on a canvas rather than discovered.
else if (s === 'canvas') buckets.add('canvas')
else buckets.add('ip') // arp / mdns / anything else → IP scan
}
if (buckets.size === 0) {
// No source recorded — legacy heuristic (mesh rows carry a non-pve ieee).
if (d.ieee_address && !d.ieee_address.startsWith('pve-')) buckets.add('zigbee')
else buckets.add('ip')
}
return buckets
}
/**
* Created from a rack canvas. Such an entry describes a mount (a chassis, a
* patch panel, a shelf), so it is never placed on a logical canvas — the
* approve paths refuse it on both sides of the wire.
*/
export function isRackDevice(d: InventoryEntry): boolean {
return sourceBuckets(d).has('rack')
}
/** Ordered bucket list for badge rendering. */
export function orderedSources(d: InventoryEntry): SourceBucket[] {
const buckets = sourceBuckets(d)
return SOURCE_ORDER.filter((b) => buckets.has(b))
}