aether-protocol 0.9.3

// File: src/response.rs
// =============================================================================
// This file defines the top-level `Response` enum. This is the single, unified
// type that represents every possible reply the server can send to a client.

use crate::types::{BatchResponse, DbStats, Record, RecordSet};
use serde::{Deserialize, Serialize};

/// A struct to hold performance metrics for a query.
#[derive(Serialize, Deserialize, Debug, PartialEq)]
pub struct QueryMetrics {
    pub execution_time_micros: u64,
    // We can add more later, like records_scanned, etc.
}

/// The primary enum representing all possible server responses.
#[derive(Serialize, Deserialize, Debug, PartialEq)]
pub enum Response {
    // --- General Responses ---
    Success,
    Error(String),

    // --- Database Management Responses ---
    DatabaseList(Vec<String>),
    DatabaseCreated(bool),
    DatabaseDropped(bool),

    // --- Collection Management Responses ---
    CollectionList(Vec<String>),
    Stats(DbStats),
    IndexList(Vec<String>),

    // --- Record & Query Responses ---
    Record(Option<Record>),
    RecordSet(RecordSet),
    RecordCount(u64),
    RecordDeleted(bool),
    LastInsertId(u64),
    RecordWithRelated(Option<(Record, Record)>),
    BatchResponse(BatchResponse),
    RecordIdSet(Vec<String>),

    /// A special response that wraps another response and includes performance data.
    ResultMetrics {
        data: Box<Response>, // The original response (e.g., RecordSet)
        metrics: QueryMetrics,
    },
}