API reference
=============

Autogenerated module documentation is produced by ``sphinx-apidoc`` on each build.
Start with the modules index, then drill into packages.

.. toctree::
   :maxdepth: 2

   All modules <../api/modules>

Core entry points
-----------------

These modules cover most integration work:

* :mod:`aioafero.v1` — ``AferoBridgeV1`` and controller registration
* :mod:`aioafero.v1.auth` — login, tokens, OTP
* :mod:`aioafero.device` — raw ``AferoDevice`` parsing and device typing
* :mod:`aioafero.errors` — exception hierarchy
* :mod:`aioafero.types` — ``TemperatureUnit``, ``EventType``

Controllers and models
----------------------

* :mod:`aioafero.v1.controllers` — device-type controllers (package)
* :mod:`aioafero.v1.models` — state models and feature types (package)

Utilities
---------

* :mod:`aioafero.anonomyize_data` — redact device payloads for bug reports
* :mod:`aioafero.util` — shared helpers

.. note::

   ``ClimateController`` in ``aioafero.v1.controllers.climate`` is a base class for
   thermostats and portable ACs; it is not registered directly on the bridge.
