feat: add get_download RPC method and OutsideProvider registration

- Add register_provider and get_download JSON-RPC server methods
- Add DownloadItemData, RpcRegisterProviderRequest, RpcDownloadInfoRequest structs
- Implement get_download on OutsideProvider (HTTP JSON-RPC callback to Kotlin)
- Add GetDownload variant to FunctionType enum with default impl on BaseProvider
- Add get_download routing in provider.rs and api.rs
- Make data module public for cross-module imports

Author: xz-dev

src/rpc.rs

@@ -1,3 +1,3 @@
 pub mod client;
-mod data;
+pub mod data;
 pub mod server;

src/rpc/client.rs

@@ -58,4 +58,20 @@ impl Client {
         };
         self.client.request("get_releases", data).await
     }
+
+    pub async fn get_download(
+        &self,
+        hub_uuid: &str,
+        app_data: BTreeMap<&str, &str>,
+        hub_data: BTreeMap<&str, &str>,
+        asset_index: &[i32],
+    ) -> Result<Vec<DownloadItemData>, Error> {
+        let data = RpcDownloadInfoRequest {
+            hub_uuid,
+            app_data,
+            hub_data,
+            asset_index: asset_index.to_vec(),
+        };
+        self.client.request("get_download", data).await
+    }
 }

src/rpc/data.rs

@@ -2,7 +2,7 @@ use crate::downloader::{DownloadState, TaskInfo};
 use jsonrpsee::core::traits::ToRpcParams;
 use serde::{Deserialize, Serialize};
 use serde_json::value::to_raw_value;
-use std::collections::BTreeMap;
+use std::collections::{BTreeMap, HashMap};
 
 #[derive(Serialize, Deserialize, Debug)]
 pub struct RpcInitRequest<'a> {
@@ -41,6 +41,49 @@ impl ToRpcParams for RpcCloudConfigRequest<'_> {
     }
 }
 
+// ============================================================================
+// Provider Registration RPC Data Structures
+// ============================================================================
+
+/// Request to register an external provider
+#[derive(Serialize, Deserialize, Debug)]
+pub struct RpcRegisterProviderRequest<'a> {
+    pub hub_uuid: &'a str,
+    pub url: &'a str,
+}
+
+impl ToRpcParams for RpcRegisterProviderRequest<'_> {
+    fn to_rpc_params(self) -> Result<Option<Box<serde_json::value::RawValue>>, serde_json::Error> {
+        to_raw_value(&self).map(Some)
+    }
+}
+
+/// Request to get download info for an app
+#[derive(Serialize, Deserialize, Debug)]
+pub struct RpcDownloadInfoRequest<'a> {
+    pub hub_uuid: &'a str,
+    pub app_data: BTreeMap<&'a str, &'a str>,
+    pub hub_data: BTreeMap<&'a str, &'a str>,
+    pub asset_index: Vec<i32>,
+}
+
+impl ToRpcParams for RpcDownloadInfoRequest<'_> {
+    fn to_rpc_params(self) -> Result<Option<Box<serde_json::value::RawValue>>, serde_json::Error> {
+        to_raw_value(&self).map(Some)
+    }
+}
+
+/// Download item data returned by get_download
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct DownloadItemData {
+    pub name: Option<String>,
+    pub url: String,
+    #[serde(default)]
+    pub headers: Option<HashMap<String, String>>,
+    #[serde(default)]
+    pub cookies: Option<HashMap<String, String>>,
+}
+
 // ============================================================================
 // Downloader RPC Data Structures
 // ============================================================================

src/rpc/server.rs

@@ -128,6 +128,44 @@ pub async fn run_server(
         }
     })?;
 
+    // register_provider: Dynamically register an external provider (e.g., Kotlin hub via HTTP JSON-RPC)
+    module.register_async_method(
+        "register_provider",
+        |params, _context, _extensions| async move {
+            let request = params.parse::<RpcRegisterProviderRequest>()?;
+            api::add_outside_provider(request.hub_uuid, request.url);
+            Ok::<bool, ErrorObjectOwned>(true)
+        },
+    )?;
+
+    // get_download: Get download info for an app's asset
+    module.register_async_method("get_download", |params, _context, _extensions| async move {
+        if let Ok(request) = params.parse::<RpcDownloadInfoRequest>() {
+            if let Some(result) = api::get_download(
+                request.hub_uuid,
+                &request.app_data,
+                &request.hub_data,
+                &request.asset_index,
+            )
+            .await
+            {
+                Ok(result)
+            } else {
+                Err(ErrorObjectOwned::borrowed(
+                    ErrorCode::InvalidParams.code(),
+                    "Invalid params",
+                    None,
+                ))
+            }
+        } else {
+            Err(ErrorObjectOwned::owned(
+                ErrorCode::ParseError.code(),
+                "Parse params error",
+                Some(params.as_str().unwrap_or("None").to_string()),
+            ))
+        }
+    })?;
+
     module.register_async_method(
         "get_cloud_config",
         |params, _context, _extensions| async move {

src/websdk/repo/api.rs

@@ -8,6 +8,7 @@ use super::provider::outside_rpc::OutsideProvider;
 use super::provider::{self, add_provider};
 use crate::cache::get_cache_manager;
 use crate::cache::manager::GroupType;
+use crate::rpc::data::DownloadItemData;
 use crate::utils::json::{bytes_to_json, json_to_bytes};
 use std::collections::HashMap;
 
@@ -141,6 +142,21 @@ pub async fn get_releases<'a>(
     .unwrap_or(None)
 }
 
+pub async fn get_download<'a>(
+    uuid: &str,
+    app_data: &AppDataMap<'a>,
+    hub_data: &HubDataMap<'a>,
+    asset_index: &[i32],
+) -> Option<Vec<DownloadItemData>> {
+    let data_map = DataMap { app_data, hub_data };
+    let fin = FIn::new(data_map, None);
+    if let Some(fout) = provider::get_download(uuid, &fin, asset_index).await {
+        fout.result.ok()
+    } else {
+        None
+    }
+}
+
 pub fn add_outside_provider(uuid: &str, url: &str) {
     let provider = OutsideProvider {
         uuid: uuid.to_string(),

src/websdk/repo/provider.rs

@@ -15,6 +15,7 @@ use self::github::GitHubProvider;
 use self::gitlab::GitLabProvider;
 use self::lsposed_repo::LsposedRepoProvider;
 use super::data::release::ReleaseData;
+use crate::rpc::data::DownloadItemData;
 
 type ProviderMap = HashMap<&'static str, Arc<dyn BaseProvider + Send + Sync>>;
 
@@ -84,3 +85,15 @@ pub async fn get_releases<'a>(uuid: &str, fin: &FIn<'a>) -> Option<FOut<Vec<Rele
         None
     }
 }
+
+pub async fn get_download<'a>(
+    uuid: &str,
+    fin: &FIn<'a>,
+    asset_index: &[i32],
+) -> Option<FOut<Vec<DownloadItemData>>> {
+    if let Some(provider) = get_provider(uuid) {
+        Some(provider.get_download(fin, asset_index).await)
+    } else {
+        None
+    }
+}

src/websdk/repo/provider/base_provider.rs

@@ -10,6 +10,7 @@ use std::{
 };
 
 use super::super::data::release::*;
+use crate::rpc::data::DownloadItemData;
 
 pub type HubDataMap<'a> = BTreeMap<&'a str, &'a str>;
 pub type AppDataMap<'a> = BTreeMap<&'a str, &'a str>;
@@ -44,6 +45,7 @@ pub enum FunctionType {
     CheckAppAvailable,
     GetLatestRelease,
     GetReleases,
+    GetDownload,
 }
 
 pub struct FIn<'a> {
@@ -157,6 +159,12 @@ pub trait BaseProvider {
     }
 
     async fn get_releases(&self, fin: &FIn) -> FOut<Vec<ReleaseData>>;
+
+    /// Get download info for an app's asset. Default returns empty (not supported).
+    /// Only OutsideProvider (Kotlin hubs) needs to implement this.
+    async fn get_download(&self, _fin: &FIn, _asset_index: &[i32]) -> FOut<Vec<DownloadItemData>> {
+        FOut::new_empty()
+    }
 }
 
 pub trait BaseProviderExt: BaseProvider {
@@ -228,6 +236,7 @@ mod tests {
                 FunctionType::CheckAppAvailable => "check_app_available",
                 FunctionType::GetLatestRelease => "get_latest_release",
                 FunctionType::GetReleases => "get_releases",
+                FunctionType::GetDownload => "get_download",
             };
             let id_map = data_map.app_data;
             vec![format!(

src/websdk/repo/provider/fdroid.rs

@@ -51,6 +51,7 @@ impl BaseProvider for FDroidProvider {
                 url, id_map[ANDROID_APP_TYPE]
             )],
             FunctionType::GetLatestRelease | FunctionType::GetReleases => vec![api_url.to_string()],
+            FunctionType::GetDownload => vec![],
         }
     }
 

src/websdk/repo/provider/github.rs

@@ -59,6 +59,7 @@ impl BaseProvider for GitHubProvider {
                 "{}/repos/{}/{}/releases",
                 GITHUB_API_URL, id_map["owner"], id_map["repo"]
             )],
+            FunctionType::GetDownload => vec![],
         }
     }
 

src/websdk/repo/provider/gitlab.rs

@@ -104,6 +104,7 @@ impl BaseProvider for GitLabProvider {
                 "{}/{}/{}/releases",
                 GITLAB_API_URL, id_map["owner"], id_map["repo"]
             )],
+            FunctionType::GetDownload => vec![],
         }
     }