feat: add MQTT-over-WebSocket client with real-time device telemetry decoding

[Copilot]

This pull request introduces MQTT-over-WebSocket support to the pymbrewclient library, enabling real-time streaming and decoding of MiniBrew device telemetry. It adds a new MqttClient implementation, typed message models, and a CLI command for live device log monitoring. The documentation is updated with usage examples and security caveats. Several internal and public APIs are extended to support MQTT integration.

MQTT-over-WebSocket Integration:

• Added a new MqttClient class and typed message models (MqttMessage, DeviceLogMessage) for real-time device telemetry over MQTT-over-WebSocket, including schema caveats and field-level documentation. (src/pymbrewclient/mqtt/client.py, src/pymbrewclient/mqtt/models.py, src/pymbrewclient/mqtt/__init__.py) [1] [2]
• Updated project dependencies to include paho-mqtt for MQTT support. (pyproject.toml)

CLI Enhancements:

• Added a new watch-device-logs CLI command to stream and print real-time device logs, with options for selecting devices, output format, debug mode, and duration. (src/pymbrewclient/cli.py)
• Improved output serialization and added a utility to curate telemetry output for readability. (src/pymbrewclient/cli.py) [1] [2]

API and Public Interface Updates:

• Extended BreweryClient with create_mqtt_client() and get_user_profile() methods to facilitate MQTT credential generation and user profile access. (src/pymbrewclient/client.py)
• Updated __init__.py exports to include the new MQTT client and models, and to expose UserProfile in the public API. (src/pymbrewclient/__init__.py)

Documentation:

• Added comprehensive documentation and code examples for MQTT usage, security considerations, and protobuf schema limitations. (docs/API_EXAMPLES.md)

These changes collectively enable robust, real-time monitoring of MiniBrew devices through both code and the command line, and lay the groundwork for further MQTT-based features.

[github-actions]

Thanks for opening this pull request, @Copilot!

A maintainer will review your PR soon. In the meantime, please make sure:

• Your code follows the project's style guidelines
• You've added/updated tests as needed
• Your commit messages follow Conventional Commits
• You've updated documentation if necessary

Feel free to ask questions if you need help!

[stuartp44]

@copilot can you add the ability for the new MQTT over WS via the cli?

[Copilot]

@copilot can you add the ability for the new MQTT over WS via the cli?

Done — added a watch-device-logs command to the CLI in commit feat: add watch-device-logs CLI command for real-time MQTT telemetry.

Usage:

pymbrewclient watch-device-logs \
  --username you@example.com \
  --password secret \
  --serial 2403K0561-61BMUWBU

Options:

• --serial — device serial number to watch; can be specified multiple times for multiple devices
• --format — pretty (default) or json
• --duration — stop automatically after N seconds (default: run until Ctrl+C)

Also fixed serialize_output to convert bytes → hex string so DeviceLogMessage.payload serializes cleanly in JSON output.

[github-actions]

🎉 This PR is included in version 1.10.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀