RecordType represents a DNS record type

Compare queries all resolvers and detects discrepancies without failing on them.

Consensus requires a minimum number of resolvers to return identical results.

Dialer is the main entry point for multiplexed DNS resolution. It coordinates multiple underlying DNS resolvers using a configurable strategy, enabli

Fallback tries resolvers sequentially in order until one succeeds.

Field represents a structured logging field (key-value pair). Used to attach context to log messages.

Logger provides structured logging throughout the resolution process.

Option is a function that configures a Dialer. This package uses the functional options pattern, which provides: 1. Sensible defaults - you can creat

Race queries all resolvers simultaneously and returns the first successful response.

Record represents a DNS record with its value

Strategy determines how to coordinate DNS queries across multiple resolvers. All strategies implement this interface, allowing them to be swapped wit

connPool manages a pool of reusable UDP connections to a single DNS resolver. Connection pooling reduces the overhead of socket creation/destruction

dnsCache wraps an LRU cache with TTL-aware expiration for IP addresses. It mimics OS-level DNS caching behavior (mDNSResponder, systemd-resolved) whil

ipCacheEntry holds cached IP addresses with their expiration time. We cache the already-parsed net.IP values here so we can skip the net.ParseIP overh

mockLogger for testing

mockResolver implements the resolver interface for testing

noopLogger is the default logger that silently discards all log messages. This allows the library to have zero logging overhead when not needed.

recordKey is used as a map key for comparing DNS records. It combines value and TTL to enable multiset equality checking.

resolver is the internal interface that all DNS resolver implementations must satisfy. This abstraction allows strategies to work with any resolver i

udpResolver implements the resolver interface using UDP transport. It uses connection pooling to reduce socket allocation overhead and supports conte