feat: add graph UI metadata management endpoints and structures

Author: halajohn

core/src/ten_manager/src/config/metadata.rs

@@ -0,0 +1,59 @@
+//
+// Copyright © 2025 Agora
+// This file is part of TEN Framework, an open source project.
+// Licensed under the Apache License, Version 2.0, with certain conditions.
+// Refer to the "LICENSE" file in the root directory for more information.
+//
+use std::collections::HashMap;
+use std::{fs, path::PathBuf};
+
+use anyhow::Result;
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+use crate::constants::METADATA_FILE;
+
+use super::get_default_home_dir;
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub struct NodeGeometry {
+    pub app: Option<String>,
+    pub extension: String,
+
+    pub x: i64,
+    pub y: i64,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub struct GraphGeometry {
+    pub nodes_geometry: Vec<NodeGeometry>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Default, Clone)]
+pub struct GraphUiMetadata {
+    pub graphs_geometry: HashMap<Uuid, GraphGeometry>,
+}
+
+#[derive(Serialize, Deserialize, Debug, Default, Clone)]
+pub struct TmanMetadata {
+    pub graph_ui: GraphUiMetadata,
+}
+
+fn get_default_metadata_path() -> PathBuf {
+    let mut config_path = get_default_home_dir();
+    config_path.push(METADATA_FILE);
+    config_path
+}
+
+// Read the internal configuration from the specified path.
+pub fn read_metadata() -> Result<Option<TmanMetadata>> {
+    let config_path = get_default_metadata_path();
+    if !config_path.exists() {
+        return Ok(None);
+    }
+
+    let config_data = fs::read_to_string(config_path.clone())?;
+    let config: TmanMetadata = serde_json::from_str(&config_data)?;
+
+    Ok(Some(config))
+}

core/src/ten_manager/src/designer/metadata/graph_ui/get.rs

@@ -0,0 +1,53 @@
+//
+// Copyright © 2025 Agora
+// This file is part of TEN Framework, an open source project.
+// Licensed under the Apache License, Version 2.0, with certain conditions.
+// Refer to the "LICENSE" file in the root directory for more information.
+//
+use std::sync::Arc;
+
+use actix_web::{web, HttpResponse, Responder};
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+use crate::config::metadata::GraphGeometry;
+use crate::designer::response::{ApiResponse, Status};
+use crate::designer::DesignerState;
+
+#[derive(Debug, Serialize, Deserialize)]
+pub struct GetGraphUiRequestPayload {
+    pub graph_id: Uuid,
+}
+
+#[derive(Debug, Serialize, Deserialize)]
+pub struct GetGraphUiResponseData {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub graph_geometry: Option<GraphGeometry>,
+}
+
+pub async fn get_graph_ui_endpoint(
+    request_payload: web::Json<GetGraphUiRequestPayload>,
+    state: web::Data<Arc<DesignerState>>,
+) -> Result<impl Responder, actix_web::Error> {
+    let graph_id = request_payload.graph_id;
+
+    // Look for the graph geometry with the given graph_id.
+    let graph_geometry = state
+        .tman_metadata
+        .read()
+        .await
+        .graph_ui
+        .graphs_geometry
+        .get(&graph_id)
+        .cloned();
+
+    let response_data = GetGraphUiResponseData { graph_geometry };
+
+    let response = ApiResponse {
+        status: Status::Ok,
+        data: response_data,
+        meta: None,
+    };
+
+    Ok(HttpResponse::Ok().json(response))
+}

core/src/ten_manager/src/designer/metadata/graph_ui/mod.rs

@@ -0,0 +1,8 @@
+//
+// Copyright © 2025 Agora
+// This file is part of TEN Framework, an open source project.
+// Licensed under the Apache License, Version 2.0, with certain conditions.
+// Refer to the "LICENSE" file in the root directory for more information.
+//
+pub mod get;
+pub mod set;

core/src/ten_manager/src/designer/metadata/graph_ui/set.rs

@@ -0,0 +1,53 @@
+//
+// Copyright © 2025 Agora
+// This file is part of TEN Framework, an open source project.
+// Licensed under the Apache License, Version 2.0, with certain conditions.
+// Refer to the "LICENSE" file in the root directory for more information.
+//
+use std::sync::Arc;
+
+use actix_web::{web, HttpResponse, Responder};
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+use crate::config::metadata::GraphGeometry;
+use crate::designer::response::{ApiResponse, Status};
+use crate::designer::DesignerState;
+
+#[derive(Debug, Serialize, Deserialize)]
+pub struct SetGraphUiRequestPayload {
+    pub graph_id: Uuid,
+    pub graph_geometry: GraphGeometry,
+}
+
+#[derive(Debug, Serialize, Deserialize)]
+pub struct SetGraphUiResponseData {
+    pub success: bool,
+}
+
+pub async fn set_graph_ui_endpoint(
+    request_payload: web::Json<SetGraphUiRequestPayload>,
+    state: web::Data<Arc<DesignerState>>,
+) -> Result<impl Responder, actix_web::Error> {
+    // Extract the payload data.
+    let payload = request_payload.into_inner();
+    let graph_id = payload.graph_id;
+    let graph_geometry = payload.graph_geometry;
+
+    state
+        .tman_metadata
+        .write()
+        .await
+        .graph_ui
+        .graphs_geometry
+        .insert(graph_id, graph_geometry);
+
+    let response_data = SetGraphUiResponseData { success: true };
+    let response = ApiResponse {
+        status: Status::Ok,
+        data: response_data,
+        meta: None,
+    };
+
+    Ok(HttpResponse::Ok().json(response))
+}

core/src/ten_manager/src/designer/metadata/mod.rs

@@ -0,0 +1,7 @@
+//
+// Copyright © 2025 Agora
+// This file is part of TEN Framework, an open source project.
+// Licensed under the Apache License, Version 2.0, with certain conditions.
+// Refer to the "LICENSE" file in the root directory for more information.
+//
+pub mod graph_ui;