openlark-docs 0.18.0

/// API通用工具函数（re-export core canonical + 本域 error 构造器）。
///
/// `serialize_params` / `extract_response_data` / `ensure_success` 已下沉到
/// `openlark_core::api`（#330），本模块 re-export canonical copy；保留 docs 域专用的
/// `missing_response_data_error`（bitable 等叶子直接复用其错误形状）。
use openlark_core::error;

// canonical HTTP 管道 helper（#330 下沉到 core）
pub use openlark_core::api::{ensure_success, extract_response_data, serialize_params};

const ERROR_COMPONENT: &str = "openlark-docs";

fn attach_standard_error_context(
    err: openlark_core::error::CoreError,
    operation: &str,
    resource: &str,
    request_id: Option<String>,
) -> openlark_core::error::CoreError {
    err.with_operation(operation, ERROR_COMPONENT)
        .map_context(|ctx| {
            ctx.add_context("resource", resource);
            if let Some(request_id) = request_id.filter(|value| !value.trim().is_empty()) {
                ctx.set_request_id(request_id);
            }
        })
}

/// 创建“响应 data 为空”的标准错误。
pub fn missing_response_data_error(
    resource: &str,
    request_id: Option<String>,
) -> openlark_core::error::CoreError {
    attach_standard_error_context(
        error::validation_error("response.data", "服务器没有返回有效的数据"),
        "extract_response_data",
        resource,
        request_id,
    )
}

#[cfg(test)]
mod tests {
    use super::*;
    use openlark_core::error::ErrorTrait;

    #[test]
    fn missing_response_data_error_attaches_context() {
        let err = missing_response_data_error("获取多维表格", Some("req-docs-456".to_string()));
        assert_eq!(err.context().operation(), Some("extract_response_data"));
        assert_eq!(err.context().component(), Some(ERROR_COMPONENT));
        assert_eq!(err.context().get_context("resource"), Some("获取多维表格"));
        assert_eq!(err.context().request_id(), Some("req-docs-456"));
    }
}