crawlrs 0.2.0

crawlrs - Enterprise-grade web scraping and crawling platform built with Rust
Documentation
// Copyright (c) 2025-2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0

//! Task command handlers — POST/PUT/DELETE task mutation operations.
//!
//! 从 `task_handler.rs` 拆分出的命令类处理器。

#![allow(unused_variables)]

use crate::application::dto::task_query_request::{
    CancelledTaskInfoDto, FailedTaskInfoDto, TaskCancelDataDto, TaskCancelRequestDto,
};
use crate::domain::repositories::task_repository::TaskRepository;
use crate::presentation::errors::CrawlRsError;
use crate::presentation::handlers::response_builder::{json_rejection_error, ApiResponse};
use crate::presentation::middleware::auth_middleware::AuthState;
use axum::{extract::Extension, Json};
use chrono::Utc;
use sdforge::validator::Validate;
use std::sync::Arc;

use super::task_queries::wait_for_tasks_completion;

/// Cancel one or more tasks by their IDs.
///
/// # Arguments
///
/// * `auth_state` - Authenticated caller state (team ownership check).
/// * `task_repo` - Task repository for persistence.
/// * `request` - DTO containing task IDs and optional `force` flag.
///
/// # Errors
///
/// Returns `CrawlRsError` when validation fails, the repository errors, or
/// the caller does not own the requested tasks.
pub async fn cancel_tasks<T: TaskRepository>(
    Extension(auth_state): Extension<AuthState>,
    Extension(task_repo): Extension<Arc<T>>,
    payload: Result<Json<TaskCancelRequestDto>, axum::extract::rejection::JsonRejection>,
) -> Result<Json<ApiResponse<TaskCancelDataDto>>, CrawlRsError> {
    // 提取器级拒绝(非法 JSON / 字段缺失)映射为统一包封,避免纯文本响应
    // 绕过 ApiResponse 契约(结构错误 422 / 语法错误 400)
    let request = parse_cancel_request(payload)?;
    let team_id = auth_state.team_id;

    let force = request.force.unwrap_or(false);
    let sync_wait_ms = request.sync_wait_ms.unwrap_or(5000);

    // 执行批量取消(使用认证上下文的 team_id)
    let (cancelled_task_ids, failed_tasks) = task_repo
        .batch_cancel(request.task_ids.clone(), team_id, force) // 使用认证上下文的 team_id
        .await?;

    // 同步等待机制:如果指定了sync_wait_ms且有任务被取消,等待取消操作完成
    let sync_mode = sync_wait_ms > 0 && !cancelled_task_ids.is_empty();

    if sync_mode {
        // 智能轮询等待取消的任务状态更新完成
        // 取消操作使用更短的初始轮询间隔(500ms),更快响应取消状态变化
        wait_for_tasks_completion(
            task_repo.as_ref(),
            &cancelled_task_ids,
            team_id,
            sync_wait_ms,
            500, // 取消操作轮询间隔500ms
        )
        .await?;
    }

    Ok(build_cancel_response(cancelled_task_ids, failed_tasks))
}

/// 解析并校验取消请求:提取器拒绝、DTO 校验与空 ID 列表统一映射为 `CrawlRsError`。
fn parse_cancel_request(
    payload: Result<Json<TaskCancelRequestDto>, axum::extract::rejection::JsonRejection>,
) -> Result<TaskCancelRequestDto, CrawlRsError> {
    // 提取器级拒绝(非法 JSON / 字段缺失)映射为统一包封,避免纯文本响应
    // 绕过 ApiResponse 契约(结构错误 422 / 语法错误 400)
    let Json(request) = match payload {
        Ok(parsed) => parsed,
        Err(rej) => return Err(json_rejection_error(rej)),
    };

    if let Err(errors) = request.validate() {
        return Err(CrawlRsError::Unprocessable(
            crate::presentation::handlers::response_builder::validation_error_message(&errors),
        ));
    }

    if request.task_ids.is_empty() {
        return Err(CrawlRsError::Validation(
            "Task IDs cannot be empty".to_string(),
        ));
    }

    Ok(request)
}

/// 组装批量取消响应(成功取消项 + 失败项)。
fn build_cancel_response(
    cancelled_task_ids: Vec<crate::domain::id::Id>,
    failed_tasks: Vec<(crate::domain::id::Id, String)>,
) -> Json<ApiResponse<TaskCancelDataDto>> {
    let cancelled_tasks: Vec<CancelledTaskInfoDto> = cancelled_task_ids
        .into_iter()
        .map(|task_id| CancelledTaskInfoDto {
            task_id,
            status: "cancelled".to_string(),
            cancelled_at: Utc::now().into(),
        })
        .collect();

    let failed_tasks_info: Vec<FailedTaskInfoDto> = failed_tasks
        .into_iter()
        .map(|(task_id, reason)| FailedTaskInfoDto { task_id, reason })
        .collect();

    let total_cancelled = cancelled_tasks.len() as u64;
    let total_failed = failed_tasks_info.len() as u64;

    Json(ApiResponse::success(TaskCancelDataDto {
        cancelled_tasks,
        failed_tasks: failed_tasks_info,
        total_cancelled,
        total_failed,
    }))
}