use actix_web::{HttpResponse, web};
use serde::Deserialize;
use utoipa::IntoParams;

use crate::api::response::{ApiErrorResponse, ApiResponse};
use crate::error::AppError;
use crate::models::repos::RepoStats;
use crate::service::AppService;
use crate::session::Session;

#[derive(Debug, Deserialize, IntoParams)]
pub struct PathParams {
    /// Workspace name (unique identifier)
    pub workspace_name: String,
    /// Repository name (unique within the workspace)
    pub repo_name: String,
}

/// Refresh repository statistics
///
/// Recalculates and updates repository statistics from the current state of the repository.
/// Requires Admin role or higher in the repository.
///
/// Effects:
/// - Recalculates star, watcher, and fork counts
/// - Recalculates branch and tag counts
/// - Recalculates commit count from Git history
/// - Recalculates release count
/// - Recalculates open issues and pull requests count
/// - Updates storage size and bandwidth usage
/// - Updates last push timestamp
///
/// Returns the refreshed statistics with all updated values.
#[utoipa::path(
    post,
    path = "/api/v1/workspaces/{workspace_name}/repos/{repo_name}/stats/refresh",
    tag = "Repos",
    operation_id = "repoRefreshStats",
    params(PathParams),
    responses(
        (status = 200, description = "Repository statistics refreshed successfully. Returns all updated metrics.", body = ApiResponse<RepoStats>),
        (status = 401, description = "Authentication required or session expired", body = ApiErrorResponse),
        (status = 403, description = "Insufficient permissions (requires Admin role or higher)", body = ApiErrorResponse),
        (status = 404, description = "Repository or workspace not found", body = ApiErrorResponse),
        (status = 500, description = "Internal server error or Git operation failed", body = ApiErrorResponse),
    ),
    security(
        ("session_cookie" = [])
    )
)]
pub async fn refresh_stats(
    service: web::Data<AppService>,
    session: Session,
    path: web::Path<PathParams>,
) -> Result<HttpResponse, AppError> {
    let stats = service
        .repo
        .repo_refresh_stats(&session, &path.workspace_name, &path.repo_name)
        .await?;

    Ok(HttpResponse::Ok().json(ApiResponse::new(stats)))
}