refactor: reorganize client transport and extension internals

- Split client, native, remote, serve, markdown, and SDK internals into focused packages with direct imports. - Move local and remote transport framing/protocol helpers behind clearer module boundaries. - Break up the extension injected DOM logic into a separate content dispatch bundle and dedicated content modules. - Add explicit client handling for passive remote discovery without noisy PQ warnings. - Keep behavior covered with updated unit, integration, and extension tests.
2026-06-13 23:31:24 +02:00
parent fd5447cbb9
commit 076914e5b7
88 changed files with 7491 additions and 5228 deletions
@@ -1,66 +1,85 @@
 """Storage and cookies namespaces: ``b.storage.*``, ``b.cookies.*``."""
 from __future__ import annotations

-from browser_cli.sdk.base import Namespace
+from browser_cli.sdk.base import Namespace, sdk_command

 class StorageNS(Namespace):
-    """Read and write localStorage / sessionStorage."""
+  """Read and write localStorage / sessionStorage."""

-    def get(
-        self,
-        key: str | None = None,
-        *,
-        type: str = "local",
-        tab_id: int | None = None,
-    ) -> str | dict | None:
-        """Get a localStorage/sessionStorage entry (or all entries if key omitted)."""
-        return self._c._cmd("storage.get", {"key": key, "type": type, "tabId": tab_id})
+  @sdk_command("storage.get", lambda self, key=None, *, type="local", tab_id=None: {
+    "key": key,
+    "type": type,
+    "tabId": tab_id,
+  })
+  def get(
+    self,
+    key: str | None = None,
+    *,
+    type: str = "local",
+    tab_id: int | None = None,
+  ) -> str | dict | None:
+    """Get a localStorage/sessionStorage entry (or all entries if key omitted)."""

-    def set(
-        self,
-        key: str,
-        value: str,
-        *,
-        type: str = "local",
-        tab_id: int | None = None,
-    ) -> None:
-        """Set a localStorage/sessionStorage entry."""
-        self._c._cmd("storage.set", {"key": key, "value": value, "type": type, "tabId": tab_id})
+  @sdk_command("storage.set", lambda self, key, value, *, type="local", tab_id=None: {
+    "key": key,
+    "value": value,
+    "type": type,
+    "tabId": tab_id,
+  })
+  def set(
+    self,
+    key: str,
+    value: str,
+    *,
+    type: str = "local",
+    tab_id: int | None = None,
+  ) -> None:
+    """Set a localStorage/sessionStorage entry."""

 class CookiesNS(Namespace):
-    """List, get, and set cookies."""
+  """List, get, and set cookies."""

-    def list(
-        self,
-        *,
-        url: str | None = None,
-        domain: str | None = None,
-        name: str | None = None,
-    ) -> list[dict]:
-        """List cookies, optionally filtered by url, domain, or name."""
-        return self._c._cmd("cookies.list", {"url": url, "domain": domain, "name": name}) or []
+  @sdk_command("cookies.list", lambda self, *, url=None, domain=None, name=None: {
+    "url": url,
+    "domain": domain,
+    "name": name,
+  }, default=[])
+  def list(
+    self,
+    *,
+    url: str | None = None,
+    domain: str | None = None,
+    name: str | None = None,
+  ) -> list[dict]:
+    """List cookies, optionally filtered by url, domain, or name."""

-    def get(self, url: str, name: str) -> dict | None:
-        """Get a single cookie by url and name."""
-        return self._c._cmd("cookies.get", {"url": url, "name": name})
+  @sdk_command("cookies.get", lambda self, url, name: {"url": url, "name": name})
+  def get(self, url: str, name: str) -> dict | None:
+    """Get a single cookie by url and name."""

-    def set(
-        self,
-        url: str,
-        name: str,
-        value: str,
-        *,
-        domain: str | None = None,
-        path: str | None = None,
-        secure: bool | None = None,
-        http_only: bool | None = None,
-        expiration_date: float | None = None,
-        same_site: str | None = None,
-    ) -> dict:
-        """Set a cookie. Returns the created cookie dict."""
-        return self._c._cmd("cookies.set", {
-            "url": url, "name": name, "value": value,
-            "domain": domain, "path": path,
-            "secure": secure, "httpOnly": http_only,
-            "expirationDate": expiration_date, "sameSite": same_site,
-        })
+  @sdk_command("cookies.set", lambda self, url, name, value, *, domain=None, path=None, secure=None,
+         http_only=None, expiration_date=None, same_site=None: {
+    "url": url,
+    "name": name,
+    "value": value,
+    "domain": domain,
+    "path": path,
+    "secure": secure,
+    "httpOnly": http_only,
+    "expirationDate": expiration_date,
+    "sameSite": same_site,
+  })
+  def set(
+    self,
+    url: str,
+    name: str,
+    value: str,
+    *,
+    domain: str | None = None,
+    path: str | None = None,
+    secure: bool | None = None,
+    http_only: bool | None = None,
+    expiration_date: float | None = None,
+    same_site: str | None = None,
+  ) -> dict:
+    """Set a cookie. Returns the created cookie dict."""