timberborn-http 0.0.2__tar.gz → 0.0.4__tar.gz

{timberborn_http-0.0.2/src/timberborn_http.egg-info → timberborn_http-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: timberborn_http
-Version: 0.0.2
+Version: 0.0.4
 Summary: Timberborn http api wrapper
 Author-email: Agroqirax <124404386+Agroqirax@users.noreply.github.com>
 License-Expression: GPL-3.0-or-later
@@ -22,10 +22,9 @@ Supports both direct API control and webhook-based event handling.
 
 ## Features
 
-- **Control levers and adapters** in your Timberborn game
-- **Poll or watch** for state changes
-- **Webhook support** for real-time events
-- **Multiple interaction styles**: OOP, decorators, and direct function calls
+- Get the state of levers & adapters from timberborn
+- Update the state of levers
+- Receive webhooks and trigger actions
 
 ## Installation
 
@@ -48,8 +47,8 @@ for lever in levers:
     print(lever.name, lever.state)
 
 # Control a lever
-api.switch_on("Main Water Pump")
-api.set_color("Main Water Pump", "ff0000")
+api.switch_on("HTTP Lever 1")
+api.set_color("HTTP Lever 1", "ff0000")
 ```
 
 ### 2. Webhook Events
@@ -57,30 +56,19 @@ api.set_color("Main Water Pump", "ff0000")
 ```python
 from timberborn_http import TimberbornWebhookServer
 
-server = TimberbornWebhookServer()
+server = TimberbornWebhookServer(port=8081)
 
-@server.on("Main Water Pump")
+@server.on_event("HTTP Lever 1")
 def handle_on(name):
     print(f"{name} turned ON!")
 
-server.start()
+while True:
+    pass
 ```
 
-## Documentation & Examples
-
-- [API Usage](/examples/api): Direct control and polling
-- [Webhook Usage](/examples/webhooks): Real-time event handling
+More examples & details in the examples folder
 
 ## Getting Help
 
 - [GitHub Issues](https://github.com/agroqirax/timberborn-http/issues)
-- [Discord](https://discord.gg/timberborn)
-
-## Commands
-
-- `python -m venv .venv`
-- `pip install -r requirements.txt`
-- `pip install -e .`
-- `python -m build`
-- `python3 -m twine upload --repository testpypi dist/*`
-- `python3 -m pip install --index-url https://test.pypi.org/simple/ --no-deps timberborn_http`
+- [Discord](https://discord.gg/timberborn) in `#⏱️automation` or `#🤖mod-creators`

timberborn_http-0.0.4/README.md

@@ -0,0 +1,57 @@
+# Timberborn HTTP API Wrapper
+
+A Python library for interacting with the Timberborn HTTP automation API.
+Supports both direct API control and webhook-based event handling.
+
+## Features
+
+- Get the state of levers & adapters from timberborn
+- Update the state of levers
+- Receive webhooks and trigger actions
+
+## Installation
+
+```bash
+pip install timberborn-http
+```
+
+## Quickstart
+
+### 1. Direct API Control
+
+```python
+from timberborn_http import TimberbornAPI
+
+api = TimberbornAPI("http://localhost:8080")
+
+# Get all levers
+levers = api.get_levers()
+for lever in levers:
+    print(lever.name, lever.state)
+
+# Control a lever
+api.switch_on("HTTP Lever 1")
+api.set_color("HTTP Lever 1", "ff0000")
+```
+
+### 2. Webhook Events
+
+```python
+from timberborn_http import TimberbornWebhookServer
+
+server = TimberbornWebhookServer(port=8081)
+
+@server.on_event("HTTP Lever 1")
+def handle_on(name):
+    print(f"{name} turned ON!")
+
+while True:
+    pass
+```
+
+More examples & details in the examples folder
+
+## Getting Help
+
+- [GitHub Issues](https://github.com/agroqirax/timberborn-http/issues)
+- [Discord](https://discord.gg/timberborn) in `#⏱️automation` or `#🤖mod-creators`

{timberborn_http-0.0.2 → timberborn_http-0.0.4}/pyproject.toml

@@ -7,7 +7,7 @@ where = ["src"]
 
 [project]
 name = "timberborn_http"
-version = "0.0.2"
+version = "0.0.4"
 authors = [
   { name="Agroqirax", email="124404386+Agroqirax@users.noreply.github.com" },
 ]

timberborn_http-0.0.4/src/timberborn_http/__init__.py

@@ -0,0 +1,14 @@
+"""
+Timberborn HTTP
+Basic usage:
+```
+from timberborn_http import TimberbornAPI
+api = TimberbornAPI("http://localhost:8080"
+api.get_levers()
+```
+:copyright: (c) 2026 by Agroqirax
+:license: GNU GPL-3.0, see LICENSE for more details.
+"""
+
+from ._client import TimberbornAPI, TimberbornWebhookServer
+__all__ = ["TimberbornAPI", "TimberbornWebhookServer"]

timberborn_http-0.0.4/src/timberborn_http/_client.py

@@ -0,0 +1,325 @@
+from typing import Callable, Dict, List, Optional, overload
+import logging
+import threading
+import urllib.parse
+
+import requests
+from flask import Flask, cli
+
+logger = logging.getLogger("timberborn_http")
+
+
+class TimberbornAPI:
+    """
+    Client for interacting with the Timberborn HTTP automation API.
+    """
+
+    def __init__(self, host: str = "http://localhost:8080"):
+        self.host = host.rstrip("/")
+
+    def _encode(self, name: str) -> str:
+        return urllib.parse.quote(name, safe="")
+
+    def _request(self, path: str) -> requests.Response:
+        url = f"{self.host}{path}"
+        try:
+            r = requests.get(url, timeout=5)
+            r.raise_for_status()
+            return r
+        except requests.exceptions.ConnectionError as e:
+            raise ConnectionError(
+                f"Failed to connect to Timberborn API at {self.host}. "
+                f"Is Timberborn running & the API started?"
+            ) from e
+        except requests.exceptions.Timeout as e:
+            raise TimeoutError(
+                f"Request to {url} timed out."
+            ) from e
+        except requests.exceptions.HTTPError as e:
+            raise RuntimeError(
+                f"HTTP error from Timberborn API: {r.status_code} {r.reason} — {url}"
+            ) from e
+
+    # ------------------------------------------------------------------
+    # Fetchers
+    # ------------------------------------------------------------------
+
+    def get_adapters(self) -> List["TimberbornAPI.Adapter"]:
+        """Retrieve all adapters."""
+        logger.debug("Fetching all adapters")
+        data = self._request("/api/adapters").json()
+        return [self.Adapter(self, d["name"]) for d in data]
+
+    def get_levers(self) -> List["TimberbornAPI.Lever"]:
+        """Retrieve all levers."""
+        logger.debug("Fetching all levers")
+        data = self._request("/api/levers").json()
+        return [self.Lever(self, d["name"]) for d in data]
+
+    def get_adapter(self, name: str) -> "TimberbornAPI.Adapter":
+        """Retrieve a single adapter by name."""
+        logger.debug("Fetching adapter '%s'", name)
+        # validates existence
+        self._request(f"/api/adapters/{self._encode(name)}")
+        return self.Adapter(self, name)
+
+    def get_lever(self, name: str) -> "TimberbornAPI.Lever":
+        """Retrieve a single lever by name."""
+        logger.debug("Fetching lever '%s'", name)
+        # validates existence
+        self._request(f"/api/levers/{self._encode(name)}")
+        return self.Lever(self, name)
+
+    # ------------------------------------------------------------------
+    # Low-level control (used by Adapter/Lever, but also callable directly)
+    # ------------------------------------------------------------------
+
+    def get_adapter_state(self, name: str) -> bool:
+        """Fetch the live state of an adapter."""
+        data = self._request(f"/api/adapters/{self._encode(name)}").json()
+        return bool(data["state"])
+
+    def get_lever_state(self, name: str) -> bool:
+        """Fetch the live state of a lever."""
+        data = self._request(f"/api/levers/{self._encode(name)}").json()
+        return bool(data["state"])
+
+    def get_lever_spring_return(self, name: str) -> bool:
+        """Fetch the live springReturn value of a lever."""
+        data = self._request(f"/api/levers/{self._encode(name)}").json()
+        return bool(data["springReturn"])
+
+    def switch_on(self, name: str) -> None:
+        """Switch a lever ON."""
+        logger.info("Switching ON lever '%s'", name)
+        self._request(f"/api/switch-on/{self._encode(name)}")
+
+    def switch_off(self, name: str) -> None:
+        """Switch a lever OFF."""
+        logger.info("Switching OFF lever '%s'", name)
+        self._request(f"/api/switch-off/{self._encode(name)}")
+
+    def toggle(self, name: str) -> None:
+        """Toggle a lever between ON and OFF."""
+        logger.info("Toggling lever '%s'", name)
+        if self.get_lever_state(name):
+            self.switch_off(name)
+        else:
+            self.switch_on(name)
+
+    def set_color(self, name: str, hex_color: str) -> None:
+        """
+        Set lever color.
+
+        Parameters
+        ----------
+        hex_color : str
+            Hex color without '#' (e.g. '00ff00').
+        """
+        hex_color = hex_color.lstrip("#")
+        if len(hex_color) != 6 or not all(c in "0123456789abcdefABCDEF" for c in hex_color):
+            raise ValueError(
+                f"Invalid hex color: '{hex_color}'. Expected 6 hex digits.")
+        logger.info("Setting color of '%s' to #%s", name, hex_color)
+        self._request(f"/api/color/{self._encode(name)}/{hex_color}")
+
+    # ------------------------------------------------------------------
+    # Inner classes
+    # ------------------------------------------------------------------
+
+    class Adapter:
+        """
+        Represents a Timberborn HTTP Adapter block.
+
+        Attributes
+        ----------
+        name : str
+            Name of the adapter block in-game.
+        state : bool
+            Live-fetched state of the adapter (True = ON). Calls the API on access.
+        """
+
+        def __init__(self, api: "TimberbornAPI", name: str):
+            self._api = api
+            self.name = name
+
+        @property
+        def state(self) -> bool:
+            """Live state — fetches from API on every access."""
+            return self._api.get_adapter_state(self.name)
+
+        def __repr__(self) -> str:
+            return f"Adapter(name={self.name!r})"
+
+    class Lever:
+        """
+        Represents a Timberborn HTTP Lever block.
+
+        Attributes
+        ----------
+        name : str
+            Name of the lever block in-game.
+        state : bool
+            Live-fetched state of the lever (True = ON). Calls the API on access.
+        springReturn : bool
+            Live-fetched springReturn flag. Calls the API on access.
+        """
+
+        def __init__(self, api: "TimberbornAPI", name: str):
+            self._api = api
+            self.name = name
+
+        @property
+        def state(self) -> bool:
+            """Live state — fetches from API on every access."""
+            return self._api.get_lever_state(self.name)
+
+        @property
+        def spring_return(self) -> bool:
+            """Live springReturn — fetches from API on every access."""
+            return self._api.get_lever_spring_return(self.name)
+
+        def switch_on(self) -> None:
+            """Switch this lever ON."""
+            self._api.switch_on(self.name)
+
+        def switch_off(self) -> None:
+            """Switch this lever OFF."""
+            self._api.switch_off(self.name)
+
+        def toggle(self) -> None:
+            """Toggle this lever."""
+            self._api.toggle(self.name)
+
+        def set_color(self, hex_color: str) -> None:
+            """Set the lever color (hex without '#', e.g. 'ff0000')."""
+            self._api.set_color(self.name, hex_color)
+
+        def __repr__(self) -> str:
+            return f"Lever(name={self.name!r})"
+
+
+class TimberbornWebhookServer:
+    """
+    Webhook server that receives adapter events from Timberborn.
+    """
+
+    def __init__(self, host: str = "0.0.0.0", port: int = 8081):
+        """
+        Create a webhook server.
+
+        Parameters
+        ----------
+        host : str
+            Host to bind to.
+        port : int
+            Port to listen on.
+        """
+
+        self.host = host
+        self.port = port
+
+        self.app = Flask("timberborn_webhooks")
+
+        self.on_callbacks: Dict[str, Callable[[str], None]] = {}
+        self.off_callbacks: Dict[str, Callable[[str], None]] = {}
+
+        self.app.add_url_rule("/on/<name>", "on_event",
+                              lambda name: self._event("ON", name),
+                              methods=["GET", "POST"])
+
+        self.app.add_url_rule("/off/<name>", "off_event",
+                              lambda name: self._event("OFF", name),
+                              methods=["GET", "POST"])
+
+        self.start()
+
+    def _event(self, state: str, name: str):
+        name = urllib.parse.unquote(name)
+
+        logger.info("Adapter '%s' turned %s", name, state)
+
+        callbacks = self.on_callbacks if state == "ON" else self.off_callbacks
+
+        if name in callbacks:
+            callbacks[name](name)
+
+        return "OK"
+
+    @overload
+    def on_event(self, adapter_name: str) -> Callable[[
+        Callable[[str], None]], Callable[[str], None]]: ...
+
+    @overload
+    def on_event(self, adapter_name: str,
+                 func: Callable[[str], None]) -> None: ...
+
+    def on_event(
+        self,
+        adapter_name: str,
+        func: Optional[Callable[[str], None]] = None
+    ) -> Optional[Callable[[Callable[[str], None]], Callable[[str], None]]]:
+        """
+        Register a callback when an adapter turns ON.
+
+        Can be used as a decorator or function call.
+        """
+
+        if func is None:
+            def decorator(f: Callable[[str], None]) -> Callable[[str], None]:
+                self.on_callbacks[adapter_name] = f
+                return f
+
+            return decorator
+
+        self.on_callbacks[adapter_name] = func
+        return None
+
+    @overload
+    def off_event(self, adapter_name: str) -> Callable[[
+        Callable[[str], None]], Callable[[str], None]]: ...
+
+    @overload
+    def off_event(self, adapter_name: str,
+                  func: Callable[[str], None]) -> None: ...
+
+    def off_event(
+        self,
+        adapter_name: str,
+        func: Optional[Callable[[str], None]] = None
+    ) -> Optional[Callable[[Callable[[str], None]], Callable[[str], None]]]:
+        """
+        Register a callback when an adapter turns OFF.
+
+        Can be used as a decorator or function call.
+        """
+
+        if func is None:
+            def decorator(f: Callable[[str], None]) -> Callable[[str], None]:
+                self.off_callbacks[adapter_name] = f
+                return f
+
+            return decorator
+
+        self.off_callbacks[adapter_name] = func
+        return None
+
+    def start(self) -> None:
+        """Start webhook server. Can take a second or two to start."""
+        logger.info("Starting webhook server on %s:%s", self.host, self.port)
+
+        cli.show_server_banner = lambda *x: None
+
+        logging.getLogger("werkzeug").setLevel(logging.ERROR)
+
+        thread = threading.Thread(
+            target=lambda: self.app.run(
+                host=self.host,
+                port=self.port,
+                debug=False,
+                use_reloader=False
+            ),
+            daemon=True,
+        )
+
+        thread.start()

{timberborn_http-0.0.2 → timberborn_http-0.0.4/src/timberborn_http.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: timberborn_http
-Version: 0.0.2
+Version: 0.0.4
 Summary: Timberborn http api wrapper
 Author-email: Agroqirax <124404386+Agroqirax@users.noreply.github.com>
 License-Expression: GPL-3.0-or-later
@@ -22,10 +22,9 @@ Supports both direct API control and webhook-based event handling.
 
 ## Features
 
-- **Control levers and adapters** in your Timberborn game
-- **Poll or watch** for state changes
-- **Webhook support** for real-time events
-- **Multiple interaction styles**: OOP, decorators, and direct function calls
+- Get the state of levers & adapters from timberborn
+- Update the state of levers
+- Receive webhooks and trigger actions
 
 ## Installation
 
@@ -48,8 +47,8 @@ for lever in levers:
     print(lever.name, lever.state)
 
 # Control a lever
-api.switch_on("Main Water Pump")
-api.set_color("Main Water Pump", "ff0000")
+api.switch_on("HTTP Lever 1")
+api.set_color("HTTP Lever 1", "ff0000")
 ```
 
 ### 2. Webhook Events
@@ -57,30 +56,19 @@ api.set_color("Main Water Pump", "ff0000")
 ```python
 from timberborn_http import TimberbornWebhookServer
 
-server = TimberbornWebhookServer()
+server = TimberbornWebhookServer(port=8081)
 
-@server.on("Main Water Pump")
+@server.on_event("HTTP Lever 1")
 def handle_on(name):
     print(f"{name} turned ON!")
 
-server.start()
+while True:
+    pass
 ```
 
-## Documentation & Examples
-
-- [API Usage](/examples/api): Direct control and polling
-- [Webhook Usage](/examples/webhooks): Real-time event handling
+More examples & details in the examples folder
 
 ## Getting Help
 
 - [GitHub Issues](https://github.com/agroqirax/timberborn-http/issues)
-- [Discord](https://discord.gg/timberborn)
-
-## Commands
-
-- `python -m venv .venv`
-- `pip install -r requirements.txt`
-- `pip install -e .`
-- `python -m build`
-- `python3 -m twine upload --repository testpypi dist/*`
-- `python3 -m pip install --index-url https://test.pypi.org/simple/ --no-deps timberborn_http`
+- [Discord](https://discord.gg/timberborn) in `#⏱️automation` or `#🤖mod-creators`

timberborn_http-0.0.2/README.md

@@ -1,69 +0,0 @@
-# Timberborn HTTP API Wrapper
-
-A Python library for interacting with the Timberborn HTTP automation API.
-Supports both direct API control and webhook-based event handling.
-
-## Features
-
-- **Control levers and adapters** in your Timberborn game
-- **Poll or watch** for state changes
-- **Webhook support** for real-time events
-- **Multiple interaction styles**: OOP, decorators, and direct function calls
-
-## Installation
-
-```bash
-pip install timberborn-http
-```
-
-## Quickstart
-
-### 1. Direct API Control
-
-```python
-from timberborn_http import TimberbornAPI
-
-api = TimberbornAPI("http://localhost:8080")
-
-# Get all levers
-levers = api.get_levers()
-for lever in levers:
-    print(lever.name, lever.state)
-
-# Control a lever
-api.switch_on("Main Water Pump")
-api.set_color("Main Water Pump", "ff0000")
-```
-
-### 2. Webhook Events
-
-```python
-from timberborn_http import TimberbornWebhookServer
-
-server = TimberbornWebhookServer()
-
-@server.on("Main Water Pump")
-def handle_on(name):
-    print(f"{name} turned ON!")
-
-server.start()
-```
-
-## Documentation & Examples
-
-- [API Usage](/examples/api): Direct control and polling
-- [Webhook Usage](/examples/webhooks): Real-time event handling
-
-## Getting Help
-
-- [GitHub Issues](https://github.com/agroqirax/timberborn-http/issues)
-- [Discord](https://discord.gg/timberborn)
-
-## Commands
-
-- `python -m venv .venv`
-- `pip install -r requirements.txt`
-- `pip install -e .`
-- `python -m build`
-- `python3 -m twine upload --repository testpypi dist/*`
-- `python3 -m pip install --index-url https://test.pypi.org/simple/ --no-deps timberborn_http`

timberborn_http-0.0.2/src/timberborn_http/__init__.py

@@ -1,2 +0,0 @@
-from ._client import TimberbornAPI, TimberbornWebhookServer, Adapter, Lever
-__all__ = ["TimberbornAPI", "TimberbornWebhookServer", "Adapter", "Lever"]

timberborn_http-0.0.2/src/timberborn_http/_client.py

@@ -1,417 +0,0 @@
-from dataclasses import dataclass, field
-from typing import Callable, Dict, List, Optional
-import logging
-import threading
-import time
-import urllib.parse
-
-import requests
-from flask import Flask
-
-logger = logging.getLogger("timberborn_http")
-
-
-# ============================================================
-# Data Classes
-# ============================================================
-
-
-@dataclass
-class Adapter:
-    """
-    Represents a Timberborn HTTP Adapter block.
-
-    Attributes
-    ----------
-    name : str
-        Name of the adapter block in-game.
-    state : bool
-        Current state of the adapter (True = ON).
-    """
-
-    name: str
-    state: bool
-
-
-@dataclass
-class Lever:
-    """
-    Represents a Timberborn HTTP Lever block.
-
-    Attributes
-    ----------
-    name : str
-        Name of the lever block in-game.
-    state : bool
-        Current state of the lever (True = ON).
-    springReturn : bool
-        Whether the lever automatically resets.
-    api : TimberbornAPI
-        Reference to the API client used for control.
-    """
-
-    name: str
-    state: bool
-    springReturn: bool
-    api: "TimberbornAPI" = field(repr=False)
-
-    # ------------------------------------------
-
-    def on(self) -> None:
-        """Switch this lever ON."""
-        self.api.switch_on(self.name)
-
-    def off(self) -> None:
-        """Switch this lever OFF."""
-        self.api.switch_off(self.name)
-
-    def toggle(self) -> None:
-        """Toggle this lever."""
-        self.api.toggle(self.name)
-
-    def set_color(self, hex_color: str) -> None:
-        """
-        Set the lever color.
-
-        Parameters
-        ----------
-        hex_color : str
-            Hex color code (e.g. 'ff0000').
-        """
-        self.api.set_color(self.name, hex_color)
-
-    def refresh(self) -> None:
-        """Refresh the lever state from the API."""
-        self.state = self.api.get_lever_state(self.name)
-
-
-# ============================================================
-# API Client
-# ============================================================
-
-
-class TimberbornAPI:
-    """
-    Client for interacting with the Timberborn HTTP automation API.
-    """
-
-    def __init__(self, host: str = "http://localhost:8080"):
-        """
-        Initialize the API client.
-
-        Parameters
-        ----------
-        host : str
-            Base URL of the Timberborn API.
-        """
-        self.host = host.rstrip("/")
-
-    # ------------------------------------------
-
-    def _encode(self, name: str) -> str:
-        """URL-encode a block name."""
-        return urllib.parse.quote(name)
-
-    # ------------------------------------------
-    # Query
-    # ------------------------------------------
-
-    def get_adapters(self) -> List[Adapter]:
-        """
-        Retrieve all adapters.
-
-        Returns
-        -------
-        List[Adapter]
-            List of adapters.
-        """
-        logger.debug("Fetching adapters")
-
-        r = requests.get(f"{self.host}/api/adapters")
-        r.raise_for_status()
-
-        data = r.json()
-
-        return [Adapter(**adapter) for adapter in data]
-
-    def get_levers(self) -> List[Lever]:
-        """
-        Retrieve all levers.
-
-        Returns
-        -------
-        List[Lever]
-            List of lever objects.
-        """
-        logger.debug("Fetching levers")
-
-        r = requests.get(f"{self.host}/api/levers")
-        r.raise_for_status()
-
-        data = r.json()
-
-        return [Lever(**lever, api=self) for lever in data]
-
-    # ------------------------------------------
-    # State helpers
-    # ------------------------------------------
-
-    def get_adapter_state(self, name: str) -> bool:
-        """
-        Get adapter state.
-
-        Parameters
-        ----------
-        name : str
-            Adapter name.
-
-        Returns
-        -------
-        bool
-            Adapter state.
-        """
-        for adapter in self.get_adapters():
-            if adapter.name == name:
-                return adapter.state
-
-        raise ValueError(f"Adapter '{name}' not found")
-
-    def get_lever_state(self, name: str) -> bool:
-        """
-        Get lever state.
-
-        Parameters
-        ----------
-        name : str
-            Lever name.
-
-        Returns
-        -------
-        bool
-            Lever state.
-        """
-        for lever in self.get_levers():
-            if lever.name == name:
-                return lever.state
-
-        raise ValueError(f"Lever '{name}' not found")
-
-    # ------------------------------------------
-    # Control
-    # ------------------------------------------
-
-    def switch_on(self, name: str) -> None:
-        """
-        Switch a lever ON.
-
-        Parameters
-        ----------
-        name : str
-            Lever name.
-        """
-        logger.info("Switching ON lever '%s'", name)
-
-        name = self._encode(name)
-        requests.get(f"{self.host}/api/switch-on/{name}").raise_for_status()
-
-    def switch_off(self, name: str) -> None:
-        """
-        Switch a lever OFF.
-
-        Parameters
-        ----------
-        name : str
-            Lever name.
-        """
-        logger.info("Switching OFF lever '%s'", name)
-
-        name = self._encode(name)
-        requests.get(f"{self.host}/api/switch-off/{name}").raise_for_status()
-
-    def toggle(self, name: str) -> None:
-        """
-        Toggle a lever state.
-
-        Parameters
-        ----------
-        name : str
-            Lever name.
-        """
-        logger.info("Toggling lever '%s'", name)
-
-        if self.get_lever_state(name):
-            self.switch_off(name)
-        else:
-            self.switch_on(name)
-
-    def set_color(self, name: str, hex_color: str) -> None:
-        """
-        Set lever color.
-
-        Parameters
-        ----------
-        name : str
-            Lever name.
-        hex_color : str
-            Hex color (e.g. '00ff00').
-        """
-        logger.info("Setting color of '%s' to %s", name, hex_color)
-
-        name = self._encode(name)
-        requests.get(
-            f"{self.host}/api/color/{name}/{hex_color}"
-        ).raise_for_status()
-
-    # ------------------------------------------
-    # Polling Watcher
-    # ------------------------------------------
-
-    def watch_adapter(
-        self,
-        name: str,
-        callback: Callable[[str, bool], None],
-        poll_interval: float = 1.0,
-    ) -> None:
-        """
-        Watch an adapter and trigger a callback when its state changes.
-
-        Parameters
-        ----------
-        name : str
-            Adapter name.
-        callback : Callable[[str, bool], None]
-            Function called with (name, state).
-        poll_interval : float
-            Seconds between polls.
-        """
-
-        def watcher():
-            logger.info("Watching adapter '%s'", name)
-
-            last_state: Optional[bool] = None
-
-            while True:
-                state = self.get_adapter_state(name)
-
-                if last_state is None:
-                    last_state = state
-
-                if state != last_state:
-                    callback(name, state)
-                    last_state = state
-
-                time.sleep(poll_interval)
-
-        thread = threading.Thread(target=watcher, daemon=True)
-        thread.start()
-
-
-# ============================================================
-# Webhook Server
-# ============================================================
-
-
-class TimberbornWebhookServer:
-    """
-    Webhook server that receives adapter events from Timberborn.
-    """
-
-    def __init__(self, host: str = "0.0.0.0", port: int = 8081):
-        """
-        Create a webhook server.
-
-        Parameters
-        ----------
-        host : str
-            Host to bind to.
-        port : int
-            Port to listen on.
-        """
-
-        self.host = host
-        self.port = port
-
-        self.app = Flask("timberborn_webhooks")
-
-        self.on_callbacks: Dict[str, Callable[[str], None]] = {}
-        self.off_callbacks: Dict[str, Callable[[str], None]] = {}
-
-        self.app.add_url_rule("/on/<name>", "on_event",
-                              self._on_event, methods=["GET", "POST"])
-        self.app.add_url_rule("/off/<name>", "off_event",
-                              self._off_event, methods=["GET", "POST"])
-
-    # ------------------------------------------
-
-    def _on_event(self, name: str) -> str:
-        name = urllib.parse.unquote(name)
-
-        logger.info("Adapter '%s' turned ON", name)
-
-        if name in self.on_callbacks:
-            self.on_callbacks[name](name)
-
-        return "OK"
-
-    def _off_event(self, name: str) -> str:
-        name = urllib.parse.unquote(name)
-
-        logger.info("Adapter '%s' turned OFF", name)
-
-        if name in self.off_callbacks:
-            self.off_callbacks[name](name)
-
-        return "OK"
-
-    # ------------------------------------------
-    # Registration
-    # ------------------------------------------
-
-    def on(self, adapter_name: str, func: Optional[Callable[[str], None]] = None):
-        """
-        Register a callback when an adapter turns ON.
-
-        Can be used as a decorator or function call.
-        """
-
-        if func is None:
-
-            def decorator(f):
-                self.on_callbacks[adapter_name] = f
-                return f
-
-            return decorator
-
-        self.on_callbacks[adapter_name] = func
-
-    def off(self, adapter_name: str, func: Optional[Callable[[str], None]] = None):
-        """
-        Register a callback when an adapter turns OFF.
-
-        Can be used as a decorator or function call.
-        """
-
-        if func is None:
-
-            def decorator(f):
-                self.off_callbacks[adapter_name] = f
-                return f
-
-            return decorator
-
-        self.off_callbacks[adapter_name] = func
-
-    # ------------------------------------------
-
-    def start(self) -> None:
-        """Start the webhook server in a background thread."""
-
-        logger.info("Starting webhook server on %s:%s", self.host, self.port)
-
-        thread = threading.Thread(
-            target=self.app.run,
-            kwargs={"host": self.host, "port": self.port},
-            daemon=True,
-        )
-
-        thread.start()