linger-openai-sdk 0.1.1

use crate::error::LingerError;
use crate::RequestId;
use serde::{Deserialize, Deserializer, Serialize};
use serde_json::Value;
use std::collections::BTreeMap;

/// EN: Request body for `POST /v1/fine_tuning/jobs`.
/// 中文：`POST /v1/fine_tuning/jobs` 的请求体。
#[derive(Clone, Debug, Serialize, PartialEq)]
#[non_exhaustive]
pub struct CreateFineTuningJobRequest {
    /// EN: Base model to fine-tune.
    /// 中文：要微调的基础模型。
    pub model: String,
    /// EN: Uploaded training file id.
    /// 中文：已上传的训练文件 ID。
    pub training_file: String,
    /// EN: Optional uploaded validation file id.
    /// 中文：可选的已上传验证文件 ID。
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation_file: Option<String>,
    /// EN: Optional suffix for the fine-tuned model name.
    /// 中文：微调后模型名称的可选后缀。
    #[serde(skip_serializing_if = "Option::is_none")]
    pub suffix: Option<String>,
    /// EN: Optional seed for reproducibility.
    /// 中文：用于可复现性的可选 seed。
    #[serde(skip_serializing_if = "Option::is_none")]
    pub seed: Option<u64>,
    /// EN: Optional metadata attached to the job.
    /// 中文：附加到任务的可选元数据。
    #[serde(skip_serializing_if = "BTreeMap::is_empty")]
    pub metadata: BTreeMap<String, String>,
    /// EN: Forward-compatible optional fields not yet covered by handwritten types.
    /// 中文：手写类型尚未覆盖的前向兼容可选字段。
    #[serde(flatten)]
    pub extra: BTreeMap<String, Value>,
}

impl CreateFineTuningJobRequest {
    /// EN: Starts building a fine-tuning job request.
    /// 中文：开始构建 fine-tuning job 请求。
    pub fn builder() -> CreateFineTuningJobRequestBuilder {
        CreateFineTuningJobRequestBuilder::default()
    }
}

/// EN: Builder for create-fine-tuning-job requests.
/// 中文：创建 fine-tuning job 请求的构建器。
#[derive(Clone, Debug, Default)]
#[non_exhaustive]
pub struct CreateFineTuningJobRequestBuilder {
    model: Option<String>,
    training_file: Option<String>,
    validation_file: Option<String>,
    suffix: Option<String>,
    seed: Option<u64>,
    metadata: BTreeMap<String, String>,
    extra: BTreeMap<String, Value>,
}

impl CreateFineTuningJobRequestBuilder {
    /// EN: Sets the base model id.
    /// 中文：设置基础模型 ID。
    pub fn model(mut self, model: impl Into<String>) -> Self {
        self.model = Some(model.into());
        self
    }

    /// EN: Sets the uploaded training file id.
    /// 中文：设置已上传的训练文件 ID。
    pub fn training_file(mut self, training_file: impl Into<String>) -> Self {
        self.training_file = Some(training_file.into());
        self
    }

    /// EN: Sets the optional validation file id.
    /// 中文：设置可选的验证文件 ID。
    pub fn validation_file(mut self, validation_file: impl Into<String>) -> Self {
        self.validation_file = Some(validation_file.into());
        self
    }

    /// EN: Sets the optional model suffix.
    /// 中文：设置可选的模型后缀。
    pub fn suffix(mut self, suffix: impl Into<String>) -> Self {
        self.suffix = Some(suffix.into());
        self
    }

    /// EN: Sets the optional reproducibility seed.
    /// 中文：设置可选的可复现 seed。
    pub fn seed(mut self, seed: u64) -> Self {
        self.seed = Some(seed);
        self
    }

    /// EN: Adds a metadata entry.
    /// 中文：添加一项元数据。
    pub fn metadata(mut self, key: impl Into<String>, value: impl Into<String>) -> Self {
        self.metadata.insert(key.into(), value.into());
        self
    }

    /// EN: Adds a forward-compatible JSON field.
    /// 中文：添加前向兼容的 JSON 字段。
    pub fn extra(mut self, name: impl Into<String>, value: Value) -> Self {
        self.extra.insert(name.into(), value);
        self
    }

    /// EN: Builds and validates the request.
    /// 中文：构建并校验请求。
    pub fn build(self) -> Result<CreateFineTuningJobRequest, LingerError> {
        let model = self
            .model
            .filter(|value| !value.trim().is_empty())
            .ok_or_else(|| LingerError::invalid_config("model is required"))?;
        let training_file = self
            .training_file
            .filter(|value| !value.trim().is_empty())
            .ok_or_else(|| LingerError::invalid_config("training_file is required"))?;
        if self
            .validation_file
            .as_ref()
            .is_some_and(|value| value.trim().is_empty())
        {
            return Err(LingerError::invalid_config(
                "validation_file must not be empty",
            ));
        }
        if self
            .suffix
            .as_ref()
            .is_some_and(|value| value.trim().is_empty())
        {
            return Err(LingerError::invalid_config("suffix must not be empty"));
        }
        if self
            .metadata
            .iter()
            .any(|(key, value)| key.trim().is_empty() || value.is_empty())
        {
            return Err(LingerError::invalid_config(
                "metadata keys and values must not be empty",
            ));
        }
        Ok(CreateFineTuningJobRequest {
            model,
            training_file,
            validation_file: self.validation_file,
            suffix: self.suffix,
            seed: self.seed,
            metadata: self.metadata,
            extra: self.extra,
        })
    }
}

/// EN: Request body for checkpoint permission creation.
/// 中文：创建 checkpoint permission 的请求体。
#[derive(Clone, Debug, Serialize, PartialEq, Eq)]
#[non_exhaustive]
pub struct CreateFineTuningCheckpointPermissionRequest {
    /// EN: Project ids to grant access to.
    /// 中文：要授予访问权限的项目 ID。
    pub project_ids: Vec<String>,
}

impl CreateFineTuningCheckpointPermissionRequest {
    /// EN: Creates and validates a checkpoint-permission request.
    /// 中文：创建并校验 checkpoint permission 请求。
    pub fn new<I, T>(project_ids: I) -> Result<Self, LingerError>
    where
        I: IntoIterator<Item = T>,
        T: Into<String>,
    {
        let project_ids = project_ids.into_iter().map(Into::into).collect::<Vec<_>>();
        if project_ids.is_empty() || project_ids.iter().any(|value| value.trim().is_empty()) {
            return Err(LingerError::invalid_config("project_ids is required"));
        }
        Ok(Self { project_ids })
    }
}

/// EN: Request body for `POST /v1/fine_tuning/alpha/graders/validate`.
/// 中文：`POST /v1/fine_tuning/alpha/graders/validate` 的请求体。
#[derive(Clone, Debug, Serialize, PartialEq)]
#[non_exhaustive]
pub struct ValidateFineTuningGraderRequest {
    /// EN: Grader definition to validate.
    /// 中文：要校验的 grader 定义。
    pub grader: Value,
}

impl ValidateFineTuningGraderRequest {
    /// EN: Starts building a grader validation request.
    /// 中文：开始构建 grader 校验请求。
    pub fn builder() -> ValidateFineTuningGraderRequestBuilder {
        ValidateFineTuningGraderRequestBuilder::default()
    }
}

/// EN: Builder for grader validation requests.
/// 中文：grader 校验请求的构建器。
#[derive(Clone, Debug, Default)]
#[non_exhaustive]
pub struct ValidateFineTuningGraderRequestBuilder {
    grader: Option<Value>,
}

impl ValidateFineTuningGraderRequestBuilder {
    /// EN: Sets the grader definition to validate.
    /// 中文：设置要校验的 grader 定义。
    pub fn grader(mut self, grader: Value) -> Self {
        self.grader = Some(grader);
        self
    }

    /// EN: Builds and validates the request.
    /// 中文：构建并校验请求。
    pub fn build(self) -> Result<ValidateFineTuningGraderRequest, LingerError> {
        let grader = self
            .grader
            .filter(|value| !value.is_null())
            .ok_or_else(|| LingerError::invalid_config("grader is required"))?;
        Ok(ValidateFineTuningGraderRequest { grader })
    }
}

/// EN: Response returned after validating a fine-tuning grader.
/// 中文：校验 fine-tuning grader 后返回的响应。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningGraderValidation {
    /// EN: Validated grader definition.
    /// 中文：已校验的 grader 定义。
    pub grader: Value,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningGraderValidation {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

/// EN: Request body for `POST /v1/fine_tuning/alpha/graders/run`.
/// 中文：`POST /v1/fine_tuning/alpha/graders/run` 的请求体。
#[derive(Clone, Debug, Serialize, PartialEq)]
#[non_exhaustive]
pub struct RunFineTuningGraderRequest {
    /// EN: Grader definition to run.
    /// 中文：要运行的 grader 定义。
    pub grader: Value,
    /// EN: Optional dataset item used to populate the `item` namespace.
    /// 中文：可选的数据集条目，用于填充 `item` 命名空间。
    #[serde(skip_serializing_if = "Option::is_none")]
    pub item: Option<Value>,
    /// EN: Model sample to evaluate.
    /// 中文：要评估的模型样本。
    pub model_sample: String,
}

impl RunFineTuningGraderRequest {
    /// EN: Starts building a grader run request.
    /// 中文：开始构建 grader run 请求。
    pub fn builder() -> RunFineTuningGraderRequestBuilder {
        RunFineTuningGraderRequestBuilder::default()
    }
}

/// EN: Builder for grader run requests.
/// 中文：grader run 请求的构建器。
#[derive(Clone, Debug, Default)]
#[non_exhaustive]
pub struct RunFineTuningGraderRequestBuilder {
    grader: Option<Value>,
    item: Option<Value>,
    model_sample: Option<String>,
}

impl RunFineTuningGraderRequestBuilder {
    /// EN: Sets the grader definition to run.
    /// 中文：设置要运行的 grader 定义。
    pub fn grader(mut self, grader: Value) -> Self {
        self.grader = Some(grader);
        self
    }

    /// EN: Sets the optional dataset item.
    /// 中文：设置可选的数据集条目。
    pub fn item(mut self, item: Value) -> Self {
        self.item = Some(item);
        self
    }

    /// EN: Sets the model sample to evaluate.
    /// 中文：设置要评估的模型样本。
    pub fn model_sample(mut self, model_sample: impl Into<String>) -> Self {
        self.model_sample = Some(model_sample.into());
        self
    }

    /// EN: Builds and validates the request.
    /// 中文：构建并校验请求。
    pub fn build(self) -> Result<RunFineTuningGraderRequest, LingerError> {
        let grader = self
            .grader
            .filter(|value| !value.is_null())
            .ok_or_else(|| LingerError::invalid_config("grader is required"))?;
        let model_sample = self
            .model_sample
            .filter(|value| !value.trim().is_empty())
            .ok_or_else(|| LingerError::invalid_config("model_sample is required"))?;
        Ok(RunFineTuningGraderRequest {
            grader,
            item: self.item,
            model_sample,
        })
    }
}

/// EN: Response returned after running a fine-tuning grader.
/// 中文：运行 fine-tuning grader 后返回的响应。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningGraderRun {
    /// EN: Numeric reward produced by the grader.
    /// 中文：grader 产生的数值 reward。
    pub reward: f64,
    /// EN: Grader execution metadata.
    /// 中文：grader 执行元数据。
    pub metadata: Value,
    /// EN: Sub-rewards returned by composite graders.
    /// 中文：组合 grader 返回的子 reward。
    pub sub_rewards: Value,
    /// EN: Model grader token usage grouped by model.
    /// 中文：按模型分组的 model grader token 用量。
    pub model_grader_token_usage_per_model: Value,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningGraderRun {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

/// EN: Fine-tuning job object returned by the API.
/// 中文：API 返回的 fine-tuning job 对象。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningJob {
    /// EN: Fine-tuning job id.
    /// 中文：fine-tuning job ID。
    pub id: String,
    /// EN: API object type.
    /// 中文：API 对象类型。
    pub object: String,
    /// EN: Base model.
    /// 中文：基础模型。
    pub model: String,
    /// EN: Unix timestamp for creation.
    /// 中文：创建时间的 Unix 时间戳。
    pub created_at: u64,
    /// EN: Fine-tuned model id, when available.
    /// 中文：可用时的微调后模型 ID。
    #[serde(default)]
    pub fine_tuned_model: Option<String>,
    /// EN: Organization id that owns the job.
    /// 中文：拥有该任务的组织 ID。
    #[serde(default)]
    pub organization_id: Option<String>,
    /// EN: Result file ids.
    /// 中文：结果文件 ID。
    #[serde(default)]
    pub result_files: Vec<String>,
    /// EN: Current job status.
    /// 中文：当前任务状态。
    pub status: String,
    /// EN: Validation file id, when present.
    /// 中文：验证文件 ID，如存在。
    #[serde(default)]
    pub validation_file: Option<String>,
    /// EN: Training file id.
    /// 中文：训练文件 ID。
    pub training_file: String,
    /// EN: Hyperparameter details returned by the API.
    /// 中文：API 返回的超参数详情。
    #[serde(default)]
    pub hyperparameters: Value,
    /// EN: Number of trained tokens, when returned.
    /// 中文：训练 token 数，如响应中存在。
    #[serde(default)]
    pub trained_tokens: Option<u64>,
    /// EN: Job error details, when returned.
    /// 中文：任务错误详情，如响应中存在。
    #[serde(default)]
    pub error: Option<Value>,
    /// EN: Estimated finish timestamp, when returned.
    /// 中文：预计完成时间戳，如响应中存在。
    #[serde(default)]
    pub estimated_finish: Option<u64>,
    /// EN: Integration descriptors returned by the API.
    /// 中文：API 返回的集成描述。
    #[serde(default)]
    pub integrations: Vec<Value>,
    /// EN: Seed used for the job, when returned.
    /// 中文：任务使用的 seed，如响应中存在。
    #[serde(default)]
    pub seed: Option<u64>,
    /// EN: Metadata returned with this job.
    /// 中文：此任务返回的元数据。
    #[serde(default, deserialize_with = "deserialize_null_default")]
    pub metadata: BTreeMap<String, String>,
    /// EN: Fine-tuning method details.
    /// 中文：fine-tuning 方法详情。
    #[serde(default)]
    pub method: Value,
    /// EN: Additional fields preserved for forward compatibility.
    /// 中文：为前向兼容保留的额外字段。
    #[serde(flatten)]
    pub extra: BTreeMap<String, Value>,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningJob {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

/// EN: Paginated fine-tuning job list.
/// 中文：分页 fine-tuning job 列表。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningJobPage {
    /// EN: API list object type.
    /// 中文：API 列表对象类型。
    pub object: String,
    /// EN: Jobs on this page.
    /// 中文：本页任务。
    #[serde(default)]
    pub data: Vec<FineTuningJob>,
    /// EN: First job id on this page.
    /// 中文：本页第一个任务 ID。
    #[serde(default)]
    pub first_id: Option<String>,
    /// EN: Last job id on this page.
    /// 中文：本页最后一个任务 ID。
    #[serde(default)]
    pub last_id: Option<String>,
    /// EN: Whether more jobs are available.
    /// 中文：是否还有更多任务。
    pub has_more: bool,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningJobPage {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

/// EN: Fine-tuning job event.
/// 中文：fine-tuning job 事件。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningEvent {
    /// EN: Event id.
    /// 中文：事件 ID。
    pub id: String,
    /// EN: API object type.
    /// 中文：API 对象类型。
    pub object: String,
    /// EN: Unix timestamp for event creation.
    /// 中文：事件创建时间的 Unix 时间戳。
    pub created_at: u64,
    /// EN: Event level.
    /// 中文：事件级别。
    pub level: String,
    /// EN: Human-readable event message.
    /// 中文：可读事件消息。
    pub message: String,
    /// EN: Event type, when returned.
    /// 中文：事件类型，如响应中存在。
    #[serde(default)]
    pub r#type: Option<String>,
    /// EN: Additional fields preserved for forward compatibility.
    /// 中文：为前向兼容保留的额外字段。
    #[serde(flatten)]
    pub extra: BTreeMap<String, Value>,
}

/// EN: Paginated fine-tuning event list.
/// 中文：分页 fine-tuning 事件列表。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningEventPage {
    /// EN: API list object type.
    /// 中文：API 列表对象类型。
    pub object: String,
    /// EN: Events on this page.
    /// 中文：本页事件。
    #[serde(default)]
    pub data: Vec<FineTuningEvent>,
    /// EN: First event id on this page.
    /// 中文：本页第一个事件 ID。
    #[serde(default)]
    pub first_id: Option<String>,
    /// EN: Last event id on this page.
    /// 中文：本页最后一个事件 ID。
    #[serde(default)]
    pub last_id: Option<String>,
    /// EN: Whether more events are available.
    /// 中文：是否还有更多事件。
    pub has_more: bool,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningEventPage {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

/// EN: Fine-tuning job checkpoint.
/// 中文：fine-tuning job 检查点。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningCheckpoint {
    /// EN: Checkpoint id.
    /// 中文：检查点 ID。
    pub id: String,
    /// EN: API object type.
    /// 中文：API 对象类型。
    pub object: String,
    /// EN: Unix timestamp for checkpoint creation.
    /// 中文：检查点创建时间的 Unix 时间戳。
    pub created_at: u64,
    /// EN: Fine-tuned checkpoint model id.
    /// 中文：微调检查点模型 ID。
    pub fine_tuned_model_checkpoint: String,
    /// EN: Fine-tuning job id.
    /// 中文：fine-tuning job ID。
    pub fine_tuning_job_id: String,
    /// EN: Step number for this checkpoint.
    /// 中文：此检查点的步数。
    pub step_number: u64,
    /// EN: Metrics returned for this checkpoint.
    /// 中文：此检查点返回的指标。
    #[serde(default)]
    pub metrics: BTreeMap<String, Value>,
    /// EN: Additional fields preserved for forward compatibility.
    /// 中文：为前向兼容保留的额外字段。
    #[serde(flatten)]
    pub extra: BTreeMap<String, Value>,
}

/// EN: Paginated fine-tuning checkpoint list.
/// 中文：分页 fine-tuning 检查点列表。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq)]
#[non_exhaustive]
pub struct FineTuningCheckpointPage {
    /// EN: API list object type.
    /// 中文：API 列表对象类型。
    pub object: String,
    /// EN: Checkpoints on this page.
    /// 中文：本页检查点。
    #[serde(default)]
    pub data: Vec<FineTuningCheckpoint>,
    /// EN: First checkpoint id on this page.
    /// 中文：本页第一个检查点 ID。
    #[serde(default)]
    pub first_id: Option<String>,
    /// EN: Last checkpoint id on this page.
    /// 中文：本页最后一个检查点 ID。
    #[serde(default)]
    pub last_id: Option<String>,
    /// EN: Whether more checkpoints are available.
    /// 中文：是否还有更多检查点。
    pub has_more: bool,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningCheckpointPage {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

/// EN: A permission for a fine-tuned model checkpoint.
/// 中文：微调模型 checkpoint 的权限对象。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
#[non_exhaustive]
pub struct FineTuningCheckpointPermission {
    /// EN: Permission id.
    /// 中文：权限 ID。
    pub id: String,
    /// EN: API object type, normally `checkpoint.permission`.
    /// 中文：API 对象类型，通常为 `checkpoint.permission`。
    pub object: String,
    /// EN: Unix timestamp for permission creation.
    /// 中文：权限创建时间的 Unix 时间戳。
    pub created_at: u64,
    /// EN: Project id this permission grants access to.
    /// 中文：此权限授予访问权限的项目 ID。
    pub project_id: String,
}

/// EN: Paginated checkpoint permission list.
/// 中文：分页 checkpoint permission 列表。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
#[non_exhaustive]
pub struct FineTuningCheckpointPermissionPage {
    /// EN: API list object type.
    /// 中文：API 列表对象类型。
    pub object: String,
    /// EN: Permissions on this page.
    /// 中文：本页权限。
    #[serde(default)]
    pub data: Vec<FineTuningCheckpointPermission>,
    /// EN: First permission id on this page.
    /// 中文：本页第一个权限 ID。
    #[serde(default)]
    pub first_id: Option<String>,
    /// EN: Last permission id on this page.
    /// 中文：本页最后一个权限 ID。
    #[serde(default)]
    pub last_id: Option<String>,
    /// EN: Whether more permissions are available.
    /// 中文：是否还有更多权限。
    pub has_more: bool,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningCheckpointPermissionPage {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

/// EN: Deletion result returned for checkpoint permissions.
/// 中文：checkpoint permission 的删除结果。
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
#[non_exhaustive]
pub struct FineTuningCheckpointPermissionDeletion {
    /// EN: Deleted permission id.
    /// 中文：已删除的权限 ID。
    pub id: String,
    /// EN: API object type, normally `checkpoint.permission`.
    /// 中文：API 对象类型，通常为 `checkpoint.permission`。
    pub object: String,
    /// EN: Whether the permission was deleted.
    /// 中文：权限是否已删除。
    pub deleted: bool,
    /// EN: OpenAI request id from response headers.
    /// 中文：响应头中的 OpenAI 请求 ID。
    #[serde(skip)]
    request_id: Option<RequestId>,
}

impl FineTuningCheckpointPermissionDeletion {
    pub(crate) fn with_request_id(mut self, request_id: Option<RequestId>) -> Self {
        self.request_id = request_id;
        self
    }

    /// EN: Returns the OpenAI request id, when present.
    /// 中文：返回 OpenAI 请求 ID，如存在。
    pub fn request_id(&self) -> Option<&RequestId> {
        self.request_id.as_ref()
    }
}

fn deserialize_null_default<'de, D, T>(deserializer: D) -> Result<T, D::Error>
where
    D: Deserializer<'de>,
    T: Deserialize<'de> + Default,
{
    Ok(Option::<T>::deserialize(deserializer)?.unwrap_or_default())
}