nodedb 0.2.1

Local-first, real-time, edge-to-cloud hybrid database for multi-modal workloads
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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

// SPDX-License-Identifier: BUSL-1.1

//! Cluster observability endpoint.
//!
//! `GET /v1/cluster/status` returns a full JSON snapshot of the
//! cluster's observability surface — lifecycle phase, every known
//! peer, every Raft group hosted on this node — sourced from the
//! `ClusterObserver` published by `control::cluster::start_raft`.
//!
//! In single-node mode (no `[cluster]` config) the endpoint returns
//! `503 Service Unavailable` with a short JSON error body so clients
//! can distinguish "cluster mode disabled" from "cluster mode broken".

use axum::extract::State;
use axum::http::{StatusCode, header};
use axum::response::{IntoResponse, Response};

use super::super::auth::{AppState, ResolvedIdentity};

/// `GET /v1/cluster/status` — full observability snapshot.
///
/// Requires authentication — cluster metadata (peer addresses, Raft group
/// membership, shard topology) must not leak to unauthenticated callers.
pub async fn cluster_status(
    _identity: ResolvedIdentity,
    State(state): State<AppState>,
) -> Response {
    match state.shared.cluster_observer.get() {
        Some(observer) => {
            let snap = observer.snapshot();
            match sonic_rs::to_string(&snap) {
                Ok(body) => json_response(StatusCode::OK, body),
                Err(e) => {
                    tracing::warn!(error = %e, "cluster snapshot serialization failed");
                    json_response(
                        StatusCode::INTERNAL_SERVER_ERROR,
                        r#"{"error":"snapshot serialization failed"}"#.to_string(),
                    )
                }
            }
        }
        None => json_response(
            StatusCode::SERVICE_UNAVAILABLE,
            r#"{"error":"cluster mode not enabled","detail":"this node is running in single-node mode; /v1/cluster/status requires a [cluster] config section"}"#
                .to_string(),
        ),
    }
}

/// Build a JSON response with the given status and pre-serialised
/// body. Centralised so every branch uses the same content-type and
/// so `axum::Json` (which calls `serde_json::to_vec` internally) is
/// not on any hot path — runtime JSON serialization goes through
/// `sonic_rs`.
fn json_response(status: StatusCode, body: String) -> Response {
    (status, [(header::CONTENT_TYPE, "application/json")], body).into_response()
}