postrust_proxy/admin/

api.rs

//! REST API endpoints for proxy management.

use crate::config::{Backend, HealthCheckConfig, LoadBalanceStrategy, Route, RouteMatch, Upstream};
use crate::ProxyState;
use axum::{
    extract::{Path, State},
    http::StatusCode,
    response::IntoResponse,
    routing::{delete, get, post, put},
    Json, Router,
};
use serde::{Deserialize, Serialize};
use std::collections::HashMap;
use std::sync::Arc;
use uuid::Uuid;

/// API response wrapper.
#[derive(Serialize)]
pub struct ApiResponse<T> {
    pub success: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub data: Option<T>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub error: Option<String>,
}

impl<T: Serialize> ApiResponse<T> {
    pub fn success(data: T) -> Self {
        Self {
            success: true,
            data: Some(data),
            error: None,
        }
    }

    pub fn error(message: impl Into<String>) -> ApiResponse<()> {
        ApiResponse {
            success: false,
            data: None,
            error: Some(message.into()),
        }
    }
}

/// Create the admin API router.
pub fn admin_router() -> Router<Arc<ProxyState>> {
    Router::new()
        // Routes
        .route("/routes", get(list_routes))
        .route("/routes", post(create_route))
        .route("/routes/:id", get(get_route))
        .route("/routes/:id", put(update_route))
        .route("/routes/:id", delete(delete_route))
        // Upstreams
        .route("/upstreams", get(list_upstreams))
        .route("/upstreams", post(create_upstream))
        .route("/upstreams/:id", get(get_upstream))
        .route("/upstreams/:id", put(update_upstream))
        .route("/upstreams/:id", delete(delete_upstream))
        // Backends
        .route("/upstreams/:id/backends", get(list_backends))
        .route("/upstreams/:id/backends", post(add_backend))
        .route(
            "/upstreams/:id/backends/:backend_id",
            delete(remove_backend),
        )
        // Health
        .route("/health", get(health_status))
        .route("/health/:backend_id", get(backend_health))
        // Config
        .route("/config/reload", post(reload_config))
        // Stats
        .route("/stats", get(get_stats))
}

// Route handlers

async fn list_routes(State(state): State<Arc<ProxyState>>) -> impl IntoResponse {
    let config = state.config.read().await;
    let routes = config.routes.clone();
    Json(ApiResponse::success(routes))
}

async fn get_route(
    State(state): State<Arc<ProxyState>>,
    Path(id): Path<Uuid>,
) -> impl IntoResponse {
    let config = state.config.read().await;
    match config.routes.iter().find(|r| r.id == Some(id)) {
        Some(route) => Json(ApiResponse::success(route)).into_response(),
        None => (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Route not found")),
        )
            .into_response(),
    }
}

#[derive(Deserialize)]
pub struct CreateRouteRequest {
    pub name: String,
    pub host: Option<String>,
    pub path: Option<String>,
    pub upstream: String,
    pub strip_path: Option<bool>,
    pub priority: Option<i32>,
    pub add_headers: Option<HashMap<String, String>>,
    pub remove_headers: Option<Vec<String>>,
}

async fn create_route(
    State(state): State<Arc<ProxyState>>,
    Json(req): Json<CreateRouteRequest>,
) -> impl IntoResponse {
    let route = Route {
        id: Some(Uuid::new_v4()),
        name: req.name,
        description: None,
        match_: RouteMatch {
            host: req.host,
            path: req.path,
            path_type: Default::default(),
            headers: HashMap::new(),
            methods: None,
        },
        priority: req.priority.unwrap_or(100),
        upstream: req.upstream,
        strip_path: req.strip_path.unwrap_or(false),
        add_headers: req.add_headers.unwrap_or_default(),
        remove_headers: req.remove_headers.unwrap_or_default(),
        rate_limit: None,
        timeout_secs: 30,
        retry_count: 0,
        enabled: true,
    };

    // TODO: Persist to database
    let mut config = state.config.write().await;
    config.routes.push(route.clone());

    (StatusCode::CREATED, Json(ApiResponse::success(route)))
}

async fn update_route(
    State(state): State<Arc<ProxyState>>,
    Path(id): Path<Uuid>,
    Json(req): Json<CreateRouteRequest>,
) -> impl IntoResponse {
    let mut config = state.config.write().await;

    if let Some(route) = config.routes.iter_mut().find(|r| r.id == Some(id)) {
        route.name = req.name;
        route.match_.host = req.host;
        route.match_.path = req.path;
        route.upstream = req.upstream;
        route.strip_path = req.strip_path.unwrap_or(false);
        route.priority = req.priority.unwrap_or(100);
        if let Some(add_headers) = req.add_headers {
            route.add_headers = add_headers;
        }
        if let Some(remove_headers) = req.remove_headers {
            route.remove_headers = remove_headers;
        }

        // TODO: Persist to database
        Json(ApiResponse::success(route.clone())).into_response()
    } else {
        (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Route not found")),
        )
            .into_response()
    }
}

async fn delete_route(
    State(state): State<Arc<ProxyState>>,
    Path(id): Path<Uuid>,
) -> impl IntoResponse {
    let mut config = state.config.write().await;
    let len_before = config.routes.len();
    config.routes.retain(|r| r.id != Some(id));

    if config.routes.len() < len_before {
        // TODO: Delete from database
        Json(ApiResponse::success(())).into_response()
    } else {
        (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Route not found")),
        )
            .into_response()
    }
}

// Upstream handlers

async fn list_upstreams(State(state): State<Arc<ProxyState>>) -> impl IntoResponse {
    let config = state.config.read().await;
    let upstreams = config.upstreams.clone();
    Json(ApiResponse::success(upstreams))
}

async fn get_upstream(
    State(state): State<Arc<ProxyState>>,
    Path(id): Path<Uuid>,
) -> impl IntoResponse {
    let config = state.config.read().await;
    match config.upstreams.iter().find(|u| u.id == Some(id)) {
        Some(upstream) => Json(ApiResponse::success(upstream)).into_response(),
        None => (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Upstream not found")),
        )
            .into_response(),
    }
}

#[derive(Deserialize)]
pub struct CreateUpstreamRequest {
    pub name: String,
    pub lb_strategy: Option<LoadBalanceStrategy>,
    pub backends: Vec<BackendRequest>,
}

#[derive(Deserialize)]
pub struct BackendRequest {
    pub address: String,
    pub weight: Option<u32>,
    pub scheme: Option<String>,
}

async fn create_upstream(
    State(state): State<Arc<ProxyState>>,
    Json(req): Json<CreateUpstreamRequest>,
) -> impl IntoResponse {
    let backends: Vec<Backend> = req
        .backends
        .into_iter()
        .map(|b| Backend {
            id: Some(Uuid::new_v4()),
            address: b.address,
            weight: b.weight.unwrap_or(100),
            scheme: b.scheme.unwrap_or_else(|| "http".to_string()),
            enabled: true,
        })
        .collect();

    let upstream = Upstream {
        id: Some(Uuid::new_v4()),
        name: req.name,
        description: None,
        lb_strategy: req.lb_strategy.unwrap_or_default(),
        backends,
        health_check: HealthCheckConfig::default(),
        enabled: true,
    };

    // TODO: Persist to database
    let mut config = state.config.write().await;
    config.upstreams.push(upstream.clone());

    (StatusCode::CREATED, Json(ApiResponse::success(upstream)))
}

async fn update_upstream(
    State(state): State<Arc<ProxyState>>,
    Path(id): Path<Uuid>,
    Json(req): Json<CreateUpstreamRequest>,
) -> impl IntoResponse {
    let mut config = state.config.write().await;

    if let Some(upstream) = config.upstreams.iter_mut().find(|u| u.id == Some(id)) {
        upstream.name = req.name;
        upstream.lb_strategy = req.lb_strategy.unwrap_or_default();
        // Note: backends update would need more sophisticated handling

        // TODO: Persist to database
        Json(ApiResponse::success(upstream.clone())).into_response()
    } else {
        (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Upstream not found")),
        )
            .into_response()
    }
}

async fn delete_upstream(
    State(state): State<Arc<ProxyState>>,
    Path(id): Path<Uuid>,
) -> impl IntoResponse {
    let mut config = state.config.write().await;
    let len_before = config.upstreams.len();
    config.upstreams.retain(|u| u.id != Some(id));

    if config.upstreams.len() < len_before {
        // TODO: Delete from database
        Json(ApiResponse::success(())).into_response()
    } else {
        (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Upstream not found")),
        )
            .into_response()
    }
}

// Backend handlers

async fn list_backends(
    State(state): State<Arc<ProxyState>>,
    Path(upstream_id): Path<Uuid>,
) -> impl IntoResponse {
    let config = state.config.read().await;
    match config.upstreams.iter().find(|u| u.id == Some(upstream_id)) {
        Some(upstream) => {
            let backends = upstream.backends.clone();
            Json(ApiResponse::success(backends)).into_response()
        }
        None => (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Upstream not found")),
        )
            .into_response(),
    }
}

async fn add_backend(
    State(state): State<Arc<ProxyState>>,
    Path(upstream_id): Path<Uuid>,
    Json(req): Json<BackendRequest>,
) -> impl IntoResponse {
    let mut config = state.config.write().await;

    if let Some(upstream) = config
        .upstreams
        .iter_mut()
        .find(|u| u.id == Some(upstream_id))
    {
        let backend = Backend {
            id: Some(Uuid::new_v4()),
            address: req.address,
            weight: req.weight.unwrap_or(100),
            scheme: req.scheme.unwrap_or_else(|| "http".to_string()),
            enabled: true,
        };

        upstream.backends.push(backend.clone());

        // TODO: Persist to database
        (StatusCode::CREATED, Json(ApiResponse::success(backend))).into_response()
    } else {
        (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Upstream not found")),
        )
            .into_response()
    }
}

async fn remove_backend(
    State(state): State<Arc<ProxyState>>,
    Path((upstream_id, backend_id)): Path<(Uuid, Uuid)>,
) -> impl IntoResponse {
    let mut config = state.config.write().await;

    if let Some(upstream) = config
        .upstreams
        .iter_mut()
        .find(|u| u.id == Some(upstream_id))
    {
        let len_before = upstream.backends.len();
        upstream.backends.retain(|b| b.id != Some(backend_id));

        if upstream.backends.len() < len_before {
            // TODO: Delete from database
            Json(ApiResponse::success(())).into_response()
        } else {
            (
                StatusCode::NOT_FOUND,
                Json(ApiResponse::<()>::error("Backend not found")),
            )
                .into_response()
        }
    } else {
        (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Upstream not found")),
        )
            .into_response()
    }
}

// Health handlers

#[derive(Serialize)]
pub struct HealthSummary {
    pub total_backends: usize,
    pub healthy_backends: usize,
    pub unhealthy_backends: usize,
}

async fn health_status(State(state): State<Arc<ProxyState>>) -> impl IntoResponse {
    let config = state.config.read().await;

    let mut total = 0;
    let mut healthy = 0;

    for upstream in &config.upstreams {
        for backend in &upstream.backends {
            total += 1;
            if let Some(id) = backend.id {
                if state.health_checker.is_healthy(id) {
                    healthy += 1;
                }
            }
        }
    }

    Json(ApiResponse::success(HealthSummary {
        total_backends: total,
        healthy_backends: healthy,
        unhealthy_backends: total - healthy,
    }))
}

async fn backend_health(
    State(state): State<Arc<ProxyState>>,
    Path(backend_id): Path<Uuid>,
) -> impl IntoResponse {
    match state.health_checker.get_health(backend_id) {
        Some(health) => Json(ApiResponse::success(health)).into_response(),
        None => (
            StatusCode::NOT_FOUND,
            Json(ApiResponse::<()>::error("Backend not found")),
        )
            .into_response(),
    }
}

// Config handlers

async fn reload_config(State(state): State<Arc<ProxyState>>) -> impl IntoResponse {
    state.config_reloader.request_reload().await;
    Json(ApiResponse::success("Configuration reload requested"))
}

// Stats handlers

#[derive(Serialize)]
pub struct ProxyStats {
    pub routes_count: usize,
    pub upstreams_count: usize,
    pub backends_count: usize,
}

async fn get_stats(State(state): State<Arc<ProxyState>>) -> impl IntoResponse {
    let config = state.config.read().await;

    let backends_count: usize = config.upstreams.iter().map(|u| u.backends.len()).sum();

    Json(ApiResponse::success(ProxyStats {
        routes_count: config.routes.len(),
        upstreams_count: config.upstreams.len(),
        backends_count,
    }))
}