export declare class UrlSafetyError extends Error {
    constructor(message: string);
}
export interface ValidatedUrl {
    href: string;
    protocol: string;
    hostname: string;
    port: string;
    pathname: string;
    search: string;
    /** Resolved IP addresses (only populated when SSRF protection is on). */
    ips: string[];
}
/**
 * Validate a URL string with optional SSRF protection.
 *
 * Throws UrlSafetyError if the URL is invalid, uses a non-http(s) protocol,
 * points to a blocked hostname, or (when ssrfProtection=true) resolves to a
 * private IP address.
 */
export declare function validateUrl(urlStr: string, opts?: {
    ssrfProtection?: boolean;
    resolveDns?: boolean;
}): Promise<ValidatedUrl>;
/** Quick synchronous URL validation without DNS resolution. */
export declare function validateUrlBasic(urlStr: string): ValidatedUrl;
/** Normalize a URL for baseline matching (strip UTM, sort params, lowercase host). */
export declare function normalizeUrl(url: string): string;
/** Hash a normalized URL for baseline deduplication. */
export declare function urlHash(url: string): string;
//# sourceMappingURL=url-safety.d.ts.map