no-mistakes(review): Warn on deprecated alias use, document raw param and public parser

Author: Bre77

docs/teslemetry.md

@@ -559,6 +559,13 @@ an unrecognized response shape raises
 never mistaken for "no authorized clients". The raw response is still
 available on `raw` for anything not modeled.
 
+`find_authorized_clients(raw=True)` skips the typed parse and returns the
+exact response `list_authorized_clients()` would, matching the call shape of
+a local gateway path that also wants to opt out of typing. The parsing itself
+lives in the module-level `tesla_fleet_api.teslemetry.energysite.parse_authorized_clients`
+function, which other callers (e.g. a local/LAN client using the same
+envelope shape) can reuse directly to get the same `AuthorizedClients` result.
+
 `remove_authorized_client(public_key)` accepts raw DER bytes or an already
 base64-encoded key string. Removal requires no physical presence proof, so any
 paired key can revoke every other key, including the owner's.

tesla_fleet_api/teslemetry/energysite.py

@@ -5,6 +5,7 @@
 import re
 import socket
 import struct
+import warnings
 from collections.abc import Awaitable, Callable
 from dataclasses import dataclass
 from typing import Any, Literal, overload, cast
@@ -207,8 +208,16 @@ def parse_authorized_clients(payload: Any) -> AuthorizedClients:
     return AuthorizedClients(clients=clients, raw=payload)
 
 
-# Deprecated alias, kept for one release.
-_parse_authorized_clients = parse_authorized_clients
+def _parse_authorized_clients(  # pyright: ignore[reportUnusedFunction]
+    payload: Any,
+) -> AuthorizedClients:
+    """Deprecated alias for :func:`parse_authorized_clients`, kept for one release."""
+    warnings.warn(
+        "_parse_authorized_clients is deprecated; use parse_authorized_clients instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return parse_authorized_clients(payload)
 
 
 _GATEWAY_INTERFACES = ("eth", "wifi")