use crate::models::{
    AsyncTaskResponse, CancelResponse, DeleteResponse, HealthResponse, ModelInfo, ModelsResponse,
    RetryResponse, Segment, TaskPriority, TaskStatsResponse, TaskStatus, TaskStatusResponse,
    TranscriptionResponse,
};
use crate::server::handlers;
use utoipa::OpenApi;
use utoipa_swagger_ui::SwaggerUi;

/// OpenAPI specification for Voice CLI API
#[derive(OpenApi)]
#[openapi(
    info(
        title = "Voice CLI API",
        version = "0.1.0",
        description = "Speech-to-text HTTP service with Whisper model support",
        license(
            name = "MIT",
        ),
        contact(
            name = "Voice CLI Support",
            email = "support@voice-cli.dev"
        )
    ),
    servers(
        (url = "http://localhost:8080", description = "Local development server"),
        (url = "https://api.voice-cli.dev", description = "Production server")
    ),
    paths(
        handlers::health_handler,
        handlers::models_list_handler,
        handlers::transcribe_handler,
        handlers::transcribe_from_url_handler,
        handlers::async_transcribe_handler,
        handlers::get_task_handler,
        handlers::cancel_task_handler,
        handlers::get_task_result_handler,
        handlers::delete_task_handler,
        handlers::retry_task_handler,
        handlers::get_tasks_stats_handler,
        handlers::tts_sync_handler,
    ),
    components(
        schemas(
            TranscriptionResponse,
            Segment,
            HealthResponse,
            ModelsResponse,
            ModelInfo,
            AsyncTaskResponse,
            TaskStatusResponse,
            TaskStatus,
            TaskPriority,
            CancelResponse,
            DeleteResponse,
            RetryResponse,
            TaskStatsResponse
        )
    ),
    tags(
        (name = "Health", description = "Service health and status endpoints"),
        (name = "Models", description = "Whisper model management endpoints"),
        (name = "Transcription", description = "Speech-to-text transcription endpoints"),
        (name = "Async Transcription", description = "Asynchronous transcription task management"),
        (name = "Task Management", description = "Task lifecycle and monitoring endpoints")
    ),
    external_docs(
        url = "https://github.com/your-org/voice-cli",
        description = "Voice CLI GitHub Repository"
    )
)]
pub struct ApiDoc;

/// Create Swagger UI service
pub fn create_swagger_ui() -> SwaggerUi {
    SwaggerUi::new("/api/docs")
        .url("/api/docs/openapi.json", ApiDoc::openapi())
        .config(utoipa_swagger_ui::Config::new(["/api/docs/openapi.json"]))
}

/// Get OpenAPI JSON specification
pub fn get_openapi_json() -> utoipa::openapi::OpenApi {
    ApiDoc::openapi()
}