rdapify 0.4.0

Unified, secure, high-performance RDAP client with built-in SSRF protection and privacy controls
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

//! # rdapify
//!
//! A unified, secure, high-performance RDAP client library for Rust.
//!
//! This crate is the public API facade that re-exports workspace crates
//! with configurable feature flags for minimal binary sizes.
//!
//! ## Feature flags
//!
//! | Feature        | Default | Description                                      |
//! |----------------|---------|--------------------------------------------------|
//! | `memory-cache` | ✓       | In-memory DashMap response cache                 |
//! | `stream`       | ✓       | Async streaming query API (`tokio-stream`)       |
//! | `batch`        |         | Batch query execution with concurrency control   |
//! | `rate-limit`   |         | Per-registry and global rate limiting            |
//! | `sqlite`       |         | SQLite persistence backend                       |
//! | `postgres`     |         | PostgreSQL persistence backend                   |
//! | `mysql`        |         | MySQL / MariaDB persistence backend              |
//! | `service`      |         | HTTP API service runtime (Axum-based)            |
//! | `full`         |         | Enables: `memory-cache`, `stream`, `batch`, `rate-limit` |
//!
//! ## Quick start
//!
//! ```rust,no_run
//! use rdapify::RdapClient;
//!
//! #[tokio::main]
//! async fn main() -> rdapify::error::Result<()> {
//!     let client = RdapClient::new()?;
//!
//!     let domain = client.domain("example.com").await?;
//!     println!("Registrar: {:?}", domain.registrar);
//!
//!     let ip = client.ip("8.8.8.8").await?;
//!     println!("Country: {:?}", ip.country);
//!
//!     Ok(())
//! }
//! ```

#![forbid(unsafe_code)]

// ── Core re-exports (always available) ───────────────────────────────────────

pub use rdap_types::error::{RdapError, Result};
pub use rdapify_client::{ClientConfig, RdapClient};

pub use rdap_types::{
    AsnResponse, AvailabilityResult, DomainResponse, EntityResponse, IpResponse, IpVersion,
    NameserverIpAddresses, NameserverResponse, RdapEntity, RdapEvent, RdapLink, RdapRemark,
    RdapRole, RdapStatus, RegistrarSummary, ResponseMeta,
};

pub use rdap_core::{FetcherConfig, Normalizer};
pub use rdap_security::{SsrfConfig, SsrfGuard};

// ── Feature-gated flat re-exports ────────────────────────────────────────────

#[cfg(feature = "memory-cache")]
pub use rdap_cache::{CacheConfig, MemoryCache};

#[cfg(feature = "stream")]
pub use rdapify_client::{AsnEvent, DomainEvent, IpEvent, NameserverEvent, StreamConfig};

// ── Always-available modules ──────────────────────────────────────────────────

pub mod error {
    pub use rdap_types::error::*;
}

pub mod bootstrap {
    pub use rdap_bootstrap::Bootstrap;
}

pub mod http {
    pub use rdap_core::{Fetcher, FetcherConfig, Normalizer};
}

pub mod security {
    pub use rdap_security::{SsrfConfig, SsrfGuard};
}

pub mod types {
    pub use rdap_types::*;
}

// ── Feature-gated modules ─────────────────────────────────────────────────────

#[cfg(feature = "memory-cache")]
pub mod cache {
    //! In-memory response cache.
    pub use rdap_cache::{CacheConfig, MemoryCache};
}

#[cfg(feature = "stream")]
pub mod stream {
    //! Async streaming query events.
    pub use rdapify_client::{AsnEvent, DomainEvent, IpEvent, NameserverEvent, StreamConfig};
}

#[cfg(feature = "batch")]
pub mod batch {
    //! Batch query execution with concurrency control.
    pub use rdap_batch::BatchExecutor;
}

#[cfg(feature = "rate-limit")]
pub mod rate_limit {
    //! Per-registry and global rate limiting.
    pub use rdap_rate_limit::{RateLimitConfig, RateLimiter};
}

/// SQLite persistence backend (skeleton — full impl pending).
#[cfg(feature = "sqlite")]
pub mod sqlite {}

/// PostgreSQL persistence backend (skeleton — full impl pending).
#[cfg(feature = "postgres")]
pub mod postgres {}

/// MySQL / MariaDB persistence backend (skeleton — full impl pending).
#[cfg(feature = "mysql")]
pub mod mysql {}

/// HTTP API service runtime (skeleton — full impl pending).
#[cfg(feature = "service")]
pub mod service {}