zwave-js-server-python 0.68.0__tar.gz → 0.70.0__tar.gz

{zwave_js_server_python-0.68.0/zwave_js_server_python.egg-info → zwave_js_server_python-0.70.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zwave-js-server-python
-Version: 0.68.0
+Version: 0.70.0
 Summary: Python wrapper for zwave-js-server
 Author-email: Home Assistant Team <hello@home-assistant.io>
 License-Expression: Apache-2.0

{zwave_js_server_python-0.68.0 → zwave_js_server_python-0.70.0}/zwave_js_server/const/__init__.py

@@ -3,17 +3,17 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from enum import Enum, IntEnum
+from enum import IntEnum, StrEnum
 import logging
 from typing import TypedDict
 
 PACKAGE_NAME = "zwave-js-server-python"
-__version__ = "0.68.0"
+__version__ = "0.70.0"
 
 # minimal server schema version we can handle
-MIN_SERVER_SCHEMA_VERSION = 44
+MIN_SERVER_SCHEMA_VERSION = 47
 # max server schema version we can handle (and our code is compatible with)
-MAX_SERVER_SCHEMA_VERSION = 44
+MAX_SERVER_SCHEMA_VERSION = 47
 
 VALUE_UNKNOWN = "unknown"
 
@@ -30,7 +30,7 @@ TRANSITION_DURATION_OPTION = "transitionDuration"
 VOLUME_OPTION = "volume"
 
 
-class CommandStatus(str, Enum):
+class CommandStatus(StrEnum):
     """Status of a command sent to zwave-js-server."""
 
     ACCEPTED = "accepted"
@@ -39,7 +39,7 @@ class CommandStatus(str, Enum):
 
 # Multiple inheritance so that LogLevel will JSON serialize properly
 # Reference: https://stackoverflow.com/a/51976841
-class LogLevel(str, Enum):
+class LogLevel(StrEnum):
     """Enum for log levels used by node-zwave-js."""
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/log/shared.ts#L12
@@ -212,7 +212,7 @@ class NodeStatus(IntEnum):
     ALIVE = 4
 
 
-class ConfigurationValueType(str, Enum):
+class ConfigurationValueType(StrEnum):
     """Enum for configuration value types."""
 
     BOOLEAN = "boolean"
@@ -457,7 +457,7 @@ class DateAndTimeDataType(TypedDict, total=False):
     standardOffset: int
 
 
-@dataclass
+@dataclass(frozen=True)
 class DateAndTime:
     """Represent a date and time."""
 
@@ -474,16 +474,16 @@ class DateAndTime:
 
     def __post_init__(self) -> None:
         """Post initialization."""
-        self.hour = self.data.get("hour")
-        self.minute = self.data.get("minute")
+        object.__setattr__(self, "hour", self.data.get("hour"))
+        object.__setattr__(self, "minute", self.data.get("minute"))
         if weekday := self.data.get("weekday"):
-            self.weekday = Weekday(weekday)
-        self.second = self.data.get("second")
-        self.year = self.data.get("year")
-        self.month = self.data.get("month")
-        self.day = self.data.get("day")
-        self.dst_offset = self.data.get("dstOffset")
-        self.standard_offset = self.data.get("standardOffset")
+            object.__setattr__(self, "weekday", Weekday(weekday))
+        object.__setattr__(self, "second", self.data.get("second"))
+        object.__setattr__(self, "year", self.data.get("year"))
+        object.__setattr__(self, "month", self.data.get("month"))
+        object.__setattr__(self, "day", self.data.get("day"))
+        object.__setattr__(self, "dst_offset", self.data.get("dstOffset"))
+        object.__setattr__(self, "standard_offset", self.data.get("standardOffset"))
 
 
 class ControllerStatus(IntEnum):

zwave_js_server_python-0.70.0/zwave_js_server/const/command_class/battery.py

@@ -0,0 +1,14 @@
+"""Constants for the Battery CC."""
+
+from __future__ import annotations
+
+from enum import IntEnum
+
+
+class BatteryReplacementStatus(IntEnum):
+    """Enum with all (known/used) Z-Wave Battery Replacement Statuses."""
+
+    # https://github.com/zwave-js/node-zwave-js/blob/master/packages/cc/src/lib/_Types.ts#L328
+    NO = 0
+    SOON = 1
+    NOW = 2

{zwave_js_server_python-0.68.0 → zwave_js_server_python-0.70.0}/zwave_js_server/const/command_class/lock.py

@@ -7,7 +7,7 @@ Includes Door Lock and Lock CCs.
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from enum import Enum, IntEnum
+from enum import IntEnum, StrEnum
 from typing import TypedDict
 
 from .. import CommandClass
@@ -49,7 +49,7 @@ DOOR_LOCK_CC_UNSECURED_MAP = {
 }
 
 
-class LatchStatus(str, Enum):
+class LatchStatus(StrEnum):
     """Enum with all (known/used) Z-Wave latch statuses."""
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/cc/src/cc/DoorLockCC.ts#L854
@@ -57,7 +57,7 @@ class LatchStatus(str, Enum):
     CLOSED = "closed"
 
 
-class BoltStatus(str, Enum):
+class BoltStatus(StrEnum):
     """Enum with all (known/used) Z-Wave bolt statuses."""
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/cc/src/cc/DoorLockCC.ts#L854
@@ -65,7 +65,7 @@ class BoltStatus(str, Enum):
     UNLOCKED = "unlocked"
 
 
-class DoorStatus(str, Enum):
+class DoorStatus(StrEnum):
     """Enum with all (known/used) Z-Wave door statuses."""
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/cc/src/cc/DoorLockCC.ts#L854
@@ -151,7 +151,7 @@ class DoorLockCCConfigurationSetOptionsDataType(TypedDict, total=False):
 DEFAULT_HANDLE_CONFIGURATION = [True, True, True, True]
 
 
-@dataclass
+@dataclass(frozen=True)
 class DoorLockCCConfigurationSetOptions:
     """Door Lock CC Configuration Set command options."""
 
@@ -173,7 +173,7 @@ class DoorLockCCConfigurationSetOptions:
             "outside_handles_can_open_door_configuration",
         ):
             if not getattr(self, attr_name):
-                setattr(self, attr_name, DEFAULT_HANDLE_CONFIGURATION)
+                object.__setattr__(self, attr_name, list(DEFAULT_HANDLE_CONFIGURATION))
 
     def to_dict(self) -> DoorLockCCConfigurationSetOptionsDataType:
         """Convert command options to dict."""

{zwave_js_server_python-0.68.0 → zwave_js_server_python-0.70.0}/zwave_js_server/const/command_class/notification.py

@@ -89,6 +89,7 @@ class AccessControlNotificationEvent(NotificationEvent):
     DOOR_HANDLE_STATE_WINDOW_DOOR_HANDLE_IS_OPEN = 24
     DOOR_STATE_WINDOW_DOOR_IS_CLOSED = 23
     DOOR_STATE_WINDOW_DOOR_IS_OPEN = 22
+    IDLE = 0
     INVALID_CREDENTIAL_USED = 50
     KEYPAD_LOCK_OPERATION = 5
     KEYPAD_STATE_KEYPAD_BUSY = 17
@@ -212,6 +213,7 @@ class ApplianceNotificationEvent(NotificationEvent):
     DRAINING_FAILURE = 15
     DRYING_FAILURE = 19
     FAN_FAILURE = 20
+    IDLE = 0
     MAINTENANCE_STATUS_REPLACE_MAIN_FILTER = 4
     PROGRAM_STATUS_PROGRAM_COMPLETED = 3
     PROGRAM_STATUS_PROGRAM_IN_PROGRESS = 2
@@ -235,6 +237,7 @@ class ClockNotificationEvent(NotificationEvent):
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
+    IDLE = 0
     TIME_REMAINING = 3
     TIMER_ENDED = 2
     WAKE_UP_ALERT = 1
@@ -251,6 +254,7 @@ class CoAlarmNotificationEvent(NotificationEvent):
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
     ALARM_STATUS_ALARM_SILENCED = 6
+    IDLE = 0
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED = 4
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED_END_OF_LIFE = 5
     PERIODIC_INSPECTION_STATUS_MAINTENANCE_REQUIRED_PLANNED_PERIODIC_INSPECTION = 7
@@ -286,6 +290,7 @@ class Co2AlarmNotificationEvent(NotificationEvent):
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
     ALARM_STATUS_ALARM_SILENCED = 6
+    IDLE = 0
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED = 4
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED_END_OF_LIFE = 5
     PERIODIC_INSPECTION_STATUS_MAINTENANCE_REQUIRED_PLANNED_PERIODIC_INSPECTION = 7
@@ -325,6 +330,7 @@ class EmergencyAlarmNotificationEvent(NotificationEvent):
     CONTACT_FIRE_SERVICE = 2
     CONTACT_MEDICAL_SERVICE = 3
     CONTACT_POLICE = 1
+    IDLE = 0
 
     @classmethod
     def _missing_(
@@ -342,6 +348,7 @@ class GasAlarmNotificationEvent(NotificationEvent):
     ALARM_STATUS_GAS_ALARM_TEST = 5
     COMBUSTIBLE_GAS_STATUS_COMBUSTIBLE_GAS_DETECTED = 2
     COMBUSTIBLE_GAS_STATUS_COMBUSTIBLE_GAS_DETECTED_LOCATION_PROVIDED = 1
+    IDLE = 0
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED = 6
     TOXIC_GAS_STATUS_TOXIC_GAS_DETECTED = 4
     TOXIC_GAS_STATUS_TOXIC_GAS_DETECTED_LOCATION_PROVIDED = 3
@@ -366,6 +373,7 @@ class HeatAlarmNotificationEvent(NotificationEvent):
     HEAT_SENSOR_STATUS_OVERHEAT_DETECTED_LOCATION_PROVIDED = 1
     HEAT_SENSOR_STATUS_UNDERHEAT_DETECTED = 6
     HEAT_SENSOR_STATUS_UNDERHEAT_DETECTED_LOCATION_PROVIDED = 5
+    IDLE = 0
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED_END_OF_LIFE = 8
     PERIODIC_INSPECTION_STATUS_MAINTENANCE_REQUIRED_PLANNED_PERIODIC_INSPECTION = 11
     RAPID_TEMPERATURE_FALL = 13
@@ -387,6 +395,7 @@ class HomeHealthNotificationEvent(NotificationEvent):
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
     FALL_DETECTED = 12
+    IDLE = 0
     POSITION_STATUS_LEAVING_BED = 1
     POSITION_STATUS_LYING_ON_BED = 3
     POSITION_STATUS_SITTING_ON_BED = 2
@@ -452,6 +461,7 @@ class HomeMonitoringNotificationEvent(NotificationEvent):
     UNKNOWN = -1
     HOME_OCCUPANCY_STATUS_HOME_OCCUPIED = 2
     HOME_OCCUPANCY_STATUS_HOME_OCCUPIED_LOCATION_PROVIDED = 1
+    IDLE = 0
 
     @classmethod
     def _missing_(
@@ -469,6 +479,7 @@ class HomeSecurityNotificationEvent(NotificationEvent):
     COVER_STATUS_TAMPERING_PRODUCT_COVER_REMOVED = 3
     GLASS_BREAKAGE = 6
     GLASS_BREAKAGE_LOCATION_PROVIDED = 5
+    IDLE = 0
     IMPACT_DETECTED = 10
     MAGNETIC_INTERFERENCE_STATUS_MAGNETIC_FIELD_INTERFERENCE_DETECTED = 11
     MOTION_SENSOR_STATUS_MOTION_DETECTION = 8
@@ -493,6 +504,7 @@ class IrrigationNotificationEvent(NotificationEvent):
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
     DEVICE_CONFIGURATION_STATUS_DEVICE_IS_NOT_CONFIGURED = 5
+    IDLE = 0
     SCHEDULE_ID_STATUS_SCHEDULE_FINISHED = 2
     SCHEDULE_ID_STATUS_SCHEDULE_STARTED = 1
     VALVE_ID_RUN_STATUS_VALVE_TABLE_RUN_FINISHED = 4
@@ -511,6 +523,7 @@ class LightSensorNotificationEvent(NotificationEvent):
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
+    IDLE = 0
     LIGHT_COLOR_TRANSITION_DETECTED = 2
     LIGHT_DETECTION_STATUS_LIGHT_DETECTED = 1
 
@@ -527,6 +540,7 @@ class PestControlNotificationEvent(NotificationEvent):
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
+    IDLE = 0
     PEST_DETECTED = 6
     PEST_DETECTED_LOCATION_PROVIDED = 5
     PEST_EXTERMINATED = 8
@@ -558,6 +572,7 @@ class PowerManagementNotificationEvent(NotificationEvent):
     BATTERY_MAINTENANCE_STATUS_BATTERY_FLUID_IS_LOW = 17
     BATTERY_MAINTENANCE_STATUS_REPLACE_BATTERY_NOW = 11
     BATTERY_MAINTENANCE_STATUS_REPLACE_BATTERY_SOON = 10
+    IDLE = 0
     LOAD_ERROR = 9
     MAINS_STATUS_AC_MAINS_DISCONNECTED = 2
     MAINS_STATUS_AC_MAINS_RE_CONNECTED = 3
@@ -581,6 +596,7 @@ class SirenNotificationEvent(NotificationEvent):
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
+    IDLE = 0
     SIREN_STATUS_SIREN_ACTIVE = 1
 
     @classmethod
@@ -597,6 +613,7 @@ class SmokeAlarmNotificationEvent(NotificationEvent):
     ALARM_STATUS_ALARM_SILENCED = 6
     ALARM_STATUS_SMOKE_ALARM_TEST = 3
     DUST_IN_DEVICE_STATUS_MAINTENANCE_REQUIRED_DUST_IN_DEVICE = 8
+    IDLE = 0
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED = 4
     MAINTENANCE_STATUS_REPLACEMENT_REQUIRED_END_OF_LIFE = 5
     PERIODIC_INSPECTION_STATUS_MAINTENANCE_REQUIRED_PLANNED_PERIODIC_INSPECTION = 7
@@ -621,6 +638,7 @@ class SystemNotificationEvent(NotificationEvent):
     HARDWARE_STATUS_SYSTEM_HARDWARE_FAILURE = 1
     HARDWARE_STATUS_SYSTEM_HARDWARE_FAILURE_WITH_FAILURE_CODE = 3
     HEARTBEAT = 5
+    IDLE = 0
     SOFTWARE_STATUS_SYSTEM_SOFTWARE_FAILURE = 2
     SOFTWARE_STATUS_SYSTEM_SOFTWARE_FAILURE_WITH_FAILURE_CODE = 4
 
@@ -635,6 +653,7 @@ class WaterAlarmNotificationEvent(NotificationEvent):
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
+    IDLE = 0
     MAINTENANCE_STATUS_REPLACE_WATER_FILTER = 5
     PUMP_STATUS_SUMP_PUMP_ACTIVE = 10
     PUMP_STATUS_SUMP_PUMP_FAILURE = 11
@@ -741,6 +760,7 @@ class WaterQualityMonitoringNotificationEvent(NotificationEvent):
     FILTER_PUMP_STATUS_FILTER_PUMP_OPERATION_ONGOING = 11
     FRESHWATER_FLOW_STATUS_FRESHWATER_OPERATION_ONGOING = 12
     HEATING_STATUS_HEATING_OPERATION_ONGOING = 10
+    IDLE = 0
     WATER_OXIDATION_ALARM = 3
     WATER_TANK_STATUS_WATER_TANK_IS_EMPTY = 14
     WATER_TANK_STATUS_WATER_TANK_IS_FULL = 16
@@ -811,6 +831,7 @@ class WaterValveNotificationEvent(NotificationEvent):
 
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
+    IDLE = 0
     MASTER_VALVE_CURRENT_ALARM = 6
     MASTER_VALVE_OPERATION = 2
     MASTER_VALVE_SHORT_CIRCUIT = 4
@@ -901,6 +922,7 @@ class WeatherAlarmNotificationEvent(NotificationEvent):
     # https://github.com/zwave-js/node-zwave-js/blob/master/packages/core/src/registries/Notifications.ts
     UNKNOWN = -1
     FREEZE_ALARM = 3
+    IDLE = 0
     MOISTURE_ALARM = 2
     RAIN_ALARM = 1
 

{zwave_js_server_python-0.68.0 → zwave_js_server_python-0.70.0}/zwave_js_server/model/association.py

@@ -10,7 +10,7 @@ if TYPE_CHECKING:
     from .node import Node
 
 
-@dataclass
+@dataclass(frozen=True)
 class AssociationGroup:
     """Represent a association group dict type."""
 
@@ -22,7 +22,7 @@ class AssociationGroup:
     issued_commands: dict[int, list[int]] = field(default_factory=dict)
 
 
-@dataclass
+@dataclass(frozen=True)
 class AssociationAddress:
     """Represent a association dict type."""
 

{zwave_js_server_python-0.68.0 → zwave_js_server_python-0.70.0}/zwave_js_server/model/controller/__init__.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from dataclasses import dataclass
+from functools import cached_property
 import logging
 from typing import TYPE_CHECKING, Any, Literal, cast
 
@@ -26,7 +26,13 @@ from ...util.helpers import convert_base64_to_bytes, convert_bytes_to_base64
 from ..association import AssociationAddress, AssociationGroup
 from ..node import Node
 from ..node.firmware import NodeFirmwareUpdateResult
-from .data_model import ControllerDataType
+from .data_model import (
+    BackgroundRSSI,
+    ControllerDataType,
+    NVMProgress,
+    ZWaveApiVersionDataType,
+    ZWaveChipType,
+)
 from .event_model import CONTROLLER_EVENT_MODEL_MAP
 from .inclusion_and_provisioning import (
     InclusionGrant,
@@ -64,14 +70,6 @@ DEFAULT_CONTROLLER_STATISTICS = (  # pylint: disable=invalid-name
 )
 
 
-@dataclass
-class NVMProgress:
-    """Class to represent an NVM backup/restore progress event."""
-
-    bytes_read_or_written: int
-    total_bytes: int
-
-
 class Controller(EventBase):
     """Represent a Z-Wave JS controller."""
 
@@ -247,9 +245,37 @@ class Controller(EventBase):
         """Return whether controller supports long range or not."""
         return self.data.get("supportsLongRange")
 
+    @property
+    def is_sis(self) -> bool | None:
+        """Return whether the controller is the SIS (Static Information Source)."""
+        return self.data.get("isSIS")
+
+    @property
+    def max_payload_size(self) -> int | None:
+        """Return the maximum Z-Wave payload size in bytes."""
+        return self.data.get("maxPayloadSize")
+
+    @property
+    def max_payload_size_lr(self) -> int | None:
+        """Return the maximum Long Range payload size in bytes."""
+        return self.data.get("maxPayloadSizeLR")
+
+    @property
+    def zwave_api_version(self) -> ZWaveApiVersionDataType | None:
+        """Return the Z-Wave API version (kind + version) supported by the controller."""
+        return self.data.get("zwaveApiVersion")
+
+    @cached_property
+    def zwave_chip_type(self) -> ZWaveChipType | None:
+        """Return the Z-Wave chip type."""
+        if (raw := self.data.get("zwaveChipType")) is None:
+            return None
+        return ZWaveChipType.from_dict(raw)
+
     def update(self, data: ControllerDataType) -> None:
         """Update controller data."""
         self.data = data
+        self.__dict__.pop("zwave_chip_type", None)
         self._statistics = ControllerStatistics(
             self.data.get("statistics", DEFAULT_CONTROLLER_STATISTICS)
         )
@@ -887,6 +913,107 @@ class Controller(EventBase):
         )
         return cast(bool, data["progress"])
 
+    async def async_get_background_rssi(self) -> BackgroundRSSI:
+        """Send getBackgroundRSSI command to Controller."""
+        data = await self.client.async_send_command(
+            {"command": "controller.get_background_rssi"},
+            require_schema=47,
+        )
+        return BackgroundRSSI(
+            channel_0=data["rssiChannel0"],
+            channel_1=data["rssiChannel1"],
+            channel_2=data.get("rssiChannel2"),
+            channel_3=data.get("rssiChannel3"),
+        )
+
+    async def async_get_long_range_nodes(self) -> list[Node]:
+        """Send getLongRangeNodes command to Controller."""
+        data = await self.client.async_send_command(
+            {"command": "controller.get_long_range_nodes"},
+            require_schema=47,
+        )
+        return [self.nodes[nid] for nid in data["nodeIds"]]
+
+    async def async_get_all_association_groups(
+        self, node: Node
+    ) -> dict[int, dict[int, AssociationGroup]]:
+        """Send getAllAssociationGroups command to Controller."""
+        data = await self.client.async_send_command(
+            {
+                "command": "controller.get_all_association_groups",
+                "nodeId": node.node_id,
+            },
+            require_schema=47,
+        )
+        return {
+            int(endpoint_id): {
+                int(group_id): AssociationGroup(
+                    max_nodes=group["maxNodes"],
+                    is_lifeline=group["isLifeline"],
+                    multi_channel=group["multiChannel"],
+                    label=group["label"],
+                    profile=group.get("profile"),
+                    issued_commands={
+                        int(cc): cmds
+                        for cc, cmds in group.get("issuedCommands", {}).items()
+                    },
+                )
+                for group_id, group in groups.items()
+            }
+            for endpoint_id, groups in data["groups"].items()
+        }
+
+    async def async_get_all_associations(
+        self, node: Node
+    ) -> dict[int, dict[int, dict[int, list[AssociationAddress]]]]:
+        """Send getAllAssociations command to Controller."""
+        data = await self.client.async_send_command(
+            {
+                "command": "controller.get_all_associations",
+                "nodeId": node.node_id,
+            },
+            require_schema=47,
+        )
+        return {
+            int(node_id_str): {
+                int(endpoint_id): {
+                    int(group_id): [
+                        AssociationAddress(
+                            self,
+                            node_id=addr["nodeId"],
+                            endpoint=addr.get("endpoint"),
+                        )
+                        for addr in addresses
+                    ]
+                    for group_id, addresses in groups.items()
+                }
+                for endpoint_id, groups in endpoints.items()
+            }
+            for node_id_str, endpoints in data["associations"].items()
+        }
+
+    async def async_get_all_available_firmware_updates(
+        self,
+        api_key: str,
+        include_prereleases: bool = True,
+        rf_region: RFRegion | None = None,
+    ) -> dict[int, list[NodeFirmwareUpdateInfo]]:
+        """Send getAllAvailableFirmwareUpdates command to Controller."""
+        cmd: dict[str, Any] = {
+            "command": "controller.get_all_available_firmware_updates",
+            "apiKey": api_key,
+            "includePrereleases": include_prereleases,
+        }
+        if rf_region is not None:
+            cmd["rfRegion"] = rf_region.value
+        data = await self.client.async_send_command(cmd, require_schema=47)
+        return {
+            int(node_id): [
+                NodeFirmwareUpdateInfo.from_dict(update) for update in updates
+            ]
+            for node_id, updates in data["updates"].items()
+        }
+
     def receive_event(self, event: Event) -> None:
         """Receive an event."""
         if event.data["source"] == "node":
@@ -1014,3 +1141,26 @@ class Controller(EventBase):
         """Process a status changed event."""
         self.data["status"] = event.data["status"]
         event.data["status"] = ControllerStatus(event.data["status"])
+
+    def handle_network_found(self, _event: Event) -> None:
+        """Process a `network found` event without mutating controller identity."""
+        # TODO: Revisit whether `homeId` / `ownNodeId` from this event should
+        # update `self.data` once upstream semantics are confirmed.
+
+    def handle_network_joined(self, event: Event) -> None:
+        """Process a `network joined` event (schema 47+)."""
+
+    def handle_network_left(self, event: Event) -> None:
+        """Process a `network left` event (schema 47+)."""
+
+    def handle_joining_network_failed(self, event: Event) -> None:
+        """Process a `joining network failed` event (schema 47+)."""
+
+    def handle_joining_network_show_dsk(self, event: Event) -> None:
+        """Process a `joining network show dsk` event (schema 47+)."""
+
+    def handle_joining_network_done(self, event: Event) -> None:
+        """Process a `joining network done` event (schema 47+)."""
+
+    def handle_leaving_network_failed(self, event: Event) -> None:
+        """Process a `leaving network failed` event (schema 47+)."""

zwave_js_server_python-0.70.0/zwave_js_server/model/controller/data_model.py

@@ -0,0 +1,98 @@
+"""Data model for a Z-Wave JS controller."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Literal, TypedDict
+
+from .statistics import ControllerStatisticsDataType
+
+
+class ZWaveApiVersionDataType(TypedDict):
+    """Represent a Z-Wave API version (schema 47+)."""
+
+    kind: Literal["official", "legacy"]
+    version: int
+
+
+class UnknownZWaveChipTypeDataType(TypedDict):
+    """Represent an unknown Z-Wave chip type descriptor (schema 47+)."""
+
+    type: int
+    version: int
+
+
+@dataclass(frozen=True)
+class ZWaveChipType:
+    """Z-Wave chip type descriptor (schema 47+).
+
+    For known chips, `name` is set (e.g. ``"ZW0700"``).
+    For unknown chips, `type` and `version` are set instead.
+    """
+
+    name: str | None = None
+    type: int | None = None
+    version: int | None = None
+
+    @classmethod
+    def from_dict(cls, data: str | UnknownZWaveChipTypeDataType) -> ZWaveChipType:
+        """Initialize from dict."""
+        if isinstance(data, str):
+            return cls(name=data)
+        return cls(type=data["type"], version=data["version"])
+
+
+@dataclass(frozen=True)
+class NVMProgress:
+    """Class to represent an NVM operation progress event.
+
+    Used for backup, restore, and convert progress updates.
+    """
+
+    bytes_read_or_written: int
+    total_bytes: int
+
+
+@dataclass(frozen=True)
+class BackgroundRSSI:
+    """Background RSSI noise levels for all channels."""
+
+    channel_0: int
+    channel_1: int
+    channel_2: int | None = None
+    channel_3: int | None = None
+
+
+class ControllerDataType(TypedDict, total=False):
+    """Represent a controller data dict type."""
+
+    sdkVersion: str
+    type: int
+    homeId: int
+    ownNodeId: int
+    isPrimary: bool
+    isSUC: bool
+    nodeType: int
+    isUsingHomeIdFromOtherNetwork: bool
+    isSISPresent: bool
+    wasRealPrimary: bool
+    firmwareVersion: str
+    manufacturerId: int
+    productType: int
+    productId: int
+    supportedFunctionTypes: list[int]
+    sucNodeId: int
+    supportsTimers: bool
+    isRebuildingRoutes: bool
+    statistics: ControllerStatisticsDataType
+    inclusionState: int
+    rfRegion: int
+    status: int
+    rebuildRoutesProgress: dict[str, str]
+    supportsLongRange: bool
+    # Schema 47+ properties
+    isSIS: bool
+    maxPayloadSize: int
+    maxPayloadSizeLR: int
+    zwaveApiVersion: ZWaveApiVersionDataType
+    zwaveChipType: str | UnknownZWaveChipTypeDataType