rezo 1.0.9 → 1.0.10

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

@@ -4219,48 +4219,101 @@ export declare class Rezo {
 	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
 	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
 	/**
-	 * Get all cookies from the cookie jar.
+	 * Get all cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object where keys are domain names and values are
-	 * arrays of Cookie objects for that domain. This provides easy access to
-	 * all stored cookies for inspection, serialization, or manual manipulation.
+	 * 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.
 	 *
-	 * @returns A Cookies object mapping domains to their Cookie arrays
+	 * 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
-	 * // Get all cookies
 	 * const cookies = rezo.getCookies();
 	 *
-	 * // Access cookies for a specific domain
-	 * const exampleCookies = cookies['example.com'];
-	 * if (exampleCookies) {
-	 *   for (const cookie of exampleCookies) {
-	 *     console.log(`${cookie.key}=${cookie.value}`);
-	 *   }
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
 	 * }
 	 *
-	 * // List all domains with cookies
-	 * const domains = Object.keys(cookies);
-	 * console.log('Cookies stored for:', domains);
+	 * // 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);
 	 *
-	 * // Count total cookies
-	 * const totalCookies = Object.values(cookies)
-	 *   .reduce((sum, arr) => sum + arr.length, 0);
-	 * console.log(`Total cookies: ${totalCookies}`);
+	 * // 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"
+	 * }
 	 *
-	 * // Serialize all cookies to JSON
-	 * const serialized = JSON.stringify(cookies);
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
 	 *
-	 * // Check if a specific cookie exists
-	 * const hasSession = cookies['example.com']
-	 *   ?.some(c => c.key === 'session');
+	 * // 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/index.cjs

@@ -1,6 +1,6 @@
-const _mod_a49tp0 = require('./picker.cjs');
-exports.detectRuntime = _mod_a49tp0.detectRuntime;
-exports.getAdapterCapabilities = _mod_a49tp0.getAdapterCapabilities;
-exports.buildAdapterContext = _mod_a49tp0.buildAdapterContext;
-exports.getAvailableAdapters = _mod_a49tp0.getAvailableAdapters;
-exports.selectAdapter = _mod_a49tp0.selectAdapter;;
+const _mod_f2hgfc = require('./picker.cjs');
+exports.detectRuntime = _mod_f2hgfc.detectRuntime;
+exports.getAdapterCapabilities = _mod_f2hgfc.getAdapterCapabilities;
+exports.buildAdapterContext = _mod_f2hgfc.buildAdapterContext;
+exports.getAvailableAdapters = _mod_f2hgfc.getAvailableAdapters;
+exports.selectAdapter = _mod_f2hgfc.selectAdapter;;

package/dist/cache/index.cjs

@@ -1,13 +1,13 @@
-const _mod_jyz6s4 = require('./lru-cache.cjs');
-exports.LRUCache = _mod_jyz6s4.LRUCache;;
-const _mod_a0ftbg = require('./dns-cache.cjs');
-exports.DNSCache = _mod_a0ftbg.DNSCache;
-exports.getGlobalDNSCache = _mod_a0ftbg.getGlobalDNSCache;
-exports.resetGlobalDNSCache = _mod_a0ftbg.resetGlobalDNSCache;;
-const _mod_knf7z5 = require('./response-cache.cjs');
-exports.ResponseCache = _mod_knf7z5.ResponseCache;
-exports.normalizeResponseCacheConfig = _mod_knf7z5.normalizeResponseCacheConfig;;
-const _mod_a13exp = require('./file-cacher.cjs');
-exports.FileCacher = _mod_a13exp.FileCacher;;
-const _mod_6bj6sb = require('./url-store.cjs');
-exports.UrlStore = _mod_6bj6sb.UrlStore;;
+const _mod_vpvlaj = require('./lru-cache.cjs');
+exports.LRUCache = _mod_vpvlaj.LRUCache;;
+const _mod_37phlu = require('./dns-cache.cjs');
+exports.DNSCache = _mod_37phlu.DNSCache;
+exports.getGlobalDNSCache = _mod_37phlu.getGlobalDNSCache;
+exports.resetGlobalDNSCache = _mod_37phlu.resetGlobalDNSCache;;
+const _mod_23ag1b = require('./response-cache.cjs');
+exports.ResponseCache = _mod_23ag1b.ResponseCache;
+exports.normalizeResponseCacheConfig = _mod_23ag1b.normalizeResponseCacheConfig;;
+const _mod_ni47l3 = require('./file-cacher.cjs');
+exports.FileCacher = _mod_ni47l3.FileCacher;;
+const _mod_pgav4z = require('./url-store.cjs');
+exports.UrlStore = _mod_pgav4z.UrlStore;;

package/dist/core/rezo.cjs

@@ -404,6 +404,9 @@ class Rezo {
   getCookies() {
     return this.jar.cookies();
   }
+  clearCookies() {
+    this.jar?.removeAllCookiesSync();
+  }
 }
 const defaultTransforms = exports.defaultTransforms = {
   request: [

package/dist/core/rezo.js

@@ -404,6 +404,9 @@ export class Rezo {
   getCookies() {
     return this.jar.cookies();
   }
+  clearCookies() {
+    this.jar?.removeAllCookiesSync();
+  }
 }
 export const defaultTransforms = {
   request: [

package/dist/crawler.d.ts

@@ -4334,48 +4334,101 @@ declare class Rezo {
 	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
 	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
 	/**
-	 * Get all cookies from the cookie jar.
+	 * Get all cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object where keys are domain names and values are
-	 * arrays of Cookie objects for that domain. This provides easy access to
-	 * all stored cookies for inspection, serialization, or manual manipulation.
+	 * 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.
 	 *
-	 * @returns A Cookies object mapping domains to their Cookie arrays
+	 * 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
-	 * // Get all cookies
 	 * const cookies = rezo.getCookies();
 	 *
-	 * // Access cookies for a specific domain
-	 * const exampleCookies = cookies['example.com'];
-	 * if (exampleCookies) {
-	 *   for (const cookie of exampleCookies) {
-	 *     console.log(`${cookie.key}=${cookie.value}`);
-	 *   }
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
 	 * }
 	 *
-	 * // List all domains with cookies
-	 * const domains = Object.keys(cookies);
-	 * console.log('Cookies stored for:', domains);
+	 * // 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);
 	 *
-	 * // Count total cookies
-	 * const totalCookies = Object.values(cookies)
-	 *   .reduce((sum, arr) => sum + arr.length, 0);
-	 * console.log(`Total cookies: ${totalCookies}`);
+	 * // 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"
+	 * }
 	 *
-	 * // Serialize all cookies to JSON
-	 * const serialized = JSON.stringify(cookies);
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
 	 *
-	 * // Check if a specific cookie exists
-	 * const hasSession = cookies['example.com']
-	 *   ?.some(c => c.key === 'session');
+	 * // 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;
 }
 /**
  * Rezo HTTP Client - Core Types

package/dist/entries/crawler.cjs

@@ -1,5 +1,5 @@
-const _mod_ap8v7n = require('../plugin/crawler.cjs');
-exports.Crawler = _mod_ap8v7n.Crawler;;
-const _mod_ldttq4 = require('../plugin/crawler-options.cjs');
-exports.CrawlerOptions = _mod_ldttq4.CrawlerOptions;
-exports.Domain = _mod_ldttq4.Domain;;
+const _mod_f905u8 = require('../plugin/crawler.cjs');
+exports.Crawler = _mod_f905u8.Crawler;;
+const _mod_885b6l = require('../plugin/crawler-options.cjs');
+exports.CrawlerOptions = _mod_885b6l.CrawlerOptions;
+exports.Domain = _mod_885b6l.Domain;;

package/dist/index.cjs

@@ -1,27 +1,27 @@
-const _mod_7p8ab6 = require('./core/rezo.cjs');
-exports.Rezo = _mod_7p8ab6.Rezo;
-exports.createRezoInstance = _mod_7p8ab6.createRezoInstance;
-exports.createDefaultInstance = _mod_7p8ab6.createDefaultInstance;;
-const _mod_gwad13 = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_gwad13.RezoError;
-exports.RezoErrorCode = _mod_gwad13.RezoErrorCode;;
-const _mod_0u5sf4 = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_0u5sf4.RezoHeaders;;
-const _mod_y55mzr = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_y55mzr.RezoFormData;;
-const _mod_8ixff7 = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_8ixff7.RezoCookieJar;
-exports.Cookie = _mod_8ixff7.Cookie;;
-const _mod_6glzgm = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_6glzgm.createDefaultHooks;
-exports.mergeHooks = _mod_6glzgm.mergeHooks;;
-const _mod_k6rnmv = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_k6rnmv.ProxyManager;;
-const _mod_mjbdct = require('./queue/index.cjs');
-exports.RezoQueue = _mod_mjbdct.RezoQueue;
-exports.HttpQueue = _mod_mjbdct.HttpQueue;
-exports.Priority = _mod_mjbdct.Priority;
-exports.HttpMethodPriority = _mod_mjbdct.HttpMethodPriority;;
+const _mod_3dvs8m = require('./core/rezo.cjs');
+exports.Rezo = _mod_3dvs8m.Rezo;
+exports.createRezoInstance = _mod_3dvs8m.createRezoInstance;
+exports.createDefaultInstance = _mod_3dvs8m.createDefaultInstance;;
+const _mod_r7o6q6 = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_r7o6q6.RezoError;
+exports.RezoErrorCode = _mod_r7o6q6.RezoErrorCode;;
+const _mod_6y2l73 = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_6y2l73.RezoHeaders;;
+const _mod_5033qo = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_5033qo.RezoFormData;;
+const _mod_wvl5qh = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_wvl5qh.RezoCookieJar;
+exports.Cookie = _mod_wvl5qh.Cookie;;
+const _mod_gqvwg5 = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_gqvwg5.createDefaultHooks;
+exports.mergeHooks = _mod_gqvwg5.mergeHooks;;
+const _mod_xy25q8 = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_xy25q8.ProxyManager;;
+const _mod_k77c7o = require('./queue/index.cjs');
+exports.RezoQueue = _mod_k77c7o.RezoQueue;
+exports.HttpQueue = _mod_k77c7o.HttpQueue;
+exports.Priority = _mod_k77c7o.Priority;
+exports.HttpMethodPriority = _mod_k77c7o.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;

package/dist/index.d.ts

@@ -4364,48 +4364,101 @@ export declare class Rezo {
 	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
 	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
 	/**
-	 * Get all cookies from the cookie jar.
+	 * Get all cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object where keys are domain names and values are
-	 * arrays of Cookie objects for that domain. This provides easy access to
-	 * all stored cookies for inspection, serialization, or manual manipulation.
+	 * 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.
 	 *
-	 * @returns A Cookies object mapping domains to their Cookie arrays
+	 * 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
-	 * // Get all cookies
 	 * const cookies = rezo.getCookies();
 	 *
-	 * // Access cookies for a specific domain
-	 * const exampleCookies = cookies['example.com'];
-	 * if (exampleCookies) {
-	 *   for (const cookie of exampleCookies) {
-	 *     console.log(`${cookie.key}=${cookie.value}`);
-	 *   }
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
 	 * }
 	 *
-	 * // List all domains with cookies
-	 * const domains = Object.keys(cookies);
-	 * console.log('Cookies stored for:', domains);
+	 * // 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);
 	 *
-	 * // Count total cookies
-	 * const totalCookies = Object.values(cookies)
-	 *   .reduce((sum, arr) => sum + arr.length, 0);
-	 * console.log(`Total cookies: ${totalCookies}`);
+	 * // 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"
+	 * }
 	 *
-	 * // Serialize all cookies to JSON
-	 * const serialized = JSON.stringify(cookies);
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
 	 *
-	 * // Check if a specific cookie exists
-	 * const hasSession = cookies['example.com']
-	 *   ?.some(c => c.key === 'session');
+	 * // 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/platform/browser.d.ts

@@ -4219,48 +4219,101 @@ export declare class Rezo {
 	setCookies(setCookieArray: string[], url: string, startNew?: boolean): void;
 	setCookies(setCookieArray: string[], url: string | undefined, startNew: boolean): void;
 	/**
-	 * Get all cookies from the cookie jar.
+	 * Get all cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object where keys are domain names and values are
-	 * arrays of Cookie objects for that domain. This provides easy access to
-	 * all stored cookies for inspection, serialization, or manual manipulation.
+	 * 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.
 	 *
-	 * @returns A Cookies object mapping domains to their Cookie arrays
+	 * 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
-	 * // Get all cookies
 	 * const cookies = rezo.getCookies();
 	 *
-	 * // Access cookies for a specific domain
-	 * const exampleCookies = cookies['example.com'];
-	 * if (exampleCookies) {
-	 *   for (const cookie of exampleCookies) {
-	 *     console.log(`${cookie.key}=${cookie.value}`);
-	 *   }
+	 * // Access as Cookie instances for programmatic use
+	 * for (const cookie of cookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value} (expires: ${cookie.expires})`);
 	 * }
 	 *
-	 * // List all domains with cookies
-	 * const domains = Object.keys(cookies);
-	 * console.log('Cookies stored for:', domains);
+	 * // 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);
 	 *
-	 * // Count total cookies
-	 * const totalCookies = Object.values(cookies)
-	 *   .reduce((sum, arr) => sum + arr.length, 0);
-	 * console.log(`Total cookies: ${totalCookies}`);
+	 * // 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"
+	 * }
 	 *
-	 * // Serialize all cookies to JSON
-	 * const serialized = JSON.stringify(cookies);
+	 * // Check cookie count
+	 * console.log(`Total cookies: ${cookies.array.length}`);
 	 *
-	 * // Check if a specific cookie exists
-	 * const hasSession = cookies['example.com']
-	 *   ?.some(c => c.key === 'session');
+	 * // 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.