Krill SDK/krill.zone.shared.node/NodeHttp

NodeHttp

class NodeHttp(httpClient: HttpClient, trustHost: TrustHost, bearerTokenProvider: () -> String?)(source)

REST + SSE-friendly client for a Krill server.

Parameters

httpClient

Pre-configured Ktor client. The caller is responsible for installing engines, content-negotiation, plugins, and trust setup.

trustHost

Trust-store callback used to evict and re-fetch a peer cert when an outbound call fails with an SSL error.

bearerTokenProvider

Supplies the current bearer token (PIN-derived per krill.zone.shared.security.PinDerivation.deriveBearerToken) on each request. null skips the Authorization header entirely, which is what unauthenticated FTUE traffic should do.

Constructors

NodeHttp

constructor(httpClient: HttpClient, trustHost: TrustHost, bearerTokenProvider: () -> String?)

Functions

chart

suspend fun chart(host: Node, id: String, startTime: Long, endTime: Long): ByteArray

deleteBackupFile

suspend fun deleteBackupFile(host: Node, filename: String): Boolean

Deletes a backup archive file.

deleteNode

suspend fun deleteNode(host: Node, node: Node)

getBackupList

suspend fun getBackupList(host: Node): List<Map<String, Any?>>

Lists backup archives from the server.

getCameraSnapshot

suspend fun getCameraSnapshot(host: Node, cameraId: String): ByteArray?

Fetches a JPEG snapshot from a camera node.

getCameraThumbnailBytes

suspend fun getCameraThumbnailBytes(host: Node, cameraId: String, filename: String): ByteArray?

Fetches a saved camera thumbnail as bytes via the trusted httpClient.

getCameraThumbnails

suspend fun getCameraThumbnails(host: Node, cameraId: String): List<String>

Lists saved camera snapshot filenames (newest first).

getCameraThumbnailUrl

fun getCameraThumbnailUrl(host: Node, cameraId: String, filename: String): String

Returns the URL for a saved camera thumbnail.

getDataExportUrl

fun getDataExportUrl(host: Node, nodeId: String, startTime: Long? = null, endTime: Long? = null): String

Returns the data-export URL for a node, optionally filtered by time range. Caller composes a download request from the returned URL.

getDataSeries

suspend fun getDataSeries(host: Node, sourceId: String, startTime: Long, endTime: Long): List<Snapshot>

Fetches data series (snapshots) for a data point within a time range. Used by GraphScreen to load and poll chart data.

getGpioHeader

suspend fun getGpioHeader(host: Node): List<PinMetaData>

Fetches available GPIO pin headers from a server.

getQrCode

suspend fun getQrCode(host: Node, nodeId: String): ByteArray?

invokeNode

suspend fun invokeNode(host: Node, target: Node, by: NodeIdentity, verb: NodeAction = NodeAction.EXECUTE)

Deliberate invocation. POSTs an InvokeRequest body to ${baseUrl(host)}/node/${target.id}/invoke — the explicit replacement for the legacy state-stamp click pattern (clients posting a node with state = NodeState.EXECUTED). Under Phase 4 the server's update() does not wake a processor; this endpoint is how clicks (and any other app-side deliberate fire) reach a node's processor.

postNode

suspend fun postNode(host: Node, node: Node)

readHealth

suspend fun readHealth(host: Node): Node?

readNode

suspend fun readNode(host: Node, id: String): Node?

readNodes

suspend fun readNodes(host: Node): List<Node>

restoreBackup

suspend fun restoreBackup(host: Node, filename: String): String?

Initiates a restore from a backup archive.

uploadDiagram

suspend fun uploadDiagram(host: Node, projectId: String, fileName: String, svgBytes: ByteArray): Boolean

Uploads an SVG diagram file to a project.