blvm-node 0.1.2

//! Error handling utilities for graceful degradation
//!
//! Provides helpers for common error handling patterns with logging and fallbacks.

use tracing::{debug, warn};

/// Execute an operation and log errors without failing
///
/// Returns `Some(T)` on success, `None` on error (after logging).
/// Useful for non-critical operations that should not stop execution.
///
/// # Example
/// ```rust,ignore
/// use blvm_node::utils::log_error;
///
/// let result = log_error(|| storage.flush(), "Failed to flush storage");
/// // If flush fails, logs warning and returns None, but execution continues
/// ```
pub fn log_error<F, T, E>(operation: F, context: &str) -> Option<T>
where
    F: FnOnce() -> Result<T, E>,
    E: std::fmt::Display,
{
    match operation() {
        Ok(value) => Some(value),
        Err(e) => {
            warn!("{}: {}", context, e);
            None
        }
    }
}

/// Execute an async operation and log errors without failing
///
/// Returns `Some(T)` on success, `None` on error (after logging).
/// Useful for non-critical async operations that should not stop execution.
///
/// # Example
/// ```rust,ignore
/// use blvm_node::utils::log_error_async;
///
/// let result = log_error_async(|| async { storage.flush() }, "Failed to flush storage").await;
/// ```
pub async fn log_error_async<F, Fut, T, E>(operation: F, context: &str) -> Option<T>
where
    F: FnOnce() -> Fut,
    Fut: std::future::Future<Output = Result<T, E>>,
    E: std::fmt::Display,
{
    match operation().await {
        Ok(value) => Some(value),
        Err(e) => {
            warn!("{}: {}", context, e);
            None
        }
    }
}

/// Execute an operation with a fallback on error
///
/// Returns the result of the primary operation on success, or the fallback on error.
/// Logs a warning when fallback is used.
///
/// # Example
/// ```rust,ignore
/// use blvm_node::utils::with_fallback;
///
/// let value = with_fallback(
///     || primary_operation(),
///     || fallback_operation(),
///     "Primary operation failed, using fallback"
/// );
/// ```
pub fn with_fallback<F1, F2, T, E>(primary: F1, fallback: F2, context: &str) -> T
where
    F1: FnOnce() -> Result<T, E>,
    F2: FnOnce() -> T,
    E: std::fmt::Display,
{
    match primary() {
        Ok(value) => value,
        Err(e) => {
            warn!("{}: {}", context, e);
            fallback()
        }
    }
}

/// Execute an async operation with a fallback on error
///
/// Returns the result of the primary operation on success, or the fallback on error.
/// Logs a warning when fallback is used.
pub async fn with_fallback_async<F1, Fut1, F2, Fut2, T, E>(
    primary: F1,
    fallback: F2,
    context: &str,
) -> T
where
    F1: FnOnce() -> Fut1,
    Fut1: std::future::Future<Output = Result<T, E>>,
    F2: FnOnce() -> Fut2,
    Fut2: std::future::Future<Output = T>,
    E: std::fmt::Display,
{
    match primary().await {
        Ok(value) => value,
        Err(e) => {
            warn!("{}: {}", context, e);
            fallback().await
        }
    }
}

/// Execute an operation and return a default value on error
///
/// Returns the result on success, or the default on error (after logging at debug level).
/// Useful for operations where failure is expected and a default is acceptable.
///
/// # Example
/// ```rust,ignore
/// use blvm_node::utils::with_default;
///
/// let count = with_default(|| get_count(), 0, "Failed to get count");
/// ```
pub fn with_default<F, T, E>(operation: F, default: T, context: &str) -> T
where
    F: FnOnce() -> Result<T, E>,
    E: std::fmt::Display,
{
    match operation() {
        Ok(value) => value,
        Err(e) => {
            debug!("{}: {}, using default", context, e);
            default
        }
    }
}

/// Execute an async operation and return a default value on error
pub async fn with_default_async<F, Fut, T, E>(operation: F, default: T, context: &str) -> T
where
    F: FnOnce() -> Fut,
    Fut: std::future::Future<Output = Result<T, E>>,
    E: std::fmt::Display,
{
    match operation().await {
        Ok(value) => value,
        Err(e) => {
            debug!("{}: {}, using default", context, e);
            default
        }
    }
}

/// Convert an Option to a Result with a context message
///
/// # Example
/// ```rust,ignore
/// use blvm_node::utils::err_option_to_result;
///
/// let value = err_option_to_result(opt, || "Value not found")?;
/// ```
pub fn err_option_to_result<T, F>(opt: Option<T>, context: F) -> Result<T, String>
where
    F: FnOnce() -> String,
{
    opt.ok_or_else(context)
}

/// Convert a Result to an Option, logging the error
///
/// Returns `Some(T)` on success, `None` on error (after logging).
pub fn result_to_option<T, E>(result: Result<T, E>, context: &str) -> Option<T>
where
    E: std::fmt::Display,
{
    match result {
        Ok(value) => Some(value),
        Err(e) => {
            warn!("{}: {}", context, e);
            None
        }
    }
}