Home Assistant WebSocket client for Elixir.

Two layers, opt-in:

• Hassock.Connection — the WebSocket itself. Always required.
• Hassock.Cache — optional ETS-backed full entity cache, kept in sync via HA's subscribe_entities command.

Both follow the controlling-process pattern (à la :gen_tcp, Circuits.UART): the process that calls start_link/1 is the default recipient of async messages. Use controlling_process/2 to hand off.

Bare connection

{:ok, conn} =
  Hassock.connect(
    config: %Hassock.Config{url: "http://homeassistant.local:8123", token: "..."}
  )

receive do
  {:hassock, ^conn, :connected} -> :ok
end

{:ok, sub} = Hassock.subscribe_entities(conn, ["light.kitchen"])
# handle {:hassock, ^conn, {:event, {:entities, _}}} in your handle_info/2

With entity cache

{:ok, conn} = Hassock.connect(config: config)
{:ok, cache} = Hassock.Cache.start_link(connection: conn)

receive do
  {:hassock_cache, ^cache, :ready} -> :ok
end

Hassock.cached_state(cache, "light.kitchen")