The house
runs itself.

import type { Light, LightStatePatch } from "@/lib/lights/types";
import { mockLightsProvider } from "@/lib/lights/mock-provider";

/**
 * The control surface every lighting backend implements. The UI and API only
 * ever talk to this interface, so swapping the mock for a real integration
 * (Home Assistant, Hue, etc.) is a one-line change in `getLightsProvider()` —
 * no route or component touches a concrete backend.
 */
export interface LightsProvider {
  readonly id: string;
  listLights(): Promise<Light[]>;
  getLight(id: string): Promise<Light | null>;
  setState(id: string, patch: LightStatePatch): Promise<Light | null>;
}

/**
 * Resolve the active lighting provider. Today this is always the file-backed
 * mock. When real hardware is wired up, branch here on a stored config
 * value (e.g. `lights.provider` in data/) and return the matching impl.
 */
export function getLightsProvider(): LightsProvider {
  return mockLightsProvider;
}