use serde::{Deserialize, Serialize};
use tracing::instrument;
use super::prices::MailClass;
use crate::core::client::UspsClient;
use crate::core::error::{Result, UspsError};
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ServiceStandardRequest {
#[serde(rename = "originZIPCode")]
pub origin_zip_code: String,
#[serde(rename = "destinationZIPCode")]
pub destination_zip_code: String,
#[serde(skip_serializing_if = "Option::is_none")]
pub acceptance_date: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub mail_class: Option<MailClass>,
}
impl ServiceStandardRequest {
#[must_use]
pub fn new(
origin_zip_code: impl Into<String>,
destination_zip_code: impl Into<String>,
) -> Self {
Self {
origin_zip_code: origin_zip_code.into(),
destination_zip_code: destination_zip_code.into(),
acceptance_date: None,
mail_class: None,
}
}
#[must_use]
pub fn acceptance_date(mut self, date: impl Into<String>) -> Self {
self.acceptance_date = Some(date.into());
self
}
#[must_use]
pub fn mail_class(mut self, mail_class: MailClass) -> Self {
self.mail_class = Some(mail_class);
self
}
}
#[derive(Debug, Clone, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct ServiceStandardEstimate {
pub mail_class: String,
pub service_standard: String,
#[serde(default)]
pub service_standard_message: Option<String>,
#[serde(default)]
pub scheduled_delivery_date: Option<String>,
#[serde(default)]
pub cutoff_time: Option<String>,
}
#[derive(Debug, Clone, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct ServiceStandardResponse {
#[serde(rename = "originZIPCode")]
pub origin_zip_code: String,
#[serde(rename = "destinationZIPCode")]
pub destination_zip_code: String,
#[serde(default)]
pub acceptance_date: Option<String>,
#[serde(default)]
pub service_standards: Vec<ServiceStandardEstimate>,
}
#[derive(Debug, Clone)]
pub struct ServiceStandardsService {
client: UspsClient,
}
impl ServiceStandardsService {
#[must_use]
pub(crate) fn new(client: UspsClient) -> Self {
Self { client }
}
#[instrument(skip(self), name = "get_service_standard_estimates")]
pub async fn get_estimates(
&self,
req: &ServiceStandardRequest,
) -> Result<ServiceStandardResponse> {
let origin = req.origin_zip_code.trim();
if origin.len() != 5 || !origin.chars().all(|c| c.is_ascii_digit()) {
return Err(UspsError::InvalidInput(
"El código postal de origen (originZIPCode) debe contener 5 dígitos numéricos"
.to_string(),
));
}
let destination = req.destination_zip_code.trim();
if destination.len() != 5 || !destination.chars().all(|c| c.is_ascii_digit()) {
return Err(UspsError::InvalidInput(
"El código postal de destino (destinationZIPCode) debe contener 5 dígitos numéricos"
.to_string(),
));
}
let endpoint = "/service-standards/v3/estimates";
self.client.get_with_query(endpoint, req).await
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn service_standard_request_builder() {
let req = ServiceStandardRequest::new("90210", "10001")
.acceptance_date("2026-09-22")
.mail_class(MailClass::PriorityMail);
assert_eq!(req.origin_zip_code, "90210");
assert_eq!(req.destination_zip_code, "10001");
assert_eq!(req.acceptance_date.as_deref(), Some("2026-09-22"));
assert_eq!(req.mail_class, Some(MailClass::PriorityMail));
}
#[test]
fn service_standard_response_deserialization() {
let json = r#"{
"originZIPCode": "90210",
"destinationZIPCode": "10001",
"acceptanceDate": "2026-09-22",
"serviceStandards": [
{
"mailClass": "PRIORITY_MAIL",
"serviceStandard": "2 Days",
"serviceStandardMessage": "Expected delivery in 2 business days",
"scheduledDeliveryDate": "2026-09-24",
"cutoffTime": "17:00:00"
},
{
"mailClass": "USPS_GROUND_ADVANTAGE",
"serviceStandard": "4 Days",
"serviceStandardMessage": "Expected delivery in 4 business days",
"scheduledDeliveryDate": "2026-09-26",
"cutoffTime": "17:00:00"
}
]
}"#;
let res: ServiceStandardResponse = serde_json::from_str(json).unwrap();
assert_eq!(res.origin_zip_code, "90210");
assert_eq!(res.destination_zip_code, "10001");
assert_eq!(res.service_standards.len(), 2);
assert_eq!(res.service_standards[0].mail_class, "PRIORITY_MAIL");
assert_eq!(res.service_standards[0].service_standard, "2 Days");
assert_eq!(
res.service_standards[0].scheduled_delivery_date.as_deref(),
Some("2026-09-24")
);
}
}