use serde::{Deserialize, Serialize};
use wist_contracts::API_VERSION_V1;
pub const API_VERSION: &str = API_VERSION_V1;
pub const POLL_DISCOVERY_SNAPSHOT_KIND: &str = "poll_discovery_snapshot";
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct AppliedDiscoverySnapshot {
pub enabled: bool,
pub interval_seconds: u64,
pub source: String,
}
impl AppliedDiscoverySnapshot {
pub fn control_plane(&self) -> bool {
self.source == APPLIED_SOURCE_CONTROL_PLANE
}
}
pub const APPLIED_SOURCE_CONTROL_PLANE: &str = "control_plane";
pub const APPLIED_SOURCE_LOCAL_CONFIG: &str = "local_config";
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct PollDiscoverySnapshot {
pub api_version: String,
pub kind: String,
pub agent_id: String,
pub instance_id: String,
pub requested_at: String,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub applied: Option<AppliedDiscoverySnapshot>,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct DiscoverySnapshotGrant {
pub enabled: bool,
pub interval_seconds: u64,
pub source: String,
pub granted_at: String,
}
pub const GRANT_SOURCE_AGENT: &str = "agent";
pub const GRANT_SOURCE_GLOBAL: &str = "global";
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn poll_round_trips_and_rejects_unknown_fields() {
let poll = PollDiscoverySnapshot {
api_version: API_VERSION_V1.to_string(),
kind: POLL_DISCOVERY_SNAPSHOT_KIND.to_string(),
agent_id: "agent-1".to_string(),
instance_id: "inst-1".to_string(),
requested_at: "2026-10-26T00:00:00Z".to_string(),
applied: Some(AppliedDiscoverySnapshot {
enabled: true,
interval_seconds: 300,
source: APPLIED_SOURCE_LOCAL_CONFIG.to_string(),
}),
};
let json = serde_json::to_string(&poll).expect("encode");
let back: PollDiscoverySnapshot = serde_json::from_str(&json).expect("decode");
assert_eq!(back, poll);
assert!(!back.applied.as_ref().expect("applied").control_plane());
let mutated = json.replacen('{', "{\"extra\":1,", 1);
assert!(serde_json::from_str::<PollDiscoverySnapshot>(&mutated).is_err());
}
#[test]
fn applied_is_optional_on_the_wire() {
let json = r#"{"api_version":"v1","kind":"poll_discovery_snapshot","agent_id":"a","instance_id":"i","requested_at":"t"}"#;
let poll: PollDiscoverySnapshot = serde_json::from_str(json).expect("decode");
assert_eq!(poll.applied, None);
}
#[test]
fn grant_round_trips() {
let grant = DiscoverySnapshotGrant {
enabled: true,
interval_seconds: 3600,
source: GRANT_SOURCE_AGENT.to_string(),
granted_at: "2026-10-26T00:00:00Z".to_string(),
};
let json = serde_json::to_string(&grant).expect("encode");
let back: DiscoverySnapshotGrant = serde_json::from_str(&json).expect("decode");
assert_eq!(back, grant);
}
}