rezo 1.0.8 → 1.0.10

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

@@ -4162,6 +4162,158 @@ export declare class Rezo {
 	 * ```
 	 */
 	upload(url: string | URL, data: Buffer | FormData | RezoFormData | string | Record<string, any>, options?: RezoHttpRequest): RezoUploadResponse;
+	/**
+	 * Set cookies in the cookie jar from various input formats.
+	 *
+	 * This method accepts multiple input formats for maximum flexibility:
+	 * - **Netscape cookie file content** (string): Full cookie file content in Netscape format
+	 * - **Set-Cookie header array** (string[]): Array of Set-Cookie header values
+	 * - **Serialized cookie objects** (SerializedCookie[]): Array of plain objects with cookie properties
+	 * - **Cookie instances** (Cookie[]): Array of Cookie class instances
+	 *
+	 * @param cookies - Cookies to set in one of the supported formats
+	 * @param url - Optional URL context for the cookies (used for domain/path inference)
+	 * @param startNew - If true, clears all existing cookies before setting new ones (default: false)
+	 *
+	 * @example
+	 * ```typescript
+	 * // From Netscape cookie file content
+	 * const netscapeContent = `# Netscape HTTP Cookie File
+	 * .example.com\tTRUE\t/\tFALSE\t0\tsession\tabc123`;
+	 * rezo.setCookies(netscapeContent);
+	 *
+	 * // From Set-Cookie header array
+	 * rezo.setCookies([
+	 *   'session=abc123; Domain=example.com; Path=/; HttpOnly',
+	 *   'user=john; Domain=example.com; Path=/; Max-Age=3600'
+	 * ], 'https://example.com');
+	 *
+	 * // From serialized cookie objects
+	 * rezo.setCookies([
+	 *   { key: 'session', value: 'abc123', domain: 'example.com', path: '/' },
+	 *   { key: 'user', value: 'john', domain: 'example.com', path: '/', maxAge: 3600 }
+	 * ]);
+	 *
+	 * // From Cookie instances
+	 * import { Cookie } from 'rezo';
+	 * const cookie = new Cookie({ key: 'token', value: 'xyz789', domain: 'api.example.com' });
+	 * rezo.setCookies([cookie]);
+	 *
+	 * // Replace all cookies (startNew = true)
+	 * rezo.setCookies([{ key: 'new', value: 'cookie' }], undefined, true);
+	 * ```
+	 *
+	 * @see {@link getCookies} - Retrieve cookies from the jar
+	 * @see {@link RezoCookieJar} - The underlying cookie jar class
+	 */
+	setCookies(stringCookies: string): void;
+	setCookies(stringCookies: string, url: string, startNew?: boolean): void;
+	setCookies(serializedStringCookiesCookies: string, url: string | undefined, startNew: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[]): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string, startNew?: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(cookies: Cookie[]): void;
+	setCookies(cookies: Cookie[], url: string, startNew?: boolean): void;
+	setCookies(cookies: Cookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(setCookieArray: string[]): void;
+	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
+	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
+	/**
+	 * Get all cookies from the cookie jar in multiple convenient formats.
+	 *
+	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * for different use cases. This provides flexible access to cookies for
+	 * HTTP headers, file storage, serialization, or programmatic manipulation.
+	 *
+	 * The returned `Cookies` object contains:
+	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
+	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
+	 * - **netscape**: `string` - Netscape cookie file format for file-based storage
+	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
+	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
+	 *
+	 * @returns A Cookies object with cookies in multiple formats
+	 *
+	 * @example
+	 * ```typescript
+	 * const cookies = rezo.getCookies();
+	 *
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
+	 * }
+	 *
+	 * // Get cookie header string for manual HTTP requests
+	 * console.log(cookies.string); // "session=abc123; user=john"
+	 *
+	 * // Save to Netscape cookie file
+	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 *
+	 * // Serialize to JSON for storage
+	 * const json = JSON.stringify(cookies.serialized);
+	 * localStorage.setItem('cookies', json);
+	 *
+	 * // Get Set-Cookie headers (useful for proxying responses)
+	 * for (const setCookie of cookies.setCookiesString) {
+	 *   console.log(setCookie); // "session=abc123; Domain=example.com; Path=/; HttpOnly"
+	 * }
+	 *
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
+	 *
+	 * // Find specific cookie
+	 * const sessionCookie = cookies.array.find(c => c.key === 'session');
+	 * ```
+	 *
+	 * @see {@link setCookies} - Set cookies in the jar
+	 * @see {@link clearCookies} - Remove all cookies from the jar
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
+	 */
+	getCookies(): Cookies;
+	/**
+	 * Remove all cookies from the cookie jar.
+	 *
+	 * This method synchronously clears the entire cookie store, removing all
+	 * cookies regardless of domain, path, or expiration. Useful for:
+	 * - Logging out users and clearing session state
+	 * - Resetting the client to a clean state between test runs
+	 * - Implementing "clear cookies" functionality in applications
+	 * - Starting fresh before authenticating with different credentials
+	 *
+	 * This operation is immediate and cannot be undone. If you need to preserve
+	 * certain cookies, use {@link getCookies} to save them before clearing,
+	 * then restore specific ones with {@link setCookies}.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Simple logout - clear all cookies
+	 * rezo.clearCookies();
+	 *
+	 * // Save cookies before clearing (if needed)
+	 * const savedCookies = rezo.getCookies();
+	 * rezo.clearCookies();
+	 * // Later, restore specific cookies if needed
+	 * const importantCookies = savedCookies.array.filter(c => c.key === 'preferences');
+	 * rezo.setCookies(importantCookies);
+	 *
+	 * // Clear and re-authenticate
+	 * rezo.clearCookies();
+	 * await rezo.post('https://api.example.com/login', {
+	 *   username: 'newuser',
+	 *   password: 'newpass'
+	 * });
+	 *
+	 * // Use in test teardown
+	 * afterEach(() => {
+	 *   rezo.clearCookies(); // Clean state for next test
+	 * });
+	 * ```
+	 *
+	 * @see {@link getCookies} - Get all cookies before clearing
+	 * @see {@link setCookies} - Restore or set new cookies after clearing
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more control
+	 */
+	clearCookies(): void;
 }
 /**
  * Extended Rezo instance with Axios-compatible static helpers.

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

@@ -4162,6 +4162,158 @@ export declare class Rezo {
 	 * ```
 	 */
 	upload(url: string | URL, data: Buffer | FormData | RezoFormData | string | Record<string, any>, options?: RezoHttpRequest): RezoUploadResponse;
+	/**
+	 * Set cookies in the cookie jar from various input formats.
+	 *
+	 * This method accepts multiple input formats for maximum flexibility:
+	 * - **Netscape cookie file content** (string): Full cookie file content in Netscape format
+	 * - **Set-Cookie header array** (string[]): Array of Set-Cookie header values
+	 * - **Serialized cookie objects** (SerializedCookie[]): Array of plain objects with cookie properties
+	 * - **Cookie instances** (Cookie[]): Array of Cookie class instances
+	 *
+	 * @param cookies - Cookies to set in one of the supported formats
+	 * @param url - Optional URL context for the cookies (used for domain/path inference)
+	 * @param startNew - If true, clears all existing cookies before setting new ones (default: false)
+	 *
+	 * @example
+	 * ```typescript
+	 * // From Netscape cookie file content
+	 * const netscapeContent = `# Netscape HTTP Cookie File
+	 * .example.com\tTRUE\t/\tFALSE\t0\tsession\tabc123`;
+	 * rezo.setCookies(netscapeContent);
+	 *
+	 * // From Set-Cookie header array
+	 * rezo.setCookies([
+	 *   'session=abc123; Domain=example.com; Path=/; HttpOnly',
+	 *   'user=john; Domain=example.com; Path=/; Max-Age=3600'
+	 * ], 'https://example.com');
+	 *
+	 * // From serialized cookie objects
+	 * rezo.setCookies([
+	 *   { key: 'session', value: 'abc123', domain: 'example.com', path: '/' },
+	 *   { key: 'user', value: 'john', domain: 'example.com', path: '/', maxAge: 3600 }
+	 * ]);
+	 *
+	 * // From Cookie instances
+	 * import { Cookie } from 'rezo';
+	 * const cookie = new Cookie({ key: 'token', value: 'xyz789', domain: 'api.example.com' });
+	 * rezo.setCookies([cookie]);
+	 *
+	 * // Replace all cookies (startNew = true)
+	 * rezo.setCookies([{ key: 'new', value: 'cookie' }], undefined, true);
+	 * ```
+	 *
+	 * @see {@link getCookies} - Retrieve cookies from the jar
+	 * @see {@link RezoCookieJar} - The underlying cookie jar class
+	 */
+	setCookies(stringCookies: string): void;
+	setCookies(stringCookies: string, url: string, startNew?: boolean): void;
+	setCookies(serializedStringCookiesCookies: string, url: string | undefined, startNew: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[]): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string, startNew?: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(cookies: Cookie[]): void;
+	setCookies(cookies: Cookie[], url: string, startNew?: boolean): void;
+	setCookies(cookies: Cookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(setCookieArray: string[]): void;
+	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
+	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
+	/**
+	 * Get all cookies from the cookie jar in multiple convenient formats.
+	 *
+	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * for different use cases. This provides flexible access to cookies for
+	 * HTTP headers, file storage, serialization, or programmatic manipulation.
+	 *
+	 * The returned `Cookies` object contains:
+	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
+	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
+	 * - **netscape**: `string` - Netscape cookie file format for file-based storage
+	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
+	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
+	 *
+	 * @returns A Cookies object with cookies in multiple formats
+	 *
+	 * @example
+	 * ```typescript
+	 * const cookies = rezo.getCookies();
+	 *
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
+	 * }
+	 *
+	 * // Get cookie header string for manual HTTP requests
+	 * console.log(cookies.string); // "session=abc123; user=john"
+	 *
+	 * // Save to Netscape cookie file
+	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 *
+	 * // Serialize to JSON for storage
+	 * const json = JSON.stringify(cookies.serialized);
+	 * localStorage.setItem('cookies', json);
+	 *
+	 * // Get Set-Cookie headers (useful for proxying responses)
+	 * for (const setCookie of cookies.setCookiesString) {
+	 *   console.log(setCookie); // "session=abc123; Domain=example.com; Path=/; HttpOnly"
+	 * }
+	 *
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
+	 *
+	 * // Find specific cookie
+	 * const sessionCookie = cookies.array.find(c => c.key === 'session');
+	 * ```
+	 *
+	 * @see {@link setCookies} - Set cookies in the jar
+	 * @see {@link clearCookies} - Remove all cookies from the jar
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
+	 */
+	getCookies(): Cookies;
+	/**
+	 * Remove all cookies from the cookie jar.
+	 *
+	 * This method synchronously clears the entire cookie store, removing all
+	 * cookies regardless of domain, path, or expiration. Useful for:
+	 * - Logging out users and clearing session state
+	 * - Resetting the client to a clean state between test runs
+	 * - Implementing "clear cookies" functionality in applications
+	 * - Starting fresh before authenticating with different credentials
+	 *
+	 * This operation is immediate and cannot be undone. If you need to preserve
+	 * certain cookies, use {@link getCookies} to save them before clearing,
+	 * then restore specific ones with {@link setCookies}.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Simple logout - clear all cookies
+	 * rezo.clearCookies();
+	 *
+	 * // Save cookies before clearing (if needed)
+	 * const savedCookies = rezo.getCookies();
+	 * rezo.clearCookies();
+	 * // Later, restore specific cookies if needed
+	 * const importantCookies = savedCookies.array.filter(c => c.key === 'preferences');
+	 * rezo.setCookies(importantCookies);
+	 *
+	 * // Clear and re-authenticate
+	 * rezo.clearCookies();
+	 * await rezo.post('https://api.example.com/login', {
+	 *   username: 'newuser',
+	 *   password: 'newpass'
+	 * });
+	 *
+	 * // Use in test teardown
+	 * afterEach(() => {
+	 *   rezo.clearCookies(); // Clean state for next test
+	 * });
+	 * ```
+	 *
+	 * @see {@link getCookies} - Get all cookies before clearing
+	 * @see {@link setCookies} - Restore or set new cookies after clearing
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more control
+	 */
+	clearCookies(): void;
 }
 /**
  * Extended Rezo instance with Axios-compatible static helpers.

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

@@ -4162,6 +4162,158 @@ export declare class Rezo {
 	 * ```
 	 */
 	upload(url: string | URL, data: Buffer | FormData | RezoFormData | string | Record<string, any>, options?: RezoHttpRequest): RezoUploadResponse;
+	/**
+	 * Set cookies in the cookie jar from various input formats.
+	 *
+	 * This method accepts multiple input formats for maximum flexibility:
+	 * - **Netscape cookie file content** (string): Full cookie file content in Netscape format
+	 * - **Set-Cookie header array** (string[]): Array of Set-Cookie header values
+	 * - **Serialized cookie objects** (SerializedCookie[]): Array of plain objects with cookie properties
+	 * - **Cookie instances** (Cookie[]): Array of Cookie class instances
+	 *
+	 * @param cookies - Cookies to set in one of the supported formats
+	 * @param url - Optional URL context for the cookies (used for domain/path inference)
+	 * @param startNew - If true, clears all existing cookies before setting new ones (default: false)
+	 *
+	 * @example
+	 * ```typescript
+	 * // From Netscape cookie file content
+	 * const netscapeContent = `# Netscape HTTP Cookie File
+	 * .example.com\tTRUE\t/\tFALSE\t0\tsession\tabc123`;
+	 * rezo.setCookies(netscapeContent);
+	 *
+	 * // From Set-Cookie header array
+	 * rezo.setCookies([
+	 *   'session=abc123; Domain=example.com; Path=/; HttpOnly',
+	 *   'user=john; Domain=example.com; Path=/; Max-Age=3600'
+	 * ], 'https://example.com');
+	 *
+	 * // From serialized cookie objects
+	 * rezo.setCookies([
+	 *   { key: 'session', value: 'abc123', domain: 'example.com', path: '/' },
+	 *   { key: 'user', value: 'john', domain: 'example.com', path: '/', maxAge: 3600 }
+	 * ]);
+	 *
+	 * // From Cookie instances
+	 * import { Cookie } from 'rezo';
+	 * const cookie = new Cookie({ key: 'token', value: 'xyz789', domain: 'api.example.com' });
+	 * rezo.setCookies([cookie]);
+	 *
+	 * // Replace all cookies (startNew = true)
+	 * rezo.setCookies([{ key: 'new', value: 'cookie' }], undefined, true);
+	 * ```
+	 *
+	 * @see {@link getCookies} - Retrieve cookies from the jar
+	 * @see {@link RezoCookieJar} - The underlying cookie jar class
+	 */
+	setCookies(stringCookies: string): void;
+	setCookies(stringCookies: string, url: string, startNew?: boolean): void;
+	setCookies(serializedStringCookiesCookies: string, url: string | undefined, startNew: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[]): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string, startNew?: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(cookies: Cookie[]): void;
+	setCookies(cookies: Cookie[], url: string, startNew?: boolean): void;
+	setCookies(cookies: Cookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(setCookieArray: string[]): void;
+	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
+	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
+	/**
+	 * Get all cookies from the cookie jar in multiple convenient formats.
+	 *
+	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * for different use cases. This provides flexible access to cookies for
+	 * HTTP headers, file storage, serialization, or programmatic manipulation.
+	 *
+	 * The returned `Cookies` object contains:
+	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
+	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
+	 * - **netscape**: `string` - Netscape cookie file format for file-based storage
+	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
+	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
+	 *
+	 * @returns A Cookies object with cookies in multiple formats
+	 *
+	 * @example
+	 * ```typescript
+	 * const cookies = rezo.getCookies();
+	 *
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
+	 * }
+	 *
+	 * // Get cookie header string for manual HTTP requests
+	 * console.log(cookies.string); // "session=abc123; user=john"
+	 *
+	 * // Save to Netscape cookie file
+	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 *
+	 * // Serialize to JSON for storage
+	 * const json = JSON.stringify(cookies.serialized);
+	 * localStorage.setItem('cookies', json);
+	 *
+	 * // Get Set-Cookie headers (useful for proxying responses)
+	 * for (const setCookie of cookies.setCookiesString) {
+	 *   console.log(setCookie); // "session=abc123; Domain=example.com; Path=/; HttpOnly"
+	 * }
+	 *
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
+	 *
+	 * // Find specific cookie
+	 * const sessionCookie = cookies.array.find(c => c.key === 'session');
+	 * ```
+	 *
+	 * @see {@link setCookies} - Set cookies in the jar
+	 * @see {@link clearCookies} - Remove all cookies from the jar
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
+	 */
+	getCookies(): Cookies;
+	/**
+	 * Remove all cookies from the cookie jar.
+	 *
+	 * This method synchronously clears the entire cookie store, removing all
+	 * cookies regardless of domain, path, or expiration. Useful for:
+	 * - Logging out users and clearing session state
+	 * - Resetting the client to a clean state between test runs
+	 * - Implementing "clear cookies" functionality in applications
+	 * - Starting fresh before authenticating with different credentials
+	 *
+	 * This operation is immediate and cannot be undone. If you need to preserve
+	 * certain cookies, use {@link getCookies} to save them before clearing,
+	 * then restore specific ones with {@link setCookies}.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Simple logout - clear all cookies
+	 * rezo.clearCookies();
+	 *
+	 * // Save cookies before clearing (if needed)
+	 * const savedCookies = rezo.getCookies();
+	 * rezo.clearCookies();
+	 * // Later, restore specific cookies if needed
+	 * const importantCookies = savedCookies.array.filter(c => c.key === 'preferences');
+	 * rezo.setCookies(importantCookies);
+	 *
+	 * // Clear and re-authenticate
+	 * rezo.clearCookies();
+	 * await rezo.post('https://api.example.com/login', {
+	 *   username: 'newuser',
+	 *   password: 'newpass'
+	 * });
+	 *
+	 * // Use in test teardown
+	 * afterEach(() => {
+	 *   rezo.clearCookies(); // Clean state for next test
+	 * });
+	 * ```
+	 *
+	 * @see {@link getCookies} - Get all cookies before clearing
+	 * @see {@link setCookies} - Restore or set new cookies after clearing
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more control
+	 */
+	clearCookies(): void;
 }
 /**
  * Extended Rezo instance with Axios-compatible static helpers.

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

@@ -4162,6 +4162,158 @@ export declare class Rezo {
 	 * ```
 	 */
 	upload(url: string | URL, data: Buffer | FormData | RezoFormData | string | Record<string, any>, options?: RezoHttpRequest): RezoUploadResponse;
+	/**
+	 * Set cookies in the cookie jar from various input formats.
+	 *
+	 * This method accepts multiple input formats for maximum flexibility:
+	 * - **Netscape cookie file content** (string): Full cookie file content in Netscape format
+	 * - **Set-Cookie header array** (string[]): Array of Set-Cookie header values
+	 * - **Serialized cookie objects** (SerializedCookie[]): Array of plain objects with cookie properties
+	 * - **Cookie instances** (Cookie[]): Array of Cookie class instances
+	 *
+	 * @param cookies - Cookies to set in one of the supported formats
+	 * @param url - Optional URL context for the cookies (used for domain/path inference)
+	 * @param startNew - If true, clears all existing cookies before setting new ones (default: false)
+	 *
+	 * @example
+	 * ```typescript
+	 * // From Netscape cookie file content
+	 * const netscapeContent = `# Netscape HTTP Cookie File
+	 * .example.com\tTRUE\t/\tFALSE\t0\tsession\tabc123`;
+	 * rezo.setCookies(netscapeContent);
+	 *
+	 * // From Set-Cookie header array
+	 * rezo.setCookies([
+	 *   'session=abc123; Domain=example.com; Path=/; HttpOnly',
+	 *   'user=john; Domain=example.com; Path=/; Max-Age=3600'
+	 * ], 'https://example.com');
+	 *
+	 * // From serialized cookie objects
+	 * rezo.setCookies([
+	 *   { key: 'session', value: 'abc123', domain: 'example.com', path: '/' },
+	 *   { key: 'user', value: 'john', domain: 'example.com', path: '/', maxAge: 3600 }
+	 * ]);
+	 *
+	 * // From Cookie instances
+	 * import { Cookie } from 'rezo';
+	 * const cookie = new Cookie({ key: 'token', value: 'xyz789', domain: 'api.example.com' });
+	 * rezo.setCookies([cookie]);
+	 *
+	 * // Replace all cookies (startNew = true)
+	 * rezo.setCookies([{ key: 'new', value: 'cookie' }], undefined, true);
+	 * ```
+	 *
+	 * @see {@link getCookies} - Retrieve cookies from the jar
+	 * @see {@link RezoCookieJar} - The underlying cookie jar class
+	 */
+	setCookies(stringCookies: string): void;
+	setCookies(stringCookies: string, url: string, startNew?: boolean): void;
+	setCookies(serializedStringCookiesCookies: string, url: string | undefined, startNew: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[]): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string, startNew?: boolean): void;
+	setCookies(serializedCookies: SerializedCookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(cookies: Cookie[]): void;
+	setCookies(cookies: Cookie[], url: string, startNew?: boolean): void;
+	setCookies(cookies: Cookie[], url: string | undefined, startNew: boolean): void;
+	setCookies(setCookieArray: string[]): void;
+	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
+	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
+	/**
+	 * Get all cookies from the cookie jar in multiple convenient formats.
+	 *
+	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * for different use cases. This provides flexible access to cookies for
+	 * HTTP headers, file storage, serialization, or programmatic manipulation.
+	 *
+	 * The returned `Cookies` object contains:
+	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
+	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
+	 * - **netscape**: `string` - Netscape cookie file format for file-based storage
+	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
+	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
+	 *
+	 * @returns A Cookies object with cookies in multiple formats
+	 *
+	 * @example
+	 * ```typescript
+	 * const cookies = rezo.getCookies();
+	 *
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
+	 * }
+	 *
+	 * // Get cookie header string for manual HTTP requests
+	 * console.log(cookies.string); // "session=abc123; user=john"
+	 *
+	 * // Save to Netscape cookie file
+	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 *
+	 * // Serialize to JSON for storage
+	 * const json = JSON.stringify(cookies.serialized);
+	 * localStorage.setItem('cookies', json);
+	 *
+	 * // Get Set-Cookie headers (useful for proxying responses)
+	 * for (const setCookie of cookies.setCookiesString) {
+	 *   console.log(setCookie); // "session=abc123; Domain=example.com; Path=/; HttpOnly"
+	 * }
+	 *
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
+	 *
+	 * // Find specific cookie
+	 * const sessionCookie = cookies.array.find(c => c.key === 'session');
+	 * ```
+	 *
+	 * @see {@link setCookies} - Set cookies in the jar
+	 * @see {@link clearCookies} - Remove all cookies from the jar
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
+	 */
+	getCookies(): Cookies;
+	/**
+	 * Remove all cookies from the cookie jar.
+	 *
+	 * This method synchronously clears the entire cookie store, removing all
+	 * cookies regardless of domain, path, or expiration. Useful for:
+	 * - Logging out users and clearing session state
+	 * - Resetting the client to a clean state between test runs
+	 * - Implementing "clear cookies" functionality in applications
+	 * - Starting fresh before authenticating with different credentials
+	 *
+	 * This operation is immediate and cannot be undone. If you need to preserve
+	 * certain cookies, use {@link getCookies} to save them before clearing,
+	 * then restore specific ones with {@link setCookies}.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Simple logout - clear all cookies
+	 * rezo.clearCookies();
+	 *
+	 * // Save cookies before clearing (if needed)
+	 * const savedCookies = rezo.getCookies();
+	 * rezo.clearCookies();
+	 * // Later, restore specific cookies if needed
+	 * const importantCookies = savedCookies.array.filter(c => c.key === 'preferences');
+	 * rezo.setCookies(importantCookies);
+	 *
+	 * // Clear and re-authenticate
+	 * rezo.clearCookies();
+	 * await rezo.post('https://api.example.com/login', {
+	 *   username: 'newuser',
+	 *   password: 'newpass'
+	 * });
+	 *
+	 * // Use in test teardown
+	 * afterEach(() => {
+	 *   rezo.clearCookies(); // Clean state for next test
+	 * });
+	 * ```
+	 *
+	 * @see {@link getCookies} - Get all cookies before clearing
+	 * @see {@link setCookies} - Restore or set new cookies after clearing
+	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more control
+	 */
+	clearCookies(): void;
 }
 /**
  * Extended Rezo instance with Axios-compatible static helpers.