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

homeassistant-stubs/components/peblar/update.pyi

@@ -0,0 +1,27 @@
+from .coordinator import PeblarConfigEntry as PeblarConfigEntry, PeblarVersionDataUpdateCoordinator as PeblarVersionDataUpdateCoordinator, PeblarVersionInformation as PeblarVersionInformation
+from .entity import PeblarEntity as PeblarEntity
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.update import UpdateDeviceClass as UpdateDeviceClass, UpdateEntity as UpdateEntity, UpdateEntityDescription as UpdateEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class PeblarUpdateEntityDescription(UpdateEntityDescription):
+    available_fn: Callable[[PeblarVersionInformation], str | None]
+    has_fn: Callable[[PeblarVersionInformation], bool] = ...
+    installed_fn: Callable[[PeblarVersionInformation], str | None]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., display_precision=..., available_fn, has_fn=..., installed_fn) -> None: ...
+
+DESCRIPTIONS: tuple[PeblarUpdateEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PeblarConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class PeblarUpdateEntity(PeblarEntity[PeblarVersionDataUpdateCoordinator], UpdateEntity):
+    entity_description: PeblarUpdateEntityDescription
+    @property
+    def installed_version(self) -> str | None: ...
+    @property
+    def latest_version(self) -> str | None: ...

homeassistant-stubs/components/plugwise/binary_sensor.pyi

@@ -12,6 +12,7 @@ from plugwise.constants import BinarySensorType as BinarySensorType
 from typing import Any
 
 SEVERITIES: Incomplete
+PARALLEL_UPDATES: int
 
 @dataclass(frozen=True)
 class PlugwiseBinarySensorEntityDescription(BinarySensorEntityDescription):

homeassistant-stubs/components/plugwise/button.pyi

@@ -9,6 +9,8 @@ from homeassistant.const import EntityCategory as EntityCategory
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+PARALLEL_UPDATES: int
+
 async def async_setup_entry(hass: HomeAssistant, entry: PlugwiseConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class PlugwiseButtonEntity(PlugwiseEntity, ButtonEntity):

homeassistant-stubs/components/plugwise/climate.pyi

@@ -7,20 +7,19 @@ from _typeshed import Incomplete
 from homeassistant.components.climate import ATTR_HVAC_MODE as ATTR_HVAC_MODE, ATTR_TARGET_TEMP_HIGH as ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW as ATTR_TARGET_TEMP_LOW, ClimateEntity as ClimateEntity, ClimateEntityFeature as ClimateEntityFeature, HVACAction as HVACAction, HVACMode as HVACMode
 from homeassistant.const import ATTR_TEMPERATURE as ATTR_TEMPERATURE, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.exceptions import ServiceValidationError as ServiceValidationError
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from typing import Any
 
+PARALLEL_UPDATES: int
+
 async def async_setup_entry(hass: HomeAssistant, entry: PlugwiseConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class PlugwiseClimateEntity(PlugwiseEntity, ClimateEntity):
-    _attr_has_entity_name: bool
     _attr_name: Incomplete
     _attr_temperature_unit: Incomplete
     _attr_translation_key = DOMAIN
-    _enable_turn_on_off_backwards_compatibility: bool
     _previous_mode: str
-    _attr_extra_state_attributes: Incomplete
     _attr_unique_id: Incomplete
     _devices: Incomplete
     _gateway: Incomplete

homeassistant-stubs/components/plugwise/config_flow.pyi

@@ -1,5 +1,6 @@
 import voluptuous as vol
 from .const import DEFAULT_PORT as DEFAULT_PORT, DEFAULT_USERNAME as DEFAULT_USERNAME, DOMAIN as DOMAIN, FLOW_SMILE as FLOW_SMILE, FLOW_STRETCH as FLOW_STRETCH, SMILE as SMILE, STRETCH as STRETCH, STRETCH_USERNAME as STRETCH_USERNAME, ZEROCONF_MAP as ZEROCONF_MAP
+from _typeshed import Incomplete
 from homeassistant.components.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, SOURCE_USER as SOURCE_USER
 from homeassistant.const import ATTR_CONFIGURATION_URL as ATTR_CONFIGURATION_URL, CONF_BASE as CONF_BASE, CONF_HOST as CONF_HOST, CONF_NAME as CONF_NAME, CONF_PASSWORD as CONF_PASSWORD, CONF_PORT as CONF_PORT, CONF_USERNAME as CONF_USERNAME
@@ -8,8 +9,12 @@ from homeassistant.helpers.aiohttp_client import async_get_clientsession as asyn
 from plugwise import Smile
 from typing import Any, Self
 
-def base_schema(discovery_info: ZeroconfServiceInfo | None) -> vol.Schema: ...
+_LOGGER: Incomplete
+SMILE_RECONF_SCHEMA: Incomplete
+
+def smile_user_schema(discovery_info: ZeroconfServiceInfo | None) -> vol.Schema: ...
 async def validate_input(hass: HomeAssistant, data: dict[str, Any]) -> Smile: ...
+async def verify_connection(hass: HomeAssistant, user_input: dict[str, Any]) -> tuple[Smile | None, dict[str, str]]: ...
 
 class PlugwiseConfigFlow(ConfigFlow, domain=DOMAIN):
     VERSION: int
@@ -19,3 +24,4 @@ class PlugwiseConfigFlow(ConfigFlow, domain=DOMAIN):
     async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     def is_matching(self, other_flow: Self) -> bool: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/plugwise/entity.pyi

@@ -15,4 +15,3 @@ class PlugwiseEntity(CoordinatorEntity[PlugwiseDataUpdateCoordinator]):
     def available(self) -> bool: ...
     @property
     def device(self) -> GwEntityData: ...
-    async def async_added_to_hass(self) -> None: ...

homeassistant-stubs/components/plugwise/number.pyi

@@ -10,6 +10,8 @@ from homeassistant.const import EntityCategory as EntityCategory, UnitOfTemperat
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True, kw_only=True)
 class PlugwiseNumberEntityDescription(NumberEntityDescription):
     key: NumberType

homeassistant-stubs/components/plugwise/select.pyi

@@ -10,6 +10,8 @@ from homeassistant.const import EntityCategory as EntityCategory, STATE_ON as ST
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True, kw_only=True)
 class PlugwiseSelectEntityDescription(SelectEntityDescription):
     key: SelectType

homeassistant-stubs/components/plugwise/sensor.pyi

@@ -9,6 +9,8 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from plugwise.constants import SensorType as SensorType
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True)
 class PlugwiseSensorEntityDescription(SensorEntityDescription):
     key: SensorType

homeassistant-stubs/components/plugwise/switch.pyi

@@ -11,6 +11,8 @@ from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEnti
 from plugwise.constants import SwitchType as SwitchType
 from typing import Any
 
+PARALLEL_UPDATES: int
+
 @dataclass(frozen=True)
 class PlugwiseSwitchEntityDescription(SwitchEntityDescription):
     key: SwitchType

homeassistant-stubs/components/plugwise/util.pyi

@@ -1,3 +1,4 @@
+from .const import DOMAIN as DOMAIN
 from .entity import PlugwiseEntity as PlugwiseEntity
 from collections.abc import Awaitable, Callable as Callable, Coroutine
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError

homeassistant-stubs/components/powerfox/__init__.pyi

@@ -0,0 +1,12 @@
+from .coordinator import PowerfoxDataUpdateCoordinator as PowerfoxDataUpdateCoordinator
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_EMAIL as CONF_EMAIL, CONF_PASSWORD as CONF_PASSWORD, Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+
+PLATFORMS: list[Platform]
+type PowerfoxConfigEntry = ConfigEntry[list[PowerfoxDataUpdateCoordinator]]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PowerfoxConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: PowerfoxConfigEntry) -> bool: ...

homeassistant-stubs/components/powerfox/config_flow.pyi

@@ -0,0 +1,16 @@
+from .const import DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from homeassistant.const import CONF_EMAIL as CONF_EMAIL, CONF_PASSWORD as CONF_PASSWORD
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from typing import Any
+
+STEP_USER_DATA_SCHEMA: Incomplete
+STEP_REAUTH_SCHEMA: Incomplete
+
+class PowerfoxConfigFlow(ConfigFlow, domain=DOMAIN):
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
+    async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/{stookalert → powerfox}/const.pyi

@@ -3,5 +3,4 @@ from typing import Final
 
 DOMAIN: Final[str]
 LOGGER: Incomplete
-CONF_PROVINCE: Final[str]
-PROVINCES: Final[Incomplete]
+SCAN_INTERVAL: Incomplete

homeassistant-stubs/components/powerfox/coordinator.pyi

@@ -0,0 +1,14 @@
+from .const import DOMAIN as DOMAIN, LOGGER as LOGGER, SCAN_INTERVAL as SCAN_INTERVAL
+from _typeshed import Incomplete
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from powerfox import Device as Device, Powerfox as Powerfox, Poweropti
+
+class PowerfoxDataUpdateCoordinator(DataUpdateCoordinator[Poweropti]):
+    config_entry: ConfigEntry
+    client: Incomplete
+    device: Incomplete
+    def __init__(self, hass: HomeAssistant, client: Powerfox, device: Device) -> None: ...
+    async def _async_update_data(self) -> Poweropti: ...

homeassistant-stubs/components/powerfox/diagnostics.pyi

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

homeassistant-stubs/components/powerfox/entity.pyi

@@ -0,0 +1,11 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import PowerfoxDataUpdateCoordinator as PowerfoxDataUpdateCoordinator
+from _typeshed import Incomplete
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+from powerfox import Device as Device
+
+class PowerfoxEntity(CoordinatorEntity[PowerfoxDataUpdateCoordinator]):
+    _attr_has_entity_name: bool
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: PowerfoxDataUpdateCoordinator, device: Device) -> None: ...

homeassistant-stubs/components/powerfox/sensor.pyi

@@ -0,0 +1,28 @@
+from . import PowerfoxConfigEntry as PowerfoxConfigEntry
+from .coordinator import PowerfoxDataUpdateCoordinator as PowerfoxDataUpdateCoordinator
+from .entity import PowerfoxEntity as PowerfoxEntity
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
+from homeassistant.const import UnitOfEnergy as UnitOfEnergy, UnitOfPower as UnitOfPower, UnitOfVolume as UnitOfVolume
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from powerfox import Device as Device, PowerMeter, WaterMeter
+
+@dataclass(frozen=True, kw_only=True)
+class PowerfoxSensorEntityDescription[T: (PowerMeter, WaterMeter)](SensorEntityDescription):
+    value_fn: Callable[[T], float | int | None]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn) -> None: ...
+
+SENSORS_POWER: tuple[PowerfoxSensorEntityDescription[PowerMeter], ...]
+SENSORS_WATER: tuple[PowerfoxSensorEntityDescription[WaterMeter], ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PowerfoxConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class PowerfoxSensorEntity(PowerfoxEntity, SensorEntity):
+    entity_description: PowerfoxSensorEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: PowerfoxDataUpdateCoordinator, device: Device, description: PowerfoxSensorEntityDescription) -> None: ...
+    @property
+    def native_value(self) -> float | int | None: ...

homeassistant-stubs/components/powerwall/sensor.pyi

@@ -10,15 +10,13 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity import Entity as Entity
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from tesla_powerwall import MeterResponse, MeterType as MeterType
-from typing import Generic, TypeVar
 
 _METER_DIRECTION_EXPORT: str
 _METER_DIRECTION_IMPORT: str
-_ValueParamT = TypeVar('_ValueParamT')
-_ValueT = TypeVar('_ValueT', bound=float | int | str | None)
+type _ValueType = float | int | str | None
 
 @dataclass(frozen=True, kw_only=True)
-class PowerwallSensorEntityDescription(SensorEntityDescription, Generic[_ValueParamT, _ValueT]):
+class PowerwallSensorEntityDescription[_ValueParamT, _ValueT: _ValueType](SensorEntityDescription):
     value_fn: Callable[[_ValueParamT], _ValueT]
     def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn) -> None: ...
 
@@ -88,7 +86,7 @@ class PowerWallImportSensor(PowerWallEnergyDirectionSensor):
     @property
     def native_value(self) -> float | None: ...
 
-class PowerWallBatterySensor(BatteryEntity, SensorEntity, Generic[_ValueT]):
+class PowerWallBatterySensor[_ValueT: _ValueType](BatteryEntity, SensorEntity):
     entity_description: PowerwallSensorEntityDescription[BatteryResponse, _ValueT]
     _attr_translation_key: Incomplete
     _attr_unique_id: Incomplete

homeassistant-stubs/components/prometheus/__init__.pyi

@@ -1,6 +1,7 @@
 from _typeshed import Incomplete
 from aiohttp import web
 from collections.abc import Callable as Callable
+from dataclasses import dataclass
 from homeassistant.components.alarm_control_panel import AlarmControlPanelState as AlarmControlPanelState
 from homeassistant.components.climate import ATTR_CURRENT_TEMPERATURE as ATTR_CURRENT_TEMPERATURE, ATTR_FAN_MODE as ATTR_FAN_MODE, ATTR_FAN_MODES as ATTR_FAN_MODES, ATTR_HVAC_ACTION as ATTR_HVAC_ACTION, ATTR_HVAC_MODES as ATTR_HVAC_MODES, ATTR_TARGET_TEMP_HIGH as ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW as ATTR_TARGET_TEMP_LOW, HVACAction as HVACAction
 from homeassistant.components.cover import ATTR_CURRENT_POSITION as ATTR_CURRENT_POSITION, ATTR_CURRENT_TILT_POSITION as ATTR_CURRENT_TILT_POSITION
@@ -39,6 +40,12 @@ CONFIG_SCHEMA: Incomplete
 
 def setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 
+@dataclass(frozen=True, slots=True)
+class MetricNameWithLabelValues:
+    metric_name: str
+    label_values: tuple[str, ...]
+    def __init__(self, metric_name, label_values) -> None: ...
+
 class PrometheusMetrics:
     _component_config: Incomplete
     _override_metric: Incomplete
@@ -47,20 +54,21 @@ class PrometheusMetrics:
     _sensor_metric_handlers: Incomplete
     metrics_prefix: Incomplete
     _metrics: Incomplete
+    _metrics_by_entity_id: Incomplete
     _climate_units: Incomplete
     def __init__(self, entity_filter: entityfilter.EntityFilter, namespace: str, climate_units: UnitOfTemperature, component_config: EntityValues, override_metric: str | None, default_metric: str | None) -> None: ...
     def handle_state_changed_event(self, event: Event[EventStateChangedData]) -> None: ...
     def handle_state(self, state: State) -> None: ...
     def handle_entity_registry_updated(self, event: Event[EventEntityRegistryUpdatedData]) -> None: ...
-    def _remove_labelsets(self, entity_id: str, friendly_name: str | None = None, ignored_metrics: set[MetricWrapperBase] | None = None) -> None: ...
+    def _remove_labelsets(self, entity_id: str, ignored_metric_names: set[str] | None = None) -> None: ...
     def _handle_attributes(self, state: State) -> None: ...
-    def _metric[_MetricBaseT: MetricWrapperBase](self, metric: str, factory: type[_MetricBaseT], documentation: str, extra_labels: list[str] | None = None) -> _MetricBaseT: ...
+    def _metric[_MetricBaseT: MetricWrapperBase](self, metric_name: str, factory: type[_MetricBaseT], documentation: str, labels: dict[str, str]) -> _MetricBaseT: ...
     @staticmethod
     def _sanitize_metric_name(metric: str) -> str: ...
     @staticmethod
     def state_as_number(state: State) -> float | None: ...
     @staticmethod
-    def _labels(state: State) -> dict[str, Any]: ...
+    def _labels(state: State, extra_labels: dict[str, str] | None = None) -> dict[str, Any]: ...
     def _battery(self, state: State) -> None: ...
     def _handle_binary_sensor(self, state: State) -> None: ...
     def _handle_input_boolean(self, state: State) -> None: ...

homeassistant-stubs/components/rabbitair/fan.pyi

@@ -19,7 +19,6 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_e
 
 class RabbitAirFanEntity(RabbitAirBaseEntity, FanEntity):
     _attr_supported_features: Incomplete
-    _enable_turn_on_off_backwards_compatibility: bool
     _attr_preset_modes: Incomplete
     _attr_speed_count: Incomplete
     def __init__(self, coordinator: RabbitAirDataUpdateCoordinator, entry: ConfigEntry) -> None: ...

homeassistant-stubs/components/recorder/__init__.pyi

@@ -1,4 +1,4 @@
-from . import entity_registry as entity_registry, websocket_api as websocket_api
+from . import backup as backup, entity_registry as entity_registry, websocket_api as websocket_api
 from .const import CONF_DB_INTEGRITY_CHECK as CONF_DB_INTEGRITY_CHECK, DOMAIN as DOMAIN, INTEGRATION_PLATFORM_COMPILE_STATISTICS as INTEGRATION_PLATFORM_COMPILE_STATISTICS, INTEGRATION_PLATFORM_METHODS as INTEGRATION_PLATFORM_METHODS, SQLITE_URL_PREFIX as SQLITE_URL_PREFIX, SupportedDialect as SupportedDialect
 from .core import Recorder as Recorder
 from .services import async_register_services as async_register_services

homeassistant-stubs/components/recorder/db_schema.pyi

@@ -13,7 +13,7 @@ from sqlalchemy.dialects import sqlite
 from sqlalchemy.engine.interfaces import Dialect as Dialect
 from sqlalchemy.orm import DeclarativeBase, Mapped as Mapped
 from sqlalchemy.types import TypeDecorator as TypeDecorator
-from typing import Any, Self
+from typing import Any, Final, Self
 
 class Base(DeclarativeBase): ...
 class LegacyBase(DeclarativeBase): ...
@@ -44,7 +44,8 @@ METADATA_ID_LAST_UPDATED_INDEX_TS: str
 EVENTS_CONTEXT_ID_BIN_INDEX: str
 STATES_CONTEXT_ID_BIN_INDEX: str
 LEGACY_STATES_EVENT_ID_INDEX: str
-LEGACY_STATES_ENTITY_ID_LAST_UPDATED_INDEX: str
+LEGACY_STATES_ENTITY_ID_LAST_UPDATED_TS_INDEX: str
+LEGACY_MAX_LENGTH_EVENT_CONTEXT_ID: Final[int]
 CONTEXT_ID_BIN_MAX_LENGTH: int
 MYSQL_COLLATE: str
 MYSQL_DEFAULT_CHARSET: str
@@ -110,6 +111,12 @@ class Events(Base):
     def from_event(event: Event) -> Events: ...
     def to_native(self, validate_entity_id: bool = True) -> Event | None: ...
 
+class LegacyEvents(LegacyBase):
+    __table_args__: Incomplete
+    __tablename__ = TABLE_EVENTS
+    event_id: Mapped[int]
+    context_id: Mapped[str | None]
+
 class EventData(Base):
     __table_args__: Incomplete
     __tablename__ = TABLE_EVENT_DATA
@@ -163,6 +170,14 @@ class States(Base):
     def from_event(event: Event[EventStateChangedData]) -> States: ...
     def to_native(self, validate_entity_id: bool = True) -> State | None: ...
 
+class LegacyStates(LegacyBase):
+    __table_args__: Incomplete
+    __tablename__ = TABLE_STATES
+    state_id: Mapped[int]
+    entity_id: Mapped[str | None]
+    last_updated_ts: Mapped[float | None]
+    context_id: Mapped[str | None]
+
 class StateAttributes(Base):
     __table_args__: Incomplete
     __tablename__ = TABLE_STATE_ATTRIBUTES
@@ -199,9 +214,9 @@ class StatisticsBase:
     sum: Mapped[float | None]
     duration: timedelta
     @classmethod
-    def from_stats(cls, metadata_id: int, stats: StatisticData) -> Self: ...
+    def from_stats(cls, metadata_id: int, stats: StatisticData, now_timestamp: float | None = None) -> Self: ...
     @classmethod
-    def from_stats_ts(cls, metadata_id: int, stats: StatisticDataTimestamp) -> Self: ...
+    def from_stats_ts(cls, metadata_id: int, stats: StatisticDataTimestamp, now_timestamp: float | None = None) -> Self: ...
 
 class Statistics(Base, StatisticsBase):
     duration: Incomplete

homeassistant-stubs/components/recorder/history/legacy.pyi

@@ -1,6 +1,6 @@
-from ..db_schema import RecorderRuns as RecorderRuns, StateAttributes as StateAttributes, States as States
+from ..db_schema import StateAttributes as StateAttributes, States as States
 from ..filters import Filters as Filters
-from ..models import process_timestamp as process_timestamp, process_timestamp_to_utc_isoformat as process_timestamp_to_utc_isoformat
+from ..models import process_timestamp_to_utc_isoformat as process_timestamp_to_utc_isoformat
 from ..models.legacy import LegacyLazyState as LegacyLazyState, legacy_row_to_compressed_state as legacy_row_to_compressed_state
 from ..util import execute_stmt_lambda_element as execute_stmt_lambda_element, session_scope as session_scope
 from .const import LAST_CHANGED_KEY as LAST_CHANGED_KEY, NEED_ATTRIBUTE_DOMAINS as NEED_ATTRIBUTE_DOMAINS, SIGNIFICANT_DOMAINS as SIGNIFICANT_DOMAINS, SIGNIFICANT_DOMAINS_ENTITY_ID_LIKE as SIGNIFICANT_DOMAINS_ENTITY_ID_LIKE, STATE_KEY as STATE_KEY
@@ -42,7 +42,7 @@ def _state_changed_during_period_stmt(start_time: datetime, end_time: datetime |
 def state_changes_during_period(hass: HomeAssistant, start_time: datetime, end_time: datetime | None = None, entity_id: str | None = None, no_attributes: bool = False, descending: bool = False, limit: int | None = None, include_start_time_state: bool = True) -> dict[str, list[State]]: ...
 def _get_last_state_changes_stmt(number_of_states: int, entity_id: str) -> StatementLambdaElement: ...
 def get_last_state_changes(hass: HomeAssistant, number_of_states: int, entity_id: str) -> dict[str, list[State]]: ...
-def _get_states_for_entities_stmt(run_start: datetime, utc_point_in_time: datetime, entity_ids: list[str], no_attributes: bool) -> StatementLambdaElement: ...
-def _get_rows_with_session(hass: HomeAssistant, session: Session, utc_point_in_time: datetime, entity_ids: list[str], run: RecorderRuns | None = None, no_attributes: bool = False) -> Iterable[Row]: ...
+def _get_states_for_entities_stmt(run_start_ts: float, utc_point_in_time: datetime, entity_ids: list[str], no_attributes: bool) -> StatementLambdaElement: ...
+def _get_rows_with_session(hass: HomeAssistant, session: Session, utc_point_in_time: datetime, entity_ids: list[str], *, no_attributes: bool = False) -> Iterable[Row]: ...
 def _get_single_entity_states_stmt(utc_point_in_time: datetime, entity_id: str, no_attributes: bool = False) -> StatementLambdaElement: ...
 def _sorted_states_to_dict(hass: HomeAssistant, session: Session, states: Iterable[Row], start_time: datetime, entity_ids: list[str], include_start_time_state: bool = True, minimal_response: bool = False, no_attributes: bool = False, compressed_state_format: bool = False) -> dict[str, list[State | dict[str, Any]]]: ...

homeassistant-stubs/components/recorder/history/modern.pyi

@@ -1,7 +1,7 @@
 from ..const import LAST_REPORTED_SCHEMA_VERSION as LAST_REPORTED_SCHEMA_VERSION
-from ..db_schema import SHARED_ATTR_OR_LEGACY_ATTRIBUTES as SHARED_ATTR_OR_LEGACY_ATTRIBUTES, StateAttributes as StateAttributes, States as States
+from ..db_schema import SHARED_ATTR_OR_LEGACY_ATTRIBUTES as SHARED_ATTR_OR_LEGACY_ATTRIBUTES, StateAttributes as StateAttributes, States as States, StatesMeta as StatesMeta
 from ..filters import Filters as Filters
-from ..models import LazyState as LazyState, datetime_to_timestamp_or_none as datetime_to_timestamp_or_none, extract_metadata_ids as extract_metadata_ids, process_timestamp as process_timestamp, row_to_compressed_state as row_to_compressed_state
+from ..models import LazyState as LazyState, datetime_to_timestamp_or_none as datetime_to_timestamp_or_none, extract_metadata_ids as extract_metadata_ids, row_to_compressed_state as row_to_compressed_state
 from ..util import execute_stmt_lambda_element as execute_stmt_lambda_element, session_scope as session_scope
 from .const import LAST_CHANGED_KEY as LAST_CHANGED_KEY, NEED_ATTRIBUTE_DOMAINS as NEED_ATTRIBUTE_DOMAINS, SIGNIFICANT_DOMAINS as SIGNIFICANT_DOMAINS, STATE_KEY as STATE_KEY
 from _typeshed import Incomplete
@@ -29,8 +29,8 @@ def state_changes_during_period(hass: HomeAssistant, start_time: datetime, end_t
 def _get_last_state_changes_single_stmt(metadata_id: int) -> Select: ...
 def _get_last_state_changes_multiple_stmt(number_of_states: int, metadata_id: int, include_last_reported: bool) -> Select: ...
 def get_last_state_changes(hass: HomeAssistant, number_of_states: int, entity_id: str) -> dict[str, list[State]]: ...
-def _get_start_time_state_for_entities_stmt(run_start_ts: float, epoch_time: float, metadata_ids: list[int], no_attributes: bool, include_last_changed: bool) -> Select: ...
-def _get_run_start_ts_for_utc_point_in_time(hass: HomeAssistant, utc_point_in_time: datetime) -> float | None: ...
-def _get_start_time_state_stmt(run_start_ts: float, epoch_time: float, single_metadata_id: int | None, metadata_ids: list[int], no_attributes: bool, include_last_changed: bool) -> Select: ...
+def _get_start_time_state_for_entities_stmt(epoch_time: float, metadata_ids: list[int], no_attributes: bool, include_last_changed: bool) -> Select: ...
+def _get_oldest_possible_ts(hass: HomeAssistant, utc_point_in_time: datetime) -> float | None: ...
+def _get_start_time_state_stmt(epoch_time: float, single_metadata_id: int | None, metadata_ids: list[int], no_attributes: bool, include_last_changed: bool) -> Select: ...
 def _get_single_entity_start_time_stmt(epoch_time: float, metadata_id: int, no_attributes: bool, include_last_changed: bool, include_last_reported: bool) -> Select: ...
 def _sorted_states_to_dict(states: Iterable[Row], start_time_ts: float | None, entity_ids: list[str], entity_id_to_metadata_id: dict[str, int | None], minimal_response: bool = False, compressed_state_format: bool = False, descending: bool = False, no_attributes: bool = False) -> dict[str, list[State | dict[str, Any]]]: ...

homeassistant-stubs/components/recorder/migration.pyi

@@ -2,7 +2,7 @@ import abc
 from . import Recorder as Recorder
 from .auto_repairs.statistics.duplicates import delete_statistics_duplicates as delete_statistics_duplicates, delete_statistics_meta_duplicates as delete_statistics_meta_duplicates
 from .const import CONTEXT_ID_AS_BINARY_SCHEMA_VERSION as CONTEXT_ID_AS_BINARY_SCHEMA_VERSION, EVENT_TYPE_IDS_SCHEMA_VERSION as EVENT_TYPE_IDS_SCHEMA_VERSION, LEGACY_STATES_EVENT_ID_INDEX_SCHEMA_VERSION as LEGACY_STATES_EVENT_ID_INDEX_SCHEMA_VERSION, STATES_META_SCHEMA_VERSION as STATES_META_SCHEMA_VERSION, SupportedDialect as SupportedDialect
-from .db_schema import BIG_INTEGER_SQL as BIG_INTEGER_SQL, Base as Base, CONTEXT_ID_BIN_MAX_LENGTH as CONTEXT_ID_BIN_MAX_LENGTH, DOUBLE_PRECISION_TYPE_SQL as DOUBLE_PRECISION_TYPE_SQL, EventTypes as EventTypes, Events as Events, LEGACY_STATES_ENTITY_ID_LAST_UPDATED_INDEX as LEGACY_STATES_ENTITY_ID_LAST_UPDATED_INDEX, LEGACY_STATES_EVENT_ID_INDEX as LEGACY_STATES_EVENT_ID_INDEX, LegacyBase as LegacyBase, MYSQL_COLLATE as MYSQL_COLLATE, MYSQL_DEFAULT_CHARSET as MYSQL_DEFAULT_CHARSET, MigrationChanges as MigrationChanges, SCHEMA_VERSION as SCHEMA_VERSION, STATISTICS_TABLES as STATISTICS_TABLES, SchemaChanges as SchemaChanges, States as States, StatesMeta as StatesMeta, Statistics as Statistics, StatisticsMeta as StatisticsMeta, StatisticsRuns as StatisticsRuns, StatisticsShortTerm as StatisticsShortTerm, TABLE_STATES as TABLE_STATES
+from .db_schema import BIG_INTEGER_SQL as BIG_INTEGER_SQL, Base as Base, CONTEXT_ID_BIN_MAX_LENGTH as CONTEXT_ID_BIN_MAX_LENGTH, DOUBLE_PRECISION_TYPE_SQL as DOUBLE_PRECISION_TYPE_SQL, EventTypes as EventTypes, Events as Events, LEGACY_STATES_ENTITY_ID_LAST_UPDATED_TS_INDEX as LEGACY_STATES_ENTITY_ID_LAST_UPDATED_TS_INDEX, LEGACY_STATES_EVENT_ID_INDEX as LEGACY_STATES_EVENT_ID_INDEX, LegacyBase as LegacyBase, MYSQL_COLLATE as MYSQL_COLLATE, MYSQL_DEFAULT_CHARSET as MYSQL_DEFAULT_CHARSET, MigrationChanges as MigrationChanges, SCHEMA_VERSION as SCHEMA_VERSION, STATISTICS_TABLES as STATISTICS_TABLES, SchemaChanges as SchemaChanges, States as States, StatesMeta as StatesMeta, Statistics as Statistics, StatisticsMeta as StatisticsMeta, StatisticsRuns as StatisticsRuns, StatisticsShortTerm as StatisticsShortTerm, TABLE_STATES as TABLE_STATES
 from .models import process_timestamp as process_timestamp
 from .models.time import datetime_to_timestamp_or_none as datetime_to_timestamp_or_none
 from .queries import batch_cleanup_entity_ids as batch_cleanup_entity_ids, delete_duplicate_short_term_statistics_row as delete_duplicate_short_term_statistics_row, delete_duplicate_statistics_row as delete_duplicate_statistics_row, find_entity_ids_to_migrate as find_entity_ids_to_migrate, find_event_type_to_migrate as find_event_type_to_migrate, find_events_context_ids_to_migrate as find_events_context_ids_to_migrate, find_states_context_ids_to_migrate as find_states_context_ids_to_migrate, find_unmigrated_short_term_statistics_rows as find_unmigrated_short_term_statistics_rows, find_unmigrated_statistics_rows as find_unmigrated_statistics_rows, get_migration_changes as get_migration_changes, has_entity_ids_to_migrate as has_entity_ids_to_migrate, has_event_type_to_migrate as has_event_type_to_migrate, has_events_context_ids_to_migrate as has_events_context_ids_to_migrate, has_states_context_ids_to_migrate as has_states_context_ids_to_migrate, has_used_states_entity_ids as has_used_states_entity_ids, has_used_states_event_ids as has_used_states_event_ids, migrate_single_short_term_statistics_row_to_timestamp as migrate_single_short_term_statistics_row_to_timestamp, migrate_single_statistics_row_to_timestamp as migrate_single_statistics_row_to_timestamp
@@ -17,6 +17,7 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.util.enum import try_parse_enum as try_parse_enum
 from homeassistant.util.ulid import ulid_at_time as ulid_at_time, ulid_to_bytes as ulid_to_bytes
 from sqlalchemy.engine import CursorResult as CursorResult, Engine as Engine
+from sqlalchemy.orm import DeclarativeBase as DeclarativeBase
 from sqlalchemy.orm.session import Session as Session
 from sqlalchemy.schema import AddConstraint
 from sqlalchemy.sql.lambdas import StatementLambdaElement as StatementLambdaElement
@@ -42,18 +43,22 @@ _POSTGRESQL_COLUMN_TYPES: Incomplete
 _SQLITE_COLUMN_TYPES: Incomplete
 _COLUMN_TYPES_FOR_DIALECT: dict[SupportedDialect | None, _ColumnTypesForDialect]
 
+def _unindexable_legacy_column(instance: Recorder, base: type[DeclarativeBase], err: Exception) -> bool: ...
 def raise_if_exception_missing_str(ex: Exception, match_substrs: Iterable[str]) -> None: ...
-def _get_schema_version(session: Session) -> int | None: ...
-def get_schema_version(session_maker: Callable[[], Session]) -> int | None: ...
+def _get_initial_schema_version(session: Session) -> int | None: ...
+def get_initial_schema_version(session_maker: Callable[[], Session]) -> int | None: ...
+def _get_current_schema_version(session: Session) -> int | None: ...
+def get_current_schema_version(session_maker: Callable[[], Session]) -> int | None: ...
 
 @dataclass(frozen=True, kw_only=True)
 class SchemaValidationStatus:
     current_version: int
+    initial_version: int
     migration_needed: bool
     non_live_data_migration_needed: bool
     schema_errors: set[str]
     start_version: int
-    def __init__(self, *, current_version, migration_needed, non_live_data_migration_needed, schema_errors, start_version) -> None: ...
+    def __init__(self, *, current_version, initial_version, migration_needed, non_live_data_migration_needed, schema_errors, start_version) -> None: ...
 
 def _schema_is_current(current_version: int) -> bool: ...
 def validate_db_schema(hass: HomeAssistant, instance: Recorder, session_maker: Callable[[], Session]) -> SchemaValidationStatus | None: ...
@@ -64,10 +69,10 @@ def _migrate_schema(instance: Recorder, hass: HomeAssistant, engine: Engine, ses
 def migrate_schema_non_live(instance: Recorder, hass: HomeAssistant, engine: Engine, session_maker: Callable[[], Session], schema_status: SchemaValidationStatus) -> SchemaValidationStatus: ...
 def migrate_schema_live(instance: Recorder, hass: HomeAssistant, engine: Engine, session_maker: Callable[[], Session], schema_status: SchemaValidationStatus) -> SchemaValidationStatus: ...
 def _get_migration_changes(session: Session) -> dict[str, int]: ...
-def non_live_data_migration_needed(instance: Recorder, session_maker: Callable[[], Session], schema_version: int) -> bool: ...
+def non_live_data_migration_needed(instance: Recorder, session_maker: Callable[[], Session], *, initial_schema_version: int, start_schema_version: int) -> bool: ...
 def migrate_data_non_live(instance: Recorder, session_maker: Callable[[], Session], schema_status: SchemaValidationStatus) -> None: ...
 def migrate_data_live(instance: Recorder, session_maker: Callable[[], Session], schema_status: SchemaValidationStatus) -> None: ...
-def _create_index(session_maker: Callable[[], Session], table_name: str, index_name: str) -> None: ...
+def _create_index(instance: Recorder, session_maker: Callable[[], Session], table_name: str, index_name: str, *, base: type[DeclarativeBase] = ...) -> None: ...
 def _execute_or_collect_error(session_maker: Callable[[], Session], query: str, errors: list[str]) -> bool: ...
 def _drop_index(session_maker: Callable[[], Session], table_name: str, index_name: str, quiet: bool | None = None) -> None: ...
 def _add_columns(session_maker: Callable[[], Session], table_name: str, columns_def: list[str]) -> None: ...
@@ -238,6 +243,9 @@ class _SchemaVersion46Migrator(_SchemaVersionMigrator, target_version=46):
 class _SchemaVersion47Migrator(_SchemaVersionMigrator, target_version=47):
     def _apply_update(self) -> None: ...
 
+class _SchemaVersion48Migrator(_SchemaVersionMigrator, target_version=48):
+    def _apply_update(self) -> None: ...
+
 def _migrate_statistics_columns_to_timestamp_removing_duplicates(hass: HomeAssistant, instance: Recorder, session_maker: Callable[[], Session], engine: Engine) -> None: ...
 def _correct_table_character_set_and_collation(table: str, session_maker: Callable[[], Session]) -> None: ...
 def _wipe_old_string_time_columns(instance: Recorder, engine: Engine, session: Session) -> None: ...
@@ -269,13 +277,15 @@ class DataMigrationStatus:
     def __init__(self, *, needs_migrate, migration_done) -> None: ...
 
 class BaseMigration(ABC, metaclass=abc.ABCMeta):
-    index_to_drop: tuple[str, str] | None
+    index_to_drop: tuple[str, str, type[DeclarativeBase]] | None
     required_schema_version: int
+    max_initial_schema_version: int
     migration_version: int
     migration_id: str
-    schema_version: Incomplete
+    initial_schema_version: Incomplete
+    start_schema_version: Incomplete
     migration_changes: Incomplete
-    def __init__(self, schema_version: int, migration_changes: dict[str, int]) -> None: ...
+    def __init__(self, *, initial_schema_version: int, start_schema_version: int, migration_changes: dict[str, int]) -> None: ...
     @abstractmethod
     def migrate_data(self, instance: Recorder) -> bool: ...
     def _migrate_data(self, instance: Recorder) -> bool: ...
@@ -285,10 +295,12 @@ class BaseMigration(ABC, metaclass=abc.ABCMeta):
     @abstractmethod
     def needs_migrate_impl(self, instance: Recorder, session: Session) -> DataMigrationStatus: ...
     def needs_migrate(self, instance: Recorder, session: Session) -> bool: ...
+    def _has_needed_index(self, session: Session) -> bool | None: ...
 
 class BaseOffLineMigration(BaseMigration, metaclass=abc.ABCMeta):
     def migrate_all(self, instance: Recorder, session_maker: Callable[[], Session]) -> None: ...
     def migrate_data(self, instance: Recorder) -> bool: ...
+    def _ensure_index_exists(self, instance: Recorder) -> None: ...
 
 class BaseRunTimeMigration(BaseMigration, metaclass=abc.ABCMeta):
     task = MigrationTask
@@ -302,6 +314,7 @@ class BaseMigrationWithQuery(BaseMigration, metaclass=abc.ABCMeta):
 
 class StatesContextIDMigration(BaseMigrationWithQuery, BaseOffLineMigration):
     required_schema_version = CONTEXT_ID_AS_BINARY_SCHEMA_VERSION
+    max_initial_schema_version: Incomplete
     migration_id: str
     migration_version: int
     index_to_drop: Incomplete
@@ -310,30 +323,30 @@ class StatesContextIDMigration(BaseMigrationWithQuery, BaseOffLineMigration):
 
 class EventsContextIDMigration(BaseMigrationWithQuery, BaseOffLineMigration):
     required_schema_version = CONTEXT_ID_AS_BINARY_SCHEMA_VERSION
+    max_initial_schema_version: Incomplete
     migration_id: str
     migration_version: int
     index_to_drop: Incomplete
     def migrate_data_impl(self, instance: Recorder) -> DataMigrationStatus: ...
     def needs_migrate_query(self) -> StatementLambdaElement: ...
 
-class EventTypeIDMigration(BaseMigrationWithQuery, BaseRunTimeMigration):
+class EventTypeIDMigration(BaseMigrationWithQuery, BaseOffLineMigration):
     required_schema_version = EVENT_TYPE_IDS_SCHEMA_VERSION
+    max_initial_schema_version: Incomplete
     migration_id: str
-    task = CommitBeforeMigrationTask
     def migrate_data_impl(self, instance: Recorder) -> DataMigrationStatus: ...
-    def migration_done(self, instance: Recorder, session: Session) -> None: ...
     def needs_migrate_query(self) -> StatementLambdaElement: ...
 
-class EntityIDMigration(BaseMigrationWithQuery, BaseRunTimeMigration):
+class EntityIDMigration(BaseMigrationWithQuery, BaseOffLineMigration):
     required_schema_version = STATES_META_SCHEMA_VERSION
+    max_initial_schema_version: Incomplete
     migration_id: str
-    task = CommitBeforeMigrationTask
     def migrate_data_impl(self, instance: Recorder) -> DataMigrationStatus: ...
-    def migration_done(self, instance: Recorder, session: Session) -> None: ...
     def needs_migrate_query(self) -> StatementLambdaElement: ...
 
 class EventIDPostMigration(BaseRunTimeMigration):
     migration_id: str
+    max_initial_schema_version: Incomplete
     task = MigrationTask
     migration_version: int
     def migrate_data_impl(self, instance: Recorder) -> DataMigrationStatus: ...
@@ -341,15 +354,15 @@ class EventIDPostMigration(BaseRunTimeMigration):
     def _legacy_event_id_foreign_key_exists(instance: Recorder) -> bool: ...
     def needs_migrate_impl(self, instance: Recorder, session: Session) -> DataMigrationStatus: ...
 
-class EntityIDPostMigration(BaseMigrationWithQuery, BaseRunTimeMigration):
+class EntityIDPostMigration(BaseMigrationWithQuery, BaseOffLineMigration):
     migration_id: str
-    task = MigrationTask
+    max_initial_schema_version: Incomplete
     index_to_drop: Incomplete
     def migrate_data_impl(self, instance: Recorder) -> DataMigrationStatus: ...
     def needs_migrate_query(self) -> StatementLambdaElement: ...
 
-NON_LIVE_DATA_MIGRATORS: Incomplete
-LIVE_DATA_MIGRATORS: Incomplete
+NON_LIVE_DATA_MIGRATORS: tuple[type[BaseOffLineMigration], ...]
+LIVE_DATA_MIGRATORS: tuple[type[BaseRunTimeMigration], ...]
 
 def _mark_migration_done(session: Session, migration: type[BaseMigration]) -> None: ...
 def rebuild_sqlite_table(session_maker: Callable[[], Session], engine: Engine, table: type[Base]) -> bool: ...

homeassistant-stubs/components/recorder/models/state.pyi

@@ -26,6 +26,9 @@ class LazyState(State):
     def _last_reported_ts(self) -> float | None: ...
     def last_reported(self) -> datetime: ...
     def last_updated(self) -> datetime: ...
+    def last_updated_timestamp(self) -> float: ...
+    def last_changed_timestamp(self) -> float: ...
+    def last_reported_timestamp(self) -> float: ...
     def as_dict(self) -> dict[str, Any]: ...
 
 def row_to_compressed_state(row: Row, attr_cache: dict[str, dict[str, Any]], start_time_ts: float | None, entity_id: str, state: str, last_updated_ts: float | None, no_attributes: bool) -> dict[str, Any]: ...