rezo 1.0.14 → 1.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/dist/adapters/entries/curl.cjs +2 -1
  2. package/dist/adapters/entries/curl.d.ts +24 -4
  3. package/dist/adapters/entries/curl.js +2 -2
  4. package/dist/adapters/entries/fetch.cjs +2 -1
  5. package/dist/adapters/entries/fetch.d.ts +24 -4
  6. package/dist/adapters/entries/fetch.js +2 -2
  7. package/dist/adapters/entries/http.cjs +2 -1
  8. package/dist/adapters/entries/http.d.ts +24 -4
  9. package/dist/adapters/entries/http.js +2 -2
  10. package/dist/adapters/entries/http2.cjs +2 -1
  11. package/dist/adapters/entries/http2.d.ts +24 -4
  12. package/dist/adapters/entries/http2.js +2 -2
  13. package/dist/adapters/entries/react-native.cjs +2 -1
  14. package/dist/adapters/entries/react-native.d.ts +24 -4
  15. package/dist/adapters/entries/react-native.js +2 -2
  16. package/dist/adapters/entries/xhr.cjs +2 -1
  17. package/dist/adapters/entries/xhr.d.ts +24 -4
  18. package/dist/adapters/entries/xhr.js +2 -2
  19. package/dist/adapters/index.cjs +6 -6
  20. package/dist/adapters/picker.cjs +1 -1
  21. package/dist/adapters/picker.js +1 -1
  22. package/dist/cache/index.cjs +13 -13
  23. package/dist/core/rezo.cjs +2 -2
  24. package/dist/core/rezo.js +2 -2
  25. package/dist/crawler.d.ts +24 -4
  26. package/dist/entries/crawler.cjs +5 -5
  27. package/dist/index.cjs +25 -24
  28. package/dist/index.d.ts +24 -4
  29. package/dist/index.js +1 -1
  30. package/dist/platform/browser.cjs +2 -1
  31. package/dist/platform/browser.d.ts +24 -4
  32. package/dist/platform/browser.js +2 -2
  33. package/dist/platform/bun.cjs +2 -1
  34. package/dist/platform/bun.d.ts +24 -4
  35. package/dist/platform/bun.js +2 -2
  36. package/dist/platform/deno.cjs +2 -1
  37. package/dist/platform/deno.d.ts +24 -4
  38. package/dist/platform/deno.js +2 -2
  39. package/dist/platform/node.cjs +2 -1
  40. package/dist/platform/node.d.ts +24 -4
  41. package/dist/platform/node.js +2 -2
  42. package/dist/platform/react-native.cjs +2 -1
  43. package/dist/platform/react-native.d.ts +24 -4
  44. package/dist/platform/react-native.js +2 -2
  45. package/dist/platform/worker.cjs +2 -1
  46. package/dist/platform/worker.d.ts +24 -4
  47. package/dist/platform/worker.js +2 -2
  48. package/dist/plugin/index.cjs +36 -36
  49. package/dist/proxy/index.cjs +2 -2
  50. package/dist/queue/index.cjs +8 -8
  51. package/dist/utils/http-config.cjs +1 -1
  52. package/dist/utils/http-config.js +1 -1
  53. package/package.json +1 -1
@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
3
3
  const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
4
4
  const { RezoHeaders } = require('../../utils/headers.cjs');
5
5
  const { RezoFormData } = require('../../utils/form-data.cjs');
6
- const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
6
+ const { RezoCookieJar, Cookie, SerializedCookie } = require('../../utils/cookies.cjs');
7
7
  const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
8
8
  const packageJson = require("../../../package.json");
9
9
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
14
14
  exports.RezoFormData = RezoFormData;
15
15
  exports.RezoCookieJar = RezoCookieJar;
16
16
  exports.Cookie = Cookie;
17
+ exports.SerializedCookie = SerializedCookie;
17
18
  exports.createDefaultHooks = createDefaultHooks;
18
19
  exports.mergeHooks = mergeHooks;
19
20
  const isRezoError = exports.isRezoError = RezoError.isRezoError;
@@ -2693,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
2693
2693
  useProxyManager?: boolean;
2694
2694
  /** Whether to enable automatic cookie handling */
2695
2695
  useCookies?: boolean;
2696
- /** Custom cookie jar for managing cookies */
2697
- cookieJar?: RezoCookieJar;
2696
+ /**
2697
+ * Custom cookie jar for managing cookies in this request.
2698
+ * Note: Passing jar per-request is supported but not recommended.
2699
+ * For better cookie management, pass the jar when creating the instance:
2700
+ * @example
2701
+ * ```typescript
2702
+ * const client = new Rezo({ jar: myJar });
2703
+ * // or
2704
+ * const client = rezo.create({ jar: myJar });
2705
+ * ```
2706
+ * If you need custom cookies for a single request, use the `cookies` option instead.
2707
+ */
2708
+ jar?: RezoCookieJar;
2698
2709
  /** Cookies to send with the request in various formats */
2699
2710
  cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
2700
2711
  /** Callback for upload progress events */
@@ -3125,8 +3136,17 @@ export interface RezoDefaultOptions {
3125
3136
  hooks?: Partial<RezoHooks>;
3126
3137
  /** Whether to enable automatic cookie handling (default: true)*/
3127
3138
  enableCookieJar?: boolean;
3128
- /** Custom cookie jar for managing cookies */
3129
- cookieJar?: RezoHttpRequest["cookieJar"];
3139
+ /**
3140
+ * Custom cookie jar for managing cookies.
3141
+ * The recommended way to manage cookies - pass the jar when creating the instance.
3142
+ * @example
3143
+ * ```typescript
3144
+ * const client = new Rezo({ jar: myJar });
3145
+ * // or
3146
+ * const client = rezo.create({ jar: myJar });
3147
+ * ```
3148
+ */
3149
+ jar?: RezoHttpRequest["jar"];
3130
3150
  /** Set default cookies to send with the requests in various formats */
3131
3151
  cookies?: RezoHttpRequest["cookies"];
3132
3152
  /**
@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
3
3
  import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
4
4
  import { RezoHeaders } from '../../utils/headers.js';
5
5
  import { RezoFormData } from '../../utils/form-data.js';
6
- import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
6
+ import { RezoCookieJar, Cookie, SerializedCookie } from '../../utils/cookies.js';
7
7
  import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
8
8
  import packageJson from "../../../package.json" with { type: 'json' };
9
9
 
@@ -12,7 +12,7 @@ export { RezoError };
12
12
  export { RezoErrorCode };
13
13
  export { RezoHeaders };
14
14
  export { RezoFormData };
15
- export { RezoCookieJar, Cookie };
15
+ export { RezoCookieJar, Cookie, SerializedCookie };
16
16
  export { createDefaultHooks };
17
17
  export { mergeHooks };
18
18
  export const isRezoError = RezoError.isRezoError;
@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
3
3
  const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
4
4
  const { RezoHeaders } = require('../../utils/headers.cjs');
5
5
  const { RezoFormData } = require('../../utils/form-data.cjs');
6
- const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
6
+ const { RezoCookieJar, Cookie, SerializedCookie } = require('../../utils/cookies.cjs');
7
7
  const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
8
8
  const packageJson = require("../../../package.json");
9
9
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
14
14
  exports.RezoFormData = RezoFormData;
15
15
  exports.RezoCookieJar = RezoCookieJar;
16
16
  exports.Cookie = Cookie;
17
+ exports.SerializedCookie = SerializedCookie;
17
18
  exports.createDefaultHooks = createDefaultHooks;
18
19
  exports.mergeHooks = mergeHooks;
19
20
  const isRezoError = exports.isRezoError = RezoError.isRezoError;
@@ -2693,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
2693
2693
  useProxyManager?: boolean;
2694
2694
  /** Whether to enable automatic cookie handling */
2695
2695
  useCookies?: boolean;
2696
- /** Custom cookie jar for managing cookies */
2697
- cookieJar?: RezoCookieJar;
2696
+ /**
2697
+ * Custom cookie jar for managing cookies in this request.
2698
+ * Note: Passing jar per-request is supported but not recommended.
2699
+ * For better cookie management, pass the jar when creating the instance:
2700
+ * @example
2701
+ * ```typescript
2702
+ * const client = new Rezo({ jar: myJar });
2703
+ * // or
2704
+ * const client = rezo.create({ jar: myJar });
2705
+ * ```
2706
+ * If you need custom cookies for a single request, use the `cookies` option instead.
2707
+ */
2708
+ jar?: RezoCookieJar;
2698
2709
  /** Cookies to send with the request in various formats */
2699
2710
  cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
2700
2711
  /** Callback for upload progress events */
@@ -3125,8 +3136,17 @@ export interface RezoDefaultOptions {
3125
3136
  hooks?: Partial<RezoHooks>;
3126
3137
  /** Whether to enable automatic cookie handling (default: true)*/
3127
3138
  enableCookieJar?: boolean;
3128
- /** Custom cookie jar for managing cookies */
3129
- cookieJar?: RezoHttpRequest["cookieJar"];
3139
+ /**
3140
+ * Custom cookie jar for managing cookies.
3141
+ * The recommended way to manage cookies - pass the jar when creating the instance.
3142
+ * @example
3143
+ * ```typescript
3144
+ * const client = new Rezo({ jar: myJar });
3145
+ * // or
3146
+ * const client = rezo.create({ jar: myJar });
3147
+ * ```
3148
+ */
3149
+ jar?: RezoHttpRequest["jar"];
3130
3150
  /** Set default cookies to send with the requests in various formats */
3131
3151
  cookies?: RezoHttpRequest["cookies"];
3132
3152
  /**
@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
3
3
  import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
4
4
  import { RezoHeaders } from '../../utils/headers.js';
5
5
  import { RezoFormData } from '../../utils/form-data.js';
6
- import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
6
+ import { RezoCookieJar, Cookie, SerializedCookie } from '../../utils/cookies.js';
7
7
  import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
8
8
  import packageJson from "../../../package.json" with { type: 'json' };
9
9
 
@@ -12,7 +12,7 @@ export { RezoError };
12
12
  export { RezoErrorCode };
13
13
  export { RezoHeaders };
14
14
  export { RezoFormData };
15
- export { RezoCookieJar, Cookie };
15
+ export { RezoCookieJar, Cookie, SerializedCookie };
16
16
  export { createDefaultHooks };
17
17
  export { mergeHooks };
18
18
  export const isRezoError = RezoError.isRezoError;
@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
3
3
  const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
4
4
  const { RezoHeaders } = require('../../utils/headers.cjs');
5
5
  const { RezoFormData } = require('../../utils/form-data.cjs');
6
- const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
6
+ const { RezoCookieJar, Cookie, SerializedCookie } = require('../../utils/cookies.cjs');
7
7
  const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
8
8
  const packageJson = require("../../../package.json");
9
9
 
@@ -13,6 +13,7 @@ exports.RezoErrorCode = RezoErrorCode;
13
13
  exports.RezoHeaders = RezoHeaders;
14
14
  exports.RezoFormData = RezoFormData;
15
15
  exports.RezoCookieJar = RezoCookieJar;
16
+ exports.SerializedCookie = SerializedCookie;
16
17
  exports.Cookie = Cookie;
17
18
  exports.createDefaultHooks = createDefaultHooks;
18
19
  exports.mergeHooks = mergeHooks;
@@ -2693,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
2693
2693
  useProxyManager?: boolean;
2694
2694
  /** Whether to enable automatic cookie handling */
2695
2695
  useCookies?: boolean;
2696
- /** Custom cookie jar for managing cookies */
2697
- cookieJar?: RezoCookieJar;
2696
+ /**
2697
+ * Custom cookie jar for managing cookies in this request.
2698
+ * Note: Passing jar per-request is supported but not recommended.
2699
+ * For better cookie management, pass the jar when creating the instance:
2700
+ * @example
2701
+ * ```typescript
2702
+ * const client = new Rezo({ jar: myJar });
2703
+ * // or
2704
+ * const client = rezo.create({ jar: myJar });
2705
+ * ```
2706
+ * If you need custom cookies for a single request, use the `cookies` option instead.
2707
+ */
2708
+ jar?: RezoCookieJar;
2698
2709
  /** Cookies to send with the request in various formats */
2699
2710
  cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
2700
2711
  /** Callback for upload progress events */
@@ -3125,8 +3136,17 @@ export interface RezoDefaultOptions {
3125
3136
  hooks?: Partial<RezoHooks>;
3126
3137
  /** Whether to enable automatic cookie handling (default: true)*/
3127
3138
  enableCookieJar?: boolean;
3128
- /** Custom cookie jar for managing cookies */
3129
- cookieJar?: RezoHttpRequest["cookieJar"];
3139
+ /**
3140
+ * Custom cookie jar for managing cookies.
3141
+ * The recommended way to manage cookies - pass the jar when creating the instance.
3142
+ * @example
3143
+ * ```typescript
3144
+ * const client = new Rezo({ jar: myJar });
3145
+ * // or
3146
+ * const client = rezo.create({ jar: myJar });
3147
+ * ```
3148
+ */
3149
+ jar?: RezoHttpRequest["jar"];
3130
3150
  /** Set default cookies to send with the requests in various formats */
3131
3151
  cookies?: RezoHttpRequest["cookies"];
3132
3152
  /**
@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
3
3
  import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
4
4
  import { RezoHeaders } from '../../utils/headers.js';
5
5
  import { RezoFormData } from '../../utils/form-data.js';
6
- import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
6
+ import { RezoCookieJar, Cookie, SerializedCookie } from '../../utils/cookies.js';
7
7
  import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
8
8
  import packageJson from "../../../package.json" with { type: 'json' };
9
9
 
@@ -12,7 +12,7 @@ export { RezoError };
12
12
  export { RezoErrorCode };
13
13
  export { RezoHeaders };
14
14
  export { RezoFormData };
15
- export { RezoCookieJar };
15
+ export { RezoCookieJar, SerializedCookie };
16
16
  export { Cookie };
17
17
  export { createDefaultHooks };
18
18
  export { mergeHooks };
@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
3
3
  const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
4
4
  const { RezoHeaders } = require('../../utils/headers.cjs');
5
5
  const { RezoFormData } = require('../../utils/form-data.cjs');
6
- const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
6
+ const { RezoCookieJar, Cookie, SerializedCookie } = require('../../utils/cookies.cjs');
7
7
  const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
8
8
  const packageJson = require("../../../package.json");
9
9
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
14
14
  exports.RezoFormData = RezoFormData;
15
15
  exports.RezoCookieJar = RezoCookieJar;
16
16
  exports.Cookie = Cookie;
17
+ exports.SerializedCookie = SerializedCookie;
17
18
  exports.createDefaultHooks = createDefaultHooks;
18
19
  exports.mergeHooks = mergeHooks;
19
20
  const isRezoError = exports.isRezoError = RezoError.isRezoError;
@@ -2693,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
2693
2693
  useProxyManager?: boolean;
2694
2694
  /** Whether to enable automatic cookie handling */
2695
2695
  useCookies?: boolean;
2696
- /** Custom cookie jar for managing cookies */
2697
- cookieJar?: RezoCookieJar;
2696
+ /**
2697
+ * Custom cookie jar for managing cookies in this request.
2698
+ * Note: Passing jar per-request is supported but not recommended.
2699
+ * For better cookie management, pass the jar when creating the instance:
2700
+ * @example
2701
+ * ```typescript
2702
+ * const client = new Rezo({ jar: myJar });
2703
+ * // or
2704
+ * const client = rezo.create({ jar: myJar });
2705
+ * ```
2706
+ * If you need custom cookies for a single request, use the `cookies` option instead.
2707
+ */
2708
+ jar?: RezoCookieJar;
2698
2709
  /** Cookies to send with the request in various formats */
2699
2710
  cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
2700
2711
  /** Callback for upload progress events */
@@ -3125,8 +3136,17 @@ export interface RezoDefaultOptions {
3125
3136
  hooks?: Partial<RezoHooks>;
3126
3137
  /** Whether to enable automatic cookie handling (default: true)*/
3127
3138
  enableCookieJar?: boolean;
3128
- /** Custom cookie jar for managing cookies */
3129
- cookieJar?: RezoHttpRequest["cookieJar"];
3139
+ /**
3140
+ * Custom cookie jar for managing cookies.
3141
+ * The recommended way to manage cookies - pass the jar when creating the instance.
3142
+ * @example
3143
+ * ```typescript
3144
+ * const client = new Rezo({ jar: myJar });
3145
+ * // or
3146
+ * const client = rezo.create({ jar: myJar });
3147
+ * ```
3148
+ */
3149
+ jar?: RezoHttpRequest["jar"];
3130
3150
  /** Set default cookies to send with the requests in various formats */
3131
3151
  cookies?: RezoHttpRequest["cookies"];
3132
3152
  /**
@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
3
3
  import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
4
4
  import { RezoHeaders } from '../../utils/headers.js';
5
5
  import { RezoFormData } from '../../utils/form-data.js';
6
- import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
6
+ import { RezoCookieJar, Cookie, SerializedCookie } from '../../utils/cookies.js';
7
7
  import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
8
8
  import packageJson from "../../../package.json" with { type: 'json' };
9
9
 
@@ -12,7 +12,7 @@ export { RezoError };
12
12
  export { RezoErrorCode };
13
13
  export { RezoHeaders };
14
14
  export { RezoFormData };
15
- export { RezoCookieJar, Cookie };
15
+ export { RezoCookieJar, Cookie, SerializedCookie };
16
16
  export { createDefaultHooks };
17
17
  export { mergeHooks };
18
18
  export const isRezoError = RezoError.isRezoError;
@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
3
3
  const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
4
4
  const { RezoHeaders } = require('../../utils/headers.cjs');
5
5
  const { RezoFormData } = require('../../utils/form-data.cjs');
6
- const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
6
+ const { RezoCookieJar, Cookie, SerializedCookie } = require('../../utils/cookies.cjs');
7
7
  const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
8
8
  const packageJson = require("../../../package.json");
9
9
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
14
14
  exports.RezoFormData = RezoFormData;
15
15
  exports.RezoCookieJar = RezoCookieJar;
16
16
  exports.Cookie = Cookie;
17
+ exports.SerializedCookie = SerializedCookie;
17
18
  exports.createDefaultHooks = createDefaultHooks;
18
19
  exports.mergeHooks = mergeHooks;
19
20
  const isRezoError = exports.isRezoError = RezoError.isRezoError;
@@ -2693,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
2693
2693
  useProxyManager?: boolean;
2694
2694
  /** Whether to enable automatic cookie handling */
2695
2695
  useCookies?: boolean;
2696
- /** Custom cookie jar for managing cookies */
2697
- cookieJar?: RezoCookieJar;
2696
+ /**
2697
+ * Custom cookie jar for managing cookies in this request.
2698
+ * Note: Passing jar per-request is supported but not recommended.
2699
+ * For better cookie management, pass the jar when creating the instance:
2700
+ * @example
2701
+ * ```typescript
2702
+ * const client = new Rezo({ jar: myJar });
2703
+ * // or
2704
+ * const client = rezo.create({ jar: myJar });
2705
+ * ```
2706
+ * If you need custom cookies for a single request, use the `cookies` option instead.
2707
+ */
2708
+ jar?: RezoCookieJar;
2698
2709
  /** Cookies to send with the request in various formats */
2699
2710
  cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
2700
2711
  /** Callback for upload progress events */
@@ -3125,8 +3136,17 @@ export interface RezoDefaultOptions {
3125
3136
  hooks?: Partial<RezoHooks>;
3126
3137
  /** Whether to enable automatic cookie handling (default: true)*/
3127
3138
  enableCookieJar?: boolean;
3128
- /** Custom cookie jar for managing cookies */
3129
- cookieJar?: RezoHttpRequest["cookieJar"];
3139
+ /**
3140
+ * Custom cookie jar for managing cookies.
3141
+ * The recommended way to manage cookies - pass the jar when creating the instance.
3142
+ * @example
3143
+ * ```typescript
3144
+ * const client = new Rezo({ jar: myJar });
3145
+ * // or
3146
+ * const client = rezo.create({ jar: myJar });
3147
+ * ```
3148
+ */
3149
+ jar?: RezoHttpRequest["jar"];
3130
3150
  /** Set default cookies to send with the requests in various formats */
3131
3151
  cookies?: RezoHttpRequest["cookies"];
3132
3152
  /**
@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
3
3
  import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
4
4
  import { RezoHeaders } from '../../utils/headers.js';
5
5
  import { RezoFormData } from '../../utils/form-data.js';
6
- import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
6
+ import { RezoCookieJar, Cookie, SerializedCookie } from '../../utils/cookies.js';
7
7
  import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
8
8
  import packageJson from "../../../package.json" with { type: 'json' };
9
9
 
@@ -12,7 +12,7 @@ export { RezoError };
12
12
  export { RezoErrorCode };
13
13
  export { RezoHeaders };
14
14
  export { RezoFormData };
15
- export { RezoCookieJar, Cookie };
15
+ export { RezoCookieJar, Cookie, SerializedCookie };
16
16
  export { createDefaultHooks };
17
17
  export { mergeHooks };
18
18
  export const isRezoError = RezoError.isRezoError;
@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
3
3
  const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
4
4
  const { RezoHeaders } = require('../../utils/headers.cjs');
5
5
  const { RezoFormData } = require('../../utils/form-data.cjs');
6
- const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
6
+ const { RezoCookieJar, Cookie, SerializedCookie } = require('../../utils/cookies.cjs');
7
7
  const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
8
8
  const packageJson = require("../../../package.json");
9
9
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
14
14
  exports.RezoFormData = RezoFormData;
15
15
  exports.RezoCookieJar = RezoCookieJar;
16
16
  exports.Cookie = Cookie;
17
+ exports.SerializedCookie = SerializedCookie;
17
18
  exports.createDefaultHooks = createDefaultHooks;
18
19
  exports.mergeHooks = mergeHooks;
19
20
  const isRezoError = exports.isRezoError = RezoError.isRezoError;
@@ -2693,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
2693
2693
  useProxyManager?: boolean;
2694
2694
  /** Whether to enable automatic cookie handling */
2695
2695
  useCookies?: boolean;
2696
- /** Custom cookie jar for managing cookies */
2697
- cookieJar?: RezoCookieJar;
2696
+ /**
2697
+ * Custom cookie jar for managing cookies in this request.
2698
+ * Note: Passing jar per-request is supported but not recommended.
2699
+ * For better cookie management, pass the jar when creating the instance:
2700
+ * @example
2701
+ * ```typescript
2702
+ * const client = new Rezo({ jar: myJar });
2703
+ * // or
2704
+ * const client = rezo.create({ jar: myJar });
2705
+ * ```
2706
+ * If you need custom cookies for a single request, use the `cookies` option instead.
2707
+ */
2708
+ jar?: RezoCookieJar;
2698
2709
  /** Cookies to send with the request in various formats */
2699
2710
  cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
2700
2711
  /** Callback for upload progress events */
@@ -3125,8 +3136,17 @@ export interface RezoDefaultOptions {
3125
3136
  hooks?: Partial<RezoHooks>;
3126
3137
  /** Whether to enable automatic cookie handling (default: true)*/
3127
3138
  enableCookieJar?: boolean;
3128
- /** Custom cookie jar for managing cookies */
3129
- cookieJar?: RezoHttpRequest["cookieJar"];
3139
+ /**
3140
+ * Custom cookie jar for managing cookies.
3141
+ * The recommended way to manage cookies - pass the jar when creating the instance.
3142
+ * @example
3143
+ * ```typescript
3144
+ * const client = new Rezo({ jar: myJar });
3145
+ * // or
3146
+ * const client = rezo.create({ jar: myJar });
3147
+ * ```
3148
+ */
3149
+ jar?: RezoHttpRequest["jar"];
3130
3150
  /** Set default cookies to send with the requests in various formats */
3131
3151
  cookies?: RezoHttpRequest["cookies"];
3132
3152
  /**
@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
3
3
  import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
4
4
  import { RezoHeaders } from '../../utils/headers.js';
5
5
  import { RezoFormData } from '../../utils/form-data.js';
6
- import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
6
+ import { RezoCookieJar, Cookie, SerializedCookie } from '../../utils/cookies.js';
7
7
  import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
8
8
  import packageJson from "../../../package.json" with { type: 'json' };
9
9
 
@@ -12,7 +12,7 @@ export { RezoError };
12
12
  export { RezoErrorCode };
13
13
  export { RezoHeaders };
14
14
  export { RezoFormData };
15
- export { RezoCookieJar, Cookie };
15
+ export { RezoCookieJar, Cookie, SerializedCookie };
16
16
  export { createDefaultHooks };
17
17
  export { mergeHooks };
18
18
  export const isRezoError = RezoError.isRezoError;
@@ -1,6 +1,6 @@
1
- const _mod_wby0uw = require('./picker.cjs');
2
- exports.detectRuntime = _mod_wby0uw.detectRuntime;
3
- exports.getAdapterCapabilities = _mod_wby0uw.getAdapterCapabilities;
4
- exports.buildAdapterContext = _mod_wby0uw.buildAdapterContext;
5
- exports.getAvailableAdapters = _mod_wby0uw.getAvailableAdapters;
6
- exports.selectAdapter = _mod_wby0uw.selectAdapter;;
1
+ const _mod_zdm6xo = require('./picker.cjs');
2
+ exports.detectRuntime = _mod_zdm6xo.detectRuntime;
3
+ exports.getAdapterCapabilities = _mod_zdm6xo.getAdapterCapabilities;
4
+ exports.buildAdapterContext = _mod_zdm6xo.buildAdapterContext;
5
+ exports.getAvailableAdapters = _mod_zdm6xo.getAvailableAdapters;
6
+ exports.selectAdapter = _mod_zdm6xo.selectAdapter;;
@@ -133,7 +133,7 @@ function getAdapterCapabilities(adapter) {
133
133
  function buildAdapterContext(options, defaultOptions) {
134
134
  const internal = options;
135
135
  return {
136
- needsCookies: !!(options.cookieJar || defaultOptions.cookieJar),
136
+ needsCookies: !!(options.jar || defaultOptions.jar),
137
137
  needsProxy: !!options.proxy,
138
138
  needsStreaming: !!internal._isStream,
139
139
  needsHttp2: false,
@@ -133,7 +133,7 @@ export function getAdapterCapabilities(adapter) {
133
133
  export function buildAdapterContext(options, defaultOptions) {
134
134
  const internal = options;
135
135
  return {
136
- needsCookies: !!(options.cookieJar || defaultOptions.cookieJar),
136
+ needsCookies: !!(options.jar || defaultOptions.jar),
137
137
  needsProxy: !!options.proxy,
138
138
  needsStreaming: !!internal._isStream,
139
139
  needsHttp2: false,
@@ -1,13 +1,13 @@
1
- const _mod_hi5yx4 = require('./lru-cache.cjs');
2
- exports.LRUCache = _mod_hi5yx4.LRUCache;;
3
- const _mod_xvsb8i = require('./dns-cache.cjs');
4
- exports.DNSCache = _mod_xvsb8i.DNSCache;
5
- exports.getGlobalDNSCache = _mod_xvsb8i.getGlobalDNSCache;
6
- exports.resetGlobalDNSCache = _mod_xvsb8i.resetGlobalDNSCache;;
7
- const _mod_gble7l = require('./response-cache.cjs');
8
- exports.ResponseCache = _mod_gble7l.ResponseCache;
9
- exports.normalizeResponseCacheConfig = _mod_gble7l.normalizeResponseCacheConfig;;
10
- const _mod_oq9kzw = require('./file-cacher.cjs');
11
- exports.FileCacher = _mod_oq9kzw.FileCacher;;
12
- const _mod_mhhavh = require('./url-store.cjs');
13
- exports.UrlStore = _mod_mhhavh.UrlStore;;
1
+ const _mod_39srb2 = require('./lru-cache.cjs');
2
+ exports.LRUCache = _mod_39srb2.LRUCache;;
3
+ const _mod_u37lrv = require('./dns-cache.cjs');
4
+ exports.DNSCache = _mod_u37lrv.DNSCache;
5
+ exports.getGlobalDNSCache = _mod_u37lrv.getGlobalDNSCache;
6
+ exports.resetGlobalDNSCache = _mod_u37lrv.resetGlobalDNSCache;;
7
+ const _mod_bs1dg1 = require('./response-cache.cjs');
8
+ exports.ResponseCache = _mod_bs1dg1.ResponseCache;
9
+ exports.normalizeResponseCacheConfig = _mod_bs1dg1.normalizeResponseCacheConfig;;
10
+ const _mod_kn7g7f = require('./file-cacher.cjs');
11
+ exports.FileCacher = _mod_kn7g7f.FileCacher;;
12
+ const _mod_cuqeg2 = require('./url-store.cjs');
13
+ exports.UrlStore = _mod_cuqeg2.UrlStore;;
@@ -49,8 +49,8 @@ class Rezo {
49
49
  }
50
50
  this.adapter = adapter || globalAdapter;
51
51
  this.defaults = config || {};
52
- if (config?.cookieJar instanceof RezoCookieJar) {
53
- this.jar = config.cookieJar;
52
+ if (config?.jar instanceof RezoCookieJar) {
53
+ this.jar = config.jar;
54
54
  } else if (config?.cookieFile) {
55
55
  this.jar = RezoCookieJar.fromFile(config.cookieFile);
56
56
  } else {
package/dist/core/rezo.js CHANGED
@@ -49,8 +49,8 @@ export class Rezo {
49
49
  }
50
50
  this.adapter = adapter || globalAdapter;
51
51
  this.defaults = config || {};
52
- if (config?.cookieJar instanceof RezoCookieJar) {
53
- this.jar = config.cookieJar;
52
+ if (config?.jar instanceof RezoCookieJar) {
53
+ this.jar = config.jar;
54
54
  } else if (config?.cookieFile) {
55
55
  this.jar = RezoCookieJar.fromFile(config.cookieFile);
56
56
  } else {
package/dist/crawler.d.ts CHANGED
@@ -2811,8 +2811,19 @@ export interface RezoRequestConfig<D = any> {
2811
2811
  useProxyManager?: boolean;
2812
2812
  /** Whether to enable automatic cookie handling */
2813
2813
  useCookies?: boolean;
2814
- /** Custom cookie jar for managing cookies */
2815
- cookieJar?: RezoCookieJar;
2814
+ /**
2815
+ * Custom cookie jar for managing cookies in this request.
2816
+ * Note: Passing jar per-request is supported but not recommended.
2817
+ * For better cookie management, pass the jar when creating the instance:
2818
+ * @example
2819
+ * ```typescript
2820
+ * const client = new Rezo({ jar: myJar });
2821
+ * // or
2822
+ * const client = rezo.create({ jar: myJar });
2823
+ * ```
2824
+ * If you need custom cookies for a single request, use the `cookies` option instead.
2825
+ */
2826
+ jar?: RezoCookieJar;
2816
2827
  /** Cookies to send with the request in various formats */
2817
2828
  cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
2818
2829
  /** Callback for upload progress events */
@@ -3243,8 +3254,17 @@ export interface RezoDefaultOptions {
3243
3254
  hooks?: Partial<RezoHooks>;
3244
3255
  /** Whether to enable automatic cookie handling (default: true)*/
3245
3256
  enableCookieJar?: boolean;
3246
- /** Custom cookie jar for managing cookies */
3247
- cookieJar?: RezoHttpRequest["cookieJar"];
3257
+ /**
3258
+ * Custom cookie jar for managing cookies.
3259
+ * The recommended way to manage cookies - pass the jar when creating the instance.
3260
+ * @example
3261
+ * ```typescript
3262
+ * const client = new Rezo({ jar: myJar });
3263
+ * // or
3264
+ * const client = rezo.create({ jar: myJar });
3265
+ * ```
3266
+ */
3267
+ jar?: RezoHttpRequest["jar"];
3248
3268
  /** Set default cookies to send with the requests in various formats */
3249
3269
  cookies?: RezoHttpRequest["cookies"];
3250
3270
  /**
@@ -1,5 +1,5 @@
1
- const _mod_6aofz8 = require('../plugin/crawler.cjs');
2
- exports.Crawler = _mod_6aofz8.Crawler;;
3
- const _mod_t23px8 = require('../plugin/crawler-options.cjs');
4
- exports.CrawlerOptions = _mod_t23px8.CrawlerOptions;
5
- exports.Domain = _mod_t23px8.Domain;;
1
+ const _mod_0n35h8 = require('../plugin/crawler.cjs');
2
+ exports.Crawler = _mod_0n35h8.Crawler;;
3
+ const _mod_lhm1d5 = require('../plugin/crawler-options.cjs');
4
+ exports.CrawlerOptions = _mod_lhm1d5.CrawlerOptions;
5
+ exports.Domain = _mod_lhm1d5.Domain;;