homeassistant-stubs 2024.12.5__py3-none-any.whl → 2025.1.0b0__py3-none-any.whl

homeassistant-stubs/components/automation/__init__.pyi

@@ -13,7 +13,6 @@ from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_MODE as A
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Context as Context, CoreState as CoreState, Event as Event, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback, split_entity_id as split_entity_id, valid_entity_id as valid_entity_id
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceNotFound as ServiceNotFound, TemplateError as TemplateError
 from homeassistant.helpers import condition as condition
-from homeassistant.helpers.deprecation import DeprecatedConstant as DeprecatedConstant, all_with_deprecated_constants as all_with_deprecated_constants, check_if_deprecated_constant as check_if_deprecated_constant, dir_with_deprecated_constants as dir_with_deprecated_constants
 from homeassistant.helpers.entity import ToggleEntity as ToggleEntity
 from homeassistant.helpers.entity_component import EntityComponent as EntityComponent
 from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue, async_delete_issue as async_delete_issue
@@ -22,7 +21,7 @@ from homeassistant.helpers.script import ATTR_CUR as ATTR_CUR, ATTR_MAX as ATTR_
 from homeassistant.helpers.script_variables import ScriptVariables as ScriptVariables
 from homeassistant.helpers.service import ReloadServiceHelper as ReloadServiceHelper, async_register_admin_service as async_register_admin_service
 from homeassistant.helpers.trace import TraceElement as TraceElement, script_execution_set as script_execution_set, trace_append_element as trace_append_element, trace_get as trace_get, trace_path as trace_path
-from homeassistant.helpers.trigger import TriggerActionType as TriggerActionType, TriggerData as TriggerData, TriggerInfo as TriggerInfo, async_initialize_triggers as async_initialize_triggers
+from homeassistant.helpers.trigger import async_initialize_triggers as async_initialize_triggers
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.dt import parse_datetime as parse_datetime
@@ -45,10 +44,6 @@ class IfAction(Protocol):
     config: list[ConfigType]
     def __call__(self, variables: Mapping[str, Any] | None = None) -> bool: ...
 
-_DEPRECATED_AutomationActionType: Incomplete
-_DEPRECATED_AutomationTriggerData: Incomplete
-_DEPRECATED_AutomationTriggerInfo: Incomplete
-
 def is_on(hass: HomeAssistant, entity_id: str) -> bool: ...
 def _automations_with_x(hass: HomeAssistant, referenced_id: str, property_name: str) -> list[str]: ...
 def _x_in_automation(hass: HomeAssistant, entity_id: str, property_name: str) -> list[str]: ...
@@ -169,7 +164,3 @@ async def _async_process_if(hass: HomeAssistant, name: str, config: dict[str, An
 def _trigger_extract_devices(trigger_conf: dict) -> list[str]: ...
 def _trigger_extract_entities(trigger_conf: dict) -> list[str]: ...
 def websocket_config(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
-
-__getattr__: Incomplete
-__dir__: Incomplete
-__all__: Incomplete

homeassistant-stubs/components/backup/__init__.pyi

@@ -1,12 +1,5 @@
-from .const import DATA_MANAGER as DATA_MANAGER, DOMAIN as DOMAIN, LOGGER as LOGGER
-from .http import async_register_http_views as async_register_http_views
-from .manager import BackupManager as BackupManager
-from .websocket import async_register_websocket_handlers as async_register_websocket_handlers
-from _typeshed import Incomplete
-from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall
-from homeassistant.helpers.hassio import is_hassio as is_hassio
-from homeassistant.helpers.typing import ConfigType as ConfigType
+from .agent import BackupAgent as BackupAgent, BackupAgentError as BackupAgentError, BackupAgentPlatformProtocol as BackupAgentPlatformProtocol, LocalBackupAgent as LocalBackupAgent
+from .manager import BackupPlatformProtocol as BackupPlatformProtocol, BackupReaderWriter as BackupReaderWriter, CreateBackupEvent as CreateBackupEvent, ManagerBackup as ManagerBackup, NewBackup as NewBackup, WrittenBackup as WrittenBackup
+from .models import AddonInfo as AddonInfo, AgentBackup as AgentBackup, Folder as Folder
 
-CONFIG_SCHEMA: Incomplete
-
-async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
+__all__ = ['AddonInfo', 'AgentBackup', 'ManagerBackup', 'BackupAgent', 'BackupAgentError', 'BackupAgentPlatformProtocol', 'BackupPlatformProtocol', 'BackupReaderWriter', 'CreateBackupEvent', 'Folder', 'LocalBackupAgent', 'NewBackup', 'WrittenBackup']

homeassistant-stubs/components/backup/agent.pyi

@@ -0,0 +1,35 @@
+import abc
+from .models import AgentBackup as AgentBackup
+from collections.abc import AsyncIterator, Callable as Callable, Coroutine
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from pathlib import Path
+from typing import Any, Protocol
+
+class BackupAgentError(HomeAssistantError): ...
+
+class BackupAgentUnreachableError(BackupAgentError):
+    _message: str
+
+class BackupAgent(abc.ABC, metaclass=abc.ABCMeta):
+    domain: str
+    name: str
+    def agent_id(self) -> str: ...
+    @abc.abstractmethod
+    async def async_download_backup(self, backup_id: str, **kwargs: Any) -> AsyncIterator[bytes]: ...
+    @abc.abstractmethod
+    async def async_upload_backup(self, *, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], backup: AgentBackup, **kwargs: Any) -> None: ...
+    @abc.abstractmethod
+    async def async_delete_backup(self, backup_id: str, **kwargs: Any) -> None: ...
+    @abc.abstractmethod
+    async def async_list_backups(self, **kwargs: Any) -> list[AgentBackup]: ...
+    @abc.abstractmethod
+    async def async_get_backup(self, backup_id: str, **kwargs: Any) -> AgentBackup | None: ...
+
+class LocalBackupAgent(BackupAgent, metaclass=abc.ABCMeta):
+    @abc.abstractmethod
+    def get_backup_path(self, backup_id: str) -> Path: ...
+
+class BackupAgentPlatformProtocol(Protocol):
+    async def async_get_backup_agents(self, hass: HomeAssistant, **kwargs: Any) -> list[BackupAgent]: ...
+    def async_register_backup_agents_listener(self, hass: HomeAssistant, *, listener: Callable[[], None], **kwargs: Any) -> Callable[[], None]: ...

homeassistant-stubs/components/backup/backup.pyi

@@ -0,0 +1,29 @@
+from .agent import BackupAgent as BackupAgent, LocalBackupAgent as LocalBackupAgent
+from .const import DOMAIN as DOMAIN, LOGGER as LOGGER
+from .models import AgentBackup as AgentBackup
+from .util import read_backup as read_backup
+from _typeshed import Incomplete
+from collections.abc import AsyncIterator, Callable as Callable, Coroutine
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.hassio import is_hassio as is_hassio
+from pathlib import Path
+from typing import Any
+
+async def async_get_backup_agents(hass: HomeAssistant, **kwargs: Any) -> list[BackupAgent]: ...
+
+class CoreLocalBackupAgent(LocalBackupAgent):
+    domain = DOMAIN
+    name: str
+    _hass: Incomplete
+    _backup_dir: Incomplete
+    _backups: Incomplete
+    _loaded_backups: bool
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    async def _load_backups(self) -> None: ...
+    def _read_backups(self) -> dict[str, AgentBackup]: ...
+    async def async_download_backup(self, backup_id: str, **kwargs: Any) -> AsyncIterator[bytes]: ...
+    async def async_upload_backup(self, *, open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]], backup: AgentBackup, **kwargs: Any) -> None: ...
+    async def async_list_backups(self, **kwargs: Any) -> list[AgentBackup]: ...
+    async def async_get_backup(self, backup_id: str, **kwargs: Any) -> AgentBackup | None: ...
+    def get_backup_path(self, backup_id: str) -> Path: ...
+    async def async_delete_backup(self, backup_id: str, **kwargs: Any) -> None: ...

homeassistant-stubs/components/backup/config.pyi

@@ -0,0 +1,117 @@
+from .const import LOGGER as LOGGER
+from .manager import BackupManager as BackupManager, ManagerBackup as ManagerBackup
+from .models import Folder as Folder
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from cronsim import CronSim
+from dataclasses import dataclass
+from datetime import datetime
+from enum import StrEnum
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.event import async_call_later as async_call_later, async_track_point_in_time as async_track_point_in_time
+from homeassistant.helpers.typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
+from typing import Self, TypedDict
+
+CRON_PATTERN_DAILY: str
+CRON_PATTERN_WEEKLY: str
+
+class StoredBackupConfig(TypedDict):
+    create_backup: StoredCreateBackupConfig
+    last_attempted_automatic_backup: str | None
+    last_completed_automatic_backup: str | None
+    retention: StoredRetentionConfig
+    schedule: StoredBackupSchedule
+
+@dataclass(kw_only=True)
+class BackupConfigData:
+    create_backup: CreateBackupConfig
+    last_attempted_automatic_backup: datetime | None = ...
+    last_completed_automatic_backup: datetime | None = ...
+    retention: RetentionConfig
+    schedule: BackupSchedule
+    @classmethod
+    def from_dict(cls, data: StoredBackupConfig) -> Self: ...
+    def to_dict(self) -> StoredBackupConfig: ...
+    def __init__(self, *, create_backup, last_attempted_automatic_backup=..., last_completed_automatic_backup=..., retention, schedule) -> None: ...
+
+class BackupConfig:
+    data: Incomplete
+    _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: ...
+
+@dataclass(kw_only=True)
+class RetentionConfig:
+    copies: int | None = ...
+    days: int | None = ...
+    def apply(self, manager: BackupManager) -> None: ...
+    def to_dict(self) -> StoredRetentionConfig: ...
+    def _schedule_next(self, manager: BackupManager) -> None: ...
+    def _unschedule_next(self, manager: BackupManager) -> None: ...
+    def __init__(self, *, copies=..., days=...) -> None: ...
+
+class StoredRetentionConfig(TypedDict):
+    copies: int | None
+    days: int | None
+
+class RetentionParametersDict(TypedDict, total=False):
+    copies: int | None
+    days: int | None
+
+class StoredBackupSchedule(TypedDict):
+    state: ScheduleState
+
+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:
+    state: ScheduleState = ...
+    cron_event: CronSim | None = ...
+    def apply(self, manager: BackupManager) -> None: ...
+    def _schedule_next(self, cron_pattern: str, manager: BackupManager) -> None: ...
+    def to_dict(self) -> StoredBackupSchedule: ...
+    def _unschedule_next(self, manager: BackupManager) -> None: ...
+    def __init__(self, *, state=...) -> None: ...
+
+@dataclass(kw_only=True)
+class CreateBackupConfig:
+    agent_ids: list[str] = ...
+    include_addons: list[str] | None = ...
+    include_all_addons: bool = ...
+    include_database: bool = ...
+    include_folders: list[Folder] | None = ...
+    name: str | None = ...
+    password: str | None = ...
+    def to_dict(self) -> StoredCreateBackupConfig: ...
+    def __init__(self, *, agent_ids=..., include_addons=..., include_all_addons=..., include_database=..., include_folders=..., name=..., password=...) -> None: ...
+
+class StoredCreateBackupConfig(TypedDict):
+    agent_ids: list[str]
+    include_addons: list[str] | None
+    include_all_addons: bool
+    include_database: bool
+    include_folders: list[Folder] | None
+    name: str | None
+    password: str | None
+
+class CreateBackupParametersDict(TypedDict, total=False):
+    agent_ids: list[str]
+    include_addons: list[str] | None
+    include_all_addons: bool
+    include_database: bool
+    include_folders: list[Folder] | None
+    name: str | None
+    password: str | None
+
+async def _delete_filtered_backups(manager: BackupManager, backup_filter: Callable[[dict[str, ManagerBackup]], dict[str, ManagerBackup]]) -> None: ...
+async def delete_backups_exceeding_configured_count(manager: BackupManager) -> None: ...

homeassistant-stubs/components/backup/const.pyi

@@ -2,7 +2,9 @@ from .manager import BackupManager as BackupManager
 from _typeshed import Incomplete
 from homeassistant.util.hass_dict import HassKey as HassKey
 
+BUF_SIZE: Incomplete
 DOMAIN: str
 DATA_MANAGER: HassKey[BackupManager]
 LOGGER: Incomplete
 EXCLUDE_FROM_BACKUP: Incomplete
+EXCLUDE_DATABASE_FROM_BACKUP: Incomplete

homeassistant-stubs/components/backup/http.pyi

@@ -1,7 +1,8 @@
 from .const import DATA_MANAGER as DATA_MANAGER
-from aiohttp.web import FileResponse, Request as Request, Response
+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
 
 def async_register_http_views(hass: HomeAssistant) -> None: ...
@@ -9,7 +10,7 @@ def async_register_http_views(hass: HomeAssistant) -> None: ...
 class DownloadBackupView(HomeAssistantView):
     url: str
     name: str
-    async def get(self, request: Request, slug: str) -> FileResponse | Response: ...
+    async def get(self, request: Request, backup_id: str) -> StreamResponse | FileResponse | Response: ...
 
 class UploadBackupView(HomeAssistantView):
     url: str

homeassistant-stubs/components/backup/manager.pyi

@@ -1,71 +1,211 @@
 import abc
 import aiohttp
-from .const import DOMAIN as DOMAIN, EXCLUDE_FROM_BACKUP as EXCLUDE_FROM_BACKUP, LOGGER as LOGGER
+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, 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 _typeshed import Incomplete
+from collections.abc import AsyncIterator, Callable as Callable, Coroutine
 from dataclasses import dataclass
-from homeassistant.backup_restore import RESTORE_BACKUP_FILE as RESTORE_BACKUP_FILE
+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.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
-from homeassistant.helpers import integration_platform as integration_platform
+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 homeassistant.util.json import json_loads_object as json_loads_object
 from pathlib import Path
-from typing import Any, Protocol
+from typing import Any, Protocol, TypedDict
 
-BUF_SIZE: Incomplete
+class IncorrectPasswordError(HomeAssistantError): ...
 
-@dataclass(slots=True)
-class Backup:
-    slug: str
-    name: str
-    date: str
-    path: Path
-    size: float
-    def as_dict(self) -> dict: ...
-    def __init__(self, slug, name, date, path, size) -> None: ...
+@dataclass(frozen=True, kw_only=True, slots=True)
+class NewBackup:
+    backup_job_id: str
+    def __init__(self, *, backup_job_id) -> None: ...
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class ManagerBackup(AgentBackup):
+    agent_ids: list[str]
+    failed_agent_ids: list[str]
+    with_automatic_settings: bool | None
+    def __init__(self, *, addons, backup_id, date, database_included, extra_metadata, folders, homeassistant_included, homeassistant_version, name, protected, size, agent_ids, failed_agent_ids, with_automatic_settings) -> None: ...
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class WrittenBackup:
+    backup: AgentBackup
+    open_stream: Callable[[], Coroutine[Any, Any, AsyncIterator[bytes]]]
+    release_stream: Callable[[], Coroutine[Any, Any, None]]
+    def __init__(self, *, backup, open_stream, release_stream) -> None: ...
+
+class BackupManagerState(StrEnum):
+    IDLE = 'idle'
+    CREATE_BACKUP = 'create_backup'
+    RECEIVE_BACKUP = 'receive_backup'
+    RESTORE_BACKUP = 'restore_backup'
+
+class CreateBackupStage(StrEnum):
+    ADDON_REPOSITORIES = 'addon_repositories'
+    ADDONS = 'addons'
+    AWAIT_ADDON_RESTARTS = 'await_addon_restarts'
+    DOCKER_CONFIG = 'docker_config'
+    FINISHING_FILE = 'finishing_file'
+    FOLDERS = 'folders'
+    HOME_ASSISTANT = 'home_assistant'
+    UPLOAD_TO_AGENTS = 'upload_to_agents'
+
+class CreateBackupState(StrEnum):
+    COMPLETED = 'completed'
+    FAILED = 'failed'
+    IN_PROGRESS = 'in_progress'
+
+class ReceiveBackupStage(StrEnum):
+    RECEIVE_FILE = 'receive_file'
+    UPLOAD_TO_AGENTS = 'upload_to_agents'
+
+class ReceiveBackupState(StrEnum):
+    COMPLETED = 'completed'
+    FAILED = 'failed'
+    IN_PROGRESS = 'in_progress'
+
+class RestoreBackupStage(StrEnum):
+    ADDON_REPOSITORIES = 'addon_repositories'
+    ADDONS = 'addons'
+    AWAIT_ADDON_RESTARTS = 'await_addon_restarts'
+    AWAIT_HOME_ASSISTANT_RESTART = 'await_home_assistant_restart'
+    CHECK_HOME_ASSISTANT = 'check_home_assistant'
+    DOCKER_CONFIG = 'docker_config'
+    DOWNLOAD_FROM_AGENT = 'download_from_agent'
+    FOLDERS = 'folders'
+    HOME_ASSISTANT = 'home_assistant'
+    REMOVE_DELTA_ADDONS = 'remove_delta_addons'
+
+class RestoreBackupState(StrEnum):
+    COMPLETED = 'completed'
+    FAILED = 'failed'
+    IN_PROGRESS = 'in_progress'
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class ManagerStateEvent:
+    manager_state: BackupManagerState
+    def __init__(self, *, manager_state) -> None: ...
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class IdleEvent(ManagerStateEvent):
+    manager_state: BackupManagerState = ...
+    def __init__(self, *, manager_state=...) -> None: ...
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class CreateBackupEvent(ManagerStateEvent):
+    manager_state: BackupManagerState = ...
+    stage: CreateBackupStage | None
+    state: CreateBackupState
+    def __init__(self, *, manager_state=..., stage, state) -> None: ...
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class ReceiveBackupEvent(ManagerStateEvent):
+    manager_state: BackupManagerState = ...
+    stage: ReceiveBackupStage | None
+    state: ReceiveBackupState
+    def __init__(self, *, manager_state=..., stage, state) -> None: ...
+
+@dataclass(frozen=True, kw_only=True, slots=True)
+class RestoreBackupEvent(ManagerStateEvent):
+    manager_state: BackupManagerState = ...
+    stage: RestoreBackupStage | None
+    state: RestoreBackupState
+    def __init__(self, *, manager_state=..., stage, state) -> None: ...
 
 class BackupPlatformProtocol(Protocol):
     async def async_pre_backup(self, hass: HomeAssistant) -> None: ...
     async def async_post_backup(self, hass: HomeAssistant) -> None: ...
 
-class BaseBackupManager(abc.ABC, metaclass=abc.ABCMeta):
-    hass: Incomplete
-    backing_up: bool
-    backups: Incomplete
-    loaded_platforms: bool
-    platforms: Incomplete
-    def __init__(self, hass: HomeAssistant) -> None: ...
-    def _add_platform(self, hass: HomeAssistant, integration_domain: str, platform: BackupPlatformProtocol) -> None: ...
-    async def async_pre_backup_actions(self, **kwargs: Any) -> None: ...
-    async def async_post_backup_actions(self, **kwargs: Any) -> None: ...
-    async def load_platforms(self) -> None: ...
-    @abc.abstractmethod
-    async def async_restore_backup(self, slug: str, **kwargs: Any) -> None: ...
+class BackupReaderWriter(abc.ABC, metaclass=abc.ABCMeta):
     @abc.abstractmethod
-    async def async_create_backup(self, **kwargs: Any) -> Backup: ...
+    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]]: ...
     @abc.abstractmethod
-    async def async_get_backups(self, **kwargs: Any) -> dict[str, Backup]: ...
+    async def async_receive_backup(self, *, agent_ids: list[str], stream: AsyncIterator[bytes], suggested_filename: str) -> WrittenBackup: ...
     @abc.abstractmethod
-    async def async_get_backup(self, *, slug: str, **kwargs: Any) -> Backup | None: ...
-    @abc.abstractmethod
-    async def async_remove_backup(self, *, slug: str, **kwargs: Any) -> None: ...
-    @abc.abstractmethod
-    async def async_receive_backup(self, *, contents: aiohttp.BodyPartReader, **kwargs: Any) -> None: ...
+    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: ...
+
+class BackupManager:
+    hass: Incomplete
+    platforms: Incomplete
+    backup_agent_platforms: Incomplete
+    backup_agents: Incomplete
+    local_backup_agents: Incomplete
+    config: Incomplete
+    _reader_writer: Incomplete
+    known_backups: Incomplete
+    store: Incomplete
+    _backup_task: Incomplete
+    _backup_finish_task: Incomplete
+    remove_next_backup_event: Incomplete
+    remove_next_delete_event: Incomplete
+    last_event: Incomplete
+    _backup_event_subscriptions: Incomplete
+    def __init__(self, hass: HomeAssistant, reader_writer: BackupReaderWriter) -> None: ...
+    async def async_setup(self) -> None: ...
+    @property
+    def state(self) -> BackupManagerState: ...
+    def _add_platform_pre_post_handler(self, integration_domain: str, platform: BackupPlatformProtocol) -> None: ...
+    def _async_add_backup_agent_platform(self, integration_domain: str, platform: BackupAgentPlatformProtocol) -> None: ...
+    async def _async_reload_backup_agents(self, domain: str) -> None: ...
+    async def _add_platform(self, hass: HomeAssistant, integration_domain: str, platform: Any) -> None: ...
+    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_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, 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, with_automatic_settings: bool) -> NewBackup: ...
+    async def _async_finish_backup(self, agent_ids: list[str], with_automatic_settings: 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: ...
+    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: ...
+    def async_on_backup_event(self, event: ManagerStateEvent) -> None: ...
+    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: ...
+
+class KnownBackups:
+    _backups: Incomplete
+    _manager: Incomplete
+    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]) -> None: ...
+    def get(self, backup_id: str) -> KnownBackup | None: ...
+    def remove(self, backup_id: str) -> None: ...
 
-class BackupManager(BaseBackupManager):
-    backup_dir: Incomplete
-    loaded_backups: bool
+@dataclass(kw_only=True)
+class KnownBackup:
+    backup_id: str
+    failed_agent_ids: list[str]
+    def to_dict(self) -> StoredKnownBackup: ...
+    def __init__(self, *, backup_id, failed_agent_ids) -> None: ...
+
+class StoredKnownBackup(TypedDict):
+    backup_id: str
+    failed_agent_ids: list[str]
+
+class CoreBackupReaderWriter(BackupReaderWriter):
+    _local_agent_id: Incomplete
+    _hass: Incomplete
+    temp_backup_dir: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
-    backups: Incomplete
-    async def load_backups(self) -> None: ...
-    def _read_backups(self) -> dict[str, Backup]: ...
-    async def async_get_backups(self, **kwargs: Any) -> dict[str, Backup]: ...
-    async def async_get_backup(self, *, slug: str, **kwargs: Any) -> Backup | None: ...
-    async def async_remove_backup(self, *, slug: str, **kwargs: Any) -> None: ...
-    async def async_receive_backup(self, *, contents: aiohttp.BodyPartReader, **kwargs: Any) -> None: ...
-    backing_up: bool
-    async def async_create_backup(self, **kwargs: Any) -> Backup: ...
-    def _mkdir_and_generate_backup_contents(self, tar_file_path: Path, backup_data: dict[str, Any]) -> int: ...
-    async def async_restore_backup(self, slug: str, **kwargs: Any) -> None: ...
-
-def _generate_slug(date: str, name: str) -> str: ...
+    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: ...
+    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: ...
+
+def _generate_backup_id(date: str, name: str) -> str: ...

homeassistant-stubs/components/backup/models.pyi

@@ -0,0 +1,35 @@
+from dataclasses import dataclass
+from enum import StrEnum
+from typing import Any, Self
+
+@dataclass(frozen=True, kw_only=True)
+class AddonInfo:
+    name: str
+    slug: str
+    version: str
+    def __init__(self, *, name, slug, version) -> None: ...
+
+class Folder(StrEnum):
+    SHARE = 'share'
+    ADDONS = 'addons/local'
+    SSL = 'ssl'
+    MEDIA = 'media'
+
+@dataclass(frozen=True, kw_only=True)
+class AgentBackup:
+    addons: list[AddonInfo]
+    backup_id: str
+    date: str
+    database_included: bool
+    extra_metadata: dict[str, bool | str]
+    folders: list[Folder]
+    homeassistant_included: bool
+    homeassistant_version: str | None
+    name: str
+    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: ...
+    def __init__(self, *, addons, backup_id, date, database_included, extra_metadata, folders, homeassistant_included, homeassistant_version, name, protected, size) -> None: ...

homeassistant-stubs/components/backup/store.pyi

@@ -0,0 +1,24 @@
+from .config import StoredBackupConfig as StoredBackupConfig
+from .const import DOMAIN as DOMAIN
+from .manager import BackupManager as BackupManager, StoredKnownBackup as StoredKnownBackup
+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
+
+STORE_DELAY_SAVE: int
+STORAGE_KEY = DOMAIN
+STORAGE_VERSION: int
+
+class StoredBackupData(TypedDict):
+    backups: list[StoredKnownBackup]
+    config: StoredBackupConfig
+
+class BackupStore:
+    _hass: Incomplete
+    _manager: Incomplete
+    _store: Incomplete
+    def __init__(self, hass: HomeAssistant, manager: BackupManager) -> None: ...
+    async def load(self) -> StoredBackupData | None: ...
+    def save(self) -> None: ...
+    def _data_to_save(self) -> StoredBackupData: ...

homeassistant-stubs/components/backup/util.pyi

@@ -0,0 +1,12 @@
+import aiohttp
+from .const import BUF_SIZE as BUF_SIZE, LOGGER as LOGGER
+from .models import AddonInfo as AddonInfo, AgentBackup as AgentBackup, Folder as Folder
+from homeassistant.backup_restore import password_to_key as password_to_key
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.util.json import JsonObjectType as JsonObjectType, json_loads_object as json_loads_object
+from pathlib import Path
+
+def make_backup_dir(path: Path) -> None: ...
+def read_backup(backup_path: Path) -> AgentBackup: ...
+def validate_password(path: Path, password: str | None) -> bool: ...
+async def receive_file(hass: HomeAssistant, contents: aiohttp.BodyPartReader, path: Path) -> None: ...

homeassistant-stubs/components/backup/websocket.pyi

@@ -1,4 +1,7 @@
+from .config import ScheduleState as ScheduleState
 from .const import DATA_MANAGER as DATA_MANAGER, LOGGER as LOGGER
+from .manager import 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
 from typing import Any
@@ -6,8 +9,13 @@ from typing import Any
 def async_register_websocket_handlers(hass: HomeAssistant, with_hassio: bool) -> None: ...
 async def handle_info(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def handle_details(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
-async def handle_remove(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def handle_delete(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def handle_restore(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def handle_create(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def handle_create_with_automatic_settings(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def handle_backup_start(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
 async def handle_backup_end(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def backup_agents_info(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def handle_config_info(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def handle_config_update(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...
+async def handle_subscribe_events(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict[str, Any]) -> None: ...

homeassistant-stubs/components/baf/climate.pyi

@@ -14,7 +14,6 @@ class BAFAutoComfort(BAFEntity, ClimateEntity):
     _attr_temperature_unit: Incomplete
     _attr_hvac_modes: Incomplete
     _attr_translation_key: str
-    _enable_turn_on_off_backwards_compatibility: bool
     _attr_hvac_mode: Incomplete
     _attr_hvac_action: Incomplete
     _attr_target_temperature: Incomplete

homeassistant-stubs/components/baf/fan.pyi

@@ -12,7 +12,6 @@ async def async_setup_entry(hass: HomeAssistant, entry: BAFConfigEntry, async_ad
 
 class BAFFan(BAFEntity, FanEntity):
     _attr_supported_features: Incomplete
-    _enable_turn_on_off_backwards_compatibility: bool
     _attr_preset_modes: Incomplete
     _attr_speed_count = SPEED_COUNT
     _attr_name: Incomplete