feat(sdk,ffi): Add server_vendor_info method to matrix-sdk with automatic logging in FFI

bindings/matrix-sdk-ffi/src/client.rs

@@ -1608,6 +1608,15 @@ impl Client {
         Ok(self.inner.server_versions().await?.contains(&ruma::api::MatrixVersion::V1_13))
     }
 
+    /// Get the server version information from the federation API.
+    ///
+    /// This method calls the `/_matrix/federation/v1/version` endpoint to get
+    /// both the server name and version.
+    pub async fn server_version(&self) -> Result<ServerVersionInfo, ClientError> {
+        let server_info = self.inner.server_version().await?;
+        Ok(server_info.into())
+    }
+
     /// Checks if the server supports the LiveKit RTC focus for placing calls.
     pub async fn is_livekit_rtc_supported(&self) -> Result<bool, ClientError> {
         Ok(self
@@ -1797,6 +1806,23 @@ impl From<search_users::v3::Response> for SearchUsersResults {
     }
 }
 
+#[derive(uniffi::Record)]
+pub struct ServerVersionInfo {
+    /// The server name.
+    pub server_name: String,
+    /// The server version.
+    pub version: String,
+}
+
+impl From<matrix_sdk::ServerVersionInfo> for ServerVersionInfo {
+    fn from(value: matrix_sdk::ServerVersionInfo) -> Self {
+        Self {
+            server_name: value.server_name,
+            version: value.version,
+        }
+    }
+}
+
 #[derive(uniffi::Record)]
 pub struct UserProfile {
     pub user_id: String,

crates/matrix-sdk/Cargo.toml

@@ -101,6 +101,7 @@ pin-project-lite.workspace = true
 rand = { workspace = true, optional = true }
 ruma = { workspace = true, features = [
     "rand",
+    "federation-api-c",
     "unstable-msc2448",
     "unstable-msc4191",
     "unstable-msc3930",

crates/matrix-sdk/src/client/mod.rs

@@ -62,6 +62,7 @@ use ruma::{
             uiaa,
             user_directory::search_users,
         },
+        federation::discovery::get_server_version,
         error::FromHttpResponseError,
         FeatureFlag, MatrixVersion, OutgoingRequest, SupportedVersions,
     },
@@ -151,6 +152,15 @@ pub enum SessionChange {
     TokensRefreshed,
 }
 
+/// Information about the server version obtained from the federation API.
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct ServerVersionInfo {
+    /// The server name.
+    pub server_name: String,
+    /// The server version.
+    pub version: String,
+}
+
 /// An async/await enabled Matrix client.
 ///
 /// All of the state is held in an `Arc` so the `Client` can be cloned freely.
@@ -521,6 +531,35 @@ impl Client {
         Ok(res.capabilities)
     }
 
+    /// Get the server version information from the federation API.
+    ///
+    /// This method calls the `/_matrix/federation/v1/version` endpoint to get
+    /// both the server name and version.
+    ///
+    /// # Examples
+    ///
+    /// ```no_run
+    /// # use matrix_sdk::Client;
+    /// # use url::Url;
+    /// # async {
+    /// # let homeserver = Url::parse("http://example.com")?;
+    /// let client = Client::new(homeserver).await?;
+    ///
+    /// let server_info = client.server_version().await?;
+    /// println!("Server: {}, Version: {}", server_info.server_name, server_info.version);
+    /// # anyhow::Ok(()) };
+    /// ```
+    pub async fn server_version(&self) -> HttpResult<ServerVersionInfo> {
+        let res = self.send(get_server_version::v1::Request::new()).await?;
+
+        // Extract server info, using defaults if fields are missing
+        let server = res.server.unwrap_or_default();
+        let server_name_str = server.name.unwrap_or_else(|| "unknown".to_string());
+        let version = server.version.unwrap_or_else(|| "unknown".to_string());
+
+        Ok(ServerVersionInfo { server_name: server_name_str, version })
+    }
+
     /// Get a copy of the default request config.
     ///
     /// The default request config is what's used when sending requests if no

crates/matrix-sdk/src/lib.rs

@@ -68,7 +68,8 @@ pub mod widget;
 pub use account::Account;
 pub use authentication::{AuthApi, AuthSession, SessionTokens};
 pub use client::{
-    sanitize_server_name, Client, ClientBuildError, ClientBuilder, LoopCtrl, SessionChange,
+    sanitize_server_name, Client, ClientBuildError, ClientBuilder, LoopCtrl, ServerVersionInfo,
+    SessionChange,
 };
 pub use error::{
     Error, HttpError, HttpResult, NotificationSettingsError, RefreshTokenError, Result,

crates/matrix-sdk/tests/integration/client.rs

@@ -1490,3 +1490,53 @@ async fn test_room_sync_state_after() {
     let member = room.get_member_no_sync(user_id!("@invited:localhost")).await.unwrap().unwrap();
     assert_eq!(*member.membership(), MembershipState::Leave);
 }
+
+#[async_test]
+async fn test_server_version() {
+    use matrix_sdk::test_utils::mocks::MatrixMockServer;
+    use serde_json::json;
+    use wiremock::{matchers::{method, path}, Mock, ResponseTemplate};
+
+    let server = MatrixMockServer::new().await;
+    let client = server.client_builder().build().await;
+
+    // Mock the federation version endpoint
+    Mock::given(method("GET"))
+        .and(path("/_matrix/federation/v1/version"))
+        .respond_with(ResponseTemplate::new(200).set_body_json(json!({
+            "server": {
+                "name": "Synapse",
+                "version": "1.70.0"
+            }
+        })))
+        .mount(server.server())
+        .await;
+
+    let server_info = client.server_version().await.unwrap();
+
+    assert_eq!(server_info.server_name, "Synapse");
+    assert_eq!(server_info.version, "1.70.0");
+}
+
+#[async_test]
+async fn test_server_version_with_missing_fields() {
+    use matrix_sdk::test_utils::mocks::MatrixMockServer;
+    use serde_json::json;
+    use wiremock::{matchers::{method, path}, Mock, ResponseTemplate};
+
+    let server = MatrixMockServer::new().await;
+    let client = server.client_builder().build().await;
+
+    // Mock the federation version endpoint with missing fields
+    Mock::given(method("GET"))
+        .and(path("/_matrix/federation/v1/version"))
+        .respond_with(ResponseTemplate::new(200).set_body_json(json!({})))
+        .mount(server.server())
+        .await;
+
+    let server_info = client.server_version().await.unwrap();
+
+    // Should use defaults for missing fields
+    assert_eq!(server_info.server_name, "unknown");
+    assert_eq!(server_info.version, "unknown");
+}