viewpoint-core 0.2.11

//! Core error types.

use std::time::Duration;
use thiserror::Error;

/// Errors that can occur in the core domain.
#[derive(Error, Debug)]
pub enum CoreError {
    /// CDP communication error.
    #[error("CDP error: {0}")]
    Cdp(#[from] viewpoint_cdp::CdpError),

    /// Browser error.
    #[error("browser error: {0}")]
    Browser(#[from] BrowserError),

    /// Context error.
    #[error("context error: {0}")]
    Context(#[from] ContextError),

    /// Page error.
    #[error("page error: {0}")]
    Page(#[from] PageError),

    /// Wait error.
    #[error("wait error: {0}")]
    Wait(#[from] WaitError),

    /// Navigation error.
    #[error("navigation error: {0}")]
    Navigation(#[from] NavigationError),

    /// Locator error.
    #[error("locator error: {0}")]
    Locator(#[from] LocatorError),

    /// Network error.
    #[error("network error: {0}")]
    Network(#[from] NetworkError),
}

/// Errors related to browser operations.
#[derive(Error, Debug)]
pub enum BrowserError {
    /// Chromium executable not found.
    #[error("Chromium not found. Set CHROMIUM_PATH environment variable or install Chromium.")]
    ChromiumNotFound,

    /// Failed to launch browser process.
    #[error("failed to launch browser: {0}")]
    LaunchFailed(String),

    /// Browser launch timed out.
    #[error("browser launch timeout after {0:?}")]
    LaunchTimeout(Duration),

    /// Failed to connect to browser.
    #[error("failed to connect to browser: {0}")]
    ConnectionFailed(String),

    /// Connection timed out.
    #[error("connection timeout after {0:?}")]
    ConnectionTimeout(Duration),

    /// Invalid endpoint URL.
    #[error("invalid endpoint URL: {0}")]
    InvalidEndpointUrl(String),

    /// Failed to discover WebSocket endpoint from HTTP endpoint.
    #[error("endpoint discovery failed: {0}")]
    EndpointDiscoveryFailed(String),

    /// Browser is already closed.
    #[error("browser is closed")]
    Closed,

    /// Context error during browser operation.
    #[error("context error: {0}")]
    Context(#[from] ContextError),

    /// CDP error during browser operation.
    #[error("CDP error: {0}")]
    Cdp(#[from] viewpoint_cdp::CdpError),
}

/// Errors related to browser context operations.
#[derive(Error, Debug)]
pub enum ContextError {
    /// Context is already closed.
    #[error("context is closed")]
    Closed,

    /// Failed to create context.
    #[error("failed to create context: {0}")]
    CreateFailed(String),

    /// Internal error.
    #[error("internal error: {0}")]
    Internal(String),

    /// Operation timed out.
    #[error("{operation} timed out after {duration:?}")]
    Timeout {
        /// The operation that timed out.
        operation: String,
        /// The duration before timeout.
        duration: Duration,
    },

    /// CDP error during context operation.
    #[error("CDP error: {0}")]
    Cdp(#[from] viewpoint_cdp::CdpError),
}

/// Errors related to page operations.
#[derive(Error, Debug)]
pub enum PageError {
    /// Page is already closed.
    #[error("page is closed")]
    Closed,

    /// Failed to create page.
    #[error("failed to create page: {0}")]
    CreateFailed(String),

    /// JavaScript evaluation failed.
    #[error("evaluation failed: {0}")]
    EvaluationFailed(String),

    /// CDP error during page operation.
    #[error("CDP error: {0}")]
    Cdp(#[from] viewpoint_cdp::CdpError),
}

/// Errors related to wait operations.
#[derive(Error, Debug)]
pub enum WaitError {
    /// Wait operation timed out.
    #[error("timeout after {0:?}")]
    Timeout(Duration),

    /// Wait operation was cancelled.
    #[error("wait cancelled")]
    Cancelled,

    /// Page was closed during wait.
    #[error("page closed during wait")]
    PageClosed,
}

/// Errors related to navigation operations.
#[derive(Error, Debug)]
pub enum NavigationError {
    /// Navigation timed out.
    #[error("navigation timeout after {0:?}")]
    Timeout(Duration),

    /// Network error during navigation.
    #[error("network error: {0}")]
    NetworkError(String),

    /// SSL certificate error.
    #[error("SSL error: {0}")]
    SslError(String),

    /// Navigation was cancelled.
    #[error("navigation cancelled")]
    Cancelled,

    /// CDP error during navigation.
    #[error("CDP error: {0}")]
    Cdp(#[from] viewpoint_cdp::CdpError),

    /// Wait error during navigation.
    #[error("wait error: {0}")]
    Wait(#[from] WaitError),
}

/// Errors related to locator operations.
#[derive(Error, Debug)]
pub enum LocatorError {
    /// Element not found.
    #[error("element not found: {0}")]
    NotFound(String),

    /// Multiple elements found when expecting one.
    #[error("strict mode violation: {0} elements found, expected 1")]
    StrictModeViolation(usize),

    /// Element is not visible.
    #[error("element is not visible")]
    NotVisible,

    /// Element is not enabled.
    #[error("element is not enabled")]
    NotEnabled,

    /// Element is not editable.
    #[error("element is not editable")]
    NotEditable,

    /// Operation timed out.
    #[error("timeout after {0:?}")]
    Timeout(Duration),

    /// JavaScript evaluation error.
    #[error("evaluation error: {0}")]
    EvaluationError(String),

    /// CDP error during locator operation.
    #[error("CDP error: {0}")]
    Cdp(#[from] viewpoint_cdp::CdpError),

    /// Page is closed.
    #[error("page is closed")]
    PageClosed,

    /// Touch not enabled.
    #[error(
        "touch not enabled: call page.enable_touch() or set hasTouch: true in browser context options before using touch actions"
    )]
    TouchNotEnabled,

    /// Wait error during action (e.g., navigation timeout after click).
    #[error("wait error: {0}")]
    WaitError(#[from] WaitError),
}

/// Errors related to network operations.
#[derive(Error, Debug)]
pub enum NetworkError {
    /// Route has already been handled.
    #[error("route has already been handled")]
    AlreadyHandled,

    /// Invalid response data.
    #[error("invalid response: {0}")]
    InvalidResponse(String),

    /// Request was aborted.
    #[error("request aborted")]
    Aborted,

    /// Request timed out.
    #[error("request timeout after {0:?}")]
    Timeout(Duration),

    /// No matching request/response found.
    #[error("no matching request/response found")]
    NotFound,

    /// IO error.
    #[error("IO error: {0}")]
    IoError(String),

    /// HAR parsing error.
    #[error("HAR error: {0}")]
    HarError(String),

    /// CDP error during network operation.
    #[error("CDP error: {0}")]
    Cdp(#[from] viewpoint_cdp::CdpError),
}