errors.rs

//! Unified Create Command Errors
//!
//! This module defines a unified error type that encompasses all create subcommand errors,
//! providing a single interface for environment, template, schema, and CLI schema command errors.

use thiserror::Error;

use super::subcommands::{
    environment::CreateEnvironmentCommandError, schema::CreateSchemaCommandError,
    template::CreateEnvironmentTemplateCommandError,
};

/// Unified error type for all create subcommands
///
/// This error type provides a unified interface for errors that can occur during
/// any create subcommand execution (environment creation, template generation,
/// or schema generation).
/// It wraps the specific command errors while preserving their context and help methods.
#[derive(Debug, Error)]
pub enum CreateCommandError {
    /// Environment creation errors
    #[error(transparent)]
    Environment(#[from] CreateEnvironmentCommandError),

    /// Template generation errors
    #[error(transparent)]
    Template(#[from] CreateEnvironmentTemplateCommandError),

    /// Schema generation errors
    #[error(transparent)]
    Schema(#[from] CreateSchemaCommandError),
}

impl CreateCommandError {
    /// Get detailed troubleshooting guidance for this error
    ///
    /// This method delegates to the specific command error's help method,
    /// providing context-appropriate troubleshooting guidance.
    #[must_use]
    pub fn help(&self) -> String {
        match self {
            Self::Environment(err) => err.help().to_string(),
            Self::Template(err) => err.help().to_string(),
            Self::Schema(err) => err.help(),
        }
    }
}