Files
CloakBrowser/CHANGELOG.md
T
CloakHQ d8960447a0 feat: add wrapper version update checks for PyPI and npm
Check for newer wrapper versions on startup (once per process).
Python queries PyPI, JS queries npm registry. Respects
CLOAKBROWSER_AUTO_UPDATE=false and CLOAKBROWSER_DOWNLOAD_URL
(custom mirror mode skips external registry calls).

Includes unit tests for both languages covering: update detection,
env var gating, network error handling, and once-per-process guard.
2026-03-03 01:21:41 +01:00

5.7 KiB
Raw Blame History

Changelog

All notable changes to CloakBrowser — wrapper and binary — are documented here.

Changes are tagged: [wrapper] for Python/JS wrapper, [binary] for Chromium patches.


[0.3.1] — 2026-03-03

  • [wrapper] Auto-check for wrapper updates on startup (PyPI/npm). Notifies users when a newer wrapper version is available. Runs once per process, respects CLOAKBROWSER_AUTO_UPDATE=false.

[0.3.0] — 2026-03-02

Chromium v145 upgrade. 25 fingerprint patches (up from 16). New download verification and fallback system. macOS v145 binary builds pending.

Breaking

  • [wrapper] Python dependency changed from playwright to patchright (CDP stealth fork). Patchright is API-compatible, but if you import playwright directly elsewhere, add it as a separate dependency. Replace from playwright.sync_api with from patchright.sync_api (or keep using cloakbrowser.launch() which handles this automatically).
  • [wrapper] launch_context() / launchContext() now defaults viewport to 1920×947 (realistic maximized Chrome on 1080p Windows with 48px taskbar) instead of Playwright's default 1280×720. Pass viewport={"width": 1280, "height": 720} explicitly to restore old behavior.

2026-03-02

  • [binary] Full stealth audit — multiple detection vectors eliminated, improved cross-API consistency
  • [binary] Platform-aware fingerprint defaults: screen dimensions, taskbar, and layout auto-adjust per spoofed platform
  • [binary] Stability and performance improvements across fingerprint patches
  • [binary] New optional flags: --fingerprint-fonts-dir, --fingerprint-taskbar-height
  • [wrapper] Sync wrapper with latest binary changes: updated flag names, viewport, and defaults
  • [wrapper] Per-platform Chromium versioning — Linux and macOS can track different binary versions independently
  • [wrapper] Improved SHA-256 checksum verification and version marker migration

2026-03-01

  • [wrapper] Upgrade wrapper to Chromium v145.0.7632.109
  • [wrapper] Add GitHub Releases fallback when primary download mirror is unavailable
  • [wrapper] Add SHA-256 checksum verification for binary downloads
  • [wrapper] Wire timezone and locale params to Chromium binary flags
  • [wrapper] Add device memory to default stealth args
  • [wrapper] JS: add colorScheme support, guard download fallback against partial failures

2026-02-28

  • [binary] Enforce strict flag discipline — patches only activate when explicitly configured via command-line flags
  • [binary] Improved fingerprint consistency across multiple browser APIs
  • [binary] 3 new fingerprint patches + bug fixes in existing patches
  • [binary] New command-line flag for device memory spoofing
  • [infra] Automated test matrix: 8 groups, 41+ tests across core stealth, fingerprint noise, bot detection, reCAPTCHA, TLS, Turnstile, residential proxy, and enterprise reCAPTCHA
  • [infra] Docker-based test runner with subprocess isolation per test group

2026-02-25

  • [binary] Reduced automation markers visible to detection scripts
  • [binary] Added browser API support at build time
  • [binary] Improved screen property consistency

2026-02-24

  • [binary] Comprehensive fingerprint audit and hardening pass
  • [binary] Fixed font rendering edge case on cross-platform spoofing
  • [binary] 4 new fingerprint patches

2026-02-22

  • [binary] Start Chromium v145 build (v145.0.7632.109)
  • [binary] 24 fingerprint patches ported and adapted

[0.2.2] — 2026-03-01

2026-03-01

  • [wrapper] Fix: replace page.wait_for_timeout() with time.sleep() to avoid timing leak
  • [wrapper] Add auto-detect timezone and locale from proxy IP via GeoIP lookup
  • [binary] CDP detection vector audit and hardening

[0.2.0] — 2026-02-27

macOS platform release. JavaScript/TypeScript wrapper. Self-hosted binary mirror.

2026-02-27

  • [wrapper] Add macOS support: Apple Silicon (arm64) and Intel (x64) binary downloads
  • [wrapper] Add GPG-signed release workflow via GitHub Actions
  • [wrapper] Fix macOS binary download: preserve .app symlinks, remove quarantine xattrs
  • [wrapper] Add real bot detection assertions to stealth tests
  • [wrapper] Bump version to 0.2.0

2026-02-26

  • [wrapper] Switch binary downloads to self-hosted mirror (cloakbrowser.dev) as GitHub backup
  • [wrapper] Set up GitLab mirror at gitlab.com/CloakHQ/cloakbrowser

2026-02-25

  • [wrapper] Move binary releases from separate repo to wrapper repo
  • [wrapper] Add auto-update check on launch
  • [infra] Initial Docker test infrastructure + matrix test runner

2026-02-24

  • [wrapper] Add JavaScript/TypeScript wrapper with Playwright + Puppeteer support (npm install cloakbrowser)
  • [wrapper] Fix proxy authentication credentials support in URL (closes #4)

[0.1.4] — 2026-02-23

2026-02-23

  • [wrapper] Stealth hardening: additional launch args and detection evasion improvements
  • [wrapper] Full test suite rewrite with real detection site assertions
  • [wrapper] Add Docker support with Dockerfile and compose config
  • [wrapper] Add headed mode documentation

[0.1.0] — 2026-02-22

Initial release. Chromium v142 with 16 fingerprint patches.

2026-02-22

  • [binary] Chromium v142.0.7444.175 with 16 source-level fingerprint patches
  • [binary] Fix browser brand string to match Chrome 142 format
  • [wrapper] launch() and launch_async() — drop-in Playwright replacements
  • [wrapper] Auto-download binary from GitHub Releases, cached in ~/.cloakbrowser/
  • [wrapper] Linux x64 platform support
  • [wrapper] Passes 14/14 bot detection tests
  • [wrapper] reCAPTCHA v3: 0.9 (server-verified), Cloudflare Turnstile: pass