scalebrowser 0.2.0__tar.gz → 0.3.0__tar.gz

{scalebrowser-0.2.0 → scalebrowser-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scalebrowser
-Version: 0.2.0
+Version: 0.3.0
 Summary: Official Python SDK for the Scalebrowser daemon — typed REST client + direct-CDP driver (nodriver-style).
 Project-URL: Homepage, https://scalebrowser.net
 Project-URL: Documentation, https://scalebrowser.net

{scalebrowser-0.2.0 → scalebrowser-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "scalebrowser"
-version = "0.2.0"
+version = "0.3.0"
 description = "Official Python SDK for the Scalebrowser daemon — typed REST client + direct-CDP driver (nodriver-style)."
 readme = "README.md"
 requires-python = ">=3.10"

{scalebrowser-0.2.0 → scalebrowser-0.3.0}/src/scalebrowser/_version.py

@@ -1,3 +1,3 @@
 """Single source of the package version."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{scalebrowser-0.2.0 → scalebrowser-0.3.0}/src/scalebrowser/client.py

@@ -755,8 +755,9 @@ class AsyncScalebrowserClient:
         """Licence state for display. The launch gate stays the authority on starts.
 
         A daemon predating the route answers 404, and that is not an error worth
-        raising: it means "self-hosted, no control plane", which is exactly what
-        ``licensed=False`` says. Same tolerance as :meth:`get_metrics`.
+        raising -- but it is read pessimistically (DEC-014): the defaults of
+        :class:`Account` say nothing is connected and nothing may start. Same
+        tolerance as :meth:`get_metrics`.
         """
         try:
             data = await self._t.get("/v1/account")

{scalebrowser-0.2.0 → scalebrowser-0.3.0}/src/scalebrowser/models_control.py

@@ -99,8 +99,13 @@ class Account(_ReadModel):
     profile the launch gate refuses is worse than no light.
     """
 
-    #: ``False`` on a self-hosted build with no control plane.
+    #: Whether an entitlement snapshot has arrived. Also ``False`` in the seconds
+    #: between signing in and the first refresh, so it never answers "is this
+    #: machine connected to an account" -- ``signed_in`` does.
     licensed: bool = False
+    #: Whether an account is connected to this machine. One without an account
+    #: starts no browser (DEC-014).
+    signed_in: bool = False
     plan: Optional[str] = None
     status: Optional[str] = None
     #: Browsers the subscription may run AT ONCE. Replaced the profile allowance
@@ -113,7 +118,9 @@ class Account(_ReadModel):
     features: list[str] = []
     #: Unix seconds; when the cached entitlement stops being valid.
     expires_at: Optional[int] = None
-    permits_launch: bool = True
+    #: Defaults to False: a daemon too old to send the field is a daemon that
+    #: cannot be shown to permit anything.
+    permits_launch: bool = False
 
 
 class HealthStatus(_ReadModel):

{scalebrowser-0.2.0 → scalebrowser-0.3.0}/tests/test_coverage.py

@@ -242,16 +242,18 @@ async def test_cookie_values_need_the_vault_password() -> None:
     assert b"vault_password" in captured[0].content
 
 
-async def test_account_reads_a_404_as_self_hosted() -> None:
+async def test_account_reads_a_404_pessimistically() -> None:
     def handler(request: httpx.Request) -> httpx.Response:
         return httpx.Response(404, json={"code": 4001, "message": "no route"})
 
-    # A daemon with no control plane has no such route. Raising here would make
-    # every self-hosted install look broken.
+    # A daemon too old to serve the route is not an error worth raising, but it is
+    # also not a daemon that can be SHOWN to permit anything: since DEC-014 an
+    # unanswered account reads as "nothing connected, nothing permitted".
     sb = make_async_client(handler)
     account = await sb.get_account()
     assert account.licensed is False
-    assert account.permits_launch is True
+    assert account.signed_in is False
+    assert account.permits_launch is False
 
 
 async def test_health_and_account() -> None: