rezo 1.0.38 → 1.0.39

package/dist/crawler.d.ts

@@ -415,7 +415,17 @@ declare class RezoCookieJar extends TouchCookieJar {
 	constructor(cookies: Cookie[]);
 	constructor(cookies: Cookie[], url: string);
 	private generateCookies;
-	cookies(): Cookies;
+	/**
+	 * Get all cookies from the cookie jar.
+	 *
+	 * This method synchronously returns all cookies stored in the jar,
+	 * including both regular and touch cookies.
+	 *
+	 * @returns {Cookies} An object containing arrays of all cookies,
+	 * serialized representations, Netscape format strings, and set-cookie strings
+	 * @see {@link getCookiesForRequest} - Get cookies for a specific request URL
+	 */
+	cookies(url?: string): Cookies;
 	parseResponseCookies(cookies: Cookie[]): Cookies;
 	static toNetscapeCookie(cookies: Cookie[] | SerializedCookie[]): string;
 	static toCookieString(cookies: Cookie[] | SerializedCookie[]): string;
@@ -4362,12 +4372,16 @@ 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 in multiple convenient formats.
+	 * Get cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * Returns a `Cookies` object containing stored cookies in various formats
 	 * for different use cases. This provides flexible access to cookies for
 	 * HTTP headers, file storage, serialization, or programmatic manipulation.
 	 *
+	 * If a `url` is provided, only cookies valid for that URL (matching domain, path,
+	 * expiration, etc.) are returned. If no `url` is provided, all cookies in the
+	 * jar are returned.
+	 *
 	 * The returned `Cookies` object contains:
 	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
 	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
@@ -4375,37 +4389,29 @@ declare class Rezo {
 	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
 	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
 	 *
+	 * @param url - Optional URL to filter cookies. If provided, returns only cookies valid for this URL.
 	 * @returns A Cookies object with cookies in multiple formats
 	 *
 	 * @example
 	 * ```typescript
-	 * const cookies = rezo.getCookies();
+	 * // Get ALL cookies in the jar
+	 * const allCookies = 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 cookies valid for a specific URL
+	 * const googleCookies = rezo.getCookies('https://google.com');
+	 * console.log(googleCookies.string); // Only sends valid cookies for google.com
 	 *
-	 * // Get cookie header string for manual HTTP requests
-	 * console.log(cookies.string); // "session=abc123; user=john"
+	 * // Access as Cookie instances
+	 * for (const cookie of allCookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value}`);
+	 * }
 	 *
 	 * // Save to Netscape cookie file
-	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 * fs.writeFileSync('cookies.txt', allCookies.netscape);
 	 *
 	 * // Serialize to JSON for storage
-	 * const json = JSON.stringify(cookies.serialized);
+	 * const json = JSON.stringify(allCookies.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
@@ -4413,6 +4419,7 @@ declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
 	 */
 	getCookies(): Cookies;
+	getCookies(url: string): Cookies;
 	/**
 	 * Remove all cookies from the cookie jar.
 	 *

package/dist/entries/crawler.cjs

@@ -1,5 +1,5 @@
-const _mod_yx52v2 = require('../plugin/crawler.cjs');
-exports.Crawler = _mod_yx52v2.Crawler;;
-const _mod_kknzs3 = require('../plugin/crawler-options.cjs');
-exports.CrawlerOptions = _mod_kknzs3.CrawlerOptions;
-exports.Domain = _mod_kknzs3.Domain;;
+const _mod_op8xhh = require('../plugin/crawler.cjs');
+exports.Crawler = _mod_op8xhh.Crawler;;
+const _mod_xqqgin = require('../plugin/crawler-options.cjs');
+exports.CrawlerOptions = _mod_xqqgin.CrawlerOptions;
+exports.Domain = _mod_xqqgin.Domain;;

package/dist/index.cjs

@@ -1,27 +1,27 @@
-const _mod_8kh4v0 = require('./core/rezo.cjs');
-exports.Rezo = _mod_8kh4v0.Rezo;
-exports.createRezoInstance = _mod_8kh4v0.createRezoInstance;
-exports.createDefaultInstance = _mod_8kh4v0.createDefaultInstance;;
-const _mod_qre162 = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_qre162.RezoError;
-exports.RezoErrorCode = _mod_qre162.RezoErrorCode;;
-const _mod_ltk2zp = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_ltk2zp.RezoHeaders;;
-const _mod_rpds6z = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_rpds6z.RezoFormData;;
-const _mod_wn5amd = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_wn5amd.RezoCookieJar;
-exports.Cookie = _mod_wn5amd.Cookie;;
-const _mod_meh3fm = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_meh3fm.createDefaultHooks;
-exports.mergeHooks = _mod_meh3fm.mergeHooks;;
-const _mod_3bs2z2 = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_3bs2z2.ProxyManager;;
-const _mod_o8mlnk = require('./queue/index.cjs');
-exports.RezoQueue = _mod_o8mlnk.RezoQueue;
-exports.HttpQueue = _mod_o8mlnk.HttpQueue;
-exports.Priority = _mod_o8mlnk.Priority;
-exports.HttpMethodPriority = _mod_o8mlnk.HttpMethodPriority;;
+const _mod_efnudx = require('./core/rezo.cjs');
+exports.Rezo = _mod_efnudx.Rezo;
+exports.createRezoInstance = _mod_efnudx.createRezoInstance;
+exports.createDefaultInstance = _mod_efnudx.createDefaultInstance;;
+const _mod_9m0bnr = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_9m0bnr.RezoError;
+exports.RezoErrorCode = _mod_9m0bnr.RezoErrorCode;;
+const _mod_74n3jq = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_74n3jq.RezoHeaders;;
+const _mod_hpz2os = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_hpz2os.RezoFormData;;
+const _mod_dodxxj = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_dodxxj.RezoCookieJar;
+exports.Cookie = _mod_dodxxj.Cookie;;
+const _mod_3s0z06 = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_3s0z06.createDefaultHooks;
+exports.mergeHooks = _mod_3s0z06.mergeHooks;;
+const _mod_id21l4 = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_id21l4.ProxyManager;;
+const _mod_00sahe = require('./queue/index.cjs');
+exports.RezoQueue = _mod_00sahe.RezoQueue;
+exports.HttpQueue = _mod_00sahe.HttpQueue;
+exports.Priority = _mod_00sahe.Priority;
+exports.HttpMethodPriority = _mod_00sahe.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;

package/dist/index.d.ts

@@ -192,7 +192,17 @@ export declare class RezoCookieJar extends TouchCookieJar {
 	constructor(cookies: Cookie[]);
 	constructor(cookies: Cookie[], url: string);
 	private generateCookies;
-	cookies(): Cookies;
+	/**
+	 * Get all cookies from the cookie jar.
+	 *
+	 * This method synchronously returns all cookies stored in the jar,
+	 * including both regular and touch cookies.
+	 *
+	 * @returns {Cookies} An object containing arrays of all cookies,
+	 * serialized representations, Netscape format strings, and set-cookie strings
+	 * @see {@link getCookiesForRequest} - Get cookies for a specific request URL
+	 */
+	cookies(url?: string): Cookies;
 	parseResponseCookies(cookies: Cookie[]): Cookies;
 	static toNetscapeCookie(cookies: Cookie[] | SerializedCookie[]): string;
 	static toCookieString(cookies: Cookie[] | SerializedCookie[]): string;
@@ -4398,12 +4408,16 @@ 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 in multiple convenient formats.
+	 * Get cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * Returns a `Cookies` object containing stored cookies in various formats
 	 * for different use cases. This provides flexible access to cookies for
 	 * HTTP headers, file storage, serialization, or programmatic manipulation.
 	 *
+	 * If a `url` is provided, only cookies valid for that URL (matching domain, path,
+	 * expiration, etc.) are returned. If no `url` is provided, all cookies in the
+	 * jar are returned.
+	 *
 	 * The returned `Cookies` object contains:
 	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
 	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
@@ -4411,37 +4425,29 @@ export declare class Rezo {
 	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
 	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
 	 *
+	 * @param url - Optional URL to filter cookies. If provided, returns only cookies valid for this URL.
 	 * @returns A Cookies object with cookies in multiple formats
 	 *
 	 * @example
 	 * ```typescript
-	 * const cookies = rezo.getCookies();
+	 * // Get ALL cookies in the jar
+	 * const allCookies = 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 cookies valid for a specific URL
+	 * const googleCookies = rezo.getCookies('https://google.com');
+	 * console.log(googleCookies.string); // Only sends valid cookies for google.com
 	 *
-	 * // Get cookie header string for manual HTTP requests
-	 * console.log(cookies.string); // "session=abc123; user=john"
+	 * // Access as Cookie instances
+	 * for (const cookie of allCookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value}`);
+	 * }
 	 *
 	 * // Save to Netscape cookie file
-	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 * fs.writeFileSync('cookies.txt', allCookies.netscape);
 	 *
 	 * // Serialize to JSON for storage
-	 * const json = JSON.stringify(cookies.serialized);
+	 * const json = JSON.stringify(allCookies.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
@@ -4449,6 +4455,7 @@ export declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
 	 */
 	getCookies(): Cookies;
+	getCookies(url: string): Cookies;
 	/**
 	 * Remove all cookies from the cookie jar.
 	 *

package/dist/platform/browser.d.ts

@@ -192,7 +192,17 @@ export declare class RezoCookieJar extends TouchCookieJar {
 	constructor(cookies: Cookie[]);
 	constructor(cookies: Cookie[], url: string);
 	private generateCookies;
-	cookies(): Cookies;
+	/**
+	 * Get all cookies from the cookie jar.
+	 *
+	 * This method synchronously returns all cookies stored in the jar,
+	 * including both regular and touch cookies.
+	 *
+	 * @returns {Cookies} An object containing arrays of all cookies,
+	 * serialized representations, Netscape format strings, and set-cookie strings
+	 * @see {@link getCookiesForRequest} - Get cookies for a specific request URL
+	 */
+	cookies(url?: string): Cookies;
 	parseResponseCookies(cookies: Cookie[]): Cookies;
 	static toNetscapeCookie(cookies: Cookie[] | SerializedCookie[]): string;
 	static toCookieString(cookies: Cookie[] | SerializedCookie[]): string;
@@ -4253,12 +4263,16 @@ 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 in multiple convenient formats.
+	 * Get cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * Returns a `Cookies` object containing stored cookies in various formats
 	 * for different use cases. This provides flexible access to cookies for
 	 * HTTP headers, file storage, serialization, or programmatic manipulation.
 	 *
+	 * If a `url` is provided, only cookies valid for that URL (matching domain, path,
+	 * expiration, etc.) are returned. If no `url` is provided, all cookies in the
+	 * jar are returned.
+	 *
 	 * The returned `Cookies` object contains:
 	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
 	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
@@ -4266,37 +4280,29 @@ export declare class Rezo {
 	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
 	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
 	 *
+	 * @param url - Optional URL to filter cookies. If provided, returns only cookies valid for this URL.
 	 * @returns A Cookies object with cookies in multiple formats
 	 *
 	 * @example
 	 * ```typescript
-	 * const cookies = rezo.getCookies();
+	 * // Get ALL cookies in the jar
+	 * const allCookies = 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 cookies valid for a specific URL
+	 * const googleCookies = rezo.getCookies('https://google.com');
+	 * console.log(googleCookies.string); // Only sends valid cookies for google.com
 	 *
-	 * // Get cookie header string for manual HTTP requests
-	 * console.log(cookies.string); // "session=abc123; user=john"
+	 * // Access as Cookie instances
+	 * for (const cookie of allCookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value}`);
+	 * }
 	 *
 	 * // Save to Netscape cookie file
-	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 * fs.writeFileSync('cookies.txt', allCookies.netscape);
 	 *
 	 * // Serialize to JSON for storage
-	 * const json = JSON.stringify(cookies.serialized);
+	 * const json = JSON.stringify(allCookies.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
@@ -4304,6 +4310,7 @@ export declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
 	 */
 	getCookies(): Cookies;
+	getCookies(url: string): Cookies;
 	/**
 	 * Remove all cookies from the cookie jar.
 	 *

package/dist/platform/bun.d.ts

@@ -192,7 +192,17 @@ export declare class RezoCookieJar extends TouchCookieJar {
 	constructor(cookies: Cookie[]);
 	constructor(cookies: Cookie[], url: string);
 	private generateCookies;
-	cookies(): Cookies;
+	/**
+	 * Get all cookies from the cookie jar.
+	 *
+	 * This method synchronously returns all cookies stored in the jar,
+	 * including both regular and touch cookies.
+	 *
+	 * @returns {Cookies} An object containing arrays of all cookies,
+	 * serialized representations, Netscape format strings, and set-cookie strings
+	 * @see {@link getCookiesForRequest} - Get cookies for a specific request URL
+	 */
+	cookies(url?: string): Cookies;
 	parseResponseCookies(cookies: Cookie[]): Cookies;
 	static toNetscapeCookie(cookies: Cookie[] | SerializedCookie[]): string;
 	static toCookieString(cookies: Cookie[] | SerializedCookie[]): string;
@@ -4253,12 +4263,16 @@ 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 in multiple convenient formats.
+	 * Get cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * Returns a `Cookies` object containing stored cookies in various formats
 	 * for different use cases. This provides flexible access to cookies for
 	 * HTTP headers, file storage, serialization, or programmatic manipulation.
 	 *
+	 * If a `url` is provided, only cookies valid for that URL (matching domain, path,
+	 * expiration, etc.) are returned. If no `url` is provided, all cookies in the
+	 * jar are returned.
+	 *
 	 * The returned `Cookies` object contains:
 	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
 	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
@@ -4266,37 +4280,29 @@ export declare class Rezo {
 	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
 	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
 	 *
+	 * @param url - Optional URL to filter cookies. If provided, returns only cookies valid for this URL.
 	 * @returns A Cookies object with cookies in multiple formats
 	 *
 	 * @example
 	 * ```typescript
-	 * const cookies = rezo.getCookies();
+	 * // Get ALL cookies in the jar
+	 * const allCookies = 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 cookies valid for a specific URL
+	 * const googleCookies = rezo.getCookies('https://google.com');
+	 * console.log(googleCookies.string); // Only sends valid cookies for google.com
 	 *
-	 * // Get cookie header string for manual HTTP requests
-	 * console.log(cookies.string); // "session=abc123; user=john"
+	 * // Access as Cookie instances
+	 * for (const cookie of allCookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value}`);
+	 * }
 	 *
 	 * // Save to Netscape cookie file
-	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 * fs.writeFileSync('cookies.txt', allCookies.netscape);
 	 *
 	 * // Serialize to JSON for storage
-	 * const json = JSON.stringify(cookies.serialized);
+	 * const json = JSON.stringify(allCookies.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
@@ -4304,6 +4310,7 @@ export declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
 	 */
 	getCookies(): Cookies;
+	getCookies(url: string): Cookies;
 	/**
 	 * Remove all cookies from the cookie jar.
 	 *

package/dist/platform/deno.d.ts

@@ -192,7 +192,17 @@ export declare class RezoCookieJar extends TouchCookieJar {
 	constructor(cookies: Cookie[]);
 	constructor(cookies: Cookie[], url: string);
 	private generateCookies;
-	cookies(): Cookies;
+	/**
+	 * Get all cookies from the cookie jar.
+	 *
+	 * This method synchronously returns all cookies stored in the jar,
+	 * including both regular and touch cookies.
+	 *
+	 * @returns {Cookies} An object containing arrays of all cookies,
+	 * serialized representations, Netscape format strings, and set-cookie strings
+	 * @see {@link getCookiesForRequest} - Get cookies for a specific request URL
+	 */
+	cookies(url?: string): Cookies;
 	parseResponseCookies(cookies: Cookie[]): Cookies;
 	static toNetscapeCookie(cookies: Cookie[] | SerializedCookie[]): string;
 	static toCookieString(cookies: Cookie[] | SerializedCookie[]): string;
@@ -4253,12 +4263,16 @@ 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 in multiple convenient formats.
+	 * Get cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * Returns a `Cookies` object containing stored cookies in various formats
 	 * for different use cases. This provides flexible access to cookies for
 	 * HTTP headers, file storage, serialization, or programmatic manipulation.
 	 *
+	 * If a `url` is provided, only cookies valid for that URL (matching domain, path,
+	 * expiration, etc.) are returned. If no `url` is provided, all cookies in the
+	 * jar are returned.
+	 *
 	 * The returned `Cookies` object contains:
 	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
 	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
@@ -4266,37 +4280,29 @@ export declare class Rezo {
 	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
 	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
 	 *
+	 * @param url - Optional URL to filter cookies. If provided, returns only cookies valid for this URL.
 	 * @returns A Cookies object with cookies in multiple formats
 	 *
 	 * @example
 	 * ```typescript
-	 * const cookies = rezo.getCookies();
+	 * // Get ALL cookies in the jar
+	 * const allCookies = 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 cookies valid for a specific URL
+	 * const googleCookies = rezo.getCookies('https://google.com');
+	 * console.log(googleCookies.string); // Only sends valid cookies for google.com
 	 *
-	 * // Get cookie header string for manual HTTP requests
-	 * console.log(cookies.string); // "session=abc123; user=john"
+	 * // Access as Cookie instances
+	 * for (const cookie of allCookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value}`);
+	 * }
 	 *
 	 * // Save to Netscape cookie file
-	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 * fs.writeFileSync('cookies.txt', allCookies.netscape);
 	 *
 	 * // Serialize to JSON for storage
-	 * const json = JSON.stringify(cookies.serialized);
+	 * const json = JSON.stringify(allCookies.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
@@ -4304,6 +4310,7 @@ export declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
 	 */
 	getCookies(): Cookies;
+	getCookies(url: string): Cookies;
 	/**
 	 * Remove all cookies from the cookie jar.
 	 *

package/dist/platform/node.d.ts

@@ -192,7 +192,17 @@ export declare class RezoCookieJar extends TouchCookieJar {
 	constructor(cookies: Cookie[]);
 	constructor(cookies: Cookie[], url: string);
 	private generateCookies;
-	cookies(): Cookies;
+	/**
+	 * Get all cookies from the cookie jar.
+	 *
+	 * This method synchronously returns all cookies stored in the jar,
+	 * including both regular and touch cookies.
+	 *
+	 * @returns {Cookies} An object containing arrays of all cookies,
+	 * serialized representations, Netscape format strings, and set-cookie strings
+	 * @see {@link getCookiesForRequest} - Get cookies for a specific request URL
+	 */
+	cookies(url?: string): Cookies;
 	parseResponseCookies(cookies: Cookie[]): Cookies;
 	static toNetscapeCookie(cookies: Cookie[] | SerializedCookie[]): string;
 	static toCookieString(cookies: Cookie[] | SerializedCookie[]): string;
@@ -4253,12 +4263,16 @@ 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 in multiple convenient formats.
+	 * Get cookies from the cookie jar in multiple convenient formats.
 	 *
-	 * Returns a `Cookies` object containing all stored cookies in various formats
+	 * Returns a `Cookies` object containing stored cookies in various formats
 	 * for different use cases. This provides flexible access to cookies for
 	 * HTTP headers, file storage, serialization, or programmatic manipulation.
 	 *
+	 * If a `url` is provided, only cookies valid for that URL (matching domain, path,
+	 * expiration, etc.) are returned. If no `url` is provided, all cookies in the
+	 * jar are returned.
+	 *
 	 * The returned `Cookies` object contains:
 	 * - **array**: `Cookie[]` - Array of Cookie class instances for programmatic access
 	 * - **serialized**: `SerializedCookie[]` - Plain objects for JSON serialization/storage
@@ -4266,37 +4280,29 @@ export declare class Rezo {
 	 * - **string**: `string` - Cookie header format (`key=value; key2=value2`) for HTTP requests
 	 * - **setCookiesString**: `string[]` - Array of Set-Cookie header strings
 	 *
+	 * @param url - Optional URL to filter cookies. If provided, returns only cookies valid for this URL.
 	 * @returns A Cookies object with cookies in multiple formats
 	 *
 	 * @example
 	 * ```typescript
-	 * const cookies = rezo.getCookies();
+	 * // Get ALL cookies in the jar
+	 * const allCookies = 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 cookies valid for a specific URL
+	 * const googleCookies = rezo.getCookies('https://google.com');
+	 * console.log(googleCookies.string); // Only sends valid cookies for google.com
 	 *
-	 * // Get cookie header string for manual HTTP requests
-	 * console.log(cookies.string); // "session=abc123; user=john"
+	 * // Access as Cookie instances
+	 * for (const cookie of allCookies.array) {
+	 *   console.log(`${cookie.key}=${cookie.value}`);
+	 * }
 	 *
 	 * // Save to Netscape cookie file
-	 * fs.writeFileSync('cookies.txt', cookies.netscape);
+	 * fs.writeFileSync('cookies.txt', allCookies.netscape);
 	 *
 	 * // Serialize to JSON for storage
-	 * const json = JSON.stringify(cookies.serialized);
+	 * const json = JSON.stringify(allCookies.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
@@ -4304,6 +4310,7 @@ export declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more methods
 	 */
 	getCookies(): Cookies;
+	getCookies(url: string): Cookies;
 	/**
 	 * Remove all cookies from the cookie jar.
 	 *