uqa-client 0.2.3

Authenticated HTTP Engine client for local and Cloud UQA data planes
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//
// Unified Query Algebra
//
// Copyright (c) 2023-2026 Cognica, Inc.
//

use std::collections::BTreeMap;
use std::fmt;

use serde::{Deserialize, Serialize};
use uqa_core::Value;

/// One decoded frame from the stable UQA NDJSON SQL stream.
#[derive(Clone, Deserialize, PartialEq, Serialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum SQLStreamFrame {
    Metadata {
        columns: Vec<String>,
        row_count: usize,
        spilled_to_disk: bool,
        request_id: String,
    },
    Row {
        row: BTreeMap<String, Value>,
    },
    Complete {
        row_count: usize,
        request_id: String,
    },
    Error {
        code: String,
        message: String,
        request_id: String,
    },
}

impl SQLStreamFrame {
    pub fn request_id(&self) -> Option<&str> {
        match self {
            Self::Metadata { request_id, .. }
            | Self::Complete { request_id, .. }
            | Self::Error { request_id, .. } => Some(request_id),
            Self::Row { .. } => None,
        }
    }

    pub const fn is_terminal(&self) -> bool {
        matches!(self, Self::Complete { .. } | Self::Error { .. })
    }
}

impl fmt::Debug for SQLStreamFrame {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        formatter.write_str("SQLStreamFrame([REDACTED])")
    }
}