capiumbrowser 1.2.0__tar.gz → 1.2.1__tar.gz

{capiumbrowser-1.2.0 → capiumbrowser-1.2.1}/MANIFEST.in

@@ -1,5 +1,8 @@
 include README.md
 include LICENSE
 include capiumbrowser/channels.json
+include capiumbrowser/android-phones.json
+include capiumbrowser/ios-phones.json
+include capiumbrowser/browser-brands.json
 global-exclude __pycache__/*
 global-exclude *.py[cod]

{capiumbrowser-1.2.0/capiumbrowser.egg-info → capiumbrowser-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capiumbrowser
-Version: 1.2.0
+Version: 1.2.1
 Summary: Drop-in stealth browser SDK on top of Playwright (Capium Chromium).
 Author: Capzy
 License: Capzy capiumbrowser SDK License
@@ -128,6 +128,7 @@ browser.close()                  # also stops the Playwright driver — no leake
 - [Install](#install) · [Why Capium](#why-capium) · [Licensing & tiers](#licensing)
 - [What a persona reads](#what-a-persona-reads) · [Comparison](#comparison) · [How it works](#how-it-works)
 - [API](#api) · [Parameters](#parameters) · [Personas & seeds](#personas--seeds) · [Fingerprint switches](#fingerprint-switches)
+- [Browser and mobile profiles](#browser-and-mobile-profiles)
 - [Human behavior](#human-behavior) · [Proxies & geo](#proxies--geo) · [Fonts](#fonts)
 - [Framework integrations](#framework-integrations) · [Deployment](#deployment) · [Platforms](#platforms)
 - [CLI](#cli--environment) · [Troubleshooting](#troubleshooting) · [FAQ](#faq) · [Security](#security) · [License](#license)
@@ -395,7 +396,9 @@ and `launch_persistent_context` forward everything to `launch`.
 | Parameter | Type | Default | Description |
 |---|---|---|---|
 | `seed` | `int` \| `None` \| `"off"` | `None` | Persona seed → a complete coherent device. `None` = fresh random seed each launch. The range selects the OS family (see [Personas & seeds](#personas--seeds)). `"off"`/`"false"`/`"none"` = **passthrough** (host's real values; debugging). |
-| `platform` | `str` | `"windows"` | Spoofed OS: `"windows"` \| `"macos"` \| `"linux"`. Sets `--fingerprint-platform` and picks the seed range if you didn't. |
+| `platform` | `str` | `"windows"` | OS profile: `"windows"` \| `"macos"` \| `"linux"` \| `"android"` \| `"ios"`. Mobile profiles are opt-in. |
+| `browser_brand` | `str` | `"chrome"` | Desktop profile: `chrome`, `edge`, `opera`, `vivaldi`. |
+| `mobile_device` | `str` | seed/default | Phone catalog ID; requires `android` or `ios`. |
 | `headless` | `bool` | `False` | Headed is recommended (reads cleaner). On a server, run headed under Xvfb. |
 | `stealth_args` | `bool` | `True` | Apply the default coherent fingerprint flags. Set `False` to build the whole command line yourself via `args`. |
 | `args` | `list[str]` \| `None` | `None` | Extra raw Chrome flags appended verbatim (see [Fingerprint switches](#fingerprint-switches)). |
@@ -496,6 +499,42 @@ Full runnable version (personas, persistent profiles, a fleet, proxy+geo, full c
 
 ---
 
+## Browser and mobile profiles
+
+CapiumBrowser 1.2.1 supports desktop Chrome, Edge, Opera and Vivaldi identity
+profiles, plus opt-in Android and iPhone profiles on Windows x64, macOS arm64
+and Linux x64. Chrome remains the default.
+
+| Profile | Python | Node.js |
+| --- | --- | --- |
+| Desktop browser | `browser_brand="edge"` (also `chrome`, `opera`, `vivaldi`) | `browserBrand: 'edge'` |
+| Android phone | `platform="android", mobile_device="pixel-9"` | `platform: 'android', mobileDevice: 'pixel-9'` |
+| iPhone 16 | `platform="ios", mobile_device="iphone-16"` | `platform: 'ios', mobileDevice: 'iphone-16'` |
+
+Android includes Pixel 7/8/9 families and Samsung Galaxy A55. Omit the Android
+device to retain the original seed selection; iOS defaults to iPhone 16. Mobile
+profiles set the mobile layout and identity while leaving desktop defaults intact.
+These are experimental desktop emulation profiles: they do not install Android
+or iOS, reproduce WebKit, or certify physical-phone fingerprints. Android Chrome
+and Chrome iOS are the supported mobile browser profiles; arbitrary app/WebView
+UAs are outside these presets.
+
+Desktop profiles use verified browser/Chromium version pairs: Edge 155/155,
+Opera 137/153 and Vivaldi 8.2/152. Vivaldi follows its usual Chrome branding.
+Capium's engine remains Chromium 155; vendor-specific features are not emulated.
+A version catalog is not an older browser engine. Native compatibility checks
+reject binaries that do not implement the selected profile.
+
+```python
+from capiumbrowser import launch_context
+
+browser, context, page = launch_context(
+    seed=200123, platform="ios", mobile_device="iphone-16")
+# Android: platform="android", mobile_device="pixel-9"
+# Desktop Edge: platform="windows", browser_brand="edge"
+browser.close()
+```
+
 ## Fingerprint switches
 
 The SDK sets the essentials from `seed`/`platform`. Everything below is available for precise control —
@@ -725,13 +764,12 @@ launches **headed**, which reads cleaner than headless.
 | Linux arm64 | `linux-arm64` | Declared in the manifest; not yet published or covered by the three-host audit |
 
 The SDK auto-detects your host and downloads the matching tag; macOS Intel and Windows ARM are **not**
-published and raise a clear error. The **1.2.0** manifest selects **Chromium 155.0.8059.39, revision 1** on the three
-supported hosts. This release is prepared as a draft; downloads become available when the browser
-artifacts are published. Linux arm64 remains unpublished.
+published and raise a clear error. The **1.2.1** manifest selects **Chromium 155.0.8059.39, revision 2** on the three
+supported hosts. Browser downloads are available with a valid license. Linux arm64 remains unpublished.
 
 ---
 
-The 1.2.0 launch APIs wait for the packaged browser's licensing decision before
+The launch APIs wait for the packaged browser's licensing decision before
 returning a handle. Invalid keys raise a typed error during launch.
 
 ## CLI & environment

{capiumbrowser-1.2.0 → capiumbrowser-1.2.1}/README.md

@@ -65,6 +65,7 @@ browser.close()                  # also stops the Playwright driver — no leake
 - [Install](#install) · [Why Capium](#why-capium) · [Licensing & tiers](#licensing)
 - [What a persona reads](#what-a-persona-reads) · [Comparison](#comparison) · [How it works](#how-it-works)
 - [API](#api) · [Parameters](#parameters) · [Personas & seeds](#personas--seeds) · [Fingerprint switches](#fingerprint-switches)
+- [Browser and mobile profiles](#browser-and-mobile-profiles)
 - [Human behavior](#human-behavior) · [Proxies & geo](#proxies--geo) · [Fonts](#fonts)
 - [Framework integrations](#framework-integrations) · [Deployment](#deployment) · [Platforms](#platforms)
 - [CLI](#cli--environment) · [Troubleshooting](#troubleshooting) · [FAQ](#faq) · [Security](#security) · [License](#license)
@@ -332,7 +333,9 @@ and `launch_persistent_context` forward everything to `launch`.
 | Parameter | Type | Default | Description |
 |---|---|---|---|
 | `seed` | `int` \| `None` \| `"off"` | `None` | Persona seed → a complete coherent device. `None` = fresh random seed each launch. The range selects the OS family (see [Personas & seeds](#personas--seeds)). `"off"`/`"false"`/`"none"` = **passthrough** (host's real values; debugging). |
-| `platform` | `str` | `"windows"` | Spoofed OS: `"windows"` \| `"macos"` \| `"linux"`. Sets `--fingerprint-platform` and picks the seed range if you didn't. |
+| `platform` | `str` | `"windows"` | OS profile: `"windows"` \| `"macos"` \| `"linux"` \| `"android"` \| `"ios"`. Mobile profiles are opt-in. |
+| `browser_brand` | `str` | `"chrome"` | Desktop profile: `chrome`, `edge`, `opera`, `vivaldi`. |
+| `mobile_device` | `str` | seed/default | Phone catalog ID; requires `android` or `ios`. |
 | `headless` | `bool` | `False` | Headed is recommended (reads cleaner). On a server, run headed under Xvfb. |
 | `stealth_args` | `bool` | `True` | Apply the default coherent fingerprint flags. Set `False` to build the whole command line yourself via `args`. |
 | `args` | `list[str]` \| `None` | `None` | Extra raw Chrome flags appended verbatim (see [Fingerprint switches](#fingerprint-switches)). |
@@ -433,6 +436,42 @@ Full runnable version (personas, persistent profiles, a fleet, proxy+geo, full c
 
 ---
 
+## Browser and mobile profiles
+
+CapiumBrowser 1.2.1 supports desktop Chrome, Edge, Opera and Vivaldi identity
+profiles, plus opt-in Android and iPhone profiles on Windows x64, macOS arm64
+and Linux x64. Chrome remains the default.
+
+| Profile | Python | Node.js |
+| --- | --- | --- |
+| Desktop browser | `browser_brand="edge"` (also `chrome`, `opera`, `vivaldi`) | `browserBrand: 'edge'` |
+| Android phone | `platform="android", mobile_device="pixel-9"` | `platform: 'android', mobileDevice: 'pixel-9'` |
+| iPhone 16 | `platform="ios", mobile_device="iphone-16"` | `platform: 'ios', mobileDevice: 'iphone-16'` |
+
+Android includes Pixel 7/8/9 families and Samsung Galaxy A55. Omit the Android
+device to retain the original seed selection; iOS defaults to iPhone 16. Mobile
+profiles set the mobile layout and identity while leaving desktop defaults intact.
+These are experimental desktop emulation profiles: they do not install Android
+or iOS, reproduce WebKit, or certify physical-phone fingerprints. Android Chrome
+and Chrome iOS are the supported mobile browser profiles; arbitrary app/WebView
+UAs are outside these presets.
+
+Desktop profiles use verified browser/Chromium version pairs: Edge 155/155,
+Opera 137/153 and Vivaldi 8.2/152. Vivaldi follows its usual Chrome branding.
+Capium's engine remains Chromium 155; vendor-specific features are not emulated.
+A version catalog is not an older browser engine. Native compatibility checks
+reject binaries that do not implement the selected profile.
+
+```python
+from capiumbrowser import launch_context
+
+browser, context, page = launch_context(
+    seed=200123, platform="ios", mobile_device="iphone-16")
+# Android: platform="android", mobile_device="pixel-9"
+# Desktop Edge: platform="windows", browser_brand="edge"
+browser.close()
+```
+
 ## Fingerprint switches
 
 The SDK sets the essentials from `seed`/`platform`. Everything below is available for precise control —
@@ -662,13 +701,12 @@ launches **headed**, which reads cleaner than headless.
 | Linux arm64 | `linux-arm64` | Declared in the manifest; not yet published or covered by the three-host audit |
 
 The SDK auto-detects your host and downloads the matching tag; macOS Intel and Windows ARM are **not**
-published and raise a clear error. The **1.2.0** manifest selects **Chromium 155.0.8059.39, revision 1** on the three
-supported hosts. This release is prepared as a draft; downloads become available when the browser
-artifacts are published. Linux arm64 remains unpublished.
+published and raise a clear error. The **1.2.1** manifest selects **Chromium 155.0.8059.39, revision 2** on the three
+supported hosts. Browser downloads are available with a valid license. Linux arm64 remains unpublished.
 
 ---
 
-The 1.2.0 launch APIs wait for the packaged browser's licensing decision before
+The launch APIs wait for the packaged browser's licensing decision before
 returning a handle. Invalid keys raise a typed error during launch.
 
 ## CLI & environment

{capiumbrowser-1.2.0 → capiumbrowser-1.2.1}/capiumbrowser/_version.py

@@ -17,7 +17,7 @@ import json
 import os
 import platform as _platform
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"
 
 # Used only if channels.json can't be read (corrupt/removed install). ensure_binary() raises a
 # clear error long before the "unsupported platform" case matters; this keeps lookups total.

capiumbrowser-1.2.1/capiumbrowser/android-phones.json

@@ -0,0 +1,99 @@
+{
+  "schema_version": 2,
+  "minimum_release_year": 2022,
+  "browser": "chrome",
+  "status": "experimental-emulation",
+  "gpu_policy": "host",
+  "hardware_policy": "host",
+  "physical_device_validation": "pending",
+  "default_profile_ids": [
+    "pixel-7",
+    "pixel-8",
+    "pixel-8-pro",
+    "pixel-8a",
+    "pixel-9"
+  ],
+  "sources": [
+    "https://support.google.com/pixelphone/answer/7158570?hl=en",
+    "https://news.samsung.com/global/samsung-galaxy-a55-5g-and-galaxy-a35-5g-awesome-innovations-and-security-engineered-for-everyone",
+    "https://www.samsung.com/ie/business/smartphones/galaxy-a/galaxy-a55-5g-awesome-navy-256gb-sm-a556bzkceub/",
+    "https://chromium.googlesource.com/devtools/devtools-frontend/+/cd7bfad9bba968ac23ba67e538f9e1d499991d25/front_end/models/emulation/EmulatedDevices.ts"
+  ],
+  "profiles": [
+    {
+      "id": "pixel-7",
+      "model": "Pixel 7",
+      "release_year": 2022,
+      "platform_version": "13",
+      "width": 412,
+      "height": 915,
+      "dpr": 2.625
+    },
+    {
+      "id": "pixel-8",
+      "model": "Pixel 8",
+      "release_year": 2023,
+      "platform_version": "14",
+      "width": 412,
+      "height": 915,
+      "dpr": 2.625
+    },
+    {
+      "id": "pixel-8-pro",
+      "model": "Pixel 8 Pro",
+      "release_year": 2023,
+      "platform_version": "14",
+      "width": 448,
+      "height": 997,
+      "dpr": 3.0
+    },
+    {
+      "id": "pixel-8a",
+      "model": "Pixel 8a",
+      "release_year": 2024,
+      "platform_version": "14",
+      "width": 412,
+      "height": 915,
+      "dpr": 2.625
+    },
+    {
+      "id": "pixel-9",
+      "model": "Pixel 9",
+      "release_year": 2024,
+      "platform_version": "14",
+      "width": 412,
+      "height": 924,
+      "dpr": 2.625
+    },
+    {
+      "id": "samsung-galaxy-a55",
+      "model": "SM-A556B",
+      "display_name": "Samsung Galaxy A55",
+      "release_year": 2024,
+      "platform_version": "14",
+      "width": 360,
+      "height": 800,
+      "dpr": 2.25,
+      "geometry_status": "devtools-emulation-only",
+      "geometry_note": "These Chromium preset dimensions/DPR do not directly map to the published 1080x2340 panel; physical Chrome capture required."
+    },
+    {
+      "id": "pixel-9-pro",
+      "model": "Pixel 9 Pro",
+      "release_year": 2024,
+      "platform_version": "14",
+      "width": 427,
+      "height": 952,
+      "dpr": 3.0
+    },
+    {
+      "id": "pixel-9-pro-xl",
+      "model": "Pixel 9 Pro XL",
+      "release_year": 2024,
+      "platform_version": "14",
+      "width": 448,
+      "height": 997,
+      "dpr": 3.0
+    }
+  ]
+}

capiumbrowser-1.2.1/capiumbrowser/browser-brands.json

@@ -0,0 +1,47 @@
+{
+  "schema_version": 1,
+  "verified_on": "2026-10-10",
+  "engine_version": "155.0.8059.39",
+  "scope": "Desktop UA and Client Hints profiles; does not install vendor engines or features.",
+  "profiles": [
+    {
+      "brand": "edge",
+      "product_version": "155.0.4283.45",
+      "chromium_version": "155.0.8059.40",
+      "hint_brand": "Microsoft Edge",
+      "ua_suffix": " Edg/",
+      "ua_version": "155.0.0.0",
+      "sources": [
+        "https://edgeupdates.microsoft.com/api/products?view=enterprise"
+      ],
+      "measurement": "Stock Edge 155 Windows and Linux owned-origin captures"
+    },
+    {
+      "brand": "opera",
+      "product_version": "137.0.6036.39",
+      "chromium_version": "153.0.8010.55",
+      "hint_brand": "Opera",
+      "ua_suffix": " OPR/",
+      "ua_version": "137.0.0.0",
+      "sources": [
+        "https://blogs.opera.com/desktop/changelog-for-137/",
+        "https://blogs.opera.com/desktop/2026/10/opera-137-stable/"
+      ],
+      "measurement": "Stock Opera 137 Linux owned-origin capture"
+    },
+    {
+      "brand": "vivaldi",
+      "product_version": "8.2.4133.84",
+      "chromium_version": "152.0.7977.160",
+      "hint_brand": "Google Chrome",
+      "ua_suffix": "",
+      "ua_version": "",
+      "sources": [
+        "https://vivaldi.com/blog/minor-update-nine-8-2/",
+        "https://vivaldi.com/blog/desktop/",
+        "https://help.vivaldi.com/developers/web/vivaldi-user-agent-and-client-hints-user-agent/"
+      ],
+      "measurement": "Stock Vivaldi 8.2 Linux owned-origin capture; default branding only, partner-site exceptions excluded"
+    }
+  ]
+}

{capiumbrowser-1.2.0 → capiumbrowser-1.2.1}/capiumbrowser/browser.py

@@ -117,13 +117,13 @@ def _has_screen_override(extra):
 
 
 def _build_args(seed, platform, stealth_args, timezone, locale, extension_paths, extra,
-                headless=False):
+                headless=False, mobile_device=None, browser_brand=None):
     args = []
     if stealth_args:
-        args += config.get_default_stealth_args(seed, platform)
+        args += config.get_default_stealth_args(seed, platform, mobile_device=mobile_device, browser_brand=browser_brand)
         # Keep the engine's seeded screen. Use initial window bounds only when
         # the caller has not provided screen/window flags.
-        if headless and not _has_screen_override(extra):
+        if headless and platform not in ("android", "ios") and not _has_screen_override(extra):
             args += config.get_headless_default_args()
     if timezone:
         args.append("--timezone=%s" % timezone)          # capium in-binary tz spoof
@@ -209,10 +209,13 @@ def _wrap_close(obj, pw):
     return obj
 
 
-def _apply_viewport_defaults(browser, asynchronous=False):
+def _apply_viewport_defaults(browser, asynchronous=False, mobile_seed=None, mobile_device=None, mobile_platform="android"):
     """Match the other launch APIs: use the window unless the caller chooses a viewport."""
     def decorate(original):
         def options(kwargs):
+            if mobile_seed is not None:
+                from .mobile import context_options
+                return context_options(mobile_seed, kwargs, mobile_device, mobile_platform)
             if 'viewport' not in kwargs and 'no_viewport' not in kwargs:
                 kwargs = dict(kwargs, no_viewport=True)
             return kwargs
@@ -234,13 +237,29 @@ def _apply_viewport_defaults(browser, asynchronous=False):
     return browser
 
 
+def _require_mobile_engine(context, mobile_device=None, seed=0, platform="android"):
+    """Refuse incompatible binaries before a mobile case can visit a site."""
+    page = context.new_page()
+    try:
+        from .mobile import mobile_profile, engine_probe
+        expected = mobile_profile(seed, mobile_device, platform)
+        page.route("**/*", lambda route: route.fulfill(status=200, content_type="text/html", body="<!doctype html>"))
+        page.goto("https://capium-mobile-preview.invalid/", wait_until="domcontentloaded")
+        supported = page.evaluate(engine_probe(platform), expected)
+        if not supported:
+            raise ValueError("This binary does not support the requested mobile profile/device; use Capium 1.2.1 revision 2 or later")
+    finally:
+        page.close()
+
+
 def launch(seed=None, platform="windows", headless=False, proxy=None, geoip=None, args=None,
            stealth_args=True, timezone=None, locale=None, extension_paths=None, binary=None,
            license_key=None, license_server=None, license_through_proxy=False,
-           license_preflight=True, driver=None, **kwargs):
+           license_preflight=True, driver=None, mobile_device=None, browser_brand=None, **kwargs):
     """Launch a Capium Browser (non-persistent; Playwright manages a temp profile).
 
     seed/platform : identity. stealth_args=False drops the default fingerprint flags.
+    mobile_device : Android/iPhone catalog ID; requires the matching native release.
     proxy         : "dataimpulse" | "http://user:pass@host:port" | "socks5://host:port" | dict.
     geoip         : geo coherence, resolved inside the binary. None (default) = OFF: no lookup
                     runs, even with a proxy (a proxy alone no longer triggers it, so proxied
@@ -263,6 +282,10 @@ def launch(seed=None, platform="windows", headless=False, proxy=None, geoip=None
     kwargs        : forwarded to Playwright's chromium.launch (e.g. slow_mo=...).
     Returns a Browser whose .close() also stops Playwright.
     """
+    from .mobile import validate_launch
+    from . import desktop
+    desktop.validate_launch(browser_brand, platform, binary, args, stealth_args)
+    validate_launch(platform, binary, args, stealth_args, mobile_device)
     if license_preflight:
         _license.preflight(license_key, license_server)
     key, _ = _license.effective(license_key, license_server)
@@ -272,7 +295,7 @@ def launch(seed=None, platform="windows", headless=False, proxy=None, geoip=None
     display = os.environ.get("DISPLAY")
     proxy_kwargs, proxy_args = _proxy_and_geo_args(proxy, binpath, geoip, display)
     launch_args = proxy_args + _build_args(
-        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless)
+        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless, mobile_device, browser_brand)
     if license_through_proxy:
         launch_args.append("--license-through-proxy")
     env = _license.child_env(license_key, license_server)
@@ -304,7 +327,30 @@ def launch(seed=None, platform="windows", headless=False, proxy=None, geoip=None
         raise
     _clear_status_file(status_path)
     browser._capium_seed = seed
-    return _wrap_close(_apply_viewport_defaults(browser), pw)
+    browser._capium_mobile = platform in ("android", "ios") and stealth_args
+    browser = _wrap_close(_apply_viewport_defaults(
+        browser, mobile_seed=seed if browser._capium_mobile else None, mobile_device=mobile_device, mobile_platform=platform), pw)
+    if browser._capium_mobile:
+        try:
+            context = browser.new_context()
+            try:
+                _require_mobile_engine(context, mobile_device, seed, platform)
+            finally:
+                context.close()
+        except Exception:
+            browser.close()
+            raise
+    if desktop.normalize_brand(browser_brand) != "chrome":
+        try:
+            context = browser.new_context()
+            try:
+                desktop.require_engine(context, browser_brand)
+            finally:
+                context.close()
+        except Exception:
+            browser.close()
+            raise
+    return browser
 
 
 def launch_persistent_context(user_data_dir, seed=None, platform="windows", headless=False,
@@ -312,11 +358,15 @@ def launch_persistent_context(user_data_dir, seed=None, platform="windows", head
                               timezone=None, locale=None, extension_paths=None, binary=None,
                               license_key=None, license_server=None,
                               license_through_proxy=False,
-                              license_preflight=True, driver=None, **kwargs):
+                              license_preflight=True, driver=None, mobile_device=None, browser_brand=None, **kwargs):
     """Launch a persistent context (cookies/localStorage/state persist in user_data_dir).
 
     Same options as launch(); returns a BrowserContext whose .close() also stops Playwright.
     """
+    from .mobile import context_options, validate_launch
+    from . import desktop
+    desktop.validate_launch(browser_brand, platform, binary, args, stealth_args)
+    validate_launch(platform, binary, args, stealth_args, mobile_device)
     if license_preflight:
         _license.preflight(license_key, license_server)
     key, _ = _license.effective(license_key, license_server)
@@ -326,14 +376,16 @@ def launch_persistent_context(user_data_dir, seed=None, platform="windows", head
     display = os.environ.get("DISPLAY")
     proxy_kwargs, proxy_args = _proxy_and_geo_args(proxy, binpath, geoip, display)
     launch_args = proxy_args + _build_args(
-        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless)
+        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless, mobile_device, browser_brand)
     if license_through_proxy:
         launch_args.append("--license-through-proxy")
     env = _license.child_env(license_key, license_server)
     status_path = _new_status_file(env)
     # Default to the page filling the window (see launch_context) unless the caller
     # pinned a viewport themselves.
-    if "viewport" not in kwargs and "no_viewport" not in kwargs:
+    if platform in ("android", "ios") and stealth_args:
+        kwargs = context_options(seed, kwargs, mobile_device, platform)
+    elif "viewport" not in kwargs and "no_viewport" not in kwargs:
         kwargs["no_viewport"] = True
     # Strip Playwright's automation + forced-software-WebGL defaults;
     # the caller can override by passing ignore_default_args explicitly.
@@ -363,6 +415,22 @@ def launch_persistent_context(user_data_dir, seed=None, platform="windows", head
         raise
     _clear_status_file(status_path)
     ctx._capium_seed = seed
+    if desktop.normalize_brand(browser_brand) != "chrome":
+        ctx = _wrap_close(ctx, pw)
+        try:
+            desktop.require_engine(ctx, browser_brand)
+        except Exception:
+            ctx.close()
+            raise
+        return ctx
+    if platform in ("android", "ios") and stealth_args:
+        ctx = _wrap_close(ctx, pw)
+        try:
+            _require_mobile_engine(ctx, mobile_device, seed, platform)
+        except Exception:
+            ctx.close()
+            raise
+        return ctx
     # Headed persistent launches fit the window to the selected screen. Headless
     # keeps its startup bounds (800x600 by default) independent of the seeded screen;
     # callers can choose larger window bounds explicitly.
@@ -383,12 +451,13 @@ def launch_context(seed=None, platform="windows", headless=False, url=None,
     # no_viewport: let the page fill the real window (fit_window sizes the window to
     # the persona's screen). A fixed 1280x720 emulated viewport would leave the page
     # smaller than the window AND mismatch window.screen — an incoherent fingerprint.
-    context = browser.contexts[0] if browser.contexts else browser.new_context(no_viewport=True)
+    context = browser.contexts[0] if browser.contexts else browser.new_context(
+        **({} if getattr(browser, "_capium_mobile", False) else {"no_viewport": True}))
     if humanize:
         from . import human as _human
         _human.humanize(context, preset=human_preset)
     page = context.pages[0] if context.pages else context.new_page()
-    if not headless:
+    if not headless and not getattr(browser, "_capium_mobile", False):
         fit_window(browser, context, page)   # modest window <= spoofed screen
     if url:
         page.goto(url, wait_until="domcontentloaded", timeout=60000)

{capiumbrowser-1.2.0 → capiumbrowser-1.2.1}/capiumbrowser/browser_async.py

@@ -72,13 +72,17 @@ async def launch_async(seed=None, platform="windows", headless=False, proxy=None
                        args=None, stealth_args=True, timezone=None, locale=None,
                        extension_paths=None, binary=None, license_key=None,
                        license_server=None, license_through_proxy=False,
-                       license_preflight=True, driver=None, **kwargs):
+                       license_preflight=True, driver=None, mobile_device=None, browser_brand=None, **kwargs):
     """Async launch -> Browser (await browser.close() also stops Playwright).
 
     driver: "playwright" (default) or the installed "patchright" fork.
     CAPIUM_DRIVER=patchright also works. Evaluation-world defaults and API
     compatibility depend on the installed version. See capiumbrowser._driver.
     """
+    from .mobile import validate_launch
+    from . import desktop
+    desktop.validate_launch(browser_brand, platform, binary, args, stealth_args)
+    validate_launch(platform, binary, args, stealth_args, mobile_device)
     await _license_preflight_async(license_key, license_server, license_preflight)
     key, _ = _license.effective(license_key, license_server)
     binpath = _resolve_binary(binary, key)
@@ -87,7 +91,7 @@ async def launch_async(seed=None, platform="windows", headless=False, proxy=None
     display = os.environ.get("DISPLAY")
     proxy_kwargs, proxy_args = await _proxy_and_geo_args_async(proxy, binpath, geoip, display)
     launch_args = proxy_args + _build_args(
-        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless)
+        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless, mobile_device, browser_brand)
     if license_through_proxy:
         launch_args.append("--license-through-proxy")
     env = _license.child_env(license_key, license_server)
@@ -119,7 +123,44 @@ async def launch_async(seed=None, platform="windows", headless=False, proxy=None
         raise
     _clear_status_file(status_path)
     browser._capium_seed = seed
-    return _wrap_close_async(_apply_viewport_defaults(browser, asynchronous=True), pw)
+    browser._capium_mobile = platform in ("android", "ios") and stealth_args
+    browser = _wrap_close_async(_apply_viewport_defaults(browser, asynchronous=True,
+        mobile_seed=seed if browser._capium_mobile else None, mobile_device=mobile_device, mobile_platform=platform), pw)
+    if browser._capium_mobile:
+        try:
+            context = await browser.new_context()
+            try:
+                await _require_mobile_engine_async(context, mobile_device, seed, platform)
+            finally:
+                await context.close()
+        except Exception:
+            await browser.close()
+            raise
+    if desktop.normalize_brand(browser_brand) != "chrome":
+        try:
+            context = await browser.new_context()
+            try:
+                await desktop.require_engine_async(context, browser_brand)
+            finally:
+                await context.close()
+        except Exception:
+            await browser.close()
+            raise
+    return browser
+
+
+async def _require_mobile_engine_async(context, mobile_device=None, seed=0, platform="android"):
+    page = await context.new_page()
+    try:
+        from .mobile import mobile_profile, engine_probe
+        expected = mobile_profile(seed, mobile_device, platform)
+        await page.route("**/*", lambda route: route.fulfill(status=200, content_type="text/html", body="<!doctype html>"))
+        await page.goto("https://capium-mobile-preview.invalid/", wait_until="domcontentloaded")
+        supported = await page.evaluate(engine_probe(platform), expected)
+        if not supported:
+            raise ValueError("This binary does not support the requested mobile profile/device; use Capium 1.2.1 revision 2 or later")
+    finally:
+        await page.close()
 
 
 async def launch_persistent_context_async(user_data_dir, seed=None, platform="windows",
@@ -127,9 +168,13 @@ async def launch_persistent_context_async(user_data_dir, seed=None, platform="wi
                                           stealth_args=True, timezone=None, locale=None,
                                           extension_paths=None, binary=None, license_key=None,
                                           license_server=None, license_through_proxy=False,
-                                          license_preflight=True, driver=None,
+                                          license_preflight=True, driver=None, mobile_device=None, browser_brand=None,
                                           **kwargs):
     """Async persistent context -> BrowserContext."""
+    from .mobile import context_options, validate_launch
+    from . import desktop
+    desktop.validate_launch(browser_brand, platform, binary, args, stealth_args)
+    validate_launch(platform, binary, args, stealth_args, mobile_device)
     await _license_preflight_async(license_key, license_server, license_preflight)
     key, _ = _license.effective(license_key, license_server)
     binpath = _resolve_binary(binary, key)
@@ -138,12 +183,14 @@ async def launch_persistent_context_async(user_data_dir, seed=None, platform="wi
     display = os.environ.get("DISPLAY")
     proxy_kwargs, proxy_args = await _proxy_and_geo_args_async(proxy, binpath, geoip, display)
     launch_args = proxy_args + _build_args(
-        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless)
+        seed, platform, stealth_args, timezone, locale, extension_paths, args, headless, mobile_device, browser_brand)
     if license_through_proxy:
         launch_args.append("--license-through-proxy")
     env = _license.child_env(license_key, license_server)
     status_path = _new_status_file(env)
-    if "viewport" not in kwargs and "no_viewport" not in kwargs:
+    if platform in ("android", "ios") and stealth_args:
+        kwargs = context_options(seed, kwargs, mobile_device, platform)
+    elif "viewport" not in kwargs and "no_viewport" not in kwargs:
         kwargs["no_viewport"] = True
     # Strip Playwright's automation + forced-software-WebGL defaults;
     # the caller can override by passing ignore_default_args explicitly.
@@ -173,6 +220,22 @@ async def launch_persistent_context_async(user_data_dir, seed=None, platform="wi
         raise
     _clear_status_file(status_path)
     ctx._capium_seed = seed
+    if desktop.normalize_brand(browser_brand) != "chrome":
+        ctx = _wrap_close_async(ctx, pw)
+        try:
+            await desktop.require_engine_async(ctx, browser_brand)
+        except Exception:
+            await ctx.close()
+            raise
+        return ctx
+    if platform in ("android", "ios") and stealth_args:
+        ctx = _wrap_close_async(ctx, pw)
+        try:
+            await _require_mobile_engine_async(ctx, mobile_device, seed, platform)
+        except Exception:
+            await ctx.close()
+            raise
+        return ctx
     return _wrap_close_async(ctx, pw)
 
 
@@ -182,7 +245,8 @@ async def launch_context_async(seed=None, platform="windows", headless=False, ur
     browser = await launch_async(seed=seed, platform=platform, headless=headless, **kwargs)
     # no_viewport: page fills the real window (see browser.launch_context).
     context = (browser.contexts[0] if browser.contexts
-               else await browser.new_context(no_viewport=True))
+               else await browser.new_context(
+                   **({} if getattr(browser, "_capium_mobile", False) else {"no_viewport": True})))
     if humanize:
         from . import human as _human
         _human.humanize(context, preset=human_preset)