homeassistant-stubs 2025.6.3__py3-none-any.whl → 2025.7.0b0__py3-none-any.whl

homeassistant-stubs/components/russound_rio/media_player.pyi

@@ -4,7 +4,6 @@ from .entity import RussoundBaseEntity as RussoundBaseEntity, command as command
 from _typeshed import Incomplete
 from aiorussound import Controller as Controller
 from aiorussound.models import Source as Source
-from aiorussound.rio import ZoneControlSurface as ZoneControlSurface
 from homeassistant.components.media_player import MediaPlayerDeviceClass as MediaPlayerDeviceClass, MediaPlayerEntity as MediaPlayerEntity, MediaPlayerEntityFeature as MediaPlayerEntityFeature, MediaPlayerState as MediaPlayerState, MediaType as MediaType
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
@@ -18,14 +17,11 @@ class RussoundZoneDevice(RussoundBaseEntity, MediaPlayerEntity):
     _attr_device_class: Incomplete
     _attr_media_content_type: Incomplete
     _attr_supported_features: Incomplete
-    _zone_id: Incomplete
-    _sources: Incomplete
     _attr_name: Incomplete
+    _sources: Incomplete
     _attr_unique_id: Incomplete
     def __init__(self, controller: Controller, zone_id: int, sources: dict[int, Source]) -> None: ...
     @property
-    def _zone(self) -> ZoneControlSurface: ...
-    @property
     def _source(self) -> Source: ...
     @property
     def state(self) -> MediaPlayerState | None: ...

homeassistant-stubs/components/russound_rio/number.pyi

@@ -0,0 +1,30 @@
+from . import RussoundConfigEntry as RussoundConfigEntry
+from .entity import RussoundBaseEntity as RussoundBaseEntity, command as command
+from _typeshed import Incomplete
+from aiorussound.rio import Controller as Controller, ZoneControlSurface as ZoneControlSurface
+from collections.abc import Awaitable, Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.number import NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class RussoundZoneNumberEntityDescription(NumberEntityDescription):
+    value_fn: Callable[[ZoneControlSurface], float]
+    set_value_fn: Callable[[ZoneControlSurface, float], Awaitable[None]]
+
+CONTROL_ENTITIES: tuple[RussoundZoneNumberEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: RussoundConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class RussoundNumberEntity(RussoundBaseEntity, NumberEntity):
+    entity_description: RussoundZoneNumberEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, controller: Controller, zone_id: int, description: RussoundZoneNumberEntityDescription) -> None: ...
+    @property
+    def native_value(self) -> float: ...
+    @command
+    async def async_set_native_value(self, value: float) -> None: ...

homeassistant-stubs/components/russound_rio/switch.pyi

@@ -0,0 +1,33 @@
+from . import RussoundConfigEntry as RussoundConfigEntry
+from .entity import RussoundBaseEntity as RussoundBaseEntity, command as command
+from _typeshed import Incomplete
+from aiorussound.rio import Controller as Controller, ZoneControlSurface as ZoneControlSurface
+from collections.abc import Awaitable, Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.switch import SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from typing import Any
+
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class RussoundZoneSwitchEntityDescription(SwitchEntityDescription):
+    value_fn: Callable[[ZoneControlSurface], bool]
+    set_value_fn: Callable[[ZoneControlSurface, bool], Awaitable[None]]
+
+CONTROL_ENTITIES: tuple[RussoundZoneSwitchEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: RussoundConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class RussoundSwitchEntity(RussoundBaseEntity, SwitchEntity):
+    entity_description: RussoundZoneSwitchEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, controller: Controller, zone_id: int, description: RussoundZoneSwitchEntityDescription) -> None: ...
+    @property
+    def is_on(self) -> bool: ...
+    @command
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    @command
+    async def async_turn_off(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/shopping_list/__init__.pyi

@@ -36,6 +36,7 @@ class ShoppingData:
     async def async_add(self, name: str | None, complete: bool = False, context: Context | None = None) -> dict[str, JsonValueType]: ...
     async def async_remove(self, item_id: str, context: Context | None = None) -> dict[str, JsonValueType] | None: ...
     async def async_remove_items(self, item_ids: set[str], context: Context | None = None) -> list[dict[str, JsonValueType]]: ...
+    async def async_complete(self, name: str, context: Context | None = None) -> list[dict[str, JsonValueType]]: ...
     async def async_update(self, item_id: str | None, info: dict[str, Any], context: Context | None = None) -> dict[str, JsonValueType]: ...
     async def async_clear_completed(self, context: Context | None = None) -> None: ...
     async def async_update_list(self, info: dict[str, JsonValueType], context: Context | None = None) -> list[dict[str, JsonValueType]]: ...

homeassistant-stubs/components/shopping_list/intent.pyi

@@ -1,9 +1,10 @@
-from . import DOMAIN as DOMAIN, EVENT_SHOPPING_LIST_UPDATED as EVENT_SHOPPING_LIST_UPDATED
+from . import DOMAIN as DOMAIN, EVENT_SHOPPING_LIST_UPDATED as EVENT_SHOPPING_LIST_UPDATED, NoMatchingShoppingListItem as NoMatchingShoppingListItem
 from _typeshed import Incomplete
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers import intent as intent
 
 INTENT_ADD_ITEM: str
+INTENT_COMPLETE_ITEM: str
 INTENT_LAST_ITEMS: str
 
 async def async_setup_intents(hass: HomeAssistant) -> None: ...
@@ -15,6 +16,13 @@ class AddItemIntent(intent.IntentHandler):
     platforms: Incomplete
     async def async_handle(self, intent_obj: intent.Intent) -> intent.IntentResponse: ...
 
+class CompleteItemIntent(intent.IntentHandler):
+    intent_type = INTENT_COMPLETE_ITEM
+    description: str
+    slot_schema: Incomplete
+    platforms: Incomplete
+    async def async_handle(self, intent_obj: intent.Intent) -> intent.IntentResponse: ...
+
 class ListTopItemsIntent(intent.IntentHandler):
     intent_type = INTENT_LAST_ITEMS
     description: str

homeassistant-stubs/components/squeezebox/button.pyi

@@ -29,6 +29,4 @@ class SqueezeboxButtonEntity(SqueezeboxEntity, ButtonEntity):
     entity_description: SqueezeboxButtonEntityDescription
     _attr_unique_id: Incomplete
     def __init__(self, coordinator: SqueezeBoxPlayerUpdateCoordinator, entity_description: SqueezeboxButtonEntityDescription) -> None: ...
-    @property
-    def available(self) -> bool: ...
     async def async_press(self) -> None: ...

homeassistant-stubs/components/squeezebox/entity.pyi

@@ -10,6 +10,8 @@ class SqueezeboxEntity(CoordinatorEntity[SqueezeBoxPlayerUpdateCoordinator]):
     _player: Incomplete
     _attr_device_info: Incomplete
     def __init__(self, coordinator: SqueezeBoxPlayerUpdateCoordinator) -> None: ...
+    @property
+    def available(self) -> bool: ...
 
 class LMSStatusEntity(CoordinatorEntity[LMSStatusDataUpdateCoordinator]):
     _attr_has_entity_name: bool

homeassistant-stubs/components/squeezebox/media_player.pyi

@@ -54,8 +54,6 @@ class SqueezeBoxMediaPlayerEntity(SqueezeboxEntity, MediaPlayerEntity):
     @property
     def browse_limit(self) -> int: ...
     @property
-    def available(self) -> bool: ...
-    @property
     def extra_state_attributes(self) -> dict[str, Any]: ...
     @property
     def state(self) -> MediaPlayerState | None: ...

homeassistant-stubs/components/sun/__init__.pyi

@@ -7,6 +7,7 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_component import EntityComponent as EntityComponent
 from homeassistant.helpers.typing import ConfigType as ConfigType
 
+PLATFORMS: Incomplete
 CONFIG_SCHEMA: Incomplete
 _LOGGER: Incomplete
 

homeassistant-stubs/components/sun/binary_sensor.pyi

@@ -0,0 +1,36 @@
+from .const import DOMAIN as DOMAIN, SIGNAL_EVENTS_CHANGED as SIGNAL_EVENTS_CHANGED
+from .entity import Sun as Sun, SunConfigEntry as SunConfigEntry
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.binary_sensor import BinarySensorEntity as BinarySensorEntity, BinarySensorEntityDescription as BinarySensorEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
+from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+
+ENTITY_ID_BINARY_SENSOR_FORMAT: Incomplete
+
+@dataclass(kw_only=True, frozen=True)
+class SunBinarySensorEntityDescription(BinarySensorEntityDescription):
+    value_fn: Callable[[Sun], bool | None]
+    signal: str
+
+BINARY_SENSOR_TYPES: tuple[SunBinarySensorEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: SunConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class SunBinarySensor(BinarySensorEntity):
+    _attr_has_entity_name: bool
+    _attr_should_poll: bool
+    _attr_entity_category: Incomplete
+    entity_description: SunBinarySensorEntityDescription
+    entity_id: Incomplete
+    _attr_unique_id: Incomplete
+    sun: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, sun: Sun, entity_description: SunBinarySensorEntityDescription, entry_id: str) -> None: ...
+    @property
+    def is_on(self) -> bool | None: ...
+    async def async_added_to_hass(self) -> None: ...

homeassistant-stubs/components/sun/condition.pyi

@@ -2,12 +2,22 @@ from _typeshed import Incomplete
 from datetime import timedelta
 from homeassistant.const import CONF_CONDITION as CONF_CONDITION, SUN_EVENT_SUNRISE as SUN_EVENT_SUNRISE, SUN_EVENT_SUNSET as SUN_EVENT_SUNSET
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.condition import ConditionCheckerType as ConditionCheckerType, condition_trace_set_result as condition_trace_set_result, condition_trace_update_result as condition_trace_update_result, trace_condition_function as trace_condition_function
+from homeassistant.helpers.condition import Condition as Condition, ConditionCheckerType as ConditionCheckerType, condition_trace_set_result as condition_trace_set_result, condition_trace_update_result as condition_trace_update_result, trace_condition_function as trace_condition_function
 from homeassistant.helpers.sun import get_astral_event_date as get_astral_event_date
 from homeassistant.helpers.typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType
 
 _CONDITION_SCHEMA: Incomplete
 
-async def async_validate_condition_config(hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
 def sun(hass: HomeAssistant, before: str | None = None, after: str | None = None, before_offset: timedelta | None = None, after_offset: timedelta | None = None) -> bool: ...
-def async_condition_from_config(config: ConfigType) -> ConditionCheckerType: ...
+
+class SunCondition(Condition):
+    _config: Incomplete
+    _hass: Incomplete
+    def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    @classmethod
+    async def async_validate_condition_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
+    async def async_condition_from_config(self) -> ConditionCheckerType: ...
+
+CONDITIONS: dict[str, type[Condition]]
+
+async def async_get_conditions(hass: HomeAssistant) -> dict[str, type[Condition]]: ...

homeassistant-stubs/components/sun/sensor.pyi

@@ -10,6 +10,7 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
 from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue, async_delete_issue as async_delete_issue
 from homeassistant.helpers.typing import StateType as StateType
 
 ENTITY_ID_SENSOR_FORMAT: Incomplete
@@ -36,3 +37,4 @@ class SunSensor(SensorEntity):
     @property
     def native_value(self) -> StateType | datetime: ...
     async def async_added_to_hass(self) -> None: ...
+    async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/switch/light.pyi

@@ -1,3 +1,4 @@
+from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from homeassistant.components.light import ColorMode as ColorMode, LightEntity as LightEntity
 from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_NAME as CONF_NAME, SERVICE_TURN_OFF as SERVICE_TURN_OFF, SERVICE_TURN_ON as SERVICE_TURN_ON, STATE_ON as STATE_ON, STATE_UNAVAILABLE as STATE_UNAVAILABLE

homeassistant-stubs/components/switch_as_x/entity.pyi

@@ -1,3 +1,4 @@
+from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from homeassistant.components.homeassistant import exposed_entities as exposed_entities
 from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, SERVICE_TURN_OFF as SERVICE_TURN_OFF, SERVICE_TURN_ON as SERVICE_TURN_ON, STATE_ON as STATE_ON, STATE_UNAVAILABLE as STATE_UNAVAILABLE

homeassistant-stubs/components/synology_dsm/__init__.pyi

@@ -1,16 +1,19 @@
 from .common import SynoApi as SynoApi, raise_config_entry_auth_error as raise_config_entry_auth_error
 from .const import CONF_BACKUP_PATH as CONF_BACKUP_PATH, CONF_BACKUP_SHARE as CONF_BACKUP_SHARE, DATA_BACKUP_AGENT_LISTENERS as DATA_BACKUP_AGENT_LISTENERS, DEFAULT_VERIFY_SSL as DEFAULT_VERIFY_SSL, DOMAIN as DOMAIN, EXCEPTION_DETAILS as EXCEPTION_DETAILS, EXCEPTION_UNKNOWN as EXCEPTION_UNKNOWN, PLATFORMS as PLATFORMS, SYNOLOGY_AUTH_FAILED_EXCEPTIONS as SYNOLOGY_AUTH_FAILED_EXCEPTIONS, SYNOLOGY_CONNECTION_EXCEPTIONS as SYNOLOGY_CONNECTION_EXCEPTIONS
 from .coordinator import SynologyDSMCameraUpdateCoordinator as SynologyDSMCameraUpdateCoordinator, SynologyDSMCentralUpdateCoordinator as SynologyDSMCentralUpdateCoordinator, SynologyDSMConfigEntry as SynologyDSMConfigEntry, SynologyDSMData as SynologyDSMData, SynologyDSMSwitchUpdateCoordinator as SynologyDSMSwitchUpdateCoordinator
-from .service import async_setup_services as async_setup_services
+from .services import async_setup_services as async_setup_services
 from _typeshed import Incomplete
 from homeassistant.const import CONF_MAC as CONF_MAC, CONF_SCAN_INTERVAL as CONF_SCAN_INTERVAL, CONF_VERIFY_SSL as CONF_VERIFY_SSL
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
 from homeassistant.helpers import device_registry as dr
+from homeassistant.helpers.typing import ConfigType as ConfigType
 from synology_dsm.api.surveillance_station.camera import SynoCamera as SynoCamera
 
 _LOGGER: Incomplete
+CONFIG_SCHEMA: Incomplete
 
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 async def async_setup_entry(hass: HomeAssistant, entry: SynologyDSMConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: SynologyDSMConfigEntry) -> bool: ...
 async def _async_update_listener(hass: HomeAssistant, entry: SynologyDSMConfigEntry) -> None: ...

homeassistant-stubs/components/synology_dsm/{service.pyi → services.pyi}

@@ -1,8 +1,10 @@
 from .const import CONF_SERIAL as CONF_SERIAL, DOMAIN as DOMAIN, SERVICES as SERVICES, SERVICE_REBOOT as SERVICE_REBOOT, SERVICE_SHUTDOWN as SERVICE_SHUTDOWN
 from .coordinator import SynologyDSMConfigEntry as SynologyDSMConfigEntry
 from _typeshed import Incomplete
-from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall
+from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback
 
 LOGGER: Incomplete
 
-async def async_setup_services(hass: HomeAssistant) -> None: ...
+async def _service_handler(call: ServiceCall) -> None: ...
+@callback
+def async_setup_services(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/tedee/binary_sensor.pyi

@@ -13,6 +13,8 @@ PARALLEL_UPDATES: int
 @dataclass(frozen=True, kw_only=True)
 class TedeeBinarySensorEntityDescription(BinarySensorEntityDescription):
     is_on_fn: Callable[[TedeeLock], bool | None]
+    supported_fn: Callable[[TedeeLock], bool] = ...
+    available_fn: Callable[[TedeeLock], bool] = ...
 
 ENTITIES: tuple[TedeeBinarySensorEntityDescription, ...]
 
@@ -22,3 +24,5 @@ class TedeeBinarySensorEntity(TedeeDescriptionEntity, BinarySensorEntity):
     entity_description: TedeeBinarySensorEntityDescription
     @property
     def is_on(self) -> bool | None: ...
+    @property
+    def available(self) -> bool: ...

homeassistant-stubs/components/telegram_bot/__init__.pyi

@@ -0,0 +1,34 @@
+from . import broadcast as broadcast, polling as polling, webhooks as webhooks
+from .bot import TelegramBotConfigEntry as TelegramBotConfigEntry, TelegramNotificationService as TelegramNotificationService, initialize_bot as initialize_bot
+from .const import ATTR_ALLOWS_MULTIPLE_ANSWERS as ATTR_ALLOWS_MULTIPLE_ANSWERS, ATTR_AUTHENTICATION as ATTR_AUTHENTICATION, ATTR_CALLBACK_QUERY_ID as ATTR_CALLBACK_QUERY_ID, ATTR_CAPTION as ATTR_CAPTION, ATTR_CHAT_ID as ATTR_CHAT_ID, ATTR_DISABLE_NOTIF as ATTR_DISABLE_NOTIF, ATTR_DISABLE_WEB_PREV as ATTR_DISABLE_WEB_PREV, ATTR_FILE as ATTR_FILE, ATTR_IS_ANONYMOUS as ATTR_IS_ANONYMOUS, ATTR_IS_BIG as ATTR_IS_BIG, ATTR_KEYBOARD as ATTR_KEYBOARD, ATTR_KEYBOARD_INLINE as ATTR_KEYBOARD_INLINE, ATTR_MESSAGE as ATTR_MESSAGE, ATTR_MESSAGEID as ATTR_MESSAGEID, ATTR_MESSAGE_TAG as ATTR_MESSAGE_TAG, ATTR_MESSAGE_THREAD_ID as ATTR_MESSAGE_THREAD_ID, ATTR_ONE_TIME_KEYBOARD as ATTR_ONE_TIME_KEYBOARD, ATTR_OPEN_PERIOD as ATTR_OPEN_PERIOD, ATTR_OPTIONS as ATTR_OPTIONS, ATTR_PARSER as ATTR_PARSER, ATTR_PASSWORD as ATTR_PASSWORD, ATTR_QUESTION as ATTR_QUESTION, ATTR_REACTION as ATTR_REACTION, ATTR_RESIZE_KEYBOARD as ATTR_RESIZE_KEYBOARD, ATTR_SHOW_ALERT as ATTR_SHOW_ALERT, ATTR_STICKER_ID as ATTR_STICKER_ID, ATTR_TARGET as ATTR_TARGET, ATTR_TIMEOUT as ATTR_TIMEOUT, ATTR_TITLE as ATTR_TITLE, ATTR_URL as ATTR_URL, ATTR_USERNAME as ATTR_USERNAME, ATTR_VERIFY_SSL as ATTR_VERIFY_SSL, CONF_ALLOWED_CHAT_IDS as CONF_ALLOWED_CHAT_IDS, CONF_BOT_COUNT as CONF_BOT_COUNT, CONF_CONFIG_ENTRY_ID as CONF_CONFIG_ENTRY_ID, CONF_PROXY_URL as CONF_PROXY_URL, CONF_TRUSTED_NETWORKS as CONF_TRUSTED_NETWORKS, DEFAULT_TRUSTED_NETWORKS as DEFAULT_TRUSTED_NETWORKS, DOMAIN as DOMAIN, PARSER_MD as PARSER_MD, PLATFORM_BROADCAST as PLATFORM_BROADCAST, PLATFORM_POLLING as PLATFORM_POLLING, PLATFORM_WEBHOOKS as PLATFORM_WEBHOOKS, SERVICE_ANSWER_CALLBACK_QUERY as SERVICE_ANSWER_CALLBACK_QUERY, SERVICE_DELETE_MESSAGE as SERVICE_DELETE_MESSAGE, SERVICE_EDIT_CAPTION as SERVICE_EDIT_CAPTION, SERVICE_EDIT_MESSAGE as SERVICE_EDIT_MESSAGE, SERVICE_EDIT_REPLYMARKUP as SERVICE_EDIT_REPLYMARKUP, SERVICE_LEAVE_CHAT as SERVICE_LEAVE_CHAT, SERVICE_SEND_ANIMATION as SERVICE_SEND_ANIMATION, SERVICE_SEND_DOCUMENT as SERVICE_SEND_DOCUMENT, SERVICE_SEND_LOCATION as SERVICE_SEND_LOCATION, SERVICE_SEND_MESSAGE as SERVICE_SEND_MESSAGE, SERVICE_SEND_PHOTO as SERVICE_SEND_PHOTO, SERVICE_SEND_POLL as SERVICE_SEND_POLL, SERVICE_SEND_STICKER as SERVICE_SEND_STICKER, SERVICE_SEND_VIDEO as SERVICE_SEND_VIDEO, SERVICE_SEND_VOICE as SERVICE_SEND_VOICE, SERVICE_SET_MESSAGE_REACTION as SERVICE_SET_MESSAGE_REACTION
+from _typeshed import Incomplete
+from homeassistant.config_entries import SOURCE_IMPORT as SOURCE_IMPORT
+from homeassistant.const import ATTR_LATITUDE as ATTR_LATITUDE, ATTR_LONGITUDE as ATTR_LONGITUDE, CONF_API_KEY as CONF_API_KEY, CONF_PLATFORM as CONF_PLATFORM, CONF_SOURCE as CONF_SOURCE, CONF_URL as CONF_URL
+from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryNotReady as ConfigEntryNotReady, ServiceValidationError as ServiceValidationError
+from homeassistant.helpers.typing import ConfigType as ConfigType
+from telegram import Bot as Bot
+from types import ModuleType
+
+_LOGGER: Incomplete
+CONFIG_SCHEMA: Incomplete
+BASE_SERVICE_SCHEMA: Incomplete
+SERVICE_SCHEMA_SEND_MESSAGE: Incomplete
+SERVICE_SCHEMA_SEND_FILE: Incomplete
+SERVICE_SCHEMA_SEND_STICKER: Incomplete
+SERVICE_SCHEMA_SEND_LOCATION: Incomplete
+SERVICE_SCHEMA_SEND_POLL: Incomplete
+SERVICE_SCHEMA_EDIT_MESSAGE: Incomplete
+SERVICE_SCHEMA_EDIT_CAPTION: Incomplete
+SERVICE_SCHEMA_EDIT_REPLYMARKUP: Incomplete
+SERVICE_SCHEMA_ANSWER_CALLBACK_QUERY: Incomplete
+SERVICE_SCHEMA_DELETE_MESSAGE: Incomplete
+SERVICE_SCHEMA_LEAVE_CHAT: Incomplete
+SERVICE_SCHEMA_SET_MESSAGE_REACTION: Incomplete
+SERVICE_MAP: Incomplete
+MODULES: dict[str, ModuleType]
+
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: TelegramBotConfigEntry) -> bool: ...
+async def update_listener(hass: HomeAssistant, entry: TelegramBotConfigEntry) -> None: ...
+async def async_unload_entry(hass: HomeAssistant, entry: TelegramBotConfigEntry) -> bool: ...

homeassistant-stubs/components/telegram_bot/bot.pyi

@@ -0,0 +1,63 @@
+import abc
+import io
+from .const import ATTR_ARGS as ATTR_ARGS, ATTR_AUTHENTICATION as ATTR_AUTHENTICATION, ATTR_CAPTION as ATTR_CAPTION, ATTR_CHAT_ID as ATTR_CHAT_ID, ATTR_CHAT_INSTANCE as ATTR_CHAT_INSTANCE, ATTR_DATA as ATTR_DATA, ATTR_DATE as ATTR_DATE, ATTR_DISABLE_NOTIF as ATTR_DISABLE_NOTIF, ATTR_DISABLE_WEB_PREV as ATTR_DISABLE_WEB_PREV, ATTR_FILE as ATTR_FILE, ATTR_FROM_FIRST as ATTR_FROM_FIRST, ATTR_FROM_LAST as ATTR_FROM_LAST, ATTR_KEYBOARD as ATTR_KEYBOARD, ATTR_KEYBOARD_INLINE as ATTR_KEYBOARD_INLINE, ATTR_MESSAGE as ATTR_MESSAGE, ATTR_MESSAGEID as ATTR_MESSAGEID, ATTR_MESSAGE_TAG as ATTR_MESSAGE_TAG, ATTR_MESSAGE_THREAD_ID as ATTR_MESSAGE_THREAD_ID, ATTR_MSG as ATTR_MSG, ATTR_MSGID as ATTR_MSGID, ATTR_ONE_TIME_KEYBOARD as ATTR_ONE_TIME_KEYBOARD, ATTR_OPEN_PERIOD as ATTR_OPEN_PERIOD, ATTR_PARSER as ATTR_PARSER, ATTR_PASSWORD as ATTR_PASSWORD, ATTR_REPLYMARKUP as ATTR_REPLYMARKUP, ATTR_REPLY_TO_MSGID as ATTR_REPLY_TO_MSGID, ATTR_RESIZE_KEYBOARD as ATTR_RESIZE_KEYBOARD, ATTR_STICKER_ID as ATTR_STICKER_ID, ATTR_TEXT as ATTR_TEXT, ATTR_TIMEOUT as ATTR_TIMEOUT, ATTR_TITLE as ATTR_TITLE, ATTR_URL as ATTR_URL, ATTR_USERNAME as ATTR_USERNAME, ATTR_USER_ID as ATTR_USER_ID, ATTR_VERIFY_SSL as ATTR_VERIFY_SSL, CONF_CHAT_ID as CONF_CHAT_ID, CONF_PROXY_URL as CONF_PROXY_URL, DOMAIN as DOMAIN, EVENT_TELEGRAM_CALLBACK as EVENT_TELEGRAM_CALLBACK, EVENT_TELEGRAM_COMMAND as EVENT_TELEGRAM_COMMAND, EVENT_TELEGRAM_SENT as EVENT_TELEGRAM_SENT, EVENT_TELEGRAM_TEXT as EVENT_TELEGRAM_TEXT, PARSER_HTML as PARSER_HTML, PARSER_MD as PARSER_MD, PARSER_MD2 as PARSER_MD2, PARSER_PLAIN_TEXT as PARSER_PLAIN_TEXT, SERVICE_EDIT_CAPTION as SERVICE_EDIT_CAPTION, SERVICE_EDIT_MESSAGE as SERVICE_EDIT_MESSAGE, SERVICE_SEND_ANIMATION as SERVICE_SEND_ANIMATION, SERVICE_SEND_DOCUMENT as SERVICE_SEND_DOCUMENT, SERVICE_SEND_PHOTO as SERVICE_SEND_PHOTO, SERVICE_SEND_STICKER as SERVICE_SEND_STICKER, SERVICE_SEND_VIDEO as SERVICE_SEND_VIDEO, SERVICE_SEND_VOICE as SERVICE_SEND_VOICE
+from _typeshed import Incomplete
+from abc import abstractmethod
+from collections.abc import Callable as Callable, Sequence
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import ATTR_COMMAND as ATTR_COMMAND, CONF_API_KEY as CONF_API_KEY, HTTP_BASIC_AUTHENTICATION as HTTP_BASIC_AUTHENTICATION, HTTP_BEARER_AUTHENTICATION as HTTP_BEARER_AUTHENTICATION, HTTP_DIGEST_AUTHENTICATION as HTTP_DIGEST_AUTHENTICATION
+from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceValidationError as ServiceValidationError
+from homeassistant.util.ssl import get_default_context as get_default_context, get_default_no_verify_context as get_default_no_verify_context
+from ssl import SSLContext
+from telegram import Bot, CallbackQuery as CallbackQuery, InputPollOption as InputPollOption, Message as Message, Update as Update, User as User
+from telegram.ext import CallbackContext as CallbackContext
+from types import MappingProxyType
+from typing import Any
+
+_LOGGER: Incomplete
+type TelegramBotConfigEntry = ConfigEntry[TelegramNotificationService]
+
+class BaseTelegramBot(metaclass=abc.ABCMeta):
+    hass: Incomplete
+    config: Incomplete
+    def __init__(self, hass: HomeAssistant, config: TelegramBotConfigEntry) -> None: ...
+    @abstractmethod
+    async def shutdown(self) -> None: ...
+    async def handle_update(self, update: Update, context: CallbackContext) -> bool: ...
+    @staticmethod
+    def _get_command_event_data(command_text: str | None) -> dict[str, str | list]: ...
+    def _get_message_event_data(self, message: Message) -> tuple[str, dict[str, Any]]: ...
+    def _get_user_event_data(self, user: User) -> dict[str, Any]: ...
+    def _get_callback_query_event_data(self, callback_query: CallbackQuery) -> tuple[str, dict[str, Any]]: ...
+    def authorize_update(self, update: Update) -> bool: ...
+
+class TelegramNotificationService:
+    app: Incomplete
+    config: Incomplete
+    _parsers: dict[str, str | None]
+    parse_mode: Incomplete
+    bot: Incomplete
+    hass: Incomplete
+    _last_message_id: dict[int, int]
+    def __init__(self, hass: HomeAssistant, app: BaseTelegramBot, bot: Bot, config: TelegramBotConfigEntry, parser: str) -> None: ...
+    def _get_allowed_chat_ids(self) -> list[int]: ...
+    def _get_msg_ids(self, msg_data: dict[str, Any], chat_id: int) -> tuple[Any | None, int | None]: ...
+    def _get_target_chat_ids(self, target: Any) -> list[int]: ...
+    def _get_msg_kwargs(self, data: dict[str, Any]) -> dict[str, Any]: ...
+    async def _send_msg(self, func_send: Callable, msg_error: str, message_tag: str | None, *args_msg: Any, context: Context | None = None, **kwargs_msg: Any) -> Any: ...
+    async def send_message(self, message: str = '', target: Any = None, context: Context | None = None, **kwargs: dict[str, Any]) -> dict[int, int]: ...
+    async def delete_message(self, chat_id: int | None = None, context: Context | None = None, **kwargs: dict[str, Any]) -> bool: ...
+    async def edit_message(self, type_edit: str, chat_id: int | None = None, context: Context | None = None, **kwargs: dict[str, Any]) -> Any: ...
+    async def answer_callback_query(self, message: str | None, callback_query_id: str, show_alert: bool = False, context: Context | None = None, **kwargs: dict[str, Any]) -> None: ...
+    async def send_file(self, file_type: str, target: Any = None, context: Context | None = None, **kwargs: Any) -> dict[int, int]: ...
+    async def send_sticker(self, target: Any = None, context: Context | None = None, **kwargs: Any) -> dict[int, int]: ...
+    async def send_location(self, latitude: Any, longitude: Any, target: Any = None, context: Context | None = None, **kwargs: dict[str, Any]) -> dict[int, int]: ...
+    async def send_poll(self, question: str, options: Sequence[str | InputPollOption], is_anonymous: bool | None, allows_multiple_answers: bool | None, target: Any = None, context: Context | None = None, **kwargs: dict[str, Any]) -> dict[int, int]: ...
+    async def leave_chat(self, chat_id: Any = None, context: Context | None = None, **kwargs: dict[str, Any]) -> Any: ...
+    async def set_message_reaction(self, chat_id: int, reaction: str, is_big: bool = False, context: Context | None = None, **kwargs: dict[str, Any]) -> None: ...
+
+def initialize_bot(hass: HomeAssistant, p_config: MappingProxyType[str, Any]) -> Bot: ...
+async def load_data(hass: HomeAssistant, url: str | None, filepath: str | None, username: str, password: str, authentication: str | None, verify_ssl: SSLContext, num_retries: int = 5) -> io.BytesIO: ...
+def _validate_credentials_input(authentication: str | None, username: str | None, password: str | None) -> None: ...
+def _read_file_as_bytesio(file_path: str) -> io.BytesIO: ...

homeassistant-stubs/components/telegram_bot/broadcast.pyi

@@ -0,0 +1,5 @@
+from .bot import BaseTelegramBot as BaseTelegramBot, TelegramBotConfigEntry as TelegramBotConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+from telegram import Bot as Bot
+
+async def async_setup_platform(hass: HomeAssistant, bot: Bot, config: TelegramBotConfigEntry) -> type[BaseTelegramBot] | None: ...

homeassistant-stubs/components/telegram_bot/config_flow.pyi

@@ -0,0 +1,53 @@
+import voluptuous as vol
+from . import initialize_bot as initialize_bot
+from .bot import TelegramBotConfigEntry as TelegramBotConfigEntry
+from .const import ATTR_PARSER as ATTR_PARSER, BOT_NAME as BOT_NAME, CONF_ALLOWED_CHAT_IDS as CONF_ALLOWED_CHAT_IDS, CONF_BOT_COUNT as CONF_BOT_COUNT, CONF_CHAT_ID as CONF_CHAT_ID, CONF_PROXY_URL as CONF_PROXY_URL, CONF_TRUSTED_NETWORKS as CONF_TRUSTED_NETWORKS, DEFAULT_TRUSTED_NETWORKS as DEFAULT_TRUSTED_NETWORKS, DOMAIN as DOMAIN, ERROR_FIELD as ERROR_FIELD, ERROR_MESSAGE as ERROR_MESSAGE, ISSUE_DEPRECATED_YAML as ISSUE_DEPRECATED_YAML, ISSUE_DEPRECATED_YAML_HAS_MORE_PLATFORMS as ISSUE_DEPRECATED_YAML_HAS_MORE_PLATFORMS, ISSUE_DEPRECATED_YAML_IMPORT_ISSUE_ERROR as ISSUE_DEPRECATED_YAML_IMPORT_ISSUE_ERROR, PARSER_HTML as PARSER_HTML, PARSER_MD as PARSER_MD, PARSER_MD2 as PARSER_MD2, PARSER_PLAIN_TEXT as PARSER_PLAIN_TEXT, PLATFORM_BROADCAST as PLATFORM_BROADCAST, PLATFORM_POLLING as PLATFORM_POLLING, PLATFORM_WEBHOOKS as PLATFORM_WEBHOOKS, SUBENTRY_TYPE_ALLOWED_CHAT_IDS as SUBENTRY_TYPE_ALLOWED_CHAT_IDS
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, ConfigSubentryData as ConfigSubentryData, ConfigSubentryFlow as ConfigSubentryFlow, OptionsFlow as OptionsFlow, SOURCE_IMPORT as SOURCE_IMPORT, SOURCE_RECONFIGURE as SOURCE_RECONFIGURE, SubentryFlowResult as SubentryFlowResult
+from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_PLATFORM as CONF_PLATFORM, CONF_URL as CONF_URL
+from homeassistant.core import callback as callback
+from homeassistant.data_entry_flow import AbortFlow as AbortFlow
+from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
+from homeassistant.helpers.network import NoURLAvailableError as NoURLAvailableError, get_url as get_url
+from homeassistant.helpers.selector import SelectSelector as SelectSelector, SelectSelectorConfig as SelectSelectorConfig, TextSelector as TextSelector, TextSelectorConfig as TextSelectorConfig, TextSelectorType as TextSelectorType
+from telegram import Bot as Bot, ChatFullInfo as ChatFullInfo
+from typing import Any
+
+_LOGGER: Incomplete
+STEP_USER_DATA_SCHEMA: vol.Schema
+STEP_RECONFIGURE_USER_DATA_SCHEMA: vol.Schema
+STEP_REAUTH_DATA_SCHEMA: vol.Schema
+STEP_WEBHOOKS_DATA_SCHEMA: vol.Schema
+OPTIONS_SCHEMA: vol.Schema
+
+class OptionsFlowHandler(OptionsFlow):
+    async def async_step_init(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+
+class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
+    VERSION: int
+    @staticmethod
+    @callback
+    def async_get_options_flow(config_entry: TelegramBotConfigEntry) -> OptionsFlowHandler: ...
+    @classmethod
+    @callback
+    def async_get_supported_subentry_types(cls, config_entry: TelegramBotConfigEntry) -> dict[str, type[ConfigSubentryFlow]]: ...
+    _bot: Bot | None
+    _bot_name: str
+    _step_user_data: dict[str, Any]
+    def __init__(self) -> None: ...
+    async def async_step_import(self, import_data: dict[str, Any]) -> ConfigFlowResult: ...
+    def _create_issue(self, issue: str, telegram_bot_type: str, bot_count: int, description_placeholders: Mapping[str, str] | None = None) -> None: ...
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def _shutdown_bot(self) -> None: ...
+    async def _validate_bot(self, user_input: dict[str, Any], errors: dict[str, str], placeholders: dict[str, str]) -> str: ...
+    async def async_step_webhooks(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    def _validate_webhooks(self, user_input: dict[str, Any], errors: dict[str, str], description_placeholders: dict[str, str]) -> None: ...
+    async def async_step_reconfigure(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: ...
+
+class AllowedChatIdsSubEntryFlowHandler(ConfigSubentryFlow):
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> SubentryFlowResult: ...
+
+async def _async_get_chat_name(bot: Bot | None, chat_id: int) -> str: ...

homeassistant-stubs/components/telegram_bot/const.pyi

@@ -0,0 +1,92 @@
+from _typeshed import Incomplete
+
+DOMAIN: str
+PLATFORM_BROADCAST: str
+PLATFORM_POLLING: str
+PLATFORM_WEBHOOKS: str
+SUBENTRY_TYPE_ALLOWED_CHAT_IDS: str
+CONF_BOT_COUNT: str
+CONF_ALLOWED_CHAT_IDS: str
+CONF_CONFIG_ENTRY_ID: str
+CONF_PROXY_URL: str
+CONF_TRUSTED_NETWORKS: str
+CONF_CHAT_ID: str
+BOT_NAME: str
+ERROR_FIELD: str
+ERROR_MESSAGE: str
+ISSUE_DEPRECATED_YAML: str
+ISSUE_DEPRECATED_YAML_HAS_MORE_PLATFORMS: str
+ISSUE_DEPRECATED_YAML_IMPORT_ISSUE_ERROR: str
+DEFAULT_TRUSTED_NETWORKS: Incomplete
+SERVICE_SEND_MESSAGE: str
+SERVICE_SEND_PHOTO: str
+SERVICE_SEND_STICKER: str
+SERVICE_SEND_ANIMATION: str
+SERVICE_SEND_VIDEO: str
+SERVICE_SEND_VOICE: str
+SERVICE_SEND_DOCUMENT: str
+SERVICE_SEND_LOCATION: str
+SERVICE_SEND_POLL: str
+SERVICE_SET_MESSAGE_REACTION: str
+SERVICE_EDIT_MESSAGE: str
+SERVICE_EDIT_CAPTION: str
+SERVICE_EDIT_REPLYMARKUP: str
+SERVICE_ANSWER_CALLBACK_QUERY: str
+SERVICE_DELETE_MESSAGE: str
+SERVICE_LEAVE_CHAT: str
+EVENT_TELEGRAM_CALLBACK: str
+EVENT_TELEGRAM_COMMAND: str
+EVENT_TELEGRAM_TEXT: str
+EVENT_TELEGRAM_SENT: str
+PARSER_HTML: str
+PARSER_MD: str
+PARSER_MD2: str
+PARSER_PLAIN_TEXT: str
+ATTR_DATA: str
+ATTR_MESSAGE: str
+ATTR_TITLE: str
+ATTR_ARGS: str
+ATTR_AUTHENTICATION: str
+ATTR_CALLBACK_QUERY: str
+ATTR_CALLBACK_QUERY_ID: str
+ATTR_CAPTION: str
+ATTR_CHAT_ID: str
+ATTR_CHAT_INSTANCE: str
+ATTR_DATE: str
+ATTR_DISABLE_NOTIF: str
+ATTR_DISABLE_WEB_PREV: str
+ATTR_EDITED_MSG: str
+ATTR_FILE: str
+ATTR_FROM_FIRST: str
+ATTR_FROM_LAST: str
+ATTR_KEYBOARD: str
+ATTR_RESIZE_KEYBOARD: str
+ATTR_ONE_TIME_KEYBOARD: str
+ATTR_KEYBOARD_INLINE: str
+ATTR_MESSAGEID: str
+ATTR_MSG: str
+ATTR_MSGID: str
+ATTR_PARSER: str
+ATTR_PASSWORD: str
+ATTR_REACTION: str
+ATTR_IS_BIG: str
+ATTR_REPLY_TO_MSGID: str
+ATTR_REPLYMARKUP: str
+ATTR_SHOW_ALERT: str
+ATTR_STICKER_ID: str
+ATTR_TARGET: str
+ATTR_TEXT: str
+ATTR_URL: str
+ATTR_USER_ID: str
+ATTR_USERNAME: str
+ATTR_VERIFY_SSL: str
+ATTR_TIMEOUT: str
+ATTR_MESSAGE_TAG: str
+ATTR_CHANNEL_POST: str
+ATTR_QUESTION: str
+ATTR_OPTIONS: str
+ATTR_ANSWERS: str
+ATTR_OPEN_PERIOD: str
+ATTR_IS_ANONYMOUS: str
+ATTR_ALLOWS_MULTIPLE_ANSWERS: str
+ATTR_MESSAGE_THREAD_ID: str

homeassistant-stubs/components/telegram_bot/polling.pyi

@@ -0,0 +1,19 @@
+from .bot import BaseTelegramBot as BaseTelegramBot, TelegramBotConfigEntry as TelegramBotConfigEntry
+from _typeshed import Incomplete
+from homeassistant.core import HomeAssistant as HomeAssistant
+from telegram import Bot as Bot
+from telegram.ext import CallbackContext as CallbackContext
+
+_LOGGER: Incomplete
+
+async def async_setup_platform(hass: HomeAssistant, bot: Bot, config: TelegramBotConfigEntry) -> BaseTelegramBot | None: ...
+async def process_error(update: object, context: CallbackContext) -> None: ...
+def error_callback(error: Exception, update: object | None = None) -> None: ...
+
+class PollBot(BaseTelegramBot):
+    bot: Incomplete
+    application: Incomplete
+    def __init__(self, hass: HomeAssistant, bot: Bot, config: TelegramBotConfigEntry) -> None: ...
+    async def shutdown(self) -> None: ...
+    async def start_polling(self) -> None: ...
+    async def stop_polling(self) -> None: ...

homeassistant-stubs/components/telegram_bot/webhooks.pyi

@@ -0,0 +1,47 @@
+from .bot import BaseTelegramBot as BaseTelegramBot, TelegramBotConfigEntry as TelegramBotConfigEntry
+from .const import CONF_TRUSTED_NETWORKS as CONF_TRUSTED_NETWORKS
+from _typeshed import Incomplete
+from aiohttp.web_response import Response as Response
+from homeassistant.components.http import HomeAssistantRequest as HomeAssistantRequest, HomeAssistantView as HomeAssistantView
+from homeassistant.const import CONF_URL as CONF_URL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.helpers.network import get_url as get_url
+from ipaddress import IPv4Network
+from telegram import Bot as Bot
+from telegram.ext import Application as Application
+
+_LOGGER: Incomplete
+TELEGRAM_WEBHOOK_URL: str
+REMOVE_WEBHOOK_URL: str
+SECRET_TOKEN_LENGTH: int
+
+async def async_setup_platform(hass: HomeAssistant, bot: Bot, config: TelegramBotConfigEntry) -> BaseTelegramBot | None: ...
+def _get_trusted_networks(config: TelegramBotConfigEntry) -> list[IPv4Network]: ...
+
+class PushBot(BaseTelegramBot):
+    bot: Incomplete
+    trusted_networks: Incomplete
+    secret_token: Incomplete
+    application: Incomplete
+    base_url: Incomplete
+    webhook_url: Incomplete
+    def __init__(self, hass: HomeAssistant, bot: Bot, config: TelegramBotConfigEntry, secret_token: str) -> None: ...
+    async def shutdown(self) -> None: ...
+    async def _try_to_set_webhook(self) -> bool: ...
+    async def start_application(self) -> None: ...
+    async def register_webhook(self) -> bool: ...
+    async def stop_application(self) -> None: ...
+    async def deregister_webhook(self) -> None: ...
+
+class PushBotView(HomeAssistantView):
+    requires_auth: bool
+    url = TELEGRAM_WEBHOOK_URL
+    name: str
+    hass: Incomplete
+    bot: Incomplete
+    application: Incomplete
+    trusted_networks: Incomplete
+    secret_token: Incomplete
+    def __init__(self, hass: HomeAssistant, bot: Bot, application: Application, trusted_networks: list[IPv4Network], secret_token: str) -> None: ...
+    async def post(self, request: HomeAssistantRequest) -> Response | None: ...