Merge pull request #118 from SpanPanel/2_3_1

v2.3.1 catch connect failure to the MQTT broker

Author: cayossarian

CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.1] - 03/2026
+
+### Fixed
+
+- **MQTT connection errors now wrapped as `SpanPanelConnectionError`** — `OSError` subclasses raised during MQTT broker connection (DNS resolution failure, connection refused, network unreachable, etc.) are now caught and wrapped as
+  `SpanPanelConnectionError`. Previously these propagated as unhandled exceptions, preventing consumers from handling them gracefully.
+
+## [2.3.0] - 03/2026
+
+### Removed
+
+- **Simulation engine removed** — `DynamicSimulationEngine`, `SimulationConfig`, and all simulation-related modules have been removed from the library. Simulation is now handled by the standalone SPAN Panel Simulator add-on.
+
 ## [2.2.4] - 03/2026
 
 ### Fixed

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "span-panel-api"
-version = "2.3.0"
+version = "2.3.1"
 description = "A client library for SPAN Panel API"
 authors = [
     {name = "SpanPanel"}

src/span_panel_api/mqtt/connection.py

@@ -175,7 +175,12 @@ def _blocking_tls_and_connect() -> None:
                 self._client.on_socket_open = self._on_socket_open_sync
                 self._client.on_socket_register_write = self._on_socket_register_write_sync
                 _LOGGER.debug("BRIDGE: Running TLS+connect in executor to %s:%s", self._host, self._port)
-                await self._loop.run_in_executor(None, _blocking_tls_and_connect)
+                try:
+                    await self._loop.run_in_executor(None, _blocking_tls_and_connect)
+                except OSError as exc:
+                    raise SpanPanelConnectionError(
+                        f"Cannot connect to MQTT broker at {self._host}:{self._port}: {exc}"
+                    ) from exc
                 _LOGGER.debug("BRIDGE: Executor connect returned, waiting for CONNACK...")
             finally:
                 # Switch to async-only socket callbacks now that we are