kuilt-mdns/us.tractat.kuilt.mdns/MDNSAdvertisement

MDNSAdvertisement

data class MDNSAdvertisement(val host: String, val port: Int, val serverPeerId: PeerId, val displayName: String, val wsPath: String = DEFAULT_WS_PATH, val hostOs: MDNSAdvertisement.HostOs? = null, val fabrics: String? = null, val mcPeer: String? = null, val txtExtensions: Map<String, String> = emptyMap()) : Tag

Tag carrying enough information to connect via WebSocket to a peer that was discovered via mDNS / Bonjour.

Discovery via mDNS is handled by MDNSServiceDiscoverer; connection is delegated to :kuilt-websocket. This advertisement bridges the two.

Schema versioning

PROTOCOL_VERSION is "2" (v2 schema). v1 readers silently ignore the new keys per DNS-SD rules; v2 readers tolerate missing optional keys.

Application extensions

Callers may carry arbitrary application-specific metadata via txtExtensions. Each entry is written as an additional TXT record key–value pair. kuilt does not interpret these values — they round-trip opaquely through the discover path and arrive in the MDNSAdvertisement emitted by MDNSServiceDiscoverer.

Constructors

MDNSAdvertisement

constructor(host: String, port: Int, serverPeerId: PeerId, displayName: String, wsPath: String = DEFAULT_WS_PATH, hostOs: MDNSAdvertisement.HostOs? = null, fabrics: String? = null, mcPeer: String? = null, txtExtensions: Map<String, String> = emptyMap())

Types

Companion

object Companion

HostOs

enum HostOs : Enum<MDNSAdvertisement.HostOs>

Host OS families that can appear in TXT_KEY_HOST_OS.

Properties

displayName

open override val displayName: String

Human-readable service name from the mDNS TXT record.

fabrics

val fabrics: String?

Comma-separated transports the host accepts (e.g. "ws,mc").

host

val host: String

IP address or hostname of the advertising peer.

hostOs

val hostOs: MDNSAdvertisement.HostOs?

OS family of the advertising host — for fabric selection.

mcPeer

val mcPeer: String?

Opaque MultipeerConnectivity handle — present only when "mc" is in fabrics.

peerKey

open override val peerKey: String

The server's stable peer ID — unique across all mDNS advertisements.

port

val port: Int

TCP port the advertising peer's WebSocket server listens on.

serverPeerId

val serverPeerId: PeerId

The advertising peer's PeerId.

txtExtensions

val txtExtensions: Map<String, String>

Arbitrary application-supplied TXT record key–value pairs. These are written into the mDNS TXT record alongside the kuilt-owned fields and recovered verbatim by MDNSServiceDiscoverer. Keys must not collide with the kuilt-reserved constants in Companion.

wsPath

val wsPath: String

WebSocket path to connect to (default: DEFAULT_WS_PATH).

wsUrl

val wsUrl: String

WebSocket URL derived from host, port, and path.