feat: cache printer-reported camera stream URLs on FlashForgeClient

Add Adventurer 3 (A3) full TCP client support, cache the OEM camera
stream URL from machine-info responses on FlashForgeClient, and
substantially improve discovery, TCP client, and parser reliability.

- Add FlashForgeA3Client with dedicated G-code protocol support
- Add A3GCodeController for Adventurer 3 command set
- Add FlashForgeClient.camera_stream_url populated from machine-info
- Major refactor of discovery.py for cross-printer reliability
- tcp_client.py reworked with improved connection and parser coverage
- All parsers updated for better type safety and correctness
- Add thumbnail_info parser for printer thumbnail responses
- Extend package exports to include A3 client and types
- Add test coverage for A3 client, camera stream URL, and model parity
- Bump version to 1.1.0

Author: GhostTypes

CHANGELOG.md

@@ -5,6 +5,32 @@ 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).
 
+## [1.1.0] - 2026-03-08
+
+### Added
+- `FlashForgeA3Client` — full Adventurer 3 TCP client with dedicated G-code protocol support
+- `A3GCodeController` — A3-specific G-code command controller
+- `FlashForgeClient.camera_stream_url` — caches the OEM camera stream URL reported by the printer in machine-info responses
+- `thumbnail_info` parser for handling printer thumbnail responses
+- New G-code commands in `gcodes.py` for broader printer compatibility
+- Test coverage for A3 client, camera stream URL caching, and machine-info model parity
+- mypy exclude configuration for tests and examples
+
+### Changed
+- Major refactor of `discovery.py` for improved reliability and cross-printer compatibility
+- `tcp_client.py` substantially reworked for better connection handling and parser coverage
+- Parsers (`endstop_status`, `location_info`, `print_status`, `printer_info`, `temp_info`) updated for improved type safety and correctness
+- `client.py` extended with camera stream URL caching from machine-info responses
+- `control.py` updated with refined API surface
+- `info.py` refactored for cleaner response handling
+- Ruff linter configuration updated to use `[tool.ruff.lint]` table (ruff >=0.1.0 syntax)
+- Package exports in `__init__.py` updated to include new A3 types and client
+- TCP module exports updated to expose A3 client and controller
+
+### Fixed
+- Discovery reliability improvements from `discovery.py` refactor
+- TCP client parser edge cases addressed across all response types
+
 ## [1.0.2] - 2025-12-26
 
 ### Added

README.md

@@ -28,7 +28,7 @@
 | **File Operations** | List, upload, and download files • Extract print thumbnails • File metadata retrieval |
 | **Async Architecture** | Native async/await implementation • Non-blocking network operations • Concurrent operations support |
 | **Type Safety** | Full type hints for IDE autocomplete • Pydantic models for data validation • mypy strict mode compatible |
-| **Model Detection** | Automatic capability detection • Feature flags for model-specific functions • Graceful degradation for older models |
+| **Model Detection** | Automatic capability detection • Runtime camera stream detection via `camera_stream_url` • Graceful degradation for older models |
 
 </div>
 
@@ -156,6 +156,31 @@ async def monitor_printer():
 asyncio.run(monitor_printer())
 ```
 
+### Camera Stream Detection
+
+Use the printer-reported runtime camera stream URL as the OEM camera source of truth:
+
+```python
+from flashforge import FlashForgeClient
+import asyncio
+
+async def check_camera():
+    async with FlashForgeClient("192.168.1.100", "SERIAL", "CODE") as client:
+        if not await client.initialize():
+            return
+
+        if client.camera_stream_url:
+            print(f"OEM camera stream: {client.camera_stream_url}")
+        else:
+            print("Printer is not reporting an active OEM camera stream")
+
+        # Camera power control remains Pro-only.
+        if client.is_pro:
+            await client.control.turn_camera_on()
+
+asyncio.run(check_camera())
+```
+
 ### File Operations and Thumbnails
 
 List files and extract G-code thumbnails:

docs/api_reference.md

@@ -64,6 +64,7 @@ FlashForgeClient(ip_address: str, serial_number: str, check_code: str)
 - `is_pro: bool` - True if Pro model
 - `firmware_version: str` - Firmware version string
 - `mac_address: str` - MAC address
+- `camera_stream_url: str` - Runtime OEM camera stream URL reported by the printer
 - `led_control: bool` - True if LED control available
 - `filtration_control: bool` - True if filtration control available
 
@@ -149,6 +150,14 @@ General machine control operations.
 - `async set_filtration_off() -> bool`  
   Turns off all filtration systems.
 
+#### Camera Control
+
+- `async turn_camera_on() -> bool`  
+  Sends the OEM camera enable command for Pro models.
+
+- `async turn_camera_off() -> bool`  
+  Sends the OEM camera disable command for Pro models.
+
 #### Fan Control
 
 - `async set_chamber_fan_speed(speed: int) -> bool`  
@@ -411,6 +420,7 @@ Structured printer status and information.
 - `firmware_version: str` - Firmware version
 - `ip_address: str` - IP address
 - `mac_address: str` - MAC address
+- `camera_stream_url: str` - OEM camera stream URL, or empty when the printer is not reporting one
 - `print_file_name: str` - Current print file
 - `print_progress: float` - Print progress (0.0-100.0)
 - `current_print_layer: int` - Current layer number

docs/client.md

@@ -103,6 +103,22 @@ async with FlashForgeClient(ip, serial, check_code) as client:
     await client.job_control.cancel_print_job()
 ```
 
+#### Detect OEM Camera Stream
+
+```python
+async with FlashForgeClient(ip, serial, check_code) as client:
+    await client.initialize()
+
+    if client.camera_stream_url:
+        print(f"OEM camera stream: {client.camera_stream_url}")
+    else:
+        print("No active OEM camera stream reported by the printer")
+
+    # Camera power control remains Pro-only.
+    if client.is_pro:
+        await client.control.turn_camera_on()
+```
+
 #### List Files
 
 ```python

docs/models.md

@@ -22,6 +22,7 @@ The primary model for printer status, aggregating data from various sources into
 | `firmware_version` | `str` | Firmware version string |
 | `ip_address` | `str` | Printer IP address |
 | `mac_address` | `str` | MAC address |
+| `camera_stream_url` | `str` | OEM camera stream URL reported by the printer, or empty when inactive |
 
 #### Temperature Properties
 

flashforge/__init__.py

@@ -51,12 +51,23 @@ async def main():
 
 # Import utility classes
 from .api.network.utils import NetworkUtils
-from .client import FlashForgeClient
+from .client import FiveMClientConnectionOptions, FlashForgeClient
 
 # Import discovery classes
 from .discovery import (
+    DiscoveredPrinter,
+    DiscoveryError,
+    DiscoveryMonitor,
+    DiscoveryOptions,
+    DiscoveryProtocol,
+    DiscoveryTimeoutError,
     FlashForgePrinter,
     FlashForgePrinterDiscovery,
+    InvalidResponseError,
+    PrinterDiscovery,
+    PrinterModel,
+    PrinterStatus,
+    SocketCreationError,
 )
 
 # Import key models for convenience
@@ -83,9 +94,16 @@ async def main():
     ThumbnailResponse,
 )
 from .tcp import (
+    A3BuildVolume,
+    A3FileEntry,
+    A3GCodeController,
+    A3PrinterInfo,
+    A3Thumbnail,
     Endstop,
     EndstopStatus,
+    FlashForgeA3Client,
     FlashForgeTcpClient,
+    FlashForgeTcpClientOptions,
     GCodeController,
     GCodes,
     LocationInfo,
@@ -104,7 +122,8 @@ async def main():
     FlashForgeTcpClient as TcpClient,
 )
 
-__version__ = "1.0.0"
+FiveMClient = FlashForgeClient
+__version__ = "1.1.0"
 __author__ = "FlashForge Python API Contributors"
 __email__ = "notghosttypes@gmail.com"
 __description__ = "Python library for controlling FlashForge 3D printers"
@@ -113,6 +132,8 @@ async def main():
 __all__ = [
     # Main client class
     "FlashForgeClient",
+    "FiveMClient",
+    "FiveMClientConnectionOptions",
     # Data models
     "FFMachineInfo",
     "FFPrinterDetail",
@@ -144,6 +165,8 @@ async def main():
     # TCP classes for low-level operations
     "TcpClient",
     "FlashForgeTcpClient",
+    "FlashForgeTcpClientOptions",
+    "FlashForgeA3Client",
     "PrinterInfo",
     "TempInfo",
     "TempData",
@@ -157,7 +180,23 @@ async def main():
     "ThumbnailInfo",
     "GCodes",
     "GCodeController",
+    "A3GCodeController",
+    "A3BuildVolume",
+    "A3PrinterInfo",
+    "A3FileEntry",
+    "A3Thumbnail",
     # Discovery classes
+    "PrinterDiscovery",
+    "DiscoveredPrinter",
+    "DiscoveryOptions",
+    "PrinterModel",
+    "DiscoveryProtocol",
+    "PrinterStatus",
+    "DiscoveryMonitor",
+    "DiscoveryError",
+    "InvalidResponseError",
+    "SocketCreationError",
+    "DiscoveryTimeoutError",
     "FlashForgePrinter",
     "FlashForgePrinterDiscovery",
     # Utilities
@@ -176,7 +215,7 @@ async def main():
 ]
 
 # Convenience imports for common patterns
-from .models.machine_info import MachineState as State
+State = MachineState
 
 # Add version info accessible as flashforge.version
 version = __version__

flashforge/api/controls/control.py

@@ -178,28 +178,26 @@ async def set_cooling_fan_speed(self, speed: int) -> bool:
     async def set_led_on(self) -> bool:
         """
         Turns on the printer's LED lights.
-        Requires the printer to have LED control.
 
         Returns:
             True if the command is successful, False otherwise.
         """
-        if self.client.led_control:
-            return await self.send_control_command(Commands.LIGHT_CONTROL_CMD, {"status": "open"})
-        print("SetLedOn() error, LEDs not equipped.")
-        return False
+        if not self.client.led_control:
+            print("SetLedOn() error, LED control not equipped.")
+            return False
+        return await self.send_control_command(Commands.LIGHT_CONTROL_CMD, {"status": "open"})
 
     async def set_led_off(self) -> bool:
         """
         Turns off the printer's LED lights.
-        Requires the printer to have LED control.
 
         Returns:
             True if the command is successful, False otherwise.
         """
-        if self.client.led_control:
-            return await self.send_control_command(Commands.LIGHT_CONTROL_CMD, {"status": "close"})
-        print("SetLedOff() error, LEDs not equipped.")
-        return False
+        if not self.client.led_control:
+            print("SetLedOff() error, LED control not equipped.")
+            return False
+        return await self.send_control_command(Commands.LIGHT_CONTROL_CMD, {"status": "close"})
 
     async def turn_runout_sensor_on(self) -> bool:
         """