pi-lean-portal 0.1.0

package/backends/chromium-py/bridge.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""
+Chromium-Py Bridge — Python-side parity reference for stealth backends.
+
+Thin subclass of :class:`PlaywrightBridge` that drives Chromium via
+Playwright Python. All shared logic lives in
+:mod:`pi_browser_bridge.playwright_base`.
+
+Usage
+-----
+Run the bridge from the command line — it reads JSON-RPC 2.0 requests
+from stdin and writes responses to stdout::
+
+    python backends/chromium-py/bridge.py
+
+The ``PythonPluginAdapter`` (TypeScript) spawns this process and
+communicates via stdin/stdout.
+
+Requires
+--------
+* Python >= 3.10
+* ``playwright`` >= 1.50  (``pip install playwright``)
+* Playwright Chromium browsers installed (``playwright install chromium``)
+"""
+
+import sys
+
+from pi_browser_bridge.playwright_base import PlaywrightBridge, check_playwright_or_exit
+
+
+class ChromiumPyBridge(PlaywrightBridge):
+    """Concrete bridge that drives Chromium via Playwright Python.
+
+    Thin subclass — engine-specific settings only.
+    """
+
+    _plugin_name: str = "chromium-py"
+    _user_agent: str = (
+        "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 "
+        "(KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+    )
+    _install_hint: str = (
+        "Chromium browser not installed. "
+        "Run: playwright install chromium (inside backends/python-base/.venv)"
+    )
+
+    def _launch_browser(self):
+        """Launch a Chromium browser instance."""
+        return self._pw.chromium.launch(
+            headless=True,
+            args=[
+                "--no-sandbox",
+                "--disable-setuid-sandbox",
+                "--disable-dev-shm-usage",
+                "--disable-gpu",
+            ],
+        )
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  Entry point
+# ═══════════════════════════════════════════════════════════════════════
+
+if __name__ == "__main__":
+    check_playwright_or_exit("chromium")
+    bridge = ChromiumPyBridge()
+    bridge.run()

package/backends/firefox/index.ts

@@ -0,0 +1,60 @@
+/**
+ * Firefox Plugin — Native Node backend using Playwright Firefox.
+ *
+ * Thin subclass of PlaywrightPluginBase. All shared logic lives in
+ * backends/playwright-base/playwright-plugin.ts.
+ *
+ * Uses probe-then-cache UA capture at first launch, with a hardcoded
+ * fallback Firefox UA string. Launch args are empty — Firefox does
+ * not accept Chromium sandbox flags.
+ */
+
+import { firefox } from "playwright";
+import type { Browser } from "playwright";
+import { PlaywrightPluginBase } from "../playwright-base/playwright-plugin.js";
+import {
+	DEFAULT_CAPABILITIES,
+	type PluginCapabilities,
+} from "../../core/plugin-api.js";
+
+// ─── Capabilities ──────────────────────────────────────────────────
+
+const FIREFOX_CAPABILITIES: PluginCapabilities = {
+	...DEFAULT_CAPABILITIES,
+	engine: "firefox",
+};
+
+// ─── Hardcoded Firefox UA fallback (used when dynamic capture fails) ─
+
+const FIREFOX_UA_FALLBACK =
+	"Mozilla/5.0 (X11; Linux x86_64; rv:135.0) Gecko/20100101 Firefox/135.0";
+
+// ─── FirefoxPlugin ────────────────────────────────────────────────
+
+export class FirefoxPlugin extends PlaywrightPluginBase {
+	readonly name = "firefox";
+	readonly capabilities = FIREFOX_CAPABILITIES;
+
+	/** Opt into probe-then-cache UA capture at lazy browser init. */
+	protected readonly captureUserAgent: boolean = true;
+
+	/**
+	 * Hardcoded fallback Firefox user-agent.
+	 * Used only if the dynamic UA capture (about:blank probe) fails.
+	 */
+	protected get userAgent(): string {
+		return FIREFOX_UA_FALLBACK;
+	}
+
+	protected async launchBrowser(): Promise<Browser> {
+		return firefox.launch({
+			headless: true,
+		});
+	}
+
+	protected get installHint(): string {
+		return "Browser not installed. Run: npx playwright install chromium firefox";
+	}
+}
+
+export default FirefoxPlugin;

package/backends/firefox-py/bridge.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+"""
+Firefox-Py Bridge — Python-side parity reference for Firefox-based stealth backends.
+
+Thin subclass of :class:`PlaywrightBridge` that drives Firefox via
+Playwright Python. All shared logic lives in
+:mod:`pi_browser_bridge.playwright_base`.
+
+Disabled by default — users enable explicitly via ``settings.json``
+when parity-testing against the Node ``firefox`` backend.
+
+Usage
+-----
+Run the bridge from the command line — it reads JSON-RPC 2.0 requests
+from stdin and writes responses to stdout::
+
+    python backends/firefox-py/bridge.py
+
+The ``PythonPluginAdapter`` (TypeScript) spawns this process and
+communicates via stdin/stdout.
+
+Requires
+--------
+* Python >= 3.10
+* ``playwright`` >= 1.50  (``pip install playwright``)
+* Playwright Firefox browsers installed (``playwright install firefox``)
+"""
+
+import sys
+
+from pi_browser_bridge.playwright_base import PlaywrightBridge, check_playwright_or_exit
+
+
+class FirefoxPyBridge(PlaywrightBridge):
+    """Concrete bridge that drives Firefox via Playwright Python.
+
+    Thin subclass — engine-specific settings only.
+    """
+
+    _plugin_name: str = "firefox-py"
+    _user_agent: str = (
+        "Mozilla/5.0 (X11; Linux x86_64; rv:135.0) Gecko/20100101 Firefox/135.0"
+    )
+    _capture_user_agent: bool = True
+    _install_hint: str = (
+        "Firefox browser not installed. "
+        "Run: playwright install firefox (inside backends/python-base/.venv)"
+    )
+
+    def _launch_browser(self):
+        """Launch a Firefox browser instance."""
+        return self._pw.firefox.launch(
+            headless=True,
+        )
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  Entry point
+# ═══════════════════════════════════════════════════════════════════════
+
+if __name__ == "__main__":
+    check_playwright_or_exit("firefox")
+    bridge = FirefoxPyBridge()
+    bridge.run()