heldar-kernel 0.2.0

Heldar kernel — media/DVR control plane, perception ingest + sampler, zone engine, auth, and the worker SDK contract. The open, domain-agnostic platform that domain apps build on.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

use axum::extract::{Path, State};
use axum::http::{header::HOST, HeaderMap};
use axum::routing::get;
use axum::{Json, Router};

use crate::auth::Principal;
use crate::error::AppResult;
use crate::services::mediamtx::{self, LiveUrls};
use crate::state::AppState;

pub fn router() -> Router<AppState> {
    Router::new().route(
        "/api/v1/cameras/{id}/liveview",
        get(liveview).post(liveview),
    )
}

/// Ensure a MediaMTX path exists for the camera and return live playback URLs.
async fn liveview(
    State(st): State<AppState>,
    principal: Principal,
    headers: HeaderMap,
    Path(id): Path<String>,
) -> AppResult<Json<LiveUrls>> {
    // Operational action (viewer+); the extractor enforces auth when it is enabled.
    principal.require(principal.can_view(), "view live streams")?;
    // The Host the client used lets us hand back stream URLs reachable over the tunnel / LAN.
    let host = headers.get(HOST).and_then(|v| v.to_str().ok());
    Ok(Json(mediamtx::ensure_live(&st, &id, host).await?))
}