use crate::EncodeError;
use crate::internal::protocol::{
DnsHeader, DnsRecord, DnsUpdateMessage, RData, ZoneSection, checked_count,
};
pub struct UpdateMessageBuilder {
zone: String,
prerequisites: Vec<DnsRecord>,
updates: Vec<DnsRecord>,
error: Option<EncodeError>,
}
impl UpdateMessageBuilder {
pub fn new(zone: impl Into<String>) -> Self {
Self {
zone: zone.into(),
prerequisites: Vec::new(),
updates: Vec::new(),
error: None,
}
}
pub fn add_record(mut self, name: impl Into<String>, ttl: u32, rdata: RData) -> Self {
let Some(rtype) = rdata.record_type() else {
self.error.get_or_insert_with(|| {
EncodeError::InvalidRecord("An added record must have RDATA".into())
});
return self;
};
self.updates.push(DnsRecord {
name: name.into(),
rtype,
rclass: 1,
ttl,
rdata,
});
self
}
pub fn delete_record(mut self, name: impl Into<String>, rtype: u16) -> Self {
self.updates.push(DnsRecord {
name: name.into(),
rtype,
rclass: 255,
ttl: 0,
rdata: RData::Empty,
});
self
}
pub fn delete_record_value(mut self, name: impl Into<String>, rdata: RData) -> Self {
let Some(rtype) = rdata.record_type() else {
self.error.get_or_insert_with(|| {
EncodeError::InvalidRecord("A value deletion must have RDATA".into())
});
return self;
};
self.updates.push(DnsRecord {
name: name.into(),
rtype,
rclass: 254,
ttl: 0,
rdata,
});
self
}
pub fn require_name_exists(self, name: impl Into<String>) -> Self {
self.require_empty(name, 255, 255)
}
pub fn require_name_absent(self, name: impl Into<String>) -> Self {
self.require_empty(name, 255, 254)
}
pub fn require_rrset_exists(self, name: impl Into<String>, rtype: u16) -> Self {
self.require_rrset_presence(name, rtype, 255)
}
pub fn require_rrset_absent(self, name: impl Into<String>, rtype: u16) -> Self {
self.require_rrset_presence(name, rtype, 254)
}
pub fn require_rrset_equals(
mut self,
name: impl Into<String>,
values: impl IntoIterator<Item = RData>,
) -> Self {
let name = name.into();
let mut record_type = None;
for rdata in values {
let Some(rtype) = rdata.record_type() else {
self.error.get_or_insert_with(|| {
EncodeError::InvalidRecord("An RRset prerequisite must have RDATA".into())
});
return self;
};
if record_type.is_some_and(|previous| previous != rtype) {
self.error.get_or_insert_with(|| {
EncodeError::InvalidRecord(
"An RRset prerequisite must contain one record type".into(),
)
});
return self;
}
record_type = Some(rtype);
self.prerequisites.push(DnsRecord {
name: name.clone(),
rtype,
rclass: 1,
ttl: 0,
rdata,
});
}
if record_type.is_none() {
self.error.get_or_insert_with(|| {
EncodeError::InvalidRecord(
"An RRset prerequisite must contain at least one value".into(),
)
});
}
self
}
fn require_rrset_presence(mut self, name: impl Into<String>, rtype: u16, rclass: u16) -> Self {
if rtype == 255 {
self.error.get_or_insert_with(|| {
EncodeError::InvalidRecord("Use a name prerequisite for type ANY".into())
});
return self;
}
self.require_empty(name, rtype, rclass)
}
fn require_empty(mut self, name: impl Into<String>, rtype: u16, rclass: u16) -> Self {
self.prerequisites.push(DnsRecord {
name: name.into(),
rtype,
rclass,
ttl: 0,
rdata: RData::Empty,
});
self
}
pub fn build(self) -> Result<DnsUpdateMessage, EncodeError> {
if let Some(error) = self.error {
return Err(error);
}
let message = DnsUpdateMessage {
header: DnsHeader {
id: rand::random(),
flags: 0x2800,
qdcount: 1,
ancount: checked_count("Prerequisite count", self.prerequisites.len())?,
nscount: checked_count("Update count", self.updates.len())?,
arcount: 0,
},
zone: ZoneSection {
zname: self.zone,
zclass: 1,
ztype: 6,
},
prerequisites: self.prerequisites,
updates: self.updates,
additional: Vec::new(),
};
message.to_bytes()?;
Ok(message)
}
}