rezo 1.0.9 → 1.0.11

package/dist/index.d.ts

@@ -4249,6 +4249,7 @@ export declare class Rezo {
 	private __create;
 	/** Get the cookie jar for this instance */
 	get cookieJar(): RezoCookieJar;
+	set cookieJar(jar: RezoCookieJar);
 	/**
 	 * Save cookies to file (if cookieFile is configured).
 	 * Can also specify a different path to save to.
@@ -4364,48 +4365,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

@@ -4104,6 +4104,7 @@ export declare class Rezo {
 	private __create;
 	/** Get the cookie jar for this instance */
 	get cookieJar(): RezoCookieJar;
+	set cookieJar(jar: RezoCookieJar);
 	/**
 	 * Save cookies to file (if cookieFile is configured).
 	 * Can also specify a different path to save to.
@@ -4219,48 +4220,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/bun.d.ts

@@ -4104,6 +4104,7 @@ export declare class Rezo {
 	private __create;
 	/** Get the cookie jar for this instance */
 	get cookieJar(): RezoCookieJar;
+	set cookieJar(jar: RezoCookieJar);
 	/**
 	 * Save cookies to file (if cookieFile is configured).
 	 * Can also specify a different path to save to.
@@ -4219,48 +4220,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/deno.d.ts

@@ -4104,6 +4104,7 @@ export declare class Rezo {
 	private __create;
 	/** Get the cookie jar for this instance */
 	get cookieJar(): RezoCookieJar;
+	set cookieJar(jar: RezoCookieJar);
 	/**
 	 * Save cookies to file (if cookieFile is configured).
 	 * Can also specify a different path to save to.
@@ -4219,48 +4220,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.