reallink-cli 0.1.10 → 0.1.12

package/rust/src/unreal.rs

@@ -0,0 +1,266 @@
+use anyhow::Result;
+use clap::{ArgAction, Args, Subcommand};
+use serde::{Deserialize, Serialize};
+use std::path::PathBuf;
+
+const DEFAULT_UNREAL_PLUGIN_BASE_URL: &str = "https://real-agent.link/plugins/unreal";
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct UnrealLinkRecord {
+    pub project_id: String,
+    pub uproject_path: String,
+    pub project_root: String,
+    pub engine_root: Option<String>,
+    pub editor_path: String,
+    pub created_at_epoch_ms: u128,
+    pub updated_at_epoch_ms: u128,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct UnrealLinksConfig {
+    pub version: u32,
+    pub default_project_id: Option<String>,
+    pub links: Vec<UnrealLinkRecord>,
+}
+
+impl Default for UnrealLinksConfig {
+    fn default() -> Self {
+        Self {
+            version: 1,
+            default_project_id: None,
+            links: Vec::new(),
+        }
+    }
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct PluginIndexFile {
+    pub schema_version: Option<u32>,
+    #[serde(default)]
+    pub plugins: Vec<PluginIndexPlugin>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct PluginIndexPlugin {
+    pub name: String,
+    pub latest: Option<String>,
+    #[serde(default)]
+    pub versions: Vec<PluginIndexVersion>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct PluginIndexVersion {
+    pub version: String,
+    pub archive_url: Option<String>,
+    pub sha256: Option<String>,
+}
+
+#[derive(Subcommand)]
+pub(crate) enum LinkCommands {
+    Unreal(LinkUnrealArgs),
+    List,
+    Use(LinkUseArgs),
+    Doctor(LinkDoctorArgs),
+    Paths(LinkPathsArgs),
+    Remove(LinkRemoveArgs),
+    Open(LinkOpenArgs),
+    Run(LinkRunArgs),
+    Plugin {
+        #[command(subcommand)]
+        command: LinkPluginCommands,
+    },
+}
+
+#[derive(Subcommand)]
+pub(crate) enum LinkPluginCommands {
+    Install(LinkPluginInstallArgs),
+    List(LinkPluginListArgs),
+}
+
+#[derive(Args)]
+pub(crate) struct LinkUnrealArgs {
+    #[arg(long, help = "Remote Reallink project id to bind")]
+    pub project_id: String,
+    #[arg(long, help = "Path to .uproject file or a folder containing one")]
+    pub uproject: PathBuf,
+    #[arg(long, help = "Path to Unreal Engine root (contains Engine/)")]
+    pub engine_root: Option<PathBuf>,
+    #[arg(long, help = "Path to Unreal editor binary (UnrealEditor/UE4Editor)")]
+    pub editor: Option<PathBuf>,
+    #[arg(long, help = "Set this link as default for `reallink link open`")]
+    pub set_default: bool,
+    #[arg(long, help = "Skip remote project verification (useful when offline)")]
+    pub no_verify_remote: bool,
+    #[arg(
+        long,
+        help = "Sync a sanitized Unreal link manifest into project assets (.reallink/link/unreal-link.latest.json)"
+    )]
+    pub sync_project: bool,
+    #[arg(
+        long,
+        help = "When syncing project manifest, include full local paths (disabled by default)"
+    )]
+    pub include_local_paths: bool,
+    #[arg(long)]
+    pub base_url: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkUseArgs {
+    #[arg(long)]
+    pub project_id: String,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkRemoveArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkOpenArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+    #[arg(long, help = "Wait for Unreal process to exit")]
+    pub wait: bool,
+    #[arg(
+        long = "arg",
+        action = ArgAction::Append,
+        help = "Additional argument forwarded to Unreal editor"
+    )]
+    pub extra_arg: Vec<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkRunArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+    #[arg(long, help = "Commandlet name to execute via -run=<name>")]
+    pub commandlet: Option<String>,
+    #[arg(long, help = "Add Unreal -log flag")]
+    pub log: bool,
+    #[arg(
+        long,
+        help = "Add headless-friendly flags (-unattended -nop4 -nosplash -nullrhi)"
+    )]
+    pub headless: bool,
+    #[arg(long, help = "Do not wait for process exit")]
+    pub no_wait: bool,
+    #[arg(
+        long = "arg",
+        action = ArgAction::Append,
+        help = "Additional argument forwarded to Unreal editor"
+    )]
+    pub extra_arg: Vec<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkDoctorArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+    #[arg(
+        long,
+        help = "Verify linked project access against API using saved session"
+    )]
+    pub verify_remote: bool,
+    #[arg(long)]
+    pub base_url: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkPathsArgs {
+    #[arg(long)]
+    pub project_id: Option<String>,
+    #[arg(long)]
+    pub uproject: Option<PathBuf>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkPluginInstallArgs {
+    #[arg(long, help = "Plugin name (also used for target folder name)")]
+    pub name: String,
+    #[arg(long, default_value = "latest", help = "Plugin version channel or tag")]
+    pub version: String,
+    #[arg(long, help = "Install against linked project id")]
+    pub project_id: Option<String>,
+    #[arg(long, help = "Install against linked uproject path")]
+    pub uproject: Option<PathBuf>,
+    #[arg(
+        long,
+        help = "Install into Engine/Plugins/Marketplace instead of Project/Plugins"
+    )]
+    pub engine: bool,
+    #[arg(long, help = "Overwrite existing plugin directory")]
+    pub force: bool,
+    #[arg(
+        long,
+        help = "Override full plugin zip URL. If omitted, URL is composed from --base-url/--name/--version"
+    )]
+    pub url: Option<String>,
+    #[arg(
+        long,
+        default_value = DEFAULT_UNREAL_PLUGIN_BASE_URL,
+        help = "Public plugin bucket base URL"
+    )]
+    pub base_url: String,
+    #[arg(
+        long,
+        help = "Resolve plugin version/url from plugin index instead of using URL template"
+    )]
+    pub use_index: bool,
+    #[arg(
+        long,
+        default_value = "index.json",
+        help = "Plugin index path under base URL (used with --use-index)"
+    )]
+    pub index_path: String,
+    #[arg(long, help = "Expected SHA-256 hex for downloaded plugin zip")]
+    pub sha256: Option<String>,
+}
+
+#[derive(Args)]
+pub(crate) struct LinkPluginListArgs {
+    #[arg(
+        long,
+        default_value = DEFAULT_UNREAL_PLUGIN_BASE_URL,
+        help = "Public plugin bucket base URL"
+    )]
+    pub base_url: String,
+    #[arg(
+        long,
+        default_value = "index.json",
+        help = "Plugin index path under base URL"
+    )]
+    pub index_path: String,
+}
+
+pub(crate) async fn dispatch(client: &reqwest::Client, command: LinkCommands) -> Result<()> {
+    match command {
+        LinkCommands::Unreal(args) => crate::link_unreal_command(client, args).await?,
+        LinkCommands::List => crate::link_list_command().await?,
+        LinkCommands::Use(args) => crate::link_use_command(args).await?,
+        LinkCommands::Doctor(args) => crate::link_doctor_command(client, args).await?,
+        LinkCommands::Paths(args) => crate::link_paths_command(args).await?,
+        LinkCommands::Remove(args) => crate::link_remove_command(args).await?,
+        LinkCommands::Open(args) => crate::link_open_command(args).await?,
+        LinkCommands::Run(args) => crate::link_run_command(args).await?,
+        LinkCommands::Plugin { command } => match command {
+            LinkPluginCommands::Install(args) => crate::link_plugin_install_command(client, args).await?,
+            LinkPluginCommands::List(args) => crate::link_plugin_list_command(client, args).await?,
+        },
+    }
+    Ok(())
+}