homeassistant-stubs 2025.1.2__py3-none-any.whl → 2025.1.4__py3-none-any.whl

homeassistant-stubs/components/camera/__init__.pyi

@@ -29,7 +29,7 @@ from homeassistant.helpers.template import Template as Template
 from homeassistant.helpers.typing import ConfigType as ConfigType, VolDictType as VolDictType
 from homeassistant.loader import bind_hass as bind_hass
 from propcache import cached_property, under_cached_property
-from typing import Any, Final
+from typing import Any, Final, final
 from webrtc_models import RTCIceCandidateInit as RTCIceCandidateInit
 
 _LOGGER: Incomplete
@@ -76,11 +76,15 @@ class Image:
 class CameraCapabilities:
     frontend_stream_types: set[StreamType]
 
+@bind_hass
 async def async_request_stream(hass: HomeAssistant, entity_id: str, fmt: str) -> str: ...
 async def _async_get_image(camera: Camera, timeout: int = 10, width: int | None = None, height: int | None = None) -> Image: ...
+@bind_hass
 async def async_get_image(hass: HomeAssistant, entity_id: str, timeout: int = 10, width: int | None = None, height: int | None = None) -> Image: ...
 async def _async_get_stream_image(camera: Camera, width: int | None = None, height: int | None = None, wait_for_next_keyframe: bool = False) -> bytes | None: ...
+@bind_hass
 async def async_get_stream_source(hass: HomeAssistant, entity_id: str) -> str | None: ...
+@bind_hass
 async def async_get_mjpeg_stream(hass: HomeAssistant, request: web.Request, entity_id: str) -> web.StreamResponse | None: ...
 async def async_get_still_stream(request: web.Request, image_cb: Callable[[], Awaitable[bytes | None]], content_type: str, interval: float) -> web.StreamResponse: ...
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
@@ -149,6 +153,7 @@ class Camera(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     async def handle_async_still_stream(self, request: web.Request, interval: float) -> web.StreamResponse: ...
     async def handle_async_mjpeg_stream(self, request: web.Request) -> web.StreamResponse | None: ...
     @property
+    @final
     def state(self) -> str: ...
     @cached_property
     def is_on(self) -> bool: ...
@@ -160,19 +165,28 @@ class Camera(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     async def async_enable_motion_detection(self) -> None: ...
     def disable_motion_detection(self) -> None: ...
     async def async_disable_motion_detection(self) -> None: ...
+    @final
     @property
     def state_attributes(self) -> dict[str, str | None]: ...
+    @callback
     def async_update_token(self) -> None: ...
     async def async_internal_added_to_hass(self) -> None: ...
     async def async_refresh_providers(self, *, write_state: bool = True) -> None: ...
     async def _async_get_supported_webrtc_provider[_T](self, fn: Callable[[HomeAssistant, Camera], Coroutine[None, None, _T | None]]) -> _T | None: ...
+    @callback
     def _async_get_webrtc_client_configuration(self) -> WebRTCClientConfiguration: ...
+    @final
+    @callback
     def async_get_webrtc_client_configuration(self) -> WebRTCClientConfiguration: ...
     async def async_on_webrtc_candidate(self, session_id: str, candidate: RTCIceCandidateInit) -> None: ...
+    @callback
     def close_webrtc_session(self, session_id: str) -> None: ...
+    @callback
     def _invalidate_camera_capabilities_cache(self) -> None: ...
+    @final
     @under_cached_property
     def camera_capabilities(self) -> CameraCapabilities: ...
+    @callback
     def async_write_ha_state(self) -> None: ...
 
 class CameraView(HomeAssistantView):
@@ -192,9 +206,13 @@ class CameraMjpegStream(CameraView):
     name: str
     async def handle(self, request: web.Request, camera: Camera) -> web.StreamResponse: ...
 
+@websocket_api.async_response
 async def ws_camera_capabilities(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def ws_camera_stream(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def websocket_get_prefs(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def websocket_update_prefs(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
 
 class _TemplateCameraEntity:

homeassistant-stubs/components/camera/significant_change.pyi

@@ -1,4 +1,5 @@
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
 
+@callback
 def async_check_significant_change(hass: HomeAssistant, old_state: str, old_attrs: dict, new_state: str, new_attrs: dict, **kwargs: Any) -> bool | None: ...

homeassistant-stubs/components/camera/webrtc.pyi

@@ -6,6 +6,7 @@ from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Awaitable, Callable, Iterable
 from dataclasses import dataclass, field
+from functools import cache
 from homeassistant.components import websocket_api as websocket_api
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
@@ -24,6 +25,7 @@ _WEBRTC: str
 @dataclass(frozen=True)
 class WebRTCMessage:
     @classmethod
+    @cache
     def _get_type(cls) -> str: ...
     def as_dict(self) -> dict[str, Any]: ...
 
@@ -57,29 +59,37 @@ class CameraWebRTCProvider(ABC, metaclass=abc.ABCMeta):
     @property
     @abstractmethod
     def domain(self) -> str: ...
+    @callback
     @abstractmethod
     def async_is_supported(self, stream_source: str) -> bool: ...
     @abstractmethod
     async def async_handle_async_webrtc_offer(self, camera: Camera, offer_sdp: str, session_id: str, send_message: WebRTCSendMessage) -> None: ...
     @abstractmethod
     async def async_on_webrtc_candidate(self, session_id: str, candidate: RTCIceCandidateInit) -> None: ...
+    @callback
     def async_close_session(self, session_id: str) -> None: ...
 
 class CameraWebRTCLegacyProvider(Protocol):
     async def async_is_supported(self, stream_source: str) -> bool: ...
     async def async_handle_web_rtc_offer(self, camera: Camera, offer_sdp: str) -> str | None: ...
 
+@callback
 def async_register_webrtc_provider(hass: HomeAssistant, provider: CameraWebRTCProvider) -> Callable[[], None]: ...
 async def _async_refresh_providers(hass: HomeAssistant) -> None: ...
 type WsCommandWithCamera = Callable[[websocket_api.ActiveConnection, dict[str, Any], Camera], Awaitable[None]]
 def require_webrtc_support(error_code: str) -> Callable[[WsCommandWithCamera], websocket_api.AsyncWebSocketCommandHandler]: ...
+@websocket_api.async_response
 async def ws_webrtc_offer(connection: websocket_api.ActiveConnection, msg: dict[str, Any], camera: Camera) -> None: ...
+@websocket_api.async_response
 async def ws_get_client_config(connection: websocket_api.ActiveConnection, msg: dict[str, Any], camera: Camera) -> None: ...
 def _parse_webrtc_candidate_init(value: Any) -> RTCIceCandidateInit: ...
+@websocket_api.async_response
 async def ws_candidate(connection: websocket_api.ActiveConnection, msg: dict[str, Any], camera: Camera) -> None: ...
+@callback
 def async_register_ws(hass: HomeAssistant) -> None: ...
 async def async_get_supported_provider(hass: HomeAssistant, camera: Camera) -> CameraWebRTCProvider | None: ...
 async def async_get_supported_legacy_provider(hass: HomeAssistant, camera: Camera) -> CameraWebRTCLegacyProvider | None: ...
+@callback
 def async_register_ice_servers(hass: HomeAssistant, get_ice_server_fn: Callable[[], Iterable[RTCIceServer]]) -> Callable[[], None]: ...
 
 _RTSP_PREFIXES: Incomplete
@@ -92,4 +102,5 @@ class _CameraRtspToWebRTCProvider(CameraWebRTCLegacyProvider):
     async def async_handle_web_rtc_offer(self, camera: Camera, offer_sdp: str) -> str | None: ...
 
 def async_register_rtsp_to_web_rtc_provider(hass: HomeAssistant, domain: str, provider: RtspToWebRtcProviderType) -> Callable[[], None]: ...
+@callback
 def _async_check_conflicting_legacy_provider(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/canary/config_flow.pyi

@@ -12,6 +12,7 @@ def validate_input(hass: HomeAssistant, data: dict[str, Any]) -> bool: ...
 class CanaryConfigFlow(ConfigFlow, domain=DOMAIN):
     VERSION: int
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> OptionsFlow: ...
     async def async_step_import(self, import_data: dict[str, Any]) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/climate/__init__.pyi

@@ -11,7 +11,7 @@ from homeassistant.loader import async_get_issue_tracker as async_get_issue_trac
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.unit_conversion import TemperatureConverter as TemperatureConverter
 from propcache import cached_property
-from typing import Any, Literal
+from typing import Any, Literal, final
 
 _LOGGER: Incomplete
 DATA_COMPONENT: HassKey[EntityComponent[ClimateEntity]]
@@ -66,12 +66,14 @@ class ClimateEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     _attr_temperature_unit: str
     __climate_reported_legacy_aux: bool
     def _report_legacy_aux(self) -> None: ...
+    @final
     @property
     def state(self) -> str | None: ...
     @property
     def precision(self) -> float: ...
     @property
     def capability_attributes(self) -> dict[str, Any] | None: ...
+    @final
     @property
     def state_attributes(self) -> dict[str, Any]: ...
     @cached_property
@@ -114,23 +116,30 @@ class ClimateEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     def swing_horizontal_mode(self) -> str | None: ...
     @cached_property
     def swing_horizontal_modes(self) -> list[str] | None: ...
+    @final
+    @callback
     def _valid_mode_or_raise(self, mode_type: Literal['preset', 'horizontal_swing', 'swing', 'fan', 'hvac'], mode: str | HVACMode, modes: list[str] | list[HVACMode] | None) -> None: ...
     def set_temperature(self, **kwargs: Any) -> None: ...
     async def async_set_temperature(self, **kwargs: Any) -> None: ...
     def set_humidity(self, humidity: int) -> None: ...
     async def async_set_humidity(self, humidity: int) -> None: ...
+    @final
     async def async_handle_set_fan_mode_service(self, fan_mode: str) -> None: ...
     def set_fan_mode(self, fan_mode: str) -> None: ...
     async def async_set_fan_mode(self, fan_mode: str) -> None: ...
+    @final
     async def async_handle_set_hvac_mode_service(self, hvac_mode: HVACMode) -> None: ...
     def set_hvac_mode(self, hvac_mode: HVACMode) -> None: ...
     async def async_set_hvac_mode(self, hvac_mode: HVACMode) -> None: ...
+    @final
     async def async_handle_set_swing_mode_service(self, swing_mode: str) -> None: ...
     def set_swing_mode(self, swing_mode: str) -> None: ...
     async def async_set_swing_mode(self, swing_mode: str) -> None: ...
+    @final
     async def async_handle_set_swing_horizontal_mode_service(self, swing_horizontal_mode: str) -> None: ...
     def set_swing_horizontal_mode(self, swing_horizontal_mode: str) -> None: ...
     async def async_set_swing_horizontal_mode(self, swing_horizontal_mode: str) -> None: ...
+    @final
     async def async_handle_set_preset_mode_service(self, preset_mode: str) -> None: ...
     def set_preset_mode(self, preset_mode: str) -> None: ...
     async def async_set_preset_mode(self, preset_mode: str) -> None: ...

homeassistant-stubs/components/climate/device_condition.pyi

@@ -16,5 +16,6 @@ PRESET_MODE_CONDITION: Incomplete
 CONDITION_SCHEMA: Incomplete
 
 async def async_get_conditions(hass: HomeAssistant, device_id: str) -> list[dict[str, str]]: ...
+@callback
 def async_condition_from_config(hass: HomeAssistant, config: ConfigType) -> condition.ConditionCheckerType: ...
 async def async_get_condition_capabilities(hass: HomeAssistant, config: ConfigType) -> dict[str, vol.Schema]: ...

homeassistant-stubs/components/climate/significant_change.pyi

@@ -6,4 +6,5 @@ from typing import Any
 
 SIGNIFICANT_ATTRIBUTES: set[str]
 
+@callback
 def async_check_significant_change(hass: HomeAssistant, old_state: str, old_attrs: dict, new_state: str, new_attrs: dict, **kwargs: Any) -> bool | None: ...

homeassistant-stubs/components/cloud/__init__.pyi

@@ -43,16 +43,29 @@ class CloudConnectionState(Enum):
     CLOUD_CONNECTED = 'cloud_connected'
     CLOUD_DISCONNECTED = 'cloud_disconnected'
 
+@bind_hass
+@callback
 def async_is_logged_in(hass: HomeAssistant) -> bool: ...
+@bind_hass
+@callback
 def async_is_connected(hass: HomeAssistant) -> bool: ...
+@callback
 def async_listen_connection_change(hass: HomeAssistant, target: Callable[[CloudConnectionState], Awaitable[None] | None]) -> Callable[[], None]: ...
+@bind_hass
+@callback
 def async_active_subscription(hass: HomeAssistant) -> bool: ...
 async def async_get_or_create_cloudhook(hass: HomeAssistant, webhook_id: str) -> str: ...
+@bind_hass
 async def async_create_cloudhook(hass: HomeAssistant, webhook_id: str) -> str: ...
+@bind_hass
 async def async_delete_cloudhook(hass: HomeAssistant, webhook_id: str) -> None: ...
+@bind_hass
+@callback
 def async_remote_ui_url(hass: HomeAssistant) -> str: ...
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
+@callback
 def _remote_handle_prefs_updated(cloud: Cloud[CloudClient]) -> None: ...
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+@callback
 def _setup_services(hass: HomeAssistant, prefs: CloudPreferences) -> None: ...

homeassistant-stubs/components/cloud/account_link.pyi

@@ -10,6 +10,7 @@ _LOGGER: Incomplete
 CURRENT_VERSION: Incomplete
 CURRENT_PLAIN_VERSION: Incomplete
 
+@callback
 def async_setup(hass: HomeAssistant) -> None: ...
 async def async_provide_implementation(hass: HomeAssistant, domain: str) -> list[config_entry_oauth2_flow.AbstractOAuth2Implementation]: ...
 async def _get_services(hass: HomeAssistant) -> list[dict[str, Any]]: ...

homeassistant-stubs/components/cloud/alexa_config.pyi

@@ -54,14 +54,18 @@ class CloudAlexaConfig(alexa_config.AbstractConfig):
     def locale(self) -> str: ...
     @property
     def entity_config(self) -> dict[str, Any]: ...
+    @callback
     def user_identifier(self) -> str: ...
     def _migrate_alexa_entity_settings_v1(self) -> None: ...
     async def async_initialize(self) -> None: ...
     def _should_expose_legacy(self, entity_id: str) -> bool: ...
+    @callback
     def should_expose(self, entity_id: str) -> bool: ...
+    @callback
     def async_invalidate_access_token(self) -> None: ...
     async def async_get_access_token(self) -> str | None: ...
     async def _async_prefs_updated(self, prefs: CloudPreferences) -> None: ...
+    @callback
     def _async_exposed_entities_updated(self) -> None: ...
     async def _sync_prefs(self, _now: datetime) -> None: ...
     async def async_sync_entities(self) -> bool: ...

homeassistant-stubs/components/cloud/backup.pyi

@@ -17,6 +17,7 @@ _RETRY_SECONDS_MAX: int
 
 async def _b64md5(stream: AsyncIterator[bytes]) -> str: ...
 async def async_get_backup_agents(hass: HomeAssistant, **kwargs: Any) -> list[BackupAgent]: ...
+@callback
 def async_register_backup_agents_listener(hass: HomeAssistant, *, listener: Callable[[], None], **kwargs: Any) -> Callable[[], None]: ...
 
 class ChunkAsyncStreamIterator:
@@ -32,6 +33,7 @@ class CloudBackupAgent(BackupAgent):
     _cloud: Incomplete
     _hass: Incomplete
     def __init__(self, hass: HomeAssistant, cloud: Cloud[CloudClient]) -> None: ...
+    @callback
     def _get_backup_filename(self) -> str: ...
     async def async_download_backup(self, backup_id: str, **kwargs: Any) -> AsyncIterator[bytes]: ...
     async def _async_do_upload_backup(self, *, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], filename: str, base64md5hash: str, metadata: dict[str, Any], size: int) -> None: ...

homeassistant-stubs/components/cloud/client.pyi

@@ -59,7 +59,9 @@ class CloudClient(Interface):
     async def cloud_started(self) -> None: ...
     async def cloud_stopped(self) -> None: ...
     async def logout_cleanups(self) -> None: ...
+    @callback
     def user_message(self, identifier: str, title: str, message: str) -> None: ...
+    @callback
     def dispatcher_message(self, identifier: str, data: Any = None) -> None: ...
     async def async_cloud_connect_update(self, connect: bool) -> None: ...
     async def async_cloud_connection_info(self, payload: dict[str, Any]) -> dict[str, Any]: ...

homeassistant-stubs/components/cloud/google_config.pyi

@@ -61,8 +61,12 @@ class CloudGoogleConfig(AbstractConfig):
     async def _async_request_sync_devices(self, agent_user_id: str) -> HTTPStatus | int: ...
     async def async_connect_agent_user(self, agent_user_id: str) -> None: ...
     async def async_disconnect_agent_user(self, agent_user_id: str) -> None: ...
+    @callback
     def async_get_agent_users(self) -> tuple: ...
     async def _async_prefs_updated(self, prefs: CloudPreferences) -> None: ...
+    @callback
     def _async_exposed_entities_updated(self) -> None: ...
+    @callback
     def _handle_entity_registry_updated(self, event: Event[er.EventEntityRegistryUpdatedData]) -> None: ...
+    @callback
     def _handle_device_registry_updated(self, event: Event[dr.EventDeviceRegistryUpdatedData]) -> None: ...

homeassistant-stubs/components/cloud/http_api.pyi

@@ -26,6 +26,7 @@ _CLOUD_ERRORS: dict[type[Exception], tuple[HTTPStatus, str]]
 
 class MFAExpiredOrNotStarted(auth.CloudError): ...
 
+@callback
 def async_setup(hass: HomeAssistant) -> None: ...
 def _handle_cloud_errors[_HassViewT: HomeAssistantView, **_P](handler: Callable[Concatenate[_HassViewT, web.Request, _P], Awaitable[web.Response]]) -> Callable[Concatenate[_HassViewT, web.Request, _P], Coroutine[Any, Any, web.Response]]: ...
 def _ws_handle_cloud_errors(handler: Callable[[HomeAssistant, websocket_api.ActiveConnection, dict[str, Any]], Coroutine[None, None, None]]) -> Callable[[HomeAssistant, websocket_api.ActiveConnection, dict[str, Any]], Coroutine[None, None, None]]: ...
@@ -34,6 +35,8 @@ def _process_cloud_exception(exc: Exception, where: str) -> tuple[HTTPStatus, st
 class GoogleActionsSyncView(HomeAssistantView):
     url: str
     name: str
+    @require_admin
+    @_handle_cloud_errors
     async def post(self, request: web.Request) -> web.Response: ...
 
 class CloudLoginView(HomeAssistantView):
@@ -41,44 +44,99 @@ class CloudLoginView(HomeAssistantView):
     _mfa_tokens_set_time: float
     url: str
     name: str
+    @require_admin
+    @_handle_cloud_errors
     async def post(self, request: web.Request, data: dict[str, Any]) -> web.Response: ...
 
 class CloudLogoutView(HomeAssistantView):
     url: str
     name: str
+    @require_admin
+    @_handle_cloud_errors
     async def post(self, request: web.Request) -> web.Response: ...
 
 class CloudRegisterView(HomeAssistantView):
     url: str
     name: str
+    @require_admin
+    @_handle_cloud_errors
     async def post(self, request: web.Request, data: dict[str, Any]) -> web.Response: ...
 
 class CloudResendConfirmView(HomeAssistantView):
     url: str
     name: str
+    @require_admin
+    @_handle_cloud_errors
     async def post(self, request: web.Request, data: dict[str, Any]) -> web.Response: ...
 
 class CloudForgotPasswordView(HomeAssistantView):
     url: str
     name: str
+    @require_admin
+    @_handle_cloud_errors
     async def post(self, request: web.Request, data: dict[str, Any]) -> web.Response: ...
 
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_cloud_remove_data(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def websocket_cloud_status(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 def _require_cloud_login(handler: Callable[[HomeAssistant, websocket_api.ActiveConnection, dict[str, Any]], None]) -> Callable[[HomeAssistant, websocket_api.ActiveConnection, dict[str, Any]], None]: ...
+@_require_cloud_login
+@websocket_api.async_response
 async def websocket_subscription(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 def validate_language_voice(value: tuple[str, str]) -> tuple[str, str]: ...
+@_require_cloud_login
+@websocket_api.async_response
 async def websocket_update_prefs(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def websocket_hook_create(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def websocket_hook_delete(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def _account_data(hass: HomeAssistant, cloud: Cloud[CloudClient]) -> dict[str, Any]: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def websocket_remote_connect(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def websocket_remote_disconnect(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def google_assistant_get(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def google_assistant_list(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def google_assistant_update(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def alexa_get(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
+@_ws_handle_cloud_errors
 async def alexa_list(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@_require_cloud_login
+@websocket_api.async_response
 async def alexa_sync(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def thingtalk_convert(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 def tts_info(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/cloud/prefs.pyi

@@ -27,6 +27,7 @@ class CloudPreferences:
     last_updated: set[str]
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_initialize(self) -> None: ...
+    @callback
     def async_listen_updates(self, listener: Callable[[CloudPreferences], Coroutine[Any, Any, None]]) -> Callable[[], None]: ...
     async def async_update(self, *, alexa_enabled: bool | UndefinedType = ..., alexa_report_state: bool | UndefinedType = ..., alexa_settings_version: int | UndefinedType = ..., cloud_ice_servers_enabled: bool | UndefinedType = ..., cloud_user: str | UndefinedType = ..., cloudhooks: dict[str, dict[str, str | bool]] | UndefinedType = ..., google_connected: bool | UndefinedType = ..., google_enabled: bool | UndefinedType = ..., google_report_state: bool | UndefinedType = ..., google_secure_devices_pin: str | None | UndefinedType = ..., google_settings_version: int | UndefinedType = ..., remote_allow_remote_enable: bool | UndefinedType = ..., remote_domain: str | None | UndefinedType = ..., remote_enabled: bool | UndefinedType = ..., tts_default_voice: tuple[str, str] | UndefinedType = ...) -> None: ...
     async def async_set_username(self, username: str | None) -> bool: ...
@@ -75,5 +76,6 @@ class CloudPreferences:
     async def get_cloud_user(self) -> str: ...
     async def _load_cloud_user(self) -> User | None: ...
     async def _save_prefs(self, prefs: dict[str, Any]) -> None: ...
+    @callback
     @staticmethod
     def _empty_config(username: str) -> dict[str, Any]: ...

homeassistant-stubs/components/cloud/repairs.pyi

@@ -9,6 +9,7 @@ from typing import Any
 BACKOFF_TIME: int
 MAX_RETRIES: int
 
+@callback
 def async_manage_legacy_subscription_issue(hass: HomeAssistant, subscription_info: dict[str, Any]) -> None: ...
 
 class LegacySubscriptionRepairFlow(RepairsFlow):

homeassistant-stubs/components/cloud/system_health.pyi

@@ -3,5 +3,6 @@ from homeassistant.components import system_health as system_health
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
 
+@callback
 def async_register(hass: HomeAssistant, register: system_health.SystemHealthRegistration) -> None: ...
 async def system_health_info(hass: HomeAssistant) -> dict[str, Any]: ...

homeassistant-stubs/components/cloud/tts.pyi

@@ -43,6 +43,7 @@ class CloudTTSEntity(TextToSpeechEntity):
     @property
     def supported_options(self) -> list[str]: ...
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def async_get_supported_voices(self, language: str) -> list[Voice] | None: ...
     async def async_get_tts_audio(self, message: str, language: str, options: dict[str, Any]) -> TtsAudioType: ...
 
@@ -57,10 +58,13 @@ class CloudProvider(Provider):
     def supported_languages(self) -> list[str]: ...
     @property
     def supported_options(self) -> list[str]: ...
+    @callback
     def async_get_supported_voices(self, language: str) -> list[Voice] | None: ...
     @property
     def default_options(self) -> dict[str, Any]: ...
     async def async_get_tts_audio(self, message: str, language: str, options: dict[str, Any]) -> TtsAudioType: ...
 
+@callback
 def handle_deprecated_gender(hass: HomeAssistant, gender: Gender | str | None) -> Gender | None: ...
+@callback
 def handle_deprecated_voice(hass: HomeAssistant, original_voice: str | None) -> str | None: ...

homeassistant-stubs/components/config/area_registry.pyi

@@ -2,8 +2,16 @@ from homeassistant.components import websocket_api as websocket_api
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
 
+@callback
 def async_setup(hass: HomeAssistant) -> bool: ...
+@callback
 def websocket_list_areas(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@callback
 def websocket_create_area(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@callback
 def websocket_delete_area(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@callback
 def websocket_update_area(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/config/auth.pyi

@@ -9,9 +9,18 @@ SCHEMA_WS_LIST: Incomplete
 WS_TYPE_DELETE: str
 SCHEMA_WS_DELETE: Incomplete
 
+@callback
 def async_setup(hass: HomeAssistant) -> bool: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_list(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_delete(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_create(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_update(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 def _user_info(user: User) -> dict[str, Any]: ...

homeassistant-stubs/components/config/auth_provider_homeassistant.pyi

@@ -3,9 +3,19 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.exceptions import Unauthorized as Unauthorized
 from typing import Any
 
+@callback
 def async_setup(hass: HomeAssistant) -> bool: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_create(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_delete(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def websocket_change_password(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_admin_change_password(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_admin_change_username(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/config/automation.pyi

@@ -6,6 +6,7 @@ from homeassistant.const import CONF_ID as CONF_ID, SERVICE_RELOAD as SERVICE_RE
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
 
+@callback
 def async_setup(hass: HomeAssistant) -> bool: ...
 
 class EditAutomationConfigView(EditIdBasedConfigView):

homeassistant-stubs/components/config/category_registry.pyi

@@ -4,9 +4,18 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.helpers import category_registry as cr
 from typing import Any
 
+@callback
 def async_setup(hass: HomeAssistant) -> bool: ...
+@callback
 def websocket_list_categories(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@callback
 def websocket_create_category(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@callback
 def websocket_delete_category(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@callback
 def websocket_update_category(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+@callback
 def _entry_dict(entry: cr.CategoryEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/config/config_entries.pyi

@@ -13,6 +13,7 @@ from homeassistant.helpers.json import json_fragment as json_fragment
 from homeassistant.loader import Integration as Integration, IntegrationNotFound as IntegrationNotFound, async_get_config_flows as async_get_config_flows, async_get_integrations as async_get_integrations, async_get_loaded_integration as async_get_loaded_integration
 from typing import Any, NoReturn
 
+@callback
 def async_setup(hass: HomeAssistant) -> bool: ...
 
 class ConfigManagerEntryIndexView(HomeAssistantView):
@@ -64,13 +65,24 @@ class OptionManagerFlowResourceView(FlowManagerResourceView[config_entries.Optio
     async def get(self, request: web.Request, /, flow_id: str) -> web.Response: ...
     async def post(self, request: web.Request, flow_id: str) -> web.Response: ...
 
+@websocket_api.require_admin
 def config_entries_progress(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 def send_entry_not_found(connection: websocket_api.ActiveConnection, msg_id: int) -> None: ...
 def get_entry(hass: HomeAssistant, connection: websocket_api.ActiveConnection, entry_id: str, msg_id: int) -> config_entries.ConfigEntry | None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def config_entry_get_single(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def config_entry_update(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def config_entry_disable(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def ignore_config_flow(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def config_entries_get(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def config_entries_subscribe(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def _async_matching_config_entries_json_fragments(hass: HomeAssistant, type_filter: list[str] | None, domain: str | None) -> list[json_fragment]: ...

homeassistant-stubs/components/config/core.pyi

@@ -8,12 +8,18 @@ from homeassistant.helpers.aiohttp_client import async_get_clientsession as asyn
 from homeassistant.util import location as location, unit_system as unit_system
 from typing import Any
 
+@callback
 def async_setup(hass: HomeAssistant) -> bool: ...
 
 class CheckConfigView(HomeAssistantView):
     url: str
     name: str
+    @require_admin
     async def post(self, request: web.Request) -> web.Response: ...
 
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_update_config(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_detect_config(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...