victauri-plugin 0.1.0

//! Typed error enums for the `victauri-plugin` crate.

/// Errors that can occur when building the Victauri plugin via [`crate::VictauriBuilder`].
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum BuilderError {
    #[error("invalid port {port}: {reason}")]
    InvalidPort { port: u16, reason: String },

    #[error("invalid event capacity {capacity}: {reason}")]
    InvalidEventCapacity { capacity: usize, reason: String },

    #[error("invalid recorder capacity {capacity}: {reason}")]
    InvalidRecorderCapacity { capacity: usize, reason: String },

    #[error("invalid eval timeout {timeout_secs}s: {reason}")]
    InvalidEvalTimeout { timeout_secs: u64, reason: String },
}

/// Errors that can occur during MCP server operation, tool execution, or webview interaction.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum PluginError {
    #[error("eval timed out after {timeout_secs}s")]
    EvalTimeout { timeout_secs: u64 },

    #[error("eval failed: {message}")]
    EvalFailed { message: String },

    #[error("too many concurrent eval requests (limit: {limit})")]
    EvalConcurrencyExceeded { limit: usize },

    #[error("bridge error: {message}")]
    BridgeError { message: String },

    #[error("screenshot failed: {message}")]
    ScreenshotFailed { message: String },

    #[error("authentication failed: {message}")]
    AuthenticationFailed { message: String },

    #[error("rate limit exceeded")]
    RateLimitExceeded,

    #[error("tool '{tool_name}' is disabled by privacy configuration")]
    ToolDisabled { tool_name: String },

    #[error("command '{command}' is blocked by privacy configuration")]
    CommandBlocked { command: String },

    #[error("window not found: {label}")]
    WindowNotFound { label: String },

    #[error("MCP server failed to start: {message}")]
    ServerStartFailed { message: String },

    #[error("port {port} is already in use")]
    PortInUse { port: u16 },

    #[error("serialization error: {0}")]
    Serialization(#[from] serde_json::Error),

    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("invalid URL: {message}")]
    InvalidUrl { message: String },

    #[error(transparent)]
    Core(#[from] victauri_core::VictauriError),
}

/// Convenience alias for `std::result::Result<T, PluginError>`.
pub type Result<T> = std::result::Result<T, PluginError>;