rezo 1.0.5 → 1.0.7

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

@@ -6,9 +6,6 @@ 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 RezoHttpHeaders {
@@ -972,8 +969,17 @@ export interface ProxyCooldownConfig {
  * Complete configuration for proxy rotation, filtering, and failure handling
  */
 export interface ProxyManagerBaseConfig {
-	/** Array of proxies to manage */
-	proxies: ProxyInfo[];
+	/**
+	 * Array of proxies to manage
+	 * Accepts ProxyInfo objects or proxy URL strings (parsed via parseProxyString)
+	 * @example
+	 * proxies: [
+	 *   { protocol: 'http', host: '127.0.0.1', port: 8080 },
+	 *   'socks5://user:pass@proxy.example.com:1080',
+	 *   'http://proxy.example.com:3128'
+	 * ]
+	 */
+	proxies: (ProxyInfo | string)[];
 	/**
 	 * Whitelist patterns for URLs that should use proxy
 	 * - String: exact domain match (e.g., 'api.example.com') or subdomain match (e.g., 'example.com' matches '*.example.com')
@@ -1185,6 +1191,35 @@ export interface AfterProxyEnableContext {
 	/** Reason for enabling */
 	reason: "cooldown-expired" | "manual";
 }
+/**
+ * Context for onNoProxiesAvailable hook
+ * Triggered when no proxies are available and an error would be thrown
+ */
+export interface OnNoProxiesAvailableContext {
+	/** Request URL that needed a proxy */
+	url: string;
+	/** The error that will be thrown */
+	error: Error;
+	/** All proxies (including disabled ones) */
+	allProxies: ProxyState[];
+	/** Number of active proxies (should be 0) */
+	activeCount: number;
+	/** Number of disabled proxies */
+	disabledCount: number;
+	/** Number of proxies in cooldown */
+	cooldownCount: number;
+	/** Reasons why proxies are unavailable */
+	disabledReasons: {
+		/** Proxies disabled due to failures */
+		dead: number;
+		/** Proxies disabled due to request limit */
+		limitReached: number;
+		/** Proxies manually disabled */
+		manual: number;
+	};
+	/** Timestamp when this event occurred */
+	timestamp: number;
+}
 /**
  * Context provided to beforeRequest hook
  * Contains metadata about the current request state
@@ -1503,6 +1538,16 @@ export type AfterProxyRotateHook = (context: AfterProxyRotateContext) => void |
  * Use for notifications, logging
  */
 export type AfterProxyEnableHook = (context: AfterProxyEnableContext) => void | Promise<void>;
+/**
+ * Hook called when no proxies are available and an error is about to be thrown
+ * Use for alerting, logging exhausted proxy pools, or triggering proxy refresh
+ * This hook is called just before the error is thrown, allowing you to:
+ * - Log the exhaustion event for monitoring
+ * - Trigger external proxy pool refresh
+ * - Send alerts to monitoring systems
+ * - Record statistics about proxy pool health
+ */
+export type OnNoProxiesAvailableHook = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Collection of all hook types
  * All hooks are arrays to allow multiple handlers
@@ -1527,6 +1572,7 @@ export interface RezoHooks {
 	afterProxyDisable: AfterProxyDisableHook[];
 	afterProxyRotate: AfterProxyRotateHook[];
 	afterProxyEnable: AfterProxyEnableHook[];
+	onNoProxiesAvailable: OnNoProxiesAvailableHook[];
 	onSocket: OnSocketHook[];
 	onDns: OnDnsHook[];
 	onTls: OnTlsHook[];
@@ -1983,6 +2029,275 @@ export declare class RezoError<T = any> extends Error {
 	toString(): string;
 	getFullDetails(): string;
 }
+/**
+ * Queue configuration options
+ */
+export interface QueueConfig {
+	/** Maximum concurrent tasks (default: Infinity) */
+	concurrency?: number;
+	/** Auto-start processing when tasks are added (default: true) */
+	autoStart?: boolean;
+	/** Timeout per task in milliseconds (default: none) */
+	timeout?: number;
+	/** Throw on timeout vs silently fail (default: true) */
+	throwOnTimeout?: boolean;
+	/** Interval between task starts in ms for rate limiting */
+	interval?: number;
+	/** Max tasks to start per interval (default: Infinity) */
+	intervalCap?: number;
+	/** Carry over unused interval capacity to next interval */
+	carryoverConcurrencyCount?: boolean;
+}
+/**
+ * Task options when adding to queue
+ */
+export interface TaskOptions {
+	/** Task priority (higher runs first, default: 0) */
+	priority?: number;
+	/** Task-specific timeout (overrides queue default) */
+	timeout?: number;
+	/** Unique ID for tracking/cancellation */
+	id?: string;
+	/** Signal for external cancellation */
+	signal?: AbortSignal;
+}
+/**
+ * Current queue state
+ */
+export interface QueueState {
+	/** Number of tasks currently running */
+	pending: number;
+	/** Number of tasks waiting in queue */
+	size: number;
+	/** Total tasks (pending + size) */
+	total: number;
+	/** Is queue paused */
+	isPaused: boolean;
+	/** Is queue idle (no tasks) */
+	isIdle: boolean;
+}
+/**
+ * Queue statistics
+ */
+export interface QueueStats {
+	/** Total tasks added since creation */
+	added: number;
+	/** Total tasks processed (started) */
+	processed: number;
+	/** Total successful completions */
+	completed: number;
+	/** Total failures */
+	failed: number;
+	/** Total timeouts */
+	timedOut: number;
+	/** Total cancellations */
+	cancelled: number;
+	/** Average task duration (ms) */
+	averageDuration: number;
+	/** Tasks per second (rolling average) */
+	throughput: number;
+}
+/**
+ * Queue event types
+ */
+export interface QueueEvents {
+	/** Task added to queue */
+	add: {
+		id: string;
+		priority: number;
+	};
+	/** Task started executing */
+	start: {
+		id: string;
+	};
+	/** Task completed successfully */
+	completed: {
+		id: string;
+		result: any;
+		duration: number;
+	};
+	/** Task failed with error */
+	error: {
+		id: string;
+		error: Error;
+	};
+	/** Task timed out */
+	timeout: {
+		id: string;
+	};
+	/** Task cancelled */
+	cancelled: {
+		id: string;
+	};
+	/** Queue became active (was idle, now processing) */
+	active: undefined;
+	/** Queue became idle (all tasks done) */
+	idle: undefined;
+	/** Queue was paused */
+	paused: undefined;
+	/** Queue was resumed */
+	resumed: undefined;
+	/** Next task about to run */
+	next: undefined;
+	/** Queue was emptied (no pending tasks) */
+	empty: undefined;
+}
+/**
+ * Event handler type
+ */
+export type EventHandler<T> = (data: T) => void;
+/**
+ * Task function type
+ */
+export type TaskFunction<T> = () => Promise<T>;
+declare class RezoQueue<T = any> {
+	private queue;
+	private pendingCount;
+	private isPausedFlag;
+	private intervalId?;
+	private intervalCount;
+	private intervalStart;
+	private eventHandlers;
+	private statsData;
+	private totalDuration;
+	private throughputWindow;
+	private readonly throughputWindowSize;
+	private idlePromise?;
+	private emptyPromise?;
+	readonly config: Required<QueueConfig>;
+	/**
+	 * Create a new RezoQueue
+	 * @param config - Queue configuration options
+	 */
+	constructor(config?: QueueConfig);
+	/**
+	 * Get current queue state
+	 */
+	get state(): QueueState;
+	/**
+	 * Get queue statistics
+	 */
+	get stats(): QueueStats;
+	/**
+	 * Get/set concurrency limit
+	 */
+	get concurrency(): number;
+	set concurrency(value: number);
+	/**
+	 * Number of pending (running) tasks
+	 */
+	get pending(): number;
+	/**
+	 * Number of tasks waiting in queue
+	 */
+	get size(): number;
+	/**
+	 * Check if queue is paused
+	 */
+	get isPaused(): boolean;
+	/**
+	 * Add a task to the queue
+	 * @param fn - Async function to execute
+	 * @param options - Task options
+	 * @returns Promise resolving to task result
+	 */
+	add<R = T>(fn: TaskFunction<R>, options?: TaskOptions): Promise<R>;
+	/**
+	 * Add multiple tasks to the queue
+	 * @param fns - Array of async functions
+	 * @param options - Task options (applied to all)
+	 * @returns Promise resolving to array of results
+	 */
+	addAll<R = T>(fns: TaskFunction<R>[], options?: TaskOptions): Promise<R[]>;
+	/**
+	 * Pause queue processing (running tasks continue)
+	 */
+	pause(): void;
+	/**
+	 * Resume queue processing
+	 */
+	start(): void;
+	/**
+	 * Clear all pending tasks from queue
+	 */
+	clear(): void;
+	/**
+	 * Cancel a specific task by ID
+	 * @param id - Task ID to cancel
+	 * @returns true if task was found and cancelled
+	 */
+	cancel(id: string): boolean;
+	/**
+	 * Cancel all tasks matching a predicate
+	 * @param predicate - Function to test each task
+	 * @returns Number of tasks cancelled
+	 */
+	cancelBy(predicate: (task: {
+		id: string;
+		priority: number;
+	}) => boolean): number;
+	/**
+	 * Wait for queue to become idle (no running or pending tasks)
+	 */
+	onIdle(): Promise<void>;
+	/**
+	 * Wait for queue to be empty (no pending tasks, but may have running)
+	 */
+	onEmpty(): Promise<void>;
+	/**
+	 * Wait for queue size to be less than limit
+	 * @param limit - Size threshold
+	 */
+	onSizeLessThan(limit: number): Promise<void>;
+	/**
+	 * Register an event handler
+	 * @param event - Event name
+	 * @param handler - Handler function
+	 */
+	on<E extends keyof QueueEvents>(event: E, handler: EventHandler<QueueEvents[E]>): void;
+	/**
+	 * Remove an event handler
+	 * @param event - Event name
+	 * @param handler - Handler function to remove
+	 */
+	off<E extends keyof QueueEvents>(event: E, handler: EventHandler<QueueEvents[E]>): void;
+	/**
+	 * Destroy the queue and cleanup resources
+	 */
+	destroy(): void;
+	/**
+	 * Insert task into queue maintaining priority order (highest first)
+	 */
+	private insertByPriority;
+	/**
+	 * Try to run next task if capacity available
+	 */
+	private tryRunNext;
+	/**
+	 * Execute a task
+	 */
+	private runTask;
+	/**
+	 * Record task duration for statistics
+	 */
+	private recordDuration;
+	/**
+	 * Start interval-based rate limiting
+	 */
+	private startInterval;
+	/**
+	 * Emit an event
+	 */
+	protected emit<E extends keyof QueueEvents>(event: E, data: QueueEvents[E]): void;
+	/**
+	 * Check if queue became empty
+	 */
+	private checkEmpty;
+	/**
+	 * Check if queue became idle
+	 */
+	private checkIdle;
+}
 type ProxyProtocol$1 = "http" | "https" | "socks4" | "socks5";
 /**
  * Configuration options for proxy connections
@@ -2104,7 +2419,7 @@ export interface RezoRequestConfig<D = any> {
 	/**
 	 * Queue to use for request execution
 	 */
-	queue?: PQueue | null;
+	queue?: RezoQueue | null;
 	/**
 	 * Controls how the response body is parsed and returned in `response.data`.
 	 *
@@ -2194,10 +2509,6 @@ export interface RezoRequestConfig<D = any> {
 	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.
 	 *
@@ -2301,6 +2612,12 @@ export interface RezoRequestConfig<D = any> {
 	withCredentials?: boolean;
 	/** Proxy configuration (URL string or detailed options) */
 	proxy?: string | ProxyOptions;
+	/**
+	 * Whether to use ProxyManager for this request
+	 * Set to false to bypass ProxyManager even when one is configured
+	 * @default true (uses ProxyManager if configured)
+	 */
+	useProxyManager?: boolean;
 	/** Whether to enable automatic cookie handling */
 	useCookies?: boolean;
 	/** Custom cookie jar for managing cookies */
@@ -2322,8 +2639,6 @@ export interface RezoRequestConfig<D = any> {
 	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) */
@@ -2540,6 +2855,7 @@ type BeforeProxyDisableHook$1 = (context: BeforeProxyDisableContext) => boolean
 type AfterProxyDisableHook$1 = (context: AfterProxyDisableContext) => void | Promise<void>;
 type AfterProxyRotateHook$1 = (context: AfterProxyRotateContext) => void | Promise<void>;
 type AfterProxyEnableHook$1 = (context: AfterProxyEnableContext) => void | Promise<void>;
+type OnNoProxiesAvailableHook$1 = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Proxy hooks collection for ProxyManager events
  */
@@ -2552,6 +2868,8 @@ export interface ProxyHooks {
 	afterProxyDisable: AfterProxyDisableHook$1[];
 	afterProxyRotate: AfterProxyRotateHook$1[];
 	afterProxyEnable: AfterProxyEnableHook$1[];
+	/** Hook triggered when no proxies are available */
+	onNoProxiesAvailable: OnNoProxiesAvailableHook$1[];
 }
 declare class ProxyManager {
 	/** Configuration for the proxy manager */
@@ -2687,8 +3005,40 @@ declare class ProxyManager {
 	private runAfterProxyRotateHooks;
 	private runAfterProxyDisableHooks;
 	private runAfterProxyEnableHooks;
+	/**
+	 * Run onNoProxiesAvailable hooks synchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	private runOnNoProxiesAvailableHooksSync;
+	/**
+	 * Run onNoProxiesAvailable hooks asynchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	runOnNoProxiesAvailableHooks(context: OnNoProxiesAvailableContext): Promise<void>;
+	/**
+	 * Notify that no proxies are available and trigger hooks
+	 * This method is called when proxy selection fails due to pool exhaustion
+	 *
+	 * @param url - The request URL that needed a proxy
+	 * @param error - The error that will be thrown
+	 * @returns The context object with detailed information about the proxy pool state
+	 *
+	 * @example
+	 * ```typescript
+	 * manager.hooks.onNoProxiesAvailable.push((context) => {
+	 *     console.error(`No proxies available for ${context.url}`);
+	 *     console.log(`Dead: ${context.disabledReasons.dead}, Limit: ${context.disabledReasons.limitReached}`);
+	 *     // Trigger external alert or proxy refresh
+	 *     alertSystem.notify('Proxy pool exhausted', context);
+	 * });
+	 *
+	 * // Called internally or by adapters when no proxies are available
+	 * const context = manager.notifyNoProxiesAvailable('https://api.example.com', new Error('No proxies'));
+	 * ```
+	 */
+	notifyNoProxiesAvailable(url: string, error: Error): OnNoProxiesAvailableContext;
 }
-export type queueOptions = Options$1<PriorityQueue, QueueAddOptions>;
+export type queueOptions = QueueConfig;
 export interface CacheConfig {
 	/** Response cache configuration */
 	response?: boolean | ResponseCacheConfig;
@@ -2747,10 +3097,6 @@ export interface RezoDefaultOptions {
 	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) */
@@ -2789,8 +3135,6 @@ export interface RezoDefaultOptions {
 	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 */
@@ -3693,7 +4037,7 @@ export type AdapterFunction<T = any> = (options: RezoRequestConfig, defaultOptio
  * Main Rezo class - Enterprise-grade HTTP client with advanced features
  */
 export declare class Rezo {
-	protected queue: PQueue | null;
+	protected queue: RezoQueue | null;
 	protected isQueueEnabled: boolean;
 	defaults: RezoDefaultOptions;
 	hooks: RezoHooks;
@@ -3839,6 +4183,2048 @@ export interface RezoInstance extends Rezo {
 	/** Spread array arguments to callback function (Axios compatibility) */
 	spread: <T extends unknown[], R>(callback: (...args: T) => R) => (array: T) => R;
 }
+/**
+ * cURL Options Configuration
+ *
+ * Comprehensive type definitions for 100+ cURL command-line options.
+ * These options are ONLY available when using the cURL adapter via:
+ * `import rezo from 'rezo/adapters/curl'`
+ *
+ * @remarks
+ * - Headers, cookies, and body are handled separately via standard Rezo options
+ * - These options map directly to cURL command-line flags
+ * - All time values are in seconds unless otherwise specified
+ * - Options are applied after internal configuration, allowing safe overrides
+ *
+ * @see https://curl.se/docs/manpage.html for complete cURL documentation
+ * @author Yuniq Solutions Team
+ * @version 2.0.0
+ */
+/**
+ * IP version preference for cURL connections
+ * @see --ipv4, --ipv6
+ */
+export type CurlIpVersion = "v4" | "v6" | "any";
+/**
+ * SSL/TLS version options
+ * @see --sslv2, --sslv3, --tlsv1, --tlsv1.0, --tlsv1.1, --tlsv1.2, --tlsv1.3
+ */
+export type CurlSslVersion = "default" | "tlsv1" | "tlsv1.0" | "tlsv1.1" | "tlsv1.2" | "tlsv1.3" | "sslv2" | "sslv3";
+/**
+ * HTTP version options for cURL
+ * @see --http1.0, --http1.1, --http2, --http2-prior-knowledge, --http3, --http3-only
+ */
+export type CurlHttpVersion = "1.0" | "1.1" | "2" | "2-prior-knowledge" | "3" | "3-only";
+/**
+ * Authentication methods supported by cURL
+ * @see --basic, --digest, --ntlm, --negotiate, --anyauth
+ */
+export type CurlAuthMethod = "basic" | "digest" | "ntlm" | "negotiate" | "bearer" | "aws-sigv4" | "anyauth";
+/**
+ * Certificate type for TLS
+ * @see --cert-type
+ */
+export type CurlCertType = "PEM" | "DER" | "ENG" | "P12";
+/**
+ * Key type for TLS
+ * @see --key-type
+ */
+export type CurlKeyType = "PEM" | "DER" | "ENG";
+/**
+ * FTP SSL level
+ * @see --ftp-ssl-ccc-mode
+ */
+export type CurlFtpSslCccMode = "active" | "passive";
+/**
+ * FTP file method
+ * @see --ftp-method
+ */
+export type CurlFtpMethod = "multicwd" | "nocwd" | "singlecwd";
+/**
+ * Kerberos/GSS-API delegation level
+ * @see --delegation
+ */
+export type CurlDelegation = "none" | "policy" | "always";
+/**
+ * Retry configuration for cURL requests
+ */
+export interface CurlRetryOptions {
+	/**
+	 * Number of retry attempts
+	 * Maps to: --retry <num>
+	 * @default 0
+	 */
+	attempts?: number;
+	/**
+	 * Delay between retries in seconds
+	 * Maps to: --retry-delay <seconds>
+	 * @default 1
+	 */
+	delay?: number;
+	/**
+	 * Maximum time in seconds to spend on retries
+	 * Maps to: --retry-max-time <seconds>
+	 */
+	maxTime?: number;
+	/**
+	 * Retry on all errors (not just transient ones)
+	 * Maps to: --retry-all-errors
+	 * @default false
+	 */
+	allErrors?: boolean;
+	/**
+	 * Retry on connection refused errors
+	 * Maps to: --retry-connrefused
+	 * @default false
+	 */
+	connRefused?: boolean;
+}
+/**
+ * Local port range configuration
+ */
+export interface CurlLocalPortRange {
+	/**
+	 * Starting port number
+	 */
+	start: number;
+	/**
+	 * Ending port number (optional, uses single port if not specified)
+	 */
+	end?: number;
+}
+/**
+ * DNS resolve override entry
+ *
+ * @example
+ * // Resolve example.com:443 to specific IP
+ * { host: 'example.com', port: 443, address: '192.168.1.1' }
+ */
+export interface CurlResolveEntry {
+	/**
+	 * Hostname to override
+	 */
+	host: string;
+	/**
+	 * Port number for the override
+	 */
+	port: number;
+	/**
+	 * IP address(es) to resolve to (comma-separated for multiple)
+	 */
+	address: string;
+}
+/**
+ * Connect-to override entry for routing connections
+ *
+ * @example
+ * // Connect requests for example.com:443 to other.com:8443
+ * { host: 'example.com', port: 443, connectHost: 'other.com', connectPort: 8443 }
+ */
+export interface CurlConnectToEntry {
+	/**
+	 * Original hostname in the request
+	 */
+	host: string;
+	/**
+	 * Original port in the request
+	 */
+	port: number;
+	/**
+	 * Target hostname to connect to
+	 */
+	connectHost: string;
+	/**
+	 * Target port to connect to
+	 */
+	connectPort: number;
+}
+/**
+ * Speed limit configuration for bandwidth throttling
+ */
+export interface CurlSpeedLimit {
+	/**
+	 * Minimum speed in bytes per second
+	 * If speed drops below this for speedTime seconds, transfer aborts
+	 * Maps to: --speed-limit <speed>
+	 */
+	limit: number;
+	/**
+	 * Time in seconds the speed must stay below limit to abort
+	 * Maps to: --speed-time <seconds>
+	 * @default 30
+	 */
+	time?: number;
+}
+/**
+ * Proxy header configuration
+ * Headers to send only to the proxy (not the final destination)
+ */
+export type CurlProxyHeaders = Record<string, string>;
+/**
+ * Proxy TLS/SSL configuration
+ */
+export interface CurlProxyTlsOptions {
+	/**
+	 * TLS version for proxy connection
+	 * Maps to: --proxy-tlsv1, --proxy-tlsv1.0, etc.
+	 */
+	version?: CurlSslVersion;
+	/**
+	 * Path to client certificate for proxy
+	 * Maps to: --proxy-cert <cert>
+	 */
+	cert?: string;
+	/**
+	 * Path to client key for proxy
+	 * Maps to: --proxy-key <key>
+	 */
+	key?: string;
+	/**
+	 * Path to CA certificate for proxy verification
+	 * Maps to: --proxy-cacert <file>
+	 */
+	cacert?: string;
+	/**
+	 * CA path directory for proxy
+	 * Maps to: --proxy-capath <dir>
+	 */
+	capath?: string;
+	/**
+	 * Skip proxy certificate verification
+	 * Maps to: --proxy-insecure
+	 * @default false
+	 */
+	insecure?: boolean;
+	/**
+	 * Specify proxy certificate type
+	 * Maps to: --proxy-cert-type <type>
+	 */
+	certType?: CurlCertType;
+	/**
+	 * Specify proxy key type
+	 * Maps to: --proxy-key-type <type>
+	 */
+	keyType?: CurlKeyType;
+	/**
+	 * Specify proxy key password
+	 * Maps to: --proxy-pass <phrase>
+	 */
+	keyPassword?: string;
+	/**
+	 * Ciphers for proxy connection
+	 * Maps to: --proxy-ciphers <list>
+	 */
+	ciphers?: string;
+	/**
+	 * TLS 1.3 ciphers for proxy
+	 * Maps to: --proxy-tls13-ciphers <list>
+	 */
+	tls13Ciphers?: string;
+	/**
+	 * Pinned public key for proxy
+	 * Maps to: --proxy-pinnedpubkey <hashes>
+	 */
+	pinnedPubKey?: string | string[];
+	/**
+	 * CRL file for proxy
+	 * Maps to: --proxy-crlfile <file>
+	 */
+	crlfile?: string;
+	/**
+	 * Check proxy cert status via OCSP
+	 * Maps to: --proxy-ssl-allow-beast
+	 */
+	allowBeast?: boolean;
+	/**
+	 * Auto client cert for proxy
+	 * Maps to: --proxy-ssl-auto-client-cert
+	 */
+	autoClientCert?: boolean;
+}
+/**
+ * HSTS (HTTP Strict Transport Security) configuration
+ */
+export interface CurlHstsOptions {
+	/**
+	 * Path to HSTS cache file
+	 * Maps to: --hsts <filename>
+	 */
+	file?: string;
+}
+/**
+ * DNS configuration options
+ */
+export interface CurlDnsOptions {
+	/**
+	 * DNS servers to use (comma-separated)
+	 * Maps to: --dns-servers <addresses>
+	 * @example '8.8.8.8,8.8.4.4'
+	 */
+	servers?: string;
+	/**
+	 * DNS-over-HTTPS URL
+	 * Maps to: --doh-url <URL>
+	 * @example 'https://dns.google/dns-query'
+	 */
+	dohUrl?: string;
+	/**
+	 * Force DNS-over-HTTPS insecure mode
+	 * Maps to: --doh-insecure
+	 * @default false
+	 */
+	dohInsecure?: boolean;
+	/**
+	 * DNS-over-HTTPS using POST
+	 * Maps to: --doh-cert-status
+	 */
+	dohCertStatus?: boolean;
+	/**
+	 * DNS interface to use
+	 * Maps to: --dns-interface <interface>
+	 */
+	interface?: string;
+	/**
+	 * Local IPv4 address for DNS
+	 * Maps to: --dns-ipv4-addr <address>
+	 */
+	ipv4Addr?: string;
+	/**
+	 * Local IPv6 address for DNS
+	 * Maps to: --dns-ipv6-addr <address>
+	 */
+	ipv6Addr?: string;
+}
+/**
+ * FTP configuration options
+ */
+export interface CurlFtpOptions {
+	/**
+	 * FTP account data
+	 * Maps to: --ftp-account <data>
+	 */
+	account?: string;
+	/**
+	 * FTP alternative user
+	 * Maps to: --ftp-alternative-to-user <command>
+	 */
+	alternativeToUser?: string;
+	/**
+	 * Create missing remote dirs
+	 * Maps to: --ftp-create-dirs
+	 */
+	createDirs?: boolean;
+	/**
+	 * FTP method to use
+	 * Maps to: --ftp-method <method>
+	 */
+	method?: CurlFtpMethod;
+	/**
+	 * FTP passive mode
+	 * Maps to: --ftp-pasv
+	 */
+	pasv?: boolean;
+	/**
+	 * FTP port command
+	 * Maps to: --ftp-port <address>
+	 */
+	port?: string;
+	/**
+	 * Send PRET before PASV
+	 * Maps to: --ftp-pret
+	 */
+	pret?: boolean;
+	/**
+	 * Skip PASV IP address
+	 * Maps to: --ftp-skip-pasv-ip
+	 */
+	skipPasvIp?: boolean;
+	/**
+	 * FTP SSL clear command channel mode
+	 * Maps to: --ftp-ssl-ccc-mode <mode>
+	 */
+	sslCccMode?: CurlFtpSslCccMode;
+	/**
+	 * Require SSL for control connection
+	 * Maps to: --ftp-ssl-control
+	 */
+	sslControl?: boolean;
+	/**
+	 * Enable active mode for FTP
+	 * Maps to: --ftp-port -
+	 */
+	activeMode?: boolean;
+	/**
+	 * Append to remote file
+	 * Maps to: --append
+	 */
+	append?: boolean;
+	/**
+	 * Use ASCII transfer
+	 * Maps to: --use-ascii
+	 */
+	ascii?: boolean;
+}
+/**
+ * SSH configuration options
+ */
+export interface CurlSshOptions {
+	/**
+	 * SSH private key file
+	 * Maps to: --key <file>
+	 */
+	privateKey?: string;
+	/**
+	 * SSH private key password
+	 * Maps to: --pass <phrase>
+	 */
+	privateKeyPassword?: string;
+	/**
+	 * SSH public key file
+	 * Maps to: --pubkey <file>
+	 */
+	publicKey?: string;
+	/**
+	 * SSH host public key SHA256
+	 * Maps to: --hostpubsha256 <sha256>
+	 */
+	hostPubSha256?: string;
+	/**
+	 * SSH host public key MD5
+	 * Maps to: --hostpubmd5 <md5>
+	 */
+	hostPubMd5?: string;
+	/**
+	 * Known hosts file
+	 * Maps to: --known-hosts <file>
+	 */
+	knownHosts?: string;
+	/**
+	 * Enable SSH compression
+	 * Maps to: --compressed-ssh
+	 */
+	compression?: boolean;
+}
+/**
+ * TLS/SSL configuration options
+ */
+export interface CurlTlsOptions {
+	/**
+	 * SSL/TLS version to use
+	 * Maps to: --sslv2, --sslv3, --tlsv1, --tlsv1.0, etc.
+	 */
+	version?: CurlSslVersion;
+	/**
+	 * Minimum TLS version
+	 * Maps to: --tls-min <VERSION>
+	 */
+	min?: CurlSslVersion;
+	/**
+	 * Maximum TLS version
+	 * Maps to: --tls-max <VERSION>
+	 */
+	max?: CurlSslVersion;
+	/**
+	 * TLS 1.3 cipher suites
+	 * Maps to: --tls13-ciphers <ciphers>
+	 */
+	tls13Ciphers?: string;
+	/**
+	 * TLS 1.2 and below cipher suites
+	 * Maps to: --ciphers <ciphers>
+	 */
+	ciphers?: string;
+	/**
+	 * Pinned public key(s)
+	 * Maps to: --pinnedpubkey <hashes>
+	 */
+	pinnedPubKey?: string | string[];
+	/**
+	 * Request OCSP stapling
+	 * Maps to: --cert-status
+	 */
+	certStatus?: boolean;
+	/**
+	 * Certificate Revocation List file
+	 * Maps to: --crlfile <file>
+	 */
+	crlfile?: string;
+	/**
+	 * Client certificate file
+	 * Maps to: --cert <certificate[:password]>
+	 */
+	cert?: string;
+	/**
+	 * Client certificate type
+	 * Maps to: --cert-type <type>
+	 */
+	certType?: CurlCertType;
+	/**
+	 * Client key file
+	 * Maps to: --key <key>
+	 */
+	key?: string;
+	/**
+	 * Client key type
+	 * Maps to: --key-type <type>
+	 */
+	keyType?: CurlKeyType;
+	/**
+	 * Client key password
+	 * Maps to: --pass <phrase>
+	 */
+	keyPassword?: string;
+	/**
+	 * CA certificate bundle file
+	 * Maps to: --cacert <file>
+	 */
+	cacert?: string;
+	/**
+	 * CA certificate directory
+	 * Maps to: --capath <dir>
+	 */
+	capath?: string;
+	/**
+	 * Skip certificate verification
+	 * Maps to: --insecure, -k
+	 */
+	insecure?: boolean;
+	/**
+	 * Use native CA store
+	 * Maps to: --ca-native
+	 */
+	caNative?: boolean;
+	/**
+	 * Disable SSL session ID reuse
+	 * Maps to: --no-sessionid
+	 */
+	noSessionId?: boolean;
+	/**
+	 * SSL engine to use
+	 * Maps to: --engine <name>
+	 */
+	engine?: string;
+	/**
+	 * Random file for SSL
+	 * Maps to: --random-file <file>
+	 */
+	randomFile?: string;
+	/**
+	 * EGD socket path
+	 * Maps to: --egd-file <file>
+	 */
+	egdFile?: string;
+	/**
+	 * SSL allow BEAST attack
+	 * Maps to: --ssl-allow-beast
+	 */
+	allowBeast?: boolean;
+	/**
+	 * SSL no revoke
+	 * Maps to: --ssl-no-revoke
+	 */
+	noRevoke?: boolean;
+	/**
+	 * SSL revoke best effort
+	 * Maps to: --ssl-revoke-best-effort
+	 */
+	revokeBestEffort?: boolean;
+	/**
+	 * Auto client certificate
+	 * Maps to: --ssl-auto-client-cert
+	 */
+	autoClientCert?: boolean;
+	/**
+	 * Force SSL/TLS
+	 * Maps to: --ssl
+	 */
+	forceSsl?: boolean;
+	/**
+	 * Require SSL/TLS
+	 * Maps to: --ssl-reqd
+	 */
+	sslRequired?: boolean;
+	/**
+	 * ALPN protocols to offer
+	 * Maps to: --alpn <protocols>
+	 */
+	alpn?: string | string[];
+	/**
+	 * Disable ALPN
+	 * Maps to: --no-alpn
+	 */
+	noAlpn?: boolean;
+	/**
+	 * NPN protocols to offer
+	 * Maps to: --no-npn
+	 */
+	noNpn?: boolean;
+	/**
+	 * False start for TLS
+	 * Maps to: --false-start
+	 */
+	falseStart?: boolean;
+	/**
+	 * Curves to use for TLS
+	 * Maps to: --curves <list>
+	 */
+	curves?: string;
+	/**
+	 * ECH config
+	 * Maps to: --ech <config>
+	 */
+	ech?: string;
+}
+/**
+ * SMTP/Email configuration options
+ */
+export interface CurlSmtpOptions {
+	/**
+	 * SMTP mail from address
+	 * Maps to: --mail-from <address>
+	 */
+	mailFrom?: string;
+	/**
+	 * SMTP mail recipients
+	 * Maps to: --mail-rcpt <address>
+	 */
+	mailRcpt?: string | string[];
+	/**
+	 * Allow SMTP recipient failures
+	 * Maps to: --mail-rcpt-allowfails
+	 */
+	mailRcptAllowFails?: boolean;
+	/**
+	 * SMTP authentication
+	 * Maps to: --mail-auth <address>
+	 */
+	mailAuth?: string;
+}
+/**
+ * Telnet options
+ */
+export interface CurlTelnetOptions {
+	/**
+	 * Telnet option
+	 * Maps to: --telnet-option <opt=val>
+	 */
+	options?: Record<string, string>;
+}
+/**
+ * Progress/Output configuration
+ */
+export interface CurlOutputOptions {
+	/**
+	 * Show verbose output
+	 * Maps to: --verbose, -v
+	 */
+	verbose?: boolean;
+	/**
+	 * Trace file path
+	 * Maps to: --trace <file>
+	 */
+	trace?: string;
+	/**
+	 * Trace in ASCII format
+	 * Maps to: --trace-ascii <file>
+	 */
+	traceAscii?: string;
+	/**
+	 * Include timestamp in trace
+	 * Maps to: --trace-time
+	 */
+	traceTime?: boolean;
+	/**
+	 * Trace ID strings
+	 * Maps to: --trace-ids
+	 */
+	traceIds?: boolean;
+	/**
+	 * Trace configuration
+	 * Maps to: --trace-config <string>
+	 */
+	traceConfig?: string;
+	/**
+	 * Dump headers to stderr
+	 * Maps to: --dump-header <filename>
+	 */
+	dumpHeader?: string;
+	/**
+	 * Progress meter type
+	 * Maps to: --progress-bar (bar), --no-progress-meter (none)
+	 */
+	progressMeter?: "bar" | "none" | "default";
+	/**
+	 * Styled output
+	 * Maps to: --styled-output
+	 */
+	styledOutput?: boolean;
+}
+/**
+ * Write-out variables for custom output format
+ */
+export interface CurlWriteOut {
+	/**
+	 * Write-out format string
+	 * Maps to: --write-out <format>
+	 * @example '%{http_code}' or '%{time_total}'
+	 */
+	format?: string;
+	/**
+	 * Output to file instead of stdout
+	 */
+	file?: string;
+}
+/**
+ * AWS Signature Version 4 authentication
+ */
+export interface CurlAwsSigV4 {
+	/**
+	 * AWS provider
+	 * @example 'aws:amz'
+	 */
+	provider: string;
+	/**
+	 * AWS region
+	 * @example 'us-east-1'
+	 */
+	region: string;
+	/**
+	 * AWS service
+	 * @example 's3'
+	 */
+	service: string;
+}
+/**
+ * Parallel transfer configuration
+ */
+export interface CurlParallelOptions {
+	/**
+	 * Enable parallel transfers
+	 * Maps to: --parallel
+	 */
+	enabled: boolean;
+	/**
+	 * Maximum concurrent transfers
+	 * Maps to: --parallel-max <num>
+	 * @default 50
+	 */
+	max?: number;
+	/**
+	 * Start transfers immediately as added
+	 * Maps to: --parallel-immediate
+	 */
+	immediate?: boolean;
+}
+/**
+ * Comprehensive cURL options configuration (100+ options)
+ *
+ * @remarks
+ * These options provide fine-grained control over cURL behavior.
+ * They are applied after internal options and can override defaults.
+ *
+ * **IMPORTANT**: These options are ONLY available when using the cURL adapter:
+ * ```typescript
+ * import rezo from 'rezo/adapters/curl';
+ * ```
+ *
+ * Options that are handled internally and should NOT be set here:
+ * - Headers (-H) → Use `headers` option
+ * - Cookies (-b, -c) → Use cookie jar or `cookies` option
+ * - Body/Data (-d, --form) → Use `data` or `body` option
+ * - Output files (-o, -O) → Use `saveTo` option
+ * - Include headers (-i) → Always enabled internally
+ * - Write-out format (-w) → Used for stats parsing
+ *
+ * @example
+ * ```typescript
+ * import rezo from 'rezo/adapters/curl';
+ *
+ * // Simple usage
+ * await rezo.get('https://api.example.com/data', {
+ *   curl: {
+ *     connectTimeout: 10,
+ *     maxTime: 300,
+ *     limitRate: '500K',
+ *     ipVersion: 'v4',
+ *     tcpFastOpen: true
+ *   }
+ * });
+ *
+ * // Advanced TLS configuration
+ * await rezo.get('https://secure.example.com/api', {
+ *   curl: {
+ *     tls: {
+ *       min: 'tlsv1.2',
+ *       tls13Ciphers: 'TLS_AES_256_GCM_SHA384',
+ *       certStatus: true,
+ *       pinnedPubKey: 'sha256//base64hash='
+ *     }
+ *   }
+ * });
+ *
+ * // Retry with exponential backoff
+ * await rezo.get('https://unreliable-api.com/data', {
+ *   curl: {
+ *     retry: {
+ *       attempts: 5,
+ *       delay: 2,
+ *       maxTime: 60,
+ *       allErrors: true
+ *     }
+ *   }
+ * });
+ *
+ * // Custom DNS resolution
+ * await rezo.get('https://api.example.com/data', {
+ *   curl: {
+ *     resolve: [{ host: 'api.example.com', port: 443, address: '10.0.0.1' }],
+ *     dns: {
+ *       servers: '8.8.8.8,8.8.4.4',
+ *       dohUrl: 'https://dns.google/dns-query'
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export interface CurlOptions {
+	/**
+	 * Maximum time in seconds for the connection phase
+	 * Maps to: --connect-timeout <seconds>
+	 *
+	 * @remarks
+	 * This is the time allowed for establishing the TCP connection.
+	 * Does not include DNS lookup or TLS handshake if separate.
+	 *
+	 * @example
+	 * connectTimeout: 10 // 10 seconds max for connection
+	 */
+	connectTimeout?: number;
+	/**
+	 * Maximum time in seconds for the entire operation
+	 * Maps to: --max-time <seconds>
+	 *
+	 * @remarks
+	 * This overrides the standard `timeout` option when using cURL adapter.
+	 * Includes all phases: DNS, connect, TLS, transfer.
+	 *
+	 * @example
+	 * maxTime: 300 // 5 minutes max for entire request
+	 */
+	maxTime?: number;
+	/**
+	 * Time in seconds to wait for 100-continue response
+	 * Maps to: --expect100-timeout <seconds>
+	 *
+	 * @remarks
+	 * When sending a request with Expect: 100-continue header,
+	 * this is how long to wait for the server's 100 response.
+	 *
+	 * @default 1
+	 */
+	expect100Timeout?: number;
+	/**
+	 * Time in seconds to wait before sending keepalive probes
+	 * Maps to: --keepalive-time <seconds>
+	 *
+	 * @remarks
+	 * Sets the TCP keepalive idle time. The connection will send
+	 * keepalive probes after this many seconds of inactivity.
+	 *
+	 * @example
+	 * keepaliveTime: 60 // Send keepalive after 60 seconds idle
+	 */
+	keepaliveTime?: number;
+	/**
+	 * Interval between keepalive probes in seconds
+	 * Maps to: --keepalive-cnt (via environment)
+	 */
+	keepaliveInterval?: number;
+	/**
+	 * Number of keepalive probes before giving up
+	 * Maps to: configuration
+	 */
+	keepaliveCnt?: number;
+	/**
+	 * Disable keepalive on the connection
+	 * Maps to: --no-keepalive
+	 *
+	 * @default false
+	 */
+	noKeepalive?: boolean;
+	/**
+	 * Enable TCP Fast Open
+	 * Maps to: --tcp-fastopen
+	 *
+	 * @remarks
+	 * Enables TCP Fast Open (TFO) which can reduce connection latency
+	 * by sending data in the SYN packet. Requires OS and server support.
+	 *
+	 * @default false
+	 */
+	tcpFastOpen?: boolean;
+	/**
+	 * Disable TCP Nagle algorithm
+	 * Maps to: --tcp-nodelay
+	 *
+	 * @remarks
+	 * Disables Nagle's algorithm which can reduce latency for small packets
+	 * at the cost of slightly increased network traffic.
+	 *
+	 * @default false (Nagle enabled)
+	 */
+	tcpNodelay?: boolean;
+	/**
+	 * Connection idle timeout in seconds
+	 * Maps to: --keepalive-time for connection reuse
+	 */
+	idleTimeout?: number;
+	/**
+	 * Maximum connection time per host
+	 * Maps to: --connect-to for routing
+	 */
+	maxHostConnections?: number;
+	/**
+	 * Maximum total connections
+	 * Maps to: environment configuration
+	 */
+	maxTotalConnections?: number;
+	/**
+	 * Maximum transfer rate (bandwidth limit)
+	 * Maps to: --limit-rate <speed>
+	 *
+	 * @remarks
+	 * Limits the transfer speed. Can use suffixes:
+	 * - K or k: Kilobytes
+	 * - M or m: Megabytes
+	 * - G or g: Gigabytes
+	 *
+	 * @example
+	 * limitRate: '100K'  // Limit to 100 KB/s
+	 * limitRate: '1M'    // Limit to 1 MB/s
+	 * limitRate: '500'   // Limit to 500 bytes/s
+	 */
+	limitRate?: string;
+	/**
+	 * Speed limit configuration for abort threshold
+	 *
+	 * @remarks
+	 * If transfer speed drops below the limit for the specified time,
+	 * the transfer will be aborted. Useful for detecting stalled transfers.
+	 *
+	 * @example
+	 * speedLimit: { limit: 1000, time: 30 } // Abort if <1KB/s for 30 seconds
+	 */
+	speedLimit?: CurlSpeedLimit;
+	/**
+	 * Maximum number of redirects to follow
+	 * Maps to: --max-redirs <num>
+	 *
+	 * @default 50
+	 */
+	maxRedirs?: number;
+	/**
+	 * Maximum response size in bytes
+	 * Maps to: --max-filesize <bytes>
+	 */
+	maxFilesize?: number;
+	/**
+	 * Retry configuration for failed requests
+	 *
+	 * @remarks
+	 * By default, cURL only retries on transient errors (timeouts, etc).
+	 * Use `allErrors: true` to retry on all errors including HTTP errors.
+	 *
+	 * @example
+	 * retry: { attempts: 3, delay: 2, allErrors: true }
+	 */
+	retry?: CurlRetryOptions;
+	/**
+	 * Network interface to use for the request
+	 * Maps to: --interface <name>
+	 *
+	 * @remarks
+	 * Specifies which network interface to use. Can be interface name,
+	 * IP address, or hostname.
+	 *
+	 * @example
+	 * interface: 'eth0'
+	 * interface: '192.168.1.100'
+	 */
+	interface?: string;
+	/**
+	 * Local IP address to use for outgoing connection
+	 * Maps to: --local-address <address>
+	 *
+	 * @remarks
+	 * Binds the local end of the connection to this IP address.
+	 * Useful on multi-homed systems.
+	 *
+	 * @example
+	 * localAddress: '192.168.1.100'
+	 */
+	localAddress?: string;
+	/**
+	 * Local port or port range to use
+	 * Maps to: --local-port <num>[-num]
+	 *
+	 * @remarks
+	 * Forces cURL to use a specific local port or port range.
+	 * Useful for firewall configurations.
+	 *
+	 * @example
+	 * localPort: 45000
+	 * localPort: { start: 45000, end: 45100 }
+	 */
+	localPort?: number | CurlLocalPortRange;
+	/**
+	 * IP version preference
+	 * Maps to: --ipv4 (v4), --ipv6 (v6), or default (any)
+	 *
+	 * @remarks
+	 * Forces cURL to resolve names to IPv4 or IPv6 addresses only.
+	 *
+	 * @example
+	 * ipVersion: 'v4' // Force IPv4 only
+	 */
+	ipVersion?: CurlIpVersion;
+	/**
+	 * DNS resolve overrides
+	 * Maps to: --resolve <host:port:address>
+	 *
+	 * @remarks
+	 * Provides custom DNS resolution, bypassing the system resolver.
+	 * Useful for testing or accessing services on specific IPs.
+	 *
+	 * @example
+	 * resolve: [{ host: 'example.com', port: 443, address: '192.168.1.1' }]
+	 * resolve: ['example.com:443:192.168.1.1']
+	 */
+	resolve?: Array<CurlResolveEntry | string>;
+	/**
+	 * Connect-to overrides for routing
+	 * Maps to: --connect-to <host:port:connect-host:connect-port>
+	 *
+	 * @remarks
+	 * Routes connections to different host:port than specified in URL.
+	 * Unlike resolve, this also changes the Host header.
+	 *
+	 * @example
+	 * connectTo: [{ host: 'example.com', port: 443, connectHost: 'backend.local', connectPort: 8443 }]
+	 * connectTo: ['example.com:443:backend.local:8443']
+	 */
+	connectTo?: Array<CurlConnectToEntry | string>;
+	/**
+	 * Hosts to bypass proxy for
+	 * Maps to: --noproxy <hosts>
+	 *
+	 * @remarks
+	 * Comma-separated list of hosts that should not go through proxy.
+	 * Supports wildcards like *.example.com
+	 *
+	 * @example
+	 * noProxy: 'localhost,127.0.0.1,*.internal.com'
+	 * noProxy: ['localhost', '127.0.0.1', '*.internal.com']
+	 */
+	noProxy?: string | string[];
+	/**
+	 * Unix domain socket to use
+	 * Maps to: --unix-socket <path>
+	 *
+	 * @remarks
+	 * Connects via Unix domain socket instead of TCP.
+	 * Useful for Docker API, local services, etc.
+	 *
+	 * @example
+	 * unixSocket: '/var/run/docker.sock'
+	 */
+	unixSocket?: string;
+	/**
+	 * Abstract Unix domain socket (Linux only)
+	 * Maps to: --abstract-unix-socket <path>
+	 *
+	 * @remarks
+	 * Like unixSocket but for abstract namespace sockets (prefixed with @)
+	 */
+	abstractUnixSocket?: string;
+	/**
+	 * Happy Eyeballs timeout in milliseconds
+	 * Maps to: --happy-eyeballs-timeout-ms <ms>
+	 *
+	 * @remarks
+	 * Time to wait for IPv6 before falling back to IPv4.
+	 * Set to 0 to disable Happy Eyeballs.
+	 *
+	 * @default 200
+	 */
+	happyEyeballsTimeout?: number;
+	/**
+	 * Network namespace to use (Linux)
+	 * Maps to: --netns <name>
+	 */
+	netns?: string;
+	/**
+	 * Disable TCP's use of PMTU discovery
+	 * Maps to: --disable-epsv
+	 */
+	disablePmtu?: boolean;
+	/**
+	 * Force using a new connection
+	 * Maps to: --no-connection
+	 */
+	forceNewConnection?: boolean;
+	/**
+	 * SOCKSv5 hostname resolution
+	 * Maps to: --socks5-hostname
+	 */
+	socks5ResolveLocal?: boolean;
+	/**
+	 * Disable session reuse on proxied connections
+	 * Maps to: --suppress-connect-headers
+	 */
+	suppressConnectHeaders?: boolean;
+	/**
+	 * HTTP version to use
+	 * Maps to: --http1.0, --http1.1, --http2, --http2-prior-knowledge, --http3, --http3-only
+	 *
+	 * @remarks
+	 * - '1.0': Force HTTP/1.0
+	 * - '1.1': Force HTTP/1.1
+	 * - '2': Use HTTP/2 if available (with HTTP/1.1 fallback)
+	 * - '2-prior-knowledge': HTTP/2 without upgrade (for known HTTP/2 servers)
+	 * - '3': Use HTTP/3 if available
+	 * - '3-only': Force HTTP/3 only
+	 *
+	 * @example
+	 * httpVersion: '2' // Prefer HTTP/2
+	 */
+	httpVersion?: CurlHttpVersion;
+	/**
+	 * Use HTTP/0.9 if server sends it
+	 * Maps to: --http0.9
+	 */
+	http09?: boolean;
+	/**
+	 * Path-as-is: don't squash .. and . in URL path
+	 * Maps to: --path-as-is
+	 *
+	 * @remarks
+	 * Prevents cURL from normalizing the URL path.
+	 * Useful for APIs that require exact paths.
+	 *
+	 * @default false
+	 */
+	pathAsIs?: boolean;
+	/**
+	 * Request target to use instead of path from URL
+	 * Maps to: --request-target <target>
+	 *
+	 * @remarks
+	 * Overrides the request target (path) in the request line.
+	 * Advanced feature for proxy requests.
+	 */
+	requestTarget?: string;
+	/**
+	 * Disable URL globbing
+	 * Maps to: --globoff
+	 *
+	 * @remarks
+	 * Prevents cURL from interpreting {}, [] in URLs as glob patterns.
+	 *
+	 * @default false
+	 */
+	globOff?: boolean;
+	/**
+	 * Disable buffering of the output stream
+	 * Maps to: --no-buffer
+	 */
+	noBuffer?: boolean;
+	/**
+	 * Do not use a username in the URL
+	 * Maps to: --disallow-username-in-url
+	 */
+	disallowUsernameInUrl?: boolean;
+	/**
+	 * Strip credentials from referrer URL
+	 * Maps to: --strip-credentials
+	 */
+	stripCredentials?: boolean;
+	/**
+	 * Use GET request after redirect (legacy)
+	 * Maps to: --post301, --post302, --post303
+	 */
+	postRedirect?: 301 | 302 | 303 | boolean;
+	/**
+	 * Referer URL to use
+	 * Maps to: --referer <URL>
+	 */
+	referer?: string;
+	/**
+	 * Automatic referer on redirect
+	 * Maps to: --referer ";auto"
+	 */
+	autoReferer?: boolean;
+	/**
+	 * SSL/TLS version to use
+	 * Maps to: --sslv2, --sslv3, --tlsv1, --tlsv1.0, --tlsv1.1, --tlsv1.2, --tlsv1.3
+	 *
+	 * @deprecated Use `tls.version` instead
+	 * @remarks
+	 * Forces a specific TLS version. Use with caution as older
+	 * versions have security vulnerabilities.
+	 *
+	 * @example
+	 * sslVersion: 'tlsv1.2' // Force TLS 1.2
+	 */
+	sslVersion?: CurlSslVersion;
+	/**
+	 * Minimum TLS version
+	 * Maps to: --tls-min <VERSION>
+	 *
+	 * @deprecated Use `tls.min` instead
+	 * @remarks
+	 * Sets the minimum acceptable TLS version for the connection.
+	 * Recommended: 'tlsv1.2' or higher.
+	 *
+	 * @example
+	 * tlsMin: 'tlsv1.2' // Require at least TLS 1.2
+	 */
+	tlsMin?: CurlSslVersion;
+	/**
+	 * Maximum TLS version
+	 * Maps to: --tls-max <VERSION>
+	 *
+	 * @deprecated Use `tls.max` instead
+	 * @remarks
+	 * Sets the maximum TLS version. Rarely needed, mainly for testing.
+	 */
+	tlsMax?: CurlSslVersion;
+	/**
+	 * TLS 1.3 cipher suites
+	 * Maps to: --tls13-ciphers <ciphers>
+	 *
+	 * @deprecated Use `tls.tls13Ciphers` instead
+	 * @remarks
+	 * Colon-separated list of TLS 1.3 cipher suites.
+	 *
+	 * @example
+	 * tls13Ciphers: 'TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256'
+	 */
+	tls13Ciphers?: string;
+	/**
+	 * TLS 1.2 and below cipher suites
+	 * Maps to: --ciphers <ciphers>
+	 *
+	 * @deprecated Use `tls.ciphers` instead
+	 * @remarks
+	 * OpenSSL cipher list for TLS 1.2 and earlier.
+	 *
+	 * @example
+	 * ciphers: 'ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256'
+	 */
+	ciphers?: string;
+	/**
+	 * Pinned public key(s) for certificate validation
+	 * Maps to: --pinnedpubkey <hashes>
+	 *
+	 * @deprecated Use `tls.pinnedPubKey` instead
+	 * @remarks
+	 * SHA256 hash(es) of the public key to pin against.
+	 * Provides additional security against certificate substitution.
+	 *
+	 * @example
+	 * pinnedPubKey: 'sha256//base64hash='
+	 * pinnedPubKey: ['sha256//hash1=', 'sha256//hash2=']
+	 */
+	pinnedPubKey?: string | string[];
+	/**
+	 * Request OCSP stapling for certificate status
+	 * Maps to: --cert-status
+	 *
+	 * @deprecated Use `tls.certStatus` instead
+	 * @remarks
+	 * Asks the server to provide OCSP stapling for certificate revocation check.
+	 *
+	 * @default false
+	 */
+	certStatus?: boolean;
+	/**
+	 * Path to Certificate Revocation List file
+	 * Maps to: --crlfile <file>
+	 *
+	 * @deprecated Use `tls.crlfile` instead
+	 * @remarks
+	 * PEM file containing Certificate Revocation Lists for validation.
+	 */
+	crlfile?: string;
+	/**
+	 * ALPN protocols to offer
+	 * Maps to: --alpn <protocols>
+	 *
+	 * @deprecated Use `tls.alpn` instead
+	 * @remarks
+	 * Application-Layer Protocol Negotiation protocols to offer.
+	 * Comma-separated or array of protocol names.
+	 *
+	 * @example
+	 * alpn: ['h2', 'http/1.1']
+	 * alpn: 'h2,http/1.1'
+	 */
+	alpn?: string | string[];
+	/**
+	 * Disable ALPN negotiation
+	 * Maps to: --no-alpn
+	 *
+	 * @deprecated Use `tls.noAlpn` instead
+	 * @default false
+	 */
+	noAlpn?: boolean;
+	/**
+	 * SSL session ID reuse control
+	 * Maps to: --no-sessionid (when false)
+	 *
+	 * @deprecated Use `tls.noSessionId` instead
+	 * @remarks
+	 * Disable SSL session ID caching. Normally sessions are reused
+	 * for performance.
+	 *
+	 * @default true
+	 */
+	sessionId?: boolean;
+	/**
+	 * SSL Engine to use
+	 * Maps to: --engine <name>
+	 *
+	 * @deprecated Use `tls.engine` instead
+	 * @remarks
+	 * Crypto engine to use for SSL operations.
+	 */
+	engine?: string;
+	/**
+	 * Custom CA path (directory of certificates)
+	 * Maps to: --capath <dir>
+	 *
+	 * @deprecated Use `tls.capath` instead
+	 * @remarks
+	 * Directory containing CA certificates in PEM format.
+	 * Certificates must be named by their hash values.
+	 */
+	capath?: string;
+	/**
+	 * Enable certificate type specification
+	 * Maps to: --cert-type <type>
+	 *
+	 * @deprecated Use `tls.certType` instead
+	 * @remarks
+	 * Specify certificate type: PEM, DER, ENG, P12.
+	 *
+	 * @default 'PEM'
+	 */
+	certType?: CurlCertType;
+	/**
+	 * Key type specification
+	 * Maps to: --key-type <type>
+	 *
+	 * @deprecated Use `tls.keyType` instead
+	 * @remarks
+	 * Specify key type: PEM, DER, ENG.
+	 *
+	 * @default 'PEM'
+	 */
+	keyType?: CurlKeyType;
+	/**
+	 * Skip TLS certificate verification (insecure)
+	 * Maps to: --insecure, -k
+	 *
+	 * @remarks
+	 * Allows connections to TLS sites without valid certificates.
+	 * WARNING: Only use for development/testing. Never in production!
+	 *
+	 * @default false
+	 */
+	insecure?: boolean;
+	/**
+	 * Comprehensive TLS/SSL configuration object
+	 *
+	 * @remarks
+	 * Preferred way to configure TLS settings. Individual TLS properties
+	 * on CurlOptions are deprecated in favor of this object.
+	 *
+	 * @example
+	 * tls: {
+	 *   min: 'tlsv1.2',
+	 *   tls13Ciphers: 'TLS_AES_256_GCM_SHA384',
+	 *   certStatus: true,
+	 *   cert: '/path/to/client.crt',
+	 *   key: '/path/to/client.key',
+	 *   cacert: '/path/to/ca-bundle.crt'
+	 * }
+	 */
+	tls?: CurlTlsOptions;
+	/**
+	 * Headers to send to the proxy only
+	 * Maps to: --proxy-header <header>
+	 *
+	 * @remarks
+	 * These headers are sent only to the proxy, not to the final destination.
+	 * Useful for proxy authentication or identification.
+	 *
+	 * @example
+	 * proxyHeaders: { 'X-Proxy-Auth': 'token123' }
+	 */
+	proxyHeaders?: CurlProxyHeaders;
+	/**
+	 * Proxy TLS/SSL configuration
+	 *
+	 * @remarks
+	 * Separate TLS settings for the connection to the proxy itself.
+	 * Useful when proxy requires client certificates or specific TLS version.
+	 *
+	 * @example
+	 * proxyTls: { version: 'tlsv1.2', insecure: false }
+	 */
+	proxyTls?: CurlProxyTlsOptions;
+	/**
+	 * Pre-proxy to use
+	 * Maps to: --preproxy <[protocol://]host[:port]>
+	 *
+	 * @remarks
+	 * Proxy to use before connecting to the main proxy.
+	 * Useful for proxy chains.
+	 */
+	preProxy?: string;
+	/**
+	 * SOCKS5 with GSSAPI
+	 * Maps to: --socks5-gssapi
+	 */
+	socks5Gssapi?: boolean;
+	/**
+	 * SOCKS5 GSSAPI service name
+	 * Maps to: --socks5-gssapi-service <name>
+	 */
+	socks5GssapiService?: string;
+	/**
+	 * SOCKS5 GSSAPI NEC mode
+	 * Maps to: --socks5-gssapi-nec
+	 */
+	socks5GssapiNec?: boolean;
+	/**
+	 * Use HTTP/1.0 for CONNECT tunneling
+	 * Maps to: --proxy1.0
+	 */
+	proxyHttp10?: boolean;
+	/**
+	 * Use HTTP digest auth with proxy
+	 * Maps to: --proxy-digest
+	 */
+	proxyDigest?: boolean;
+	/**
+	 * Use HTTP basic auth with proxy
+	 * Maps to: --proxy-basic
+	 */
+	proxyBasic?: boolean;
+	/**
+	 * Use NTLM auth with proxy
+	 * Maps to: --proxy-ntlm
+	 */
+	proxyNtlm?: boolean;
+	/**
+	 * Use Negotiate auth with proxy
+	 * Maps to: --proxy-negotiate
+	 */
+	proxyNegotiate?: boolean;
+	/**
+	 * Use any auth with proxy
+	 * Maps to: --proxy-anyauth
+	 */
+	proxyAnyAuth?: boolean;
+	/**
+	 * Proxy service name
+	 * Maps to: --proxy-service-name <name>
+	 */
+	proxyServiceName?: string;
+	/**
+	 * Tunnel through HTTP proxy
+	 * Maps to: --proxytunnel
+	 */
+	proxyTunnel?: boolean;
+	/**
+	 * Haproxy client IP
+	 * Maps to: --haproxy-clientip <ip>
+	 */
+	haproxyClientIp?: string;
+	/**
+	 * Haproxy protocol
+	 * Maps to: --haproxy-protocol
+	 */
+	haproxyProtocol?: boolean;
+	/**
+	 * DNS configuration
+	 *
+	 * @remarks
+	 * Advanced DNS settings including custom servers, DNS-over-HTTPS,
+	 * and interface bindings.
+	 *
+	 * @example
+	 * dns: {
+	 *   servers: '8.8.8.8,8.8.4.4',
+	 *   dohUrl: 'https://dns.google/dns-query'
+	 * }
+	 */
+	dns?: CurlDnsOptions;
+	/**
+	 * HSTS configuration
+	 * Maps to: --hsts <filename>
+	 */
+	hsts?: CurlHstsOptions;
+	/**
+	 * Alt-Svc cache file
+	 * Maps to: --alt-svc <filename>
+	 *
+	 * @remarks
+	 * File to read/write Alt-Svc cache for HTTP/3 upgrades.
+	 */
+	altSvc?: string;
+	/**
+	 * Disable Alt-Svc
+	 * Maps to: --no-alt-svc
+	 *
+	 * @default false
+	 */
+	noAltSvc?: boolean;
+	/**
+	 * Trust credentials on redirect
+	 * Maps to: --location-trusted
+	 *
+	 * @remarks
+	 * Send authentication credentials to hosts after redirect.
+	 * Use with caution for security reasons.
+	 *
+	 * @default false
+	 */
+	locationTrusted?: boolean;
+	/**
+	 * Discard session cookies on redirect
+	 * Maps to: --junk-session-cookies
+	 *
+	 * @default false
+	 */
+	junkSessionCookies?: boolean;
+	/**
+	 * Fail silently on HTTP errors
+	 * Maps to: --fail
+	 *
+	 * @remarks
+	 * Exit with error code 22 if server returns error (4xx, 5xx).
+	 * Suppresses error page output.
+	 *
+	 * @default false
+	 */
+	fail?: boolean;
+	/**
+	 * Fail early on first error
+	 * Maps to: --fail-early
+	 */
+	failEarly?: boolean;
+	/**
+	 * Fail with body on HTTP errors
+	 * Maps to: --fail-with-body
+	 */
+	failWithBody?: boolean;
+	/**
+	 * Enable verbose output
+	 * Maps to: --verbose, -v
+	 *
+	 * @remarks
+	 * Shows detailed request/response information including headers
+	 * and connection details. Useful for debugging.
+	 *
+	 * @default false
+	 */
+	verbose?: boolean;
+	/**
+	 * Trace file path
+	 * Maps to: --trace <file>
+	 *
+	 * @remarks
+	 * Write full trace including binary data to file.
+	 * More detailed than verbose.
+	 */
+	trace?: string;
+	/**
+	 * Trace ASCII file
+	 * Maps to: --trace-ascii <file>
+	 *
+	 * @remarks
+	 * Like trace but without hex dump of binary data.
+	 */
+	traceAscii?: string;
+	/**
+	 * Include timestamp in trace output
+	 * Maps to: --trace-time
+	 *
+	 * @default false
+	 */
+	traceTime?: boolean;
+	/**
+	 * Include transfer IDs in trace
+	 * Maps to: --trace-ids
+	 */
+	traceIds?: boolean;
+	/**
+	 * Trace configuration
+	 * Maps to: --trace-config <string>
+	 */
+	traceConfig?: string;
+	/**
+	 * Raw output (disable content decoding)
+	 * Maps to: --raw
+	 *
+	 * @default false
+	 */
+	raw?: boolean;
+	/**
+	 * Disable compression for response
+	 * Maps to: (internal - removes --compressed)
+	 *
+	 * @default false
+	 */
+	noCompressed?: boolean;
+	/**
+	 * Buffer size for receive
+	 * Maps to: --buffer-size <size>
+	 *
+	 * @remarks
+	 * Maximum receive buffer size with suffix (K, M).
+	 *
+	 * @example
+	 * bufferSize: '1M'
+	 */
+	bufferSize?: string;
+	/**
+	 * Styled output
+	 * Maps to: --styled-output
+	 */
+	styledOutput?: boolean;
+	/**
+	 * Dump header to file
+	 * Maps to: --dump-header <filename>
+	 */
+	dumpHeader?: string;
+	/**
+	 * Progress meter type
+	 * Maps to: --progress-bar, --no-progress-meter
+	 */
+	progressMeter?: "bar" | "none" | "default";
+	/**
+	 * Write-out format
+	 * Maps to: --write-out <format>
+	 */
+	writeOut?: string | CurlWriteOut;
+	/**
+	 * Output configuration
+	 * Comprehensive output/debugging settings
+	 */
+	output?: CurlOutputOptions;
+	/**
+	 * Use netrc file for credentials
+	 * Maps to: --netrc, --netrc-optional, --netrc-file <filename>
+	 *
+	 * @remarks
+	 * - true: Use ~/.netrc (fail if not found)
+	 * - 'optional': Use ~/.netrc (don't fail if not found)
+	 * - string: Path to custom netrc file
+	 */
+	netrc?: boolean | "optional" | string;
+	/**
+	 * Delegation level for GSS-API/Kerberos
+	 * Maps to: --delegation <level>
+	 *
+	 * @remarks
+	 * Controls credential delegation in GSS-API.
+	 * - 'none': No delegation
+	 * - 'policy': Delegate if OK according to policy
+	 * - 'always': Always delegate
+	 */
+	delegation?: CurlDelegation;
+	/**
+	 * Service name for SPNEGO
+	 * Maps to: --service-name <name>
+	 *
+	 * @remarks
+	 * Override the default service name for SPNEGO authentication.
+	 */
+	serviceName?: string;
+	/**
+	 * Negotiate authentication
+	 * Maps to: --negotiate
+	 *
+	 * @remarks
+	 * Enable SPNEGO/Negotiate authentication (Kerberos, NTLM).
+	 *
+	 * @default false
+	 */
+	negotiate?: boolean;
+	/**
+	 * NTLM authentication with winbind
+	 * Maps to: --ntlm-wb
+	 */
+	ntlmWb?: boolean;
+	/**
+	 * SASL IR (Initial Response)
+	 * Maps to: --sasl-ir
+	 *
+	 * @remarks
+	 * Enable SASL initial response for protocols that support it.
+	 *
+	 * @default false
+	 */
+	saslIr?: boolean;
+	/**
+	 * SASL authentication mechanism
+	 * Maps to: --sasl-authzid <identity>
+	 */
+	saslAuthzid?: string;
+	/**
+	 * AWS Signature Version 4 authentication
+	 * Maps to: --aws-sigv4 <provider1[:provider2[:region[:service]]]>
+	 *
+	 * @example
+	 * awsSigv4: { provider: 'aws:amz', region: 'us-east-1', service: 's3' }
+	 * awsSigv4: 'aws:amz:us-east-1:s3'
+	 */
+	awsSigv4?: string | CurlAwsSigV4;
+	/**
+	 * OAuth 2.0 bearer token
+	 * Maps to: --oauth2-bearer <token>
+	 */
+	oauth2Bearer?: string;
+	/**
+	 * Login options
+	 * Maps to: --login-options <options>
+	 */
+	loginOptions?: string;
+	/**
+	 * Kerberos authentication level
+	 * Maps to: --krb <level>
+	 */
+	kerberos?: "clear" | "safe" | "confidential" | "private";
+	/**
+	 * XOAUTH2 bearer token
+	 * Maps to: --xoauth2-bearer <token>
+	 */
+	xoauth2Bearer?: string;
+	/**
+	 * Digest authentication
+	 * Maps to: --digest
+	 */
+	digest?: boolean;
+	/**
+	 * Basic authentication
+	 * Maps to: --basic
+	 */
+	basic?: boolean;
+	/**
+	 * Any authentication method
+	 * Maps to: --anyauth
+	 */
+	anyAuth?: boolean;
+	/**
+	 * FTP configuration
+	 *
+	 * @example
+	 * ftp: {
+	 *   createDirs: true,
+	 *   pasv: true,
+	 *   method: 'singlecwd'
+	 * }
+	 */
+	ftp?: CurlFtpOptions;
+	/**
+	 * Use EPRT command for active mode
+	 * Maps to: --disable-eprt
+	 */
+	disableEprt?: boolean;
+	/**
+	 * Use EPSV command for passive mode
+	 * Maps to: --disable-epsv
+	 */
+	disableEpsv?: boolean;
+	/**
+	 * Quote commands
+	 * Maps to: --quote <command>
+	 */
+	quote?: string | string[];
+	/**
+	 * Pre-transfer quote commands
+	 * Maps to: --prequote <command>
+	 */
+	prequote?: string | string[];
+	/**
+	 * Post-transfer quote commands
+	 * Maps to: --postquote <command>
+	 */
+	postquote?: string | string[];
+	/**
+	 * Continue at offset
+	 * Maps to: --continue-at <offset>
+	 */
+	continueAt?: number | "-";
+	/**
+	 * CRLF conversion
+	 * Maps to: --crlf
+	 */
+	crlf?: boolean;
+	/**
+	 * Range request
+	 * Maps to: --range <range>
+	 */
+	range?: string;
+	/**
+	 * Remove file after download
+	 * Maps to: --remote-header-name
+	 */
+	remoteHeaderName?: boolean;
+	/**
+	 * Request compression
+	 * Maps to: --tr-encoding
+	 */
+	trEncoding?: boolean;
+	/**
+	 * Ignore content length
+	 * Maps to: --ignore-content-length
+	 */
+	ignoreContentLength?: boolean;
+	/**
+	 * SSH configuration
+	 *
+	 * @example
+	 * ssh: {
+	 *   privateKey: '/path/to/key',
+	 *   knownHosts: '/path/to/known_hosts',
+	 *   compression: true
+	 * }
+	 */
+	ssh?: CurlSshOptions;
+	/**
+	 * Enable compressed SSH protocols
+	 * Maps to: --compressed-ssh
+	 *
+	 * @deprecated Use `ssh.compression` instead
+	 * @remarks
+	 * Enable compression for SSH connections (SCP, SFTP).
+	 *
+	 * @default false
+	 */
+	compressedSsh?: boolean;
+	/**
+	 * SMTP configuration
+	 *
+	 * @example
+	 * smtp: {
+	 *   mailFrom: 'sender@example.com',
+	 *   mailRcpt: ['recipient@example.com']
+	 * }
+	 */
+	smtp?: CurlSmtpOptions;
+	/**
+	 * Telnet configuration
+	 */
+	telnet?: CurlTelnetOptions;
+	/**
+	 * TFTP block size
+	 * Maps to: --tftp-blksize <value>
+	 */
+	tftpBlksize?: number;
+	/**
+	 * TFTP no options
+	 * Maps to: --tftp-no-options
+	 */
+	tftpNoOptions?: boolean;
+	/**
+	 * Parallel transfer configuration (for multiple URLs)
+	 * Maps to: --parallel, --parallel-max, --parallel-immediate
+	 *
+	 * @remarks
+	 * Only applicable when making multiple requests.
+	 */
+	parallel?: CurlParallelOptions;
+	/**
+	 * Time condition for request
+	 * Maps to: --time-cond <time>
+	 */
+	timeCond?: string | Date;
+	/**
+	 * Create required local dirs
+	 * Maps to: --create-dirs
+	 */
+	createDirs?: boolean;
+	/**
+	 * Create required remote dirs
+	 * Maps to: --ftp-create-dirs
+	 */
+	createRemoteDirs?: boolean;
+	/**
+	 * Request compressed transfer encoding
+	 * Maps to: --compressed
+	 */
+	compressed?: boolean;
+	/**
+	 * Use file for config
+	 * Maps to: --config <file>
+	 */
+	configFile?: string;
+	/**
+	 * Disable config file
+	 * Maps to: --disable
+	 */
+	disableConfig?: boolean;
+	/**
+	 * Disable environment variable use
+	 * Maps to: --disable-env
+	 */
+	disableEnv?: boolean;
+	/**
+	 * Engine list
+	 * Maps to: --engine list
+	 */
+	engineList?: boolean;
+	/**
+	 * Form escape
+	 * Maps to: --form-escape
+	 */
+	formEscape?: boolean;
+	/**
+	 * Form string
+	 * Maps to: --form-string <name=string>
+	 */
+	formString?: Record<string, string>;
+	/**
+	 * Globoff for URLs
+	 * Maps to: --globoff
+	 */
+	globoff?: boolean;
+	/**
+	 * Data binary
+	 * Maps to: --data-binary <data>
+	 */
+	dataBinary?: string | Buffer;
+	/**
+	 * Data raw
+	 * Maps to: --data-raw <data>
+	 */
+	dataRaw?: string;
+	/**
+	 * Data URL encode
+	 * Maps to: --data-urlencode <data>
+	 */
+	dataUrlencode?: string | Record<string, string>;
+	/**
+	 * JSON data
+	 * Maps to: --json <data>
+	 */
+	json?: string | Record<string, unknown>;
+	/**
+	 * URL encode
+	 * Maps to: --url-query <data>
+	 */
+	urlQuery?: string | Record<string, string>;
+	/**
+	 * Variable
+	 * Maps to: --variable <name=value>
+	 */
+	variable?: Record<string, string>;
+	/**
+	 * Expand variables in URL
+	 * Maps to: --expand-url
+	 */
+	expandUrl?: boolean;
+	/**
+	 * MIME type for content
+	 * Maps to: used with multipart
+	 */
+	mimeType?: string;
+	/**
+	 * Remote time
+	 * Maps to: --remote-time
+	 */
+	remoteTime?: boolean;
+	/**
+	 * Output directory
+	 * Maps to: --output-dir <dir>
+	 */
+	outputDir?: string;
+	/**
+	 * Xattr
+	 * Maps to: --xattr
+	 */
+	xattr?: boolean;
+	/**
+	 * ECH config list
+	 * Maps to: --ech <config>
+	 */
+	ech?: string;
+}
+/**
+ * Extended request configuration for cURL adapter
+ *
+ * @remarks
+ * This type extends the base RezoRequestConfig with cURL-specific options.
+ * It is ONLY available when importing from `rezo/adapters/curl`.
+ *
+ * @example
+ * ```typescript
+ * import rezo, { CurlRequestConfig } from 'rezo/adapters/curl';
+ *
+ * const config: CurlRequestConfig = {
+ *   url: 'https://api.example.com/data',
+ *   method: 'GET',
+ *   curl: {
+ *     connectTimeout: 10,
+ *     limitRate: '500K',
+ *     retry: { attempts: 3, allErrors: true }
+ *   }
+ * };
+ *
+ * const response = await rezo.request(config);
+ * ```
+ */
+export interface CurlRequestConfig extends RezoRequestConfig {
+	/**
+	 * cURL-specific options
+	 *
+	 * @remarks
+	 * These options are only available when using the cURL adapter.
+	 * They provide fine-grained control over cURL command-line behavior
+	 * and will override internal defaults when set.
+	 *
+	 * Options that are handled internally and should NOT be set here:
+	 * - Headers → Use `headers` option
+	 * - Cookies → Use cookie jar or `cookies` option
+	 * - Body/Data → Use `data` or `body` option
+	 * - Output files → Use `saveTo` option
+	 *
+	 * @example
+	 * ```typescript
+	 * import rezo from 'rezo/adapters/curl';
+	 *
+	 * await rezo.get('https://api.example.com/data', {
+	 *   curl: {
+	 *     connectTimeout: 10,
+	 *     limitRate: '500K',
+	 *     retry: { attempts: 3, allErrors: true },
+	 *     ipVersion: 'v4',
+	 *     tcpFastOpen: true,
+	 *     tls: {
+	 *       min: 'tlsv1.2',
+	 *       certStatus: true
+	 *     },
+	 *     resolve: [{ host: 'example.com', port: 443, address: '192.168.1.1' }]
+	 *   }
+	 * });
+	 * ```
+	 */
+	curl?: CurlOptions;
+}
 export declare const isRezoError: typeof RezoError.isRezoError;
 export declare const Cancel: typeof RezoError;
 export declare const CancelToken: {
@@ -3858,6 +6244,7 @@ export declare const VERSION: string;
 declare const rezo: RezoInstance;
 
 export {
+	CurlRequestConfig as RezoRequestConfig,
 	ResponseType$1 as ResponseType,
 	rezo as default,
 };