homeassistant-stubs 2025.4.0b9__py3-none-any.whl → 2026.1.0b0__py3-none-any.whl

homeassistant-stubs/components/backblaze_b2/repairs.pyi

@@ -0,0 +1,15 @@
+from .const import CONF_BUCKET as CONF_BUCKET, DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from homeassistant.components.repairs import ConfirmRepairFlow as ConfirmRepairFlow
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+
+_LOGGER: Incomplete
+ISSUE_BUCKET_ACCESS_RESTRICTED: str
+ISSUE_BUCKET_NOT_FOUND: str
+
+def _create_issue(hass: HomeAssistant, entry: ConfigEntry, issue_type: str, bucket_name: str) -> None: ...
+def create_bucket_access_restricted_issue(hass: HomeAssistant, entry: ConfigEntry, bucket_name: str) -> None: ...
+def create_bucket_not_found_issue(hass: HomeAssistant, entry: ConfigEntry, bucket_name: str) -> None: ...
+async def async_check_for_repair_issues(hass: HomeAssistant, entry: ConfigEntry) -> None: ...
+async def async_create_fix_flow(hass: HomeAssistant, issue_id: str, data: dict[str, str | int | float | None] | None) -> ConfirmRepairFlow: ...

homeassistant-stubs/components/backup/__init__.pyi

@@ -1,7 +1,11 @@
 from .agent import BackupAgent as BackupAgent, BackupAgentError as BackupAgentError, BackupAgentPlatformProtocol as BackupAgentPlatformProtocol, LocalBackupAgent as LocalBackupAgent
 from .config import BackupConfig as BackupConfig, CreateBackupParametersDict as CreateBackupParametersDict
-from .manager import BackupManagerError as BackupManagerError, BackupPlatformEvent as BackupPlatformEvent, BackupPlatformProtocol as BackupPlatformProtocol, BackupReaderWriter as BackupReaderWriter, BackupReaderWriterError as BackupReaderWriterError, CreateBackupEvent as CreateBackupEvent, CreateBackupStage as CreateBackupStage, CreateBackupState as CreateBackupState, IdleEvent as IdleEvent, IncorrectPasswordError as IncorrectPasswordError, ManagerBackup as ManagerBackup, ManagerStateEvent as ManagerStateEvent, NewBackup as NewBackup, RestoreBackupEvent as RestoreBackupEvent, RestoreBackupStage as RestoreBackupStage, RestoreBackupState as RestoreBackupState, WrittenBackup as WrittenBackup
+from .manager import AddonErrorData as AddonErrorData, BackupManager, BackupManagerError as BackupManagerError, BackupPlatformEvent as BackupPlatformEvent, BackupPlatformProtocol as BackupPlatformProtocol, BackupReaderWriter as BackupReaderWriter, BackupReaderWriterError as BackupReaderWriterError, CreateBackupEvent as CreateBackupEvent, CreateBackupStage as CreateBackupStage, CreateBackupState as CreateBackupState, IdleEvent as IdleEvent, IncorrectPasswordError as IncorrectPasswordError, ManagerBackup as ManagerBackup, NewBackup as NewBackup, RestoreBackupEvent as RestoreBackupEvent, RestoreBackupStage as RestoreBackupStage, RestoreBackupState as RestoreBackupState, WrittenBackup as WrittenBackup
 from .models import AddonInfo as AddonInfo, AgentBackup as AgentBackup, BackupNotFound as BackupNotFound, Folder as Folder
 from .util import suggested_filename as suggested_filename, suggested_filename_from_name_date as suggested_filename_from_name_date
+from homeassistant.core import HomeAssistant, callback
 
-__all__ = ['AddonInfo', 'AgentBackup', 'BackupAgent', 'BackupAgentError', 'BackupAgentPlatformProtocol', 'BackupConfig', 'BackupManagerError', 'BackupNotFound', 'BackupPlatformEvent', 'BackupPlatformProtocol', 'BackupReaderWriter', 'BackupReaderWriterError', 'CreateBackupEvent', 'CreateBackupParametersDict', 'CreateBackupStage', 'CreateBackupState', 'Folder', 'IdleEvent', 'IncorrectPasswordError', 'LocalBackupAgent', 'ManagerBackup', 'ManagerStateEvent', 'NewBackup', 'RestoreBackupEvent', 'RestoreBackupStage', 'RestoreBackupState', 'WrittenBackup', 'suggested_filename', 'suggested_filename_from_name_date']
+__all__ = ['AddonErrorData', 'AddonInfo', 'AgentBackup', 'BackupAgent', 'BackupAgentError', 'BackupAgentPlatformProtocol', 'BackupConfig', 'BackupManagerError', 'BackupNotFound', 'BackupPlatformEvent', 'BackupPlatformProtocol', 'BackupReaderWriter', 'BackupReaderWriterError', 'CreateBackupEvent', 'CreateBackupParametersDict', 'CreateBackupStage', 'CreateBackupState', 'Folder', 'IdleEvent', 'IncorrectPasswordError', 'LocalBackupAgent', 'ManagerBackup', 'NewBackup', 'RestoreBackupEvent', 'RestoreBackupStage', 'RestoreBackupState', 'WrittenBackup', 'async_get_manager', 'suggested_filename', 'suggested_filename_from_name_date']
+
+@callback
+def async_get_manager(hass: HomeAssistant) -> BackupManager: ...

homeassistant-stubs/components/backup/config.pyi

@@ -52,20 +52,26 @@ class BackupConfig:
 @dataclass(kw_only=True)
 class AgentConfig:
     protected: bool
+    retention: AgentRetentionConfig | None = ...
     def to_dict(self) -> StoredAgentConfig: ...
 
 class StoredAgentConfig(TypedDict):
     protected: bool
+    retention: StoredRetentionConfig | None
 
 class AgentParametersDict(TypedDict, total=False):
     protected: bool
+    retention: RetentionParametersDict | None
 
 @dataclass(kw_only=True)
-class RetentionConfig:
+class BaseRetentionConfig:
     copies: int | None = ...
     days: int | None = ...
-    def apply(self, manager: BackupManager) -> None: ...
     def to_dict(self) -> StoredRetentionConfig: ...
+
+@dataclass(kw_only=True)
+class RetentionConfig(BaseRetentionConfig):
+    def apply(self, manager: BackupManager) -> None: ...
     @callback
     def _schedule_next(self, manager: BackupManager) -> None: ...
     @callback
@@ -79,16 +85,16 @@ class RetentionParametersDict(TypedDict, total=False):
     copies: int | None
     days: int | None
 
+class AgentRetentionConfig(BaseRetentionConfig): ...
+
 class StoredBackupSchedule(TypedDict):
     days: list[Day]
     recurrence: ScheduleRecurrence
-    state: ScheduleState
     time: str | None
 
 class ScheduleParametersDict(TypedDict, total=False):
     days: list[Day]
     recurrence: ScheduleRecurrence
-    state: ScheduleState
     time: dt.time | None
 
 class Day(StrEnum):
@@ -105,22 +111,10 @@ class ScheduleRecurrence(StrEnum):
     DAILY = 'daily'
     CUSTOM_DAYS = 'custom_days'
 
-class ScheduleState(StrEnum):
-    NEVER = 'never'
-    DAILY = 'daily'
-    MONDAY = 'mon'
-    TUESDAY = 'tue'
-    WEDNESDAY = 'wed'
-    THURSDAY = 'thu'
-    FRIDAY = 'fri'
-    SATURDAY = 'sat'
-    SUNDAY = 'sun'
-
 @dataclass(kw_only=True)
 class BackupSchedule:
     days: list[Day] = field(default_factory=list)
     recurrence: ScheduleRecurrence = ...
-    state: ScheduleState = ...
     time: dt.time | None = ...
     cron_event: CronSim | None = field(init=False, default=None)
     next_automatic_backup: datetime | None = field(init=False, default=None)

homeassistant-stubs/components/backup/coordinator.pyi

@@ -6,20 +6,22 @@ from dataclasses import dataclass
 from datetime import datetime
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.helpers.backup import async_subscribe_events as async_subscribe_events, async_subscribe_platform_events as async_subscribe_platform_events
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator
 
 type BackupConfigEntry = ConfigEntry[BackupDataUpdateCoordinator]
 @dataclass
 class BackupCoordinatorData:
     backup_manager_state: BackupManagerState
+    last_attempted_automatic_backup: datetime | None
     last_successful_automatic_backup: datetime | None
     next_scheduled_automatic_backup: datetime | None
+    last_event: ManagerStateEvent | BackupPlatformEvent | None
 
 class BackupDataUpdateCoordinator(DataUpdateCoordinator[BackupCoordinatorData]):
     config_entry: ConfigEntry
     unsubscribe: list[Callable[[], None]]
     backup_manager: Incomplete
+    _last_event: ManagerStateEvent | BackupPlatformEvent | None
     def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry, backup_manager: BackupManager) -> None: ...
     @callback
     def _on_event(self, event: ManagerStateEvent | BackupPlatformEvent) -> None: ...

homeassistant-stubs/components/backup/entity.pyi

@@ -5,9 +5,12 @@ from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntry
 from homeassistant.helpers.entity import EntityDescription as EntityDescription
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
 
-class BackupManagerEntity(CoordinatorEntity[BackupDataUpdateCoordinator]):
+class BackupManagerBaseEntity(CoordinatorEntity[BackupDataUpdateCoordinator]):
     _attr_has_entity_name: bool
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: BackupDataUpdateCoordinator) -> None: ...
+
+class BackupManagerEntity(BackupManagerBaseEntity):
     entity_description: Incomplete
     _attr_unique_id: Incomplete
-    _attr_device_info: Incomplete
     def __init__(self, coordinator: BackupDataUpdateCoordinator, entity_description: EntityDescription) -> None: ...

homeassistant-stubs/components/backup/event.pyi

@@ -0,0 +1,23 @@
+from .coordinator import BackupConfigEntry as BackupConfigEntry, BackupDataUpdateCoordinator as BackupDataUpdateCoordinator
+from .entity import BackupManagerBaseEntity as BackupManagerBaseEntity
+from .manager import CreateBackupEvent as CreateBackupEvent, CreateBackupState as CreateBackupState
+from _typeshed import Incomplete
+from homeassistant.components.event import EventEntity as EventEntity
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from typing import Final
+
+ATTR_BACKUP_STAGE: Final[str]
+ATTR_FAILED_REASON: Final[str]
+
+async def async_setup_entry(hass: HomeAssistant, config_entry: BackupConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class AutomaticBackupEvent(BackupManagerBaseEntity, EventEntity):
+    _attr_event_types: Incomplete
+    _unrecorded_attributes: Incomplete
+    coordinator: BackupDataUpdateCoordinator
+    _attr_unique_id: str
+    _attr_translation_key: str
+    def __init__(self, coordinator: BackupDataUpdateCoordinator) -> None: ...
+    @callback
+    def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/components/backup/http.pyi

@@ -2,13 +2,14 @@ from . import util as util
 from .agent import BackupAgent as BackupAgent
 from .const import DATA_MANAGER as DATA_MANAGER
 from .manager import BackupManager as BackupManager
-from .models import BackupNotFound as BackupNotFound
+from .models import AgentBackup as AgentBackup, BackupNotFound as BackupNotFound
 from aiohttp.web import FileResponse, Request as Request, Response, StreamResponse
 from homeassistant.components.http import HomeAssistantView as HomeAssistantView, KEY_HASS as KEY_HASS, require_admin as require_admin
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers import frame as frame
 from homeassistant.util import slugify as slugify
+from homeassistant.util.async_iterator import AsyncIteratorReader as AsyncIteratorReader, AsyncIteratorWriter as AsyncIteratorWriter
 from multidict import istr
 
 @callback
@@ -19,7 +20,7 @@ class DownloadBackupView(HomeAssistantView):
     name: str
     async def get(self, request: Request, backup_id: str) -> StreamResponse | FileResponse | Response: ...
     async def _send_backup_no_password(self, request: Request, headers: dict[istr, str], backup_id: str, agent_id: str, agent: BackupAgent, manager: BackupManager) -> StreamResponse | FileResponse | Response: ...
-    async def _send_backup_with_password(self, hass: HomeAssistant, request: Request, headers: dict[istr, str], backup_id: str, agent_id: str, password: str, agent: BackupAgent, manager: BackupManager) -> StreamResponse | FileResponse | Response: ...
+    async def _send_backup_with_password(self, hass: HomeAssistant, backup: AgentBackup, request: Request, headers: dict[istr, str], backup_id: str, agent_id: str, password: str, agent: BackupAgent, manager: BackupManager) -> StreamResponse | FileResponse | Response: ...
 
 class UploadBackupView(HomeAssistantView):
     url: str

homeassistant-stubs/components/backup/manager.pyi

@@ -4,9 +4,9 @@ import asyncio
 from .agent import BackupAgent as BackupAgent, BackupAgentError as BackupAgentError, BackupAgentPlatformProtocol as BackupAgentPlatformProtocol, LocalBackupAgent as LocalBackupAgent
 from .config import BackupConfig as BackupConfig, CreateBackupParametersDict as CreateBackupParametersDict, check_unavailable_agents as check_unavailable_agents, delete_backups_exceeding_configured_count as delete_backups_exceeding_configured_count
 from .const import BUF_SIZE as BUF_SIZE, DATA_MANAGER as DATA_MANAGER, DOMAIN as DOMAIN, EXCLUDE_DATABASE_FROM_BACKUP as EXCLUDE_DATABASE_FROM_BACKUP, EXCLUDE_FROM_BACKUP as EXCLUDE_FROM_BACKUP, LOGGER as LOGGER
-from .models import AgentBackup as AgentBackup, BackupError as BackupError, BackupManagerError as BackupManagerError, BackupNotFound as BackupNotFound, BackupReaderWriterError as BackupReaderWriterError, BaseBackup as BaseBackup, Folder as Folder
+from .models import AddonInfo as AddonInfo, AgentBackup as AgentBackup, BackupError as BackupError, BackupManagerError as BackupManagerError, BackupNotFound as BackupNotFound, BackupReaderWriterError as BackupReaderWriterError, BaseBackup as BaseBackup, Folder as Folder
 from .store import BackupStore as BackupStore
-from .util import AsyncIteratorReader as AsyncIteratorReader, DecryptedBackupStreamer as DecryptedBackupStreamer, EncryptedBackupStreamer as EncryptedBackupStreamer, make_backup_dir as make_backup_dir, read_backup as read_backup, validate_password as validate_password, validate_password_stream as validate_password_stream
+from .util import DecryptedBackupStreamer as DecryptedBackupStreamer, EncryptedBackupStreamer as EncryptedBackupStreamer, make_backup_dir as make_backup_dir, read_backup as read_backup, validate_password as validate_password, validate_password_stream as validate_password_stream
 from _typeshed import Incomplete
 from collections.abc import AsyncIterator, Callable as Callable, Coroutine
 from dataclasses import dataclass
@@ -14,8 +14,8 @@ from enum import StrEnum
 from homeassistant.backup_restore import RESTORE_BACKUP_FILE as RESTORE_BACKUP_FILE, RESTORE_BACKUP_RESULT_FILE as RESTORE_BACKUP_RESULT_FILE, password_to_key as password_to_key
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers import frame as frame, instance_id as instance_id, integration_platform as integration_platform, start as start
-from homeassistant.helpers.backup import DATA_BACKUP as DATA_BACKUP
 from homeassistant.helpers.json import json_bytes as json_bytes
+from homeassistant.util.async_iterator import AsyncIteratorReader as AsyncIteratorReader
 from pathlib import Path
 from typing import Any, Protocol, TypedDict
 
@@ -31,12 +31,21 @@ class AgentBackupStatus:
 @dataclass(frozen=True, kw_only=True, slots=True)
 class ManagerBackup(BaseBackup):
     agents: dict[str, AgentBackupStatus]
+    failed_addons: list[AddonInfo]
     failed_agent_ids: list[str]
+    failed_folders: list[Folder]
     with_automatic_settings: bool | None
 
+@dataclass(frozen=True, kw_only=True, slots=True)
+class AddonErrorData:
+    addon: AddonInfo
+    errors: list[tuple[str, str]]
+
 @dataclass(frozen=True, kw_only=True, slots=True)
 class WrittenBackup:
+    addon_errors: dict[str, AddonErrorData]
     backup: AgentBackup
+    folder_errors: dict[Folder, list[tuple[str, str]]]
     open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]]
     release_stream: Callable[[], Coroutine[Any, Any, None]]
 
@@ -169,8 +178,8 @@ class BackupManager:
     remove_next_delete_event: Callable[[], None] | None
     last_event: ManagerStateEvent
     last_action_event: ManagerStateEvent | None
-    _backup_event_subscriptions: Incomplete
-    _backup_platform_event_subscriptions: Incomplete
+    _backup_event_subscriptions: list[Callable[[ManagerStateEvent], None]]
+    _backup_platform_event_subscriptions: list[Callable[[BackupPlatformEvent], None]]
     def __init__(self, hass: HomeAssistant, reader_writer: BackupReaderWriter) -> None: ...
     async def async_setup(self) -> None: ...
     @property
@@ -202,8 +211,13 @@ class BackupManager:
     async def _async_restore_backup(self, backup_id: str, *, agent_id: str, password: str | None, restore_addons: list[str] | None, restore_database: bool, restore_folders: list[Folder] | None, restore_homeassistant: bool) -> None: ...
     @callback
     def async_on_backup_event(self, event: ManagerStateEvent) -> None: ...
+    @callback
+    def async_subscribe_events(self, on_event: Callable[[ManagerStateEvent], None]) -> Callable[[], None]: ...
+    @callback
+    def async_subscribe_platform_events(self, on_event: Callable[[BackupPlatformEvent], None]) -> Callable[[], None]: ...
+    def _create_automatic_backup_failed_issue(self, translation_key: str, translation_placeholders: dict[str, str] | None) -> None: ...
     def _update_issue_backup_failed(self) -> None: ...
-    def _update_issue_after_agent_upload(self, agent_errors: dict[str, Exception], unavailable_agents: list[str]) -> None: ...
+    def _update_issue_after_agent_upload(self, written_backup: WrittenBackup, agent_errors: dict[str, Exception], unavailable_agents: list[str]) -> None: ...
     async def async_can_decrypt_on_download(self, backup_id: str, *, agent_id: str, password: str | None) -> None: ...
 
 class KnownBackups:
@@ -212,19 +226,28 @@ class KnownBackups:
     def __init__(self, manager: BackupManager) -> None: ...
     def load(self, stored_backups: list[StoredKnownBackup]) -> None: ...
     def to_list(self) -> list[StoredKnownBackup]: ...
-    def add(self, backup: AgentBackup, agent_errors: dict[str, Exception], unavailable_agents: list[str]) -> None: ...
+    def add(self, backup: AgentBackup, agent_errors: dict[str, Exception], failed_addons: dict[str, AddonErrorData], failed_folders: dict[Folder, list[tuple[str, str]]], unavailable_agents: list[str]) -> None: ...
     def get(self, backup_id: str) -> KnownBackup | None: ...
     def remove(self, backup_id: str) -> None: ...
 
 @dataclass(kw_only=True)
 class KnownBackup:
     backup_id: str
+    failed_addons: list[AddonInfo]
     failed_agent_ids: list[str]
+    failed_folders: list[Folder]
     def to_dict(self) -> StoredKnownBackup: ...
 
+class StoredAddonInfo(TypedDict):
+    name: str | None
+    slug: str
+    version: str | None
+
 class StoredKnownBackup(TypedDict):
     backup_id: str
+    failed_addons: list[StoredAddonInfo]
     failed_agent_ids: list[str]
+    failed_folders: list[str]
 
 class CoreBackupReaderWriter(BackupReaderWriter):
     _local_agent_id: Incomplete

homeassistant-stubs/components/backup/models.pyi

@@ -5,9 +5,9 @@ from typing import Any, Self
 
 @dataclass(frozen=True, kw_only=True)
 class AddonInfo:
-    name: str
+    name: str | None
     slug: str
-    version: str
+    version: str | None
 
 class Folder(StrEnum):
     SHARE = 'share'

homeassistant-stubs/components/backup/onboarding.pyi

@@ -0,0 +1,30 @@
+from . import BackupManager as BackupManager, Folder as Folder, IncorrectPasswordError as IncorrectPasswordError, async_get_manager as async_get_manager, http as backup_http
+from aiohttp import web
+from collections.abc import Callable as Callable, Coroutine
+from homeassistant.components.http import KEY_HASS as KEY_HASS
+from homeassistant.components.http.data_validator import RequestDataValidator as RequestDataValidator
+from homeassistant.components.onboarding import BaseOnboardingView as BaseOnboardingView, NoAuthBaseOnboardingView as NoAuthBaseOnboardingView, OnboardingStoreData as OnboardingStoreData
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from typing import Any, Concatenate
+
+async def async_setup_views(hass: HomeAssistant, data: OnboardingStoreData) -> None: ...
+def with_backup_manager[_ViewT: BaseOnboardingView, **_P](func: Callable[Concatenate[_ViewT, BackupManager, web.Request, _P], Coroutine[Any, Any, web.Response]]) -> Callable[Concatenate[_ViewT, web.Request, _P], Coroutine[Any, Any, web.Response]]: ...
+
+class BackupInfoView(NoAuthBaseOnboardingView):
+    url: str
+    name: str
+    @with_backup_manager
+    async def get(self, manager: BackupManager, request: web.Request) -> web.Response: ...
+
+class RestoreBackupView(NoAuthBaseOnboardingView):
+    url: str
+    name: str
+    @with_backup_manager
+    async def post(self, manager: BackupManager, request: web.Request, data: dict[str, Any]) -> web.Response: ...
+
+class UploadBackupView(NoAuthBaseOnboardingView, backup_http.UploadBackupView):
+    url: str
+    name: str
+    @with_backup_manager
+    async def post(self, manager: BackupManager, request: web.Request) -> web.Response: ...

homeassistant-stubs/components/backup/services.pyi

@@ -0,0 +1,7 @@
+from .const import DATA_MANAGER as DATA_MANAGER, DOMAIN as DOMAIN
+from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall
+from homeassistant.helpers.hassio import is_hassio as is_hassio
+
+async def _async_handle_create_service(call: ServiceCall) -> None: ...
+async def _async_handle_create_automatic_service(call: ServiceCall) -> None: ...
+def async_setup_services(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/backup/util.pyi

@@ -6,14 +6,14 @@ from .const import BUF_SIZE as BUF_SIZE, LOGGER as LOGGER
 from .models import AddonInfo as AddonInfo, AgentBackup as AgentBackup, Folder as Folder
 from _typeshed import Incomplete
 from collections.abc import AsyncIterator, Callable as Callable, Coroutine
-from concurrent.futures import Future
 from dataclasses import dataclass
 from homeassistant.backup_restore import password_to_key as password_to_key
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.util.async_iterator import Abort as Abort, AsyncIteratorReader as AsyncIteratorReader, AsyncIteratorWriter as AsyncIteratorWriter
 from homeassistant.util.json import JsonObjectType as JsonObjectType, json_loads_object as json_loads_object
 from pathlib import Path
-from typing import Any, IO, Self
+from typing import Any, IO
 
 class DecryptError(HomeAssistantError):
     _message: str
@@ -30,46 +30,17 @@ class IncorrectPassword(DecryptError):
 class BackupEmpty(DecryptError):
     _message: str
 
-class AbortCipher(HomeAssistantError):
-    _message: str
-
 def make_backup_dir(path: Path) -> None: ...
 def read_backup(backup_path: Path) -> AgentBackup: ...
 def suggested_filename_from_name_date(name: str, date_str: str) -> str: ...
 def suggested_filename(backup: AgentBackup) -> str: ...
 def validate_password(path: Path, password: str | None) -> bool: ...
-
-class AsyncIteratorReader:
-    _aborted: bool
-    _hass: Incomplete
-    _stream: Incomplete
-    _buffer: bytes | None
-    _next_future: Future[bytes | None] | None
-    _pos: int
-    def __init__(self, hass: HomeAssistant, stream: AsyncIterator[bytes]) -> None: ...
-    async def _next(self) -> bytes | None: ...
-    def abort(self) -> None: ...
-    def read(self, n: int = -1, /) -> bytes: ...
-    def close(self) -> None: ...
-
-class AsyncIteratorWriter:
-    _aborted: bool
-    _hass: Incomplete
-    _pos: int
-    _queue: asyncio.Queue[bytes | None]
-    _write_future: Future[bytes | None] | None
-    def __init__(self, hass: HomeAssistant) -> None: ...
-    def __aiter__(self) -> Self: ...
-    async def __anext__(self) -> bytes: ...
-    def abort(self) -> None: ...
-    def tell(self) -> int: ...
-    def write(self, s: bytes, /) -> int: ...
-
 def validate_password_stream(input_stream: IO[bytes], password: str | None) -> None: ...
-def decrypt_backup(input_stream: IO[bytes], output_stream: IO[bytes], password: str | None, on_done: Callable[[Exception | None], None], minimum_size: int, nonces: list[bytes]) -> None: ...
-def _decrypt_backup(input_tar: tarfile.TarFile, output_tar: tarfile.TarFile, password: str | None) -> None: ...
-def encrypt_backup(input_stream: IO[bytes], output_stream: IO[bytes], password: str | None, on_done: Callable[[Exception | None], None], minimum_size: int, nonces: list[bytes]) -> None: ...
-def _encrypt_backup(input_tar: tarfile.TarFile, output_tar: tarfile.TarFile, password: str | None, nonces: list[bytes]) -> None: ...
+def _get_expected_archives(backup: AgentBackup) -> set[str]: ...
+def decrypt_backup(backup: AgentBackup, input_stream: IO[bytes], output_stream: IO[bytes], password: str | None, on_done: Callable[[Exception | None], None], minimum_size: int, nonces: NonceGenerator) -> None: ...
+def _decrypt_backup(backup: AgentBackup, input_tar: tarfile.TarFile, output_tar: tarfile.TarFile, password: str | None) -> None: ...
+def encrypt_backup(backup: AgentBackup, input_stream: IO[bytes], output_stream: IO[bytes], password: str | None, on_done: Callable[[Exception | None], None], minimum_size: int, nonces: NonceGenerator) -> None: ...
+def _encrypt_backup(backup: AgentBackup, input_tar: tarfile.TarFile, output_tar: tarfile.TarFile, password: str | None, nonces: NonceGenerator) -> None: ...
 
 @dataclass(kw_only=True)
 class _CipherWorkerStatus:
@@ -79,14 +50,19 @@ class _CipherWorkerStatus:
     thread: threading.Thread
     writer: AsyncIteratorWriter
 
+class NonceGenerator:
+    _nonces: dict[int, bytes]
+    def __init__(self) -> None: ...
+    def get(self, index: int) -> bytes: ...
+
 class _CipherBackupStreamer:
-    _cipher_func: Callable[[IO[bytes], IO[bytes], str | None, Callable[[Exception | None], None], int, list[bytes]], None]
+    _cipher_func: Callable[[AgentBackup, IO[bytes], IO[bytes], str | None, Callable[[Exception | None], None], int, NonceGenerator], None]
     _workers: list[_CipherWorkerStatus]
     _backup: Incomplete
     _hass: Incomplete
     _open_stream: Incomplete
     _password: Incomplete
-    _nonces: list[bytes]
+    _nonces: Incomplete
     def __init__(self, hass: HomeAssistant, backup: AgentBackup, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], password: str | None) -> None: ...
     def size(self) -> int: ...
     def _num_tar_files(self) -> int: ...
@@ -98,8 +74,6 @@ class DecryptedBackupStreamer(_CipherBackupStreamer):
     def backup(self) -> AgentBackup: ...
 
 class EncryptedBackupStreamer(_CipherBackupStreamer):
-    _nonces: Incomplete
-    def __init__(self, hass: HomeAssistant, backup: AgentBackup, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], password: str | None) -> None: ...
     _cipher_func: Incomplete
     def backup(self) -> AgentBackup: ...
 

homeassistant-stubs/components/backup/websocket.pyi

@@ -1,6 +1,6 @@
 from .config import Day as Day, ScheduleRecurrence as ScheduleRecurrence
 from .const import DATA_MANAGER as DATA_MANAGER, LOGGER as LOGGER
-from .manager import DecryptOnDowloadNotSupported as DecryptOnDowloadNotSupported, IncorrectPasswordError as IncorrectPasswordError
+from .manager import DecryptOnDowloadNotSupported as DecryptOnDowloadNotSupported, IncorrectPasswordError as IncorrectPasswordError, ManagerStateEvent as ManagerStateEvent
 from .models import BackupNotFound as BackupNotFound, Folder as Folder
 from homeassistant.components import websocket_api as websocket_api
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
@@ -42,3 +42,6 @@ async def handle_config_info(hass: HomeAssistant, connection: websocket_api.Acti
 @callback
 @websocket_api.require_admin
 def handle_config_update(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
+async def handle_subscribe_events(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/bang_olufsen/__init__.pyi

@@ -1,5 +1,5 @@
 from .const import DOMAIN as DOMAIN
-from .websocket import BangOlufsenWebsocket as BangOlufsenWebsocket
+from .websocket import BeoWebsocket as BeoWebsocket
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -10,12 +10,12 @@ from homeassistant.util.ssl import get_default_context as get_default_context
 from mozart_api.mozart_client import MozartClient
 
 @dataclass
-class BangOlufsenData:
-    websocket: BangOlufsenWebsocket
+class BeoData:
+    websocket: BeoWebsocket
     client: MozartClient
-type BangOlufsenConfigEntry = ConfigEntry[BangOlufsenData]
+type BeoConfigEntry = ConfigEntry[BeoData]
 
 PLATFORMS: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, entry: BangOlufsenConfigEntry) -> bool: ...
-async def async_unload_entry(hass: HomeAssistant, entry: BangOlufsenConfigEntry) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: BeoConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: BeoConfigEntry) -> bool: ...

homeassistant-stubs/components/bang_olufsen/config_flow.pyi

@@ -1,4 +1,4 @@
-from .const import ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ITEM_NUMBER as ATTR_ITEM_NUMBER, ATTR_SERIAL_NUMBER as ATTR_SERIAL_NUMBER, ATTR_TYPE_NUMBER as ATTR_TYPE_NUMBER, COMPATIBLE_MODELS as COMPATIBLE_MODELS, CONF_SERIAL_NUMBER as CONF_SERIAL_NUMBER, DEFAULT_MODEL as DEFAULT_MODEL, DOMAIN as DOMAIN
+from .const import ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ITEM_NUMBER as ATTR_ITEM_NUMBER, ATTR_SERIAL_NUMBER as ATTR_SERIAL_NUMBER, ATTR_TYPE_NUMBER as ATTR_TYPE_NUMBER, CONF_SERIAL_NUMBER as CONF_SERIAL_NUMBER, DEFAULT_MODEL as DEFAULT_MODEL, DOMAIN as DOMAIN, SELECTABLE_MODELS as SELECTABLE_MODELS
 from .util import get_serial_number_from_jid as get_serial_number_from_jid
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
@@ -17,7 +17,7 @@ class EntryData(TypedDict, total=False):
 
 _exception_map: Incomplete
 
-class BangOlufsenConfigFlowHandler(ConfigFlow, domain=DOMAIN):
+class BeoConfigFlowHandler(ConfigFlow, domain=DOMAIN):
     _beolink_jid: str
     _client: MozartClient
     _host: str

homeassistant-stubs/components/bang_olufsen/const.pyi

@@ -4,24 +4,30 @@ from homeassistant.components.media_player import MediaPlayerState as MediaPlaye
 from mozart_api.models import Source, SourceArray
 from typing import Final
 
-class BangOlufsenSource:
+class BeoSource:
+    DEEZER: Final[Source]
     LINE_IN: Final[Source]
+    NET_RADIO: Final[Source]
     SPDIF: Final[Source]
+    TIDAL: Final[Source]
+    TV: Final[Source]
+    UNKNOWN: Final[Source]
     URI_STREAMER: Final[Source]
 
-BANG_OLUFSEN_STATES: dict[str, MediaPlayerState]
-BANG_OLUFSEN_REPEAT_FROM_HA: dict[RepeatMode, str]
-BANG_OLUFSEN_REPEAT_TO_HA: dict[str, RepeatMode]
+BEO_STATES: dict[str, MediaPlayerState]
+BEO_REPEAT_FROM_HA: dict[RepeatMode, str]
+BEO_REPEAT_TO_HA: dict[str, RepeatMode]
 
-class BangOlufsenMediaType(StrEnum):
-    FAVOURITE = 'favourite'
+class BeoMediaType(StrEnum):
     DEEZER = 'deezer'
+    FAVOURITE = 'favourite'
+    OVERLAY_TTS = 'overlay_tts'
     RADIO = 'radio'
     TIDAL = 'tidal'
     TTS = 'provider'
-    OVERLAY_TTS = 'overlay_tts'
+    TV = 'tv'
 
-class BangOlufsenModel(StrEnum):
+class BeoModel(StrEnum):
     BEOCONNECT_CORE = 'Beoconnect Core'
     BEOLAB_8 = 'BeoLab 8'
     BEOLAB_28 = 'BeoLab 28'
@@ -31,10 +37,32 @@ class BangOlufsenModel(StrEnum):
     BEOSOUND_BALANCE = 'Beosound Balance'
     BEOSOUND_EMERGE = 'Beosound Emerge'
     BEOSOUND_LEVEL = 'Beosound Level'
+    BEOSOUND_PREMIERE = 'Beosound Premiere'
     BEOSOUND_THEATRE = 'Beosound Theatre'
+    BEOREMOTE_ONE = 'Beoremote One'
+
+class BeoAttribute(StrEnum):
+    BEOLINK = 'beolink'
+    BEOLINK_PEERS = 'peers'
+    BEOLINK_SELF = 'self'
+    BEOLINK_LEADER = 'leader'
+    BEOLINK_LISTENERS = 'listeners'
+
+class BeoButtons(StrEnum):
+    BLUETOOTH = 'Bluetooth'
+    MICROPHONE = 'Microphone'
+    NEXT = 'Next'
+    PLAY_PAUSE = 'PlayPause'
+    PRESET_1 = 'Preset1'
+    PRESET_2 = 'Preset2'
+    PRESET_3 = 'Preset3'
+    PRESET_4 = 'Preset4'
+    PREVIOUS = 'Previous'
+    VOLUME = 'Volume'
 
 class WebsocketNotification(StrEnum):
     ACTIVE_LISTENING_MODE = 'active_listening_mode'
+    BEO_REMOTE_BUTTON = 'beo_remote_button'
     BUTTON = 'button'
     PLAYBACK_ERROR = 'playback_error'
     PLAYBACK_METADATA = 'playback_metadata'
@@ -50,6 +78,7 @@ class WebsocketNotification(StrEnum):
     BEOLINK_AVAILABLE_LISTENERS = 'beolinkAvailableListeners'
     CONFIGURATION = 'configuration'
     NOTIFICATION = 'notification'
+    REMOTE_CONTROL_DEVICES = 'remoteControlDevices'
     REMOTE_MENU_CHANGED = 'remoteMenuChanged'
     ALL = 'all'
 
@@ -57,20 +86,24 @@ DOMAIN: Final[str]
 DEFAULT_MODEL: Final[str]
 CONF_SERIAL_NUMBER: Final[str]
 CONF_BEOLINK_JID: Final[str]
-COMPATIBLE_MODELS: list[str]
+SELECTABLE_MODELS: list[str]
+MANUFACTURER: Final[str]
 ATTR_TYPE_NUMBER: Final[str]
 ATTR_SERIAL_NUMBER: Final[str]
 ATTR_ITEM_NUMBER: Final[str]
 ATTR_FRIENDLY_NAME: Final[str]
-BANG_OLUFSEN_ON: Final[str]
+BEO_ON: Final[str]
 VALID_MEDIA_TYPES: Final[tuple]
 FALLBACK_SOURCES: Final[SourceArray]
-MODEL_SUPPORT_DEVICE_BUTTONS: Final[str]
-MODEL_SUPPORT_MAP: Incomplete
-BANG_OLUFSEN_WEBSOCKET_EVENT: Final[str]
+BEO_WEBSOCKET_EVENT: Final[str]
 EVENT_TRANSLATION_MAP: dict[str, str]
 CONNECTION_STATUS: Final[str]
 DEVICE_BUTTONS: Final[list[str]]
 DEVICE_BUTTON_EVENTS: Final[list[str]]
+BEO_REMOTE_SUBMENU_CONTROL: Final[str]
+BEO_REMOTE_SUBMENU_LIGHT: Final[str]
+BEO_REMOTE_KEYS: Final[tuple[str, ...]]
+BEO_REMOTE_CONTROL_KEYS: Final[tuple[str, ...]]
+BEO_REMOTE_KEY_EVENTS: Final[list[str]]
 BEOLINK_JOIN_SOURCES_TO_UPPER: Incomplete
 BEOLINK_JOIN_SOURCES: Incomplete

homeassistant-stubs/components/bang_olufsen/diagnostics.pyi

@@ -1,6 +1,8 @@
-from . import BangOlufsenConfigEntry as BangOlufsenConfigEntry
-from .const import DEVICE_BUTTONS as DEVICE_BUTTONS, DOMAIN as DOMAIN
+from . import BeoConfigEntry as BeoConfigEntry
+from .const import DOMAIN as DOMAIN
+from .util import get_device_buttons as get_device_buttons, get_remote_keys as get_remote_keys, get_remotes as get_remotes
+from homeassistant.const import CONF_MODEL as CONF_MODEL
 from homeassistant.core import HomeAssistant as HomeAssistant
 from typing import Any
 
-async def async_get_config_entry_diagnostics(hass: HomeAssistant, config_entry: BangOlufsenConfigEntry) -> dict[str, Any]: ...
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, config_entry: BeoConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/bang_olufsen/entity.pyi

@@ -8,7 +8,7 @@ from homeassistant.helpers.entity import Entity as Entity
 from mozart_api.models import PlaybackContentMetadata, PlaybackProgress, RenderingState, Source, VolumeState
 from mozart_api.mozart_client import MozartClient as MozartClient
 
-class BangOlufsenBase:
+class BeoBase:
     _client: Incomplete
     entry: ConfigEntry
     _host: str
@@ -21,7 +21,7 @@ class BangOlufsenBase:
     _volume: VolumeState
     def __init__(self, entry: ConfigEntry, client: MozartClient) -> None: ...
 
-class BangOlufsenEntity(Entity, BangOlufsenBase):
+class BeoEntity(Entity, BeoBase):
     _attr_has_entity_name: bool
     _attr_should_poll: bool
     _attr_device_info: Incomplete