zynor 0.0.44

package/dist/index.d.ts

@@ -0,0 +1,3078 @@
+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: 1000 */
+	maxSize?: number;
+	/** DNS result TTL in ms. Default: 300_000 (5 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 const EmailProviders: readonly [
+	{
+		readonly name: "Gmail";
+		readonly domains: readonly [
+			"@gmail.com",
+			"@googlemail.com"
+		];
+	},
+	{
+		readonly name: "Outlook";
+		readonly domains: readonly [
+			"@outlook.com",
+			"@hotmail.com",
+			"@hotmail.co.uk",
+			"@hotmail.fr",
+			"@hotmail.it",
+			"@hotmail.es",
+			"@hotmail.de",
+			"@live.com",
+			"@live.co.uk",
+			"@live.fr",
+			"@live.nl",
+			"@live.it",
+			"@live.com.au",
+			"@live.ca",
+			"@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"
+		];
+	}
+];
+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: "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: "..................";
+	}
+];
+type ProviderName$1 = typeof records[number]["name"] | ProviderNames;
+export interface ValidationConfig {
+	/**
+	 * @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;
+	};
+	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";
+}
+export declare class EmailValidator {
+	private resolver;
+	private findIpKeys;
+	private roles;
+	private records;
+	private yahooList;
+	private domain;
+	private static instance;
+	private dns;
+	private validateCache;
+	private ipCache;
+	private inflight;
+	private validationConfig;
+	constructor(config?: {
+		options?: ValidationConfig;
+		dns?: Omit<ZynorConfig, "cache">;
+	});
+	/**
+	 * 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.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;
+	}): Promise<EmailResponse>;
+	/**
+	 * 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;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<EmailResponse[]>;
+	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 dnsLookup;
+	private returnDNS;
+	protected ipApi(ip: string, abortOptions?: AbortOptions): Promise<IPResponseData | null>;
+	protected findIp(ip: string, abortOptions?: AbortOptions): Promise<IPResponseDataFindIp | 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;
+	}>;
+	/**
+	 * Looks up IP address info using ipApi and/or findIp services.
+	 * Returns ISP, organization, geolocation, and hosting details.
+	 *
+	 * 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 ip - The IP address to look up (e.g. "93.184.216.34")
+	 * @param abortOptions - Optional signal/timeout to cancel the operation
+	 * @returns IP info object from ipApi or findIp, or null if lookup is disabled/fails
+	 *
+	 * @example
+	 * const validator = EmailValidator.create({
+	 *   options: { ipResolver: { ipApi: true } }
+	 * });
+	 * const info = await validator.lookupIpInfo('93.184.216.34');
+	 * // { status: 'success', isp: 'Edgecast Inc.', org: 'Verizon', ... }
+	 */
+	lookupIpInfo(ip: string, abortOptions?: AbortOptions): Promise<IPResponseData | IPResponseDataFindIp | null>;
+	/**
+	 * 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 {ProviderName} 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 {ProviderName} 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: ProviderName$1): string | null;
+	getProviderWebmailUrl(provider: ProviderName$1, 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 type IPResponseData = {
+	status: string;
+	continent: string;
+	continentCode: string;
+	country: string;
+	countryCode: string;
+	region: string;
+	regionName: string;
+	city: string;
+	zip: string;
+	lat: number;
+	lon: number;
+	timezone: string;
+	currency: string;
+	isp: string;
+	org: string;
+	as: string;
+	reverse: string;
+	mobile: boolean;
+	proxy: boolean;
+	hosting: boolean;
+	query: string;
+};
+export type IPResponseDataFindIp = {
+	city: {
+		geoname_id: number;
+		names: {
+			de: string;
+			en: string;
+			es: string;
+			fa: string;
+			fr: string;
+			ja: string;
+			ko: string;
+			"pt-BR": string;
+			ru: string;
+			"zh-CN": string;
+		};
+	};
+	continent: {
+		code: string;
+		geoname_id: number;
+		names: {
+			de: string;
+			en: string;
+			es: string;
+			fa: string;
+			fr: string;
+			ja: string;
+			ko: string;
+			"pt-BR": string;
+			ru: string;
+			"zh-CN": string;
+		};
+	};
+	country: {
+		geoname_id: number;
+		is_in_european_union: boolean;
+		iso_code: string;
+		names: {
+			de: string;
+			en: string;
+			es: string;
+			fa: string;
+			fr: string;
+			ja: string;
+			ko: string;
+			"pt-BR": string;
+			ru: string;
+			"zh-CN": string;
+		};
+	};
+	location: {
+		latitude: number;
+		longitude: number;
+		time_zone: string;
+		weather_code: string;
+	};
+	subdivisions: Array<{
+		geoname_id: number;
+		iso_code?: string;
+		names: {
+			en: string;
+		};
+	}>;
+	traits: {
+		autonomous_system_number: number;
+		autonomous_system_organization: string;
+		connection_type: string;
+		isp: string;
+		user_type: string;
+	};
+};
+export interface Valid {
+	success: true;
+	data: {
+		provider: ProviderName$1;
+		isFree: boolean;
+		email: string;
+		role: boolean;
+		webmail?: string;
+	};
+}
+export interface Invalid {
+	success: false;
+	type: "Invalid";
+	email: string;
+	role: boolean;
+}
+interface Disposable$1 {
+	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;
+}
+interface Error$1 {
+	success: false;
+	type: "Error";
+	email: string;
+	message: string;
+	role: boolean;
+}
+export type EmailResponse = Valid | Invalid | Rejected | Syntax | Error$1 | Disposable$1;
+/**
+ * Main DNS resolver class that aggregates multiple DNS providers.
+ */
+export declare class Zynor {
+	private providers;
+	private static __emailValidator;
+	private dnsCache;
+	private dnsTtl;
+	private inflight;
+	/**
+	 * 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;
+	/**
+	 * 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"];
+	/**
+	 * 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;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<EmailResponse[]>;
+}
+/**
+ * Resets the default resolver instance.
+ * This is useful for testing or when you want to change the default configuration.
+ */
+export declare const resetDefaultResolver: () => void;
+/**
+ * Sets a custom default resolver instance.
+ * @param resolver - The Zynor instance to use as default
+ */
+export declare const setDefaultResolver: (resolver: Zynor) => void;
+/**
+ * Resolves A records for a hostname using the default resolver.
+ * @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 IPv4 addresses or records with TTL
+ * @example
+ * ```typescript
+ * import { resolve4 } from 'zynor';
+ *
+ * const addresses = await resolve4('example.com');
+ * console.log(addresses); // ['93.184.216.34']
+ *
+ * const withTtl = await resolve4('example.com', { ttl: true });
+ * console.log(withTtl); // [{ address: '93.184.216.34', ttl: 300 }]
+ * ```
+ */
+export declare const resolve4: IResolver["resolve4"];
+/**
+ * Resolves AAAA records for a hostname using the default resolver.
+ * @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
+ * @example
+ * ```typescript
+ * import { resolve6 } from 'zynor';
+ *
+ * const addresses = await resolve6('example.com');
+ * console.log(addresses); // ['2606:2800:220:1:248:1893:25c8:1946']
+ * ```
+ */
+export declare const resolve6: IResolver["resolve6"];
+/**
+ * Resolves ANY records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of any DNS records
+ * @example
+ * ```typescript
+ * import { resolveAny } from 'zynor';
+ *
+ * const records = await resolveAny('example.com');
+ * console.log(records); // [{ type: 'A', address: '93.184.216.34' }, ...]
+ * ```
+ */
+export declare const resolveAny: IResolver["resolveAny"];
+/**
+ * Resolves CAA records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of CAA records
+ */
+export declare const resolveCaa: IResolver["resolveCaa"];
+/**
+ * Resolves CNAME records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of CNAME records
+ */
+export declare const resolveCname: IResolver["resolveCname"];
+/**
+ * Resolves MX records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of MX records
+ * @example
+ * ```typescript
+ * import { resolveMx } from 'zynor';
+ *
+ * const mxRecords = await resolveMx('example.com');
+ * console.log(mxRecords); // [{ priority: 10, exchange: 'mail.example.com' }]
+ * ```
+ */
+export declare const resolveMx: IResolver["resolveMx"];
+/**
+ * Resolves NAPTR records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of NAPTR records
+ */
+export declare const resolveNaptr: IResolver["resolveNaptr"];
+/**
+ * Resolves NS records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of NS records
+ */
+export declare const resolveNs: IResolver["resolveNs"];
+export declare const resolvePtr: IResolver["resolvePtr"];
+export declare const resolveSoa: IResolver["resolveSoa"];
+export declare const resolveSrv: IResolver["resolveSrv"];
+/**
+ * Resolves TLSA records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of TLSA records
+ */
+export declare const resolveTlsa: IResolver["resolveTlsa"];
+/**
+ * Resolves TXT records for a hostname using the default resolver.
+ * @param hostname - The hostname to resolve
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of TXT records
+ * @example
+ * ```typescript
+ * import { resolveTxt } from 'zynor';
+ *
+ * const txtRecords = await resolveTxt('example.com');
+ * console.log(txtRecords); // [['v=spf1 include:_spf.example.com ~all']]
+ * ```
+ */
+export declare const resolveTxt: IResolver["resolveTxt"];
+/**
+ * Performs reverse DNS lookup for an IP address using the default resolver.
+ * @param ip - The IP address to reverse lookup
+ * @param provider - Optional specific provider to use
+ * @returns A promise resolving to an array of hostnames
+ * @example
+ * ```typescript
+ * import { reverse } from 'zynor';
+ *
+ * const hostnames = await reverse('8.8.8.8');
+ * console.log(hostnames); // ['dns.google.']
+ * ```
+ */
+export declare const reverse: IResolver["reverse"];
+export declare const resolve: IResolver["resolve"];
+
+export {
+	CaaRecord,
+	MxRecord,
+	NaptrRecord,
+	RecordWithTtl,
+	ResolveOptions,
+	ResolveWithTtlOptions,
+	SoaRecord,
+	SrvRecord,
+	TlsaRecord,
+	Zynor as default,
+};
+
+export {};