use std::collections::BTreeMap;
use serde::{Deserialize, Serialize};
use wist_contracts::API_VERSION_V1;
pub const API_VERSION: &str = API_VERSION_V1;
pub const POLL_AGENT_METRICS_LABELS_KIND: &str = "poll_agent_metrics_labels";
pub const AGENT_METRICS_LABELS_KIND: &str = "agent_metrics_labels";
pub const ADMIN_METRICS_LABELS_KIND: &str = "admin_agent_metrics_labels";
pub const SET_AGENT_METRICS_LABELS_KIND: &str = "set_agent_metrics_labels";
pub mod label_source {
pub const DEFAULT: &str = "default";
pub const INFERRED: &str = "inferred";
pub const MANUAL: &str = "manual";
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct PollAgentMetricsLabels {
pub api_version: String,
pub kind: String,
pub agent_id: String,
pub instance_id: String,
#[serde(default)]
pub requested_at: String,
}
impl PollAgentMetricsLabels {
pub fn new(agent_id: &str, instance_id: &str, requested_at: &str) -> Self {
Self {
api_version: API_VERSION.to_string(),
kind: POLL_AGENT_METRICS_LABELS_KIND.to_string(),
agent_id: agent_id.to_string(),
instance_id: instance_id.to_string(),
requested_at: requested_at.to_string(),
}
}
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct AgentMetricsLabels {
pub api_version: String,
pub kind: String,
pub agent_id: String,
pub revision: u64,
pub labels: BTreeMap<String, String>,
#[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
pub sources: BTreeMap<String, String>,
pub updated_at: String,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct AgentMetricsLabelsView {
pub api_version: String,
pub kind: String,
pub agent_id: String,
pub revision: u64,
pub labels: BTreeMap<String, String>,
pub sources: BTreeMap<String, String>,
pub overrides: BTreeMap<String, String>,
pub updated_at: String,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct SetAgentMetricsLabelsRequest {
pub api_version: String,
pub kind: String,
pub overrides: BTreeMap<String, Option<String>>,
}
impl SetAgentMetricsLabelsRequest {
pub fn new(overrides: BTreeMap<String, Option<String>>) -> Self {
Self {
api_version: API_VERSION.to_string(),
kind: SET_AGENT_METRICS_LABELS_KIND.to_string(),
overrides,
}
}
}
impl AgentMetricsLabels {
pub fn new(
agent_id: &str,
revision: u64,
labels: BTreeMap<String, String>,
sources: BTreeMap<String, String>,
updated_at: &str,
) -> Self {
Self {
api_version: API_VERSION.to_string(),
kind: AGENT_METRICS_LABELS_KIND.to_string(),
agent_id: agent_id.to_string(),
revision,
labels,
sources,
updated_at: updated_at.to_string(),
}
}
}
#[cfg(test)]
mod tests {
use super::*;
fn sample_labels() -> BTreeMap<String, String> {
BTreeMap::from([
("app".to_string(), "kafka".to_string()),
("cluster".to_string(), "kafka-prod".to_string()),
("env".to_string(), "prod".to_string()),
])
}
#[test]
fn agent_response_round_trips() {
let payload = AgentMetricsLabels::new(
"agent-1",
7,
sample_labels(),
BTreeMap::from([
("app".to_string(), label_source::MANUAL.to_string()),
("cluster".to_string(), label_source::DEFAULT.to_string()),
("env".to_string(), label_source::DEFAULT.to_string()),
]),
"2026-11-03T07:00:00Z",
);
let json = serde_json::to_string(&payload).expect("serialize");
let parsed: AgentMetricsLabels = serde_json::from_str(&json).expect("deserialize");
assert_eq!(parsed, payload);
assert_eq!(parsed.kind, AGENT_METRICS_LABELS_KIND);
}
#[test]
fn empty_labels_are_a_valid_state() {
let payload = AgentMetricsLabels::new("agent-1", 0, BTreeMap::new(), BTreeMap::new(), "t");
let json = serde_json::to_string(&payload).expect("serialize");
let parsed: AgentMetricsLabels = serde_json::from_str(&json).expect("deserialize");
assert!(parsed.labels.is_empty());
}
#[test]
fn overrides_can_remove_a_key_with_null() {
let request = SetAgentMetricsLabelsRequest::new(BTreeMap::from([
("app".to_string(), Some("kafka".to_string())),
("role".to_string(), None),
]));
let json = serde_json::to_string(&request).expect("serialize");
assert!(json.contains("\"role\":null"));
let parsed: SetAgentMetricsLabelsRequest =
serde_json::from_str(&json).expect("deserialize");
assert_eq!(parsed.overrides.get("role"), Some(&None));
assert_eq!(
parsed
.overrides
.get("app")
.and_then(|value| value.as_deref()),
Some("kafka")
);
}
#[test]
fn the_poll_request_round_trips() {
let payload = PollAgentMetricsLabels::new("agent-1", "inst-1", "2026-11-03T07:00:00Z");
let json = serde_json::to_string(&payload).expect("serialize");
let parsed: PollAgentMetricsLabels = serde_json::from_str(&json).expect("deserialize");
assert_eq!(parsed, payload);
assert_eq!(parsed.kind, POLL_AGENT_METRICS_LABELS_KIND);
}
#[test]
fn unknown_fields_are_rejected() {
let json = r#"{"api_version":"v1","kind":"agent_metrics_labels","agent_id":"a","revision":1,"labels":{},"updated_at":"t","extra":1}"#;
assert!(serde_json::from_str::<AgentMetricsLabels>(json).is_err());
}
}