homeassistant-stubs 2024.10.3__py3-none-any.whl → 2024.11.0__py3-none-any.whl

homeassistant-stubs/components/button/__init__.pyi

@@ -1,7 +1,6 @@
 from .const import DOMAIN as DOMAIN, SERVICE_PRESS as SERVICE_PRESS
 from _typeshed import Incomplete
 from enum import StrEnum
-from functools import cached_property as cached_property
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import STATE_UNAVAILABLE as STATE_UNAVAILABLE
 from homeassistant.core import HomeAssistant as HomeAssistant
@@ -44,9 +43,7 @@ class ButtonEntity(RestoreEntity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_
     _attr_state: None
     __last_pressed_isoformat: str | None
     def _default_to_device_class_name(self) -> bool: ...
-    @cached_property
     def device_class(self) -> ButtonDeviceClass | None: ...
-    @cached_property
     def state(self) -> str | None: ...
     def __set_state(self, state: str | None) -> None: ...
     async def _async_press_action(self) -> None: ...

homeassistant-stubs/components/calendar/trigger.pyi

@@ -2,7 +2,7 @@ import datetime
 from . import CalendarEntity as CalendarEntity, CalendarEvent as CalendarEvent
 from .const import DATA_COMPONENT as DATA_COMPONENT, DOMAIN as DOMAIN
 from _typeshed import Incomplete
-from collections.abc import Coroutine
+from collections.abc import Awaitable, Callable, Coroutine
 from dataclasses import dataclass
 from homeassistant.const import CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_EVENT as CONF_EVENT, CONF_OFFSET as CONF_OFFSET, CONF_PLATFORM as CONF_PLATFORM
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback
@@ -34,6 +34,8 @@ class Timespan:
     def next_upcoming(self, now: datetime.datetime, interval: datetime.timedelta) -> Timespan: ...
     def __str__(self) -> str: ...
     def __init__(self, start, end) -> None: ...
+type EventFetcher = Callable[[Timespan], Awaitable[list[CalendarEvent]]]
+type QueuedEventFetcher = Callable[[Timespan], Awaitable[list[QueuedCalendarEvent]]]
 
 def get_entity(hass: HomeAssistant, entity_id: str) -> CalendarEntity: ...
 def event_fetcher(hass: HomeAssistant, entity_id: str) -> EventFetcher: ...

homeassistant-stubs/components/cambridge_audio/__init__.pyi

@@ -0,0 +1,14 @@
+from .const import CONNECT_TIMEOUT as CONNECT_TIMEOUT, DOMAIN as DOMAIN, STREAM_MAGIC_EXCEPTIONS as STREAM_MAGIC_EXCEPTIONS
+from _typeshed import Incomplete
+from aiostreammagic import StreamMagicClient
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_HOST as CONF_HOST, Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
+
+PLATFORMS: list[Platform]
+_LOGGER: Incomplete
+type CambridgeAudioConfigEntry = ConfigEntry[StreamMagicClient]
+
+async def async_setup_entry(hass: HomeAssistant, entry: CambridgeAudioConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: CambridgeAudioConfigEntry) -> bool: ...

homeassistant-stubs/components/cambridge_audio/config_flow.pyi

@@ -0,0 +1,14 @@
+from .const import CONNECT_TIMEOUT as CONNECT_TIMEOUT, DOMAIN as DOMAIN, STREAM_MAGIC_EXCEPTIONS as STREAM_MAGIC_EXCEPTIONS
+from _typeshed import Incomplete
+from homeassistant.components import zeroconf as zeroconf
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from homeassistant.const import CONF_HOST as CONF_HOST, CONF_NAME as CONF_NAME
+from typing import Any
+
+class CambridgeAudioConfigFlow(ConfigFlow, domain=DOMAIN):
+    VERSION: int
+    data: Incomplete
+    def __init__(self) -> None: ...
+    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_discovery_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/cambridge_audio/const.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+
+DOMAIN: str
+LOGGER: Incomplete
+STREAM_MAGIC_EXCEPTIONS: Incomplete
+CONNECT_TIMEOUT: int
+CAMBRIDGE_MEDIA_TYPE_PRESET: str
+CAMBRIDGE_MEDIA_TYPE_AIRABLE: str
+CAMBRIDGE_MEDIA_TYPE_INTERNET_RADIO: str

homeassistant-stubs/components/cambridge_audio/diagnostics.pyi

@@ -0,0 +1,5 @@
+from . import CambridgeAudioConfigEntry as CambridgeAudioConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+from typing import Any
+
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: CambridgeAudioConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/cambridge_audio/entity.pyi

@@ -0,0 +1,21 @@
+from .const import DOMAIN as DOMAIN, STREAM_MAGIC_EXCEPTIONS as STREAM_MAGIC_EXCEPTIONS
+from _typeshed import Incomplete
+from aiostreammagic import StreamMagicClient as StreamMagicClient
+from aiostreammagic.models import CallbackType as CallbackType
+from collections.abc import Awaitable, Callable as Callable, Coroutine
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.entity import Entity as Entity
+from typing import Any, Concatenate
+
+def command[_EntityT: CambridgeAudioEntity, **_P](func: Callable[Concatenate[_EntityT, _P], Awaitable[None]]) -> Callable[Concatenate[_EntityT, _P], Coroutine[Any, Any, None]]: ...
+
+class CambridgeAudioEntity(Entity):
+    _attr_has_entity_name: bool
+    client: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, client: StreamMagicClient) -> None: ...
+    _attr_available: Incomplete
+    async def _state_update_callback(self, _client: StreamMagicClient, _callback_type: CallbackType) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
+    async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/cambridge_audio/media_player.pyi

@@ -0,0 +1,71 @@
+from .const import CAMBRIDGE_MEDIA_TYPE_AIRABLE as CAMBRIDGE_MEDIA_TYPE_AIRABLE, CAMBRIDGE_MEDIA_TYPE_INTERNET_RADIO as CAMBRIDGE_MEDIA_TYPE_INTERNET_RADIO, CAMBRIDGE_MEDIA_TYPE_PRESET as CAMBRIDGE_MEDIA_TYPE_PRESET, DOMAIN as DOMAIN
+from .entity import CambridgeAudioEntity as CambridgeAudioEntity, command as command
+from _typeshed import Incomplete
+from aiostreammagic import StreamMagicClient as StreamMagicClient, TransportControl
+from datetime import datetime
+from homeassistant.components.media_player import MediaPlayerDeviceClass as MediaPlayerDeviceClass, MediaPlayerEntity as MediaPlayerEntity, MediaPlayerEntityFeature as MediaPlayerEntityFeature, MediaPlayerState as MediaPlayerState, MediaType as MediaType, RepeatMode as RepeatMode
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceValidationError as ServiceValidationError
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from typing import Any
+
+BASE_FEATURES: Incomplete
+PREAMP_FEATURES: Incomplete
+TRANSPORT_FEATURES: dict[TransportControl, MediaPlayerEntityFeature]
+
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class CambridgeAudioDevice(CambridgeAudioEntity, MediaPlayerEntity):
+    _attr_name: Incomplete
+    _attr_media_content_type: Incomplete
+    _attr_device_class: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, client: StreamMagicClient) -> None: ...
+    @property
+    def supported_features(self) -> MediaPlayerEntityFeature: ...
+    @property
+    def state(self) -> MediaPlayerState: ...
+    @property
+    def source_list(self) -> list[str]: ...
+    @property
+    def source(self) -> str | None: ...
+    @property
+    def media_title(self) -> str | None: ...
+    @property
+    def media_artist(self) -> str | None: ...
+    @property
+    def media_album_name(self) -> str | None: ...
+    @property
+    def media_image_url(self) -> str | None: ...
+    @property
+    def media_duration(self) -> int | None: ...
+    @property
+    def media_position(self) -> int | None: ...
+    @property
+    def media_position_updated_at(self) -> datetime: ...
+    @property
+    def is_volume_muted(self) -> bool | None: ...
+    @property
+    def volume_level(self) -> float | None: ...
+    @property
+    def shuffle(self) -> bool: ...
+    @property
+    def repeat(self) -> RepeatMode | None: ...
+    async def async_media_play_pause(self) -> None: ...
+    async def async_media_pause(self) -> None: ...
+    async def async_media_stop(self) -> None: ...
+    async def async_media_play(self) -> None: ...
+    async def async_media_next_track(self) -> None: ...
+    async def async_media_previous_track(self) -> None: ...
+    async def async_select_source(self, source: str) -> None: ...
+    async def async_turn_on(self) -> None: ...
+    async def async_turn_off(self) -> None: ...
+    async def async_volume_up(self) -> None: ...
+    async def async_volume_down(self) -> None: ...
+    async def async_set_volume_level(self, volume: float) -> None: ...
+    async def async_mute_volume(self, mute: bool) -> None: ...
+    async def async_media_seek(self, position: float) -> None: ...
+    async def async_set_shuffle(self, shuffle: bool) -> None: ...
+    async def async_set_repeat(self, repeat: RepeatMode) -> None: ...
+    async def async_play_media(self, media_type: MediaType | str, media_id: str, **kwargs: Any) -> None: ...

homeassistant-stubs/components/cambridge_audio/select.pyi

@@ -0,0 +1,34 @@
+from .entity import CambridgeAudioEntity as CambridgeAudioEntity
+from _typeshed import Incomplete
+from aiostreammagic import StreamMagicClient as StreamMagicClient
+from collections.abc import Awaitable, Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.select import SelectEntity as SelectEntity, SelectEntityDescription as SelectEntityDescription
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+
+@dataclass(frozen=True, kw_only=True)
+class CambridgeAudioSelectEntityDescription(SelectEntityDescription):
+    options_fn: Callable[[StreamMagicClient], list[str]] = ...
+    load_fn: Callable[[StreamMagicClient], bool] = ...
+    value_fn: Callable[[StreamMagicClient], str | None]
+    set_value_fn: Callable[[StreamMagicClient, str], Awaitable[None]]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., options=..., options_fn=..., load_fn=..., value_fn, set_value_fn) -> None: ...
+
+async def _audio_output_set_value_fn(client: StreamMagicClient, value: str) -> None: ...
+def _audio_output_value_fn(client: StreamMagicClient) -> str | None: ...
+
+CONTROL_ENTITIES: tuple[CambridgeAudioSelectEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class CambridgeAudioSelect(CambridgeAudioEntity, SelectEntity):
+    entity_description: CambridgeAudioSelectEntityDescription
+    _attr_unique_id: Incomplete
+    _attr_options: Incomplete
+    def __init__(self, client: StreamMagicClient, description: CambridgeAudioSelectEntityDescription) -> None: ...
+    @property
+    def current_option(self) -> str | None: ...
+    async def async_select_option(self, option: str) -> None: ...

homeassistant-stubs/components/cambridge_audio/switch.pyi

@@ -0,0 +1,30 @@
+from .entity import CambridgeAudioEntity as CambridgeAudioEntity
+from _typeshed import Incomplete
+from aiostreammagic import StreamMagicClient as StreamMagicClient
+from collections.abc import Awaitable, Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.switch import SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from typing import Any
+
+@dataclass(frozen=True, kw_only=True)
+class CambridgeAudioSwitchEntityDescription(SwitchEntityDescription):
+    value_fn: Callable[[StreamMagicClient], bool]
+    set_value_fn: Callable[[StreamMagicClient, bool], Awaitable[None]]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., value_fn, set_value_fn) -> None: ...
+
+CONTROL_ENTITIES: tuple[CambridgeAudioSwitchEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class CambridgeAudioSwitch(CambridgeAudioEntity, SwitchEntity):
+    entity_description: CambridgeAudioSwitchEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, client: StreamMagicClient, description: CambridgeAudioSwitchEntityDescription) -> None: ...
+    @property
+    def is_on(self) -> bool: ...
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    async def async_turn_off(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/camera/__init__.pyi

@@ -1,11 +1,13 @@
-from .const import CAMERA_IMAGE_TIMEOUT as CAMERA_IMAGE_TIMEOUT, CAMERA_STREAM_SOURCE_TIMEOUT as CAMERA_STREAM_SOURCE_TIMEOUT, CONF_DURATION as CONF_DURATION, CONF_LOOKBACK as CONF_LOOKBACK, CameraState as CameraState, DATA_CAMERA_PREFS as DATA_CAMERA_PREFS, DATA_COMPONENT as DATA_COMPONENT, DATA_RTSP_TO_WEB_RTC as DATA_RTSP_TO_WEB_RTC, DOMAIN as DOMAIN, PREF_ORIENTATION as PREF_ORIENTATION, PREF_PRELOAD_STREAM as PREF_PRELOAD_STREAM, SERVICE_RECORD as SERVICE_RECORD, StreamType as StreamType, _DEPRECATED_STREAM_TYPE_HLS as _DEPRECATED_STREAM_TYPE_HLS, _DEPRECATED_STREAM_TYPE_WEB_RTC as _DEPRECATED_STREAM_TYPE_WEB_RTC
+from .const import CAMERA_IMAGE_TIMEOUT as CAMERA_IMAGE_TIMEOUT, CAMERA_STREAM_SOURCE_TIMEOUT as CAMERA_STREAM_SOURCE_TIMEOUT, CONF_DURATION as CONF_DURATION, CONF_LOOKBACK as CONF_LOOKBACK, CameraState as CameraState, DATA_CAMERA_PREFS as DATA_CAMERA_PREFS, DATA_COMPONENT as DATA_COMPONENT, DOMAIN as DOMAIN, PREF_ORIENTATION as PREF_ORIENTATION, PREF_PRELOAD_STREAM as PREF_PRELOAD_STREAM, SERVICE_RECORD as SERVICE_RECORD, StreamType as StreamType, _DEPRECATED_STREAM_TYPE_HLS as _DEPRECATED_STREAM_TYPE_HLS, _DEPRECATED_STREAM_TYPE_WEB_RTC as _DEPRECATED_STREAM_TYPE_WEB_RTC
+from .helper import get_camera_from_entity_id as get_camera_from_entity_id
 from .img_util import scale_jpeg_camera_image as scale_jpeg_camera_image
 from .prefs import CameraPreferences as CameraPreferences, DynamicStreamSettings as DynamicStreamSettings
+from .webrtc import CameraWebRTCLegacyProvider as CameraWebRTCLegacyProvider, CameraWebRTCProvider as CameraWebRTCProvider, DATA_ICE_SERVERS as DATA_ICE_SERVERS, WebRTCAnswer as WebRTCAnswer, WebRTCCandidate as WebRTCCandidate, WebRTCClientConfiguration as WebRTCClientConfiguration, WebRTCError as WebRTCError, WebRTCMessage as WebRTCMessage, WebRTCSendMessage as WebRTCSendMessage, async_get_supported_legacy_provider as async_get_supported_legacy_provider, async_get_supported_provider as async_get_supported_provider, async_register_ice_servers as async_register_ice_servers, async_register_rtsp_to_web_rtc_provider as async_register_rtsp_to_web_rtc_provider, async_register_webrtc_provider as async_register_webrtc_provider, async_register_ws as async_register_ws
 from _typeshed import Incomplete
 from aiohttp import web
-from collections.abc import Awaitable, Callable, Iterable
+from collections.abc import Awaitable, Callable as Callable, Coroutine
+from dataclasses import dataclass
 from enum import IntFlag
-from functools import cached_property as cached_property
 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.media_player import ATTR_MEDIA_CONTENT_ID as ATTR_MEDIA_CONTENT_ID, ATTR_MEDIA_CONTENT_TYPE as ATTR_MEDIA_CONTENT_TYPE, SERVICE_PLAY_MEDIA as SERVICE_PLAY_MEDIA
@@ -24,6 +26,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 typing import Any, Final
+from webrtc_models import RTCIceCandidate as RTCIceCandidate
 
 _LOGGER: Incomplete
 ENTITY_ID_FORMAT: Final[Incomplete]
@@ -47,7 +50,6 @@ class CameraEntityFeature(IntFlag):
 
 _DEPRECATED_SUPPORT_ON_OFF: Final[Incomplete]
 _DEPRECATED_SUPPORT_STREAM: Final[Incomplete]
-RTSP_PREFIXES: Incomplete
 DEFAULT_CONTENT_TYPE: Final[str]
 ENTITY_IMAGE_URL: Final[str]
 TOKEN_CHANGE_INTERVAL: Final[Incomplete]
@@ -70,6 +72,11 @@ class Image:
     def __gt__(self, other): ...
     def __ge__(self, other): ...
 
+@dataclass(frozen=True)
+class CameraCapabilities:
+    frontend_stream_types: set[StreamType]
+    def __init__(self, frontend_stream_types) -> None: ...
+
 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: ...
 async def async_get_image(hass: HomeAssistant, entity_id: str, timeout: int = 10, width: int | None = None, height: int | None = None) -> Image: ...
@@ -77,10 +84,6 @@ async def _async_get_stream_image(camera: Camera, width: int | None = None, heig
 async def async_get_stream_source(hass: HomeAssistant, entity_id: str) -> str | None: ...
 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: ...
-def _get_camera_from_entity_id(hass: HomeAssistant, entity_id: str) -> Camera: ...
-def async_register_rtsp_to_web_rtc_provider(hass: HomeAssistant, domain: str, provider: RtspToWebRtcProviderType) -> Callable[[], None]: ...
-async def _async_refresh_providers(hass: HomeAssistant) -> None: ...
-def _async_get_rtsp_to_web_rtc_providers(hass: HomeAssistant) -> Iterable[RtspToWebRtcProviderType]: ...
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
@@ -100,33 +103,29 @@ class Camera(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     _attr_should_poll: bool
     _attr_state: None
     _attr_supported_features: CameraEntityFeature
+    __supports_stream: CameraEntityFeature | None
+    _cache: Incomplete
     stream: Incomplete
     stream_options: Incomplete
     content_type: Incomplete
     access_tokens: Incomplete
     _warned_old_signature: bool
     _create_stream_lock: Incomplete
-    _rtsp_to_webrtc: bool
+    _webrtc_provider: Incomplete
+    _legacy_webrtc_provider: Incomplete
+    _supports_native_sync_webrtc: Incomplete
+    _supports_native_async_webrtc: Incomplete
     def __init__(self) -> None: ...
-    @cached_property
     def entity_picture(self) -> str: ...
-    @cached_property
     def use_stream_for_stills(self) -> bool: ...
-    @cached_property
     def supported_features(self) -> CameraEntityFeature: ...
     @property
     def supported_features_compat(self) -> CameraEntityFeature: ...
-    @cached_property
     def is_recording(self) -> bool: ...
-    @cached_property
     def is_streaming(self) -> bool: ...
-    @cached_property
     def brand(self) -> str | None: ...
-    @cached_property
     def motion_detection_enabled(self) -> bool: ...
-    @cached_property
     def model(self) -> str | None: ...
-    @cached_property
     def frame_interval(self) -> float: ...
     @property
     def frontend_stream_type(self) -> StreamType | None: ...
@@ -135,13 +134,13 @@ class Camera(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     async def async_create_stream(self) -> Stream | None: ...
     async def stream_source(self) -> str | None: ...
     async def async_handle_web_rtc_offer(self, offer_sdp: str) -> str | None: ...
+    async def async_handle_async_webrtc_offer(self, offer_sdp: str, session_id: str, send_message: WebRTCSendMessage) -> None: ...
     def camera_image(self, width: int | None = None, height: int | None = None) -> bytes | None: ...
     async def async_camera_image(self, width: int | None = None, height: int | None = None) -> bytes | None: ...
     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
     def state(self) -> str: ...
-    @cached_property
     def is_on(self) -> bool: ...
     def turn_off(self) -> None: ...
     async def async_turn_off(self) -> None: ...
@@ -155,8 +154,15 @@ class Camera(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     def state_attributes(self) -> dict[str, str | None]: ...
     def async_update_token(self) -> None: ...
     async def async_internal_added_to_hass(self) -> None: ...
-    async def async_refresh_providers(self) -> None: ...
-    async def _async_use_rtsp_to_webrtc(self) -> bool: ...
+    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: ...
+    def _async_get_webrtc_client_configuration(self) -> WebRTCClientConfiguration: ...
+    def async_get_webrtc_client_configuration(self) -> WebRTCClientConfiguration: ...
+    async def async_on_webrtc_candidate(self, session_id: str, candidate: RTCIceCandidate) -> None: ...
+    def close_webrtc_session(self, session_id: str) -> None: ...
+    def _invalidate_camera_capabilities_cache(self) -> None: ...
+    def camera_capabilities(self) -> CameraCapabilities: ...
+    def async_write_ha_state(self) -> None: ...
 
 class CameraView(HomeAssistantView):
     requires_auth: bool
@@ -175,10 +181,21 @@ class CameraMjpegStream(CameraView):
     name: str
     async def handle(self, request: web.Request, camera: Camera) -> web.StreamResponse: ...
 
+async def ws_camera_capabilities(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def ws_camera_stream(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
-async def ws_camera_web_rtc_offer(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def websocket_get_prefs(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def websocket_update_prefs(hass: HomeAssistant, connection: ActiveConnection, msg: dict[str, Any]) -> None: ...
+
+class _TemplateCameraEntity:
+    _camera: Incomplete
+    _entity_id: Incomplete
+    _hass: Incomplete
+    _service: Incomplete
+    def __init__(self, camera: Camera, service: str) -> None: ...
+    def _report_issue(self) -> None: ...
+    def __getattr__(self, name: str) -> Any: ...
+    def __str__(self) -> str: ...
+
 async def async_handle_snapshot_service(camera: Camera, service_call: ServiceCall) -> None: ...
 async def async_handle_play_stream_service(camera: Camera, service_call: ServiceCall) -> None: ...
 async def _async_stream_endpoint_url(hass: HomeAssistant, camera: Camera, fmt: str) -> str: ...

homeassistant-stubs/components/camera/const.pyi

@@ -1,4 +1,4 @@
-from . import Camera as Camera, RtspToWebRtcProviderType as RtspToWebRtcProviderType
+from . import Camera as Camera
 from .prefs import CameraPreferences as CameraPreferences
 from _typeshed import Incomplete
 from enum import StrEnum
@@ -10,7 +10,6 @@ from typing import Final
 DOMAIN: Final[str]
 DATA_COMPONENT: HassKey[EntityComponent[Camera]]
 DATA_CAMERA_PREFS: HassKey[CameraPreferences]
-DATA_RTSP_TO_WEB_RTC: HassKey[dict[str, RtspToWebRtcProviderType]]
 PREF_PRELOAD_STREAM: Final[str]
 PREF_ORIENTATION: Final[str]
 SERVICE_RECORD: Final[str]

homeassistant-stubs/components/camera/diagnostics.pyi

@@ -1,5 +1,5 @@
-from . import _get_camera_from_entity_id as _get_camera_from_entity_id
 from .const import DOMAIN as DOMAIN
+from .helper import get_camera_from_entity_id as get_camera_from_entity_id
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError

homeassistant-stubs/components/camera/helper.pyi

@@ -0,0 +1,6 @@
+from . import Camera as Camera
+from .const import DATA_COMPONENT as DATA_COMPONENT
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+
+def get_camera_from_entity_id(hass: HomeAssistant, entity_id: str) -> Camera: ...

homeassistant-stubs/components/camera/webrtc.pyi

@@ -0,0 +1,96 @@
+import abc
+from . import Camera as Camera
+from .const import DATA_COMPONENT as DATA_COMPONENT, DOMAIN as DOMAIN, StreamType as StreamType
+from .helper import get_camera_from_entity_id as get_camera_from_entity_id
+from _typeshed import Incomplete
+from abc import ABC, abstractmethod
+from collections.abc import Awaitable, Callable, Iterable
+from dataclasses import dataclass
+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
+from homeassistant.util.hass_dict import HassKey as HassKey
+from homeassistant.util.ulid import ulid as ulid
+from typing import Any, Protocol
+from webrtc_models import RTCConfiguration, RTCIceCandidate, RTCIceServer as RTCIceServer
+
+_LOGGER: Incomplete
+DATA_WEBRTC_PROVIDERS: HassKey[set[CameraWebRTCProvider]]
+DATA_WEBRTC_LEGACY_PROVIDERS: HassKey[dict[str, CameraWebRTCLegacyProvider]]
+DATA_ICE_SERVERS: HassKey[list[Callable[[], Iterable[RTCIceServer]]]]
+_WEBRTC: str
+
+@dataclass(frozen=True)
+class WebRTCMessage:
+    @classmethod
+    def _get_type(cls) -> str: ...
+    def as_dict(self) -> dict[str, Any]: ...
+
+@dataclass(frozen=True)
+class WebRTCSession(WebRTCMessage):
+    session_id: str
+    def __init__(self, session_id) -> None: ...
+
+@dataclass(frozen=True)
+class WebRTCAnswer(WebRTCMessage):
+    answer: str
+    def __init__(self, answer) -> None: ...
+
+@dataclass(frozen=True)
+class WebRTCCandidate(WebRTCMessage):
+    candidate: RTCIceCandidate
+    def as_dict(self) -> dict[str, Any]: ...
+    def __init__(self, candidate) -> None: ...
+
+@dataclass(frozen=True)
+class WebRTCError(WebRTCMessage):
+    code: str
+    message: str
+    def __init__(self, code, message) -> None: ...
+type WebRTCSendMessage = Callable[[WebRTCMessage], None]
+
+@dataclass(kw_only=True)
+class WebRTCClientConfiguration:
+    configuration: RTCConfiguration = ...
+    data_channel: str | None = ...
+    get_candidates_upfront: bool = ...
+    def to_frontend_dict(self) -> dict[str, Any]: ...
+    def __init__(self, *, configuration=..., data_channel=..., get_candidates_upfront=...) -> None: ...
+
+class CameraWebRTCProvider(ABC, metaclass=abc.ABCMeta):
+    @property
+    @abstractmethod
+    def domain(self) -> str: ...
+    @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: RTCIceCandidate) -> None: ...
+    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: ...
+
+def async_register_webrtc_provider(hass: HomeAssistant, provider: CameraWebRTCProvider) -> Callable[[], None]: ...
+async def _async_refresh_providers(hass: HomeAssistant) -> None: ...
+async def ws_webrtc_offer(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def ws_get_client_config(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def ws_candidate(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+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: ...
+def async_register_ice_servers(hass: HomeAssistant, get_ice_server_fn: Callable[[], Iterable[RTCIceServer]]) -> Callable[[], None]: ...
+
+_RTSP_PREFIXES: Incomplete
+type RtspToWebRtcProviderType = Callable[[str, str, str], Awaitable[str | None]]
+
+class _CameraRtspToWebRTCProvider(CameraWebRTCLegacyProvider):
+    _fn: Incomplete
+    def __init__(self, fn: RtspToWebRtcProviderType) -> None: ...
+    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: ...
+
+def async_register_rtsp_to_web_rtc_provider(hass: HomeAssistant, domain: str, provider: RtspToWebRtcProviderType) -> Callable[[], None]: ...
+def _async_check_conflicting_legacy_provider(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/canary/alarm_control_panel.pyi

@@ -2,9 +2,8 @@ from .const import DATA_COORDINATOR as DATA_COORDINATOR, DOMAIN as DOMAIN
 from .coordinator import CanaryDataUpdateCoordinator as CanaryDataUpdateCoordinator
 from _typeshed import Incomplete
 from canary.model import Location as Location
-from homeassistant.components.alarm_control_panel import AlarmControlPanelEntity as AlarmControlPanelEntity, AlarmControlPanelEntityFeature as AlarmControlPanelEntityFeature
+from homeassistant.components.alarm_control_panel import AlarmControlPanelEntity as AlarmControlPanelEntity, AlarmControlPanelEntityFeature as AlarmControlPanelEntityFeature, AlarmControlPanelState as AlarmControlPanelState
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import STATE_ALARM_ARMED_AWAY as STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME as STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT as STATE_ALARM_ARMED_NIGHT, STATE_ALARM_DISARMED as STATE_ALARM_DISARMED
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
@@ -22,7 +21,7 @@ class CanaryAlarm(CoordinatorEntity[CanaryDataUpdateCoordinator], AlarmControlPa
     @property
     def location(self) -> Location: ...
     @property
-    def state(self) -> str | None: ...
+    def alarm_state(self) -> AlarmControlPanelState | None: ...
     @property
     def extra_state_attributes(self) -> dict[str, Any]: ...
     def alarm_disarm(self, code: str | None = None) -> None: ...

homeassistant-stubs/components/canary/sensor.pyi

@@ -11,6 +11,7 @@ from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEnti
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
 from typing import Final
 
+type SensorTypeItem = tuple[str, str | None, str | None, SensorDeviceClass | None, list[str]]
 SENSOR_VALUE_PRECISION: Final[int]
 ATTR_AIR_QUALITY: Final[str]
 CANARY_PRO: Final[str]

homeassistant-stubs/components/cert_expiry/__init__.pyi

@@ -6,6 +6,7 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.start import async_at_started as async_at_started
 
 PLATFORMS: Incomplete
+type CertExpiryConfigEntry = ConfigEntry[CertExpiryDataUpdateCoordinator]
 
 async def async_setup_entry(hass: HomeAssistant, entry: CertExpiryConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...

homeassistant-stubs/components/climate/__init__.pyi

@@ -1,7 +1,6 @@
 import asyncio
 from .const import ATTR_AUX_HEAT as ATTR_AUX_HEAT, ATTR_CURRENT_HUMIDITY as ATTR_CURRENT_HUMIDITY, ATTR_CURRENT_TEMPERATURE as ATTR_CURRENT_TEMPERATURE, ATTR_FAN_MODE as ATTR_FAN_MODE, ATTR_FAN_MODES as ATTR_FAN_MODES, ATTR_HUMIDITY as ATTR_HUMIDITY, ATTR_HVAC_ACTION as ATTR_HVAC_ACTION, ATTR_HVAC_MODE as ATTR_HVAC_MODE, ATTR_HVAC_MODES as ATTR_HVAC_MODES, ATTR_MAX_HUMIDITY as ATTR_MAX_HUMIDITY, ATTR_MAX_TEMP as ATTR_MAX_TEMP, ATTR_MIN_HUMIDITY as ATTR_MIN_HUMIDITY, ATTR_MIN_TEMP as ATTR_MIN_TEMP, ATTR_PRESET_MODE as ATTR_PRESET_MODE, ATTR_PRESET_MODES as ATTR_PRESET_MODES, ATTR_SWING_MODE as ATTR_SWING_MODE, ATTR_SWING_MODES as ATTR_SWING_MODES, ATTR_TARGET_TEMP_HIGH as ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW as ATTR_TARGET_TEMP_LOW, ATTR_TARGET_TEMP_STEP as ATTR_TARGET_TEMP_STEP, ClimateEntityFeature as ClimateEntityFeature, DOMAIN as DOMAIN, FAN_AUTO as FAN_AUTO, FAN_DIFFUSE as FAN_DIFFUSE, FAN_FOCUS as FAN_FOCUS, FAN_HIGH as FAN_HIGH, FAN_LOW as FAN_LOW, FAN_MEDIUM as FAN_MEDIUM, FAN_MIDDLE as FAN_MIDDLE, FAN_OFF as FAN_OFF, FAN_ON as FAN_ON, FAN_TOP as FAN_TOP, HVACAction as HVACAction, HVACMode as HVACMode, HVAC_MODES as HVAC_MODES, INTENT_GET_TEMPERATURE as INTENT_GET_TEMPERATURE, PRESET_ACTIVITY as PRESET_ACTIVITY, PRESET_AWAY as PRESET_AWAY, PRESET_BOOST as PRESET_BOOST, PRESET_COMFORT as PRESET_COMFORT, PRESET_ECO as PRESET_ECO, PRESET_HOME as PRESET_HOME, PRESET_NONE as PRESET_NONE, PRESET_SLEEP as PRESET_SLEEP, SERVICE_SET_AUX_HEAT as SERVICE_SET_AUX_HEAT, SERVICE_SET_FAN_MODE as SERVICE_SET_FAN_MODE, SERVICE_SET_HUMIDITY as SERVICE_SET_HUMIDITY, SERVICE_SET_HVAC_MODE as SERVICE_SET_HVAC_MODE, SERVICE_SET_PRESET_MODE as SERVICE_SET_PRESET_MODE, SERVICE_SET_SWING_MODE as SERVICE_SET_SWING_MODE, SERVICE_SET_TEMPERATURE as SERVICE_SET_TEMPERATURE, SWING_BOTH as SWING_BOTH, SWING_HORIZONTAL as SWING_HORIZONTAL, SWING_OFF as SWING_OFF, SWING_ON as SWING_ON, SWING_VERTICAL as SWING_VERTICAL, _DEPRECATED_HVAC_MODE_AUTO as _DEPRECATED_HVAC_MODE_AUTO, _DEPRECATED_HVAC_MODE_COOL as _DEPRECATED_HVAC_MODE_COOL, _DEPRECATED_HVAC_MODE_DRY as _DEPRECATED_HVAC_MODE_DRY, _DEPRECATED_HVAC_MODE_FAN_ONLY as _DEPRECATED_HVAC_MODE_FAN_ONLY, _DEPRECATED_HVAC_MODE_HEAT as _DEPRECATED_HVAC_MODE_HEAT, _DEPRECATED_HVAC_MODE_HEAT_COOL as _DEPRECATED_HVAC_MODE_HEAT_COOL, _DEPRECATED_HVAC_MODE_OFF as _DEPRECATED_HVAC_MODE_OFF, _DEPRECATED_SUPPORT_AUX_HEAT as _DEPRECATED_SUPPORT_AUX_HEAT, _DEPRECATED_SUPPORT_FAN_MODE as _DEPRECATED_SUPPORT_FAN_MODE, _DEPRECATED_SUPPORT_PRESET_MODE as _DEPRECATED_SUPPORT_PRESET_MODE, _DEPRECATED_SUPPORT_SWING_MODE as _DEPRECATED_SUPPORT_SWING_MODE, _DEPRECATED_SUPPORT_TARGET_HUMIDITY as _DEPRECATED_SUPPORT_TARGET_HUMIDITY, _DEPRECATED_SUPPORT_TARGET_TEMPERATURE as _DEPRECATED_SUPPORT_TARGET_TEMPERATURE, _DEPRECATED_SUPPORT_TARGET_TEMPERATURE_RANGE as _DEPRECATED_SUPPORT_TARGET_TEMPERATURE_RANGE
 from _typeshed import Incomplete
-from functools import cached_property as cached_property
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import ATTR_TEMPERATURE as ATTR_TEMPERATURE, PRECISION_TENTHS as PRECISION_TENTHS, PRECISION_WHOLE as PRECISION_WHOLE, SERVICE_TOGGLE as SERVICE_TOGGLE, SERVICE_TURN_OFF as SERVICE_TURN_OFF, SERVICE_TURN_ON as SERVICE_TURN_ON, STATE_OFF as STATE_OFF, STATE_ON as STATE_ON, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback
@@ -81,41 +80,23 @@ class ClimateEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     def capability_attributes(self) -> dict[str, Any] | None: ...
     @property
     def state_attributes(self) -> dict[str, Any]: ...
-    @cached_property
     def temperature_unit(self) -> str: ...
-    @cached_property
     def current_humidity(self) -> float | None: ...
-    @cached_property
     def target_humidity(self) -> float | None: ...
-    @cached_property
     def hvac_mode(self) -> HVACMode | None: ...
-    @cached_property
     def hvac_modes(self) -> list[HVACMode]: ...
-    @cached_property
     def hvac_action(self) -> HVACAction | None: ...
-    @cached_property
     def current_temperature(self) -> float | None: ...
-    @cached_property
     def target_temperature(self) -> float | None: ...
-    @cached_property
     def target_temperature_step(self) -> float | None: ...
-    @cached_property
     def target_temperature_high(self) -> float | None: ...
-    @cached_property
     def target_temperature_low(self) -> float | None: ...
-    @cached_property
     def preset_mode(self) -> str | None: ...
-    @cached_property
     def preset_modes(self) -> list[str] | None: ...
-    @cached_property
     def is_aux_heat(self) -> bool | None: ...
-    @cached_property
     def fan_mode(self) -> str | None: ...
-    @cached_property
     def fan_modes(self) -> list[str] | None: ...
-    @cached_property
     def swing_mode(self) -> str | None: ...
-    @cached_property
     def swing_modes(self) -> list[str] | None: ...
     def _valid_mode_or_raise(self, mode_type: Literal['preset', 'swing', 'fan', 'hvac'], mode: str | HVACMode, modes: list[str] | list[HVACMode] | None) -> None: ...
     def set_temperature(self, **kwargs: Any) -> None: ...
@@ -144,15 +125,10 @@ class ClimateEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     async def async_turn_off(self) -> None: ...
     def toggle(self) -> None: ...
     async def async_toggle(self) -> None: ...
-    @cached_property
     def supported_features(self) -> ClimateEntityFeature: ...
-    @cached_property
     def min_temp(self) -> float: ...
-    @cached_property
     def max_temp(self) -> float: ...
-    @cached_property
     def min_humidity(self) -> float: ...
-    @cached_property
     def max_humidity(self) -> float: ...
 
 async def async_service_aux_heat(entity: ClimateEntity, service_call: ServiceCall) -> None: ...