use serde::{Deserialize, Serialize};
use serde_json::Value;
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct StreamMetadata {
#[serde(default)]
pub provenance: Vec<String>,
#[serde(default)]
pub plexus_hash: String,
#[serde(default)]
pub timestamp: i64,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum StreamItem {
Data {
#[serde(default, skip_serializing_if = "Option::is_none")]
metadata: Option<StreamMetadata>,
#[serde(default, skip_serializing_if = "Option::is_none")]
content_type: Option<String>,
content: Value,
},
Progress {
#[serde(default, skip_serializing_if = "Option::is_none")]
metadata: Option<StreamMetadata>,
message: String,
#[serde(default, skip_serializing_if = "Option::is_none")]
percentage: Option<f32>,
},
Error {
#[serde(default, skip_serializing_if = "Option::is_none")]
metadata: Option<StreamMetadata>,
message: String,
#[serde(default, skip_serializing_if = "Option::is_none")]
code: Option<String>,
#[serde(default)]
recoverable: bool,
},
#[serde(rename_all = "camelCase")]
Request {
request_id: String,
request_data: Value,
#[serde(default)]
timeout_ms: u64,
},
Done {
#[serde(default, skip_serializing_if = "Option::is_none")]
metadata: Option<StreamMetadata>,
},
}
impl StreamItem {
pub fn data(content: Value) -> Self {
StreamItem::Data {
metadata: None,
content_type: None,
content,
}
}
pub fn done() -> Self {
StreamItem::Done { metadata: None }
}
pub fn is_terminal(&self) -> bool {
matches!(self, StreamItem::Done { .. } | StreamItem::Error { .. })
}
pub fn metadata(&self) -> Option<&StreamMetadata> {
match self {
StreamItem::Data { metadata, .. }
| StreamItem::Progress { metadata, .. }
| StreamItem::Error { metadata, .. }
| StreamItem::Done { metadata } => metadata.as_ref(),
StreamItem::Request { .. } => None,
}
}
}