httpcloak 1.6.1-beta.2 → 1.6.1

package/README.md

@@ -16,7 +16,7 @@ npm install httpcloak
 const { Session } = require("httpcloak");
 
 async function main() {
-  const session = new Session({ preset: "chrome-145" });
+  const session = new Session({ preset: "chrome-latest" });
 
   try {
     // GET request
@@ -53,7 +53,7 @@ main();
 ```javascript
 import { Session } from "httpcloak";
 
-const session = new Session({ preset: "chrome-145" });
+const session = new Session({ preset: "chrome-latest" });
 
 const response = await session.get("https://example.com");
 console.log(response.text);
@@ -66,7 +66,7 @@ session.close();
 ```javascript
 const { Session } = require("httpcloak");
 
-const session = new Session({ preset: "chrome-145" });
+const session = new Session({ preset: "chrome-latest" });
 
 // Sync GET
 const response = session.getSync("https://example.com");
@@ -86,7 +86,7 @@ session.close();
 ```javascript
 const { Session } = require("httpcloak");
 
-const session = new Session({ preset: "chrome-145" });
+const session = new Session({ preset: "chrome-latest" });
 
 // GET with callback
 session.getCb("https://example.com", (err, response) => {
@@ -121,7 +121,7 @@ const { Session } = require("httpcloak");
 const fs = require("fs");
 
 async function downloadFile() {
-  const session = new Session({ preset: "chrome-145" });
+  const session = new Session({ preset: "chrome-latest" });
 
   try {
     // Start streaming request
@@ -158,7 +158,7 @@ downloadFile();
 ```javascript
 const { Session } = require("httpcloak");
 
-const session = new Session({ preset: "chrome-145" });
+const session = new Session({ preset: "chrome-latest" });
 
 // Stream GET
 const getStream = session.getStream("https://example.com/data");
@@ -195,19 +195,19 @@ const { Session } = require("httpcloak");
 
 // Basic HTTP proxy
 const session = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   proxy: "http://host:port",
 });
 
 // With authentication
 const sessionAuth = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   proxy: "http://user:pass@host:port",
 });
 
 // HTTPS proxy
 const sessionHttps = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   proxy: "https://user:pass@host:port",
 });
 ```
@@ -219,13 +219,13 @@ const { Session } = require("httpcloak");
 
 // SOCKS5 proxy (with DNS resolution on proxy)
 const session = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   proxy: "socks5h://host:port",
 });
 
 // With authentication
 const sessionAuth = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   proxy: "socks5h://user:pass@host:port",
 });
 
@@ -242,7 +242,7 @@ const { Session } = require("httpcloak");
 
 // MASQUE proxy (auto-detected for known providers like Bright Data)
 const session = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   proxy: "https://user:pass@brd.superproxy.io:10001",
 });
 
@@ -258,7 +258,7 @@ Use different proxies for TCP (HTTP/1.1, HTTP/2) and UDP (HTTP/3) traffic:
 const { Session } = require("httpcloak");
 
 const session = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   tcpProxy: "http://tcp-proxy:port",      // For HTTP/1.1, HTTP/2
   udpProxy: "https://masque-proxy:port",  // For HTTP/3
 });
@@ -275,7 +275,7 @@ const { Session } = require("httpcloak");
 
 // Enable ECH for Cloudflare domains
 const session = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   echConfigDomain: "cloudflare-ech.com",
 });
 
@@ -293,7 +293,7 @@ const { Session } = require("httpcloak");
 
 // Connect to example.com's IP but request www.cloudflare.com
 const session = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   connectTo: { "www.cloudflare.com": "example.com" },
 });
 
@@ -308,7 +308,7 @@ Get HTTP/3 with encrypted SNI through a SOCKS5 proxy:
 const { Session } = require("httpcloak");
 
 const session = new Session({
-  preset: "chrome-145",
+  preset: "chrome-latest",
   proxy: "socks5h://user:pass@host:port",
   echConfigDomain: "cloudflare-ech.com",
 });
@@ -324,18 +324,31 @@ const { Session } = require("httpcloak");
 
 const session = new Session();
 
-// Set a cookie
+// Set a simple cookie (global, sent to all domains)
 session.setCookie("session_id", "abc123");
 
-// Get all cookies
+// Set a domain-scoped cookie with full metadata
+session.setCookie("auth", "token", {
+  domain: ".example.com",
+  path: "/",
+  secure: true,
+  httpOnly: true,
+  sameSite: "Lax",
+});
+
+// Get all cookies (returns Cookie[] with full metadata)
 const cookies = session.getCookies();
-console.log(cookies);
+for (const cookie of cookies) {
+  console.log(`${cookie.name}=${cookie.value} (domain: ${cookie.domain})`);
+}
 
-// Access cookies as property
-console.log(session.cookies);
+// Get a specific cookie by name (returns Cookie or null)
+const cookie = session.getCookie("session_id");
+if (cookie) console.log(cookie.value);
 
-// Delete a cookie
+// Delete a cookie (omit domain to delete from all domains)
 session.deleteCookie("session_id");
+session.deleteCookie("auth", ".example.com"); // delete from specific domain
 
 // Clear all cookies
 session.clearCookies();
@@ -349,7 +362,7 @@ session.close();
 const { Session } = require("httpcloak");
 
 const session = new Session({
-  preset: "chrome-145",           // Browser fingerprint preset
+  preset: "chrome-latest",           // Browser fingerprint preset
   proxy: null,                    // Proxy URL
   tcpProxy: null,                 // Separate TCP proxy
   udpProxy: null,                 // Separate UDP proxy (MASQUE)
@@ -371,8 +384,8 @@ const session = new Session({
 const { availablePresets } = require("httpcloak");
 
 console.log(availablePresets());
-// ['chrome-145', 'chrome-144', 'chrome-143', 'chrome-141', 'chrome-133',
-//  'firefox-133', 'safari-18', 'chrome-145-ios', ...]
+// ['chrome-146', 'chrome-145', 'chrome-144', 'chrome-143', 'chrome-141', 'chrome-133',
+//  'firefox-133', 'safari-18', 'chrome-146-ios', ...]
 ```
 
 ## Response Object
@@ -428,7 +441,7 @@ stream.close();
 ```javascript
 const { Session } = require("httpcloak");
 
-const session = new Session({ preset: "chrome-145" });
+const session = new Session({ preset: "chrome-latest" });
 
 // GET
 const response = await session.get("https://example.com");
@@ -452,9 +465,7 @@ const headResponse = await session.head("https://example.com");
 const optionsResponse = await session.options("https://example.com");
 
 // Custom request
-const customResponse = await session.request({
-  method: "PUT",
-  url: "https://api.example.com/resource",
+const customResponse = await session.request("PUT", "https://api.example.com/resource", {
   headers: { "X-Custom": "value" },
   body: { data: "value" },
   timeout: 60,
@@ -490,7 +501,7 @@ HTTPCloak includes TypeScript definitions out of the box:
 ```typescript
 import { Session, Response, StreamResponse, HTTPCloakError } from "httpcloak";
 
-const session = new Session({ preset: "chrome-145" });
+const session = new Session({ preset: "chrome-latest" });
 
 async function fetchData(): Promise<Response> {
   return session.get("https://example.com");
@@ -519,7 +530,7 @@ const { LocalProxy } = require("httpcloak");
 const axios = require("axios");
 
 // Start local proxy with Chrome fingerprint
-const proxy = new LocalProxy({ preset: "chrome-145" });
+const proxy = new LocalProxy({ preset: "chrome-latest" });
 console.log(`Proxy running on ${proxy.proxyUrl}`);
 
 // Use X-HTTPCloak-Scheme header for HTTPS with fingerprinting + streaming
@@ -558,7 +569,7 @@ const { LocalProxy } = require("httpcloak");
 const axios = require("axios");
 
 // Start local proxy with Chrome fingerprint
-const proxy = new LocalProxy({ preset: "chrome-145" });
+const proxy = new LocalProxy({ preset: "chrome-latest" });
 
 // Standard HTTPS (uses CONNECT tunnel - fingerprinting via upstream proxy only)
 const response = await axios.get("https://example.com", {
@@ -590,7 +601,7 @@ When your client already provides authentic browser headers, use TLS-only mode:
 const { LocalProxy } = require("httpcloak");
 
 // Only apply TLS fingerprint, pass headers through
-const proxy = new LocalProxy({ preset: "chrome-145", tlsOnly: true });
+const proxy = new LocalProxy({ preset: "chrome-latest", tlsOnly: true });
 
 // Your client's headers are preserved
 const response = await fetch("https://example.com", {
@@ -608,10 +619,10 @@ Route different requests through different browser fingerprints:
 ```javascript
 const { LocalProxy, Session } = require("httpcloak");
 
-const proxy = new LocalProxy({ preset: "chrome-145" });
+const proxy = new LocalProxy({ preset: "chrome-latest" });
 
 // Create sessions with different fingerprints
-const chromeSession = new Session({ preset: "chrome-145" });
+const chromeSession = new Session({ preset: "chrome-latest" });
 const firefoxSession = new Session({ preset: "firefox-133" });
 
 // Register sessions with the proxy
@@ -638,7 +649,7 @@ proxy.close();
 ```javascript
 const proxy = new LocalProxy({
   port: 0,              // Port (0 = auto-select)
-  preset: "chrome-145", // Browser fingerprint
+  preset: "chrome-latest", // Browser fingerprint
   timeout: 30,          // Request timeout in seconds
   maxConnections: 1000, // Max concurrent connections
   tcpProxy: null,       // Default upstream TCP proxy

package/lib/index.d.ts

@@ -195,7 +195,7 @@ export class StreamResponse {
 }
 
 export interface SessionOptions {
-  /** Browser preset to use (default: "chrome-145") */
+  /** Browser preset to use (default: "chrome-146") */
   preset?: string;
   /** Proxy URL (e.g., "http://user:pass@host:port" or "socks5://host:port") */
   proxy?: string;
@@ -337,22 +337,50 @@ export class Session {
   options(url: string, options?: RequestOptions): Promise<Response>;
 
   // Cookie management
-  /** Get all cookies from the session */
+
+  /** Get all cookies with full metadata (domain, path, expiry, flags) */
+  getCookiesDetailed(): Cookie[];
+
+  /** Get a specific cookie by name with full metadata */
+  getCookieDetailed(name: string): Cookie | null;
+
+  /**
+   * Get all cookies as a flat name-value object.
+   * @deprecated Will return Cookie[] with full metadata in a future release. Use getCookiesDetailed() for the new format now.
+   */
   getCookies(): Record<string, string>;
 
-  /** Get a specific cookie by name */
+  /**
+   * Get a specific cookie value by name.
+   * @deprecated Will return Cookie|null in a future release. Use getCookieDetailed() for the new format now.
+   */
   getCookie(name: string): string | null;
 
   /** Set a cookie in the session */
-  setCookie(name: string, value: string): void;
-
-  /** Delete a specific cookie by name */
-  deleteCookie(name: string): void;
+  setCookie(
+    name: string,
+    value: string,
+    options?: {
+      domain?: string;
+      path?: string;
+      secure?: boolean;
+      httpOnly?: boolean;
+      sameSite?: string;
+      maxAge?: number;
+      expires?: string;
+    }
+  ): void;
+
+  /** Delete a specific cookie by name. If domain is omitted, deletes from all domains. */
+  deleteCookie(name: string, domain?: string): void;
 
   /** Clear all cookies from the session */
   clearCookies(): void;
 
-  /** Get cookies as a property */
+  /**
+   * Get cookies as a property.
+   * @deprecated Will return Cookie[] with full metadata in a future release.
+   */
   readonly cookies: Record<string, string>;
 
   // Proxy management
@@ -619,7 +647,7 @@ export class Session {
 export interface LocalProxyOptions {
   /** Port to listen on (default: 0 for auto-assign) */
   port?: number;
-  /** Browser preset to use (default: "chrome-145") */
+  /** Browser preset to use (default: "chrome-146") */
   preset?: string;
   /** Request timeout in seconds (default: 30) */
   timeout?: number;
@@ -659,7 +687,7 @@ export interface LocalProxyStats {
  *
  * @example
  * // Basic usage
- * const proxy = new LocalProxy({ preset: "chrome-145", tlsOnly: true });
+ * const proxy = new LocalProxy({ preset: "chrome-146", tlsOnly: true });
  * console.log(`Proxy running on ${proxy.proxyUrl}`);
  * // Use with any HTTP client pointing to the proxy
  * proxy.close();
@@ -816,6 +844,10 @@ export function request(method: string, url: string, options?: RequestOptions):
 
 /** Available browser presets */
 export const Preset: {
+  CHROME_146: string;
+  CHROME_146_WINDOWS: string;
+  CHROME_146_LINUX: string;
+  CHROME_146_MACOS: string;
   CHROME_145: string;
   CHROME_145_WINDOWS: string;
   CHROME_145_LINUX: string;
@@ -833,9 +865,11 @@ export const Preset: {
   CHROME_143_IOS: string;
   CHROME_144_IOS: string;
   CHROME_145_IOS: string;
+  CHROME_146_IOS: string;
   CHROME_143_ANDROID: string;
   CHROME_144_ANDROID: string;
   CHROME_145_ANDROID: string;
+  CHROME_146_ANDROID: string;
   FIREFOX_133: string;
   SAFARI_18: string;
   SAFARI_17_IOS: string;
@@ -844,9 +878,11 @@ export const Preset: {
   IOS_CHROME_143: string;
   IOS_CHROME_144: string;
   IOS_CHROME_145: string;
+  IOS_CHROME_146: string;
   ANDROID_CHROME_143: string;
   ANDROID_CHROME_144: string;
   ANDROID_CHROME_145: string;
+  ANDROID_CHROME_146: string;
   IOS_SAFARI_17: string;
   IOS_SAFARI_18: string;
   all(): string[];

package/lib/index.js

@@ -31,7 +31,13 @@ class HTTPCloakError extends Error {
  *   const session = new httpcloak.Session({ preset: httpcloak.Preset.FIREFOX_133 });
  */
 const Preset = {
-  // Chrome 145 (latest)
+  // Chrome 146 (latest)
+  CHROME_146: "chrome-146",
+  CHROME_146_WINDOWS: "chrome-146-windows",
+  CHROME_146_LINUX: "chrome-146-linux",
+  CHROME_146_MACOS: "chrome-146-macos",
+
+  // Chrome 145
   CHROME_145: "chrome-145",
   CHROME_145_WINDOWS: "chrome-145-windows",
   CHROME_145_LINUX: "chrome-145-linux",
@@ -59,9 +65,11 @@ const Preset = {
   CHROME_143_IOS: "chrome-143-ios",
   CHROME_144_IOS: "chrome-144-ios",
   CHROME_145_IOS: "chrome-145-ios",
+  CHROME_146_IOS: "chrome-146-ios",
   CHROME_143_ANDROID: "chrome-143-android",
   CHROME_144_ANDROID: "chrome-144-android",
   CHROME_145_ANDROID: "chrome-145-android",
+  CHROME_146_ANDROID: "chrome-146-android",
 
   // Firefox
   FIREFOX_133: "firefox-133",
@@ -75,9 +83,11 @@ const Preset = {
   IOS_CHROME_143: "chrome-143-ios",
   IOS_CHROME_144: "chrome-144-ios",
   IOS_CHROME_145: "chrome-145-ios",
+  IOS_CHROME_146: "chrome-146-ios",
   ANDROID_CHROME_143: "chrome-143-android",
   ANDROID_CHROME_144: "chrome-144-android",
   ANDROID_CHROME_145: "chrome-145-android",
+  ANDROID_CHROME_146: "chrome-146-android",
   IOS_SAFARI_17: "safari-17-ios",
   IOS_SAFARI_18: "safari-18-ios",
 
@@ -87,12 +97,13 @@ const Preset = {
    */
   all() {
     return [
+      this.CHROME_146, this.CHROME_146_WINDOWS, this.CHROME_146_LINUX, this.CHROME_146_MACOS,
       this.CHROME_145, this.CHROME_145_WINDOWS, this.CHROME_145_LINUX, this.CHROME_145_MACOS,
       this.CHROME_144, this.CHROME_144_WINDOWS, this.CHROME_144_LINUX, this.CHROME_144_MACOS,
       this.CHROME_143, this.CHROME_143_WINDOWS, this.CHROME_143_LINUX, this.CHROME_143_MACOS,
       this.CHROME_141, this.CHROME_133,
-      this.CHROME_145_IOS, this.CHROME_144_IOS, this.CHROME_143_IOS,
-      this.CHROME_145_ANDROID, this.CHROME_144_ANDROID, this.CHROME_143_ANDROID,
+      this.CHROME_146_IOS, this.CHROME_145_IOS, this.CHROME_144_IOS, this.CHROME_143_IOS,
+      this.CHROME_146_ANDROID, this.CHROME_145_ANDROID, this.CHROME_144_ANDROID, this.CHROME_143_ANDROID,
       this.FIREFOX_133,
       this.SAFARI_18, this.SAFARI_17_IOS, this.SAFARI_18_IOS,
     ];
@@ -789,7 +800,9 @@ function getLib() {
       httpcloak_post: nativeLibHandle.func("httpcloak_post", "str", ["int64", "str", "str", "str"]),
       httpcloak_request: nativeLibHandle.func("httpcloak_request", "str", ["int64", "str"]),
       httpcloak_get_cookies: nativeLibHandle.func("httpcloak_get_cookies", "str", ["int64"]),
-      httpcloak_set_cookie: nativeLibHandle.func("httpcloak_set_cookie", "void", ["int64", "str", "str"]),
+      httpcloak_set_cookie: nativeLibHandle.func("httpcloak_set_cookie", "void", ["int64", "str"]),
+      httpcloak_delete_cookie: nativeLibHandle.func("httpcloak_delete_cookie", "void", ["int64", "str", "str"]),
+      httpcloak_clear_cookies: nativeLibHandle.func("httpcloak_clear_cookies", "void", ["int64"]),
       httpcloak_free_string: nativeLibHandle.func("httpcloak_free_string", "void", ["void*"]),
       httpcloak_version: nativeLibHandle.func("httpcloak_version", "str", []),
       httpcloak_available_presets: nativeLibHandle.func("httpcloak_available_presets", "str", []),
@@ -1162,7 +1175,7 @@ function version() {
 /**
  * Get available browser presets with their supported protocols.
  * Returns an object mapping preset names to their info:
- *   { "chrome-145": { protocols: ["h1", "h2", "h3"] }, ... }
+ *   { "chrome-146": { protocols: ["h1", "h2", "h3"] }, ... }
  */
 function availablePresets() {
   const nativeLib = getLib();
@@ -1228,7 +1241,7 @@ class Session {
   /**
    * Create a new session
    * @param {Object} options - Session options
-   * @param {string} [options.preset="chrome-145"] - Browser preset to use
+   * @param {string} [options.preset="chrome-146"] - Browser preset to use
    * @param {string} [options.proxy] - Proxy URL (e.g., "http://user:pass@host:port" or "socks5://host:port")
    * @param {string} [options.tcpProxy] - Proxy URL for TCP protocols (HTTP/1.1, HTTP/2) - use with udpProxy for split config
    * @param {string} [options.udpProxy] - Proxy URL for UDP protocols (HTTP/3 via MASQUE) - use with tcpProxy for split config
@@ -1249,7 +1262,7 @@ class Session {
    */
   constructor(options = {}) {
     const {
-      preset = "chrome-145",
+      preset = "chrome-146",
       proxy = null,
       tcpProxy = null,
       udpProxy = null,
@@ -1275,6 +1288,11 @@ class Session {
       ja3 = null,
       akamai = null,
       extraFp = null,
+      tcpTtl = null,
+      tcpMss = null,
+      tcpWindowSize = null,
+      tcpWindowScale = null,
+      tcpDf = null,
     } = options;
 
     this._lib = getLib();
@@ -1350,6 +1368,21 @@ class Session {
     if (extraFp) {
       config.extra_fp = extraFp;
     }
+    if (tcpTtl != null) {
+      config.tcp_ttl = tcpTtl;
+    }
+    if (tcpMss != null) {
+      config.tcp_mss = tcpMss;
+    }
+    if (tcpWindowSize != null) {
+      config.tcp_window_size = tcpWindowSize;
+    }
+    if (tcpWindowScale != null) {
+      config.tcp_window_scale = tcpWindowScale;
+    }
+    if (tcpDf != null) {
+      config.tcp_df = tcpDf;
+    }
 
     this._handle = this._lib.httpcloak_session_new(JSON.stringify(config));
 
@@ -1855,58 +1888,118 @@ class Session {
   // ===========================================================================
 
   /**
-   * Get all cookies from the session
-   * @returns {Object} Cookies as key-value pairs
+   * Get all cookies with full metadata (domain, path, expiry, flags).
+   * @returns {Cookie[]} Array of Cookie objects
    */
-  getCookies() {
+  getCookiesDetailed() {
     const resultPtr = this._lib.httpcloak_get_cookies(this._handle);
     const result = resultToString(resultPtr);
     if (result) {
-      return JSON.parse(result);
+      const parsed = JSON.parse(result);
+      return parsed.map(c => new Cookie(c));
     }
-    return {};
+    return [];
+  }
+
+  /**
+   * Get all cookies as a flat name-value object.
+   * @deprecated getCookies() will return Cookie[] with full metadata (domain, path, expiry) in a future release.
+   *             Use getCookiesDetailed() if you want the new format now.
+   * @returns {Object} Cookies as key-value pairs
+   */
+  getCookies() {
+    if (!Session._getCookiesDeprecated) {
+      Session._getCookiesDeprecated = true;
+      process.emitWarning(
+        'getCookies() currently returns a flat {name: value} object. In a future release, it will return Cookie[] with full metadata (domain, path, expiry, etc.), same as getCookiesDetailed(). Update your code accordingly.',
+        'DeprecationWarning'
+      );
+    }
+    const cookies = this.getCookiesDetailed();
+    const result = {};
+    for (const c of cookies) {
+      result[c.name] = c.value;
+    }
+    return result;
+  }
+
+  /**
+   * Get a specific cookie by name with full metadata.
+   * @param {string} name - Cookie name
+   * @returns {Cookie|null} Cookie object or null if not found
+   */
+  getCookieDetailed(name) {
+    const cookies = this.getCookiesDetailed();
+    return cookies.find(c => c.name === name) || null;
   }
 
   /**
-   * Get a specific cookie by name
+   * Get a specific cookie value by name.
+   * @deprecated getCookie() will return a Cookie object (with domain, path, expiry) instead of a string in a future release.
+   *             Use getCookieDetailed() if you want the new format now.
    * @param {string} name - Cookie name
    * @returns {string|null} Cookie value or null if not found
    */
   getCookie(name) {
-    const cookies = this.getCookies();
-    return cookies[name] || null;
+    if (!Session._getCookieDeprecated) {
+      Session._getCookieDeprecated = true;
+      process.emitWarning(
+        'getCookie() currently returns a string value. In a future release, it will return a Cookie object with full metadata (domain, path, expiry, etc.), same as getCookieDetailed(). Update your code accordingly.',
+        'DeprecationWarning'
+      );
+    }
+    const cookie = this.getCookieDetailed(name);
+    return cookie ? cookie.value : null;
   }
 
   /**
    * Set a cookie in the session
    * @param {string} name - Cookie name
    * @param {string} value - Cookie value
-   */
-  setCookie(name, value) {
-    this._lib.httpcloak_set_cookie(this._handle, name, value);
+   * @param {Object} [options] - Cookie options
+   * @param {string} [options.domain] - Cookie domain
+   * @param {string} [options.path] - Cookie path (default: "/")
+   * @param {boolean} [options.secure] - Secure flag
+   * @param {boolean} [options.httpOnly] - HttpOnly flag
+   * @param {string} [options.sameSite] - SameSite attribute (Strict, Lax, None)
+   * @param {number} [options.maxAge] - Max age in seconds (0 means not set)
+   * @param {string} [options.expires] - Expiration date (RFC1123 format)
+   */
+  setCookie(name, value, options = {}) {
+    const cookie = {
+      name,
+      value,
+      domain: options.domain || "",
+      path: options.path || "/",
+      secure: options.secure || false,
+      http_only: options.httpOnly || false,
+      same_site: options.sameSite || "",
+      max_age: options.maxAge || 0,
+      expires: options.expires || "",
+    };
+    this._lib.httpcloak_set_cookie(this._handle, JSON.stringify(cookie));
   }
 
   /**
    * Delete a specific cookie by name
    * @param {string} name - Cookie name to delete
+   * @param {string} [domain] - Domain to delete from (omit to delete from all domains)
    */
-  deleteCookie(name) {
-    // Set cookie to empty value - effectively deletes it
-    this._lib.httpcloak_set_cookie(this._handle, name, "");
+  deleteCookie(name, domain = "") {
+    this._lib.httpcloak_delete_cookie(this._handle, name, domain);
   }
 
   /**
    * Clear all cookies from the session
    */
   clearCookies() {
-    const cookies = this.getCookies();
-    for (const name of Object.keys(cookies)) {
-      this.deleteCookie(name);
-    }
+    this._lib.httpcloak_clear_cookies(this._handle);
   }
 
   /**
-   * Get cookies as a property
+   * Get cookies as a property.
+   * @deprecated This property will return Cookie[] with full metadata in a future release.
+   * @returns {Object} Cookies as key-value pairs
    */
   get cookies() {
     return this.getCookies();
@@ -2077,7 +2170,7 @@ class Session {
    * @param {string} path - Path to save the session file
    *
    * Example:
-   *   const session = new httpcloak.Session({ preset: "chrome-145" });
+   *   const session = new httpcloak.Session({ preset: "chrome-146" });
    *   await session.get("https://example.com");  // Acquire cookies
    *   session.save("session.json");
    *
@@ -2715,7 +2808,7 @@ let _defaultConfig = {};
 /**
  * Configure defaults for module-level functions
  * @param {Object} options - Configuration options
- * @param {string} [options.preset="chrome-145"] - Browser preset
+ * @param {string} [options.preset="chrome-146"] - Browser preset
  * @param {Object} [options.headers] - Default headers
  * @param {Array} [options.auth] - Default basic auth [username, password]
  * @param {string} [options.proxy] - Proxy URL
@@ -2729,7 +2822,7 @@ let _defaultConfig = {};
  */
 function configure(options = {}) {
   const {
-    preset = "chrome-145",
+    preset = "chrome-146",
     headers = null,
     auth = null,
     proxy = null,
@@ -2787,7 +2880,7 @@ function configure(options = {}) {
  */
 function _getDefaultSession() {
   if (!_defaultSession) {
-    const preset = _defaultConfig.preset || "chrome-145";
+    const preset = _defaultConfig.preset || "chrome-146";
     const proxy = _defaultConfig.proxy || null;
     const timeout = _defaultConfig.timeout || 30;
     const httpVersion = _defaultConfig.httpVersion || "auto";
@@ -2890,7 +2983,7 @@ function request(method, url, options = {}) {
  * Without registration, cache callbacks will not be triggered for that session.
  *
  * @example
- * const proxy = new LocalProxy({ preset: "chrome-145", tlsOnly: true });
+ * const proxy = new LocalProxy({ preset: "chrome-146", tlsOnly: true });
  * console.log(`Proxy running on ${proxy.proxyUrl}`);
  *
  * // Use with any HTTP client pointing to the proxy
@@ -2919,7 +3012,7 @@ class LocalProxy {
    * Create and start a local HTTP proxy server.
    * @param {Object} options - Proxy configuration options
    * @param {number} [options.port=0] - Port to listen on (0 = auto-select)
-   * @param {string} [options.preset="chrome-145"] - Browser fingerprint preset
+   * @param {string} [options.preset="chrome-146"] - Browser fingerprint preset
    * @param {number} [options.timeout=30] - Request timeout in seconds
    * @param {number} [options.maxConnections=1000] - Maximum concurrent connections
    * @param {string} [options.tcpProxy] - Default upstream TCP proxy URL
@@ -2929,7 +3022,7 @@ class LocalProxy {
   constructor(options = {}) {
     const {
       port = 0,
-      preset = "chrome-145",
+      preset = "chrome-146",
       timeout = 30,
       maxConnections = 1000,
       tcpProxy = null,

package/npm/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@httpcloak/darwin-arm64",
-  "version": "1.6.1-beta.2",
+  "version": "1.6.1",
   "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.6.1-beta.2",
+  "version": "1.6.1",
   "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.6.1-beta.2",
+  "version": "1.6.1",
   "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.6.1-beta.2",
+  "version": "1.6.1",
   "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.6.1-beta.2",
+  "version": "1.6.1",
   "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.6.1-beta.2",
+  "version": "1.6.1",
   "description": "HTTPCloak native binary for win32 x64",
   "os": [
     "win32"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "httpcloak",
-  "version": "1.6.1-beta.2",
+  "version": "1.6.1",
   "description": "Browser fingerprint emulation HTTP client with HTTP/1.1, HTTP/2, and HTTP/3 support",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
@@ -49,12 +49,12 @@
     "koffi": "^2.9.0"
   },
   "optionalDependencies": {
-    "@httpcloak/darwin-arm64": "1.6.1-beta.2",
-    "@httpcloak/darwin-x64": "1.6.1-beta.2",
-    "@httpcloak/linux-arm64": "1.6.1-beta.2",
-    "@httpcloak/linux-x64": "1.6.1-beta.2",
-    "@httpcloak/win32-arm64": "1.6.1-beta.2",
-    "@httpcloak/win32-x64": "1.6.1-beta.2"
+    "@httpcloak/darwin-arm64": "1.6.1",
+    "@httpcloak/darwin-x64": "1.6.1",
+    "@httpcloak/linux-arm64": "1.6.1",
+    "@httpcloak/linux-x64": "1.6.1",
+    "@httpcloak/win32-arm64": "1.6.1",
+    "@httpcloak/win32-x64": "1.6.1"
   },
   "devDependencies": {
     "@types/node": "^25.1.0",