dnsync 0.2.2

DNS Sync and Control with MCP
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use clap::Args;
use schemars::JsonSchema;
use serde::Deserialize;
use serde_json::Value;

use crate::core::{
    dns::service::{ZoneExport, ZoneImport, ZoneRead, ZoneWrite},
    error::Result,
};

/// Shared DNS zone summary.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ZoneSummary {
    pub name: String,
    pub zone_type: String,
    pub disabled: bool,
}

/// Overwrite flags for zone-file imports. Used by both CLI and MCP.
#[derive(Debug, Clone, Args, Deserialize, JsonSchema)]
pub struct ZoneImportOptions {
    /// Overwrite existing record sets for imported types (default: true)
    #[arg(long, default_value_t = true)]
    #[serde(default = "default_overwrite")]
    pub overwrite: bool,
    /// Delete all existing records before importing — clean replace (default: false)
    #[arg(long, default_value_t = false)]
    #[serde(default)]
    pub overwrite_zone: bool,
    /// Use the SOA serial from the file instead of auto-incrementing (default: false)
    #[arg(long, default_value_t = false)]
    #[serde(default)]
    pub overwrite_soa_serial: bool,
}

fn default_overwrite() -> bool {
    true
}

/// List DNS zones through a vendor-neutral zone reader.
///
/// # Errors
///
/// Returns any error reported by the selected DNS backend.
pub async fn list_zones<C: ZoneRead + ?Sized>(
    client: &C,
    page: u32,
    per_page: u32,
) -> Result<Value> {
    client.list_zones(page, per_page).await
}

/// Create a DNS zone through a vendor-neutral zone writer.
///
/// # Errors
///
/// Returns any error reported by the selected DNS backend.
pub async fn create_zone<C: ZoneWrite + ?Sized>(
    client: &C,
    zone: &str,
    zone_type: &str,
) -> Result<Value> {
    client.create_zone(zone, zone_type).await
}

/// Delete a DNS zone through a vendor-neutral zone writer.
///
/// # Errors
///
/// Returns any error reported by the selected DNS backend.
pub async fn delete_zone<C: ZoneWrite + ?Sized>(client: &C, zone: &str) -> Result<Value> {
    client.delete_zone(zone).await
}

/// Enable a DNS zone through a vendor-neutral zone writer.
///
/// # Errors
///
/// Returns any error reported by the selected DNS backend.
pub async fn enable_zone<C: ZoneWrite + ?Sized>(client: &C, zone: &str) -> Result<Value> {
    client.enable_zone(zone).await
}

/// Disable a DNS zone through a vendor-neutral zone writer.
///
/// # Errors
///
/// Returns any error reported by the selected DNS backend.
pub async fn disable_zone<C: ZoneWrite + ?Sized>(client: &C, zone: &str) -> Result<Value> {
    client.disable_zone(zone).await
}

/// Import a zone file through a vendor-neutral zone importer.
///
/// # Errors
///
/// Returns any error reported by the selected DNS backend.
pub async fn import_zone_file<C: ZoneImport + ?Sized>(
    client: &C,
    zone: &str,
    file_name: String,
    file_bytes: Vec<u8>,
    overwrite: bool,
    overwrite_zone: bool,
    overwrite_soa_serial: bool,
) -> Result<Value> {
    client
        .import_zone_file(
            zone,
            file_name,
            file_bytes,
            overwrite,
            overwrite_zone,
            overwrite_soa_serial,
        )
        .await
}

/// Export a zone file through a vendor-neutral zone exporter.
///
/// # Errors
///
/// Returns any error reported by the selected DNS backend.
pub async fn export_zone_file<C: ZoneExport + ?Sized>(client: &C, zone: &str) -> Result<String> {
    client.export_zone_file(zone).await
}