Node

@Serializable

data class Node(val id: String, val parent: String, val host: String, val type: KrillApp, val state: NodeState = NodeState.NONE, val meta: NodeMetaData, val timestamp: Long = 0)(source)

A single node in a Krill swarm.

Constructors

Node

constructor(id: String, parent: String, host: String, type: KrillApp, state: NodeState = NodeState.NONE, meta: NodeMetaData, timestamp: Long = 0)

Properties

host

val host: String

UUID of the server hosting this node.

val id: String

Stable per-node UUID, unique within host.

Functions

details

fun Node.details(): String

Renders a debug-friendly one-liner of the node — used in log lines to give the timestamp / type / display name / state in a compact form.

https

fun Node.https(): Url

Returns the canonical https://<resolvedHost>:<port> Url for a server node. Throws IllegalArgumentException with a diagnostic message when meta is not a ServerMetaData — prefer calling this only on nodes whose type is KrillApp.Server.

fun Node.id(): NodeIdentity

Returns this node's address pair — (nodeId, hostId) — as a NodeIdentity suitable for use inside SourceMetaData source / target lists.

isDigital

fun Node.isDigital(): Boolean

true when this node's value is inherently boolean / digital. Delegates to NodeMetaData.isDigital.

key

fun Node.key(): String

Renders the node as a "<timestamp>:<id>" key. Used as a stable cache / comparison key in places where (timestamp, id) tuples need to be compared by value rather than by structural equality of the full node.

name

fun Node.name(): String

Returns the human-readable display name for the node. Delegates to NodeMetaData.displayName; when that returns empty, falls back to the node's KrillApp type string (the desired behaviour for MenuCommand entries and any subtype with no dedicated name field).

snapshotColorArgb

fun Node.snapshotColorArgb(): Long

For a DataPoint whose DataType is COLOR, returns the snapshot value parsed as a packed ARGB Long (0xFFRRGGBB). For any other node type or an unparseable value, returns opaque black (0xFF000000) so callers can unconditionally render the result without null-checking.