/**
Thrown when the public IP address could not be found.
*/
export class IpNotFoundError extends Error {}

export type Options = {
	/**
	Use a HTTPS check using the [icanhazip.com](https://github.com/major/icanhaz) service instead of the DNS query. [ipify.org](https://ipify.org) is used as a fallback if `icanhazip.com` fails. This check is much more secure and tamper-proof, but also a lot slower.

	__This option is only available in the Node.js version.__

	The default behaviour is to check against DNS before using HTTPS fallback. If set to `true`, it will *only* check against HTTPS.

	@default false
	*/
	readonly onlyHttps?: boolean;

	/**
	The time in milliseconds until the operation is considered timed out. This applies to the entire operation, not individual requests.

	@default 5000
	*/
	readonly timeout?: number;

	/**
	An `AbortSignal`` to cancel the operation. If both `timeout` and `signal` are provided, the operation will be aborted when either the timeout is reached or the signal is aborted.
	*/
	readonly signal?: AbortSignal;

	/**
	Add your own custom HTTPS endpoints to get the public IP from. They will only be used if everything else fails. Any service used as fallback *must* return the IP as a plain string.

	@default []

	@example
	```
	import {publicIpv6} from 'public-ip';

	await publicIpv6({
		fallbackUrls: [
			'https://ifconfig.co/ip'
		]
	});
	```
	*/
	readonly fallbackUrls?: readonly string[];
};

/**
Get your public IP address.

In Node.js, it queries the DNS records of OpenDNS, Google DNS, and HTTPS services to determine your IP address. In browsers, it uses the [icanhaz](https://github.com/major/icanhaz) and [ipify](https://ipify.org) services through HTTPS.

@returns Your public IPv6 address or as a fallback, your public IPv4 address. Tries IPv6 first, then falls back to IPv4.
@throws On error or timeout.

@example
```
import {publicIp} from 'public-ip';

console.log(await publicIp()); // Tries IPv6 first, falls back to IPv4
//=> 'fe80::200:f8ff:fe21:67cf'
```
*/
export function publicIp(options?: Options): Promise<string>;

/**
Get your public IP address.

In Node.js, it queries the DNS records of OpenDNS, Google DNS, and HTTPS services to determine your IP address. In browsers, it uses the [icanhaz](https://github.com/major/icanhaz) and [ipify](https://ipify.org) services through HTTPS.

@returns Your public IPv4 address.
@throws On error or timeout.

@example
```
import {publicIpv4} from 'public-ip';

console.log(await publicIpv4());
//=> '46.5.21.123'
```
*/
export function publicIpv4(options?: Options): Promise<string>;

/**
Get your public IP address.

In Node.js, it queries the DNS records of OpenDNS, Google DNS, and HTTPS services to determine your IP address. In browsers, it uses the [icanhaz](https://github.com/major/icanhaz) and [ipify](https://ipify.org) services through HTTPS.

@returns Your public IPv6 address.
@throws On error or timeout.

@example
```
import {publicIpv6} from 'public-ip';

console.log(await publicIpv6());
//=> 'fe80::200:f8ff:fe21:67cf'
```
*/
export function publicIpv6(options?: Options): Promise<string>;