dna-rs 0.2.0

Async Rust client for the Domain Name API REST gateway
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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

use serde::{Deserialize, Serialize};
use serde_json::Value;

// ── Wire type ─────────────────────────────────────────────────────────────────

/// Raw contact as returned by the gateway (many optional aliases for field names).
#[derive(Debug, Deserialize, Clone)]
#[serde(rename_all = "camelCase")]
pub struct ContactRaw {
    pub handle: Option<String>,
    pub id: Option<Value>,
    pub contact_type: Option<String>,
    pub status: Option<String>,
    pub first_name: Option<String>,
    pub last_name: Option<String>,
    pub company_name: Option<String>,
    pub organization_name: Option<String>,
    pub e_mail: Option<String>,
    pub email_address: Option<String>,
    pub email: Option<String>,
    pub address: Option<String>,
    pub address_line1: Option<String>,
    pub address_line2: Option<String>,
    pub address_line3: Option<String>,
    pub city: Option<String>,
    pub state: Option<String>,
    pub state_or_province: Option<String>,
    pub country: Option<String>,
    pub country_code: Option<String>,
    pub postal_code: Option<String>,
    pub zip_code: Option<String>,
    pub phone: Option<String>,
    pub phone_number: Option<String>,
    pub phone_country_code: Option<String>,
    pub fax: Option<String>,
    pub fax_number: Option<String>,
    pub fax_country_code: Option<String>,
    pub additional_attributes: Option<Value>,
}

// ── Public-facing types ───────────────────────────────────────────────────────

/// Normalised contact returned to callers.
#[derive(Debug, Clone)]
pub struct ContactInfo {
    pub id: String,
    pub status: String,
    pub first_name: String,
    pub last_name: String,
    pub company: String,
    pub email: String,
    pub contact_type: String,
    pub address: ContactAddress,
    pub phone: ContactPhone,
    pub additional: Value,
}

#[derive(Debug, Clone, Default)]
pub struct ContactAddress {
    pub line1: String,
    pub line2: String,
    pub line3: String,
    pub city: String,
    pub state: String,
    pub country: String,
    pub zip_code: String,
}

#[derive(Debug, Clone, Default)]
pub struct ContactPhone {
    pub number: String,
    pub country_code: String,
    pub fax: String,
    pub fax_cc: String,
}

/// Caller-supplied contact data used for registration, transfer, or update.
#[derive(Debug, Clone, Default)]
pub struct ContactInput {
    pub first_name: String,
    pub last_name: String,
    pub company: String,
    pub email: String,
    pub address_line1: String,
    pub address_line2: String,
    pub city: String,
    pub state: String,
    pub country: String,
    pub zip_code: String,
    pub phone: String,
    pub phone_country_code: String,
    pub fax: String,
    pub fax_country_code: String,
}

// ── Wire payload ──────────────────────────────────────────────────────────────

/// Serialised contact sent to the API.
#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct ContactPayload {
    pub contact_type: String,
    pub first_name: String,
    pub last_name: String,
    pub company_name: String,
    pub e_mail: String,
    pub address: String,
    pub city: String,
    pub state: String,
    pub country: String,
    pub postal_code: String,
    pub phone_country_code: String,
    pub phone: String,
    pub fax_country_code: String,
    pub fax: String,
}

#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
pub(crate) struct SaveContactsPayload {
    pub domain_name: String,
    pub contacts: Vec<ContactPayload>,
}

#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub(crate) struct SaveContactsResponse {
    pub contacts: Option<Vec<ContactRaw>>,
}

// ── Helper ────────────────────────────────────────────────────────────────────

/// Map a caller-facing contact type label to the API's type string.
pub fn contact_type_to_api(t: &str) -> &'static str {
    match t.to_lowercase().as_str() {
        "administrative" | "admin" => "Admin",
        "technical" | "tech" => "Tech",
        "billing" => "Billing",
        "registrant" => "Registrant",
        _ => "Registrant",
    }
}