docs: update all documentation for 2025-09-15 release features and proxy system rewrite

Author: MSTU0

ADVANCED_FEATURES.md

@@ -62,8 +62,8 @@ chrome.exe --bot-profile="profile.enc" \
            --bot-bookmarks='[{"name":"Research","url":"https://example.com","folder":"Work"}]'
 ```
 
-### Advanced Proxy Authentication
-Enhanced proxy support with embedded credentials and automatic geo-detection.
+### Enhanced Proxy System
+Rewritten proxy subsystem with stability improvements, per-context support, and DNS leak protection.
 
 **Embedded Credentials:**
 ```bash
@@ -76,7 +76,36 @@ Enhanced proxy support with embedded credentials and automatic geo-detection.
 ```
 
 
-**Important:** Use BotBrowser's `--proxy-server` flag instead of framework-specific proxy options (like `page.authenticate()` in Puppeteer) to ensure proper geo-detection for timezone/locale auto-configuration.
+**Per-Context Proxy Support:**
+```javascript
+// Playwright example with different proxies per context
+const browser = await chromium.launch({
+  executablePath: './chrome', // BotBrowser path
+  args: ['--bot-profile=profile.enc']
+});
+
+// Context 1 with proxy A
+const context1 = await browser.newContext({
+  proxy: { server: 'http://user1:[email protected]:8080' }
+});
+
+// Context 2 with proxy B
+const context2 = await browser.newContext({
+  proxy: { server: 'socks5://user2:[email protected]:1080' }
+});
+```
+
+**Performance Optimization:**
+```bash
+# Skip IP lookups for faster page loads
+--proxy-server="http://user:[email protected]:8080" --proxy-ip="203.0.113.1"
+```
+
+**DNS Leak Protection:**
+- SOCKS5 proxies now prevent local DNS resolution
+- All domain lookups go through the proxy tunnel
+
+**Important:** Use BotBrowser's proxy options instead of framework-specific settings to ensure proper geo-detection for timezone/locale auto-configuration.
 
 ---
 

CHANGELOG.md

@@ -9,6 +9,38 @@ This software and its documented capabilities are provided for **academic study
 ⚠️ **This software is for compatibility validation in controlled, academic test environments only. It must not be used to bypass security controls on production systems.**
 
 
+## [2025-09-15]
+
+### Major
+- **Chromium Core Upgrade → 140.0.7339.128**
+  Keeps BotBrowser in lock‑step with the latest stable Chrome for improved performance, security patches, and parity across modern web/APIs.
+
+- **Proxy Subsystem Rewrite (faster • more stable • unified config)**
+  Re‑architected proxy stack to reduce connection latency and flakiness. **Deprecated** `--proxy-username` / `--proxy-password`; now use a single **`--proxy-server`** (or profile) endpoint that supports **auth & multiple protocols** (e.g., `http(s)`, `socks5`). Example: `socks5://user:pass@host:port`.
+
+- **Per‑Context Proxy (createBrowserContext)**
+  You can assign a **different `proxy-server` per BrowserContext**, including authenticated endpoints. Enables multi‑proxy, high‑concurrency tasks in one process.
+  Resolves: https://github.com/botswin/BotBrowser/issues/61
+
+### Improved / Fixed
+- **DNS Leak Hardening for SOCKS5**
+  Fixed a case where domain resolution might occur locally under SOCKS5, preventing DNS leaks and strengthening stealth.
+
+### New
+- **CLI: `--proxy-ip` (profile key: `configs.proxy.ip`)**
+  Provide the proxy’s public IP via CLI or profile so BotBrowser **skips per‑page IP lookups**, speeding up page open. Combine with `--bot-config-timezone` to emulate regions/timezones consistently.
+
+- **CLI: `--bot-config-mobile-force-touch` (profile key: `configs.mobileForceTouch`)**
+  Force **on/off** touch emission when simulating mobile devices. Useful for sites that require touch events regardless of the detected environment.
+  Resolves: https://github.com/botswin/BotBrowser/issues/65
+
+### Migration Notes
+- Replace `--proxy-username/--proxy-password` with **embedded credentials in `--proxy-server`** (or in the profile).
+  Example: `http://user:pass@ip:port`, `socks5://user:pass@ip:port`.
+
+
+---
+
 ## [2025-09-06]
 
 ### Major

CLI_FLAGS.md

@@ -59,6 +59,20 @@ BotBrowser enhanced the standard `--proxy-server` flag to accept embedded creden
 
 **Supported protocols:** HTTP, HTTPS, SOCKS5
 
+### `--proxy-ip`
+**Specify proxy's public IP to optimize performance**
+
+Provide the proxy's public IP address to skip per-page IP lookups, improving page load performance.
+
+```bash
+--proxy-ip="203.0.113.1"
+```
+
+**Benefits:**
+- Eliminates IP detection overhead on each page load
+- Faster browsing when using proxies
+- Combine with `--bot-config-timezone` for consistent region emulation
+
 
 ⚠️ **Important:** Use `--proxy-server` flag instead of framework-specific proxy options (like `page.authenticate()` in Puppeteer or `proxy` parameter in Playwright's `launch()`). This ensures BotBrowser can retrieve geo information from proxy IP for accurate timezone/locale auto-configuration.
 
@@ -159,6 +173,7 @@ The following `--bot-config-*` flags correspond directly to profile `configs` pr
 --bot-config-webrtc=profile                   # WebRTC: profile (use profile), real (native), disabled (off)
 --bot-config-window=profile                   # Window dimensions: profile (use profile), real (system window)
 --bot-config-media-types=profile              # Media types: profile, real, expand (allow expanding via local decoders)
+--bot-config-mobile-force-touch=false         # Mobile touch: force touch events on/off for mobile device simulation
 ```
 
 ### Key Benefits of CLI Configuration Flags

README.md

@@ -56,9 +56,10 @@ Automatic touch simulation, device metrics, and consistent fingerprint rendering
 BotBrowser provides sophisticated browser fingerprint consistency testing through multiple layers of emulation and control:
 
 **🔧 Configuration & Control**
-- **21+ `--bot-config-*` flags** - Override browser brand, WebGL, timezone, etc.
+- **22+ `--bot-config-*` flags** - Override browser brand, WebGL, timezone, mobile touch, etc.
 - **Session Management** - Custom titles, cookies, bookmarks with `--bot-title`
-- **Advanced Proxy Auth** - Direct credentials: `--proxy-server="http://user:[email protected]:8080"`
+- **Enhanced Proxy System** - Rewritten for stability, per-context proxies, DNS leak protection
+- **Performance Optimization** - `--proxy-ip` skips IP lookups for faster page loads
 
 **🎭 Automation Research** 
 - **Multi-Layer Noise Injection** - Canvas, WebGL, Audio with per-session consistency

profiles/PROFILE_CONFIGS.md

@@ -93,12 +93,14 @@ All configurations are embedded in the `configs` field inside your profile JSON
 | `disableDebugger`               | Prevents unintended interruptions from JavaScript debugger statements during automated academic workflows. | `true`     |
 | `keyboard`                      | Choose keyboard fingerprint source: `profile` (emulated from profile) or `real` (use system keyboard). | `profile` |
 | `mediaTypes`                    | Media types behavior: `profile` (use profile settings), `real` (native system), `expand` (allow expanding via local decoders). | `profile` |
+| `mobileForceTouch`              | Force touch events on/off when simulating mobile devices (`true`, `false`).          | `false`    |
 
 ### Proxy Settings
 
 | Field            | Description                               | Default |
 | ---------------- | ----------------------------------------- | ------- |
 | `proxy.server`   | Proxy server address (`scheme://username:password@hostname:port`).   | `""`    |
+| `proxy.ip`       | Proxy's public IP address (skips IP lookups for better performance). | `""`    |
 
 > 💡 **Better Approach:** Use CLI flags for proxy configuration:
 > ```bash
@@ -158,7 +160,8 @@ All configurations are embedded in the `configs` field inside your profile JSON
 
     // Proxy settings: hostname:port, with optional basic auth
     "proxy": {
-      "server": "1.2.3.4:8080"
+      "server": "1.2.3.4:8080",
+      "ip": "1.2.3.4"
     },
 
     // Disable GUI scaling based on device scale factor (ignore DevicePixelRatio for UI scaling)
@@ -225,6 +228,9 @@ All configurations are embedded in the `configs` field inside your profile JSON
 
     // keyboard: choose keyboard fingerprint source: "profile" (emulated from profile) or "real" (use system keyboard)
     "keyboard": "profile",
+
+    // mobileForceTouch: Force touch events on/off when simulating mobile devices
+    "mobileForceTouch": false,
   }
 }