Fixing Zones

Author: vzucher

src/brightdata/client.py

@@ -225,10 +225,12 @@ async def _ensure_zones(self) -> None:
         if self._zone_manager is None:
             self._zone_manager = ZoneManager(self.engine)
 
+        # Don't pass browser_zone to auto-creation because browser zones
+        # require additional configuration and cannot be auto-created
         await self._zone_manager.ensure_required_zones(
             web_unlocker_zone=self.web_unlocker_zone,
             serp_zone=self.serp_zone,
-            browser_zone=self.browser_zone
+            browser_zone=None  # Never auto-create browser zones
         )
         self._zones_ensured = True
 
@@ -341,17 +343,23 @@ async def test_connection(self) -> bool:
             self._is_connected = False
             return False
 
-    async def get_account_info(self) -> AccountInfo:
+    async def get_account_info(self, refresh: bool = False) -> AccountInfo:
         """
         Get account information including usage, limits, and quotas.
         
+        Note: This method caches the result by default. For fresh zone data,
+        use list_zones() instead, or pass refresh=True.
+        
         Retrieves:
         - Account status
         - Active zones
         - Usage statistics
         - Credit balance
         - Rate limits
         
+        Args:
+            refresh: If True, bypass cache and fetch fresh data (default: False)
+        
         Returns:
             Dictionary with account information
         
@@ -360,11 +368,18 @@ async def get_account_info(self) -> AccountInfo:
             APIError: If API request fails
         
         Example:
+            >>> # Cached version (fast)
             >>> info = await client.get_account_info()
             >>> print(f"Active zones: {len(info['zones'])}")
-            >>> print(f"Credit balance: ${info['balance']}")
+            
+            >>> # Fresh data (use this after creating/deleting zones)
+            >>> info = await client.get_account_info(refresh=True)
+            >>> print(f"Active zones: {len(info['zones'])}")
+            
+            >>> # Or better: use list_zones() for current zone list
+            >>> zones = await client.list_zones()
         """
-        if self._account_info is not None:
+        if self._account_info is not None and not refresh:
             return self._account_info
 
         try:
@@ -447,9 +462,14 @@ def _run_async_with_cleanup(self, coro):
             finally:
                 loop.close()
 
-    def get_account_info_sync(self) -> AccountInfo:
-        """Synchronous version of get_account_info()."""
-        return self._run_async_with_cleanup(self.get_account_info())
+    def get_account_info_sync(self, refresh: bool = False) -> AccountInfo:
+        """
+        Synchronous version of get_account_info().
+        
+        Args:
+            refresh: If True, bypass cache and fetch fresh data (default: False)
+        """
+        return self._run_async_with_cleanup(self.get_account_info(refresh=refresh))
 
     def test_connection_sync(self) -> bool:
         """Synchronous version of test_connection()."""

src/brightdata/core/zone_manager.py

@@ -47,14 +47,14 @@ async def ensure_required_zones(
         """
         Check if required zones exist and create them if they don't.
 
-        Note: Browser zones are NOT auto-created because they require additional
-        configuration parameters (like "start" value) that vary by use case.
-        Only unblocker and SERP zones are auto-created.
+        Important: Only unblocker and SERP zones can be auto-created.
+        Browser zones require additional configuration parameters (like "start" value)
+        and must be created manually in the Bright Data dashboard.
 
         Args:
-            web_unlocker_zone: Web unlocker zone name
-            serp_zone: SERP zone name (optional)
-            browser_zone: Browser zone name (optional, but NOT auto-created)
+            web_unlocker_zone: Web unlocker zone name (will be created if missing)
+            serp_zone: SERP zone name (optional, will be created if missing)
+            browser_zone: Browser zone name (NOT auto-created, pass None to skip)
 
         Raises:
             ZoneError: If zone creation or validation fails
@@ -79,15 +79,9 @@ async def ensure_required_zones(
                 zones_to_create.append((serp_zone, 'serp'))
                 logger.info(f"Need to create SERP zone: {serp_zone}")
 
-            # Browser zones are NOT auto-created because they require additional
-            # configuration (like "start" parameter) that we cannot provide automatically
-            if browser_zone and browser_zone not in zone_names:
-                logger.warning(
-                    f"Browser zone '{browser_zone}' does not exist. "
-                    f"Browser zones cannot be auto-created because they require "
-                    f"additional configuration parameters. Please create this zone "
-                    f"manually in the Bright Data dashboard."
-                )
+            # Browser zones are intentionally NOT checked here
+            # They require additional configuration (like "start" parameter)
+            # and must be created manually in the Bright Data dashboard
 
             if not zones_to_create:
                 logger.info("All required zones already exist")