asupersync 0.3.0

//! Async DNS resolution with caching and Happy Eyeballs support.
//!
//! This module provides DNS resolution with configurable caching, retry logic,
//! and Happy Eyeballs (RFC 6555) support for optimal connection establishment.
//!
//! # Cancel Safety
//!
//! - `lookup_ip`: Cancel-safe, DNS query can be cancelled at any point.
//! - `happy_eyeballs_connect`: Cancel-safe, connection attempts are cancelled on drop.
//! - Cache updates are atomic and don't block on cancellation.
//!
//! # Implementation Notes
//!
//! `lookup_ip` keeps the system-resolver fast path for the default
//! configuration so search-domain behavior stays aligned with the host.
//! When explicit nameservers are configured, or when record-specific lookups
//! (MX, SRV, TXT) are requested, the resolver uses its own DNS transport over
//! UDP/TCP on the blocking pool.
//!
//! # Example
//!
//! ```ignore
//! use asupersync::net::dns::{Resolver, ResolverConfig};
//!
//! let resolver = Resolver::new();
//!
//! // Simple IP lookup
//! let lookup = resolver.lookup_ip("example.com").await?;
//! for addr in lookup.addresses() {
//!     println!("{}", addr);
//! }
//!
//! // Happy Eyeballs connection (races IPv6/IPv4)
//! let stream = resolver.happy_eyeballs_connect("example.com", 443).await?;
//! ```

mod cache;
mod error;
mod lookup;
mod resolver;

pub use cache::{CacheConfig, CacheStats, DnsCache};
pub use error::DnsError;
pub use lookup::{HappyEyeballs, LookupIp, LookupMx, LookupSrv, LookupTxt, MxRecord, SrvRecord};
#[cfg(any(test, feature = "test-internals"))]
pub use resolver::parse_resolv_conf_nameservers_for_test;
pub use resolver::{Resolver, ResolverConfig};