A command is not a confirmation
Requested state and observed state are separate. Consumers can distinguish an acknowledged write from an observation that matches the request.
API & INTEGRATION ENGINEERING
Different devices. One understandable system.
Lighting systems speak different protocols. An application needs more than a way to send commands: it needs to know what happened, which device responded, and what to do when one did not.
Built for developers integrating mixed lighting hardware and operators who need a common control interface.
I built a local lighting gateway that separates a common API from manufacturer adapters. Work is tracked as an operation with per-device results, so a partial failure remains visible instead of disappearing behind a single success response.
THE WORKFLOW
An application submits the desired state for selected devices.
The gateway validates capabilities and orders work per device.
Adapters communicate with devices and read back available state.
Operation results distinguish success, partial completion, and failure.
ENGINEERING DECISIONS
Requested state and observed state are separate. Consumers can distinguish an acknowledged write from an observation that matches the request.
Per-device scheduling and deadlines prevent a slow target from holding up unrelated device work.
The local implementation includes timeout containment, quarantine, and reconnect scheduling. Failures become structured results that the calling application can handle.
CURRENT SCOPE
The implementation includes a common lighting API, adapters for Feit/Tuya local control, Govee, Hubspace and a simulated mock device set, persisted asynchronous operations, database-backed presets, observed-state handling, and a Docker deployment on my home server. A public repository exists, but may lag the latest local changes. A controlled public hardware demonstration is still pending.
Source review and tests confirm the operation and adapter mechanisms described here. Supported behavior depends on the configured adapter and device; this illustration is conceptual and does not represent live device activity. Matter is not supported.
APPLYING THE APPROACH
The same engineering approach applies when business applications need to exchange data, coordinate asynchronous jobs, and explain failures to an operator.
Discuss a similar project Opens your email application with a draft.