v0.1.0

First tagged release of foxfire — a modern Go client for the Philips Hue CLIP API v2.

Validated end-to-end against real hardware (a Hue Bridge Pro with a lightstrip, motion sensor, dimmer, smart button, and smart plug).

Included

• Discovery & pairing — mDNS with cloud fallback, link-button handshake, TLS certificate pinning (trust-on-first-use)
• Transport — generic getMany/getOne/put/post/del; treats a 200 with a populated errors array as an error; per-light and per-group rate limiters
• Lights & groups — lights, grouped lights, rooms, zones; scene recall, creation, and deletion
• Sensors — motion, grouped_motion, temperature, light_level, device_power
• Devices — buttons (validated on dimmer + smart button), bridge config, zigbee connectivity, device rename
• Event stream — SSE subscription with jittered exponential backoff; recovers automatically across a bridge reboot
• foxfire/state — folds sparse event deltas into current state
• foxfire/color — sRGB↔xy conversion (D65), hex parsing, gamut clamping
• CLI — discover, pair, lights, rooms, on/off, set, bridge, sensors, devices, rename, watch, with --json output

Status

Pre-1.0. The resource types will grow; the transport and update semantics are settled.

Install

go get github.com/scttfrdmn/foxfire@v0.1.0