homeassistant-stubs 2025.1.4__py3-none-any.whl → 2025.2.0b0__py3-none-any.whl

homeassistant-stubs/components/backup/backup.pyi

@@ -14,6 +14,7 @@ async def async_get_backup_agents(hass: HomeAssistant, **kwargs: Any) -> list[Ba
 class CoreLocalBackupAgent(LocalBackupAgent):
     domain = DOMAIN
     name: str
+    unique_id: str
     _hass: Incomplete
     _backup_dir: Incomplete
     _backups: dict[str, AgentBackup]

homeassistant-stubs/components/backup/config.pyi

@@ -1,3 +1,4 @@
+import datetime as dt
 from .const import LOGGER as LOGGER
 from .manager import BackupManager as BackupManager, ManagerBackup as ManagerBackup
 from .models import BackupManagerError as BackupManagerError, Folder as Folder
@@ -14,9 +15,11 @@ from typing import Self, TypedDict
 
 CRON_PATTERN_DAILY: str
 CRON_PATTERN_WEEKLY: str
+DEFAULT_BACKUP_TIME: Incomplete
 BACKUP_START_TIME_JITTER: Incomplete
 
 class StoredBackupConfig(TypedDict):
+    agents: dict[str, StoredAgentConfig]
     create_backup: StoredCreateBackupConfig
     last_attempted_automatic_backup: str | None
     last_completed_automatic_backup: str | None
@@ -25,6 +28,7 @@ class StoredBackupConfig(TypedDict):
 
 @dataclass(kw_only=True)
 class BackupConfigData:
+    agents: dict[str, AgentConfig]
     create_backup: CreateBackupConfig
     last_attempted_automatic_backup: datetime | None = ...
     last_completed_automatic_backup: datetime | None = ...
@@ -39,7 +43,18 @@ class BackupConfig:
     _manager: Incomplete
     def __init__(self, hass: HomeAssistant, manager: BackupManager) -> None: ...
     def load(self, stored_config: StoredBackupConfig) -> None: ...
-    async def update(self, *, create_backup: CreateBackupParametersDict | UndefinedType = ..., retention: RetentionParametersDict | UndefinedType = ..., schedule: ScheduleState | UndefinedType = ...) -> None: ...
+    async def update(self, *, agents: dict[str, AgentParametersDict] | UndefinedType = ..., create_backup: CreateBackupParametersDict | UndefinedType = ..., retention: RetentionParametersDict | UndefinedType = ..., schedule: ScheduleParametersDict | UndefinedType = ...) -> None: ...
+
+@dataclass(kw_only=True)
+class AgentConfig:
+    protected: bool
+    def to_dict(self) -> StoredAgentConfig: ...
+
+class StoredAgentConfig(TypedDict):
+    protected: bool
+
+class AgentParametersDict(TypedDict, total=False):
+    protected: bool
 
 @dataclass(kw_only=True)
 class RetentionConfig:
@@ -61,7 +76,30 @@ class RetentionParametersDict(TypedDict, total=False):
     days: int | None
 
 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):
+    MONDAY = 'mon'
+    TUESDAY = 'tue'
+    WEDNESDAY = 'wed'
+    THURSDAY = 'thu'
+    FRIDAY = 'fri'
+    SATURDAY = 'sat'
+    SUNDAY = 'sun'
+
+class ScheduleRecurrence(StrEnum):
+    NEVER = 'never'
+    DAILY = 'daily'
+    CUSTOM_DAYS = 'custom_days'
 
 class ScheduleState(StrEnum):
     NEVER = 'never'
@@ -76,8 +114,13 @@ class ScheduleState(StrEnum):
 
 @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)
+    next_automatic_backup_additional = ...
     @callback
     def apply(self, manager: BackupManager) -> None: ...
     @callback

homeassistant-stubs/components/backup/http.pyi

@@ -1,9 +1,13 @@
+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 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.util import slugify as slugify
+from multidict import istr
 
 @callback
 def async_register_http_views(hass: HomeAssistant) -> None: ...
@@ -12,9 +16,12 @@ class DownloadBackupView(HomeAssistantView):
     url: str
     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: ...
 
 class UploadBackupView(HomeAssistantView):
     url: str
     name: str
     @require_admin
     async def post(self, request: Request) -> Response: ...
+    async def _post(self, request: Request) -> Response: ...

homeassistant-stubs/components/backup/manager.pyi

@@ -4,16 +4,15 @@ import asyncio
 from .agent import BackupAgent as BackupAgent, BackupAgentError as BackupAgentError, BackupAgentPlatformProtocol as BackupAgentPlatformProtocol, LocalBackupAgent as LocalBackupAgent
 from .config import BackupConfig as BackupConfig, 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, BackupManagerError as BackupManagerError, Folder as Folder
+from .models import AgentBackup as AgentBackup, BackupError as BackupError, BackupManagerError as BackupManagerError, BaseBackup as BaseBackup, Folder as Folder
 from .store import BackupStore as BackupStore
-from .util import make_backup_dir as make_backup_dir, read_backup as read_backup, validate_password as validate_password
+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 _typeshed import Incomplete
 from collections.abc import AsyncIterator, Callable as Callable, Coroutine
 from dataclasses import dataclass
 from enum import StrEnum
-from homeassistant.backup_restore import RESTORE_BACKUP_FILE as RESTORE_BACKUP_FILE, password_to_key as password_to_key
+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.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers import instance_id as instance_id, integration_platform as integration_platform
 from homeassistant.helpers.json import json_bytes as json_bytes
 from pathlib import Path
@@ -24,8 +23,13 @@ class NewBackup:
     backup_job_id: str
 
 @dataclass(frozen=True, kw_only=True, slots=True)
-class ManagerBackup(AgentBackup):
-    agent_ids: list[str]
+class AgentBackupStatus:
+    protected: bool
+    size: int
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class ManagerBackup(BaseBackup):
+    agents: dict[str, AgentBackupStatus]
     failed_agent_ids: list[str]
     with_automatic_settings: bool | None
 
@@ -79,6 +83,7 @@ class RestoreBackupStage(StrEnum):
 
 class RestoreBackupState(StrEnum):
     COMPLETED = 'completed'
+    CORE_RESTART = 'core_restart'
     FAILED = 'failed'
     IN_PROGRESS = 'in_progress'
 
@@ -93,18 +98,21 @@ class IdleEvent(ManagerStateEvent):
 @dataclass(frozen=True, kw_only=True, slots=True)
 class CreateBackupEvent(ManagerStateEvent):
     manager_state: BackupManagerState = ...
+    reason: str | None
     stage: CreateBackupStage | None
     state: CreateBackupState
 
 @dataclass(frozen=True, kw_only=True, slots=True)
 class ReceiveBackupEvent(ManagerStateEvent):
     manager_state: BackupManagerState = ...
+    reason: str | None
     stage: ReceiveBackupStage | None
     state: ReceiveBackupState
 
 @dataclass(frozen=True, kw_only=True, slots=True)
 class RestoreBackupEvent(ManagerStateEvent):
     manager_state: BackupManagerState = ...
+    reason: str | None
     stage: RestoreBackupStage | None
     state: RestoreBackupState
 
@@ -114,14 +122,24 @@ class BackupPlatformProtocol(Protocol):
 
 class BackupReaderWriter(abc.ABC, metaclass=abc.ABCMeta):
     @abc.abstractmethod
-    async def async_create_backup(self, *, agent_ids: list[str], backup_name: str, extra_metadata: dict[str, bool | str], include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, on_progress: Callable[[ManagerStateEvent], None], password: str | None) -> tuple[NewBackup, asyncio.Task[WrittenBackup]]: ...
+    async def async_create_backup(self, *, agent_ids: list[str], backup_name: str, extra_metadata: dict[str, bool | str], include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, on_progress: Callable[[CreateBackupEvent], None], password: str | None) -> tuple[NewBackup, asyncio.Task[WrittenBackup]]: ...
     @abc.abstractmethod
     async def async_receive_backup(self, *, agent_ids: list[str], stream: AsyncIterator[bytes], suggested_filename: str) -> WrittenBackup: ...
     @abc.abstractmethod
-    async def async_restore_backup(self, backup_id: str, *, agent_id: str, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], password: str | None, restore_addons: list[str] | None, restore_database: bool, restore_folders: list[Folder] | None, restore_homeassistant: bool) -> None: ...
+    async def async_restore_backup(self, backup_id: str, *, agent_id: str, on_progress: Callable[[RestoreBackupEvent], None], open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], password: str | None, restore_addons: list[str] | None, restore_database: bool, restore_folders: list[Folder] | None, restore_homeassistant: bool) -> None: ...
+    @abc.abstractmethod
+    async def async_resume_restore_progress_after_restart(self, *, on_progress: Callable[[RestoreBackupEvent | IdleEvent], None]) -> None: ...
+
+class BackupReaderWriterError(BackupError):
+    error_code: str
+
+class IncorrectPasswordError(BackupReaderWriterError):
+    error_code: str
+    _message: str
 
-class BackupReaderWriterError(HomeAssistantError): ...
-class IncorrectPasswordError(BackupReaderWriterError): ...
+class DecryptOnDowloadNotSupported(BackupManagerError):
+    error_code: str
+    _message: str
 
 class BackupManager:
     hass: Incomplete
@@ -138,6 +156,7 @@ class BackupManager:
     remove_next_backup_event: Callable[[], None] | None
     remove_next_delete_event: Callable[[], None] | None
     last_event: ManagerStateEvent
+    last_non_idle_event: ManagerStateEvent | None
     _backup_event_subscriptions: list[Callable[[ManagerStateEvent], None]]
     def __init__(self, hass: HomeAssistant, reader_writer: BackupReaderWriter) -> None: ...
     async def async_setup(self) -> None: ...
@@ -152,18 +171,19 @@ class BackupManager:
     async def async_pre_backup_actions(self) -> None: ...
     async def async_post_backup_actions(self) -> None: ...
     async def load_platforms(self) -> None: ...
-    async def _async_upload_backup(self, *, backup: AgentBackup, agent_ids: list[str], open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]]) -> dict[str, Exception]: ...
+    async def _async_upload_backup(self, *, backup: AgentBackup, agent_ids: list[str], open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], password: str | None) -> dict[str, Exception]: ...
     async def async_get_backups(self) -> tuple[dict[str, ManagerBackup], dict[str, Exception]]: ...
     async def async_get_backup(self, backup_id: str) -> tuple[ManagerBackup | None, dict[str, Exception]]: ...
     @staticmethod
     def is_our_automatic_backup(backup: AgentBackup, our_instance_id: str) -> bool | None: ...
     async def async_delete_backup(self, backup_id: str) -> dict[str, Exception]: ...
-    async def async_receive_backup(self, *, agent_ids: list[str], contents: aiohttp.BodyPartReader) -> None: ...
-    async def _async_receive_backup(self, *, agent_ids: list[str], contents: aiohttp.BodyPartReader) -> None: ...
-    async def async_create_backup(self, *, agent_ids: list[str], include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, name: str | None, password: str | None, with_automatic_settings: bool = False) -> NewBackup: ...
-    async def async_initiate_backup(self, *, agent_ids: list[str], include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, name: str | None, password: str | None, raise_task_error: bool = False, with_automatic_settings: bool = False) -> NewBackup: ...
-    async def _async_create_backup(self, *, agent_ids: list[str], include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, name: str | None, password: str | None, raise_task_error: bool, with_automatic_settings: bool) -> NewBackup: ...
-    async def _async_finish_backup(self, agent_ids: list[str], with_automatic_settings: bool) -> None: ...
+    async def async_receive_backup(self, *, agent_ids: list[str], contents: aiohttp.BodyPartReader) -> str: ...
+    async def _async_receive_backup(self, *, agent_ids: list[str], contents: aiohttp.BodyPartReader) -> str: ...
+    async def async_create_backup(self, *, agent_ids: list[str], extra_metadata: dict[str, bool | str] | None = None, include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, name: str | None, password: str | None, with_automatic_settings: bool = False) -> NewBackup: ...
+    async def async_create_automatic_backup(self) -> NewBackup: ...
+    async def async_initiate_backup(self, *, agent_ids: list[str], extra_metadata: dict[str, bool | str] | None = None, include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, name: str | None, password: str | None, raise_task_error: bool = False, with_automatic_settings: bool = False) -> NewBackup: ...
+    async def _async_create_backup(self, *, agent_ids: list[str], extra_metadata: dict[str, bool | str] | None, include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, name: str | None, password: str | None, raise_task_error: bool, with_automatic_settings: bool) -> NewBackup: ...
+    async def _async_finish_backup(self, agent_ids: list[str], with_automatic_settings: bool, password: str | None) -> None: ...
     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: ...
     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
@@ -172,6 +192,7 @@ class BackupManager:
     def async_subscribe_events(self, on_event: Callable[[ManagerStateEvent], None]) -> Callable[[], None]: ...
     def _update_issue_backup_failed(self) -> None: ...
     def _update_issue_after_agent_upload(self, agent_errors: dict[str, Exception]) -> None: ...
+    async def async_can_decrypt_on_download(self, backup_id: str, *, agent_id: str, password: str | None) -> None: ...
 
 class KnownBackups:
     _backups: dict[str, KnownBackup]
@@ -198,10 +219,11 @@ class CoreBackupReaderWriter(BackupReaderWriter):
     _hass: Incomplete
     temp_backup_dir: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
-    async def async_create_backup(self, *, agent_ids: list[str], backup_name: str, extra_metadata: dict[str, bool | str], include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, on_progress: Callable[[ManagerStateEvent], None], password: str | None) -> tuple[NewBackup, asyncio.Task[WrittenBackup]]: ...
-    async def _async_create_backup(self, *, agent_ids: list[str], backup_id: str, backup_name: str, date_str: str, extra_metadata: dict[str, bool | str], include_database: bool, on_progress: Callable[[ManagerStateEvent], None], password: str | None) -> WrittenBackup: ...
+    async def async_create_backup(self, *, agent_ids: list[str], backup_name: str, extra_metadata: dict[str, bool | str], include_addons: list[str] | None, include_all_addons: bool, include_database: bool, include_folders: list[Folder] | None, include_homeassistant: bool, on_progress: Callable[[CreateBackupEvent], None], password: str | None) -> tuple[NewBackup, asyncio.Task[WrittenBackup]]: ...
+    async def _async_create_backup(self, *, agent_ids: list[str], backup_id: str, backup_name: str, date_str: str, extra_metadata: dict[str, bool | str], include_database: bool, on_progress: Callable[[CreateBackupEvent], None], password: str | None) -> WrittenBackup: ...
     def _mkdir_and_generate_backup_contents(self, backup_data: dict[str, Any], database_included: bool, password: str | None, tar_file_path: Path | None) -> tuple[Path, int]: ...
     async def async_receive_backup(self, *, agent_ids: list[str], stream: AsyncIterator[bytes], suggested_filename: str) -> WrittenBackup: ...
-    async def async_restore_backup(self, backup_id: str, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], *, agent_id: str, password: str | None, restore_addons: list[str] | None, restore_database: bool, restore_folders: list[Folder] | None, restore_homeassistant: bool) -> None: ...
+    async def async_restore_backup(self, backup_id: str, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], *, agent_id: str, on_progress: Callable[[RestoreBackupEvent], None], password: str | None, restore_addons: list[str] | None, restore_database: bool, restore_folders: list[Folder] | None, restore_homeassistant: bool) -> None: ...
+    async def async_resume_restore_progress_after_restart(self, *, on_progress: Callable[[RestoreBackupEvent | IdleEvent], None]) -> None: ...
 
 def _generate_backup_id(date: str, name: str) -> str: ...

homeassistant-stubs/components/backup/models.pyi

@@ -16,7 +16,7 @@ class Folder(StrEnum):
     MEDIA = 'media'
 
 @dataclass(frozen=True, kw_only=True)
-class AgentBackup:
+class BaseBackup:
     addons: list[AddonInfo]
     backup_id: str
     date: str
@@ -26,11 +26,18 @@ class AgentBackup:
     homeassistant_included: bool
     homeassistant_version: str | None
     name: str
+    def as_frontend_json(self) -> dict: ...
+
+@dataclass(frozen=True, kw_only=True)
+class AgentBackup(BaseBackup):
     protected: bool
     size: int
     def as_dict(self) -> dict: ...
-    def as_frontend_json(self) -> dict: ...
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> Self: ...
 
-class BackupManagerError(HomeAssistantError): ...
+class BackupError(HomeAssistantError):
+    error_code: str
+
+class BackupManagerError(BackupError):
+    error_code: str

homeassistant-stubs/components/backup/store.pyi

@@ -4,20 +4,25 @@ from .manager import BackupManager as BackupManager, StoredKnownBackup as Stored
 from _typeshed import Incomplete
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.storage import Store as Store
-from typing import TypedDict
+from typing import Any, TypedDict
 
 STORE_DELAY_SAVE: int
 STORAGE_KEY = DOMAIN
 STORAGE_VERSION: int
+STORAGE_VERSION_MINOR: int
 
 class StoredBackupData(TypedDict):
     backups: list[StoredKnownBackup]
     config: StoredBackupConfig
 
+class _BackupStore(Store[StoredBackupData]):
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, Any]) -> dict[str, Any]: ...
+
 class BackupStore:
     _hass: Incomplete
     _manager: Incomplete
-    _store: Store[StoredBackupData]
+    _store: Incomplete
     def __init__(self, hass: HomeAssistant, manager: BackupManager) -> None: ...
     async def load(self) -> StoredBackupData | None: ...
     @callback

homeassistant-stubs/components/backup/util.pyi

@@ -1,12 +1,95 @@
 import aiohttp
+import asyncio
+import tarfile
 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 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.json import JsonObjectType as JsonObjectType, json_loads_object as json_loads_object
+from homeassistant.util.thread import ThreadWithException as ThreadWithException
 from pathlib import Path
+from typing import Any, IO, Self
+
+class DecryptError(HomeAssistantError):
+    _message: str
+
+class EncryptError(HomeAssistantError):
+    _message: str
+
+class UnsupportedSecureTarVersion(DecryptError):
+    _message: str
+
+class IncorrectPassword(DecryptError):
+    _message: str
+
+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 validate_password(path: Path, password: str | None) -> bool: ...
+
+class AsyncIteratorReader:
+    _hass: Incomplete
+    _stream: Incomplete
+    _buffer: bytes | None
+    _pos: int
+    def __init__(self, hass: HomeAssistant, stream: AsyncIterator[bytes]) -> None: ...
+    async def _next(self) -> bytes | None: ...
+    def read(self, n: int = -1, /) -> bytes: ...
+    def close(self) -> None: ...
+
+class AsyncIteratorWriter:
+    _hass: Incomplete
+    _pos: int
+    _queue: asyncio.Queue[bytes | None]
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    def __aiter__(self) -> Self: ...
+    async def __anext__(self) -> bytes: ...
+    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: ...
+
+@dataclass(kw_only=True)
+class _CipherWorkerStatus:
+    done: asyncio.Event
+    error: Exception | None = ...
+    thread: ThreadWithException
+
+class _CipherBackupStreamer:
+    _cipher_func: Callable[[IO[bytes], IO[bytes], str | None, Callable[[Exception | None], None], int, list[bytes]], None]
+    _workers: list[_CipherWorkerStatus]
+    _backup: Incomplete
+    _hass: Incomplete
+    _open_stream: Incomplete
+    _password: Incomplete
+    _nonces: list[bytes]
+    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: ...
+    async def open_stream(self) -> AsyncIterator[bytes]: ...
+    async def wait(self) -> None: ...
+
+class DecryptedBackupStreamer(_CipherBackupStreamer):
+    _cipher_func: Incomplete
+    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: ...
+
 async def receive_file(hass: HomeAssistant, contents: aiohttp.BodyPartReader, path: Path) -> None: ...

homeassistant-stubs/components/backup/websocket.pyi

@@ -1,6 +1,6 @@
-from .config import ScheduleState as ScheduleState
+from .config import Day as Day, ScheduleRecurrence as ScheduleRecurrence
 from .const import DATA_MANAGER as DATA_MANAGER, LOGGER as LOGGER
-from .manager import IncorrectPasswordError as IncorrectPasswordError, ManagerStateEvent as ManagerStateEvent
+from .manager import DecryptOnDowloadNotSupported as DecryptOnDowloadNotSupported, IncorrectPasswordError as IncorrectPasswordError, ManagerStateEvent as ManagerStateEvent
 from .models import Folder as Folder
 from homeassistant.components import websocket_api as websocket_api
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
@@ -22,6 +22,9 @@ async def handle_delete(hass: HomeAssistant, connection: websocket_api.ActiveCon
 async def handle_restore(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 @websocket_api.require_admin
 @websocket_api.async_response
+async def handle_can_decrypt_on_download(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+@websocket_api.require_admin
+@websocket_api.async_response
 async def handle_create(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 @websocket_api.require_admin
 @websocket_api.async_response

homeassistant-stubs/components/baf/config_flow.pyi

@@ -2,9 +2,9 @@ from .const import DOMAIN as DOMAIN, RUN_TIMEOUT as RUN_TIMEOUT
 from .models import BAFDiscovery as BAFDiscovery
 from _typeshed import Incomplete
 from aiobafi6 import Device
-from homeassistant.components import zeroconf as zeroconf
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_IP_ADDRESS as CONF_IP_ADDRESS
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from typing import Any
 
 _LOGGER: Incomplete
@@ -15,7 +15,7 @@ class BAFFlowHandler(ConfigFlow, domain=DOMAIN):
     VERSION: int
     discovery: BAFDiscovery | None
     def __init__(self) -> None: ...
-    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_zeroconf(self, discovery_info: 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/bang_olufsen/config_flow.pyi

@@ -1,10 +1,10 @@
 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 .util import get_serial_number_from_jid as get_serial_number_from_jid
 from _typeshed import Incomplete
-from homeassistant.components.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_MODEL as CONF_MODEL
 from homeassistant.helpers.selector import SelectSelector as SelectSelector, SelectSelectorConfig as SelectSelectorConfig
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from homeassistant.util.ssl import get_default_context as get_default_context
 from mozart_api.mozart_client import MozartClient
 from typing import Any, TypedDict

homeassistant-stubs/components/bang_olufsen/const.pyi

@@ -35,6 +35,7 @@ class BangOlufsenModel(StrEnum):
 
 class WebsocketNotification(StrEnum):
     ACTIVE_LISTENING_MODE = 'active_listening_mode'
+    BUTTON = 'button'
     PLAYBACK_ERROR = 'playback_error'
     PLAYBACK_METADATA = 'playback_metadata'
     PLAYBACK_PROGRESS = 'playback_progress'
@@ -64,7 +65,12 @@ ATTR_FRIENDLY_NAME: Final[str]
 BANG_OLUFSEN_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]
+EVENT_TRANSLATION_MAP: dict[str, str]
 CONNECTION_STATUS: Final[str]
+DEVICE_BUTTONS: Final[list[str]]
+DEVICE_BUTTON_EVENTS: Final[list[str]]
 BEOLINK_JOIN_SOURCES_TO_UPPER: Incomplete
 BEOLINK_JOIN_SOURCES: Incomplete

homeassistant-stubs/components/bang_olufsen/event.pyi

@@ -0,0 +1,23 @@
+from . import BangOlufsenConfigEntry as BangOlufsenConfigEntry
+from .const import CONNECTION_STATUS as CONNECTION_STATUS, DEVICE_BUTTONS as DEVICE_BUTTONS, DEVICE_BUTTON_EVENTS as DEVICE_BUTTON_EVENTS, MODEL_SUPPORT_DEVICE_BUTTONS as MODEL_SUPPORT_DEVICE_BUTTONS, MODEL_SUPPORT_MAP as MODEL_SUPPORT_MAP, WebsocketNotification as WebsocketNotification
+from .entity import BangOlufsenEntity as BangOlufsenEntity
+from _typeshed import Incomplete
+from homeassistant.components.event import EventDeviceClass as EventDeviceClass, EventEntity as EventEntity
+from homeassistant.const import CONF_MODEL as CONF_MODEL
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+
+async def async_setup_entry(hass: HomeAssistant, config_entry: BangOlufsenConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class BangOlufsenButtonEvent(BangOlufsenEntity, EventEntity):
+    _attr_device_class: Incomplete
+    _attr_entity_registry_enabled_default: bool
+    _attr_event_types = DEVICE_BUTTON_EVENTS
+    _attr_unique_id: Incomplete
+    _attr_translation_key: Incomplete
+    _button_type: Incomplete
+    def __init__(self, config_entry: BangOlufsenConfigEntry, button_type: str) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
+    @callback
+    def _async_handle_event(self, event: str) -> None: ...

homeassistant-stubs/components/bang_olufsen/websocket.pyi

@@ -1,4 +1,4 @@
-from .const import BANG_OLUFSEN_WEBSOCKET_EVENT as BANG_OLUFSEN_WEBSOCKET_EVENT, CONNECTION_STATUS as CONNECTION_STATUS, WebsocketNotification as WebsocketNotification
+from .const import BANG_OLUFSEN_WEBSOCKET_EVENT as BANG_OLUFSEN_WEBSOCKET_EVENT, CONNECTION_STATUS as CONNECTION_STATUS, EVENT_TRANSLATION_MAP as EVENT_TRANSLATION_MAP, WebsocketNotification as WebsocketNotification
 from .entity import BangOlufsenBase as BangOlufsenBase
 from .util import get_device as get_device
 from _typeshed import Incomplete
@@ -6,7 +6,7 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.dispatcher import async_dispatcher_send as async_dispatcher_send
 from homeassistant.util.enum import try_parse_enum as try_parse_enum
-from mozart_api.models import ListeningModeProps as ListeningModeProps, PlaybackContentMetadata as PlaybackContentMetadata, PlaybackError as PlaybackError, PlaybackProgress as PlaybackProgress, RenderingState as RenderingState, SoftwareUpdateState as SoftwareUpdateState, Source as Source, VolumeState as VolumeState, WebsocketNotificationTag as WebsocketNotificationTag
+from mozart_api.models import ButtonEvent as ButtonEvent, ListeningModeProps as ListeningModeProps, PlaybackContentMetadata as PlaybackContentMetadata, PlaybackError as PlaybackError, PlaybackProgress as PlaybackProgress, RenderingState as RenderingState, SoftwareUpdateState as SoftwareUpdateState, Source as Source, VolumeState as VolumeState, WebsocketNotificationTag as WebsocketNotificationTag
 from mozart_api.mozart_client import BaseWebSocketResponse as BaseWebSocketResponse, MozartClient as MozartClient
 
 _LOGGER: Incomplete
@@ -19,6 +19,7 @@ class BangOlufsenWebsocket(BangOlufsenBase):
     def on_connection(self) -> None: ...
     def on_connection_lost(self) -> None: ...
     def on_active_listening_mode(self, notification: ListeningModeProps) -> None: ...
+    def on_button_notification(self, notification: ButtonEvent) -> None: ...
     def on_notification_notification(self, notification: WebsocketNotificationTag) -> None: ...
     def on_playback_error_notification(self, notification: PlaybackError) -> None: ...
     def on_playback_metadata_notification(self, notification: PlaybackContentMetadata) -> None: ...

homeassistant-stubs/components/binary_sensor/__init__.pyi

@@ -8,7 +8,7 @@ from homeassistant.helpers.entity import Entity as Entity, EntityDescription as
 from homeassistant.helpers.entity_component import EntityComponent as EntityComponent
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.util.hass_dict import HassKey as HassKey
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Literal, final
 
 _LOGGER: Incomplete

homeassistant-stubs/components/blueprint/importer.pyi

@@ -5,7 +5,6 @@ from dataclasses import dataclass
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers import aiohttp_client as aiohttp_client
-from homeassistant.util import yaml as yaml
 
 COMMUNITY_TOPIC_PATTERN: Incomplete
 COMMUNITY_CODE_BLOCK: Incomplete

homeassistant-stubs/components/blueprint/models.pyi

@@ -9,7 +9,6 @@ from homeassistant import loader as loader
 from homeassistant.const import CONF_DEFAULT as CONF_DEFAULT, CONF_DOMAIN as CONF_DOMAIN, CONF_NAME as CONF_NAME, CONF_PATH as CONF_PATH, __version__ as __version__
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
-from homeassistant.util import yaml as yaml
 from typing import Any
 
 class Blueprint:

homeassistant-stubs/components/blueprint/websocket_api.pyi

@@ -6,7 +6,6 @@ from collections.abc import Callable as Callable, Coroutine
 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 import yaml as yaml
 from typing import Any
 
 @callback

homeassistant-stubs/components/bluesound/__init__.pyi

@@ -1,4 +1,5 @@
 from .const import DOMAIN as DOMAIN
+from .coordinator import BluesoundCoordinator as BluesoundCoordinator
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -16,6 +17,7 @@ PLATFORMS: Incomplete
 class BluesoundRuntimeData:
     player: Player
     sync_status: SyncStatus
+    coordinator: BluesoundCoordinator
 type BluesoundConfigEntry = ConfigEntry[BluesoundRuntimeData]
 
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...

homeassistant-stubs/components/bluesound/config_flow.pyi

@@ -2,10 +2,10 @@ from .const import DOMAIN as DOMAIN
 from .media_player import DEFAULT_PORT as DEFAULT_PORT
 from .utils import format_unique_id as format_unique_id
 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_PORT as CONF_PORT
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from pyblu import SyncStatus as SyncStatus
 from typing import Any
 
@@ -19,6 +19,5 @@ class BluesoundConfigFlow(ConfigFlow, domain=DOMAIN):
     _sync_status: SyncStatus | None
     def __init__(self) -> None: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def async_step_import(self, import_data: dict[str, Any]) -> ConfigFlowResult: ...
-    async def async_step_zeroconf(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def async_step_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...