httpcloak 1.0.2 → 1.0.4

package/lib/index.d.ts

@@ -31,6 +31,18 @@ export interface SessionOptions {
   proxy?: string;
   /** Request timeout in seconds (default: 30) */
   timeout?: number;
+  /** HTTP version: "auto", "h1", "h2", "h3" (default: "auto") */
+  httpVersion?: string;
+  /** SSL certificate verification (default: true) */
+  verify?: boolean;
+  /** Follow redirects (default: true) */
+  allowRedirects?: boolean;
+  /** Maximum number of redirects to follow (default: 10) */
+  maxRedirects?: number;
+  /** Number of retries on failure (default: 3, set to 0 to disable) */
+  retry?: number;
+  /** Status codes to retry on (default: [429, 500, 502, 503, 504]) */
+  retryOnStatus?: number[];
 }
 
 export interface RequestOptions {
@@ -150,3 +162,56 @@ export function version(): string;
 
 /** Get list of available browser presets */
 export function availablePresets(): string[];
+
+export interface ConfigureOptions extends SessionOptions {
+  /** Default headers for all requests */
+  headers?: Record<string, string>;
+  /** Default basic auth [username, password] */
+  auth?: [string, string];
+}
+
+/** Configure defaults for module-level functions */
+export function configure(options?: ConfigureOptions): void;
+
+/** Perform a GET request */
+export function get(url: string, options?: RequestOptions): Promise<Response>;
+
+/** Perform a POST request */
+export function post(url: string, options?: RequestOptions): Promise<Response>;
+
+/** Perform a PUT request */
+export function put(url: string, options?: RequestOptions): Promise<Response>;
+
+/** Perform a DELETE request */
+declare function del(url: string, options?: RequestOptions): Promise<Response>;
+export { del as delete };
+
+/** Perform a PATCH request */
+export function patch(url: string, options?: RequestOptions): Promise<Response>;
+
+/** Perform a HEAD request */
+export function head(url: string, options?: RequestOptions): Promise<Response>;
+
+/** Perform an OPTIONS request */
+export function options(url: string, options?: RequestOptions): Promise<Response>;
+
+/** Perform a custom HTTP request */
+export function request(method: string, url: string, options?: RequestOptions): Promise<Response>;
+
+/** Available browser presets */
+export const Preset: {
+  CHROME_143: string;
+  CHROME_143_WINDOWS: string;
+  CHROME_143_LINUX: string;
+  CHROME_143_MACOS: string;
+  CHROME_131: string;
+  CHROME_131_WINDOWS: string;
+  CHROME_131_LINUX: string;
+  CHROME_131_MACOS: string;
+  IOS_CHROME_143: string;
+  ANDROID_CHROME_143: string;
+  FIREFOX_133: string;
+  SAFARI_18: string;
+  IOS_SAFARI_17: string;
+  all(): string[];
+};

package/lib/index.js

@@ -43,11 +43,16 @@ const Preset = {
   CHROME_131_LINUX: "chrome-131-linux",
   CHROME_131_MACOS: "chrome-131-macos",
 
+  // Mobile Chrome
+  IOS_CHROME_143: "ios-chrome-143",
+  ANDROID_CHROME_143: "android-chrome-143",
+
   // Firefox
   FIREFOX_133: "firefox-133",
 
-  // Safari
+  // Safari (desktop and mobile)
   SAFARI_18: "safari-18",
+  IOS_SAFARI_17: "ios-safari-17",
 
   /**
    * Get all available preset names
@@ -57,7 +62,9 @@ const Preset = {
     return [
       this.CHROME_143, this.CHROME_143_WINDOWS, this.CHROME_143_LINUX, this.CHROME_143_MACOS,
       this.CHROME_131, this.CHROME_131_WINDOWS, this.CHROME_131_LINUX, this.CHROME_131_MACOS,
-      this.FIREFOX_133, this.SAFARI_18,
+      this.IOS_CHROME_143, this.ANDROID_CHROME_143,
+      this.FIREFOX_133,
+      this.SAFARI_18, this.IOS_SAFARI_17,
     ];
   },
 };
@@ -438,7 +445,7 @@ class Session {
    * @param {boolean} [options.verify=true] - SSL certificate verification
    * @param {boolean} [options.allowRedirects=true] - Follow redirects
    * @param {number} [options.maxRedirects=10] - Maximum number of redirects to follow
-   * @param {number} [options.retry=0] - Number of retries on failure
+   * @param {number} [options.retry=3] - Number of retries on failure (set to 0 to disable)
    * @param {number[]} [options.retryOnStatus] - Status codes to retry on
    */
   constructor(options = {}) {
@@ -450,7 +457,7 @@ class Session {
       verify = true,
       allowRedirects = true,
       maxRedirects = 10,
-      retry = 0,
+      retry = 3,
       retryOnStatus = null,
     } = options;
 
@@ -473,11 +480,10 @@ class Session {
     } else if (maxRedirects !== 10) {
       config.max_redirects = maxRedirects;
     }
-    if (retry > 0) {
-      config.retry = retry;
-      if (retryOnStatus) {
-        config.retry_on_status = retryOnStatus;
-      }
+    // Always pass retry to clib (even if 0 to explicitly disable)
+    config.retry = retry;
+    if (retryOnStatus) {
+      config.retry_on_status = retryOnStatus;
     }
 
     this._handle = this._lib.httpcloak_session_new(JSON.stringify(config));
@@ -797,7 +803,7 @@ let _defaultConfig = {};
  * @param {boolean} [options.verify=true] - SSL certificate verification
  * @param {boolean} [options.allowRedirects=true] - Follow redirects
  * @param {number} [options.maxRedirects=10] - Maximum number of redirects to follow
- * @param {number} [options.retry=0] - Number of retries on failure
+ * @param {number} [options.retry=3] - Number of retries on failure (set to 0 to disable)
  * @param {number[]} [options.retryOnStatus] - Status codes to retry on
  */
 function configure(options = {}) {
@@ -811,7 +817,7 @@ function configure(options = {}) {
     verify = true,
     allowRedirects = true,
     maxRedirects = 10,
-    retry = 0,
+    retry = 3,
     retryOnStatus = null,
   } = options;
 
@@ -867,7 +873,7 @@ function _getDefaultSession() {
     const verify = _defaultConfig.verify !== undefined ? _defaultConfig.verify : true;
     const allowRedirects = _defaultConfig.allowRedirects !== undefined ? _defaultConfig.allowRedirects : true;
     const maxRedirects = _defaultConfig.maxRedirects || 10;
-    const retry = _defaultConfig.retry || 0;
+    const retry = _defaultConfig.retry !== undefined ? _defaultConfig.retry : 3;
     const retryOnStatus = _defaultConfig.retryOnStatus || null;
     const headers = _defaultConfig.headers || {};
 

package/npm/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httpcloak/darwin-arm64",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "HTTPCloak native binary for darwin arm64",
   "os": [
     "darwin"

package/npm/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httpcloak/darwin-x64",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "HTTPCloak native binary for darwin x64",
   "os": [
     "darwin"

package/npm/linux-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httpcloak/linux-arm64",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "HTTPCloak native binary for linux arm64",
   "os": [
     "linux"

package/npm/linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httpcloak/linux-x64",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "HTTPCloak native binary for linux x64",
   "os": [
     "linux"

package/npm/win32-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httpcloak/win32-arm64",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "HTTPCloak native binary for win32 arm64",
   "os": [
     "win32"

package/npm/win32-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httpcloak/win32-x64",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "HTTPCloak native binary for win32 x64",
   "os": [
     "win32"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "httpcloak",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Browser fingerprint emulation HTTP client with HTTP/1.1, HTTP/2, and HTTP/3 support",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -35,11 +35,11 @@
     "koffi": "^2.9.0"
   },
   "optionalDependencies": {
-    "@httpcloak/linux-x64": "1.0.2",
-    "@httpcloak/linux-arm64": "1.0.2",
-    "@httpcloak/darwin-x64": "1.0.2",
-    "@httpcloak/darwin-arm64": "1.0.2",
-    "@httpcloak/win32-x64": "1.0.2",
-    "@httpcloak/win32-arm64": "1.0.2"
+    "@httpcloak/linux-x64": "1.0.3",
+    "@httpcloak/linux-arm64": "1.0.3",
+    "@httpcloak/darwin-x64": "1.0.3",
+    "@httpcloak/darwin-arm64": "1.0.3",
+    "@httpcloak/win32-x64": "1.0.3",
+    "@httpcloak/win32-arm64": "1.0.3"
   }
 }