zynor 0.0.82 → 0.0.85

package/dist/native.d.ts

@@ -0,0 +1,3770 @@
+import { AnyARecord, AnyAaaaRecord, AnyCnameRecord, AnyMxRecord, AnyNaptrRecord, AnyNsRecord, AnyPtrRecord, AnySoaRecord, AnySrvRecord, AnyTlsaRecord, AnyTxtRecord, CaaRecord, MxRecord, NaptrRecord, RecordWithTtl, ResolveOptions, ResolveWithTtlOptions, SoaRecord, SrvRecord, TlsaRecord } from 'node:dns';
+
+export interface CacheConfig {
+	/** Enable/disable caching. Default: true */
+	enabled?: boolean;
+	/** Max entries per cache namespace. Default: 100_000 */
+	maxSize?: number;
+	/** DNS result TTL in ms. Default: 1_440_000 (24 min) */
+	dnsTtl?: number;
+}
+/**
+ * In-memory LRU cache with TTL-based expiry and size-based eviction.
+ * Uses Map insertion order for O(1) LRU tracking.
+ */
+export declare class LruCache<T = any> {
+	private cache;
+	private readonly maxSize;
+	constructor(maxSize?: number);
+	/** Get a value by key. Returns undefined if missing or expired. Promotes to MRU on hit. */
+	get(key: string): T | undefined;
+	/** Set a value with a TTL in milliseconds. Evicts LRU entry if at capacity. */
+	set(key: string, data: T, ttlMs: number): void;
+	/** Check if a key exists and is not expired. */
+	has(key: string): boolean;
+	/** Delete a specific key. Returns true if the key existed. */
+	delete(key: string): boolean;
+	/** Remove all entries. */
+	clear(): void;
+	/** Number of entries (including potentially expired ones not yet evicted). */
+	get size(): number;
+	/** Iterate all non-expired keys. Lazily evicts expired entries. */
+	keys(): IterableIterator<string>;
+	/** Iterate all non-expired values. Lazily evicts expired entries. */
+	values(): IterableIterator<T>;
+	/** Iterate all non-expired [key, value] pairs. Lazily evicts expired entries. */
+	entries(): IterableIterator<[
+		string,
+		T
+	]>;
+	/** Purge all expired entries. Returns number of entries removed. */
+	prune(): number;
+	/** Peek at a value without promoting it in the LRU order. */
+	peek(key: string): T | undefined;
+	/** Get remaining TTL in ms for a key. Returns 0 if missing or expired. */
+	ttl(key: string): number;
+}
+/**
+ * Configuration for a DNS provider's concurrency and rate limiting.
+ */
+export interface ProviderConfig {
+	/**
+	 * Concurrency and rate limiting configuration.
+	 * Can be either a simple concurrency limit or include interval-based rate limiting.
+	 */
+	limit?: {
+		/** Maximum number of concurrent requests */
+		concurrency: number;
+		/** Time interval in milliseconds for rate limiting */
+		interval?: number;
+		/** Maximum number of requests per interval */
+		intervalCap?: number;
+		/**
+		 * Whether to carry over the concurrency count from the previous interval.
+		 * @default false
+		 */
+		carryoverConcurrencyCount?: boolean;
+	};
+	/**
+	 * Whether this provider is enabled.
+	 * @default true
+	 */
+	enabled?: boolean;
+}
+/**
+ * Configuration for all DNS providers.
+ */
+export interface ZynorConfig {
+	/** Configuration for the native Node.js DNS resolver */
+	native?: ProviderConfig;
+	/** Configuration for Google DNS-over-HTTPS */
+	google?: ProviderConfig;
+	/** Configuration for Cloudflare DNS-over-HTTPS */
+	cloudflare?: ProviderConfig;
+	/** Configuration for Quad9 DNS-over-HTTPS */
+	quad9?: ProviderConfig;
+	/** Configuration for DNS result caching */
+	cache?: CacheConfig;
+}
+/**
+ * Union type of all possible DNS record types returned by ANY queries.
+ */
+export type AnyRecord = AnyARecord | AnyAaaaRecord | AnyCnameRecord | AnyMxRecord | AnyNaptrRecord | AnyNsRecord | AnyPtrRecord | AnySoaRecord | AnySrvRecord | AnyTlsaRecord | AnyTxtRecord;
+/**
+ * Available DNS provider names.
+ */
+export type ProviderName = "native" | "google" | "cloudflare" | "quad9";
+/**
+ * DNS record types supported by the resolver.
+ */
+export type RecordType = "A" | "AAAA" | "ANY" | "CAA" | "CNAME" | "MX" | "NAPTR" | "NS" | "PTR" | "SOA" | "SRV" | "TLSA" | "TXT";
+/**
+ * Error thrown when no providers are enabled.
+ */
+export declare class NoEnabledProvidersError extends Error {
+	constructor();
+}
+/**
+ * Error thrown when an invalid hostname is provided.
+ */
+export declare class InvalidHostnameError extends Error {
+	constructor(hostname: string);
+}
+/**
+ * Error thrown when a provider is not enabled.
+ */
+export declare class ProviderNotEnabledError extends Error {
+	constructor(provider: string);
+}
+/**
+ * Error thrown when an invalid provider name is specified.
+ */
+export declare class InvalidProviderError extends Error {
+	constructor(provider: string);
+}
+/**
+ * Options for aborting/timing out DNS operations.
+ */
+export interface AbortOptions {
+	/** AbortSignal to cancel the operation (queue wait + fetch). */
+	signal?: AbortSignal;
+	/** Timeout in milliseconds for the entire operation (queue wait + fetch). */
+	timeout?: number;
+}
+export interface IResolver {
+	/**
+	 * Resolves DNS records for a hostname without specifying record type (defaults to A records)
+	 * @param hostname - The hostname to resolve
+	 * @returns Promise resolving to an array of IPv4 addresses
+	 */
+	resolve(hostname: string): Promise<string[]>;
+	/**
+	 * Resolves DNS records for a hostname without specifying record type but with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of IPv4 addresses
+	 */
+	resolve(hostname: string, provider: ProviderName): Promise<string[]>;
+	/**
+	 * Resolves A records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "A"
+	 * @returns Promise resolving to an array of IPv4 addresses
+	 */
+	resolve(hostname: string, rrtype: "A"): Promise<string[]>;
+	/**
+	 * Resolves A records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "A"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of IPv4 addresses
+	 */
+	resolve(hostname: string, rrtype: "A", provider: ProviderName): Promise<string[]>;
+	/**
+	 * Resolves AAAA records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "AAAA"
+	 * @returns Promise resolving to an array of IPv6 addresses
+	 */
+	resolve(hostname: string, rrtype: "AAAA"): Promise<string[]>;
+	/**
+	 * Resolves AAAA records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "AAAA"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of IPv6 addresses
+	 */
+	resolve(hostname: string, rrtype: "AAAA", provider: ProviderName): Promise<string[]>;
+	/**
+	 * Resolves ANY records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "ANY"
+	 * @returns Promise resolving to an array of any DNS records
+	 */
+	resolve(hostname: string, rrtype: "ANY"): Promise<AnyRecord[]>;
+	/**
+	 * Resolves ANY records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "ANY"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of any DNS records
+	 */
+	resolve(hostname: string, rrtype: "ANY", provider: ProviderName): Promise<AnyRecord[]>;
+	/**
+	 * Resolves CAA records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "CAA"
+	 * @returns Promise resolving to an array of CAA records
+	 */
+	resolve(hostname: string, rrtype: "CAA"): Promise<CaaRecord[]>;
+	/**
+	 * Resolves CAA records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "CAA"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of CAA records
+	 */
+	resolve(hostname: string, rrtype: "CAA", provider: ProviderName): Promise<CaaRecord[]>;
+	/**
+	 * Resolves CNAME records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "CNAME"
+	 * @returns Promise resolving to an array of canonical names
+	 */
+	resolve(hostname: string, rrtype: "CNAME"): Promise<string[]>;
+	/**
+	 * Resolves CNAME records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "CNAME"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of canonical names
+	 */
+	resolve(hostname: string, rrtype: "CNAME", provider: ProviderName): Promise<string[]>;
+	/**
+	 * Resolves MX records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "MX"
+	 * @returns Promise resolving to an array of mail exchange records
+	 */
+	resolve(hostname: string, rrtype: "MX"): Promise<MxRecord[]>;
+	/**
+	 * Resolves MX records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "MX"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of mail exchange records
+	 */
+	resolve(hostname: string, rrtype: "MX", provider: ProviderName): Promise<MxRecord[]>;
+	/**
+	 * Resolves NAPTR records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "NAPTR"
+	 * @returns Promise resolving to an array of NAPTR records
+	 */
+	resolve(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>;
+	/**
+	 * Resolves NAPTR records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "NAPTR"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of NAPTR records
+	 */
+	resolve(hostname: string, rrtype: "NAPTR", provider: ProviderName): Promise<NaptrRecord[]>;
+	/**
+	 * Resolves NS records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "NS"
+	 * @returns Promise resolving to an array of nameserver hostnames
+	 */
+	resolve(hostname: string, rrtype: "NS"): Promise<string[]>;
+	/**
+	 * Resolves NS records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "NS"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of nameserver hostnames
+	 */
+	resolve(hostname: string, rrtype: "NS", provider: ProviderName): Promise<string[]>;
+	/**
+	 * Resolves PTR records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "PTR"
+	 * @returns Promise resolving to an array of pointer records
+	 */
+	resolve(hostname: string, rrtype: "PTR"): Promise<string[]>;
+	/**
+	 * Resolves PTR records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "PTR"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of pointer records
+	 */
+	resolve(hostname: string, rrtype: "PTR", provider: ProviderName): Promise<string[]>;
+	/**
+	 * Resolves SOA record for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "SOA"
+	 * @returns Promise resolving to a start of authority record
+	 */
+	resolve(hostname: string, rrtype: "SOA"): Promise<SoaRecord>;
+	/**
+	 * Resolves SOA record for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "SOA"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to a start of authority record
+	 */
+	resolve(hostname: string, rrtype: "SOA", provider: ProviderName): Promise<SoaRecord>;
+	/**
+	 * Resolves SRV records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "SRV"
+	 * @returns Promise resolving to an array of service records
+	 */
+	resolve(hostname: string, rrtype: "SRV"): Promise<SrvRecord[]>;
+	/**
+	 * Resolves SRV records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "SRV"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of service records
+	 */
+	resolve(hostname: string, rrtype: "SRV", provider: ProviderName): Promise<SrvRecord[]>;
+	/**
+	 * Resolves TLSA records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "TLSA"
+	 * @returns Promise resolving to an array of TLSA records
+	 */
+	resolve(hostname: string, rrtype: "TLSA"): Promise<TlsaRecord[]>;
+	/**
+	 * Resolves TLSA records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "TLSA"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of TLSA records
+	 */
+	resolve(hostname: string, rrtype: "TLSA", provider: ProviderName): Promise<TlsaRecord[]>;
+	/**
+	 * Resolves TXT records for a hostname
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "TXT"
+	 * @returns Promise resolving to an array of text record arrays
+	 */
+	resolve(hostname: string, rrtype: "TXT"): Promise<string[][]>;
+	/**
+	 * Resolves TXT records for a hostname with a specific provider
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - DNS record type "TXT"
+	 * @param provider - The DNS provider to use
+	 * @returns Promise resolving to an array of text record arrays
+	 */
+	resolve(hostname: string, rrtype: "TXT", provider: ProviderName): Promise<string[][]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv4 addresses (`A` records) for the `hostname`. On success, the `Promise` is resolved with an array of IPv4
+	 * addresses (e.g. `['74.125.79.104', '74.125.79.105', '74.125.79.106']`).
+	 * @since v10.6.0
+	 * @param hostname Host name to resolve.
+	 */
+	resolve4(hostname: string): Promise<string[]>;
+	resolve4(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
+	resolve4(hostname: string, options: ResolveOptions): Promise<string[] | RecordWithTtl[]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv4 addresses (`A` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolve4(hostname: string, provider: ProviderName): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv4 addresses (`A` records) for the `hostname` with TTL using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param options Resolution options with TTL enabled.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolve4(hostname: string, options: ResolveWithTtlOptions, provider: ProviderName): Promise<RecordWithTtl[]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv4 addresses (`A` records) for the `hostname` with options using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param options Resolution options.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolve4(hostname: string, options: ResolveOptions, provider: ProviderName): Promise<string[] | RecordWithTtl[]>;
+	resolve4(hostname: string, options: AbortOptions): Promise<string[]>;
+	resolve4(hostname: string, options: AbortOptions, provider: ProviderName): Promise<string[]>;
+	resolve4(hostname: string, options: ResolveOptions & AbortOptions): Promise<string[] | RecordWithTtl[]>;
+	resolve4(hostname: string, options: ResolveOptions & AbortOptions, provider: ProviderName): Promise<string[] | RecordWithTtl[]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv6 addresses (`AAAA` records) for the `hostname`. On success, the `Promise` is resolved with an array of IPv6
+	 * addresses.
+	 * @since v10.6.0
+	 * @param hostname Host name to resolve.
+	 */
+	resolve6(hostname: string): Promise<string[]>;
+	resolve6(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
+	resolve6(hostname: string, options: ResolveOptions): Promise<string[] | RecordWithTtl[]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv6 addresses (`AAAA` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolve6(hostname: string, provider: ProviderName): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv6 addresses (`AAAA` records) for the `hostname` with TTL using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param options Resolution options with TTL enabled.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolve6(hostname: string, options: ResolveWithTtlOptions, provider: ProviderName): Promise<RecordWithTtl[]>;
+	/**
+	 * Uses the DNS protocol to resolve IPv6 addresses (`AAAA` records) for the `hostname` with options using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param options Resolution options.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolve6(hostname: string, options: ResolveOptions, provider: ProviderName): Promise<string[] | RecordWithTtl[]>;
+	resolve6(hostname: string, options: AbortOptions): Promise<string[]>;
+	resolve6(hostname: string, options: AbortOptions, provider: ProviderName): Promise<string[]>;
+	resolve6(hostname: string, options: ResolveOptions & AbortOptions): Promise<string[] | RecordWithTtl[]>;
+	resolve6(hostname: string, options: ResolveOptions & AbortOptions, provider: ProviderName): Promise<string[] | RecordWithTtl[]>;
+	/**
+	 * Uses the DNS protocol to resolve all records (also known as `ANY` or `*` query).
+	 * On success, the `Promise` is resolved with an array containing various types of
+	 * records. Each object has a property `type` that indicates the type of the
+	 * current record. And depending on the `type`, additional properties will be
+	 * present on the object:
+	 *
+	 * <omitted>
+	 *
+	 * Here is an example of the result object:
+	 *
+	 * ```js
+	 * [ { type: 'A', address: '127.0.0.1', ttl: 299 },
+	 *   { type: 'CNAME', value: 'example.com' },
+	 *   { type: 'MX', exchange: 'alt4.aspmx.l.example.com', priority: 50 },
+	 *   { type: 'NS', value: 'ns1.example.com' },
+	 *   { type: 'TXT', entries: [ 'v=spf1 include:_spf.example.com ~all' ] },
+	 *   { type: 'SOA',
+	 *     nsname: 'ns1.example.com',
+	 *     hostmaster: 'admin.example.com',
+	 *     serial: 156696742,
+	 *     refresh: 900,
+	 *     retry: 900,
+	 *     expire: 1800,
+	 *     minttl: 60 } ]
+	 * ```
+	 * @since v10.6.0
+	 */
+	resolveAny(hostname: string): Promise<AnyRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve all records (also known as `ANY` or `*` query) using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveAny(hostname: string, provider: ProviderName): Promise<AnyRecord[]>;
+	resolveAny(hostname: string, options: AbortOptions): Promise<AnyRecord[]>;
+	resolveAny(hostname: string, options: AbortOptions, provider: ProviderName): Promise<AnyRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve `CAA` records for the `hostname`. On success,
+	 * the `Promise` is resolved with an array of objects containing available
+	 * certification authority authorization records available for the `hostname` (e.g. `[{critical: 0, iodef: 'mailto:pki@example.com'},{critical: 128, issue: 'pki.example.com'}]`).
+	 * @since v15.0.0, v14.17.0
+	 */
+	resolveCaa(hostname: string): Promise<CaaRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve `CAA` records for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveCaa(hostname: string, provider: ProviderName): Promise<CaaRecord[]>;
+	resolveCaa(hostname: string, options: AbortOptions): Promise<CaaRecord[]>;
+	resolveCaa(hostname: string, options: AbortOptions, provider: ProviderName): Promise<CaaRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve `CNAME` records for the `hostname`. On success,
+	 * the `Promise` is resolved with an array of canonical name records available for
+	 * the `hostname` (e.g. `['bar.example.com']`).
+	 * @since v10.6.0
+	 */
+	resolveCname(hostname: string): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve `CNAME` records for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveCname(hostname: string, provider: ProviderName): Promise<string[]>;
+	resolveCname(hostname: string, options: AbortOptions): Promise<string[]>;
+	resolveCname(hostname: string, options: AbortOptions, provider: ProviderName): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve mail exchange records (`MX` records) for the `hostname`. On success, the `Promise` is resolved with an array of objects
+	 * containing both a `priority` and `exchange` property (e.g.`[{priority: 10, exchange: 'mx.example.com'}, ...]`).
+	 * @since v10.6.0
+	 */
+	resolveMx(hostname: string): Promise<MxRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve mail exchange records (`MX` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveMx(hostname: string, provider: ProviderName): Promise<MxRecord[]>;
+	resolveMx(hostname: string, options: AbortOptions): Promise<MxRecord[]>;
+	resolveMx(hostname: string, options: AbortOptions, provider: ProviderName): Promise<MxRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve regular expression-based records (`NAPTR` records) for the `hostname`. On success, the `Promise` is resolved with an array
+	 * of objects with the following properties:
+	 *
+	 * * `flags`
+	 * * `service`
+	 * * `regexp`
+	 * * `replacement`
+	 * * `order`
+	 * * `preference`
+	 *
+	 * ```js
+	 * {
+	 *   flags: 's',
+	 *   service: 'SIP+D2U',
+	 *   regexp: '',
+	 *   replacement: '_sip._udp.example.com',
+	 *   order: 30,
+	 *   preference: 100
+	 * }
+	 * ```
+	 * @since v10.6.0
+	 */
+	resolveNaptr(hostname: string): Promise<NaptrRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve regular expression-based records (`NAPTR` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveNaptr(hostname: string, provider: ProviderName): Promise<NaptrRecord[]>;
+	resolveNaptr(hostname: string, options: AbortOptions): Promise<NaptrRecord[]>;
+	resolveNaptr(hostname: string, options: AbortOptions, provider: ProviderName): Promise<NaptrRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve name server records (`NS` records) for the `hostname`. On success, the `Promise` is resolved with an array of name server
+	 * records available for `hostname` (e.g.`['ns1.example.com', 'ns2.example.com']`).
+	 * @since v10.6.0
+	 */
+	resolveNs(hostname: string): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve name server records (`NS` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveNs(hostname: string, provider: ProviderName): Promise<string[]>;
+	resolveNs(hostname: string, options: AbortOptions): Promise<string[]>;
+	resolveNs(hostname: string, options: AbortOptions, provider: ProviderName): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve pointer records (`PTR` records) for the `hostname`. On success, the `Promise` is resolved with an array of strings
+	 * containing the reply records.
+	 * @since v10.6.0
+	 */
+	resolvePtr(hostname: string): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve pointer records (`PTR` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolvePtr(hostname: string, provider: ProviderName): Promise<string[]>;
+	resolvePtr(hostname: string, options: AbortOptions): Promise<string[]>;
+	resolvePtr(hostname: string, options: AbortOptions, provider: ProviderName): Promise<string[]>;
+	/**
+	 * Uses the DNS protocol to resolve a start of authority record (`SOA` record) for
+	 * the `hostname`. On success, the `Promise` is resolved with an object with the
+	 * following properties:
+	 *
+	 * * `nsname`
+	 * * `hostmaster`
+	 * * `serial`
+	 * * `refresh`
+	 * * `retry`
+	 * * `expire`
+	 * * `minttl`
+	 *
+	 * ```js
+	 * {
+	 *   nsname: 'ns.example.com',
+	 *   hostmaster: 'root.example.com',
+	 *   serial: 2013101809,
+	 *   refresh: 10000,
+	 *   retry: 2400,
+	 *   expire: 604800,
+	 *   minttl: 3600
+	 * }
+	 * ```
+	 * @since v10.6.0
+	 */
+	resolveSoa(hostname: string): Promise<SoaRecord>;
+	/**
+	 * Uses the DNS protocol to resolve a start of authority record (`SOA` record) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveSoa(hostname: string, provider: ProviderName): Promise<SoaRecord>;
+	resolveSoa(hostname: string, options: AbortOptions): Promise<SoaRecord>;
+	resolveSoa(hostname: string, options: AbortOptions, provider: ProviderName): Promise<SoaRecord>;
+	/**
+	 * Uses the DNS protocol to resolve service records (`SRV` records) for the `hostname`. On success, the `Promise` is resolved with an array of objects with
+	 * the following properties:
+	 *
+	 * * `priority`
+	 * * `weight`
+	 * * `port`
+	 * * `name`
+	 *
+	 * ```js
+	 * {
+	 *   priority: 10,
+	 *   weight: 5,
+	 *   port: 21223,
+	 *   name: 'service.example.com'
+	 * }
+	 * ```
+	 * @since v10.6.0
+	 */
+	resolveSrv(hostname: string): Promise<SrvRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve service records (`SRV` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveSrv(hostname: string, provider: ProviderName): Promise<SrvRecord[]>;
+	resolveSrv(hostname: string, options: AbortOptions): Promise<SrvRecord[]>;
+	resolveSrv(hostname: string, options: AbortOptions, provider: ProviderName): Promise<SrvRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve certificate associations (`TLSA` records) for
+	 * the `hostname`. On success, the `Promise` is resolved with an array of objectsAdd commentMore actions
+	 * with these properties:
+	 *
+	 * * `certUsage`
+	 * * `selector`
+	 * * `match`
+	 * * `data`
+	 *
+	 * ```js
+	 * {
+	 *   certUsage: 3,
+	 *   selector: 1,
+	 *   match: 1,
+	 *   data: [ArrayBuffer]
+	 * }
+	 * ```
+	 * @since v23.9.0, v22.15.0
+	 */
+	resolveTlsa(hostname: string): Promise<TlsaRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve certificate associations (`TLSA` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveTlsa(hostname: string, provider: ProviderName): Promise<TlsaRecord[]>;
+	resolveTlsa(hostname: string, options: AbortOptions): Promise<TlsaRecord[]>;
+	resolveTlsa(hostname: string, options: AbortOptions, provider: ProviderName): Promise<TlsaRecord[]>;
+	/**
+	 * Uses the DNS protocol to resolve text queries (`TXT` records) for the `hostname`. On success, the `Promise` is resolved with a two-dimensional array
+	 * of the text records available for `hostname` (e.g.`[ ['v=spf1 ip4:0.0.0.0 ', '~all' ] ]`). Each sub-array contains TXT chunks of
+	 * one record. Depending on the use case, these could be either joined together or
+	 * treated separately.
+	 * @since v10.6.0
+	 */
+	resolveTxt(hostname: string): Promise<string[][]>;
+	/**
+	 * Uses the DNS protocol to resolve text queries (`TXT` records) for the `hostname` using a specific provider.
+	 * @param hostname Host name to resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	resolveTxt(hostname: string, provider: ProviderName): Promise<string[][]>;
+	resolveTxt(hostname: string, options: AbortOptions): Promise<string[][]>;
+	resolveTxt(hostname: string, options: AbortOptions, provider: ProviderName): Promise<string[][]>;
+	/**
+	 * Performs a reverse DNS query that resolves an IPv4 or IPv6 address to an
+	 * array of host names.
+	 *
+	 * On error, the `Promise` is rejected with an [`Error`](https://nodejs.org/docs/latest-v20.x/api/errors.html#class-error) object, where `err.code`
+	 * is one of the [DNS error codes](https://nodejs.org/docs/latest-v20.x/api/dns.html#error-codes).
+	 * @since v10.6.0
+	 */
+	reverse(ip: string): Promise<string[]>;
+	/**
+	 * Performs a reverse DNS query that resolves an IPv4 or IPv6 address to an array of host names using a specific provider.
+	 * @param ip IPv4 or IPv6 address to reverse resolve.
+	 * @param provider The DNS provider to use for resolution.
+	 */
+	reverse(ip: string, provider: ProviderName): Promise<string[]>;
+	reverse(ip: string, options: AbortOptions): Promise<string[]>;
+	reverse(ip: string, options: AbortOptions, provider: ProviderName): Promise<string[]>;
+}
+declare class NativeProvider {
+	private queue;
+	private config;
+	/** Injected hickory binding, or null for the libuv path. Provided by the
+	 *  `'zynor/native'` entry; never loaded here. */
+	private rustBinding;
+	/**
+	 * Creates a new native DNS provider instance.
+	 *
+	 * @param config - Provider config (concurrency, rate limiting, enabled).
+	 * @param runtime - Internal: `rust` is the hickory binding injected by the
+	 *   `'zynor/native'` entry. When present, MX/A/AAAA/etc. route through it;
+	 *   when absent, everything uses libuv. Not part of the public surface.
+	 */
+	constructor(config?: ProviderConfig);
+	/**
+	 * Updates the provider configuration.
+	 */
+	updateConfig(config: ProviderConfig): void;
+	get enabled(): boolean;
+	get queueSize(): number;
+	get concurrency(): number;
+	get isFull(): boolean;
+	/** Returns the injected hickory binding, or null for the libuv path.
+	 *  No loading happens here — the `'zynor/native'` entry injects (or
+	 *  refuses to construct, if the binary is missing). */
+	private rust;
+	/**
+	 * Executes a function through the queue with abort/timeout support.
+	 */
+	private executeQueued;
+	/**
+	 * @internal Bypasses PQueue and intervalCap. Reserved for the validator
+	 * hot path. Dispatches to Rust when `useRust` is on (and binary loaded);
+	 * otherwise to `dns.resolve`. Both paths remain abort-aware.
+	 */
+	_resolveDirect<T>(hostname: string, type: RecordType, options?: AbortOptions): Promise<T>;
+	/**
+	 * Resolves A records for a hostname. TTL-aware variants stay on libuv.
+	 */
+	resolve4(hostname: string): Promise<string[]>;
+	resolve4(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
+	/** Resolves AAAA records for a hostname. TTL-aware variants stay on libuv. */
+	resolve6(hostname: string): Promise<string[]>;
+	resolve6(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
+	/** ANY records — Rust binding's shape doesn't mirror libuv's tagged union,
+	 *  so we always go through libuv. */
+	resolveAny(hostname: string, options?: AbortOptions): Promise<AnyRecord[]>;
+	resolveCaa(hostname: string, options?: AbortOptions): Promise<CaaRecord[]>;
+	resolveCname(hostname: string, options?: AbortOptions): Promise<string[]>;
+	resolveMx(hostname: string, options?: AbortOptions): Promise<MxRecord[]>;
+	resolveNaptr(hostname: string, options?: AbortOptions): Promise<NaptrRecord[]>;
+	resolveNs(hostname: string, options?: AbortOptions): Promise<string[]>;
+	resolvePtr(hostname: string, options?: AbortOptions): Promise<string[]>;
+	/** SOA. Rust returns `RustSoaRecord | null`; libuv throws on missing.
+	 *  Bridge: if Rust returns null, throw to match libuv contract. */
+	resolveSoa(hostname: string, options?: AbortOptions): Promise<SoaRecord>;
+	resolveSrv(hostname: string, options?: AbortOptions): Promise<SrvRecord[]>;
+	resolveTlsa(hostname: string, options?: AbortOptions): Promise<TlsaRecord[]>;
+	resolveTxt(hostname: string, options?: AbortOptions): Promise<string[][]>;
+	reverse(ip: string, options?: AbortOptions): Promise<string[]>;
+	/**
+	 * Generic resolve method. Dispatches to the typed methods so that the
+	 * Rust path is honored consistently — calling `resolve('gmail.com', 'MX')`
+	 * with `useRust: true` goes through hickory just like `resolveMx` would.
+	 */
+	resolve(hostname: string): Promise<string[]>;
+	resolve(hostname: string, rrtype: "A"): Promise<string[]>;
+	resolve(hostname: string, rrtype: "AAAA"): Promise<string[]>;
+	resolve(hostname: string, rrtype: "ANY"): Promise<AnyRecord[]>;
+	resolve(hostname: string, rrtype: "CAA"): Promise<CaaRecord[]>;
+	resolve(hostname: string, rrtype: "CNAME"): Promise<string[]>;
+	resolve(hostname: string, rrtype: "MX"): Promise<MxRecord[]>;
+	resolve(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>;
+	resolve(hostname: string, rrtype: "NS"): Promise<string[]>;
+	resolve(hostname: string, rrtype: "PTR"): Promise<string[]>;
+	resolve(hostname: string, rrtype: "SOA"): Promise<SoaRecord>;
+	resolve(hostname: string, rrtype: "SRV"): Promise<SrvRecord[]>;
+	resolve(hostname: string, rrtype: "TLSA"): Promise<TlsaRecord[]>;
+	resolve(hostname: string, rrtype: "TXT"): Promise<string[][]>;
+}
+declare const EmailProviders: readonly [
+	{
+		readonly name: "Gmail";
+		readonly domains: readonly [
+			"@gmail.com",
+			"@googlemail.com"
+		];
+	},
+	{
+		readonly name: "Outlook";
+		readonly domains: readonly [
+			"@outlook.com",
+			"@outlook.com.au",
+			"@outlook.com.br",
+			"@outlook.cl",
+			"@outlook.cz",
+			"@outlook.de",
+			"@outlook.dk",
+			"@outlook.es",
+			"@outlook.fr",
+			"@outlook.hu",
+			"@outlook.ie",
+			"@outlook.in",
+			"@outlook.it",
+			"@outlook.jp",
+			"@outlook.kr",
+			"@outlook.lv",
+			"@outlook.my",
+			"@outlook.ph",
+			"@outlook.pt",
+			"@outlook.sa",
+			"@outlook.sg",
+			"@outlook.sk",
+			"@outlook.co.id",
+			"@outlook.co.th",
+			"@hotmail.com",
+			"@hotmail.com.ar",
+			"@hotmail.com.au",
+			"@hotmail.com.br",
+			"@hotmail.co.uk",
+			"@hotmail.de",
+			"@hotmail.es",
+			"@hotmail.fr",
+			"@hotmail.gr",
+			"@hotmail.it",
+			"@hotmail.jp",
+			"@hotmail.nl",
+			"@hotmail.no",
+			"@hotmail.se",
+			"@live.com",
+			"@live.com.ar",
+			"@live.com.au",
+			"@live.com.mx",
+			"@live.co.uk",
+			"@live.ca",
+			"@live.cl",
+			"@live.cn",
+			"@live.de",
+			"@live.dk",
+			"@live.fr",
+			"@live.it",
+			"@live.jp",
+			"@live.nl",
+			"@live.no",
+			"@live.ru",
+			"@live.se",
+			"@msn.com"
+		];
+	},
+	{
+		readonly name: "Yahoo";
+		readonly domains: readonly [
+			"@yahoo.com",
+			"@yahoo.co.uk",
+			"@yahoo.fr",
+			"@yahoo.com.br",
+			"@yahoo.co.in",
+			"@yahoo.es",
+			"@yahoo.it",
+			"@yahoo.de",
+			"@yahoo.in",
+			"@yahoo.ca",
+			"@yahoo.com.au",
+			"@yahoo.co.jp",
+			"@yahoo.com.ar",
+			"@yahoo.com.mx",
+			"@yahoo.co.id",
+			"@yahoo.com.sg",
+			"@ymail.com",
+			"@rocketmail.com",
+			"@yahoo.at",
+			"@yahoo.be",
+			"@yahoo.bg",
+			"@yahoo.cl",
+			"@yahoo.co.hu",
+			"@yahoo.co.kr",
+			"@yahoo.co.nz",
+			"@yahoo.co.th",
+			"@yahoo.co.za",
+			"@yahoo.com.hk",
+			"@yahoo.com.hr",
+			"@yahoo.com.my",
+			"@yahoo.com.pe",
+			"@yahoo.com.ph",
+			"@yahoo.com.tr",
+			"@yahoo.com.tw",
+			"@yahoo.com.ua",
+			"@yahoo.com.ve",
+			"@yahoo.com.vn",
+			"@yahoo.cz",
+			"@yahoo.dk",
+			"@yahoo.ee",
+			"@yahoo.fi",
+			"@yahoo.gr",
+			"@yahoo.hr",
+			"@yahoo.hu",
+			"@yahoo.ie",
+			"@yahoo.lt",
+			"@yahoo.lv",
+			"@yahoo.nl",
+			"@yahoo.no",
+			"@yahoo.pl",
+			"@yahoo.pt",
+			"@yahoo.ro",
+			"@yahoo.rs",
+			"@yahoo.se",
+			"@yahoo.si",
+			"@yahoo.sk"
+		];
+	},
+	{
+		readonly name: "AOL";
+		readonly domains: readonly [
+			"@aol.com",
+			"@aim.com"
+		];
+	},
+	{
+		readonly name: "iCloud";
+		readonly domains: readonly [
+			"@icloud.com",
+			"@me.com",
+			"@mac.com"
+		];
+	},
+	{
+		readonly name: "ProtonMail";
+		readonly domains: readonly [
+			"@protonmail.com",
+			"@protonmail.ch",
+			"@pm.me",
+			"@proton.me"
+		];
+	},
+	{
+		readonly name: "Zoho";
+		readonly domains: readonly [
+			"@zoho.com",
+			"@zohomail.com"
+		];
+	},
+	{
+		readonly name: "Mail.ru";
+		readonly domains: readonly [
+			"@mail.ru",
+			"@bk.ru",
+			"@inbox.ru",
+			"@list.ru",
+			"@internet.ru",
+			"@corp.mail.ru",
+			"@ro.ru",
+			"@rbcmail.ru",
+			"@hotbox.ru",
+			"@mail15.com",
+			"@pochta.ru",
+			"@fromru.com",
+			"@front.ru",
+			"@krovatka.su",
+			"@land.ru",
+			"@newmail.ru",
+			"@nightmail.ru",
+			"@nm.ru",
+			"@pisem.net",
+			"@pochtamt.ru",
+			"@pop3.ru",
+			"@smtp.ru",
+			"@mail333.com",
+			"@mailru.com",
+			"@e-mail.ru",
+			"@email.ru",
+			"@emailru.com",
+			"@mail.ua",
+			"@bigmir.net",
+			"@ukr.net",
+			"@i.ua",
+			"@meta.ua",
+			"@online.ua",
+			"@yandex.ua",
+			"@yandex.by",
+			"@yandex.kz",
+			"@narod.ru",
+			"@lenta.ru",
+			"@autorambler.ru",
+			"@myrambler.ru",
+			"@r0.ru",
+			"@rambler.ua",
+			"@qip.ru",
+			"@mail.kz",
+			"@nursat.kz",
+			"@kazmail.kz",
+			"@mail.kg",
+			"@mail.tj",
+			"@mail.uz",
+			"@tut.by",
+			"@mail.by",
+			"@open.by",
+			"@rambler.by",
+			"@mail.md",
+			"@mail.am",
+			"@mail.ge",
+			"@mail.az",
+			"@mail.lv",
+			"@mail.lt",
+			"@mail.ee",
+			"@delfi.lv",
+			"@inbox.lv",
+			"@apollo.lv",
+			"@one.lv",
+			"@parks.lv"
+		];
+	},
+	{
+		readonly name: "Yandex";
+		readonly domains: readonly [
+			"@yandex.ru",
+			"@yandex.com",
+			"@ya.ru"
+		];
+	},
+	{
+		readonly name: "GMX";
+		readonly domains: readonly [
+			"@gmx.com",
+			"@gmx.net",
+			"@gmx.de",
+			"@gmx.at",
+			"@gmx.ch"
+		];
+	},
+	{
+		readonly name: "Web.de";
+		readonly domains: readonly [
+			"@web.de"
+		];
+	},
+	{
+		readonly name: "Mail.com";
+		readonly domains: readonly [
+			"@mail.com",
+			"@email.com",
+			"@usa.com",
+			"@myself.com",
+			"@consultant.com",
+			"@post.com",
+			"@europe.com",
+			"@asia.com",
+			"@iname.com",
+			"@writeme.com",
+			"@techie.com",
+			"@accountant.com",
+			"@activist.com",
+			"@adexec.com",
+			"@allergist.com",
+			"@alumnidirector.com",
+			"@angelic.com",
+			"@appraiser.com",
+			"@archaeologist.com",
+			"@architect.com",
+			"@artlover.com",
+			"@asia-mail.com",
+			"@auctioneer.com",
+			"@bartender.com",
+			"@bikerider.com",
+			"@birdlover.com",
+			"@brew-master.com",
+			"@brew-meister.com",
+			"@chef.net",
+			"@chemist.com",
+			"@clerk.com",
+			"@clubmember.com",
+			"@collector.com",
+			"@columnist.com",
+			"@comic.com",
+			"@computer4u.com",
+			"@contractor.com",
+			"@coolsite.net",
+			"@counsellor.com",
+			"@count.com",
+			"@cyber-wizard.com",
+			"@cyberdude.com",
+			"@cybergal.com",
+			"@cyberservices.com",
+			"@dallasmail.com",
+			"@dbzmail.com",
+			"@deliveryman.com",
+			"@diplomats.com",
+			"@doctor.com",
+			"@dr.com",
+			"@engineer.com",
+			"@execs.com",
+			"@fastservice.com",
+			"@financialmail.com",
+			"@fireman.net",
+			"@gardener.com",
+			"@geologist.com",
+			"@graduate.org",
+			"@graphic-designer.com",
+			"@groupmail.com",
+			"@hairdresser.net",
+			"@homemail.com",
+			"@hot-shot.com",
+			"@humanoid.net",
+			"@instructor.net",
+			"@insurer.com",
+			"@journalist.com",
+			"@lawyer.com",
+			"@legislator.com",
+			"@lobbyist.com",
+			"@mad.scientist.com",
+			"@manager.com",
+			"@mathematician.com",
+			"@mechanic.com",
+			"@minister.com",
+			"@musician.org",
+			"@optician.com",
+			"@orthodontist.net",
+			"@pediatrician.com",
+			"@photographer.net",
+			"@physicist.net",
+			"@politician.com",
+			"@presidency.com",
+			"@priest.com",
+			"@programmer.net",
+			"@publicist.com",
+			"@realtyagent.com",
+			"@registrar.com",
+			"@repairman.com",
+			"@representative.com",
+			"@rescueteam.com",
+			"@salesperson.net",
+			"@scientist.com",
+			"@secretary.net",
+			"@socialworker.net",
+			"@sociologist.com",
+			"@solution4u.com",
+			"@songwriter.net",
+			"@surgical.net",
+			"@teacher.net",
+			"@technologist.com",
+			"@therapist.net",
+			"@toothfairy.com",
+			"@tvstar.com",
+			"@umpire.com",
+			"@webname.com",
+			"@worker.com",
+			"@workmail.com"
+		];
+	},
+	{
+		readonly name: "Fastmail";
+		readonly domains: readonly [
+			"@fastmail.com",
+			"@fastmail.fm"
+		];
+	},
+	{
+		readonly name: "AT&T";
+		readonly domains: readonly [
+			"@att.net",
+			"@sbcglobal.net",
+			"@sbcglobal.com",
+			"@ameritech.net",
+			"@bellsouth.net",
+			"@flash.net",
+			"@prodigy.net",
+			"@pacbell.net",
+			"@nvbell.net",
+			"@snet.net",
+			"@swbell.net",
+			"@wans.net",
+			"@worldnet.att.net"
+		];
+	},
+	{
+		readonly name: "Comcast";
+		readonly domains: readonly [
+			"@comcast.net"
+		];
+	},
+	{
+		readonly name: "Verizon";
+		readonly domains: readonly [
+			"@verizon.net"
+		];
+	},
+	{
+		readonly name: "Cox";
+		readonly domains: readonly [
+			"@cox.net"
+		];
+	},
+	{
+		readonly name: "Charter";
+		readonly domains: readonly [
+			"@charter.net"
+		];
+	},
+	{
+		readonly name: "Earthlink";
+		readonly domains: readonly [
+			"@earthlink.net"
+		];
+	},
+	{
+		readonly name: "Frontier";
+		readonly domains: readonly [
+			"@frontier.com",
+			"@frontiernet.net",
+			"@myfrontiermail.com",
+			"@frontiernet.com"
+		];
+	},
+	{
+		readonly name: "Windstream";
+		readonly domains: readonly [
+			"@windstream.net"
+		];
+	},
+	{
+		readonly name: "CenturyTel";
+		readonly domains: readonly [
+			"@centurytel.net"
+		];
+	},
+	{
+		readonly name: "Juno";
+		readonly domains: readonly [
+			"@juno.com"
+		];
+	},
+	{
+		readonly name: "Optonline";
+		readonly domains: readonly [
+			"@optonline.net"
+		];
+	},
+	{
+		readonly name: "QQ";
+		readonly domains: readonly [
+			"@qq.com"
+		];
+	},
+	{
+		readonly name: "163";
+		readonly domains: readonly [
+			"@163.com",
+			"@126.com"
+		];
+	},
+	{
+		readonly name: "139";
+		readonly domains: readonly [
+			"@139.com"
+		];
+	},
+	{
+		readonly name: "21cn";
+		readonly domains: readonly [
+			"@21cn.com"
+		];
+	},
+	{
+		readonly name: "Sina";
+		readonly domains: readonly [
+			"@sina.com",
+			"@sina.cn",
+			"@sina.com.cn"
+		];
+	},
+	{
+		readonly name: "Sohu";
+		readonly domains: readonly [
+			"@sohu.com"
+		];
+	},
+	{
+		readonly name: "Aliyun";
+		readonly domains: readonly [
+			"@aliyun.com",
+			"@alibaba.com"
+		];
+	},
+	{
+		readonly name: "Naver";
+		readonly domains: readonly [
+			"@naver.com"
+		];
+	},
+	{
+		readonly name: "Daum";
+		readonly domains: readonly [
+			"@daum.net",
+			"@hanmail.net"
+		];
+	},
+	{
+		readonly name: "Nate";
+		readonly domains: readonly [
+			"@nate.com"
+		];
+	},
+	{
+		readonly name: "Netvigator";
+		readonly domains: readonly [
+			"@netvigator.com"
+		];
+	},
+	{
+		readonly name: "Ziggo";
+		readonly domains: readonly [
+			"@ziggo.nl"
+		];
+	},
+	{
+		readonly name: "263.net";
+		readonly domains: readonly [
+			"@263.net"
+		];
+	},
+	{
+		readonly name: "Aruba";
+		readonly domains: readonly [
+			"@aruba.it"
+		];
+	},
+	{
+		readonly name: "Plala Webmail";
+		readonly domains: readonly [
+			"@plala.or.jp"
+		];
+	},
+	{
+		readonly name: "Turbify";
+		readonly domains: readonly [
+			"@yahoo-inc.com"
+		];
+	},
+	{
+		readonly name: "Godaddy";
+		readonly domains: readonly [
+			"@secureserver.net"
+		];
+	},
+	{
+		readonly name: "Rackspace";
+		readonly domains: readonly [
+			"@emailsrvr.com"
+		];
+	},
+	{
+		readonly name: "Mimecast";
+		readonly domains: readonly [
+			"@mimecast.com"
+		];
+	},
+	{
+		readonly name: "Facebook";
+		readonly domains: readonly [
+			"@facebook.com"
+		];
+	},
+	{
+		readonly name: "Amazon";
+		readonly domains: readonly [
+			"@amazon.com",
+			"@amazonaws.com"
+		];
+	},
+	{
+		readonly name: "Anazana";
+		readonly domains: readonly [
+			"@anazana.com"
+		];
+	},
+	{
+		readonly name: "CoreMail";
+		readonly domains: readonly [
+			"@icoremail.net"
+		];
+	},
+	{
+		readonly name: "Hinet";
+		readonly domains: readonly [
+			"@hinet.net"
+		];
+	},
+	{
+		readonly name: "Iinet";
+		readonly domains: readonly [
+			"@iinet.net.au"
+		];
+	},
+	{
+		readonly name: "Namecheap";
+		readonly domains: readonly [
+			"@registrar-servers.com"
+		];
+	},
+	{
+		readonly name: "Network Solutions";
+		readonly domains: readonly [
+			"@myregisteredsite.com"
+		];
+	},
+	{
+		readonly name: "Orange";
+		readonly domains: readonly [
+			"@orange.fr",
+			"@wanadoo.fr"
+		];
+	},
+	{
+		readonly name: "Synaq";
+		readonly domains: readonly [
+			"@synaq.com"
+		];
+	},
+	{
+		readonly name: "Zmail";
+		readonly domains: readonly [
+			"@zmail.ru"
+		];
+	},
+	{
+		readonly name: "Strato";
+		readonly domains: readonly [
+			"@strato.de"
+		];
+	},
+	{
+		readonly name: "Apple";
+		readonly domains: readonly [
+			"@apple.com"
+		];
+	},
+	{
+		readonly name: "Cox Webmail";
+		readonly domains: readonly [
+			"@cloudfilter.net"
+		];
+	},
+	{
+		readonly name: "Mailgun";
+		readonly domains: readonly [
+			"@mailgun.org"
+		];
+	},
+	{
+		readonly name: "Postmark";
+		readonly domains: readonly [
+			"@pmta.postmarkapp.com"
+		];
+	},
+	{
+		readonly name: "SendGrid";
+		readonly domains: readonly [
+			"@sendgrid.net"
+		];
+	},
+	{
+		readonly name: "Elastic Email";
+		readonly domains: readonly [
+			"@elasticemail.com"
+		];
+	},
+	{
+		readonly name: "Zendesk";
+		readonly domains: readonly [
+			"@zendesk.com"
+		];
+	},
+	{
+		readonly name: "Intermedia";
+		readonly domains: readonly [
+			"@intermedia.net"
+		];
+	},
+	{
+		readonly name: "Mailjet";
+		readonly domains: readonly [
+			"@mailjet.com"
+		];
+	},
+	{
+		readonly name: "Front";
+		readonly domains: readonly [
+			"@frontapp.com"
+		];
+	},
+	{
+		readonly name: "Free.fr";
+		readonly domains: readonly [
+			"@free.fr"
+		];
+	},
+	{
+		readonly name: "Libero";
+		readonly domains: readonly [
+			"@libero.it"
+		];
+	},
+	{
+		readonly name: "UOL";
+		readonly domains: readonly [
+			"@uol.com.br"
+		];
+	},
+	{
+		readonly name: "BOL";
+		readonly domains: readonly [
+			"@bol.com.br"
+		];
+	},
+	{
+		readonly name: "SFR";
+		readonly domains: readonly [
+			"@sfr.fr"
+		];
+	},
+	{
+		readonly name: "IG";
+		readonly domains: readonly [
+			"@ig.com.br"
+		];
+	},
+	{
+		readonly name: "Bigpond";
+		readonly domains: readonly [
+			"@bigpond.com",
+			"@bigpond.net.au"
+		];
+	},
+	{
+		readonly name: "Terra";
+		readonly domains: readonly [
+			"@terra.com.br"
+		];
+	},
+	{
+		readonly name: "Neuf";
+		readonly domains: readonly [
+			"@neuf.fr"
+		];
+	},
+	{
+		readonly name: "Alice";
+		readonly domains: readonly [
+			"@alice.it",
+			"@aliceadsl.fr"
+		];
+	},
+	{
+		readonly name: "La Poste";
+		readonly domains: readonly [
+			"@laposte.net"
+		];
+	},
+	{
+		readonly name: "Rambler";
+		readonly domains: readonly [
+			"@rambler.ru"
+		];
+	},
+	{
+		readonly name: "Tiscali";
+		readonly domains: readonly [
+			"@tiscali.it",
+			"@tiscali.co.uk"
+		];
+	},
+	{
+		readonly name: "Shaw";
+		readonly domains: readonly [
+			"@shaw.ca"
+		];
+	},
+	{
+		readonly name: "Sky";
+		readonly domains: readonly [
+			"@sky.com"
+		];
+	},
+	{
+		readonly name: "Freenet";
+		readonly domains: readonly [
+			"@freenet.de"
+		];
+	},
+	{
+		readonly name: "T-Online";
+		readonly domains: readonly [
+			"@t-online.de"
+		];
+	},
+	{
+		readonly name: "Virgilio";
+		readonly domains: readonly [
+			"@virgilio.it"
+		];
+	},
+	{
+		readonly name: "Home.nl";
+		readonly domains: readonly [
+			"@home.nl"
+		];
+	},
+	{
+		readonly name: "Telenet";
+		readonly domains: readonly [
+			"@telenet.be"
+		];
+	},
+	{
+		readonly name: "Voila";
+		readonly domains: readonly [
+			"@voila.fr"
+		];
+	},
+	{
+		readonly name: "Planet.nl";
+		readonly domains: readonly [
+			"@planet.nl"
+		];
+	},
+	{
+		readonly name: "Tin.it";
+		readonly domains: readonly [
+			"@tin.it"
+		];
+	},
+	{
+		readonly name: "NTL World";
+		readonly domains: readonly [
+			"@ntlworld.com"
+		];
+	},
+	{
+		readonly name: "Arcor";
+		readonly domains: readonly [
+			"@arcor.de"
+		];
+	},
+	{
+		readonly name: "Hetnet";
+		readonly domains: readonly [
+			"@hetnet.nl"
+		];
+	},
+	{
+		readonly name: "Zonnet";
+		readonly domains: readonly [
+			"@zonnet.nl"
+		];
+	},
+	{
+		readonly name: "Club Internet";
+		readonly domains: readonly [
+			"@club-internet.fr"
+		];
+	},
+	{
+		readonly name: "Optus";
+		readonly domains: readonly [
+			"@optusnet.com.au"
+		];
+	},
+	{
+		readonly name: "Blueyonder";
+		readonly domains: readonly [
+			"@blueyonder.co.uk"
+		];
+	},
+	{
+		readonly name: "Bluewin";
+		readonly domains: readonly [
+			"@bluewin.ch"
+		];
+	},
+	{
+		readonly name: "Skynet";
+		readonly domains: readonly [
+			"@skynet.be"
+		];
+	},
+	{
+		readonly name: "Sympatico";
+		readonly domains: readonly [
+			"@sympatico.ca"
+		];
+	},
+	{
+		readonly name: "Chello";
+		readonly domains: readonly [
+			"@chello.nl"
+		];
+	},
+	{
+		readonly name: "Hey";
+		readonly domains: readonly [
+			"@hey.com"
+		];
+	},
+	{
+		readonly name: "Inbox";
+		readonly domains: readonly [
+			"@inbox.lv",
+			"@inbox.eu"
+		];
+	},
+	{
+		readonly name: "Kolab Now";
+		readonly domains: readonly [
+			"@kolabnow.com"
+		];
+	},
+	{
+		readonly name: "Lycos";
+		readonly domains: readonly [
+			"@lycos.com"
+		];
+	},
+	{
+		readonly name: "Mailbox.org";
+		readonly domains: readonly [
+			"@mailbox.org"
+		];
+	},
+	{
+		readonly name: "Mailfence";
+		readonly domains: readonly [
+			"@mailfence.com"
+		];
+	},
+	{
+		readonly name: "Posteo";
+		readonly domains: readonly [
+			"@posteo.de"
+		];
+	},
+	{
+		readonly name: "Rediffmail";
+		readonly domains: readonly [
+			"@rediffmail.com"
+		];
+	},
+	{
+		readonly name: "Skiff";
+		readonly domains: readonly [
+			"@skiff.com"
+		];
+	},
+	{
+		readonly name: "Tutanota";
+		readonly domains: readonly [
+			"@tutanota.com",
+			"@tutanota.de",
+			"@tuta.io",
+			"@tutamail.com",
+			"@keemail.me"
+		];
+	},
+	{
+		readonly name: "DuckDuckGo Email";
+		readonly domains: readonly [
+			"@duck.com"
+		];
+	},
+	{
+		readonly name: "SimpleLogin";
+		readonly domains: readonly [
+			"@simplelogin.com",
+			"@simplelogin.fr",
+			"@simplelogin.co",
+			"@simplelogin.io",
+			"@aleeas.com",
+			"@silomails.com",
+			"@slmails.com",
+			"@slmail.me"
+		];
+	},
+	{
+		readonly name: "Addy.io";
+		readonly domains: readonly [
+			"@addy.io",
+			"@anonaddy.com",
+			"@anonaddy.me"
+		];
+	},
+	{
+		readonly name: "Firefox Relay";
+		readonly domains: readonly [
+			"@mozmail.com"
+		];
+	},
+	{
+		readonly name: "StartMail";
+		readonly domains: readonly [
+			"@startmail.com"
+		];
+	},
+	{
+		readonly name: "Runbox";
+		readonly domains: readonly [
+			"@runbox.com"
+		];
+	},
+	{
+		readonly name: "Disroot";
+		readonly domains: readonly [
+			"@disroot.org"
+		];
+	},
+	{
+		readonly name: "Riseup";
+		readonly domains: readonly [
+			"@riseup.net"
+		];
+	},
+	{
+		readonly name: "CounterMail";
+		readonly domains: readonly [
+			"@countermail.com"
+		];
+	},
+	{
+		readonly name: "Soverin";
+		readonly domains: readonly [
+			"@soverin.net"
+		];
+	},
+	{
+		readonly name: "WP";
+		readonly domains: readonly [
+			"@wp.pl",
+			"@o2.pl",
+			"@tlen.pl"
+		];
+	},
+	{
+		readonly name: "Onet";
+		readonly domains: readonly [
+			"@onet.pl",
+			"@op.pl",
+			"@vp.pl",
+			"@onet.eu"
+		];
+	},
+	{
+		readonly name: "Interia";
+		readonly domains: readonly [
+			"@interia.pl",
+			"@interia.eu",
+			"@poczta.fm"
+		];
+	},
+	{
+		readonly name: "Gazeta.pl";
+		readonly domains: readonly [
+			"@gazeta.pl"
+		];
+	},
+	{
+		readonly name: "Seznam";
+		readonly domains: readonly [
+			"@seznam.cz",
+			"@email.cz",
+			"@post.cz"
+		];
+	},
+	{
+		readonly name: "Centrum";
+		readonly domains: readonly [
+			"@centrum.cz",
+			"@centrum.sk"
+		];
+	},
+	{
+		readonly name: "Volny";
+		readonly domains: readonly [
+			"@volny.cz"
+		];
+	},
+	{
+		readonly name: "Freemail HU";
+		readonly domains: readonly [
+			"@freemail.hu",
+			"@citromail.hu"
+		];
+	},
+	{
+		readonly name: "In.gr";
+		readonly domains: readonly [
+			"@in.gr"
+		];
+	},
+	{
+		readonly name: "Sify";
+		readonly domains: readonly [
+			"@sifymail.com",
+			"@sify.com"
+		];
+	},
+	{
+		readonly name: "Indiatimes";
+		readonly domains: readonly [
+			"@indiatimes.com"
+		];
+	},
+	{
+		readonly name: "BSNL";
+		readonly domains: readonly [
+			"@bsnl.in",
+			"@dataone.in"
+		];
+	},
+	{
+		readonly name: "Locaweb";
+		readonly domains: readonly [
+			"@lwmail.com.br"
+		];
+	},
+	{
+		readonly name: "Movistar";
+		readonly domains: readonly [
+			"@telefonica.net",
+			"@movistar.es"
+		];
+	},
+	{
+		readonly name: "Telkom SA";
+		readonly domains: readonly [
+			"@telkomsa.net",
+			"@vodamail.co.za",
+			"@webmail.co.za"
+		];
+	},
+	{
+		readonly name: "BIGLOBE";
+		readonly domains: readonly [
+			"@biglobe.ne.jp"
+		];
+	},
+	{
+		readonly name: "@nifty";
+		readonly domains: readonly [
+			"@nifty.com",
+			"@nifty.ne.jp"
+		];
+	},
+	{
+		readonly name: "OCN";
+		readonly domains: readonly [
+			"@ocn.ne.jp"
+		];
+	},
+	{
+		readonly name: "Rakuten";
+		readonly domains: readonly [
+			"@rakuten.co.jp",
+			"@gol.com"
+		];
+	},
+	{
+		readonly name: "Excite Japan";
+		readonly domains: readonly [
+			"@excite.co.jp"
+		];
+	},
+	{
+		readonly name: "So-net";
+		readonly domains: readonly [
+			"@so-net.ne.jp"
+		];
+	},
+	{
+		readonly name: "Xtra";
+		readonly domains: readonly [
+			"@xtra.co.nz"
+		];
+	},
+	{
+		readonly name: "Spectrum";
+		readonly domains: readonly [
+			"@spectrum.net"
+		];
+	},
+	{
+		readonly name: "RoadRunner";
+		readonly domains: readonly [
+			"@rr.com",
+			"@twc.com",
+			"@roadrunner.com",
+			"@nc.rr.com",
+			"@sc.rr.com",
+			"@socal.rr.com",
+			"@tampabay.rr.com",
+			"@cinci.rr.com",
+			"@nycap.rr.com",
+			"@neo.rr.com"
+		];
+	},
+	{
+		readonly name: "Mediacom";
+		readonly domains: readonly [
+			"@mediacombb.net",
+			"@mchsi.com"
+		];
+	},
+	{
+		readonly name: "Optimum";
+		readonly domains: readonly [
+			"@optimum.net"
+		];
+	},
+	{
+		readonly name: "Suddenlink";
+		readonly domains: readonly [
+			"@suddenlink.net"
+		];
+	},
+	{
+		readonly name: "RCN";
+		readonly domains: readonly [
+			"@rcn.com"
+		];
+	},
+	{
+		readonly name: "Breezeline";
+		readonly domains: readonly [
+			"@atlanticbb.net",
+			"@breezeline.com"
+		];
+	},
+	{
+		readonly name: "BT Internet";
+		readonly domains: readonly [
+			"@btinternet.com",
+			"@btopenworld.com",
+			"@talk21.com"
+		];
+	},
+	{
+		readonly name: "Virgin Media";
+		readonly domains: readonly [
+			"@virginmedia.com",
+			"@virgin.net"
+		];
+	},
+	{
+		readonly name: "TalkTalk";
+		readonly domains: readonly [
+			"@talktalk.net"
+		];
+	},
+	{
+		readonly name: "Plusnet";
+		readonly domains: readonly [
+			"@plus.net",
+			"@force9.co.uk",
+			"@free-online.net"
+		];
+	},
+	{
+		readonly name: "Rogers";
+		readonly domains: readonly [
+			"@rogers.com"
+		];
+	},
+	{
+		readonly name: "Bell";
+		readonly domains: readonly [
+			"@bell.net"
+		];
+	},
+	{
+		readonly name: "Telus";
+		readonly domains: readonly [
+			"@telus.net"
+		];
+	},
+	{
+		readonly name: "Videotron";
+		readonly domains: readonly [
+			"@videotron.ca",
+			"@videotron.qc.ca"
+		];
+	},
+	{
+		readonly name: "Cogeco";
+		readonly domains: readonly [
+			"@cogeco.ca"
+		];
+	}
+];
+export type ProviderNames = typeof EmailProviders[number]["name"];
+declare const records: readonly [
+	{
+		readonly name: "Sohu";
+		readonly mx: "a.sohu.com";
+	},
+	{
+		readonly name: "Sohu";
+		readonly mx: "sohu.com";
+	},
+	{
+		readonly name: "Strato";
+		readonly mx: ".rzone.de";
+	},
+	{
+		readonly name: "Strato";
+		readonly mx: ".strato.de";
+	},
+	{
+		readonly name: "21cn";
+		readonly mx: ".21cn.com";
+	},
+	{
+		readonly name: "163";
+		readonly mx: ".netease.com";
+	},
+	{
+		readonly name: "Netvigator";
+		readonly mx: ".netvigator.com";
+	},
+	{
+		readonly name: "139";
+		readonly mx: ".mail.139.com";
+	},
+	{
+		readonly name: "Nate";
+		readonly mx: ".nate.com";
+	},
+	{
+		readonly name: "Naver";
+		readonly mx: ".naver.com";
+	},
+	{
+		readonly name: "Daum";
+		readonly mx: ".daum.kgslb.com";
+	},
+	{
+		readonly name: "Daum";
+		readonly mx: ".hanmail.net";
+	},
+	{
+		readonly name: "Ziggo";
+		readonly mx: ".ziggo.nl";
+	},
+	{
+		readonly name: "QQ";
+		readonly mx: ".qq.com";
+	},
+	{
+		readonly name: "263.net";
+		readonly mx: "263.net";
+	},
+	{
+		readonly name: "Sina";
+		readonly mx: ".vip.sina.com";
+	},
+	{
+		readonly name: "Sina";
+		readonly mx: ".sina.com.cn";
+	},
+	{
+		readonly name: "Aruba";
+		readonly mx: ".aruba.it";
+	},
+	{
+		readonly name: "Aliyun";
+		readonly mx: ".mxhichina.com";
+	},
+	{
+		readonly name: "Plala Webmail";
+		readonly mx: ".plala.or.jp";
+	},
+	{
+		readonly name: "AOL";
+		readonly mx: "mx-aol.mail";
+	},
+	{
+		readonly name: "Turbify";
+		readonly mx: "mx-biz.mail.am0.yahoodns.net";
+	},
+	{
+		readonly name: "Turbify";
+		readonly mx: "mx-biz.mail.am.yahoodns.net";
+	},
+	{
+		readonly name: "Turbify";
+		readonly mx: "mx-biz.mail.am1.yahoodns.net";
+	},
+	{
+		readonly name: "Turbify";
+		readonly mx: "mx1.biz.mail.yahoo.com";
+	},
+	{
+		readonly name: "Turbify";
+		readonly mx: "mx5.biz.mail.yahoo.com";
+	},
+	{
+		readonly name: "Turbify";
+		readonly mx: ".biz.mail.yahoo.com";
+	},
+	{
+		readonly name: "AT&T";
+		readonly mx: ".prodigy.net";
+	},
+	{
+		readonly name: "Yahoo";
+		readonly mx: ".yahoo.";
+	},
+	{
+		readonly name: "Yahoo";
+		readonly mx: ".yahoodns.net";
+	},
+	{
+		readonly name: "Zoho";
+		readonly mx: ".zoho.com";
+	},
+	{
+		readonly name: "Sitestar Webmail";
+		readonly mx: ".sitestar.everyone.net";
+		readonly webmail: "https://webmail.sitestar.net";
+	},
+	{
+		readonly name: "Outlook Web App (OWA)";
+		readonly mx: ".serverdata.net";
+		readonly webmail: "https://owa.serverdata.net";
+	},
+	{
+		readonly name: "1and1";
+		readonly mx: ".1and1.";
+	},
+	{
+		readonly name: "Outlook";
+		readonly mx: "olc.protection.outlook.com";
+	},
+	{
+		readonly name: "Outlook";
+		readonly mx: ".mail.outlook.com";
+	},
+	{
+		readonly name: "Outlook";
+		readonly mx: ".hotmail.";
+	},
+	{
+		readonly name: "Office 365";
+		readonly mx: "mail.protection.outlook.com";
+	},
+	{
+		readonly name: "Office 365";
+		readonly mx: ".outlook.com";
+	},
+	{
+		readonly name: "Office 365";
+		readonly mx: ".office365.com";
+	},
+	{
+		readonly name: "Gmail";
+		readonly mx: ".google.com";
+	},
+	{
+		readonly name: "Mail.ru";
+		readonly mx: ".mail.ru";
+	},
+	{
+		readonly name: "Mail.com";
+		readonly mx: ".mail.com";
+	},
+	{
+		readonly name: "Earthlink";
+		readonly mx: ".earthlink.net";
+	},
+	{
+		readonly name: "Earthlink";
+		readonly mx: ".oxsus-vadesecure.net";
+	},
+	{
+		readonly name: "Rackspace";
+		readonly mx: ".emailsrvr.com";
+	},
+	{
+		readonly name: "Mimecast";
+		readonly mx: ".mimecast.com";
+	},
+	{
+		readonly name: "Godaddy";
+		readonly mx: ".secureserver.net";
+	},
+	{
+		readonly name: "Comcast";
+		readonly mx: ".comcast.net";
+	},
+	{
+		readonly name: "Office 365";
+		readonly mx: ".ppe-hosted.com";
+	},
+	{
+		readonly name: "Office 365";
+		readonly mx: ".gslb.pphosted.com";
+	},
+	{
+		readonly name: "Office 365";
+		readonly mx: ".arsmtp.com";
+	},
+	{
+		readonly name: "Zoho";
+		readonly mx: ".zoho.com";
+	},
+	{
+		readonly name: "ProtonMail";
+		readonly mx: "mail.protonmail.ch";
+	},
+	{
+		readonly name: "Facebook";
+		readonly mx: ".facebook.com";
+	},
+	{
+		readonly name: "163";
+		readonly mx: ".netease.com";
+	},
+	{
+		readonly name: "163";
+		readonly mx: ".163.com";
+	},
+	{
+		readonly name: "263";
+		readonly mx: ".263.net";
+	},
+	{
+		readonly name: "Aliyun";
+		readonly mx: ".alibaba.com";
+	},
+	{
+		readonly name: "Aliyun";
+		readonly mx: ".aliyun.com";
+	},
+	{
+		readonly name: "Amazon";
+		readonly mx: ".amazon.com";
+	},
+	{
+		readonly name: "Amazon";
+		readonly mx: ".amazonaws.com";
+	},
+	{
+		readonly name: "Anazana";
+		readonly mx: ".anazana.com";
+	},
+	{
+		readonly name: "CoreMail";
+		readonly mx: ".icoremail.net";
+	},
+	{
+		readonly name: "GMX";
+		readonly mx: ".gmx.net";
+	},
+	{
+		readonly name: "GMX";
+		readonly mx: ".gmx.com";
+	},
+	{
+		readonly name: "Hinet";
+		readonly mx: ".hinet.";
+	},
+	{
+		readonly name: "iCloud";
+		readonly mx: ".icloud.com";
+	},
+	{
+		readonly name: "Iinet";
+		readonly mx: ".iinet.net.au";
+	},
+	{
+		readonly name: "Namecheap";
+		readonly mx: ".registrar-servers.com";
+	},
+	{
+		readonly name: "Network Solutions";
+		readonly mx: ".myregisteredsite.com";
+	},
+	{
+		readonly name: "Orange";
+		readonly mx: ".orange.";
+	},
+	{
+		readonly name: "QQ";
+		readonly mx: ".qq.com";
+	},
+	{
+		readonly name: "Synaq";
+		readonly mx: ".synaq.";
+	},
+	{
+		readonly name: "Web.de";
+		readonly mx: ".web.de";
+	},
+	{
+		readonly name: "Yandex";
+		readonly mx: ".yandex.";
+	},
+	{
+		readonly name: "Zmail";
+		readonly mx: ".zmail.";
+	},
+	{
+		readonly name: "Strato";
+		readonly mx: ".strato.de";
+	},
+	{
+		readonly name: "Apple";
+		readonly mx: ".apple.com";
+	},
+	{
+		readonly name: "Cox Webmail";
+		readonly mx: ".cloudfilter.net";
+	},
+	{
+		readonly name: "Fastmail";
+		readonly mx: ".messagingengine.com";
+	},
+	{
+		readonly name: "Mailgun";
+		readonly mx: ".mailgun.org";
+	},
+	{
+		readonly name: "Postmark";
+		readonly mx: ".pmta.postmarkapp.com";
+	},
+	{
+		readonly name: "SendGrid";
+		readonly mx: ".sendgrid.net";
+	},
+	{
+		readonly name: "Elastic Email";
+		readonly mx: ".elasticemail.com";
+	},
+	{
+		readonly name: "Zendesk";
+		readonly mx: ".zendesk.com";
+	},
+	{
+		readonly name: "Intermedia";
+		readonly mx: ".intermedia.net";
+	},
+	{
+		readonly name: "Mailjet";
+		readonly mx: ".mailjet.com";
+	},
+	{
+		readonly name: "Front";
+		readonly mx: ".frontapp.com";
+	},
+	{
+		readonly name: "Tutanota";
+		readonly mx: ".tutanota.de";
+	},
+	{
+		readonly name: "Tutanota";
+		readonly mx: ".tutanota.com";
+	},
+	{
+		readonly name: "Tutanota";
+		readonly mx: ".tuta.io";
+	},
+	{
+		readonly name: "Mailbox.org";
+		readonly mx: ".mailbox.org";
+	},
+	{
+		readonly name: "Posteo";
+		readonly mx: ".posteo.de";
+	},
+	{
+		readonly name: "Mailfence";
+		readonly mx: ".mailfence.com";
+	},
+	{
+		readonly name: "Rediffmail";
+		readonly mx: ".rediffmail.com";
+	},
+	{
+		readonly name: "Rediffmail";
+		readonly mx: ".rediff.com";
+	},
+	{
+		readonly name: "Lycos";
+		readonly mx: ".lycos.com";
+	},
+	{
+		readonly name: "Kolab Now";
+		readonly mx: ".kolabnow.com";
+	},
+	{
+		readonly name: "Hey";
+		readonly mx: ".hey.com";
+	},
+	{
+		readonly name: "Skiff";
+		readonly mx: ".skiff.com";
+	},
+	{
+		readonly name: "Inbox";
+		readonly mx: ".inbox.lv";
+	},
+	{
+		readonly name: "Inbox";
+		readonly mx: ".inbox.eu";
+	},
+	{
+		readonly name: "Unknown";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Webmail";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Zimbra";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Others";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Aruba";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Alibaba";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "IBM";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Digitalocean";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "AWS Partner";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Microsoft Exchange";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Oracle Cloud";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Roundcube Webmail";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "cPanel Webmail";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Yahoo (External Provider)";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "cPanel Webmail";
+		readonly mx: "..................";
+	},
+	{
+		readonly name: "Disposable";
+		readonly mx: "..................";
+	}
+];
+export type EmailProviderName = typeof records[number]["name"] | ProviderNames;
+/**
+ * Logger signature for debug output. Receives one preformatted line per event.
+ */
+export type DebugLogger = (line: string) => void;
+/**
+ * Verbosity level for debug logging.
+ * - `info`  — top-level checkpoints only: validate() enter/exit, MX result,
+ *             shallow/deep/Invalid outcome, deep-validation enter/exit,
+ *             validateBulk phase boundaries. Best for spotting *where* a hang
+ *             occurs without drowning in noise.
+ * - `debug` — adds sub-operations: cache hits/misses, MX→record matches,
+ *             domain_check probes, dnsLookup per-IP iteration, IP-cascade
+ *             HTTP calls, per-EmailProviders match.
+ * - `trace` — adds every event: inflight hit/cleared, per-mx loop iterations,
+ *             per-worker bulk progress, syntax/rejected/disposable early
+ *             returns. Use only when `debug` doesn't pinpoint the issue.
+ */
+export type DebugLevel = "info" | "debug" | "trace";
+export interface ValidationConfig {
+	/**
+	 * Structured debug logging for the validation flow. Off by default.
+	 *
+	 * - `false` / omitted — silent (no overhead)
+	 * - `true` — `info` level, logged to stderr via `console.error`
+	 * - `'info' | 'debug' | 'trace'` — that level on stderr
+	 * - `(line: string) => void` — `trace` level, each line passed to fn
+	 * - `{ level, log }` — both explicit
+	 *
+	 * Each line is `[zynor HH:MM:SS.mmm <LEVEL>] <scope>: <msg>`.
+	 *
+	 * @default false
+	 */
+	debug?: boolean | DebugLevel | DebugLogger | {
+		level?: DebugLevel;
+		log?: DebugLogger;
+	};
+	/**
+	 * @description This will enable deep validation of the email. slower than normal email validator as it triggers multiple dns requests, or travel to the ip address to get the domain name.
+	 * This is per request option, passing true to the getProvider without turning this ON, it wont work and vice versa.
+	 * @default false
+	 */
+	enableDeepValidation?: boolean;
+	/**
+	 * @description This will enable the ipResolver for the email validator on deep validation.
+	 * @default undefined
+	 */
+	ipResolver?: {
+		/**
+		 * @description Get your free api keys from https://findip.net to use find-api as a fallback for ipApi if enabled
+		 * @default undefined
+		 */
+		findip?: {
+			enabled: boolean;
+			apiKey: string[];
+		};
+		/**
+		 * @description This is 100% but might throagth that's why we have a fallback to findip.net
+		 * if you want to use this feature, change to true enable it
+		 * @default false
+		 */
+		ipApi?: boolean;
+		/**
+		 * @description This is 100% but might throagth that's why we have a fallback to findip.net
+		 * if you want to use this feature, change to true enable it
+		 * @default false
+		 */
+		ipWhoIs?: boolean;
+	};
+	deepValidationOptions?: {
+		/** Max total time (ms) for the entire deep validation phase. @default 3000 */
+		maxTimeout?: number;
+		http?: {
+			timeout?: number;
+			maxRetry?: number;
+		};
+	};
+}
+/**
+ * Minimal domain-level cache entry.
+ * Cheap fields (isFree, role, isDisposable) are recomputed on cache hit.
+ */
+export interface ValidateCacheEntry {
+	provider?: string;
+	status: "valid" | "Invalid" | "Syntax" | "Error" | "Rejected" | "Disposable";
+	message?: string;
+	webmail?: string;
+	/** Validation method — only set for Unknown/Others providers. */
+	method?: "shallow" | "deep";
+}
+declare class EmailValidator {
+	private findIpKeys;
+	private roles;
+	private records;
+	private yahooList;
+	private domain;
+	private static instance;
+	private dns;
+	private validateCache;
+	private ipCache;
+	private inflight;
+	private _logFn;
+	/** 0=silent, 1=info, 2=debug, 3=trace */
+	private _logLevel;
+	private validationConfig;
+	constructor(config?: {
+		options?: ValidationConfig;
+		dns?: Omit<ZynorConfig, "cache">;
+	});
+	/**
+	 * @internal Overridable factory for the internal DNS resolver. Base
+	 * implementation returns a libuv-backed {@link Zynor} (quad9 off,
+	 * cache off). The subclass exported from `'zynor/native'` overrides
+	 * this to return a hickory-Rust-backed Zynor instead, so users of
+	 * that subpath get the Rust DNS engine without any public config
+	 * knob.
+	 *
+	 * Called from the constructor; JS method dispatch goes through the
+	 * actual class of `this`, so subclass overrides fire correctly.
+	 */
+	protected createDns(config?: Omit<ZynorConfig, "cache">): Zynor;
+	/**
+	 * Creates or returns an existing instance of the EmailValidator (Singleton pattern)
+	 * @param config - Configuration object for the EmailValidator
+	 * @param config.options - Optional validation configuration settings
+	 * @param config.options.enableDeepValidation - Enable deep validation with additional DNS lookups
+	 * @param config.options.ipResolver - Configure IP resolution settings
+	 * @param config.options.ipResolver.findip - Settings for findip.net API
+	 * @param config.options.ipResolver.ipApi - Enable/disable ipApi service
+	 * @param config.options.ipResolver.ipWhoIs - Enable/disable ipWhoIs service
+	 * @param config.dns - Optional DNS configuration settings
+	 * @returns The singleton instance of EmailValidator
+	 * @example
+	 * // Create with default settings
+	 * const validator = EmailValidator.create();
+	 *
+	 * // Create with custom configuration
+	 * const validator = EmailValidator.create({
+	 *   options: {
+	 *     enableDeepValidation: true,
+	 *     ipResolver: {
+	 *       findip: {
+	 *         enabled: true,
+	 *         apiKey: ['your-api-key']
+	 *       }
+	 *     }
+	 *   }
+	 * });
+	 */
+	static create(config?: {
+		options?: ValidationConfig;
+		dns?: ZynorConfig;
+	}): EmailValidator;
+	private getMxRecords;
+	/**
+	 * Validates an email address and determines its provider/service
+	 * @param email - The email address to validate and analyze
+	 * @returns Promise resolving to EmailResponse containing validation status and provider details
+	 * @throws Error if email validation fails
+	 * @example
+	 * const validator = EmailValidator.create();
+	 * const result = await validator.validate("user@gmail.com");
+	 */
+	validate(email: string): Promise<EmailResponse>;
+	/**
+	 * Validates an email address with deep validation and determines its provider/service
+	 * @param email - The email address to validate and analyze
+	 * @param deep - Set to true to enable deep validation with additional DNS lookups
+	 * @returns Promise resolving to EmailResponse containing validation status and provider details
+	 * @throws Error if email validation fails
+	 * @remarks Deep validation performs additional DNS lookups and domain checks which may be slower
+	 * @example
+	 * const validator = EmailValidator.create();
+	 * const result = await validator.getProvider("user@company.com", true);
+	 */
+	validate(email: string, deep: true): Promise<EmailResponse>;
+	/**
+	 * Validates an email address with abort/timeout support and optional deep validation
+	 * @param email - The email address to validate and analyze
+	 * @param options - Options including signal, timeout, and optional deep flag
+	 * @returns Promise resolving to EmailResponse containing validation status and provider details
+	 * @example
+	 * const validator = EmailValidator.create();
+	 * const result = await validator.validate("user@company.com", { timeout: 5000 });
+	 * const result2 = await validator.validate("user@company.com", { timeout: 5000, deep: true });
+	 */
+	validate(email: string, options: AbortOptions & {
+		deep?: boolean;
+		logo?: boolean;
+	}): Promise<EmailResponse>;
+	/**
+	 * Emit a log line if its level is at or below the configured threshold.
+	 * Format: `[zynor HH:MM:SS.mmm <LVL>] <scope>: <msg>`. Zero formatting
+	 * cost when level is filtered out.
+	 *
+	 * Use the typed wrappers (`_info`/`_debug`/`_trace`) — they make every
+	 * call site self-document its expected verbosity.
+	 */
+	private _emit;
+	/** Top-level checkpoint (validate enter/exit, MX result, terminal outcome). */
+	private _info;
+	/** Sub-operation (cache hit/miss, network call start/end, sub-loop boundary). */
+	private _debug;
+	/** Fine-grained event (singleflight cleanup, per-iteration loop, early returns). */
+	private _trace;
+	/**
+	 * Belt-and-suspenders timeout for DNS calls. Races the underlying
+	 * operation against a `setTimeout`-based watchdog so a hung c-ares
+	 * query (or a broken AbortSignal propagation) cannot pin the inflight
+	 * Map indefinitely. The leaked DNS promise continues running in the
+	 * background — c-ares eventually abandons it on its own — but the
+	 * wrapper rejects on time and the inflight key is always cleared.
+	 *
+	 * Logged at INFO so the watchdog firing is visible at default
+	 * `debug: true`; the `WATCHDOG fired` line tells you which domain is
+	 * misbehaving.
+	 */
+	private _withWatchdog;
+	/**
+	 * Build a Valid response with `websiteTitle` and optional `loginUrl`
+	 * populated from the provider maps in ./provider-webmail.
+	 *
+	 * `webmail` (record-level override) and `loginUrl` (provider-level default)
+	 * coexist: both may be set, neither, or one. All optional fields use
+	 * conditional spread to satisfy `exactOptionalPropertyTypes`.
+	 */
+	private _buildValidResponse;
+	/**
+	 * Reconstruct full EmailResponse from a cache entry + cheap recomputed fields.
+	 */
+	private _buildResponse;
+	private _validateCore;
+	/**
+	 * Validates multiple email addresses in parallel.
+	 * Concurrency is derived from enabled DNS provider limits unless explicitly provided.
+	 * Results are returned in the same order as the input array.
+	 * Each validation is independent — one failure does not abort others.
+	 *
+	 * @param emails - Array of email addresses to validate
+	 * @param options - Optional bulk validation options
+	 * @param options.concurrency - Max parallel validations (defaults to DNS totalConcurrency)
+	 * @param options.deep - Enable deep validation for all emails
+	 * @param options.signal - AbortSignal to cancel the entire batch
+	 * @param options.timeout - Timeout in ms forwarded to each validation
+	 * @returns A promise resolving to an array of EmailResponse in the same order as input
+	 *
+	 * @example
+	 * ```typescript
+	 * const validator = EmailValidator.create();
+	 * const results = await validator.validateBulk(
+	 *   ['user@gmail.com', 'invalid@@', 'test@company.com'],
+	 *   { deep: true }
+	 * );
+	 * // results[0].success === true, results[1].success === false, ...
+	 * ```
+	 */
+	validateBulk(emails: string[], options?: {
+		concurrency?: number;
+		deep?: boolean;
+		logo?: boolean;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<EmailResponse[]>;
+	/**
+	 * Streams validation results as they complete, in completion order.
+	 *
+	 * Unlike {@link validateBulk}, which waits for every input before returning,
+	 * `each` invokes `onBatch` as soon as enough results have accumulated
+	 * (`returnBatch`, default 10) and continues until every input has been
+	 * processed. Designed for very large inputs (millions) where time-to-first
+	 * result matters and holding the entire result array in memory is wasteful.
+	 *
+	 * Concurrency is controlled here, not by the DNS layer: every validation
+	 * routes through the validator-internal direct path, which bypasses the
+	 * per-provider PQueue and rate limiter. DoH providers are load-balanced
+	 * round-robin per validation.
+	 *
+	 * Backpressure: `onBatch` is awaited serially. If the callback is slow and
+	 * the in-memory buffer reaches `10 * returnBatch`, workers pause picking
+	 * new emails until the buffer drains below the cap. This keeps memory
+	 * bounded for truly large inputs.
+	 *
+	 * Errors:
+	 * - Per-email errors become error-shaped {@link EmailResponse} entries in
+	 *   the stream — they never abort the batch.
+	 * - An error thrown by `onBatch` aborts production: workers stop picking
+	 *   new emails, in-flight work is awaited, and the returned promise
+	 *   rejects with the first such error.
+	 *
+	 * Abort: when the supplied `signal` fires, workers stop picking new
+	 * emails, in-flight validations finish, the buffer is flushed via
+	 * `onBatch`, and the returned promise resolves cleanly.
+	 *
+	 * @param emails - The list of email addresses to validate
+	 * @param options - Streaming options
+	 * @param options.concurrency - Max parallel validations (default 500)
+	 * @param options.returnBatch - Min results buffered before invoking onBatch (default 10)
+	 * @param options.deep - Enable deep validation per email
+	 * @param options.logo - Fetch provider logo per email
+	 * @param options.signal - AbortSignal to cancel the batch
+	 * @param options.timeout - Per-validation timeout in ms
+	 * @param onBatch - Invoked with each completed batch; may return a Promise
+	 * @returns Resolves once every input has been processed and flushed
+	 *
+	 * @example
+	 * ```typescript
+	 * await validator.each(
+	 *   emails, // could be millions
+	 *   { concurrency: 500, returnBatch: 50, deep: true },
+	 *   async (batch) => {
+	 *     await db.insertMany(batch);
+	 *   },
+	 * );
+	 * ```
+	 */
+	each(emails: string[], options: {
+		concurrency?: number;
+		returnBatch?: number;
+		deep?: boolean;
+		logo?: boolean;
+		signal?: AbortSignal;
+		timeout?: number;
+	} | undefined, onBatch: (batch: EmailResponse[]) => void | Promise<void>): Promise<void>;
+	private is_wale4r_zimbra;
+	private is_zimbra;
+	private is_webmail;
+	private is_owa;
+	private is_cPanel;
+	private toToken;
+	private parseJSCpanel;
+	private is_Roundcube;
+	private probeUrl;
+	protected domain_check(email?: string, direct?: boolean, _pattern?: number, abortOptions?: AbortOptions): Promise<{
+		status: boolean;
+		type: string;
+		webmail?: string;
+	}>;
+	private resolveA;
+	private getIpCache;
+	private dnsLookup;
+	private returnDNS;
+	protected ipApi(ip: string, abortOptions?: AbortOptions): Promise<[
+		string,
+		string
+	] | null>;
+	protected ipWhoIs(ip: string, abortOptions?: AbortOptions): Promise<[
+		string,
+		string
+	] | null>;
+	protected findIp(ip: string, abortOptions?: AbortOptions): Promise<[
+		string,
+		string
+	] | null>;
+	/**
+	 * Checks if the given string is a valid email address according to advanced validation rules.
+	 *
+	 * This function performs a multi-step validation of an email address. It first checks the general format,
+	 * then splits the address into local and domain parts, and applies several constraints:
+	 * - Local part must be at least 2 characters, domain part at least 5 characters.
+	 * - Local part cannot exceed certain length and may not contain too many hyphens or dots.
+	 * - Domain part may not contain too many dots or hyphens.
+	 * - Validates extension via this.domain.isDomainExtension.
+	 * - Total email length cannot be excessive.
+	 *
+	 * Validation rules:
+	 * - Maximum 35 characters for the local part
+	 * - Maximum 3 hyphens in the local part
+	 * - Maximum 3 dots in the local part
+	 * - Maximum 3 dots in the domain part
+	 * - Maximum 2 hyphens in the domain part
+	 * - Maximum 55 total characters in the email address
+	 * - Local part >= 2 chars; domain part >= 5 chars
+	 *
+	 * @param {string} email - The email address to validate.
+	 * @returns {boolean} True if the email passes all format and structural constraints, false otherwise.
+	 *
+	 * @example
+	 *   validator.isEmail("john.doe@example.com"); // true
+	 *   validator.isEmail("x@y.com"); // false (domain part < 5 chars)
+	 *   validator.isEmail("toolong--name----more@long-domain-hyphen---.com"); // false
+	 */
+	isEmail(email: string): boolean;
+	/**
+	 * Checks if the given email or domain name belongs to a free (public/free-to-register) email provider.
+	 *
+	 * - If an email address is provided, this method extracts the domain part.
+	 * - If a domain is provided directly, it is checked as-is.
+	 * - Returns `true` if the domain is recognized as a free provider (such as Gmail, Yahoo, Outlook, etc.), otherwise `false`.
+	 *
+	 * @param {string} email_or_domain - The email address (e.g. "user@gmail.com") or domain name (e.g. "gmail.com") to check.
+	 * @returns {boolean} `true` if the domain is a known free email provider, `false` otherwise.
+	 *
+	 * @example
+	 *   validator.isFreeDomain('person@yahoo.com'); // returns true
+	 *   validator.isFreeDomain('gmail.com'); // returns true
+	 *   validator.isFreeDomain('user@private-company.org'); // returns false
+	 *   validator.isFreeDomain('private-company.org'); // returns false
+	 */
+	isFreeDomain(email_or_domain: string): boolean;
+	/**
+	 * Checks if the given email address is disposable.
+	 *
+	 * This method determines whether the provided email address is from a known disposable email provider.
+	 * Disposable email addresses are typically used for temporary or throwaway purposes, and are often associated
+	 * with domains that provide temporary inboxes.
+	 *
+	 * - Returns `true` if the email is found to be disposable using the internal provider list.
+	 * - Returns `false` for any non-disposable addresses, invalid addresses, or if the email is not recognized.
+	 *
+	 * @param {string} email - The email address to check for disposability (e.g., "user@mailinator.com").
+	 * @returns {boolean} `true` if the email is disposable, otherwise `false`.
+	 *
+	 * @example
+	 *   validator.isDisposable('test@mailinator.com'); // returns true
+	 *   validator.isDisposable('john.doe@gmail.com');  // returns false
+	 *
+	 * @see {@link https://github.com/yourrepo/zynor#email-validation}
+	 */
+	isDisposable(email: string): boolean;
+	/**
+	 * Detects the mail server / webmail provider for a domain by probing common webmail URLs.
+	 * This is the deep validation `domain_check` logic exposed as a standalone public method.
+	 *
+	 * @param domain - The domain name to check (e.g. "example.com")
+	 * @param abortOptions - Optional signal/timeout to cancel the operation
+	 * @returns An object with `status`, `type` (provider name), and optional `webmail` URL
+	 *
+	 * @example
+	 * const result = await validator.detectMailProvider('company.com');
+	 * // { status: true, type: 'Zimbra', webmail: 'https://mail.company.com' }
+	 *
+	 * @example
+	 * const result = await validator.detectMailProvider('unknown.io', { timeout: 2000 });
+	 * // { status: false, type: '' }
+	 */
+	detectMailProvider(domain: string, abortOptions?: AbortOptions): Promise<{
+		status: boolean;
+		type: string;
+		webmail?: string;
+	}>;
+	/**
+	 * Detects the hosting provider for a domain by resolving its A records and looking up IP info.
+	 * Identifies providers like AWS, Microsoft, DigitalOcean, Oracle, IBM, Alibaba, and Aruba.
+	 *
+	 * Works independently of `enableDeepValidation`. Only requires `ipResolver` config:
+	 * - `ipResolver.ipApi: true` for ip-api.com lookups
+	 * - `ipResolver.findip: { enabled: true, apiKey: [...] }` for findip.net fallback
+	 *
+	 * @param domain - The domain name to check (e.g. "mail.example.com")
+	 * @param abortOptions - Optional signal/timeout to cancel the operation
+	 * @returns An object with `status` and `type` (hosting provider name)
+	 *
+	 * @example
+	 * const validator = EmailValidator.create({
+	 *   options: { ipResolver: { ipApi: true } }
+	 * });
+	 * const result = await validator.detectHostingProvider('mail.company.com');
+	 * // { status: true, type: 'AWS Partner' }
+	 */
+	detectHostingProvider(domain: string, abortOptions?: AbortOptions): Promise<{
+		status: boolean;
+		type: string;
+		webmail?: string;
+	}>;
+	private is_email;
+	private isDomainOrUrl;
+	/**
+	 * Checks if the input string is a valid JSON array of strings, where each string is a valid email address.
+	 *
+	 * - Attempts to parse the input string as JSON.
+	 * - Ensures the parsed value is an array of non-empty strings.
+	 * - Each element is also checked (using this.isEmail) to confirm it is a valid email address.
+	 * - If all conditions are met and the array has at least one valid email, returns the array.
+	 * - Otherwise, returns null.
+	 *
+	 * @param {string} input - The input string to validate.
+	 * @returns {string[] | null} The parsed array of valid email addresses if all conditions are met, otherwise null.
+	 *
+	 * @example
+	 *   validator.isJson('["hello@site.com", "test@a.io"]'); // returns ["hello@site.com", "test@a.io"]
+	 *   validator.isJson('["foo", 1, null]'); // returns null
+	 *   validator.isJson('not json'); // returns null
+	 *   validator.isJson('[]'); // returns null
+	 */
+	isJson(input: string): string[] | null;
+	/**
+	 * Extracts and returns an array of valid email addresses from various input formats.
+	 *
+	 * This method processes input strings that may contain:
+	 * - Plain email addresses
+	 * - Comma-separated email addresses
+	 * - URL-encoded strings (automatically decoded)
+	 * - JSON arrays containing email addresses
+	 *
+	 * The function will:
+	 * 1. URL-decode each input string
+	 * 2. Split comma-separated values
+	 * 3. Validate each token as an email address
+	 * 4. Parse JSON arrays and extract valid emails from them
+	 * 5. Return a flat array of all valid email addresses found
+	 *
+	 * Note: Domain/URL detection is currently disabled (commented out in the implementation).
+	 * Only valid email addresses are included in the result.
+	 *
+	 * @param {string[]} input - An array of strings that may contain email addresses in various formats.
+	 *                           Each string can be:
+	 *                           - A single email address
+	 *                           - Comma-separated email addresses
+	 *                           - URL-encoded email addresses
+	 *                           - A JSON array string containing email addresses
+	 *                           - Any combination of the above
+	 *
+	 * @returns {string[]} An array of valid email addresses extracted from the input.
+	 *                     Duplicate emails may be present if they appear multiple times in the input.
+	 *                     Returns an empty array if no valid emails are found.
+	 *
+	 * @example
+	 * // Single email
+	 * validator.extractEmailsFromArray(["user@example.com"]);
+	 * // Returns: ["user@example.com"]
+	 *
+	 * @example
+	 * // Comma-separated emails
+	 * validator.extractEmailsFromArray(["user1@example.com,user2@example.com"]);
+	 * // Returns: ["user1@example.com", "user2@example.com"]
+	 *
+	 * @example
+	 * // URL-encoded and comma-separated
+	 * validator.extractEmailsFromArray(["user%40example.com,test%40domain.com"]);
+	 * // Returns: ["user@example.com", "test@domain.com"]
+	 *
+	 * @example
+	 * // JSON array of emails
+	 * validator.extractEmailsFromArray(['["email1@test.com", "email2@test.com"]']);
+	 * // Returns: ["email1@test.com", "email2@test.com"]
+	 *
+	 * @example
+	 * // Mixed formats
+	 * validator.extractEmailsFromArray([
+	 *   "user@example.com",
+	 *   "test@domain.com,admin@site.com",
+	 *   '["json@email.com"]'
+	 * ]);
+	 * // Returns: ["user@example.com", "test@domain.com", "admin@site.com", "json@email.com"]
+	 *
+	 * @example
+	 * // Invalid emails are filtered out
+	 * validator.extractEmailsFromArray(["valid@example.com", "invalid-email", "another@valid.com"]);
+	 * // Returns: ["valid@example.com", "another@valid.com"]
+	 */
+	extractEmailsFromArray(input: string[]): string[];
+	/**
+	 * Retrieves the webmail URL for a given email provider or domain/email address.
+	 *
+	 * This method returns the webmail login URL for known email providers (e.g., Gmail, Yahoo, Outlook).
+	 * It supports multiple calling patterns:
+	 * - By provider name only (returns the standard webmail URL for that provider)
+	 * - By provider name with domain/email (for providers that may have custom domains)
+	 * - By domain/email address directly (automatically detects if the string is a domain or email)
+	 *
+	 * The method first checks if the provider has a known webmail URL in the internal provider list.
+	 * If not found and a domain/email is provided, it attempts to resolve the webmail URL from the domain.
+	 *
+	 * Supported providers include major global providers (Gmail, Yahoo, Outlook, etc.), regional providers,
+	 * business/enterprise providers, and many others. See the provider list for complete coverage.
+	 *
+	 * @overload
+	 * @param {EmailProviderName} provider - The name of the email provider (e.g., "Gmail", "Yahoo", "Outlook").
+	 * @returns {string | null} The webmail URL for the provider, or `null` if not found.
+	 *
+	 * @overload
+	 * @param {EmailProviderName} provider - The name of the email provider.
+	 * @param {string} domainOrEmail - A domain name (e.g., "example.com") or email address (e.g., "user@example.com").
+	 *                                 Used as a fallback if the provider name doesn't have a direct URL mapping.
+	 * @returns {string | null} The webmail URL for the provider/domain, or `null` if not found.
+	 *
+	 * @overload
+	 * @param {string} domainOrEmail - A domain name (e.g., "gmail.com") or email address (e.g., "user@gmail.com").
+	 *                                 The method automatically detects if this is a domain or email by checking for "@" or ".".
+	 * @returns {string | null} The webmail URL for the domain, or `null` if not found.
+	 *
+	 * @example
+	 * // Get webmail URL by provider name
+	 * validator.getProviderWebmailUrl("Gmail");
+	 * // Returns: "https://mail.google.com"
+	 *
+	 * @example
+	 * // Get webmail URL by provider name with domain
+	 * validator.getProviderWebmailUrl("Yahoo", "yahoo.com");
+	 * // Returns: "https://mail.yahoo.com"
+	 *
+	 * @example
+	 * // Get webmail URL by email address (auto-detects domain)
+	 * validator.getProviderWebmailUrl("user@gmail.com");
+	 * // Returns: "https://mail.google.com"
+	 *
+	 * @example
+	 * // Get webmail URL by domain name
+	 * validator.getProviderWebmailUrl("outlook.com");
+	 * // Returns: "https://outlook.live.com"
+	 *
+	 * @example
+	 * // Unknown provider returns null
+	 * validator.getProviderWebmailUrl("UnknownProvider");
+	 * // Returns: null
+	 *
+	 * @example
+	 * // Provider with domain fallback
+	 * validator.getProviderWebmailUrl("CustomProvider", "customdomain.com");
+	 * // May return a URL if the domain is recognized as a free provider
+	 */
+	getProviderWebmailUrl(provider: EmailProviderName): string | null;
+	getProviderWebmailUrl(provider: EmailProviderName, domainOrEmail: string): string | null;
+	getProviderWebmailUrl(domainOrEmail: string): string | null;
+	/**
+	 * Extract and validate email addresses from mixed HTML or plain-text content.
+	 *
+	 * The method:
+	 * 1. Sanitizes the input by stripping HTML tags and removing non-essential punctuation.
+	 * 2. Applies a robust regular-expression pattern to locate candidate email strings.
+	 * 3. Validates each candidate against the full RFC-style rules implemented in {@link isEmail}.
+	 * 4. De-duplicates the final list while preserving the original order of first appearance.
+	 *
+	 * @param content - Arbitrary HTML or plain-text that may contain zero or more email addresses.
+	 * @returns An array of unique, syntactically valid email addresses discovered in the supplied content.
+	 *          Returns an empty array when no valid emails are found.
+	 *
+	 * @example
+	 * // Plain text
+	 * validator.extractEmails('Contact us at support@example.com or sales@example.com');
+	 * // → ['support@example.com', 'sales@example.com']
+	 *
+	 * @example
+	 * // HTML fragment
+	 * validator.extractEmails('<a href="mailto:info@site.org">Info</a> <span>admin@site.org</span>');
+	 * // → ['info@site.org', 'admin@site.org']
+	 *
+	 * @example
+	 * // Duplicates are removed
+	 * validator.extractEmails('user@demo.io, User@demo.io, USER@DEMO.IO');
+	 * // → ['user@demo.io']
+	 */
+	extractEmails(content: string): string[];
+}
+export interface Valid {
+	success: true;
+	data: {
+		provider: EmailProviderName;
+		isFree: boolean;
+		email: string;
+		role: boolean;
+		websiteTitle: string;
+		webmail?: string;
+		loginUrl?: string;
+		logo?: string;
+	};
+}
+export interface Invalid {
+	success: false;
+	type: "Invalid";
+	email: string;
+	role: boolean;
+}
+export interface EmailDisposable {
+	success: false;
+	type: "Disposable";
+	email: string;
+	role: boolean;
+}
+export interface Rejected {
+	success: false;
+	type: "Rejected";
+	email: string;
+	role: boolean;
+}
+export interface Syntax {
+	success: false;
+	type: "Syntax";
+	email: string;
+	role: boolean;
+}
+export interface EmailError {
+	success: false;
+	type: "Error";
+	email: string;
+	message: string;
+	role: boolean;
+}
+export type EmailResponse = Valid | Invalid | Rejected | Syntax | EmailError | EmailDisposable;
+export interface RustResolveOptions {
+	/** Hard deadline in milliseconds. Rust task self-cancels at the
+	 *  boundary; prevents orphan tasks if the JS caller's watchdog gives
+	 *  up first. `| undefined` is explicit so callers can spread
+	 *  `{ timeoutMs: options?.timeout }` under exactOptionalPropertyTypes. */
+	timeoutMs?: number | undefined;
+}
+export interface RustMxRecord {
+	exchange: string;
+	priority: number;
+}
+export interface RustSrvRecord {
+	priority: number;
+	weight: number;
+	port: number;
+	name: string;
+}
+export interface RustSoaRecord {
+	nsname: string;
+	hostmaster: string;
+	serial: number;
+	refresh: number;
+	retry: number;
+	expire: number;
+	minttl: number;
+}
+export interface RustCaaRecord {
+	/** 128 when issuer-critical bit set, 0 otherwise (mirrors libuv). */
+	critical: number;
+	issue?: string;
+	issuewild?: string;
+	iodef?: string;
+}
+export interface RustNaptrRecord {
+	order: number;
+	preference: number;
+	flags: string;
+	service: string;
+	regexp: string;
+	replacement: string;
+}
+/** TLSA. Note: field is `matching` (not `match`); the validator-side
+ *  adapter renames if needed for the public TS type. */
+export interface RustTlsaRecord {
+	certUsage: number;
+	selector: number;
+	matching: number;
+	data: Uint8Array;
+}
+/** Generic envelope for `resolveAny`. Different shape from node:dns's
+ *  tagged union — `kind` is the record-type name ("A", "MX", …) and
+ *  `data` is hickory's textual rendering. The validator's hot path
+ *  doesn't use ANY, so divergence is acceptable. */
+export interface RustAnyRecord {
+	kind: string;
+	data: string;
+	ttl: number;
+}
+export interface RustBinding {
+	resolveMx(hostname: string, options?: RustResolveOptions | null): Promise<RustMxRecord[]>;
+	resolveA(hostname: string, options?: RustResolveOptions | null): Promise<string[]>;
+	resolveAaaa(hostname: string, options?: RustResolveOptions | null): Promise<string[]>;
+	resolveCname(hostname: string, options?: RustResolveOptions | null): Promise<string[]>;
+	resolveTxt(hostname: string, options?: RustResolveOptions | null): Promise<string[][]>;
+	resolveNs(hostname: string, options?: RustResolveOptions | null): Promise<string[]>;
+	resolvePtr(hostname: string, options?: RustResolveOptions | null): Promise<string[]>;
+	resolveSrv(hostname: string, options?: RustResolveOptions | null): Promise<RustSrvRecord[]>;
+	resolveSoa(hostname: string, options?: RustResolveOptions | null): Promise<RustSoaRecord | null>;
+	resolveCaa(hostname: string, options?: RustResolveOptions | null): Promise<RustCaaRecord[]>;
+	resolveNaptr(hostname: string, options?: RustResolveOptions | null): Promise<RustNaptrRecord[]>;
+	resolveTlsa(hostname: string, options?: RustResolveOptions | null): Promise<RustTlsaRecord[]>;
+	resolveAny(hostname: string, options?: RustResolveOptions | null): Promise<RustAnyRecord[]>;
+	reverseLookup(ip: string, options?: RustResolveOptions | null): Promise<string[]>;
+	buildInfo?(): string;
+}
+declare class Zynor {
+	private providers;
+	private static __emailValidator;
+	private dnsCache;
+	private dnsTtl;
+	private inflight;
+	private rrIndex;
+	protected rust: RustBinding | null;
+	private dnsInFlight;
+	/** Epoch-ms until which a DoH provider is considered failing and excluded
+	 *  from {@link pickFreestProvider}. Native is never paused — libuv errors
+	 *  are local concerns, not upstream-health signals. */
+	private dohPausedUntil;
+	/** Consecutive-failure counters per provider; reset on any success. We only
+	 *  pause once a provider's streak exceeds {@link DOH_PAUSE_AFTER}, so single
+	 *  transient errors don't cascade-pause healthy providers under high load. */
+	private dohFailureStreak;
+	private static readonly DOH_PAUSE_MS;
+	private static readonly DOH_PAUSE_AFTER;
+	/** Native's reported `concurrency` (default 50) is the PQueue limit, which
+	 *  the validator path bypasses anyway. The *real* parallel ceiling is
+	 *  libuv's getaddrinfo thread pool — defaults to 4 unless UV_THREADPOOL_SIZE
+	 *  is set. {@link pickFreestProvider} uses this to weight native correctly
+	 *  in load balancing instead of dumping 60%+ of traffic on libuv. */
+	private static readonly NATIVE_EFFECTIVE_CONCURRENCY;
+	/**
+	 * Creates a new Zynor resolver instance.
+	 * @param config - Configuration for all providers
+	 * @example
+	 * ```typescript
+	 * const dns = new Zynor({
+	 *   google: { enabled: true, limit: { concurrency: 10 } },
+	 *   cloudflare: { enabled: false }
+	 * });
+	 * ```
+	 */
+	constructor(config?: ZynorConfig);
+	private cachedResolve;
+	/**
+	 * Creates or returns a singleton instance of EmailValidator.
+	 * If an instance already exists, returns the existing instance.
+	 * If no instance exists, creates a new one with the provided configuration.
+	 *
+	 * @param config - Configuration object for the EmailValidator
+	 * @param config.options - Optional validation configuration settings
+	 * @param config.options.allowIPv6 - Whether to allow IPv6 addresses in email domains
+	 * @param config.options.allowInternational - Whether to allow international email addresses
+	 * @param config.options.checkDNS - Whether to perform DNS lookups during validation
+	 * @param config.dns - Optional DNS configuration for the validator's DNS resolver
+	 * @returns An EmailValidator instance
+	 *
+	 * @example
+	 * ```typescript
+	 * // Create with default configuration
+	 * const validator = Zynor.createEmailValidator();
+	 *
+	 * // Create with custom configuration
+	 * const validator = Zynor.createEmailValidator({
+	 *   options: {
+	 *     allowIPv6: true,
+	 *     checkDNS: true
+	 *   },
+	 *   dns: {
+	 *     google: { enabled: true }
+	 *   }
+	 * });
+	 * ```
+	 */
+	static createEmailValidator(config?: {
+		options?: ValidationConfig;
+		dns?: ZynorConfig;
+	}): EmailValidator;
+	static get emailValidator(): EmailValidator;
+	/**
+	 * Initializes all DNS providers with their configurations.
+	 */
+	private initializeProviders;
+	/**
+	 * @internal Overridable factory for the `native` provider. Base
+	 * implementation returns a libuv-backed NativeProvider. The subclass
+	 * exported from `'zynor/native'` overrides this to inject `useRust: true`
+	 * so importers of that subpath get the hickory-dns binding.
+	 *
+	 * Called from {@link initializeProviders} during construction. JS method
+	 * dispatch resolves through the *actual* class of `this`, so subclass
+	 * overrides fire correctly even though the call site is in the base
+	 * constructor's code path.
+	 */
+	protected createNativeProvider(config?: ProviderConfig): NativeProvider;
+	/**
+	 * Sets configuration for a specific provider.
+	 * @param provider - The provider name
+	 * @param config - The provider configuration
+	 * @throws {InvalidProviderError} If the provider name is invalid
+	 * @example
+	 * ```typescript
+	 * dns.setConfig('google', { enabled: true, limit: { concurrency: 15 } });
+	 * ```
+	 */
+	setConfig(provider: string, config: ProviderConfig): void;
+	/**
+	 * Sets configurations for all providers.
+	 * @param config - Configuration object for all providers
+	 * @example
+	 * ```typescript
+	 * dns.setConfigs({
+	 *   native: { enabled: true },
+	 *   google: { enabled: true, limit: { concurrency: 10 } },
+	 *   cloudflare: { enabled: false },
+	 *   quad9: { enabled: true }
+	 * });
+	 * ```
+	 */
+	setConfigs(config: ZynorConfig): void;
+	/**
+	 * Validates if a provider name is valid.
+	 */
+	private isValidProvider;
+	/**
+	 * Validates hostname format.
+	 */
+	private validateHostname;
+	/**
+	 * Gets all enabled providers.
+	 */
+	private getEnabledProviders;
+	/**
+	 * Selects a random enabled provider, preferring non-full queues.
+	 */
+	private selectProvider;
+	private rnd;
+	/**
+	 * Parses the second argument which can be either AbortOptions or a provider string.
+	 */
+	private parseArgs;
+	/**
+	 * Gets a provider instance by name.
+	 */
+	private getProvider;
+	/**
+	 * Resolves A records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param options - Optional resolution options
+	 * @param provider - Optional specific provider to use (e.g., 'google', 'cloudflare')
+	 * @returns A promise resolving to an array of IPv4 addresses or records with TTL
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 * @example
+	 * ```typescript
+	 * const addresses = await dns.resolve4('example.com');
+	 * console.log(addresses); // ['93.184.216.34']
+	 *
+	 * const withTtl = await dns.resolve4('example.com', { ttl: true });
+	 * console.log(withTtl); // [{ address: '93.184.216.34', ttl: 300 }]
+	 * ```
+	 */
+	resolve4: IResolver["resolve4"];
+	/**
+	 * Resolves AAAA records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param options - Optional resolution options
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of IPv6 addresses or records with TTL
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 * @example
+	 * ```typescript
+	 * const addresses = await dns.resolve6('example.com');
+	 * console.log(addresses); // ['2606:2800:220:1:248:1893:25c8:1946']
+	 * ```
+	 */
+	resolve6: IResolver["resolve6"];
+	/**
+	 * Resolves ANY records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of any DNS records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 * @example
+	 * ```typescript
+	 * const records = await dns.resolveAny('example.com');
+	 * console.log(records); // [{ type: 'A', address: '93.184.216.34' }, ...]
+	 * ```
+	 */
+	resolveAny: IResolver["resolveAny"];
+	/**
+	 * Resolves CAA records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of CAA records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolveCaa: IResolver["resolveCaa"];
+	/**
+	 * Resolves CNAME records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of CNAME records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolveCname: IResolver["resolveCname"];
+	/**
+	 * Resolves MX records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of MX records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 * @example
+	 * ```typescript
+	 * const mxRecords = await dns.resolveMx('example.com');
+	 * console.log(mxRecords); // [{ priority: 10, exchange: 'mail.example.com' }]
+	 * ```
+	 */
+	resolveMx: IResolver["resolveMx"];
+	/**
+	 * Resolves NAPTR records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of NAPTR records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolveNaptr: IResolver["resolveNaptr"];
+	/**
+	 * Resolves NS records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of NS records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolveNs: IResolver["resolveNs"];
+	/**
+	 * Resolves PTR records for an IP address.
+	 * @param ip - The IP address to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of PTR records
+	 * @throws {InvalidHostnameError} If the IP address is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolvePtr: IResolver["resolvePtr"];
+	/**
+	 * Resolves SOA record for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to the SOA record
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolveSoa: IResolver["resolveSoa"];
+	/**
+	 * Resolves SRV records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of SRV records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolveSrv: IResolver["resolveSrv"];
+	/**
+	 * Resolves TLSA records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of TLSA records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 */
+	resolveTlsa: IResolver["resolveTlsa"];
+	/**
+	 * Resolves TXT records for a hostname.
+	 * @param hostname - The hostname to resolve
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of TXT records
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 * @example
+	 * ```typescript
+	 * const txtRecords = await dns.resolveTxt('example.com');
+	 * console.log(txtRecords); // [['v=spf1 include:_spf.example.com ~all']]
+	 * ```
+	 */
+	resolveTxt: IResolver["resolveTxt"];
+	/**
+	 * Performs reverse DNS lookup for an IP address.
+	 * @param ip - The IP address to reverse lookup
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to an array of hostnames
+	 * @throws {InvalidHostnameError} If the IP address is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 * @example
+	 * ```typescript
+	 * const hostnames = await dns.reverse('8.8.8.8');
+	 * console.log(hostnames); // ['dns.google.']
+	 * ```
+	 */
+	reverse: IResolver["reverse"];
+	/**
+	 * Generic resolve method that delegates to specific resolve methods.
+	 * @param hostname - The hostname to resolve
+	 * @param rrtype - The DNS record type
+	 * @param provider - Optional specific provider to use
+	 * @returns A promise resolving to DNS records of the specified type
+	 * @throws {InvalidHostnameError} If the hostname is invalid
+	 * @throws {NoEnabledProvidersError} If no providers are enabled
+	 * @example
+	 * ```typescript
+	 * const aRecords = await dns.resolve('example.com', 'A');
+	 * const mxRecords = await dns.resolve('example.com', 'MX');
+	 * ```
+	 */
+	resolve: IResolver["resolve"];
+	/**
+	 * @internal Validator-only. Picks the enabled provider with the lowest
+	 * load ratio (`inFlight / effectiveCapacity`), which yields a distribution
+	 * proportional to each provider's capacity even when total in-flight far
+	 * exceeds total capacity. A simple slack-based picker over-saturates
+	 * everyone equally above their cap and effectively ignores weights; the
+	 * ratio formulation keeps weights honest at any load level.
+	 *
+	 * Native is included but its effective cap is clamped to libuv's
+	 * getaddrinfo pool ({@link NATIVE_EFFECTIVE_CONCURRENCY}, defaults to
+	 * UV_THREADPOOL_SIZE or 4) — otherwise the validator would dump 50+ in-
+	 * flight lookups onto a 4-thread pool. Paused DoH providers are excluded;
+	 * if every enabled provider is paused, the filter is dropped.
+	 *
+	 * RR breaks ties so even loads spread.
+	 */
+	private pickFreestProvider;
+	/**
+	 * Distinguishes "this provider is broken/slow" from cases that don't
+	 * indicate provider health:
+	 *  - DNS-level no-such-name answers (ENOTFOUND/NODATA): authoritative,
+	 *    not the provider's fault.
+	 *  - AbortError: caller-initiated cancellation or per-call timeout.
+	 *    A user's tight deadline shouldn't make us blacklist a healthy provider.
+	 */
+	private isProviderFailure;
+	/**
+	 * @internal Validator-only. Direct DNS path that bypasses the per-provider
+	 * PQueue and rate limiter while keeping LRU cache + singleflight. Provider
+	 * is chosen by least-loaded-first (the validator does not need to know or
+	 * pick); the in-flight counter is incremented inside the singleflight
+	 * closure so coalesced waiters don't overcount upstream load. Public
+	 * consumers must continue to use the queued resolve* methods.
+	 */
+	_resolveDirect<T>(hostname: string, type: RecordType, options?: AbortOptions): Promise<T>;
+	/**
+	 * Returns the sum of concurrency limits across all enabled DNS providers.
+	 * Used by `validateBulk` to determine default parallelism.
+	 * @example
+	 * ```typescript
+	 * const dns = new Zynor({ google: { enabled: true }, cloudflare: { enabled: true } });
+	 * console.log(dns.totalConcurrency); // 20 (10 + 10)
+	 * ```
+	 */
+	get totalConcurrency(): number;
+	/**
+	 * Validates multiple email addresses in parallel using the email validator.
+	 * Concurrency is derived from enabled DNS provider limits unless explicitly provided.
+	 * @param emails - Array of email addresses to validate
+	 * @param options - Optional bulk validation options
+	 * @returns A promise resolving to an array of EmailResponse in the same order as input
+	 * @example
+	 * ```typescript
+	 * const results = await Zynor.validateBulk(['user@gmail.com', 'test@example.com']);
+	 * console.log(results); // [{ success: true, data: { provider: 'Google', ... } }, ...]
+	 * ```
+	 */
+	static validateBulk(emails: string[], options?: {
+		concurrency?: number;
+		deep?: boolean;
+		logo?: boolean;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<EmailResponse[]>;
+	/**
+	 * Streams validation results as they complete. Forwards to
+	 * {@link EmailValidator.each} on the singleton validator. See `each` for
+	 * full semantics — defaults are `concurrency: 500`, `returnBatch: 10`, and
+	 * all validator-routed DNS calls bypass the per-provider queue.
+	 *
+	 * @param emails - The list of email addresses to validate
+	 * @param options - Streaming options (concurrency, returnBatch, deep, etc.)
+	 * @param onBatch - Callback invoked with each completed batch
+	 * @returns Resolves once every input has been processed and flushed
+	 *
+	 * @example
+	 * ```typescript
+	 * await Zynor.each(emails, { returnBatch: 50 }, async (batch) => {
+	 *   await db.insertMany(batch);
+	 * });
+	 * ```
+	 */
+	static each(emails: string[], options: {
+		concurrency?: number;
+		returnBatch?: number;
+		deep?: boolean;
+		logo?: boolean;
+		signal?: AbortSignal;
+		timeout?: number;
+	} | undefined, onBatch: Parameters<EmailValidator["each"]>[2]): Promise<void>;
+}
+/**
+ * Identical to {@link BaseZynor} except the `native` provider routes
+ * through the hickory-dns Rust binding. Overrides {@link BaseZynor.createNativeProvider}.
+ */
+declare class Zynor$1 extends Zynor {
+	constructor(config?: ZynorConfig);
+}
+/**
+ * Identical to {@link BaseEmailValidator} except the internal DNS
+ * resolver is a {@link Zynor} — every DNS call zynor makes during
+ * validation routes through the Rust binding.
+ */
+declare class NativeEmailValidator extends EmailValidator {
+	protected createDns(config?: Omit<ZynorConfig, "cache">): Zynor$1;
+}
+export declare const resetDefaultResolver: () => void;
+export declare const setDefaultResolver: (resolver: Zynor$1) => void;
+export declare const resolve4: IResolver["resolve4"];
+export declare const resolve6: IResolver["resolve6"];
+export declare const resolveAny: IResolver["resolveAny"];
+export declare const resolveCaa: IResolver["resolveCaa"];
+export declare const resolveCname: IResolver["resolveCname"];
+export declare const resolveMx: IResolver["resolveMx"];
+export declare const resolveNaptr: IResolver["resolveNaptr"];
+export declare const resolveNs: IResolver["resolveNs"];
+export declare const resolvePtr: IResolver["resolvePtr"];
+export declare const resolveSoa: IResolver["resolveSoa"];
+export declare const resolveSrv: IResolver["resolveSrv"];
+export declare const resolveTlsa: IResolver["resolveTlsa"];
+export declare const resolveTxt: IResolver["resolveTxt"];
+export declare const reverse: IResolver["reverse"];
+export declare const resolve: IResolver["resolve"];
+
+export {
+	CaaRecord,
+	MxRecord,
+	NaptrRecord,
+	NativeEmailValidator as EmailValidator,
+	RecordWithTtl,
+	ResolveOptions,
+	ResolveWithTtlOptions,
+	SoaRecord,
+	SrvRecord,
+	TlsaRecord,
+	Zynor$1 as Zynor,
+	Zynor$1 as default,
+};
+
+export {};