rezo 1.0.0

package/dist/adapters/entries/curl.d.ts

@@ -0,0 +1,2136 @@
+import NodeFormData from 'form-data';
+import { EventEmitter } from 'node:events';
+import { Agent as HttpAgent, OutgoingHttpHeaders } from 'node:http';
+import { Agent as HttpsAgent } from 'node:https';
+import { Socket } from 'node:net';
+import { Readable, Writable, WritableOptions } from 'node:stream';
+import { SecureContext, TLSSocket } from 'node:tls';
+import PQueue from 'p-queue';
+import { Options as Options$1, QueueAddOptions } from 'p-queue';
+import PriorityQueue from 'p-queue/dist/priority-queue';
+import { Cookie as TouchCookie, CookieJar as TouchCookieJar, CreateCookieOptions } from 'tough-cookie';
+
+export interface SerializedCookie {
+	key: string;
+	value: string;
+	expires?: string;
+	maxAge?: number | "Infinity" | "-Infinity";
+	domain?: string;
+	path?: string;
+	secure?: boolean;
+	hostOnly?: boolean;
+	creation?: string;
+	lastAccessed?: string;
+	[key: string]: unknown;
+}
+declare class Cookie extends TouchCookie {
+	constructor(options?: CreateCookieOptions);
+	/**
+	 * Fixes date fields that may have become strings during JSON deserialization.
+	 * This is a workaround for tough-cookie's deserialization behavior in Bun/Node.js
+	 * where Date objects become ISO strings.
+	 */
+	private fixDateFields;
+	private getExpires;
+	toNetscapeFormat(): string;
+	toSetCookieString(): string;
+	/**
+	   * Retrieves the complete URL from the cookie object
+	   * @returns {string | undefined} The complete URL including protocol, domain and path. Returns undefined if domain is not set
+	   * @example
+	   * const cookie = new Cookie({
+	   *   domain: "example.com",
+	   *   path: "/path",
+	   *   secure: true
+	   * });
+	   * cookie.getURL(); // Returns: "https://example.com/path"
+	   */
+	getURL(): string | undefined;
+	/**
+	 * Type guard to check if an object is an instance of Cookie
+	 * @param cookie - The object to check
+	 * @returns {boolean} True if the object is a Cookie instance, false otherwise
+	 * @example
+	 * const obj = new Cookie();
+	 * if (Cookie.isCookie(obj)) {
+	 *   // obj is confirmed to be a Cookie instance
+	 * }
+	 */
+	static isCookie(cookie: any): cookie is Cookie;
+}
+declare class RezoCookieJar extends TouchCookieJar {
+	constructor();
+	constructor(cookies: Cookie[]);
+	constructor(cookies: Cookie[], url: string);
+	private generateCookies;
+	cookies(): Cookies;
+	parseResponseCookies(cookies: Cookie[]): Cookies;
+	static toNetscapeCookie(cookies: Cookie[] | SerializedCookie[]): string;
+	static toCookieString(cookies: Cookie[] | SerializedCookie[]): string;
+	toCookieString(): string;
+	toNetscapeCookie(): string;
+	toArray(): Cookie[];
+	toSetCookies(): string[];
+	toSerializedCookies(): SerializedCookie[];
+	setCookiesSync(setCookieArray: string[]): Cookies;
+	setCookiesSync(setCookieArray: string[], url: string): Cookies;
+	setCookiesSync(cookiesString: string): Cookies;
+	setCookiesSync(cookiesString: string, url: string): Cookies;
+	setCookiesSync(serializedCookies: SerializedCookie[]): Cookies;
+	setCookiesSync(serializedCookies: SerializedCookie[], url: string): Cookies;
+	setCookiesSync(cookieArray: Cookie[]): Cookies;
+	setCookiesSync(cookieArray: Cookie[], url: string): Cookies;
+	private splitSetCookiesString;
+	private getUrlFromCookie;
+	private parseNetscapeCookies;
+	/**
+	   * Converts Netscape cookie format to an array of Set-Cookie header strings
+	   *
+	   * @param netscapeCookieText - Netscape format cookie string
+	   * @returns Array of Set-Cookie header strings
+	   */
+	static netscapeCookiesToSetCookieArray(netscapeCookieText: string): string[];
+	/** Path to cookie file for persistence */
+	private _cookieFile?;
+	/** Get the cookie file path */
+	get cookieFile(): string | undefined;
+	/**
+	 * Load cookies from a file (sync version).
+	 * - .json files are loaded as serialized JSON cookies
+	 * - .txt files are loaded as Netscape format cookies
+	 *
+	 * This method bypasses public suffix validation for persisted cookies only,
+	 * keeping normal network cookie validation intact.
+	 *
+	 * @param filePath - Path to the cookie file
+	 * @param defaultUrl - Default URL for cookies without domain (optional)
+	 */
+	loadFromFile(filePath: string, defaultUrl?: string): void;
+	/**
+	 * Save cookies to a file.
+	 * - .json files save cookies as serialized JSON
+	 * - .txt files save cookies in Netscape format
+	 *
+	 * @param filePath - Path to save the cookies (defaults to the loaded file path)
+	 */
+	saveToFile(filePath?: string): void;
+	/**
+	 * Create a new RezoCookieJar from a cookie file.
+	 * - .json files are loaded as serialized JSON cookies
+	 * - .txt files are loaded as Netscape format cookies
+	 *
+	 * @param filePath - Path to the cookie file
+	 * @param defaultUrl - Default URL for cookies without domain (optional)
+	 * @returns A new RezoCookieJar with cookies loaded from the file
+	 */
+	static fromFile(filePath: string, defaultUrl?: string): RezoCookieJar;
+}
+export interface Cookies {
+	array: Cookie[];
+	serialized: SerializedCookie[];
+	netscape: string;
+	string: string;
+	setCookiesString: string[];
+}
+export interface RezoHttpHeaders {
+	accept?: string | undefined;
+	"accept-encoding"?: string | undefined;
+	"accept-language"?: string | undefined;
+	"accept-patch"?: string | undefined;
+	"accept-ranges"?: string | undefined;
+	"access-control-allow-credentials"?: string | undefined;
+	"access-control-allow-headers"?: string | undefined;
+	"access-control-allow-methods"?: string | undefined;
+	"access-control-allow-origin"?: string | undefined;
+	"access-control-expose-headers"?: string | undefined;
+	"access-control-max-age"?: string | undefined;
+	"access-control-request-headers"?: string | undefined;
+	"access-control-request-method"?: string | undefined;
+	age?: string | undefined;
+	allow?: string | undefined;
+	"alt-svc"?: string | undefined;
+	authorization?: string | undefined;
+	"cache-control"?: string | undefined;
+	connection?: string | undefined;
+	"content-disposition"?: string | undefined;
+	"content-encoding"?: string | undefined;
+	"content-language"?: string | undefined;
+	"content-length"?: string | undefined;
+	"content-location"?: string | undefined;
+	"content-range"?: string | undefined;
+	"content-type"?: string | undefined;
+	cookie?: string | undefined;
+	date?: string | undefined;
+	etag?: string | undefined;
+	expect?: string | undefined;
+	expires?: string | undefined;
+	forwarded?: string | undefined;
+	from?: string | undefined;
+	host?: string | undefined;
+	"if-match"?: string | undefined;
+	"if-modified-since"?: string | undefined;
+	"if-none-match"?: string | undefined;
+	"if-unmodified-since"?: string | undefined;
+	"last-modified"?: string | undefined;
+	location?: string | undefined;
+	origin?: string | undefined;
+	pragma?: string | undefined;
+	"proxy-authenticate"?: string | undefined;
+	"proxy-authorization"?: string | undefined;
+	"public-key-pins"?: string | undefined;
+	range?: string | undefined;
+	referer?: string | undefined;
+	"retry-after"?: string | undefined;
+	"sec-fetch-site"?: string | undefined;
+	"sec-fetch-mode"?: string | undefined;
+	"sec-fetch-user"?: string | undefined;
+	"sec-fetch-dest"?: string | undefined;
+	"sec-websocket-accept"?: string | undefined;
+	"sec-websocket-extensions"?: string | undefined;
+	"sec-websocket-key"?: string | undefined;
+	"sec-websocket-protocol"?: string | undefined;
+	"sec-websocket-version"?: string | undefined;
+	"strict-transport-security"?: string | undefined;
+	tk?: string | undefined;
+	trailer?: string | undefined;
+	"transfer-encoding"?: string | undefined;
+	upgrade?: string | undefined;
+	"user-agent"?: string | undefined;
+	vary?: string | undefined;
+	via?: string | undefined;
+	warning?: string | undefined;
+	"www-authenticate"?: string | undefined;
+	"accept-charset"?: string | undefined;
+	"cdn-cache-control"?: string | undefined;
+	"content-security-policy"?: string | undefined;
+	"content-security-policy-report-only"?: string | undefined;
+	dav?: string | undefined;
+	dnt?: string | undefined;
+	"if-range"?: string | undefined;
+	link?: string | undefined;
+	"max-forwards"?: string | undefined;
+	"public-key-pins-report-only"?: string | undefined;
+	"referrer-policy"?: string | undefined;
+	refresh?: string | undefined;
+	server?: string | undefined;
+	te?: string | undefined;
+	"upgrade-insecure-requests"?: string | undefined;
+	"x-content-type-options"?: string | undefined;
+	"x-dns-prefetch-control"?: string | undefined;
+	"x-frame-options"?: string | undefined;
+	"x-xss-protection"?: string | undefined;
+	"set-cookie"?: string[];
+}
+export type RezoHeadersInit = [
+	string,
+	string
+][] | Record<string, string> | Headers | RezoHttpHeaders | RezoHeaders | OutgoingHttpHeaders;
+declare class RezoHeaders extends Headers {
+	constructor(init?: RezoHeadersInit);
+	getAll(name: "set-cookie" | "Set-Cookie"): string[];
+	getSetCookie(): string[];
+	get size(): number;
+	setContentType(value: string): this;
+	getContentType(): string | undefined;
+	setAuthorization(value: string): this;
+	setUserAgent(value: string): this;
+	getUserAgent(): string | undefined;
+	getKeys(): string[];
+	getValues(): string[];
+	toEntries(): [
+		string,
+		string | string
+	][];
+	toNative(): Headers;
+	toRaw(): [
+		string,
+		string
+	][];
+	toArray(): {
+		key: string;
+		value: string;
+	}[];
+	toObject(omit?: Array<keyof RezoHttpHeaders> | keyof RezoHttpHeaders): Record<string, string | string[]>;
+	toString(): string;
+	set(name: keyof RezoHttpHeaders, value: string): void;
+	set(name: string, value: string): void;
+	append(name: keyof RezoHttpHeaders, value: string): void;
+	append(name: string, value: string): void;
+	get(name: keyof RezoHttpHeaders): string | null;
+	get(name: string): string | null;
+	has(name: keyof RezoHttpHeaders): boolean;
+	has(name: string): boolean;
+	[Symbol.iterator](): ArrayIterator<[
+		string,
+		string | string[]
+	]>;
+	[util.inspect.custom](_depth: number, options: util.InspectOptionsStylized): string;
+	get [Symbol.toStringTag](): string;
+}
+export interface ReadableOptions {
+	highWaterMark?: number;
+	encoding?: string;
+	objectMode?: boolean;
+	read?(this: Readable, size: number): void;
+	destroy?(this: Readable, error: Error | null, callback: (error: Error | null) => void): void;
+	autoDestroy?: boolean;
+}
+export interface Options extends ReadableOptions {
+	writable?: boolean;
+	readable?: boolean;
+	dataSize?: number;
+	maxDataSize?: number;
+	pauseStreams?: boolean;
+}
+declare class RezoFormData extends NodeFormData {
+	constructor(options?: Options);
+	/**
+	 * Get field entries as array of [name, value] pairs
+	 * @returns {Promise<Array<[string, any]>>} Array of field entries
+	 */
+	getFieldEntries(): Promise<Array<[
+		string,
+		any
+	]>>;
+	/**
+	 * Convert to native FormData
+	 * @returns {Promise<FormData | null>}
+	 */
+	toNativeFormData(): Promise<FormData | null>;
+	/**
+	 * Create RezoFormData from native FormData
+	 * @param {FormData} formData - Native FormData object
+	 * @param {Options} options - Optional RezoFormData options
+	 * @returns {Promise<RezoFormData>}
+	 */
+	static fromNativeFormData(formData: FormData, options?: Options): Promise<RezoFormData>;
+	/**
+	 * Get the content type header for this form data
+	 * @returns {string} Content type with boundary
+	 */
+	getContentType(): string;
+	/**
+	 * Convert form data to Buffer
+	 * @returns {Buffer} Form data as buffer
+	 */
+	toBuffer(): Buffer;
+	/**
+	 * Create RezoFormData from object
+	 * @param {Record<string, any>} obj - Object to convert
+	 * @param {Options} options - Optional RezoFormData options
+	 * @returns {RezoFormData}
+	 */
+	static fromObject(obj: Record<string, any>, options?: Options): RezoFormData;
+	/**
+	 * Convert to URL query string
+	 * Warning: File, Blob, and binary data will be omitted
+	 * @param {boolean} convertBinaryToBase64 - Convert binary data to base64 strings
+	 * @returns {Promise<string>} URL query string
+	 */
+	toUrlQueryString(convertBinaryToBase64?: boolean): Promise<string>;
+	/**
+	 * Convert to URLSearchParams object
+	 * Warning: File, Blob, and binary data will be omitted
+	 * @param {boolean} convertBinaryToBase64 - Convert binary data to base64 strings
+	 * @returns {Promise<URLSearchParams>} URLSearchParams object
+	 */
+	toURLSearchParams(convertBinaryToBase64?: boolean): Promise<URLSearchParams>;
+}
+/**
+ * Emitted when request is initiated
+ * Contains basic request configuration without sensitive data
+ */
+export interface RequestStartEvent {
+	/** Target URL */
+	url: string;
+	/** HTTP method */
+	method: string;
+	/** Request headers being sent */
+	headers: RezoHeaders;
+	/** Timestamp when request started (performance.now()) */
+	timestamp: number;
+	/** Request timeout in milliseconds */
+	timeout?: number;
+	/** Maximum redirects allowed */
+	maxRedirects?: number;
+	/** Retry configuration */
+	retry?: {
+		maxRetries?: number;
+		delay?: number;
+		backoff?: number;
+	};
+}
+/**
+ * Emitted when response headers are received (first byte)
+ * Provides response metadata before body is processed
+ */
+export interface ResponseHeadersEvent {
+	/** HTTP status code */
+	status: number;
+	/** HTTP status text */
+	statusText: string;
+	/** Response headers */
+	headers: RezoHeaders;
+	/** Content-Type header value */
+	contentType?: string;
+	/** Content-Length header value (bytes) */
+	contentLength?: number;
+	/** Cookies from Set-Cookie headers */
+	cookies?: Cookie[];
+	/** Timing information */
+	timing: {
+		/** Time to first byte (TTFB) in milliseconds */
+		firstByte: number;
+		/** Total time elapsed so far in milliseconds */
+		total: number;
+	};
+}
+/**
+ * Emitted AFTER a redirect is followed
+ * Provides complete redirect information
+ */
+export interface RedirectEvent {
+	/** Source URL (where we're redirecting FROM) */
+	sourceUrl: string;
+	/** Source HTTP status code */
+	sourceStatus: number;
+	/** Source HTTP status text */
+	sourceStatusText: string;
+	/** Destination URL (where we're redirecting TO) */
+	destinationUrl: string;
+	/** Number of redirects followed so far */
+	redirectCount: number;
+	/** Maximum redirects allowed */
+	maxRedirects: number;
+	/** Response headers from redirect response */
+	headers: RezoHeaders;
+	/** Cookies from redirect response */
+	cookies: Cookie[];
+	/** HTTP method used for the redirect */
+	method: string;
+	/** Timestamp when redirect occurred */
+	timestamp: number;
+	/** Duration of this redirect in milliseconds */
+	duration: number;
+}
+interface ProgressEvent$1 {
+	/** Bytes transferred so far */
+	loaded: number;
+	/** Total bytes (from Content-Length or file size) */
+	total: number;
+	/** Progress percentage (0-100) */
+	percentage: number;
+	/** Current transfer speed in bytes/second */
+	speed: number;
+	/** Average transfer speed in bytes/second */
+	averageSpeed: number;
+	/** Estimated time remaining in milliseconds */
+	estimatedTime: number;
+	/** Timestamp of this progress update */
+	timestamp: number;
+}
+/**
+ * Emitted when StreamResponse completes
+ * Body has already been emitted via 'data' events
+ */
+export interface StreamFinishEvent {
+	/** HTTP status code */
+	status: number;
+	/** HTTP status text */
+	statusText: string;
+	/** Response headers */
+	headers: RezoHeaders;
+	/** Content-Type header value */
+	contentType?: string;
+	/** Content-Length (bytes received) */
+	contentLength: number;
+	/** Final URL after redirects */
+	finalUrl: string;
+	/** Cookies received */
+	cookies: Cookies;
+	/** All URLs traversed (includes redirects) */
+	urls: string[];
+	/** Timing breakdown */
+	timing: {
+		/** Total request time in milliseconds */
+		total: number;
+		/** DNS lookup time in milliseconds */
+		dns?: number;
+		/** TCP connection time in milliseconds */
+		tcp?: number;
+		/** TLS handshake time in milliseconds */
+		tls?: number;
+		/** Time to first byte in milliseconds */
+		firstByte?: number;
+		/** Content download time in milliseconds */
+		download?: number;
+	};
+	/** Response configuration (execution metadata) */
+	config: SanitizedRezoConfig;
+}
+/**
+ * Emitted when DownloadResponse completes
+ * Body has been saved to file
+ */
+export interface DownloadFinishEvent {
+	/** HTTP status code */
+	status: number;
+	/** HTTP status text */
+	statusText: string;
+	/** Response headers */
+	headers: RezoHeaders;
+	/** Content-Type header value */
+	contentType?: string;
+	/** Content-Length (bytes downloaded) */
+	contentLength: number;
+	/** Final URL after redirects */
+	finalUrl: string;
+	/** Cookies received */
+	cookies: Cookies;
+	/** All URLs traversed (includes redirects) */
+	urls: string[];
+	/**
+	 * File name (supports both basename and fullname)
+	 * - For fileName: 'report.pdf' → returns 'report.pdf'
+	 * - For saveTo: '/path/to/report.pdf' → returns '/path/to/report.pdf'
+	 */
+	fileName: string;
+	/** File size in bytes */
+	fileSize: number;
+	/** Timing breakdown */
+	timing: {
+		/** Total request time in milliseconds */
+		total: number;
+		/** DNS lookup time in milliseconds */
+		dns?: number;
+		/** TCP connection time in milliseconds */
+		tcp?: number;
+		/** TLS handshake time in milliseconds */
+		tls?: number;
+		/** Time to first byte in milliseconds */
+		firstByte?: number;
+		/** Download duration in milliseconds */
+		download: number;
+	};
+	/** Average download speed in bytes/second */
+	averageSpeed: number;
+	/** Response configuration (execution metadata) */
+	config: SanitizedRezoConfig;
+}
+/**
+ * Emitted when UploadResponse completes
+ * Includes server's response body
+ */
+export interface UploadFinishEvent {
+	/** Server's response to our upload */
+	response: {
+		/** HTTP status code */
+		status: number;
+		/** HTTP status text */
+		statusText: string;
+		/** Response headers */
+		headers: RezoHeaders;
+		/** Response body from server */
+		data: any;
+		/** Content-Type header value */
+		contentType?: string;
+		/** Response content length */
+		contentLength?: number;
+	};
+	/** Final URL after redirects */
+	finalUrl: string;
+	/** Cookies received */
+	cookies: Cookies;
+	/** All URLs traversed (includes redirects) */
+	urls: string[];
+	/** Upload size in bytes */
+	uploadSize: number;
+	/** File name if uploading a file */
+	fileName?: string;
+	/** Timing breakdown */
+	timing: {
+		/** Total request time in milliseconds */
+		total: number;
+		/** DNS lookup time in milliseconds */
+		dns?: number;
+		/** TCP connection time in milliseconds */
+		tcp?: number;
+		/** TLS handshake time in milliseconds */
+		tls?: number;
+		/** Upload duration in milliseconds */
+		upload: number;
+		/** Time waiting for server response in milliseconds */
+		waiting: number;
+		/** Response download time in milliseconds */
+		download?: number;
+	};
+	/** Average upload speed in bytes/second */
+	averageUploadSpeed: number;
+	/** Average download speed in bytes/second (for response) */
+	averageDownloadSpeed?: number;
+	/** Response configuration (execution metadata) */
+	config: SanitizedRezoConfig;
+}
+/**
+ * Sanitized RezoConfig for event emission
+ * Excludes only request body/data, includes all metadata
+ */
+export type SanitizedRezoConfig = Omit<RezoConfig, "data"> & {
+	/** Data field explicitly removed */
+	data?: never;
+};
+/**
+ * Event map for StreamResponse - defines all available events and their signatures
+ */
+export interface StreamResponseEvents {
+	close: [
+	];
+	drain: [
+	];
+	error: [
+		err: RezoError
+	];
+	finish: [
+		info: StreamFinishEvent
+	];
+	done: [
+		info: StreamFinishEvent
+	];
+	start: [
+		info: RequestStartEvent
+	];
+	initiated: [
+	];
+	headers: [
+		info: ResponseHeadersEvent
+	];
+	cookies: [
+		cookies: Cookie[]
+	];
+	status: [
+		status: number,
+		statusText: string
+	];
+	redirect: [
+		info: RedirectEvent
+	];
+	progress: [
+		progress: ProgressEvent$1
+	];
+	data: [
+		chunk: Buffer | string
+	];
+	pipe: [
+		src: Readable
+	];
+	unpipe: [
+		src: Readable
+	];
+}
+/**
+ * Complete type-safe event method overrides for StreamResponse
+ * All event listener methods return 'this' for chaining
+ */
+export interface StreamResponseEventOverrides {
+	on<K extends keyof StreamResponseEvents>(event: K, listener: (...args: StreamResponseEvents[K]) => void): this;
+	on(event: string | symbol, listener: (...args: any[]) => void): this;
+	once<K extends keyof StreamResponseEvents>(event: K, listener: (...args: StreamResponseEvents[K]) => void): this;
+	once(event: string | symbol, listener: (...args: any[]) => void): this;
+	addListener<K extends keyof StreamResponseEvents>(event: K, listener: (...args: StreamResponseEvents[K]) => void): this;
+	addListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependListener<K extends keyof StreamResponseEvents>(event: K, listener: (...args: StreamResponseEvents[K]) => void): this;
+	prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependOnceListener<K extends keyof StreamResponseEvents>(event: K, listener: (...args: StreamResponseEvents[K]) => void): this;
+	prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+declare class StreamResponse extends Writable implements StreamResponseEventOverrides {
+	private _finished;
+	private _encoding?;
+	constructor(opts?: WritableOptions);
+	/**
+	 * Set encoding for string chunks
+	 * @param encoding - Buffer encoding (utf8, ascii, etc.)
+	 * @returns this for chaining
+	 */
+	setEncoding(encoding: BufferEncoding): this;
+	/**
+	 * Get current encoding
+	 */
+	getEncoding(): BufferEncoding | undefined;
+	/**
+	 * Check if stream has finished
+	 */
+	isFinished(): boolean;
+	/**
+	 * Mark stream as finished (internal use)
+	 * @internal
+	 */
+	_markFinished(): void;
+	/**
+	 * Internal write implementation required by Writable
+	 * Emits 'data' event for each chunk received
+	 * @internal
+	 */
+	_write(chunk: any, _encoding: BufferEncoding, callback: (error?: Error | null) => void): void;
+	on(event: string | symbol, listener: (...args: any[]) => void): this;
+	once(event: string | symbol, listener: (...args: any[]) => void): this;
+	addListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	off(event: string | symbol, listener: (...args: any[]) => void): this;
+	removeListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	removeAllListeners(event?: string | symbol): this;
+}
+/**
+ * Complete type-safe event method overrides for DownloadResponse
+ * All event listener methods return 'this' for chaining
+ */
+export interface DownloadResponseEventOverrides {
+	on(event: "error", listener: (err: RezoError) => void): this;
+	on(event: "finish", listener: (info: DownloadFinishEvent) => void): this;
+	on(event: "done", listener: (info: DownloadFinishEvent) => void): this;
+	on(event: "start", listener: (info: RequestStartEvent) => void): this;
+	on(event: "initiated", listener: () => void): this;
+	on(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	on(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	on(event: "status", listener: (status: number, statusText: string) => void): this;
+	on(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	on(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	on(event: string | symbol, listener: (...args: any[]) => void): this;
+	once(event: "error", listener: (err: RezoError) => void): this;
+	once(event: "finish", listener: (info: DownloadFinishEvent) => void): this;
+	once(event: "done", listener: (info: DownloadFinishEvent) => void): this;
+	once(event: "start", listener: (info: RequestStartEvent) => void): this;
+	once(event: "initiated", listener: () => void): this;
+	once(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	once(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	once(event: "status", listener: (status: number, statusText: string) => void): this;
+	once(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	once(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	once(event: string | symbol, listener: (...args: any[]) => void): this;
+	addListener(event: "error", listener: (err: RezoError) => void): this;
+	addListener(event: "finish", listener: (info: DownloadFinishEvent) => void): this;
+	addListener(event: "done", listener: (info: DownloadFinishEvent) => void): this;
+	addListener(event: "start", listener: (info: RequestStartEvent) => void): this;
+	addListener(event: "initiated", listener: () => void): this;
+	addListener(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	addListener(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	addListener(event: "status", listener: (status: number, statusText: string) => void): this;
+	addListener(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	addListener(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	addListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependListener(event: "error", listener: (err: RezoError) => void): this;
+	prependListener(event: "finish", listener: (info: DownloadFinishEvent) => void): this;
+	prependListener(event: "done", listener: (info: DownloadFinishEvent) => void): this;
+	prependListener(event: "start", listener: (info: RequestStartEvent) => void): this;
+	prependListener(event: "initiated", listener: () => void): this;
+	prependListener(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	prependListener(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	prependListener(event: "status", listener: (status: number, statusText: string) => void): this;
+	prependListener(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	prependListener(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependOnceListener(event: "error", listener: (err: RezoError) => void): this;
+	prependOnceListener(event: "finish", listener: (info: DownloadFinishEvent) => void): this;
+	prependOnceListener(event: "done", listener: (info: DownloadFinishEvent) => void): this;
+	prependOnceListener(event: "start", listener: (info: RequestStartEvent) => void): this;
+	prependOnceListener(event: "initiated", listener: () => void): this;
+	prependOnceListener(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	prependOnceListener(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	prependOnceListener(event: "status", listener: (status: number, statusText: string) => void): this;
+	prependOnceListener(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	prependOnceListener(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+declare class DownloadResponse extends EventEmitter implements DownloadResponseEventOverrides {
+	/** File name (basename or fullname) */
+	fileName: string;
+	/** Target URL */
+	url: string;
+	/** HTTP status code (set when headers received) */
+	status?: number;
+	/** HTTP status text (set when headers received) */
+	statusText?: string;
+	private _finished;
+	constructor(fileName: string, url: string);
+	/**
+	 * Check if download has finished
+	 */
+	isFinished(): boolean;
+	/**
+	 * Mark download as finished (internal use)
+	 * @internal
+	 */
+	_markFinished(): void;
+	on(event: string | symbol, listener: (...args: any[]) => void): this;
+	once(event: string | symbol, listener: (...args: any[]) => void): this;
+	addListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	off(event: string | symbol, listener: (...args: any[]) => void): this;
+	removeListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	removeAllListeners(event?: string | symbol): this;
+}
+/**
+ * Complete type-safe event method overrides for UploadResponse
+ * All event listener methods return 'this' for chaining
+ */
+export interface UploadResponseEventOverrides {
+	on(event: "error", listener: (err: RezoError) => void): this;
+	on(event: "finish", listener: (info: UploadFinishEvent) => void): this;
+	on(event: "done", listener: (info: UploadFinishEvent) => void): this;
+	on(event: "start", listener: (info: RequestStartEvent) => void): this;
+	on(event: "initiated", listener: () => void): this;
+	on(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	on(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	on(event: "status", listener: (status: number, statusText: string) => void): this;
+	on(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	on(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	on(event: string | symbol, listener: (...args: any[]) => void): this;
+	once(event: "error", listener: (err: RezoError) => void): this;
+	once(event: "finish", listener: (info: UploadFinishEvent) => void): this;
+	once(event: "done", listener: (info: UploadFinishEvent) => void): this;
+	once(event: "start", listener: (info: RequestStartEvent) => void): this;
+	once(event: "initiated", listener: () => void): this;
+	once(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	once(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	once(event: "status", listener: (status: number, statusText: string) => void): this;
+	once(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	once(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	once(event: string | symbol, listener: (...args: any[]) => void): this;
+	addListener(event: "error", listener: (err: RezoError) => void): this;
+	addListener(event: "finish", listener: (info: UploadFinishEvent) => void): this;
+	addListener(event: "done", listener: (info: UploadFinishEvent) => void): this;
+	addListener(event: "start", listener: (info: RequestStartEvent) => void): this;
+	addListener(event: "initiated", listener: () => void): this;
+	addListener(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	addListener(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	addListener(event: "status", listener: (status: number, statusText: string) => void): this;
+	addListener(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	addListener(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	addListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependListener(event: "error", listener: (err: RezoError) => void): this;
+	prependListener(event: "finish", listener: (info: UploadFinishEvent) => void): this;
+	prependListener(event: "done", listener: (info: UploadFinishEvent) => void): this;
+	prependListener(event: "start", listener: (info: RequestStartEvent) => void): this;
+	prependListener(event: "initiated", listener: () => void): this;
+	prependListener(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	prependListener(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	prependListener(event: "status", listener: (status: number, statusText: string) => void): this;
+	prependListener(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	prependListener(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependOnceListener(event: "error", listener: (err: RezoError) => void): this;
+	prependOnceListener(event: "finish", listener: (info: UploadFinishEvent) => void): this;
+	prependOnceListener(event: "done", listener: (info: UploadFinishEvent) => void): this;
+	prependOnceListener(event: "start", listener: (info: RequestStartEvent) => void): this;
+	prependOnceListener(event: "initiated", listener: () => void): this;
+	prependOnceListener(event: "headers", listener: (info: ResponseHeadersEvent) => void): this;
+	prependOnceListener(event: "cookies", listener: (cookies: Cookie[]) => void): this;
+	prependOnceListener(event: "status", listener: (status: number, statusText: string) => void): this;
+	prependOnceListener(event: "redirect", listener: (info: RedirectEvent) => void): this;
+	prependOnceListener(event: "progress", listener: (progress: ProgressEvent$1) => void): this;
+	prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+declare class UploadResponse extends EventEmitter implements UploadResponseEventOverrides {
+	/** Target URL */
+	url: string;
+	/** File name if uploading a file */
+	fileName?: string;
+	/** HTTP status code (set when headers received) */
+	status?: number;
+	/** HTTP status text (set when headers received) */
+	statusText?: string;
+	private _finished;
+	constructor(url: string, fileName?: string);
+	/**
+	 * Check if upload has finished
+	 */
+	isFinished(): boolean;
+	/**
+	 * Mark upload as finished (internal use)
+	 * @internal
+	 */
+	_markFinished(): void;
+	on(event: string | symbol, listener: (...args: any[]) => void): this;
+	once(event: string | symbol, listener: (...args: any[]) => void): this;
+	addListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	off(event: string | symbol, listener: (...args: any[]) => void): this;
+	removeListener(event: string | symbol, listener: (...args: any[]) => void): this;
+	removeAllListeners(event?: string | symbol): this;
+}
+/**
+ * Standard RezoResponse for non-streaming requests
+ * Contains response data, status, headers, cookies, and execution metadata
+ */
+export interface RezoResponse<T = any> {
+	data: T;
+	status: number;
+	statusText: string;
+	finalUrl: string;
+	cookies: Cookies;
+	headers: RezoHeaders;
+	contentType: string | undefined;
+	contentLength: number;
+	urls: string[];
+	config: RezoConfig;
+}
+/**
+ * RezoStreamResponse - For responseType: 'stream'
+ * Extends StreamResponse class (EventEmitter)
+ * Emits 'data' events for response body chunks
+ */
+export interface RezoStreamResponse extends StreamResponse {
+}
+/**
+ * RezoDownloadResponse - For fileName/saveTo options
+ * Extends DownloadResponse class (EventEmitter)
+ * Streams response body directly to file
+ */
+export interface RezoDownloadResponse extends DownloadResponse {
+}
+/**
+ * RezoUploadResponse - For responseType: 'upload'
+ * Extends UploadResponse class (EventEmitter)
+ * Tracks upload progress and includes server response body
+ */
+export interface RezoUploadResponse extends UploadResponse {
+}
+declare class RezoError<T = any> extends Error {
+	readonly code?: string;
+	readonly errno?: number;
+	readonly config: RezoConfig;
+	readonly request?: RezoHttpRequest;
+	readonly response?: RezoResponse<T>;
+	readonly isRezoError: boolean;
+	readonly cause?: Error;
+	readonly syscall?: string;
+	readonly hostname?: string;
+	readonly port?: number;
+	readonly address?: string;
+	readonly status?: number;
+	readonly statusText?: string;
+	readonly isTimeout: boolean;
+	readonly isAborted: boolean;
+	readonly isNetworkError: boolean;
+	readonly isHttpError: boolean;
+	readonly isProxyError: boolean;
+	readonly isSocksError: boolean;
+	readonly isTlsError: boolean;
+	readonly isRetryable: boolean;
+	readonly details: string;
+	readonly suggestion: string;
+	constructor(message: string, config: RezoConfig, code?: string, request?: RezoHttpRequest, response?: RezoResponse<T>);
+	static isRezoError(error: unknown): error is RezoError;
+	static fromError<T = any>(error: Error, config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	static createNetworkError<T = any>(message: string, code: string, config: RezoConfig, request?: RezoHttpRequest): RezoError<T>;
+	static createHttpError<T = any>(statusCode: number, config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	static createTimeoutError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest): RezoError<T>;
+	static createAbortError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest): RezoError<T>;
+	static createParsingError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest): RezoError<T>;
+	static createEnvironmentError<T = any>(message: string, config: RezoConfig): RezoError<T>;
+	static createDecompressionError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	static createDownloadError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	static createUploadError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	static createStreamError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	static createRedirectError<T = any>(message: string, config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	static createProxyError<T = any>(code: string, config: RezoConfig, request?: RezoHttpRequest): RezoError<T>;
+	static createSocksError<T = any>(code: string, config: RezoConfig, request?: RezoHttpRequest): RezoError<T>;
+	static createTlsError<T = any>(code: string, config: RezoConfig, request?: RezoHttpRequest): RezoError<T>;
+	static createRateLimitError<T = any>(config: RezoConfig, request?: RezoHttpRequest, response?: RezoResponse<T>): RezoError<T>;
+	/**
+	 * Convert error to JSON - only includes defined values
+	 */
+	toJSON(): Record<string, unknown>;
+	toString(): string;
+	getFullDetails(): string;
+}
+/**
+ * Context provided to beforeRequest hook
+ * Contains metadata about the current request state
+ */
+export interface BeforeRequestContext {
+	/** Current retry count (0 for initial request, 1+ for retries) */
+	retryCount: number;
+	/** Whether this is a redirect follow-up request */
+	isRedirect: boolean;
+	/** Number of redirects followed so far */
+	redirectCount: number;
+	/** Timestamp when request processing started */
+	startTime: number;
+}
+/**
+ * Context provided to afterResponse hook
+ * Includes retry capability for token refresh scenarios
+ */
+export interface AfterResponseContext {
+	/** Current retry count */
+	retryCount: number;
+	/** Function to retry request with merged options */
+	retryWithMergedOptions: (options: Partial<RezoRequestConfig>) => never;
+}
+/**
+ * DNS resolution event data
+ */
+export interface DnsLookupEvent {
+	/** Hostname being resolved */
+	hostname: string;
+	/** Resolved IP address */
+	address: string;
+	/** Address family (4 for IPv4, 6 for IPv6) */
+	family: 4 | 6;
+	/** DNS lookup duration in milliseconds */
+	duration: number;
+	/** Timestamp when lookup completed */
+	timestamp: number;
+}
+/**
+ * TLS handshake event data
+ */
+export interface TlsHandshakeEvent {
+	/** TLS protocol version (TLSv1.2, TLSv1.3, etc.) */
+	protocol: string;
+	/** Cipher suite used */
+	cipher: string;
+	/** Whether certificate is authorized */
+	authorized: boolean;
+	/** Authorization error if any */
+	authorizationError?: string;
+	/** Server certificate info */
+	certificate?: {
+		subject: string;
+		issuer: string;
+		validFrom: string;
+		validTo: string;
+		fingerprint: string;
+	};
+	/** Handshake duration in milliseconds */
+	duration: number;
+	/** Timestamp when handshake completed */
+	timestamp: number;
+}
+/**
+ * Socket event data
+ */
+export interface SocketEvent {
+	/** Event type */
+	type: "connect" | "close" | "drain" | "error" | "timeout" | "end";
+	/** Local address */
+	localAddress?: string;
+	/** Local port */
+	localPort?: number;
+	/** Remote address */
+	remoteAddress?: string;
+	/** Remote port */
+	remotePort?: number;
+	/** Bytes written */
+	bytesWritten?: number;
+	/** Bytes read */
+	bytesRead?: number;
+	/** Error if applicable */
+	error?: Error;
+	/** Timestamp */
+	timestamp: number;
+}
+/**
+ * Timeout event data
+ */
+export interface TimeoutEvent {
+	/** Type of timeout */
+	type: "connect" | "request" | "response" | "socket" | "lookup";
+	/** Configured timeout value in milliseconds */
+	timeout: number;
+	/** Elapsed time before timeout in milliseconds */
+	elapsed: number;
+	/** URL being requested */
+	url: string;
+	/** Timestamp when timeout occurred */
+	timestamp: number;
+}
+/**
+ * Abort event data
+ */
+export interface AbortEvent {
+	/** Reason for abort */
+	reason: "user" | "timeout" | "signal" | "error";
+	/** Abort message */
+	message?: string;
+	/** URL being requested */
+	url: string;
+	/** Elapsed time before abort in milliseconds */
+	elapsed: number;
+	/** Timestamp when abort occurred */
+	timestamp: number;
+}
+/**
+ * Headers received event data (before body)
+ */
+export interface HeadersReceivedEvent {
+	/** HTTP status code */
+	status: number;
+	/** HTTP status text */
+	statusText: string;
+	/** Response headers */
+	headers: RezoHeaders;
+	/** Content-Type header */
+	contentType?: string;
+	/** Content-Length header */
+	contentLength?: number;
+	/** Time to first byte in milliseconds */
+	ttfb: number;
+	/** Timestamp */
+	timestamp: number;
+}
+/**
+ * Parse complete event data
+ */
+export interface ParseCompleteEvent<T = any> {
+	/** Parsed data */
+	data: T;
+	/** Original raw data before parsing */
+	rawData: string | Buffer;
+	/** Content-Type that triggered parsing */
+	contentType: string;
+	/** Parse duration in milliseconds */
+	parseDuration: number;
+	/** Timestamp */
+	timestamp: number;
+}
+/**
+ * Cache event data
+ */
+export interface CacheEvent {
+	/** HTTP status code */
+	status: number;
+	/** Response headers */
+	headers: RezoHeaders;
+	/** URL being cached */
+	url: string;
+	/** Cache key if applicable */
+	cacheKey?: string;
+	/** Whether response is cacheable by default */
+	isCacheable: boolean;
+	/** Cache-Control header parsed */
+	cacheControl?: {
+		maxAge?: number;
+		sMaxAge?: number;
+		noCache?: boolean;
+		noStore?: boolean;
+		mustRevalidate?: boolean;
+		private?: boolean;
+		public?: boolean;
+	};
+}
+/**
+ * Cookie event data
+ */
+export interface CookieEvent {
+	/** Cookie being set/processed */
+	cookie: Cookie;
+	/** Source of cookie (response header, manual set, etc.) */
+	source: "response" | "request" | "manual";
+	/** URL context */
+	url: string;
+	/** Whether cookie is valid */
+	isValid: boolean;
+	/** Validation errors if any */
+	validationErrors?: string[];
+}
+/**
+ * Hook called during options initialization
+ * Use to normalize or validate request options
+ * Must be synchronous
+ */
+export type InitHook = (plainOptions: Partial<RezoRequestConfig>, options: RezoRequestConfig) => void;
+/**
+ * Hook called before request is sent
+ * Use to modify config, add headers, sign requests
+ * Can return early with a Response to bypass actual request
+ */
+export type BeforeRequestHook = (config: RezoConfig, context: BeforeRequestContext) => void | Response | Promise<void | Response>;
+/**
+ * Hook called before following a redirect
+ * Use to inspect/modify redirect behavior
+ */
+export type BeforeRedirectHook = (config: RezoConfig, response: RezoResponse) => void | Promise<void>;
+/**
+ * Hook called before a retry attempt
+ * Use for custom backoff logic, logging
+ */
+export type BeforeRetryHook = (config: RezoConfig, error: RezoError, retryCount: number) => void | Promise<void>;
+/**
+ * Hook called after response is received
+ * Use to transform response, refresh tokens
+ * Can trigger retry via context.retryWithMergedOptions
+ * Return modified response or original
+ */
+export type AfterResponseHook<T = any> = (response: RezoResponse<T>, config: RezoConfig, context: AfterResponseContext) => RezoResponse<T> | Promise<RezoResponse<T>>;
+/**
+ * Hook called before error is thrown
+ * Use to transform errors, add context
+ * Can return custom Error subclasses
+ */
+export type BeforeErrorHook = (error: RezoError | Error) => RezoError | Error | Promise<RezoError | Error>;
+/**
+ * Hook called before caching a response
+ * Return false to prevent caching
+ * Can modify response headers to affect caching behavior
+ */
+export type BeforeCacheHook = (event: CacheEvent) => boolean | void;
+/**
+ * Hook called when response headers are received (before body)
+ * Use to inspect headers, abort early, prepare for response
+ */
+export type AfterHeadersHook = (event: HeadersReceivedEvent, config: RezoConfig) => void | Promise<void>;
+/**
+ * Hook called after response body is parsed
+ * Use to transform parsed data, validate response
+ */
+export type AfterParseHook<T = any> = (event: ParseCompleteEvent<T>, config: RezoConfig) => T | Promise<T>;
+/**
+ * Hook called before a cookie is set
+ * Return false to reject the cookie
+ * Can modify cookie properties
+ */
+export type BeforeCookieHook = (event: CookieEvent, config: RezoConfig) => boolean | void | Promise<boolean | void>;
+/**
+ * Hook called after cookies are processed
+ * Use for cookie logging, analytics
+ */
+export type AfterCookieHook = (cookies: Cookie[], config: RezoConfig) => void | Promise<void>;
+/**
+ * Hook called on socket events
+ * Use for connection monitoring, metrics
+ */
+export type OnSocketHook = (event: SocketEvent, socket: Socket | TLSSocket) => void;
+/**
+ * Hook called when DNS lookup completes
+ * Use for DNS caching, logging, analytics
+ */
+export type OnDnsHook = (event: DnsLookupEvent, config: RezoConfig) => void;
+/**
+ * Hook called when TLS handshake completes
+ * Use for certificate validation, security logging
+ */
+export type OnTlsHook = (event: TlsHandshakeEvent, config: RezoConfig) => void;
+/**
+ * Hook called when timeout occurs
+ * Use for timeout logging, retry decisions
+ */
+export type OnTimeoutHook = (event: TimeoutEvent, config: RezoConfig) => void;
+/**
+ * Hook called when request is aborted
+ * Use for cleanup, logging
+ */
+export type OnAbortHook = (event: AbortEvent, config: RezoConfig) => void;
+/**
+ * Collection of all hook types
+ * All hooks are arrays to allow multiple handlers
+ */
+export interface RezoHooks {
+	init: InitHook[];
+	beforeRequest: BeforeRequestHook[];
+	beforeRedirect: BeforeRedirectHook[];
+	beforeRetry: BeforeRetryHook[];
+	afterResponse: AfterResponseHook[];
+	beforeError: BeforeErrorHook[];
+	beforeCache: BeforeCacheHook[];
+	afterHeaders: AfterHeadersHook[];
+	afterParse: AfterParseHook[];
+	beforeCookie: BeforeCookieHook[];
+	afterCookie: AfterCookieHook[];
+	onSocket: OnSocketHook[];
+	onDns: OnDnsHook[];
+	onTls: OnTlsHook[];
+	onTimeout: OnTimeoutHook[];
+	onAbort: OnAbortHook[];
+}
+/**
+ * Supported proxy protocols for network requests
+ */
+export type ProxyProtocol = "http" | "https" | "socks4" | "socks5";
+/**
+ * Configuration options for proxy connections
+ */
+export type ProxyOptions = {
+	/** The proxy protocol to use */
+	protocol: ProxyProtocol;
+	/** Proxy server hostname or IP address */
+	host: string;
+	/** Proxy server port number */
+	port: number;
+	/** Optional authentication credentials for the proxy */
+	auth?: {
+		/** Username for proxy authentication */
+		username: string;
+		/** Password for proxy authentication */
+		password: string;
+	};
+	/** Connection timeout in milliseconds */
+	timeout?: number;
+	/** Whether to keep the connection alive */
+	keepAlive?: boolean;
+	/** Keep-alive timeout in milliseconds */
+	keepAliveMsecs?: number;
+	/** Maximum number of sockets to allow per host */
+	maxSockets?: number;
+	/** Maximum number of free sockets to keep open per host */
+	maxFreeSockets?: number;
+	/** Whether to reject unauthorized SSL certificates */
+	rejectUnauthorized?: boolean;
+};
+/**
+ * Maximum upload rate in bytes per second
+ */
+export type MaxUploadRate = number;
+/**
+ * Maximum download rate in bytes per second
+ */
+export type MaxDownloadRate = number;
+/**
+ * Custom string type for Rezo-specific string values
+ */
+export type RezoString = string;
+/**
+ * Standard HTTP methods supported by Rezo
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "TRACE" | "CONNECT";
+type ResponseType$1 = "json" | "text" | "blob" | "arrayBuffer" | "buffer" | "auto";
+/**
+ * MIME content types for request/response bodies
+ */
+export type ContentType = "application/json" | "application/x-www-form-urlencoded" | "multipart/form-data" | "text/plain" | "text/html" | "application/xml" | "application/octet-stream" | RezoString;
+/**
+ * RezoRequestConfig - Clean interface for internal request processing
+ *
+ * @template D - Type of the request body data
+ */
+export interface RezoRequestConfig<D = any> {
+	/** The target URL for the request */
+	url: string | URL;
+	/**
+	 * The absolute request url
+	 */
+	fullUrl: string;
+	/** Request method to use for the request */
+	method: HttpMethod;
+	/** Request headers as various supported formats */
+	headers?: [
+		string,
+		string
+	][] | Record<string, string> | Headers | RezoHttpHeaders | RezoHeaders | OutgoingHttpHeaders;
+	/** URL query parameters to append to the request */
+	params?: Record<string | number, any>;
+	/**
+	 * Queue to use for request execution
+	 */
+	queue?: PQueue | null;
+	/**
+	 * Controls how the response body is parsed and returned in `response.data`.
+	 *
+	 * **Available Types:**
+	 * - `'json'` - Parse as JSON object/array. Best for REST APIs.
+	 * - `'text'` - Return as string. Best for HTML, XML, plain text.
+	 * - `'blob'` - Return as Blob (browser). Best for binary in browsers.
+	 * - `'arrayBuffer'` - Return as ArrayBuffer. Best for binary processing.
+	 * - `'buffer'` - Return as Buffer (Node.js). Best for binary in Node.
+	 * - `'auto'` - Auto-detect from Content-Type header (default).
+	 *
+	 * **For streaming, use dedicated methods instead:**
+	 * - `rezo.stream(url)` - Real-time streaming data
+	 * - `rezo.download(url, saveTo)` - Download with progress
+	 * - `rezo.upload(url, data)` - Upload with progress
+	 *
+	 * @default 'auto'
+	 * @example
+	 * // Get JSON
+	 * const { data } = await rezo.get('/api/users', { responseType: 'json' });
+	 *
+	 * // Get HTML as text
+	 * const { data: html } = await rezo.get('/page', { responseType: 'text' });
+	 *
+	 * // Get image as buffer
+	 * const { data: img } = await rezo.get('/image.png', { responseType: 'buffer' });
+	 */
+	responseType?: ResponseType$1;
+	/** Character encoding for the response */
+	responseEncoding?: string;
+	/** Base URL for the request (used with relative URLs) */
+	baseURL?: string;
+	/** Raw request body data */
+	body?: D;
+	/** JSON object to be serialized as request body */
+	json?: Record<string, any>;
+	/** Form data to be URL-encoded */
+	form?: Record<string, any>;
+	/** Form data for multipart/form-data requests */
+	formData?: Record<string, any> | RezoFormData;
+	/** Multipart data (alias for formData) */
+	multipart?: Record<string, any> | RezoFormData;
+	/** Whether to detect and prevent redirect cycles */
+	enableRedirectCycleDetection?: boolean;
+	/** MIME type for the request content */
+	contentType?: ContentType | string;
+	/** Skip setting Content-Type header automatically */
+	withoutContentType?: boolean;
+	/** Basic authentication credentials */
+	auth?: {
+		/** Username for authentication */
+		username: string;
+		/** Password for authentication */
+		password: string;
+	};
+	/** Request timeout in milliseconds */
+	timeout?: number;
+	/** Whether to reject requests with invalid SSL certificates */
+	rejectUnauthorized?: boolean;
+	/** Retry configuration for failed requests */
+	retry?: {
+		/** Maximum number of retry attempts */
+		maxRetries?: number;
+		/** Delay between retries in milliseconds */
+		retryDelay?: number;
+		/** Whether to increment delay on each retry */
+		incrementDelay?: boolean;
+		/** HTTP status codes that should trigger a retry attempt  defaults are (408, 429, 500, 502, 503, 504, 425, 520) */
+		statusCodes?: number[];
+		/** Weather to stop or continue retry when certain condition is met*/
+		condition?: (error: RezoError) => boolean | Promise<boolean>;
+	};
+	/** Whether to use a secure context for HTTPS requests */
+	useSecureContext?: boolean;
+	/** Custom secure context for TLS connections */
+	secureContext?: SecureContext;
+	/** Whether to automatically follow HTTP redirects */
+	followRedirects?: boolean;
+	/** Maximum number of redirects to follow */
+	maxRedirects?: number;
+	/** Whether to automatically decompress response data */
+	decompress?: boolean;
+	/** Whether to keep the connection alive for reuse */
+	keepAlive?: boolean;
+	withoutBodyOnRedirect?: boolean;
+	autoSetReferer?: boolean;
+	autoSetOrigin?: boolean;
+	treat302As303?: boolean;
+	startNewRequest?: boolean;
+	/** Whether to use HTTP/2 protocol */
+	http2?: boolean;
+	/** Whether to use cURL adapter */
+	curl?: boolean;
+	/**
+	 * DNS cache configuration for faster repeated requests.
+	 *
+	 * When enabled, DNS lookups are cached to avoid repeated DNS queries
+	 * for the same hostname, significantly improving performance for
+	 * applications making many requests to the same servers.
+	 *
+	 * **Options:**
+	 * - `true` - Enable with default settings (1 min TTL, 1000 entries max)
+	 * - `false` - Disable DNS caching (default)
+	 * - `object` - Custom configuration with ttl and maxEntries
+	 *
+	 * @example
+	 * // Enable with defaults
+	 * { dnsCache: true }
+	 *
+	 * // Custom TTL (5 minutes) and max entries
+	 * { dnsCache: { ttl: 300000, maxEntries: 500 } }
+	 *
+	 * @default false
+	 */
+	dnsCache?: boolean | {
+		/** Time-to-live for cached entries in milliseconds */
+		ttl?: number;
+		/** Maximum number of entries to cache */
+		maxEntries?: number;
+	};
+	/**
+	 * Response cache configuration for caching HTTP responses.
+	 *
+	 * When enabled, successful GET/HEAD responses are cached to avoid
+	 * repeated network requests. Supports memory-only or file persistence.
+	 * Honors Cache-Control headers by default.
+	 *
+	 * **Options:**
+	 * - `true` - Enable memory cache with defaults (5 min TTL, 500 entries)
+	 * - `false` - Disable response caching (default)
+	 * - `object` - Custom configuration
+	 *
+	 * **Cache-Control Support:**
+	 * - Respects `max-age`, `s-maxage`, `no-store`, `no-cache`
+	 * - Sends `If-None-Match` / `If-Modified-Since` for revalidation
+	 * - Returns cached response on 304 Not Modified
+	 *
+	 * @example
+	 * // Enable memory-only cache
+	 * { cache: true }
+	 *
+	 * // With file persistence
+	 * { cache: { cacheDir: './cache', ttl: 300000 } }
+	 *
+	 * // Custom settings
+	 * { cache: {
+	 *   ttl: 600000,           // 10 minutes
+	 *   maxEntries: 1000,
+	 *   methods: ['GET'],      // Only cache GET
+	 *   respectHeaders: true   // Honor Cache-Control
+	 * }}
+	 *
+	 * @default false
+	 */
+	cache?: boolean | {
+		/** Directory for persistent cache storage (enables file persistence) */
+		cacheDir?: string;
+		/** Time-to-live for cached entries in milliseconds */
+		ttl?: number;
+		/** Maximum number of entries to cache */
+		maxEntries?: number;
+		/** HTTP methods to cache */
+		methods?: string[];
+		/** Whether to respect Cache-Control headers */
+		respectHeaders?: boolean;
+	};
+	/**
+	 * Callback invoked when a redirect response is received.
+	 * Controls redirect behavior including whether to follow, modify URL, or change HTTP method.
+	 *
+	 * @param options - Redirect response details
+	 * @param options.url - Redirect target URL
+	 * @param options.status - HTTP status code
+	 * @param options.headers - Response headers
+	 * @param options.sameDomain - Whether redirect is to same domain
+	 * @returns Boolean to follow/reject redirect, or object for granular control
+	 *
+	 * @example
+	 * ```typescript
+	 * beforeRedirect: ({ status, url }) => {
+	 *   if (status === 301 || status === 302) {
+	 *     return true; // Follow permanent/temporary redirects
+	 *   } else if (status === 307 || status === 308) {
+	 *     return { redirect: true, url: url.toString() }; // Preserve method for 307/308
+	 *   } else if (status === 303) {
+	 *     return { redirect: true, url: url.toString(), method: 'GET' }; // Force GET for 303
+	 *   }
+	 *   return false; // Reject other redirects
+	 * }
+	 * ```
+	 */
+	beforeRedirect?: (options: OnRedirectOptions) => OnRedirectResponse;
+	/** Whether to send cookies and authorization headers with cross-origin requests */
+	withCredentials?: boolean;
+	/** Proxy configuration (URL string or detailed options) */
+	proxy?: string | ProxyOptions;
+	/** Whether to enable automatic cookie handling */
+	useCookies?: boolean;
+	/** Custom cookie jar for managing cookies */
+	cookieJar?: RezoCookieJar;
+	/** Cookies to send with the request in various formats */
+	cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
+	/** Callback for upload progress events */
+	onUploadProgress?: (progressEvent: any) => void;
+	/** Callback for download progress events */
+	onDownloadProgress?: (progressEvent: any) => void;
+	/** Maximum allowed size of the request body in bytes */
+	maxBodyLength?: number;
+	/** Maximum transfer rate (single number or [upload, download] tuple) */
+	maxRate?: number | [
+		MaxUploadRate,
+		MaxDownloadRate
+	];
+	/** Array of functions to transform request data */
+	transformRequest?: Array<(data: any, headers: RezoHeaders) => any>;
+	/** Array of functions to transform response data */
+	transformResponse?: Array<(data: any) => any>;
+	/** Adapter to use for the request (name or custom function) */
+	adapter?: string | ((config: RezoRequestConfig) => Promise<any>);
+	/** AbortSignal to cancel the request */
+	signal?: AbortSignal;
+	/** File path to save the response to (for downloads) */
+	saveTo?: string;
+	/** Custom filename for downloaded files */
+	fileName?: string;
+	/** Browser simulation configuration for user agent spoofing */
+	browser?: {
+		/** Browser name to simulate */
+		name: "chrome" | "firefox" | "safari" | "edge" | "opera" | "ie" | "chromium";
+		/** Browser version string */
+		version: string;
+		/** Device platform type */
+		platform: "desktop" | "mobile" | "tablet";
+		/** Operating system details */
+		os: {
+			/** Operating system name */
+			name: "windows" | "macos" | "linux" | "ios" | "android" | "chromeos";
+			/** OS version string */
+			version: string;
+			/** CPU architecture */
+			architecture: "x86" | "x64" | "arm" | "arm64";
+		};
+		/** Browser language preference */
+		language?: string;
+	};
+	/** Enable debug logging for the request */
+	debug?: boolean;
+	/** Enable verbose logging with detailed information */
+	verbose?: boolean;
+	/** Name of the cookie containing XSRF token */
+	xsrfCookieName?: string;
+	/** Name of the header to send XSRF token in */
+	xsrfHeaderName?: string;
+	/** Custom HTTP agent for HTTP requests */
+	httpAgent?: HttpAgent;
+	/** Custom HTTPS agent for HTTPS requests */
+	httpsAgent?: HttpsAgent;
+	/** Transitional options for backward compatibility */
+	transitional?: {
+		/** Silently ignore JSON parsing errors */
+		silentJSONParsing?: boolean;
+		/** Force JSON parsing even for non-JSON responses */
+		forcedJSONParsing?: boolean;
+		/** Provide clearer timeout error messages */
+		clarifyTimeoutError?: boolean;
+	};
+	/** Character encoding for request body and response data */
+	encoding?: BufferEncoding;
+	/**
+	 * Request lifecycle hooks for intercepting and modifying request/response behavior.
+	 * Optional hooks that will be merged with default hooks during request processing.
+	 */
+	hooks?: Partial<RezoHooks>;
+}
+export interface OnRedirectOptions {
+	url: URL;
+	status: number;
+	headers: RezoHeaders;
+	sameDomain: boolean;
+	method: string;
+}
+export type OnRedirectResponse = boolean | ToRedirectOptions | undefined;
+export type ToRedirectOptions = {
+	redirect: false;
+	message?: string;
+} | {
+	redirect: true;
+	url: string;
+	method?: "POST" | "GET" | "PUT" | "DELETE" | "PATCH" | "OPTIONS";
+	body?: any;
+	withoutBody?: boolean;
+	setHeaders?: RezoHeaders | OutgoingHttpHeaders;
+	setHeadersOnRedirects?: RezoHeaders | OutgoingHttpHeaders;
+};
+/**
+ * RezoHttpRequest - Request configuration type for all methods
+ *
+ * This type excludes internal properties and is specifically designed for public API usage.
+ * Use this type when creating reusable request configurations for the all method.
+ *
+ * @public - Use with all methods
+ * @internal - Do not use internally within the library
+ */
+export type RezoHttpRequest = Omit<RezoRequestConfig, "body" | "url" | "method" | "form" | "json" | "formData" | "multipart" | "fullUrl" | "responseType">;
+/**
+ * Configuration object that encapsulates comprehensive request execution metadata and response processing information.
+ * This interface serves as the central configuration hub for HTTP requests, containing both input parameters
+ * and execution tracking data throughout the request lifecycle.
+ *
+ * @interface RezoConfig
+ * @since 1.0.0
+ * @example
+ * ```typescript
+ * const config: RezoConfig = {
+ *   originalRequest: requestConfig,
+ *   finalUrl: 'https://api.example.com/data',
+ *   adapterUsed: 'fetch',
+ *   timing: { startTime: Date.now(), endTime: Date.now() + 1000, total: 1000 },
+ *   network: { protocol: 'https' },
+ *   transfer: { requestSize: 256, responseSize: 1024, headerSize: 128, bodySize: 896 },
+ *   retryAttempts: 0,
+ *   errors: [],
+ *   security: {},
+ *   metadata: {}
+ * };
+ * ```
+ */
+export interface RezoConfig {
+	/** @description The target URL for the HTTP request */
+	url: string;
+	/** @description HTTP method (GET, POST, PUT, DELETE, etc.) */
+	method: RezoRequestConfig["method"];
+	/** @description HTTP headers to be sent with the request */
+	headers: RezoHeaders;
+	/** @description Request payload data (null when not set) */
+	data?: RezoRequestConfig["body"] | null;
+	/** @description URL query parameters */
+	params?: RezoRequestConfig["params"];
+	/** @description Request timeout in milliseconds (null when not set) */
+	timeout?: number | null;
+	/** @description Expected response data type */
+	responseType?: "json" | "text" | "blob" | "arrayBuffer" | "stream" | "download" | "upload" | "buffer" | "binary";
+	/** @description Basic authentication credentials (null when not set) */
+	auth?: RezoRequestConfig["auth"] | null;
+	/** @description Proxy configuration (null when not set) */
+	proxy?: RezoRequestConfig["proxy"] | null;
+	/** @description Maximum number of redirects to follow */
+	maxRedirects: number;
+	/** @description Base URL for relative requests */
+	baseURL?: string;
+	/** @description Enable HTTP/2 protocol */
+	http2: boolean;
+	/** @description Enable cURL command generation */
+	curl: boolean;
+	/** @description Enable detection of redirect cycles */
+	enableRedirectCycleDetection?: boolean;
+	/** @description Reject unauthorized SSL certificates */
+	rejectUnauthorized?: boolean;
+	/** @description Retry configuration */
+	retry?: RezoRequestConfig["retry"];
+	/** @description Compression settings */
+	compression?: {
+		/** @description Enable compression */
+		enabled?: boolean;
+		/** @description Compression threshold in bytes */
+		threshold?: number;
+		/** @description Supported compression algorithms */
+		algorithms?: string[];
+	};
+	/** @description Enable cookie jar for session management */
+	enableCookieJar?: boolean;
+	/** @description Feature flags for adapter capabilities */
+	features?: {
+		/** @description HTTP/2 support */
+		http2?: boolean;
+		/** @description Compression support */
+		compression?: boolean;
+		/** @description Cookie support */
+		cookies?: boolean;
+		/** @description Redirect support */
+		redirects?: boolean;
+		/** @description Proxy support */
+		proxy?: boolean;
+		/** @description Timeout support */
+		timeout?: boolean;
+		/** @description Retry support */
+		retry?: boolean;
+		/** @description Cache support */
+		cache?: boolean;
+		/** @description Metrics support */
+		metrics?: boolean;
+		/** @description Event support */
+		events?: boolean;
+		/** @description Validation support */
+		validation?: boolean;
+		/** @description Browser support */
+		browser?: boolean;
+		/** @description SSL support */
+		ssl?: boolean;
+	};
+	/** @description Use insecure HTTP parser */
+	insecureHTTPParser: boolean;
+	/** @description Custom adapter implementation */
+	adapter?: any;
+	isSecure?: boolean;
+	/**
+	 * @description Rate limiting for network transfer speed (bandwidth throttling)
+	 *
+	 * Controls the maximum transfer speed in bytes per second.
+	 *
+	 * - `number`: Applies same limit to both download and upload (e.g., 1024000 = ~1MB/s)
+	 * - `[download, upload]`: Different limits for each direction (e.g., [5242880, 1048576] = 5MB/s down, 1MB/s up)
+	 * - `0` or `null`: No rate limiting (unlimited speed)
+	 *
+	 * Common values:
+	 * - 1048576 = 1 MB/s
+	 * - 5242880 = 5 MB/s
+	 * - 10485760 = 10 MB/s
+	 *
+	 * Note: Actual transfer speed may vary based on network conditions and adapter support.
+	 * This feature is adapter-dependent (HTTP adapter supports it, other adapters may vary).
+	 */
+	maxRate: number | [
+		number,
+		number
+	];
+	/** @description Cancellation token for request abortion (null when not set) */
+	cancelToken?: any | null;
+	/** @description AbortSignal for request cancellation (null when not set) */
+	signal?: AbortSignal | null;
+	/** @description Function to set the AbortSignal */
+	setSignal: () => void;
+	/** @description HTTP agent for connection pooling (null when not set) */
+	httpAgent?: RezoRequestConfig["httpAgent"] | null;
+	/** @description HTTPS agent for secure connection pooling (null when not set) */
+	httpsAgent?: RezoRequestConfig["httpsAgent"] | null;
+	/** @description Unix socket path (null when not set) */
+	socketPath?: string | null;
+	/** @description File path to save the response (null when not set) */
+	fileName?: string | null;
+	/**
+	 * Array of cookies to be sent with the request.
+	 * These cookies are configured before the request is made and will be included in the request headers.
+	 */
+	requestCookies: Cookie[];
+	/**
+	 * Cookies received from the server in the response.
+	 * These cookies are parsed from the 'Set-Cookie' response headers and can be used for subsequent requests
+	 * or session management. Contains multiple formats: array, serialized, netscape, string, setCookiesString.
+	 */
+	responseCookies: Cookies;
+	/**
+	 * Path to cookie file for persistence (null when not configured).
+	 * - .json files save cookies as serialized JSON
+	 * - .txt files save cookies in Netscape format
+	 */
+	cookieFile?: string | null;
+	/**
+	 * Request lifecycle hooks for intercepting and modifying request/response behavior.
+	 * null when no hooks are registered, otherwise contains only hooks with registered functions.
+	 * Empty arrays are not included - only hooks with actual handlers appear.
+	 *
+	 * Available hooks:
+	 * - init: During options initialization
+	 * - beforeRequest: Before request is sent
+	 * - beforeRedirect: Before following redirects
+	 * - beforeRetry: Before retry attempts
+	 * - afterResponse: After response is received
+	 * - beforeError: Before error is thrown
+	 * - beforeCache: Before caching response
+	 * - afterHeaders: When headers are received
+	 * - afterParse: After body is parsed
+	 * - beforeCookie/afterCookie: Cookie lifecycle
+	 * - onSocket/onDns/onTls/onTimeout/onAbort: Low-level events
+	 */
+	hooks: Partial<RezoHooks> | null;
+	/** @description Snapshot of the original request configuration */
+	originalRequest: RezoRequestConfig;
+	/** @description Final resolved URL after redirects and processing */
+	finalUrl: string;
+	/** @description HTTP adapter used for the request */
+	adapterUsed: "http" | "https" | "http2" | "fetch" | "xhr" | "curl";
+	/** @description Metadata about the adapter used */
+	adapterMetadata?: {
+		/** @description Adapter version */
+		version?: string;
+		/** @description Supported features */
+		features?: string[];
+		/** @description Adapter capabilities */
+		capabilities?: Record<string, any>;
+	};
+	/** @description Complete redirect chain history */
+	redirectHistory: {
+		/** @description Cookies set in this redirect */
+		cookies: Cookie[];
+		/** @description Redirect URL */
+		url: string;
+		/** @description HTTP status code */
+		statusCode: number;
+		/** @description HTTP status text */
+		statusText: string;
+		/** @description Response headers */
+		headers: RezoHeaders;
+		/** @description Redirect timestamp */
+		duration: number;
+		/** @description Request configuration at this step */
+		request: RezoRequestConfig;
+		/** @description HTTP method used */
+		method: string;
+	}[];
+	/** @description Number of redirects followed */
+	redirectCount: number;
+	/** @description Whether maximum redirects limit was reached */
+	maxRedirectsReached: boolean;
+	/**
+	 * @description Cookie jar instance for session management
+	 * Full RezoCookieJar class with all methods available:
+	 * - cookies(): Get all cookies in the jar
+	 * - setCookiesSync(cookies, url): Set cookies from Set-Cookie headers
+	 * - getCookiesSync(url): Get cookies for a URL
+	 * - removeAllCookiesSync(): Clear all cookies
+	 */
+	cookieJar: RezoCookieJar;
+	/** @description Comprehensive timing information */
+	timing: {
+		/** @description Request start timestamp (absolute performance.now() value) */
+		startTimestamp: number;
+		/** @description Request end timestamp (absolute performance.now() value) */
+		endTimestamp: number;
+		/** @description DNS lookup duration in milliseconds */
+		dnsMs?: number;
+		/** @description TCP connection duration in milliseconds */
+		tcpMs?: number;
+		/** @description TLS handshake duration in milliseconds */
+		tlsMs?: number;
+		/** @description Time to first byte in milliseconds (from start to first response byte) */
+		ttfbMs?: number;
+		/** @description Content transfer duration in milliseconds */
+		transferMs?: number;
+		/** @description Total request duration in milliseconds (endTimestamp - startTimestamp) */
+		durationMs: number;
+	};
+	/** @description Network connection information */
+	network: {
+		/** @description Local IP address */
+		localAddress?: string;
+		/** @description Local port number */
+		localPort?: number;
+		/** @description Remote IP address */
+		remoteAddress?: string;
+		/** @description Remote port number */
+		remotePort?: number;
+		/** @description Protocol used (http/https) */
+		protocol: string;
+		/** @description HTTP version (1.1, 2.0, etc.) */
+		httpVersion?: string;
+		/** @description IP family preference (4 for IPv4, 6 for IPv6) */
+		family?: 4 | 6;
+		/** @description Custom DNS lookup function */
+		lookup?: any;
+	};
+	/** @description Data transfer statistics */
+	transfer: {
+		/** @description Total request size in bytes (headers + body) */
+		requestSize: number;
+		/** @description Request headers size in bytes */
+		requestHeaderSize?: number;
+		/** @description Request body size in bytes */
+		requestBodySize?: number;
+		/** @description Total response size in bytes (headers + body) */
+		responseSize: number;
+		/** @description Response headers size in bytes */
+		headerSize: number;
+		/** @description Response body size in bytes */
+		bodySize: number;
+		/** @description Compression ratio if applicable */
+		compressionRatio?: number;
+	};
+	/** @description Number of retry attempts made */
+	retryAttempts: number;
+	/** @description Error history during request execution */
+	errors: Array<{
+		/** @description Retry attempt number */
+		attempt: number;
+		/** @description Error message */
+		error: RezoError;
+		/** @description Request duration before error */
+		duration: number;
+	}>;
+	/** @description Security and validation information */
+	security: {
+		/** @description TLS version used */
+		tlsVersion?: string;
+		/** @description Cipher suite used */
+		cipher?: string;
+		/** @description Certificate information */
+		certificateInfo?: Record<string, any>;
+		/** @description Validation results */
+		validationResults?: Record<string, boolean>;
+	};
+	/** @description Debug mode flag */
+	debug?: boolean;
+	/** @description Request tracking identifier */
+	requestId: string;
+	/** @description Session identifier */
+	sessionId?: string;
+	/** @description Distributed tracing identifier */
+	traceId?: string;
+	/** @description Request timestamp */
+	timestamp: number;
+	/** @description Additional tracking data */
+	trackingData?: Record<string, unknown>;
+	/**
+	 * Callback invoked when a redirect response is received.
+	 * Controls redirect behavior including whether to follow, modify URL, or change HTTP method.
+	 *
+	 * @param options - Redirect response details
+	 * @param options.url - Redirect target URL
+	 * @param options.status - HTTP status code
+	 * @param options.headers - Response headers
+	 * @param options.sameDomain - Whether redirect is to same domain
+	 * @returns Boolean to follow/reject redirect, or object for granular control
+	 *
+	 * @example
+	 * ```typescript
+	 * beforeRedirect: ({ status, url }) => {
+	 *   if (status === 301 || status === 302) {
+	 *     return true; // Follow permanent/temporary redirects
+	 *   } else if (status === 307 || status === 308) {
+	 *     return { redirect: true, url: url.toString() }; // Preserve method for 307/308
+	 *   } else if (status === 303) {
+	 *     return { redirect: true, url: url.toString(), method: 'GET' }; // Force GET for 303
+	 *   }
+	 *   return false; // Reject other redirects
+	 * }
+	 * ```
+	 */
+	beforeRedirect?: RezoRequestConfig["beforeRedirect"];
+	/** Character encoding for request body and response data */
+	encoding?: BufferEncoding;
+	/**
+	 * Whether to use cookies for the request
+	 */
+	useCookies: boolean;
+}
+export interface DNSCacheOptions {
+	enable?: boolean;
+	ttl?: number;
+	maxEntries?: number;
+}
+export interface ResponseCacheConfig {
+	enable?: boolean;
+	cacheDir?: string;
+	networkCheck?: boolean;
+	ttl?: number;
+	maxEntries?: number;
+	methods?: string[];
+	respectHeaders?: boolean;
+}
+export type queueOptions = Options$1<PriorityQueue, QueueAddOptions>;
+export interface CacheConfig {
+	/** Response cache configuration */
+	response?: boolean | ResponseCacheConfig;
+	/** DNS cache configuration */
+	dns?: boolean | DNSCacheOptions;
+}
+export type CacheOption = boolean | CacheConfig;
+export interface RezoDefaultOptions {
+	baseURL?: string;
+	/** Hooks for request/response lifecycle */
+	hooks?: Partial<RezoHooks>;
+	/** Whether to enable automatic cookie handling (default: true)*/
+	enableCookieJar?: boolean;
+	/** Custom cookie jar for managing cookies */
+	cookieJar?: RezoHttpRequest["cookieJar"];
+	/** Set default cookies to send with the requests in various formats */
+	cookies?: RezoHttpRequest["cookies"];
+	/**
+	 * Path to cookie file for persistence.
+	 * - .json files save cookies as serialized JSON
+	 * - .txt files save cookies in Netscape format
+	 * Cookies are loaded on construction and saved automatically after each request.
+	 */
+	cookieFile?: string;
+	queueOptions?: {
+		enable: boolean;
+		options?: queueOptions;
+	};
+	/** Request headers as various supported formats */
+	headers?: RezoHttpRequest["headers"];
+	/** Expected response data type */
+	responseType?: ResponseType$1;
+	/** Character encoding for the response */
+	responseEncoding?: string;
+	/** Basic authentication credentials */
+	auth?: RezoHttpRequest["auth"];
+	/** Request timeout in milliseconds */
+	timeout?: number;
+	/** @deprecated Use `timeout` instead */
+	requestTimeout?: number;
+	/** Whether to reject requests with invalid SSL certificates */
+	rejectUnauthorized?: boolean;
+	/** Retry configuration for failed requests */
+	retry?: RezoHttpRequest["retry"];
+	/** Whether to use a secure context for HTTPS requests */
+	useSecureContext?: boolean;
+	/** Custom secure context for TLS connections */
+	secureContext?: RezoHttpRequest["secureContext"];
+	/** Whether to automatically follow HTTP redirects */
+	followRedirects?: boolean;
+	/** Maximum number of redirects to follow */
+	maxRedirects?: number;
+	/** Whether to automatically decompress response data */
+	decompress?: boolean;
+	/** Whether to keep the connection alive for reuse */
+	keepAlive?: boolean;
+	/** Whether to detect and prevent redirect cycles */
+	enableRedirectCycleDetection?: boolean;
+	/** Whether to use HTTP/2 protocol */
+	http2?: boolean;
+	/** Whether to use cURL adapter */
+	curl?: boolean;
+	/** Whether to send cookies and authorization headers with cross-origin requests */
+	withCredentials?: boolean;
+	/** Proxy configuration (URL string or detailed options) */
+	proxy?: RezoHttpRequest["proxy"];
+	/** Maximum allowed size of the request body in bytes */
+	maxBodyLength?: number;
+	/** Maximum transfer rate (single number or [upload, download] tuple) */
+	maxRate?: RezoHttpRequest["maxRate"];
+	/**
+   * Callback invoked when a redirect response is received.
+   * Controls redirect behavior including whether to follow, modify URL, or change HTTP method.
+   *
+   * @param options - Redirect response details
+   * @param options.url - Redirect target URL
+   * @param options.status - HTTP status code
+   * @param options.headers - Response headers
+   * @param options.sameDomain - Whether redirect is to same domain
+   * @returns Boolean to follow/reject redirect, or object for granular control
+   *
+   * @example
+   * ```typescript
+   * beforeRedirect: ({ status, url }) => {
+   *   if (status === 301 || status === 302) {
+   *     return true; // Follow permanent/temporary redirects
+   *   } else if (status === 307 || status === 308) {
+   *     return { redirect: true, url: url.toString() }; // Preserve method for 307/308
+   *   } else if (status === 303) {
+   *     return { redirect: true, url: url.toString(), method: 'GET' }; // Force GET for 303
+   *   }
+   *   return false; // Reject other redirects
+   * }
+   * ```
+   */
+	beforeRedirect?: RezoHttpRequest["beforeRedirect"];
+	/** Array of functions to transform request data */
+	transformRequest?: RezoHttpRequest["transformRequest"];
+	/** Array of functions to transform response data */
+	transformResponse?: RezoHttpRequest["transformResponse"];
+	/** Adapter to use for the request (name or custom function) */
+	adapter?: RezoHttpRequest["adapter"];
+	/** Browser simulation configuration for user agent spoofing */
+	browser?: RezoHttpRequest["browser"];
+	/** Enable debug logging for the request */
+	debug?: RezoHttpRequest["debug"];
+	/** Enable verbose logging with detailed information */
+	verbose?: RezoHttpRequest["verbose"];
+	/** HTTP agent for HTTP requests */
+	httpAgent?: RezoHttpRequest["httpAgent"];
+	/** HTTPS agent for HTTPS requests */
+	httpsAgent?: RezoHttpRequest["httpsAgent"];
+	/** Transitional options for backward compatibility */
+	transitional?: RezoHttpRequest["transitional"];
+	/** Character encoding for request body and response data */
+	encoding?: BufferEncoding;
+	/**
+	 * Cache configuration for response and DNS caching
+	 * - `true`: Enable default in-memory cache (fast, sensible defaults)
+	 * - `{ response: {...}, dns: {...} }`: Fine-grained control
+	 *
+	 * Response cache defaults: 30 min TTL, 500 entries, GET/HEAD only
+	 * DNS cache defaults: 1 min TTL, 1000 entries
+	 */
+	cache?: CacheOption;
+}
+/**
+ * Execute cURL request - main adapter entry point
+ * Follows the same pattern as http.ts executeRequest
+ */
+declare function executeRequest<T = any>(options: RezoRequestConfig, defaultOptions: RezoDefaultOptions, jar: RezoCookieJar): Promise<RezoResponse<T> | RezoStreamResponse | RezoDownloadResponse | RezoUploadResponse>;
+/**
+ * Execute HTTP request using Node.js http/https modules
+ */
+declare function executeRequest$1<T = any>(options: RezoRequestConfig, defaultOptions: RezoDefaultOptions, jar: RezoCookieJar): Promise<RezoResponse<T> | RezoStreamResponse | RezoDownloadResponse | RezoUploadResponse>;
+/**
+ * Unified adapter execution function type.
+ * All adapters implement this signature for consistent behavior.
+ */
+export type ExecuteRequestFn<T = any> = (options: RezoRequestConfig, defaultOptions: RezoDefaultOptions, jar: RezoCookieJar) => Promise<RezoResponse<T> | RezoStreamResponse | RezoDownloadResponse | RezoUploadResponse>;
+
+export {
+	executeRequest as executeCurlRequest,
+	executeRequest$1 as executeHttpRequest,
+};
+
+export {};