eero-api 4.1.2__tar.gz → 4.2.0__tar.gz

{eero_api-4.1.2/src/eero_api.egg-info → eero_api-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eero-api
-Version: 4.1.2
+Version: 4.2.0
 Summary: Modern async Python client for Eero network management
 Author: Eero API Contributors
 Maintainer: Eero API Contributors

{eero_api-4.1.2 → eero_api-4.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eero-api"
-version = "4.1.2"
+version = "4.2.0"
 description = "Modern async Python client for Eero network management"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -121,7 +121,7 @@ asyncio_mode = "auto"
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.1.2"
+version = "4.2.0"
 version_files = [
     "pyproject.toml:project.version",
     "src/eero/__init__.py:__version__",

{eero_api-4.1.2 → eero_api-4.2.0}/src/eero/__init__.py

@@ -27,4 +27,4 @@ __all__ = [
     "redact_sensitive",
 ]
 
-__version__ = "4.1.2"
+__version__ = "4.2.0"

{eero_api-4.1.2 → eero_api-4.2.0}/src/eero/api/__init__.py

@@ -10,6 +10,7 @@ from .auth import AuthAPI
 from .backup import BackupAPI
 from .blacklist import BlacklistAPI
 from .burst_reporters import BurstReportersAPI
+from .data_usage import DataUsageAPI
 from .devices import DevicesAPI
 from .diagnostics import DiagnosticsAPI
 from .dns import DnsAPI
@@ -72,6 +73,7 @@ class EeroAPI:
         self.forwards = ForwardsAPI(self.auth)
         self.transfer = TransferAPI(self.auth)
         self.burst_reporters = BurstReportersAPI(self.auth)
+        self.data_usage = DataUsageAPI(self.auth)
         self.ac_compat = ACCompatAPI(self.auth)
         self.ouicheck = OUICheckAPI(self.auth)
         self.password = PasswordAPI(self.auth)

eero_api-4.2.0/src/eero/api/data_usage.py

@@ -0,0 +1,64 @@
+"""Data Usage API for Eero.
+
+IMPORTANT: This module returns RAW responses from the Eero Cloud API.
+All data extraction, field mapping, and transformation must be done by downstream clients.
+"""
+
+import logging
+from typing import Any, Dict, Optional
+
+from ..const import API_ENDPOINT
+from ..exceptions import EeroAuthenticationException
+from .auth import AuthAPI
+from .base import AuthenticatedAPI
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class DataUsageAPI(AuthenticatedAPI):
+    """Data Usage API for Eero.
+
+    All methods return raw, unmodified JSON responses from the Eero Cloud API.
+    Response format: {"meta": {...}, "data": {...}}
+    """
+
+    def __init__(self, auth_api: AuthAPI) -> None:
+        """Initialize the DataUsageAPI.
+
+        Args:
+            auth_api: Authentication API instance
+        """
+        super().__init__(auth_api, API_ENDPOINT)
+
+    async def get_data_usage(
+        self, network_id: str, payload: Dict[str, Any], resource: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """Get data usage statistics - returns raw Eero API response.
+
+        Args:
+            network_id: ID of the network to get usage from
+            payload: JSON payload to send with the GET request.
+                Note: The eero cloud API expects a JSON body on this GET
+                request (e.g., timezone, period filters), which is uncommon
+                but matches the behavior used by Home Assistant's eero
+                integration.
+            resource: Optional resource type (e.g., "devices", "eeros")
+
+        Returns:
+            Raw API response: {"meta": {...}, "data": {...}}
+
+        Raises:
+            EeroAuthenticationException: If not authenticated
+            EeroAPIException: If the API returns an error
+        """
+        auth_token = await self._auth_api.get_auth_token()
+        if not auth_token:
+            raise EeroAuthenticationException("Not authenticated")
+
+        path = f"networks/{network_id}/data_usage"
+        if resource:
+            path = f"{path}/{resource}"
+
+        _LOGGER.debug("Getting data usage for network %s (resource=%s)", network_id, resource)
+
+        return await self.get(path, auth_token=auth_token, json=payload)

{eero_api-4.1.2 → eero_api-4.2.0}/src/eero/api/sqm.py

@@ -125,6 +125,9 @@ class SqmAPI(AuthenticatedAPI):
             download_mbps,
         )
 
+        # TODO: Verify whether bandwidth payload should be flattened (e.g. {"sqm": true,
+        # "upload_bandwidth": N}) rather than nested ({"sqm": {...}}) — pending live API
+        # verification against the /settings endpoint.
         return await self.put(
             f"networks/{network_id}/settings",
             auth_token=auth_token,
@@ -167,6 +170,9 @@ class SqmAPI(AuthenticatedAPI):
 
         _LOGGER.debug("Configuring SQM for network %s: %s", network_id, sqm_payload)
 
+        # TODO: Verify whether combined enable+bandwidth payload should be flattened rather
+        # than nested ({"sqm": {...}}) — pending live API verification against the /settings
+        # endpoint.
         return await self.put(
             f"networks/{network_id}/settings",
             auth_token=auth_token,
@@ -188,6 +194,9 @@ class SqmAPI(AuthenticatedAPI):
 
         _LOGGER.debug("Setting SQM to auto mode for network %s", network_id)
 
+        # TODO: Verify whether auto-mode payload should be flattened (e.g. {"sqm": true,
+        # "mode": "auto"}) rather than nested ({"sqm": {"enabled": true, "mode": "auto"}}) —
+        # pending live API verification against the /settings endpoint.
         return await self.put(
             f"networks/{network_id}/settings",
             auth_token=auth_token,

{eero_api-4.1.2 → eero_api-4.2.0}/src/eero/client.py

@@ -671,6 +671,7 @@ class EeroClient:
         response = await self._api.profiles.rename_profile(network_id, profile_id, name)
 
         self._invalidate_profile_cache(network_id, profile_id)
+        self._invalidate_profiles_list_cache(network_id)
 
         return response
 
@@ -693,6 +694,7 @@ class EeroClient:
         response = await self._api.profiles.delete_profile(network_id, profile_id)
 
         self._invalidate_profile_cache(network_id, profile_id)
+        self._invalidate_profiles_list_cache(network_id)
 
         return response
 
@@ -824,6 +826,16 @@ class EeroClient:
         network_id = await self._ensure_network_id(network_id, auto_discover=False)
         return await self._api.transfer.get_transfer_stats(network_id, device_id)
 
+    async def get_data_usage(
+        self,
+        network_id: Optional[str] = None,
+        payload: Optional[Dict[str, Any]] = None,
+        resource: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Get data usage statistics - returns raw Eero API response."""
+        network_id = await self._ensure_network_id(network_id, auto_discover=False)
+        return await self._api.data_usage.get_data_usage(network_id, payload or {}, resource)
+
     async def get_burst_reporters(self, network_id: Optional[str] = None) -> Dict[str, Any]:
         """Get burst reporters - returns raw Eero API response."""
         network_id = await self._ensure_network_id(network_id, auto_discover=False)

{eero_api-4.1.2 → eero_api-4.2.0/src/eero_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eero-api
-Version: 4.1.2
+Version: 4.2.0
 Summary: Modern async Python client for Eero network management
 Author: Eero API Contributors
 Maintainer: Eero API Contributors

{eero_api-4.1.2 → eero_api-4.2.0}/src/eero_api.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ src/eero/api/backup.py
 src/eero/api/base.py
 src/eero/api/blacklist.py
 src/eero/api/burst_reporters.py
+src/eero/api/data_usage.py
 src/eero/api/devices.py
 src/eero/api/diagnostics.py
 src/eero/api/dns.py