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

homeassistant-stubs/components/matter/helpers.pyi

@@ -15,8 +15,11 @@ class MatterEntryData:
     adapter: MatterAdapter
     listen_task: asyncio.Task
 
+@callback
 def get_matter(hass: HomeAssistant) -> MatterAdapter: ...
 def get_operational_instance_id(server_info: ServerInfoMessage, node: MatterNode) -> str: ...
 def get_device_id(server_info: ServerInfoMessage, endpoint: MatterEndpoint) -> str: ...
+@callback
 def node_from_ha_device_id(hass: HomeAssistant, ha_device_id: str) -> MatterNode | None: ...
+@callback
 def get_node_from_device_entry(hass: HomeAssistant, device: dr.DeviceEntry) -> MatterNode | None: ...

homeassistant-stubs/components/matter/light.pyi

@@ -44,6 +44,7 @@ class MatterLight(MatterEntity, LightEntity):
     _attr_color_mode: Incomplete
     _attr_hs_color: Incomplete
     _attr_xy_color: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
     def _check_transition_blocklist(self) -> None: ...
 

homeassistant-stubs/components/matter/lock.pyi

@@ -31,9 +31,12 @@ class MatterLock(MatterEntity, LockEntity):
     async def async_open(self, **kwargs: Any) -> None: ...
     _attr_is_locked: bool
     _attr_is_open: bool
+    @callback
     def _update_from_device(self) -> None: ...
+    @callback
     def _reset_optimistic_state(self, write_state: bool = True) -> None: ...
     _attr_supported_features: Incomplete
+    @callback
     def _calculate_features(self) -> None: ...
 
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/number.pyi

@@ -18,6 +18,7 @@ class MatterNumber(MatterEntity, NumberEntity):
     entity_description: MatterNumberEntityDescription
     async def async_set_native_value(self, value: float) -> None: ...
     _attr_native_value: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
 
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/select.pyi

@@ -21,6 +21,7 @@ class MatterSelectEntity(MatterEntity, SelectEntity):
     entity_description: MatterSelectEntityDescription
     async def async_select_option(self, option: str) -> None: ...
     _attr_current_option: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
 
 class MatterModeSelectEntity(MatterSelectEntity):
@@ -28,6 +29,7 @@ class MatterModeSelectEntity(MatterSelectEntity):
     _attr_options: Incomplete
     _attr_current_option: Incomplete
     _attr_name: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
 
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/sensor.pyi

@@ -23,12 +23,14 @@ class MatterSensorEntityDescription(SensorEntityDescription, MatterEntityDescrip
 class MatterSensor(MatterEntity, SensorEntity):
     entity_description: MatterSensorEntityDescription
     _attr_native_value: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
 
 class MatterOperationalStateSensor(MatterSensor):
     states_map: dict[int, str]
     _attr_options: Incomplete
     _attr_native_value: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
 
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/switch.pyi

@@ -16,6 +16,7 @@ class MatterSwitch(MatterEntity, SwitchEntity):
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...
     _attr_is_on: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
 
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/update.pyi

@@ -36,6 +36,7 @@ class MatterUpdate(MatterEntity, UpdateEntity):
     _attr_installed_version: Incomplete
     _attr_in_progress: bool
     _attr_update_percentage: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
     _attr_latest_version: Incomplete
     _attr_release_url: Incomplete

homeassistant-stubs/components/matter/vacuum.pyi

@@ -40,8 +40,10 @@ class MatterVacuum(MatterEntity, StateVacuumEntity):
     async def _send_device_command(self, command: clusters.ClusterCommand) -> None: ...
     _attr_battery_level: Incomplete
     _attr_activity: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
     _attr_supported_features: Incomplete
+    @callback
     def _calculate_features(self) -> None: ...
 
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/valve.pyi

@@ -26,9 +26,11 @@ class MatterValve(MatterEntity, ValveEntity):
     _attr_is_closing: bool
     _attr_is_closed: bool
     _attr_current_valve_position: Incomplete
+    @callback
     def _update_from_device(self) -> None: ...
     _attr_supported_features: Incomplete
     _attr_reports_position: bool
+    @callback
     def _calculate_features(self) -> None: ...
 
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/media_player/__init__.pyi

@@ -10,6 +10,7 @@ from aiohttp import web
 from aiohttp.typedefs import LooseHeaders as LooseHeaders
 from collections.abc import Callable as Callable
 from enum import StrEnum
+from functools import lru_cache
 from homeassistant.components import websocket_api as websocket_api
 from homeassistant.components.http import HomeAssistantView as HomeAssistantView, KEY_AUTHENTICATED as KEY_AUTHENTICATED
 from homeassistant.components.websocket_api import ERR_NOT_SUPPORTED as ERR_NOT_SUPPORTED, ERR_UNKNOWN_ERROR as ERR_UNKNOWN_ERROR
@@ -25,7 +26,7 @@ from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.hass_dict import HassKey as HassKey
 from propcache import cached_property
-from typing import Any, Final, Required, TypedDict
+from typing import Any, Final, Required, TypedDict, final
 
 _LOGGER: Incomplete
 DATA_COMPONENT: HassKey[EntityComponent[MediaPlayerEntity]]
@@ -68,6 +69,7 @@ class _ImageCache(TypedDict):
 
 _ENTITY_IMAGE_CACHE: Incomplete
 
+@bind_hass
 def is_on(hass: HomeAssistant, entity_id: str | None = None) -> bool: ...
 def _rename_keys(**keys: Any) -> Callable[[dict[str, Any]], dict[str, Any]]: ...
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
@@ -80,6 +82,7 @@ class MediaPlayerEntityDescription(EntityDescription, frozen_or_thawed=True):
 
 CACHED_PROPERTIES_WITH_ATTR_: Incomplete
 
+@lru_cache
 def _url_hash(url: str) -> str: ...
 
 class MediaPlayerEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
@@ -223,32 +226,46 @@ class MediaPlayerEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     async def async_set_shuffle(self, shuffle: bool) -> None: ...
     def set_repeat(self, repeat: RepeatMode) -> None: ...
     async def async_set_repeat(self, repeat: RepeatMode) -> None: ...
+    @final
     @property
     def support_play(self) -> bool: ...
+    @final
     @property
     def support_pause(self) -> bool: ...
+    @final
     @property
     def support_stop(self) -> bool: ...
+    @final
     @property
     def support_seek(self) -> bool: ...
+    @final
     @property
     def support_volume_set(self) -> bool: ...
+    @final
     @property
     def support_volume_mute(self) -> bool: ...
+    @final
     @property
     def support_previous_track(self) -> bool: ...
+    @final
     @property
     def support_next_track(self) -> bool: ...
+    @final
     @property
     def support_play_media(self) -> bool: ...
+    @final
     @property
     def support_select_source(self) -> bool: ...
+    @final
     @property
     def support_select_sound_mode(self) -> bool: ...
+    @final
     @property
     def support_clear_playlist(self) -> bool: ...
+    @final
     @property
     def support_shuffle_set(self) -> bool: ...
+    @final
     @property
     def support_grouping(self) -> bool: ...
     async def async_toggle(self) -> None: ...
@@ -261,6 +278,7 @@ class MediaPlayerEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     def media_image_local(self) -> str | None: ...
     @property
     def capability_attributes(self) -> dict[str, Any]: ...
+    @final
     @property
     def state_attributes(self) -> dict[str, Any]: ...
     async def async_browse_media(self, media_content_type: MediaType | str | None = None, media_content_id: str | None = None) -> BrowseMedia: ...
@@ -281,6 +299,7 @@ class MediaPlayerImageView(HomeAssistantView):
     def __init__(self, component: EntityComponent[MediaPlayerEntity]) -> None: ...
     async def get(self, request: web.Request, entity_id: str, media_content_type: MediaType | str | None = None, media_content_id: str | None = None) -> web.Response: ...
 
+@websocket_api.async_response
 async def websocket_browse_media(hass: HomeAssistant, connection: websocket_api.connection.ActiveConnection, msg: dict[str, Any]) -> None: ...
 
 _FETCH_TIMEOUT: Incomplete

homeassistant-stubs/components/media_player/browse_media.pyi

@@ -9,6 +9,7 @@ from typing import Any
 
 PATHS_WITHOUT_AUTH: Incomplete
 
+@callback
 def async_process_play_media_url(hass: HomeAssistant, media_content_id: str, *, allow_relative_url: bool = False, for_supervisor_network: bool = False) -> str: ...
 
 class BrowseMedia:

homeassistant-stubs/components/media_player/device_condition.pyi

@@ -10,4 +10,5 @@ CONDITION_TYPES: 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: ...

homeassistant-stubs/components/media_player/significant_change.pyi

@@ -6,4 +6,5 @@ from typing import Any
 INSIGNIFICANT_ATTRIBUTES: set[str]
 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/media_source/__init__.pyi

@@ -2,9 +2,11 @@ from .const import DOMAIN as DOMAIN, MEDIA_CLASS_MAP as MEDIA_CLASS_MAP, MEDIA_M
 from .error import MediaSourceError as MediaSourceError, Unresolvable as Unresolvable
 from .models import BrowseMediaSource as BrowseMediaSource, MediaSource as MediaSource, MediaSourceItem as MediaSourceItem, PlayMedia as PlayMedia
 from collections.abc import Callable
+from homeassistant.components import websocket_api
 from homeassistant.components.media_player import BrowseMedia
-from homeassistant.core import HomeAssistant
+from homeassistant.core import HomeAssistant, callback
 from homeassistant.helpers.typing import UndefinedType
+from homeassistant.loader import bind_hass
 from typing import Protocol
 
 __all__ = ['DOMAIN', 'is_media_source_id', 'generate_media_source_id', 'async_browse_media', 'async_resolve_media', 'BrowseMediaSource', 'PlayMedia', 'MediaSourceItem', 'Unresolvable', 'MediaSource', 'MediaSourceError', 'MEDIA_CLASS_MAP', 'MEDIA_MIME_TYPES']
@@ -14,5 +16,7 @@ class MediaSourceProtocol(Protocol):
 
 def is_media_source_id(media_content_id: str) -> bool: ...
 def generate_media_source_id(domain: str, identifier: str) -> str: ...
+@bind_hass
 async def async_browse_media(hass: HomeAssistant, media_content_id: str | None, *, content_filter: Callable[[BrowseMedia], bool] | None = None) -> BrowseMediaSource: ...
+@bind_hass
 async def async_resolve_media(hass: HomeAssistant, media_content_id: str, target_media_player: str | None | UndefinedType = ...) -> PlayMedia: ...

homeassistant-stubs/components/media_source/local_source.pyi

@@ -15,13 +15,16 @@ from typing import Any
 MAX_UPLOAD_SIZE: Incomplete
 LOGGER: Incomplete
 
+@callback
 def async_setup(hass: HomeAssistant) -> None: ...
 
 class LocalSource(MediaSource):
     name: str
     hass: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_full_path(self, source_dir_id: str, location: str) -> Path: ...
+    @callback
     def async_parse_identifier(self, item: MediaSourceItem) -> tuple[str, str]: ...
     async def async_resolve_media(self, item: MediaSourceItem) -> PlayMedia: ...
     async def async_browse_media(self, item: MediaSourceItem) -> BrowseMediaSource: ...
@@ -43,7 +46,10 @@ class UploadMediaView(http.HomeAssistantView):
     source: Incomplete
     schema: Incomplete
     def __init__(self, hass: HomeAssistant, source: LocalSource) -> None: ...
+    @require_admin
     async def post(self, request: web.Request) -> web.Response: ...
     def _move_file(self, target_dir: Path, uploaded_file: FileField) -> None: ...
 
+@websocket_api.require_admin
+@websocket_api.async_response
 async def websocket_remove_media(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/media_source/models.pyi

@@ -24,6 +24,7 @@ class MediaSourceItem:
     target_media_player: str | None
     async def async_browse(self) -> BrowseMediaSource: ...
     async def async_resolve(self) -> PlayMedia: ...
+    @callback
     def async_media_source(self) -> MediaSource: ...
     @classmethod
     def from_uri(cls, hass: HomeAssistant, uri: str, target_media_player: str | None) -> MediaSourceItem: ...

homeassistant-stubs/components/met_eireann/weather.pyi

@@ -42,5 +42,7 @@ class MetEireannWeather(SingleCoordinatorWeatherEntity[DataUpdateCoordinator[Met
     @property
     def wind_bearing(self) -> float | None: ...
     def _forecast(self, hourly: bool) -> list[Forecast]: ...
+    @callback
     def _async_forecast_daily(self) -> list[Forecast]: ...
+    @callback
     def _async_forecast_hourly(self) -> list[Forecast]: ...

homeassistant-stubs/components/metoffice/weather.pyi

@@ -38,5 +38,7 @@ class MetOfficeWeather(CoordinatorWeatherEntity[TimestampDataUpdateCoordinator[M
     def native_wind_speed(self) -> float | None: ...
     @property
     def wind_bearing(self) -> str | None: ...
+    @callback
     def _async_forecast_daily(self) -> list[Forecast] | None: ...
+    @callback
     def _async_forecast_hourly(self) -> list[Forecast] | None: ...

homeassistant-stubs/components/mikrotik/config_flow.pyi

@@ -10,6 +10,7 @@ from typing import Any
 class MikrotikFlowHandler(ConfigFlow, domain=DOMAIN):
     VERSION: int
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> MikrotikOptionsFlowHandler: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...

homeassistant-stubs/components/mikrotik/device_tracker.pyi

@@ -8,6 +8,7 @@ from homeassistant.helpers.update_coordinator import CoordinatorEntity as Coordi
 from typing import Any
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: MikrotikConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+@callback
 def update_items(coordinator: MikrotikDataUpdateCoordinator, async_add_entities: AddEntitiesCallback, tracked: dict[str, MikrotikDataUpdateCoordinatorTracker]) -> None: ...
 
 class MikrotikDataUpdateCoordinatorTracker(CoordinatorEntity[MikrotikDataUpdateCoordinator], ScannerEntity):

homeassistant-stubs/components/min_max/sensor.pyi

@@ -69,5 +69,7 @@ class MinMaxSensor(SensorEntity):
     def native_unit_of_measurement(self) -> str | None: ...
     @property
     def extra_state_attributes(self) -> dict[str, Any] | None: ...
+    @callback
     def _async_min_max_sensor_state_listener(self, event: Event[EventStateChangedData], update_state: bool = True) -> None: ...
+    @callback
     def _calc_values(self) -> None: ...

homeassistant-stubs/components/minecraft_server/__init__.pyi

@@ -17,4 +17,5 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ..
 async def async_unload_entry(hass: HomeAssistant, config_entry: ConfigEntry) -> bool: ...
 async def async_migrate_entry(hass: HomeAssistant, config_entry: ConfigEntry) -> bool: ...
 async def _async_migrate_device_identifiers(hass: HomeAssistant, config_entry: ConfigEntry, old_unique_id: str | None) -> None: ...
+@callback
 def _migrate_entity_unique_id(entity_entry: er.RegistryEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/minecraft_server/sensor.pyi

@@ -40,7 +40,9 @@ class MinecraftServerSensorEntity(MinecraftServerEntity, SensorEntity):
     entity_description: MinecraftServerSensorEntityDescription
     _attr_unique_id: Incomplete
     def __init__(self, coordinator: MinecraftServerCoordinator, description: MinecraftServerSensorEntityDescription, config_entry: ConfigEntry) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     _attr_native_value: Incomplete
     _attr_extra_state_attributes: Incomplete
+    @callback
     def _update_properties(self) -> None: ...

homeassistant-stubs/components/mjpeg/config_flow.pyi

@@ -7,6 +7,7 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from types import MappingProxyType
 from typing import Any
 
+@callback
 def async_get_schema(defaults: dict[str, Any] | MappingProxyType[str, Any], show_name: bool = False) -> vol.Schema: ...
 def validate_url(url: str, username: str | None, password: str, verify_ssl: bool, authentication: str = ...) -> str: ...
 async def async_validate_input(hass: HomeAssistant, user_input: dict[str, Any]) -> tuple[dict[str, str], str]: ...
@@ -14,6 +15,7 @@ async def async_validate_input(hass: HomeAssistant, user_input: dict[str, Any])
 class MJPEGFlowHandler(ConfigFlow, domain=DOMAIN):
     VERSION: int
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> MJPEGOptionsFlowHandler: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
 

homeassistant-stubs/components/modbus/binary_sensor.pyi

@@ -39,4 +39,5 @@ class SlaveSensor(CoordinatorEntity[DataUpdateCoordinator[list[int] | None]], Re
     def __init__(self, coordinator: DataUpdateCoordinator[list[int] | None], idx: int, entry: dict[str, Any]) -> None: ...
     _attr_is_on: Incomplete
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/components/modbus/entity.pyi

@@ -38,7 +38,9 @@ class BasePlatform(Entity, metaclass=abc.ABCMeta):
     def __init__(self, hass: HomeAssistant, hub: ModbusHub, entry: dict[str, Any]) -> None: ...
     @abstractmethod
     async def async_update(self, now: datetime | None = None) -> None: ...
+    @callback
     def async_run(self) -> None: ...
+    @callback
     def async_hold(self, update: bool = True) -> None: ...
     async def async_base_added_to_hass(self) -> None: ...
 

homeassistant-stubs/components/modbus/modbus.pyi

@@ -44,6 +44,7 @@ class ModbusHub:
     def _log_error(self, text: str, error_state: bool = True) -> None: ...
     async def async_pb_connect(self) -> None: ...
     async def async_setup(self) -> bool: ...
+    @callback
     def async_end_delay(self, args: Any) -> None: ...
     async def async_restart(self) -> None: ...
     async def async_close(self) -> None: ...

homeassistant-stubs/components/modbus/sensor.pyi

@@ -42,4 +42,5 @@ class SlaveSensor(CoordinatorEntity[DataUpdateCoordinator[list[float] | None]],
     def __init__(self, coordinator: DataUpdateCoordinator[list[float] | None], idx: int, entry: dict[str, Any]) -> None: ...
     _attr_native_value: Incomplete
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/components/modem_callerid/sensor.pyi

@@ -22,4 +22,5 @@ class ModemCalleridSensor(SensorEntity):
     _attr_device_info: Incomplete
     def __init__(self, api: PhoneModem, server_unique_id: str) -> None: ...
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def _async_incoming_call(self, new_state: str) -> None: ...

homeassistant-stubs/components/mold_indicator/config_flow.pyi

@@ -26,4 +26,5 @@ class MoldIndicatorConfigFlowHandler(SchemaConfigFlowHandler, domain=DOMAIN):
     @staticmethod
     async def async_setup_preview(hass: HomeAssistant) -> None: ...
 
+@callback
 def ws_start_preview(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/mold_indicator/sensor.pyi

@@ -46,8 +46,10 @@ class MoldIndicator(SensorEntity):
     _attr_device_info: Incomplete
     _preview_callback: Callable[[str, Mapping[str, Any]], None] | None
     def __init__(self, hass: HomeAssistant, name: str, is_metric: bool, indoor_temp_sensor: str, outdoor_temp_sensor: str, indoor_humidity_sensor: str, calib_factor: float, unique_id: str | None) -> None: ...
+    @callback
     def async_start_preview(self, preview_callback: Callable[[str, Mapping[str, Any]], None]) -> CALLBACK_TYPE: ...
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def _async_setup_sensor(self) -> None: ...
     def _update_sensor(self, entity: str, old_state: State | None, new_state: State | None) -> bool: ...
     @staticmethod

homeassistant-stubs/components/mopeka/config_flow.pyi

@@ -22,6 +22,7 @@ class MopekaConfigFlow(ConfigFlow, domain=DOMAIN):
     _discovered_device: DeviceData | None
     _discovered_devices: dict[str, str]
     def __init__(self) -> None: ...
+    @callback
     @staticmethod
     def async_get_options_flow(config_entry: config_entries.ConfigEntry) -> MopekaOptionsFlow: ...
     async def async_step_bluetooth(self, discovery_info: BluetoothServiceInfoBleak) -> ConfigFlowResult: ...

homeassistant-stubs/components/mqtt/__init__.pyi

@@ -39,13 +39,17 @@ CONFIG_SCHEMA: Incomplete
 MQTT_PUBLISH_SCHEMA: Incomplete
 
 async def _async_config_entry_updated(hass: HomeAssistant, entry: ConfigEntry) -> None: ...
+@callback
 def _async_remove_mqtt_issues(hass: HomeAssistant, mqtt_data: MqttData) -> None: ...
 async def async_check_config_schema(hass: HomeAssistant, config_yaml: ConfigType) -> None: ...
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+@callback
 def websocket_mqtt_info(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.async_response
 async def websocket_subscribe(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 type ConnectionStatusCallback = Callable[[bool], None]
+@callback
 def async_subscribe_connection_status(hass: HomeAssistant, connection_status_callback: ConnectionStatusCallback) -> Callable[[], None]: ...
 def is_connected(hass: HomeAssistant) -> bool: ...
 async def async_remove_config_entry_device(hass: HomeAssistant, config_entry: ConfigEntry, device_entry: DeviceEntry) -> bool: ...

homeassistant-stubs/components/mqtt/addon.pyi

@@ -7,4 +7,5 @@ from homeassistant.helpers.singleton import singleton as singleton
 ADDON_SLUG: str
 DATA_ADDON_MANAGER: Incomplete
 
+@callback
 def get_addon_manager(hass: HomeAssistant) -> AddonManager: ...

homeassistant-stubs/components/mqtt/alarm_control_panel.pyi

@@ -58,6 +58,7 @@ class MqttAlarm(MqttEntity, alarm.AlarmControlPanelEntity):
     def _setup_from_config(self, config: ConfigType) -> None: ...
     _attr_alarm_state: Incomplete
     def _state_message_received(self, msg: ReceiveMessage) -> None: ...
+    @callback
     def _prepare_subscribe_topics(self) -> None: ...
     async def _subscribe_topics(self) -> None: ...
     async def async_alarm_disarm(self, code: str | None = None) -> None: ...

homeassistant-stubs/components/mqtt/binary_sensor.pyi

@@ -47,10 +47,13 @@ class MqttBinarySensor(MqttEntity, BinarySensorEntity, RestoreEntity):
     _attr_device_class: Incomplete
     _value_template: Incomplete
     def _setup_from_config(self, config: ConfigType) -> None: ...
+    @callback
     def _off_delay_listener(self, now: datetime) -> None: ...
     def _state_message_received(self, msg: ReceiveMessage) -> None: ...
+    @callback
     def _prepare_subscribe_topics(self) -> None: ...
     async def _subscribe_topics(self) -> None: ...
+    @callback
     def _value_is_expired(self, *_: Any) -> None: ...
     @property
     def available(self) -> bool: ...

homeassistant-stubs/components/mqtt/button.pyi

@@ -31,6 +31,7 @@ class MqttButton(MqttEntity, ButtonEntity):
     _command_template: Incomplete
     _attr_device_class: Incomplete
     def _setup_from_config(self, config: ConfigType) -> None: ...
+    @callback
     def _prepare_subscribe_topics(self) -> None: ...
     async def _subscribe_topics(self) -> None: ...
     async def async_press(self) -> None: ...

homeassistant-stubs/components/mqtt/camera.pyi

@@ -34,7 +34,9 @@ class MqttCamera(MqttEntity, Camera):
     def __init__(self, hass: HomeAssistant, config: ConfigType, config_entry: ConfigEntry, discovery_data: DiscoveryInfoType | None) -> None: ...
     @staticmethod
     def config_schema() -> vol.Schema: ...
+    @callback
     def _image_received(self, msg: ReceiveMessage) -> None: ...
+    @callback
     def _prepare_subscribe_topics(self) -> None: ...
     async def _subscribe_topics(self) -> None: ...
     async def async_camera_image(self, width: int | None = None, height: int | None = None) -> bytes | None: ...

homeassistant-stubs/components/mqtt/client.pyi

@@ -1,4 +1,5 @@
 import asyncio
+import contextlib
 import paho.mqtt.client as mqtt
 import socket
 import ssl
@@ -42,8 +43,11 @@ type SubscribePayloadType = str | bytes | bytearray
 
 def publish(hass: HomeAssistant, topic: str, payload: PublishPayloadType, qos: int | None = 0, retain: bool | None = False, encoding: str | None = ...) -> None: ...
 async def async_publish(hass: HomeAssistant, topic: str, payload: PublishPayloadType, qos: int | None = 0, retain: bool | None = False, encoding: str | None = ...) -> None: ...
+@bind_hass
 async def async_subscribe(hass: HomeAssistant, topic: str, msg_callback: Callable[[ReceiveMessage], Coroutine[Any, Any, None] | None], qos: int = ..., encoding: str | None = ...) -> CALLBACK_TYPE: ...
+@callback
 def async_subscribe_internal(hass: HomeAssistant, topic: str, msg_callback: Callable[[ReceiveMessage], Coroutine[Any, Any, None] | None], qos: int = ..., encoding: str | None = ..., job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@bind_hass
 def subscribe(hass: HomeAssistant, topic: str, msg_callback: MessageCallbackType, qos: int = ..., encoding: str = 'utf-8') -> Callable[[], None]: ...
 
 @dataclass(slots=True, frozen=True)
@@ -90,50 +94,76 @@ class MQTT:
     _pending_unsubscribes: set[str]
     _socket_buffersize: int | None
     def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry, conf: ConfigType) -> None: ...
+    @callback
     def _async_ha_started(self, _hass: HomeAssistant) -> None: ...
     async def _async_ha_stop(self, _event: Event) -> None: ...
     async def async_start(self, mqtt_data: MqttData) -> None: ...
     @property
     def subscriptions(self) -> set[Subscription]: ...
     def cleanup(self) -> None: ...
+    @contextlib.asynccontextmanager
     async def _async_connect_in_executor(self) -> AsyncGenerator[None]: ...
     async def async_init_client(self) -> None: ...
+    @callback
     def _async_reader_callback(self, client: mqtt.Client) -> None: ...
+    @callback
     def _async_start_misc_periodic(self) -> None: ...
     def _increase_socket_buffer_size(self, sock: SocketType) -> None: ...
     def _on_socket_open(self, client: mqtt.Client, userdata: Any, sock: SocketType) -> None: ...
+    @callback
     def _async_on_socket_open(self, client: mqtt.Client, userdata: Any, sock: SocketType) -> None: ...
+    @callback
     def _async_on_socket_close(self, client: mqtt.Client, userdata: Any, sock: SocketType) -> None: ...
+    @callback
     def _async_writer_callback(self, client: mqtt.Client) -> None: ...
     def _on_socket_register_write(self, client: mqtt.Client, userdata: Any, sock: SocketType) -> None: ...
+    @callback
     def _async_on_socket_register_write(self, client: mqtt.Client, userdata: Any, sock: SocketType) -> None: ...
+    @callback
     def _async_on_socket_unregister_write(self, client: mqtt.Client, userdata: Any, sock: SocketType) -> None: ...
     def _is_active_subscription(self, topic: str) -> bool: ...
     async def async_publish(self, topic: str, payload: PublishPayloadType, qos: int, retain: bool) -> None: ...
     async def async_connect(self, client_available: asyncio.Future[bool]) -> None: ...
+    @callback
     def _async_connection_result(self, connected: bool) -> None: ...
+    @callback
     def _async_cancel_reconnect(self) -> None: ...
     async def _reconnect_loop(self) -> None: ...
     async def async_disconnect(self, disconnect_paho_client: bool = False) -> None: ...
+    @callback
     def async_restore_tracked_subscriptions(self, subscriptions: set[Subscription]) -> None: ...
+    @callback
     def _async_track_subscription(self, subscription: Subscription) -> None: ...
+    @callback
     def _async_untrack_subscription(self, subscription: Subscription) -> None: ...
+    @callback
     def _async_queue_subscriptions(self, subscriptions: Iterable[tuple[str, int]], queue_only: bool = False) -> None: ...
     def _exception_message(self, msg_callback: Callable[[ReceiveMessage], Coroutine[Any, Any, None] | None], msg: ReceiveMessage) -> str: ...
+    @callback
     def async_subscribe(self, topic: str, msg_callback: Callable[[ReceiveMessage], Coroutine[Any, Any, None] | None], qos: int, encoding: str | None = None, job_type: HassJobType | None = None) -> Callable[[], None]: ...
+    @callback
     def _async_remove(self, subscription: Subscription) -> None: ...
+    @callback
     def _async_unsubscribe(self, topic: str) -> None: ...
     async def _async_perform_subscriptions(self) -> None: ...
     async def _async_perform_unsubscribes(self) -> None: ...
     async def _async_resubscribe_and_publish_birth_message(self, birth_message: PublishMessage) -> None: ...
+    @callback
     def _async_mqtt_on_connect(self, _mqttc: mqtt.Client, _userdata: None, _flags: dict[str, int], result_code: int, properties: mqtt.Properties | None = None) -> None: ...
+    @callback
     def _async_queue_resubscribe(self) -> None: ...
     def _matching_subscriptions(self, topic: str) -> list[Subscription]: ...
+    @callback
     def _async_mqtt_on_message(self, _mqttc: mqtt.Client, _userdata: None, msg: mqtt.MQTTMessage) -> None: ...
+    @callback
     def _async_mqtt_on_callback(self, _mqttc: mqtt.Client, _userdata: None, mid: int, _granted_qos_reason: tuple[int, ...] | mqtt.ReasonCodes | None = None, _properties_reason: mqtt.ReasonCodes | None = None) -> None: ...
+    @callback
     def _async_get_mid_future(self, mid: int) -> asyncio.Future[None]: ...
+    @callback
     def _async_mqtt_on_disconnect(self, _mqttc: mqtt.Client, _userdata: None, result_code: int, properties: mqtt.Properties | None = None) -> None: ...
+    @callback
     def _async_on_disconnect(self, result_code: int) -> None: ...
+    @callback
     def _async_timeout_mid(self, future: asyncio.Future[None]) -> None: ...
     async def _async_wait_for_mid_or_raise(self, mid: int, result_code: int) -> None: ...
     async def _discovery_cooldown(self) -> None: ...