iobroker.govee-smart 2.8.2 → 2.8.3

package/README.md

@@ -128,6 +128,11 @@ This adapter's MQTT authentication and BLE-over-LAN (ptReal) protocol implementa
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 2.8.3 (2026-05-12)
+
+- Debug log now covers every adapter path: App and Cloud API calls (with body snippets on null), cache load/save with age, state-writes, capability mapping, LAN command timing, MQTT login server reply.
+- Bug reports can be triaged from a debug log alone — no more "the adapter did nothing and didn't say why".
+
 ### 2.8.2 (2026-05-11)
 
 - Snapshot refresh per device now also reloads the activation data — when you re-record a snapshot in the Govee app it takes effect right away, no manual cache reset.
@@ -147,13 +152,6 @@ This adapter's MQTT authentication and BLE-over-LAN (ptReal) protocol implementa
 
 - Cleaner startup log: the first line now tells you to wait for the "ready" message, and one redundant connection-info line is gone.
 
-### 2.7.0 (2026-05-10)
-
-- Newly created snapshots in the Govee Home app now appear in the ioBroker dropdown — both after the update and via the refresh button. Previously the cache held the old list forever.
-- Refresh button is now per device under `devices.<id>.snapshots.refresh_cloud` instead of an adapter-wide button: a press hits Govee only for that one light, not for every device on your account.
-- The refresh also re-fetches the Govee device list, so a brand-new snapshot from the Govee Home app is picked up even when Govee's cloud hasn't caught up to it yet.
-- `info.refresh_cloud_data` is removed in favour of the per-device button above. ioBroker scripts that wrote to it need to point at `devices.<id>.snapshots.refresh_cloud` instead.
-
 Older entries are in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
 
 ## Support

package/build/lib/capability-mapper.js

@@ -62,17 +62,27 @@ function coerceNum(v) {
   }
   return null;
 }
-function mapCapabilities(capabilities) {
+function mapCapabilities(capabilities, log) {
+  var _a, _b;
   const states = [];
   if (!Array.isArray(capabilities)) {
     return states;
   }
+  let mapped = 0;
+  let skipped = 0;
   for (const cap of capabilities) {
-    const mapped = mapSingleCapability(cap);
-    if (mapped) {
-      states.push(...mapped);
+    const result = mapSingleCapability(cap);
+    if (result) {
+      states.push(...result);
+      mapped++;
+    } else {
+      skipped++;
+      log.debug(
+        `Cap skipped: type=${(_a = cap == null ? void 0 : cap.type) != null ? _a : "?"} instance=${(_b = cap == null ? void 0 : cap.instance) != null ? _b : "?"} \u2014 no mapping (capability not handled or malformed)`
+      );
     }
   }
+  log.debug(`mapCapabilities: ${mapped} mapped, ${skipped} skipped, ${states.length} state def(s) produced`);
   return states;
 }
 function hasDynamicSceneCapability(capabilities, instance) {
@@ -547,10 +557,15 @@ function mapMusicSetting(cap) {
   }
   return states;
 }
-function applyQuirksToStates(sku, states) {
+function applyQuirksToStates(sku, states, log) {
   for (const state of states) {
     if (state.id === "colorTemperature" && state.min != null && state.max != null) {
       const corrected = (0, import_device_registry.applyColorTempQuirk)(sku, state.min, state.max);
+      if (corrected.min !== state.min || corrected.max !== state.max) {
+        log.debug(
+          `Quirk applied for ${sku}: colorTemperature range ${state.min}-${state.max}K \u2192 ${corrected.min}-${corrected.max}K`
+        );
+      }
       state.min = corrected.min;
       state.max = corrected.max;
       state.def = corrected.min;
@@ -712,20 +727,20 @@ const SCENE_DROPDOWN_RULES = [
     source: (d) => d.snapshots
   }
 ];
-function buildLanStateDefs(device) {
+function buildLanStateDefs(device, log) {
   if (!device.lanIp) {
     return [];
   }
   const stateDefs = getDefaultLanStates();
-  applyQuirksToStates(device.sku, stateDefs);
+  applyQuirksToStates(device.sku, stateDefs, log);
   return stateDefs;
 }
-function buildCloudStateDefs(device, localSnapshots, memberDevices) {
+function buildCloudStateDefs(device, log, localSnapshots, memberDevices) {
   if (device.sku === "BaseGroup") {
     return buildGroupStateDefs(memberDevices || []);
   }
-  const stateDefs = mapCapabilities(device.capabilities).filter((d) => !LAN_STATE_IDS.has(d.id));
-  applyQuirksToStates(device.sku, stateDefs);
+  const stateDefs = mapCapabilities(device.capabilities, log).filter((d) => !LAN_STATE_IDS.has(d.id));
+  applyQuirksToStates(device.sku, stateDefs, log);
   const isLight = device.type === "devices.types.light";
   for (const r of SCENE_DROPDOWN_RULES) {
     if (!isLight || !hasDynamicSceneCapability(device.capabilities, r.cap)) {

package/build/lib/capability-mapper.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/capability-mapper.ts"],
-  "sourcesContent": ["import {\n  buildUniqueLabelMap,\n  rgbToHex,\n  type CloudCapability,\n  type CloudStateCapability,\n  type GoveeDevice,\n} from \"./types\";\nimport { applyColorTempQuirk } from \"./device-registry\";\nimport { tDesc, tLabel, tName } from \"./i18n-states\";\n\n/** ioBroker state definition derived from a Govee capability */\nexport interface StateDefinition {\n  /** State ID suffix (e.g. \"power\", \"brightness\", \"colorRgb\") */\n  id: string;\n  /**\n   * Display name. Plain string for capability-derived names (e.g. from\n   * `humanize(cap.instance)` of an unknown Govee capability \u2014 those aren't\n   * predictable). For known states, a translation object `{en, de, ru, ...}`\n   * built via `tName()` from `i18n-states.ts` \u2014 Admin/vis/Object-Browser\n   * pick the user's language automatically.\n   */\n  name: string | Record<string, string>;\n  /**\n   * Human-readable description shown in the object browser \u2014 used to clarify\n   * ambiguous state names (e.g. cloud vs local snapshots) where the id alone\n   * isn't enough for a user to know what the state does.\n   */\n  desc?: string | Record<string, string>;\n  /** ioBroker value type */\n  type: ioBroker.CommonType;\n  /** ioBroker role */\n  role: string;\n  /** Whether state is writable */\n  write: boolean;\n  /** Unit string */\n  unit?: string;\n  /** Min value for numbers */\n  min?: number;\n  /** Max value for numbers */\n  max?: number;\n  /**\n   * Predefined values for a select (value \u2192 label). Label can be a plain\n   * string or a `{en, de, ...}` translation object (ioBroker Admin v6+).\n   */\n  states?: Record<string, string | Record<string, string>>;\n  /** Default value for new states */\n  def?: ioBroker.StateValue;\n  /** Original capability type */\n  capabilityType: string;\n  /** Original capability instance */\n  capabilityInstance: string;\n  /** Target channel (control, scenes, music, snapshots). Defaults to \"control\". */\n  channel?: string;\n}\n\n/**\n * Coerce arbitrary value to boolean. Accepts true/1/\"1\"/\"true\" as truthy.\n *\n * @param v Raw value from API\n */\nfunction coerceBool(v: unknown): boolean {\n  return v === true || v === 1 || v === \"1\" || v === \"true\";\n}\n\n/**\n * Stringify an unknown raw API value for an ioBroker state. Objects /\n * functions go through JSON.stringify (so we don't get `[object Object]`);\n * everything else takes the primitive `String()` path. Centralised to keep\n * the no-base-to-string lint rule happy at the call sites without\n * sprinkling type assertions all over.\n *\n * @param v Raw value from API\n */\nfunction safeStringify(v: unknown): string {\n  switch (typeof v) {\n    case \"string\":\n      return v;\n    case \"number\":\n    case \"bigint\":\n    case \"boolean\":\n    case \"symbol\":\n      return v.toString();\n    case \"undefined\":\n      return \"undefined\";\n    default:\n      // object, function, null\n      return JSON.stringify(v);\n  }\n}\n\n/**\n * Coerce arbitrary value to finite number, or null if not parseable.\n *\n * @param v Raw value from API\n */\nfunction coerceNum(v: unknown): number | null {\n  if (typeof v === \"number\" && Number.isFinite(v)) {\n    return v;\n  }\n  if (typeof v === \"string\" && v.trim() !== \"\") {\n    const n = Number(v);\n    if (Number.isFinite(n)) {\n      return n;\n    }\n  }\n  return null;\n}\n\n/**\n * Maps Govee Cloud API capabilities to ioBroker state definitions.\n * Pure function \u2014 no side effects, easily testable.\n *\n * @param capabilities Device capabilities from Cloud API\n */\nexport function mapCapabilities(capabilities: CloudCapability[]): StateDefinition[] {\n  const states: StateDefinition[] = [];\n\n  if (!Array.isArray(capabilities)) {\n    return states;\n  }\n\n  for (const cap of capabilities) {\n    const mapped = mapSingleCapability(cap);\n    if (mapped) {\n      states.push(...mapped);\n    }\n  }\n\n  return states;\n}\n\n/**\n * Probe `capabilities` for a `devices.capabilities.dynamic_scene` entry of\n * the given instance (lightScene / diyScene / snapshot). Used to gate the\n * scene/snapshot dropdowns capability-driven instead of data-driven \u2014 a\n * device that exposes the cap should always show the dropdown, even if\n * the scene list hasn't been fetched yet.\n *\n * @param capabilities Device capabilities from Cloud API\n * @param instance The dynamic_scene instance to look up\n */\nexport function hasDynamicSceneCapability(\n  capabilities: CloudCapability[],\n  instance: \"lightScene\" | \"diyScene\" | \"snapshot\",\n): boolean {\n  if (!Array.isArray(capabilities)) {\n    return false;\n  }\n  return capabilities.some(\n    cap =>\n      typeof cap?.type === \"string\" &&\n      typeof cap?.instance === \"string\" &&\n      (cap.type === \"devices.capabilities.dynamic_scene\" || cap.type === \"dynamic_scene\") &&\n      cap.instance === instance,\n  );\n}\n\n/**\n * Single source of truth for \"this state-id belongs to LAN territory\". Used by:\n * - cleanupCloudOwnedStates \u2192 skip these ids when wiping cloud-owned states in the control channel\n * - buildCloudStateDefs \u2192 dedup capability-derived defs against LAN ownership (prevents double-create)\n * - cloud-state-loader \u2192 filter out LAN-state-ids when applying cloud values\n *\n * Adding a new LAN-default state means: extend this set AND add the entry in getDefaultLanStates.\n * The capability-tag-invariant test enforces both stay in lock-step.\n */\nexport const LAN_STATE_IDS: ReadonlySet<string> = new Set([\"power\", \"brightness\", \"colorRgb\", \"colorTemperature\"]);\n\n/**\n * Default state definitions for LAN-only devices (no Cloud capabilities).\n * All LAN-capable Govee lights support: power, brightness, color, color temperature.\n *\n * State IDs MUST match LAN_STATE_IDS above. Invariant test in capability-mapper.test.ts\n * fails if these drift apart.\n */\nexport function getDefaultLanStates(): StateDefinition[] {\n  return [\n    {\n      id: \"power\",\n      name: tName(\"power\"),\n      type: \"boolean\",\n      role: \"switch\",\n      write: true,\n      def: false,\n      capabilityType: \"lan\",\n      capabilityInstance: \"powerSwitch\",\n    },\n    {\n      id: \"brightness\",\n      name: tName(\"brightness\"),\n      type: \"number\",\n      role: \"level.brightness\",\n      write: true,\n      min: 0,\n      max: 100,\n      unit: \"%\",\n      def: 0,\n      capabilityType: \"lan\",\n      capabilityInstance: \"brightness\",\n    },\n    {\n      id: \"colorRgb\",\n      name: tName(\"colorRgb\"),\n      type: \"string\",\n      role: \"level.color.rgb\",\n      write: true,\n      def: \"#000000\",\n      capabilityType: \"lan\",\n      capabilityInstance: \"colorRgb\",\n    },\n    {\n      id: \"colorTemperature\",\n      name: tName(\"colorTemperature\"),\n      type: \"number\",\n      role: \"level.color.temperature\",\n      write: true,\n      min: 2000,\n      max: 9000,\n      unit: \"K\",\n      def: 2000,\n      capabilityType: \"lan\",\n      capabilityInstance: \"colorTemperatureK\",\n    },\n  ];\n}\n\n/**\n * Map a single capability to state definition(s)\n *\n * @param cap Cloud capability to map\n */\nfunction mapSingleCapability(cap: CloudCapability): StateDefinition[] | null {\n  if (!cap || typeof cap.type !== \"string\" || typeof cap.instance !== \"string\") {\n    return null;\n  }\n  const shortType = cap.type.replace(\"devices.capabilities.\", \"\");\n\n  switch (shortType) {\n    case \"on_off\":\n      return [\n        {\n          id: \"power\",\n          name: tName(\"power\"),\n          type: \"boolean\",\n          role: \"switch\",\n          write: true,\n          def: false,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"range\":\n      return mapRange(cap);\n\n    case \"color_setting\":\n      return mapColorSetting(cap);\n\n    case \"toggle\":\n      return [\n        {\n          id: sanitizeId(cap.instance),\n          name: humanize(cap.instance),\n          type: \"boolean\",\n          role: \"switch\",\n          write: true,\n          def: false,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"mode\":\n      return mapMode(cap);\n\n    case \"property\":\n      return mapProperty(cap);\n\n    case \"online\":\n      // Handled separately \u2014 not a regular state\n      return null;\n\n    case \"segment_color_setting\":\n      // Segments are handled specially by state-manager\n      return [\n        {\n          id: `_segment_${sanitizeId(cap.instance)}`,\n          name: humanize(cap.instance),\n          type: \"string\",\n          role: \"json\",\n          write: true,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"dynamic_scene\":\n      // lightScene / diyScene / snapshot get real dropdowns built later in\n      // buildCloudStateDefs from the scenes/snapshots arrays \u2014 skip the\n      // generic stub here so we don't create and immediately delete it.\n      if (cap.instance === \"lightScene\" || cap.instance === \"diyScene\" || cap.instance === \"snapshot\") {\n        return null;\n      }\n      return [\n        {\n          id: sanitizeId(cap.instance),\n          name: humanize(cap.instance),\n          type: \"string\",\n          role: \"json\",\n          write: true,\n          def: \"\",\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"work_mode\":\n      return mapWorkMode(cap);\n\n    case \"temperature_setting\":\n      return mapTemperatureSetting(cap);\n\n    case \"event\":\n      return mapEvent(cap);\n\n    case \"music_setting\":\n      return mapMusicSetting(cap);\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Map range capability (brightness, humidity, etc.)\n *\n * @param cap Cloud range capability\n */\nfunction mapRange(cap: CloudCapability): StateDefinition[] {\n  const range = cap.parameters?.range;\n  const isBrightness = cap.instance.toLowerCase().includes(\"brightness\");\n\n  return [\n    {\n      id: sanitizeId(cap.instance),\n      name: humanize(cap.instance),\n      type: \"number\",\n      role: isBrightness ? \"level.brightness\" : \"level\",\n      write: true,\n      min: range?.min ?? 0,\n      max: range?.max ?? 100,\n      unit: normalizeUnit(cap.parameters?.unit),\n      def: range?.min ?? 0,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    },\n  ];\n}\n\n/**\n * Map color_setting capability (RGB or color temperature)\n *\n * @param cap Cloud color setting capability\n */\nfunction mapColorSetting(cap: CloudCapability): StateDefinition[] {\n  if (cap.instance === \"colorRgb\") {\n    return [\n      {\n        id: \"colorRgb\",\n        name: tName(\"colorRgb\"),\n        type: \"string\",\n        role: \"level.color.rgb\",\n        write: true,\n        def: \"#000000\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  if (cap.instance === \"colorTemperatureK\" || cap.instance.includes(\"colorTem\")) {\n    const range = cap.parameters?.range;\n    return [\n      {\n        id: \"colorTemperature\",\n        name: tName(\"colorTemperature\"),\n        type: \"number\",\n        role: \"level.color.temperature\",\n        write: true,\n        min: range?.min ?? 2000,\n        max: range?.max ?? 9000,\n        unit: \"K\",\n        def: range?.min ?? 2000,\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  return [];\n}\n\n/**\n * Map mode capability (scenes with ENUM options)\n *\n * @param cap Cloud mode capability\n */\nfunction mapMode(cap: CloudCapability): StateDefinition[] {\n  if (cap.instance !== \"presetScene\" || !Array.isArray(cap.parameters?.options)) {\n    return [];\n  }\n\n  const states: Record<string, string> = {};\n  for (const opt of cap.parameters.options) {\n    if (!opt || typeof opt.name !== \"string\") {\n      continue;\n    }\n    const val = typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value);\n    states[val] = opt.name;\n  }\n\n  return [\n    {\n      id: \"scene\",\n      name: tName(\"scene\"),\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states,\n      def: \"\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    },\n  ];\n}\n\n/**\n * Map property capability (read-only sensors). Routes to the `sensor`\n * channel so a Heater's temperature reading sits cleanly next to other\n * sensor-style states instead of in `control`.\n *\n * @param cap Cloud property capability\n */\nfunction mapProperty(cap: CloudCapability): StateDefinition[] {\n  const instance = cap.instance.toLowerCase();\n  let role = \"value\";\n  let unit: string | undefined;\n\n  if (instance.includes(\"temperature\")) {\n    role = \"value.temperature\";\n    unit = \"\u00B0C\";\n  } else if (instance.includes(\"humidity\")) {\n    role = \"value.humidity\";\n    unit = \"%\";\n  } else if (instance.includes(\"battery\")) {\n    role = \"value.battery\";\n    unit = \"%\";\n  } else if (instance.includes(\"co2\") || instance.includes(\"carbondioxide\")) {\n    role = \"value.co2\";\n    unit = \"ppm\";\n  }\n\n  return [\n    {\n      id: sanitizeId(cap.instance),\n      name: humanize(cap.instance),\n      type: \"number\",\n      role,\n      write: false,\n      unit: normalizeUnit(cap.parameters?.unit) ?? unit,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n      channel: \"sensor\",\n    },\n  ];\n}\n\n/**\n * Map work_mode capability (STRUCT \u2014 Govee Heater/Humidifier/Fan/...).\n *\n * Two states max:\n *   - `work_mode` \u2014 main mode dropdown (mixed type so users can write\n *     either the numeric mode value or the label name)\n *   - `mode_value` \u2014 secondary parameter (e.g. fan-speed level for the\n *     \"manual\" mode); only created if the API actually exposes one\n *\n * @param cap Cloud work_mode capability\n */\nfunction mapWorkMode(cap: CloudCapability): StateDefinition[] {\n  const fields = cap.parameters?.fields;\n  if (!fields || fields.length === 0) {\n    return [\n      {\n        id: \"work_mode\",\n        name: tName(\"workMode\"),\n        type: \"mixed\",\n        role: \"level.mode\",\n        write: true,\n        def: \"\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  const states: StateDefinition[] = [];\n  const modeField = fields.find(f => f && f.fieldName === \"workMode\");\n  if (modeField?.options && modeField.options.length > 0) {\n    const modeStates: Record<string, string> = {};\n    for (const opt of modeField.options) {\n      if (opt && typeof opt.name === \"string\") {\n        modeStates[typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value)] = opt.name;\n      }\n    }\n    states.push({\n      id: \"work_mode\",\n      name: tName(\"workMode\"),\n      type: \"mixed\",\n      role: \"level.mode\",\n      write: true,\n      states: modeStates,\n      def: modeField.options[0] ? safeStringify(modeField.options[0].value) : \"\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  const valueField = fields.find(f => f && f.fieldName === \"modeValue\");\n  if (valueField) {\n    if (valueField.options && valueField.options.length > 0) {\n      const valStates: Record<string, string> = {};\n      for (const opt of valueField.options) {\n        if (opt && typeof opt.name === \"string\") {\n          valStates[typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value)] = opt.name;\n        }\n      }\n      states.push({\n        id: \"mode_value\",\n        name: tName(\"modeValue\"),\n        type: \"mixed\",\n        role: \"level\",\n        write: true,\n        states: valStates,\n        def: valueField.options[0] ? safeStringify(valueField.options[0].value) : \"\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      });\n    } else if (valueField.range) {\n      states.push({\n        id: \"mode_value\",\n        name: tName(\"modeValue\"),\n        type: \"number\",\n        role: \"level\",\n        write: true,\n        min: valueField.range.min,\n        max: valueField.range.max,\n        def: valueField.range.min,\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      });\n    }\n  }\n\n  return states;\n}\n\n/**\n * Map temperature_setting capability \u2014 Heater target-temp slider.\n * Honours the unit reported by the API (\u00B0F or \u00B0C); falls back to \u00B0F\n * because that's the more common Govee Heater default.\n *\n * @param cap Cloud temperature_setting capability\n */\nfunction mapTemperatureSetting(cap: CloudCapability): StateDefinition[] {\n  const fields = cap.parameters?.fields;\n  if (Array.isArray(fields) && fields.length > 0) {\n    const tempField = fields.find(f => {\n      if (!f || typeof f.fieldName !== \"string\") {\n        return false;\n      }\n      if (f.fieldName === \"targetTemperature\") {\n        return true;\n      }\n      return f.fieldName.toLowerCase().includes(\"temperature\");\n    });\n    if (tempField?.range) {\n      const unit = normalizeUnit(cap.parameters?.unit) ?? \"\u00B0F\";\n      return [\n        {\n          id: \"target_temperature\",\n          name: tName(\"targetTemperature\"),\n          type: \"number\",\n          role: \"level.temperature\",\n          write: true,\n          min: tempField.range.min,\n          max: tempField.range.max,\n          unit,\n          def: tempField.range.min,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n    }\n  }\n\n  const range = cap.parameters?.range;\n  if (range) {\n    const unit = normalizeUnit(cap.parameters?.unit) ?? \"\u00B0F\";\n    return [\n      {\n        id: \"target_temperature\",\n        name: tName(\"targetTemperature\"),\n        type: \"number\",\n        role: \"level.temperature\",\n        write: true,\n        min: range.min,\n        max: range.max,\n        unit,\n        def: range.min,\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  // No usable schema \u2014 expose the raw payload so the user at least sees\n  // the attempt and can report it. Stays JSON to avoid pretending we\n  // understand the structure.\n  return [\n    {\n      id: \"target_temperature\",\n      name: tName(\"targetTemperature\"),\n      type: \"string\",\n      role: \"json\",\n      write: true,\n      def: \"\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    },\n  ];\n}\n\n/**\n * Map event capability (asynchronous OpenAPI-MQTT alarms \u2014 read-only).\n * Each event becomes a boolean indicator in the events/ channel\n * (lackWater, iceFull, bodyAppeared, dirtDetected, \u2026).\n *\n * @param cap Cloud event capability\n */\nfunction mapEvent(cap: CloudCapability): StateDefinition[] {\n  return [\n    {\n      id: sanitizeId(cap.instance),\n      name: humanize(cap.instance),\n      type: \"boolean\",\n      role: \"indicator.alarm\",\n      write: false,\n      def: false,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n      channel: \"events\",\n    },\n  ];\n}\n\n/**\n * Map music_setting capability to user-friendly states.\n * Parses STRUCT fields into: mode dropdown, sensitivity slider, auto-color toggle.\n *\n * @param cap Cloud music_setting capability\n */\nfunction mapMusicSetting(cap: CloudCapability): StateDefinition[] {\n  const fields = cap.parameters?.fields;\n  if (!Array.isArray(fields) || fields.length === 0) {\n    // No field details from API \u2014 can't create usable states\n    return [];\n  }\n\n  const states: StateDefinition[] = [];\n\n  // Mode dropdown \u2014 only if API provides actual mode options\n  const modeField = fields.find(f => f && typeof f.fieldName === \"string\" && f.fieldName === \"musicMode\");\n  if (modeField?.options && Array.isArray(modeField.options) && modeField.options.length > 0) {\n    const modeStates: Record<string, string> = { 0: \"---\" };\n    for (const opt of modeField.options) {\n      if (!opt || typeof opt.name !== \"string\") {\n        continue;\n      }\n      modeStates[typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value)] = opt.name;\n    }\n    states.push({\n      id: \"music_mode\",\n      name: tName(\"musicMode\"),\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: modeStates,\n      def: \"0\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  // Sensitivity slider\n  const sensField = fields.find(f => f && typeof f.fieldName === \"string\" && f.fieldName === \"sensitivity\");\n  if (sensField?.range) {\n    states.push({\n      id: \"music_sensitivity\",\n      name: tName(\"musicSensitivity\"),\n      type: \"number\",\n      role: \"level\",\n      write: true,\n      min: sensField.range.min,\n      max: sensField.range.max,\n      unit: \"%\",\n      def: sensField.range.max,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  // Auto color toggle\n  const autoColorField = fields.find(f => f && typeof f.fieldName === \"string\" && f.fieldName === \"autoColor\");\n  if (autoColorField) {\n    states.push({\n      id: \"music_auto_color\",\n      name: tName(\"musicAutoColor\"),\n      type: \"boolean\",\n      role: \"switch\",\n      write: true,\n      def: true,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  // All music states belong to the music channel\n  for (const s of states) {\n    s.channel = \"music\";\n  }\n  return states;\n}\n\n/**\n * Apply device quirks to mapped state definitions.\n * Corrects wrong API data (e.g. color temperature range) for specific SKUs.\n *\n * @param sku Device model (e.g. \"H60A1\")\n * @param states State definitions to adjust\n */\nexport function applyQuirksToStates(sku: string, states: StateDefinition[]): StateDefinition[] {\n  for (const state of states) {\n    if (state.id === \"colorTemperature\" && state.min != null && state.max != null) {\n      const corrected = applyColorTempQuirk(sku, state.min, state.max);\n      state.min = corrected.min;\n      state.max = corrected.max;\n      state.def = corrected.min;\n    }\n  }\n  return states;\n}\n\n/** Known Govee API unit strings \u2192 ioBroker units */\nconst UNIT_MAP: Record<string, string> = {\n  \"unit.percent\": \"%\",\n  \"unit.kelvin\": \"K\",\n  \"unit.celsius\": \"\u00B0C\",\n  \"unit.fahrenheit\": \"\u00B0F\",\n};\n\n/**\n * Normalize Govee API unit string to ioBroker standard\n *\n * @param unit Raw unit string from API\n */\nfunction normalizeUnit(unit?: string): string | undefined {\n  if (!unit) {\n    return undefined;\n  }\n  return UNIT_MAP[unit] ?? unit;\n}\n\n/**\n * Sanitize a string for use as ioBroker state ID\n *\n * @param str Input string to sanitize\n */\nfunction sanitizeId(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1_$2\")\n    .replace(/[^a-zA-Z0-9_]/g, \"_\")\n    .toLowerCase();\n}\n\n/**\n * Convert camelCase to human-readable name\n *\n * @param str camelCase input string\n */\nfunction humanize(str: string): string {\n  // Reihenfolge: erst Underscore \u2192 Space, dann camelCase-split, dann\n  // trim + erstes Zeichen uppercase. Vorher: leading-underscore-IDs\n  // (z.B. `_segment_color`) wurden zu ` segment color` mit leading\n  // Space und ohne Capitalization (^\\w matched space, nicht word-char).\n  return str\n    .replace(/_/g, \" \")\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .trim()\n    .replace(/^./, c => c.toUpperCase());\n}\n\n/** Mapped Cloud state value: state ID + converted value */\nexport interface CloudStateValue {\n  /** State ID in control/ channel (e.g. \"power\", \"brightness\", \"gradient_toggle\") */\n  stateId: string;\n  /** Converted value ready for ioBroker setStateAsync */\n  value: ioBroker.StateValue;\n}\n\n/**\n * Map a Cloud device state capability to a state ID + converted value.\n * Uses the same ID logic as mapCapabilities so IDs always match.\n *\n * @param cap Cloud state capability with current value\n */\nexport function mapCloudStateValue(cap: CloudStateCapability): CloudStateValue | null {\n  if (!cap || typeof cap.type !== \"string\" || typeof cap.instance !== \"string\") {\n    return null;\n  }\n  const shortType = cap.type.replace(\"devices.capabilities.\", \"\");\n  const raw = cap.state?.value;\n  if (raw === undefined || raw === null) {\n    return null;\n  }\n\n  switch (shortType) {\n    case \"on_off\":\n      return { stateId: \"power\", value: coerceBool(raw) };\n\n    case \"range\": {\n      const n = coerceNum(raw);\n      if (n === null) {\n        return null;\n      }\n      return { stateId: sanitizeId(cap.instance), value: n };\n    }\n\n    case \"color_setting\":\n      if (cap.instance === \"colorRgb\") {\n        const num = coerceNum(raw) ?? 0;\n        return {\n          stateId: \"colorRgb\",\n          value: rgbToHex((num >> 16) & 0xff, (num >> 8) & 0xff, num & 0xff),\n        };\n      }\n      if (cap.instance.includes(\"colorTem\")) {\n        const n = coerceNum(raw);\n        if (n === null) {\n          return null;\n        }\n        return { stateId: \"colorTemperature\", value: n };\n      }\n      return null;\n\n    case \"toggle\":\n      return { stateId: sanitizeId(cap.instance), value: coerceBool(raw) };\n\n    case \"mode\":\n      if (cap.instance === \"presetScene\") {\n        return {\n          stateId: \"scene\",\n          value: safeStringify(raw),\n        };\n      }\n      return null;\n\n    case \"dynamic_scene\":\n      return {\n        stateId: sanitizeId(cap.instance),\n        value: safeStringify(raw),\n      };\n\n    case \"work_mode\": {\n      // STRUCT: { workMode: <number>, modeValue?: <number> }. Cloud\n      // /device/state only returns the primary mode here \u2014 mode_value\n      // (sub-parameter) follows via MQTT status push when the device\n      // reports it, so we don't lose it just because it isn't in the\n      // initial state response.\n      if (typeof raw === \"object\" && raw !== null) {\n        const struct = raw as Record<string, unknown>;\n        const n = coerceNum(struct.workMode);\n        if (n !== null) {\n          return { stateId: \"work_mode\", value: n };\n        }\n      }\n      const direct = coerceNum(raw);\n      if (direct !== null) {\n        return { stateId: \"work_mode\", value: direct };\n      }\n      return null;\n    }\n\n    case \"temperature_setting\": {\n      // STRUCT: { targetTemperature: <number>, temperatureUnit?: ... }\n      // \u2014 fall back to direct number for adapters that simplify.\n      const direct = coerceNum(raw);\n      if (direct !== null) {\n        return { stateId: \"target_temperature\", value: direct };\n      }\n      if (typeof raw === \"object\" && raw !== null) {\n        const struct = raw as Record<string, unknown>;\n        const temp = struct.targetTemperature ?? struct.temperature ?? struct.temp;\n        const n = coerceNum(temp);\n        if (n !== null) {\n          return { stateId: \"target_temperature\", value: n };\n        }\n      }\n      return null;\n    }\n\n    case \"event\":\n      return {\n        stateId: sanitizeId(cap.instance),\n        value: coerceBool(raw),\n      };\n\n    case \"music_setting\":\n      // Extract mode value from STRUCT state\n      if (typeof raw === \"object\" && raw !== null) {\n        const struct = raw as Record<string, unknown>;\n        const mode = coerceNum(struct.musicMode);\n        return {\n          stateId: \"music_mode\",\n          value: mode !== null ? String(mode) : \"0\",\n        };\n      }\n      return null;\n\n    case \"property\": {\n      const n = coerceNum(raw);\n      if (n === null) {\n        return null;\n      }\n      return { stateId: sanitizeId(cap.instance), value: n };\n    }\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Plan the per-state writes for a list of synthesised Cloud-state\n * capabilities. Used by the App-API poll and the OpenAPI-MQTT event\n * handler (both call into `applyCloudCapabilities` on the adapter side).\n *\n * Returns the resolved `(stateId, value)` pairs for capabilities that:\n *   - decode via `mapCloudStateValue` to a non-null result, AND\n *   - aren't shadowed by the LAN-state set when the device is LAN-capable\n *     (lights with `lanIp` shouldn't have their LAN sub-second updates\n *      overwritten by a Cloud-source value).\n *\n * Pure function \u2014 no adapter state, no I/O \u2014 so the LAN-shadow logic is\n * unit-testable independent of the live state-write pipeline.\n *\n * @param caps Capabilities to consider\n * @param hasLanIp Whether the target device has a known LAN IP\n * @param lanStateIds Default-LAN state IDs that LAN delivers authoritatively\n */\nexport function planCloudCapabilityWrites(\n  caps: CloudStateCapability[],\n  hasLanIp: boolean,\n  lanStateIds: ReadonlySet<string>,\n): CloudStateValue[] {\n  const writes: CloudStateValue[] = [];\n  if (!Array.isArray(caps)) {\n    return writes;\n  }\n  for (const cap of caps) {\n    const mapped = mapCloudStateValue(cap);\n    if (!mapped) {\n      continue;\n    }\n    if (hasLanIp && lanStateIds.has(mapped.stateId)) {\n      continue;\n    }\n    writes.push(mapped);\n  }\n  return writes;\n}\n\n/**\n * Scene-dropdown rules \u2014 three states with identical shape (dropdown over a\n * device-content array, capabilityType `dynamic_scene`). Adding a new\n * scene-style dropdown means: append one entry here. The 8 other Cloud-derived\n * states (scene_speed, refresh_cloud, snapshot_local/save/delete, diag.*)\n * have genuinely different shapes and stay inline \u2014 not the same anti-pattern.\n */\nconst SCENE_DROPDOWN_RULES: ReadonlyArray<{\n  id: string;\n  cap: \"lightScene\" | \"diyScene\" | \"snapshot\";\n  nameKey: Parameters<typeof tName>[0];\n  descKey?: Parameters<typeof tDesc>[0];\n  channel: \"scenes\" | \"snapshots\";\n  source: (d: GoveeDevice) => { name: string }[];\n}> = [\n  { id: \"light_scene\", cap: \"lightScene\", nameKey: \"lightScene\", channel: \"scenes\", source: d => d.scenes },\n  { id: \"diy_scene\", cap: \"diyScene\", nameKey: \"diyScene\", channel: \"scenes\", source: d => d.diyScenes },\n  {\n    id: \"snapshot_cloud\",\n    cap: \"snapshot\",\n    nameKey: \"cloudSnapshot\",\n    descKey: \"cloudSnapshotDesc\",\n    channel: \"snapshots\",\n    source: d => d.snapshots,\n  },\n];\n\n/**\n * Build LAN-owned state definitions for a device. Returns the four\n * lan-default states (power/brightness/colorRgb/colorTemperature) with quirks\n * applied, or [] for devices without a LAN address (sensors, appliances,\n * groups).\n *\n * Phase-Architektur: geh\u00F6rt zur LAN-Phase. Wird gerufen wenn ein Ger\u00E4t per\n * LAN-Discovery sichtbar wird oder mit lanIp aus dem Cache geladen wird.\n *\n * @param device Govee device\n */\nexport function buildLanStateDefs(device: GoveeDevice): StateDefinition[] {\n  if (!device.lanIp) {\n    return [];\n  }\n  const stateDefs = getDefaultLanStates();\n  applyQuirksToStates(device.sku, stateDefs);\n  return stateDefs;\n}\n\n/**\n * Build Cloud-owned state definitions for a device \u2014 everything that needs\n * Cloud capabilities or local synthetic decoration. Excludes LAN-default IDs\n * (the LAN phase owns those). Returns intersection state for BaseGroup\n * devices.\n *\n * Phase-Architektur: geh\u00F6rt zur Cloud-Phase. Wird gerufen wenn capabilities\n * f\u00FCr ein Ger\u00E4t aus dem Cache oder einem frischen Cloud-Load verf\u00FCgbar sind.\n *\n * @param device Govee device\n * @param localSnapshots Optional local snapshot names\n * @param memberDevices Resolved member devices (only for BaseGroup)\n */\nexport function buildCloudStateDefs(\n  device: GoveeDevice,\n  localSnapshots?: { name: string }[],\n  memberDevices?: GoveeDevice[],\n): StateDefinition[] {\n  if (device.sku === \"BaseGroup\") {\n    return buildGroupStateDefs(memberDevices || []);\n  }\n\n  // Capability-derived states with LAN-default IDs filtered out \u2014 the LAN\n  // phase owns those, capability mapper duplicates would land in the same\n  // channel and confuse cleanup. Single source of truth: LAN_STATE_IDS.\n  const stateDefs: StateDefinition[] = mapCapabilities(device.capabilities).filter(d => !LAN_STATE_IDS.has(d.id));\n\n  applyQuirksToStates(device.sku, stateDefs);\n\n  // Light-only synthetic state defs \u2014 scenes / snapshots / music / scene_speed\n  // only make sense for lights. Sensors and appliances would otherwise see\n  // empty snapshot dropdowns and a useless save/delete button pair.\n  const isLight = device.type === \"devices.types.light\";\n\n  // Three structurally-identical Cloud dropdowns \u2014 collapsed into one loop.\n  for (const r of SCENE_DROPDOWN_RULES) {\n    if (!isLight || !hasDynamicSceneCapability(device.capabilities, r.cap)) {\n      continue;\n    }\n    stateDefs.push({\n      id: r.id,\n      name: tName(r.nameKey),\n      desc: r.descKey ? tDesc(r.descKey) : undefined,\n      // mixed lets users write the index (\"1\"), the index as number (1),\n      // or the entry name (\"Aurora\") \u2014 the onStateChange handler resolves\n      // all three forms via the common.states map.\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(r.source(device)),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: r.cap,\n      channel: r.channel,\n    });\n  }\n\n  // Scene speed slider \u2014 only if any scene supports speed adjustment.\n  // Stays inline: depends on a computed maxSpeedLevel that doesn't fit the\n  // dropdown-rule shape.\n  const maxSpeedLevel = device.sceneLibrary.reduce((max, entry) => {\n    if (entry.speedInfo?.supSpeed && entry.speedInfo.config) {\n      try {\n        const parsed = JSON.parse(entry.speedInfo.config) as unknown;\n        // Config can drift \u2014 if not an array, skip this entry silently\n        if (!Array.isArray(parsed)) {\n          return max;\n        }\n        for (const cfg of parsed as Array<{ moveIn?: number[] }>) {\n          if (cfg && Array.isArray(cfg.moveIn) && cfg.moveIn.length - 1 > max) {\n            max = cfg.moveIn.length - 1;\n          }\n        }\n      } catch {\n        /* ignore invalid config JSON */\n      }\n    }\n    return max;\n  }, -1);\n  if (isLight && maxSpeedLevel > 0) {\n    stateDefs.push({\n      id: \"scene_speed\",\n      name: tName(\"sceneSpeed\"),\n      type: \"number\",\n      role: \"level\",\n      write: true,\n      min: 0,\n      max: maxSpeedLevel,\n      def: 0,\n      capabilityType: \"local\",\n      capabilityInstance: \"sceneSpeed\",\n      channel: \"scenes\",\n    });\n  }\n\n  // Per-device refresh button \u2014 gated on ANY dynamic-scene capability.\n  // OR-gate over three caps doesn't fit a rules-table.\n  if (\n    isLight &&\n    (hasDynamicSceneCapability(device.capabilities, \"lightScene\") ||\n      hasDynamicSceneCapability(device.capabilities, \"diyScene\") ||\n      hasDynamicSceneCapability(device.capabilities, \"snapshot\"))\n  ) {\n    stateDefs.push({\n      id: \"refresh_cloud\",\n      name: tName(\"refreshCloud\"),\n      desc: tDesc(\"refreshCloudDesc\"),\n      type: \"boolean\",\n      role: \"button\",\n      write: true,\n      def: false,\n      capabilityType: \"local\",\n      capabilityInstance: \"refreshCloud\",\n      channel: \"snapshots\",\n    });\n  }\n\n  // Local snapshots \u2014 three states with different shapes (mixed dropdown vs\n  // plain string-write fields). Inline because a rules-table would need a\n  // discriminator field with no payoff.\n  if (isLight) {\n    stateDefs.push({\n      id: \"snapshot_local\",\n      name: tName(\"localSnapshot\"),\n      desc: tDesc(\"localSnapshotDesc\"),\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(localSnapshots ?? []),\n      def: \"0\",\n      capabilityType: \"local\",\n      capabilityInstance: \"snapshotLocal\",\n      channel: \"snapshots\",\n    });\n    stateDefs.push({\n      id: \"snapshot_save\",\n      name: tName(\"saveLocalSnapshot\"),\n      desc: tDesc(\"saveLocalSnapshotDesc\"),\n      type: \"string\",\n      role: \"text\",\n      write: true,\n      def: \"\",\n      capabilityType: \"local\",\n      capabilityInstance: \"snapshotSave\",\n      channel: \"snapshots\",\n    });\n    stateDefs.push({\n      id: \"snapshot_delete\",\n      name: tName(\"deleteLocalSnapshot\"),\n      desc: tDesc(\"deleteLocalSnapshotDesc\"),\n      type: \"string\",\n      role: \"text\",\n      write: true,\n      def: \"\",\n      capabilityType: \"local\",\n      capabilityInstance: \"snapshotDelete\",\n      channel: \"snapshots\",\n    });\n  }\n\n  // Diagnostics \u2014 three states with different shapes (boolean button vs\n  // read-only string vs string with fixed states map). Inline for same\n  // reason as local snapshots.\n  stateDefs.push({\n    id: \"export\",\n    name: tName(\"exportDiagnostics\"),\n    type: \"boolean\",\n    role: \"button\",\n    write: true,\n    def: false,\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsExport\",\n    channel: \"diag\",\n  });\n  stateDefs.push({\n    id: \"result\",\n    name: tName(\"diagnosticsJson\"),\n    type: \"string\",\n    role: \"json\",\n    write: false,\n    def: \"\",\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsResult\",\n    channel: \"diag\",\n  });\n  // Trust tier for the user \u2014 verified/reported/seed/unknown. Tells\n  // power users whether the experimental toggle would buy them anything,\n  // and lets unknown-SKU users see at a glance that their device isn't\n  // in the catalogue yet.\n  stateDefs.push({\n    id: \"tier\",\n    name: tName(\"deviceTier\"),\n    type: \"string\",\n    role: \"text\",\n    write: false,\n    def: \"unknown\",\n    states: {\n      verified: tLabel(\"deviceTierVerified\"),\n      reported: tLabel(\"deviceTierReported\"),\n      seed: tLabel(\"deviceTierSeed\"),\n      unknown: tLabel(\"deviceTierUnknown\"),\n    },\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsTier\",\n    channel: \"diag\",\n  });\n\n  return stateDefs;\n}\n\n/**\n * Check if a member device supports a given control state.\n * LAN-capable devices support all basic controls.\n *\n * @param member Group member device\n * @param stateId Control state ID (e.g. \"power\", \"brightness\")\n */\nfunction memberHasControlState(member: GoveeDevice, stateId: string): boolean {\n  if (member.lanIp) {\n    return true;\n  }\n  const caps = Array.isArray(member.capabilities) ? member.capabilities : [];\n  switch (stateId) {\n    case \"power\":\n      return caps.some(c => c && typeof c.type === \"string\" && c.type.endsWith(\"on_off\"));\n    case \"brightness\":\n      return caps.some(\n        c =>\n          c &&\n          typeof c.type === \"string\" &&\n          typeof c.instance === \"string\" &&\n          c.type.endsWith(\"range\") &&\n          c.instance === \"brightness\",\n      );\n    case \"colorRgb\":\n      return caps.some(\n        c =>\n          c &&\n          typeof c.type === \"string\" &&\n          typeof c.instance === \"string\" &&\n          c.type.endsWith(\"color_setting\") &&\n          c.instance === \"colorRgb\",\n      );\n    case \"colorTemperature\":\n      return caps.some(\n        c =>\n          c &&\n          typeof c.type === \"string\" &&\n          typeof c.instance === \"string\" &&\n          c.type.endsWith(\"color_setting\") &&\n          (c.instance === \"colorTem\" || c.instance === \"colorTemperatureK\"),\n      );\n    default:\n      return false;\n  }\n}\n\n/**\n * Build state definitions for a BaseGroup device.\n * Capabilities = intersection of controllable member devices.\n * No snapshots, no diagnostics, no segments.\n *\n * @param members Resolved member devices\n */\nfunction buildGroupStateDefs(members: GoveeDevice[]): StateDefinition[] {\n  const controllable = members.filter(m => m.lanIp || m.channels.cloud);\n  if (controllable.length === 0) {\n    return [];\n  }\n\n  const stateDefs: StateDefinition[] = [];\n\n  // Control states: intersection of member capabilities\n  for (const ld of getDefaultLanStates()) {\n    if (controllable.every(m => memberHasControlState(m, ld.id))) {\n      stateDefs.push(ld);\n    }\n  }\n\n  // Scenes: intersection of member scene names\n  if (controllable.every(m => m.scenes.length > 0)) {\n    const firstNames = controllable[0].scenes.map(s => s.name);\n    const commonNames = firstNames.filter(name => controllable.every(m => m.scenes.some(s => s.name === name)));\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"light_scene\",\n        name: tName(\"lightScene\"),\n        type: \"mixed\",\n        role: \"text\",\n        write: true,\n        states: buildUniqueLabelMap(commonNames.map(name => ({ name }))),\n        def: \"0\",\n        capabilityType: \"devices.capabilities.dynamic_scene\",\n        capabilityInstance: \"lightScene\",\n        channel: \"scenes\",\n      });\n    }\n  }\n\n  // Music: intersection of member music libraries\n  if (controllable.every(m => m.musicLibrary.length > 0)) {\n    const firstNames = controllable[0].musicLibrary.map(m => m.name);\n    const commonNames = firstNames.filter(name => controllable.every(m => m.musicLibrary.some(ml => ml.name === name)));\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"music_mode\",\n        name: tName(\"musicMode\"),\n        type: \"mixed\",\n        role: \"text\",\n        write: true,\n        states: buildUniqueLabelMap(commonNames.map(name => ({ name }))),\n        def: \"0\",\n        capabilityType: \"devices.capabilities.music_setting\",\n        capabilityInstance: \"musicMode\",\n        channel: \"music\",\n      });\n    }\n  }\n\n  return stateDefs;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  buildUniqueLabelMap,\n  rgbToHex,\n  type CloudCapability,\n  type CloudStateCapability,\n  type GoveeDevice,\n} from \"./types\";\nimport { applyColorTempQuirk } from \"./device-registry\";\nimport { tDesc, tLabel, tName } from \"./i18n-states\";\n\n/** ioBroker state definition derived from a Govee capability */\nexport interface StateDefinition {\n  /** State ID suffix (e.g. \"power\", \"brightness\", \"colorRgb\") */\n  id: string;\n  /**\n   * Display name. Plain string for capability-derived names (e.g. from\n   * `humanize(cap.instance)` of an unknown Govee capability \u2014 those aren't\n   * predictable). For known states, a translation object `{en, de, ru, ...}`\n   * built via `tName()` from `i18n-states.ts` \u2014 Admin/vis/Object-Browser\n   * pick the user's language automatically.\n   */\n  name: string | Record<string, string>;\n  /**\n   * Human-readable description shown in the object browser \u2014 used to clarify\n   * ambiguous state names (e.g. cloud vs local snapshots) where the id alone\n   * isn't enough for a user to know what the state does.\n   */\n  desc?: string | Record<string, string>;\n  /** ioBroker value type */\n  type: ioBroker.CommonType;\n  /** ioBroker role */\n  role: string;\n  /** Whether state is writable */\n  write: boolean;\n  /** Unit string */\n  unit?: string;\n  /** Min value for numbers */\n  min?: number;\n  /** Max value for numbers */\n  max?: number;\n  /**\n   * Predefined values for a select (value \u2192 label). Label can be a plain\n   * string or a `{en, de, ...}` translation object (ioBroker Admin v6+).\n   */\n  states?: Record<string, string | Record<string, string>>;\n  /** Default value for new states */\n  def?: ioBroker.StateValue;\n  /** Original capability type */\n  capabilityType: string;\n  /** Original capability instance */\n  capabilityInstance: string;\n  /** Target channel (control, scenes, music, snapshots). Defaults to \"control\". */\n  channel?: string;\n}\n\n/**\n * Coerce arbitrary value to boolean. Accepts true/1/\"1\"/\"true\" as truthy.\n *\n * @param v Raw value from API\n */\nfunction coerceBool(v: unknown): boolean {\n  return v === true || v === 1 || v === \"1\" || v === \"true\";\n}\n\n/**\n * Stringify an unknown raw API value for an ioBroker state. Objects /\n * functions go through JSON.stringify (so we don't get `[object Object]`);\n * everything else takes the primitive `String()` path. Centralised to keep\n * the no-base-to-string lint rule happy at the call sites without\n * sprinkling type assertions all over.\n *\n * @param v Raw value from API\n */\nfunction safeStringify(v: unknown): string {\n  switch (typeof v) {\n    case \"string\":\n      return v;\n    case \"number\":\n    case \"bigint\":\n    case \"boolean\":\n    case \"symbol\":\n      return v.toString();\n    case \"undefined\":\n      return \"undefined\";\n    default:\n      // object, function, null\n      return JSON.stringify(v);\n  }\n}\n\n/**\n * Coerce arbitrary value to finite number, or null if not parseable.\n *\n * @param v Raw value from API\n */\nfunction coerceNum(v: unknown): number | null {\n  if (typeof v === \"number\" && Number.isFinite(v)) {\n    return v;\n  }\n  if (typeof v === \"string\" && v.trim() !== \"\") {\n    const n = Number(v);\n    if (Number.isFinite(n)) {\n      return n;\n    }\n  }\n  return null;\n}\n\n/**\n * Maps Govee Cloud API capabilities to ioBroker state definitions.\n * Pure function \u2014 no side effects, easily testable.\n *\n * @param capabilities Device capabilities from Cloud API\n * @param log Adapter logger \u2014 per-cap skip-decisions land on debug.\n */\nexport function mapCapabilities(capabilities: CloudCapability[], log: ioBroker.Logger): StateDefinition[] {\n  const states: StateDefinition[] = [];\n\n  if (!Array.isArray(capabilities)) {\n    return states;\n  }\n\n  let mapped = 0;\n  let skipped = 0;\n  for (const cap of capabilities) {\n    const result = mapSingleCapability(cap);\n    if (result) {\n      states.push(...result);\n      mapped++;\n    } else {\n      skipped++;\n      // Unknown / unhandled cap shape \u2014 log so bug reports can see what\n      // Govee sent that we didn't know what to do with. Includes type+\n      // instance because that's enough to grep against device-registry\n      // entries when adding support for a new SKU.\n      log.debug(\n        `Cap skipped: type=${cap?.type ?? \"?\"} instance=${cap?.instance ?? \"?\"} \u2014 no mapping (capability not handled or malformed)`,\n      );\n    }\n  }\n  log.debug(`mapCapabilities: ${mapped} mapped, ${skipped} skipped, ${states.length} state def(s) produced`);\n\n  return states;\n}\n\n/**\n * Probe `capabilities` for a `devices.capabilities.dynamic_scene` entry of\n * the given instance (lightScene / diyScene / snapshot). Used to gate the\n * scene/snapshot dropdowns capability-driven instead of data-driven \u2014 a\n * device that exposes the cap should always show the dropdown, even if\n * the scene list hasn't been fetched yet.\n *\n * @param capabilities Device capabilities from Cloud API\n * @param instance The dynamic_scene instance to look up\n */\nexport function hasDynamicSceneCapability(\n  capabilities: CloudCapability[],\n  instance: \"lightScene\" | \"diyScene\" | \"snapshot\",\n): boolean {\n  if (!Array.isArray(capabilities)) {\n    return false;\n  }\n  return capabilities.some(\n    cap =>\n      typeof cap?.type === \"string\" &&\n      typeof cap?.instance === \"string\" &&\n      (cap.type === \"devices.capabilities.dynamic_scene\" || cap.type === \"dynamic_scene\") &&\n      cap.instance === instance,\n  );\n}\n\n/**\n * Single source of truth for \"this state-id belongs to LAN territory\". Used by:\n * - cleanupCloudOwnedStates \u2192 skip these ids when wiping cloud-owned states in the control channel\n * - buildCloudStateDefs \u2192 dedup capability-derived defs against LAN ownership (prevents double-create)\n * - cloud-state-loader \u2192 filter out LAN-state-ids when applying cloud values\n *\n * Adding a new LAN-default state means: extend this set AND add the entry in getDefaultLanStates.\n * The capability-tag-invariant test enforces both stay in lock-step.\n */\nexport const LAN_STATE_IDS: ReadonlySet<string> = new Set([\"power\", \"brightness\", \"colorRgb\", \"colorTemperature\"]);\n\n/**\n * Default state definitions for LAN-only devices (no Cloud capabilities).\n * All LAN-capable Govee lights support: power, brightness, color, color temperature.\n *\n * State IDs MUST match LAN_STATE_IDS above. Invariant test in capability-mapper.test.ts\n * fails if these drift apart.\n */\nexport function getDefaultLanStates(): StateDefinition[] {\n  return [\n    {\n      id: \"power\",\n      name: tName(\"power\"),\n      type: \"boolean\",\n      role: \"switch\",\n      write: true,\n      def: false,\n      capabilityType: \"lan\",\n      capabilityInstance: \"powerSwitch\",\n    },\n    {\n      id: \"brightness\",\n      name: tName(\"brightness\"),\n      type: \"number\",\n      role: \"level.brightness\",\n      write: true,\n      min: 0,\n      max: 100,\n      unit: \"%\",\n      def: 0,\n      capabilityType: \"lan\",\n      capabilityInstance: \"brightness\",\n    },\n    {\n      id: \"colorRgb\",\n      name: tName(\"colorRgb\"),\n      type: \"string\",\n      role: \"level.color.rgb\",\n      write: true,\n      def: \"#000000\",\n      capabilityType: \"lan\",\n      capabilityInstance: \"colorRgb\",\n    },\n    {\n      id: \"colorTemperature\",\n      name: tName(\"colorTemperature\"),\n      type: \"number\",\n      role: \"level.color.temperature\",\n      write: true,\n      min: 2000,\n      max: 9000,\n      unit: \"K\",\n      def: 2000,\n      capabilityType: \"lan\",\n      capabilityInstance: \"colorTemperatureK\",\n    },\n  ];\n}\n\n/**\n * Map a single capability to state definition(s)\n *\n * @param cap Cloud capability to map\n */\nfunction mapSingleCapability(cap: CloudCapability): StateDefinition[] | null {\n  if (!cap || typeof cap.type !== \"string\" || typeof cap.instance !== \"string\") {\n    return null;\n  }\n  const shortType = cap.type.replace(\"devices.capabilities.\", \"\");\n\n  switch (shortType) {\n    case \"on_off\":\n      return [\n        {\n          id: \"power\",\n          name: tName(\"power\"),\n          type: \"boolean\",\n          role: \"switch\",\n          write: true,\n          def: false,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"range\":\n      return mapRange(cap);\n\n    case \"color_setting\":\n      return mapColorSetting(cap);\n\n    case \"toggle\":\n      return [\n        {\n          id: sanitizeId(cap.instance),\n          name: humanize(cap.instance),\n          type: \"boolean\",\n          role: \"switch\",\n          write: true,\n          def: false,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"mode\":\n      return mapMode(cap);\n\n    case \"property\":\n      return mapProperty(cap);\n\n    case \"online\":\n      // Handled separately \u2014 not a regular state\n      return null;\n\n    case \"segment_color_setting\":\n      // Segments are handled specially by state-manager\n      return [\n        {\n          id: `_segment_${sanitizeId(cap.instance)}`,\n          name: humanize(cap.instance),\n          type: \"string\",\n          role: \"json\",\n          write: true,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"dynamic_scene\":\n      // lightScene / diyScene / snapshot get real dropdowns built later in\n      // buildCloudStateDefs from the scenes/snapshots arrays \u2014 skip the\n      // generic stub here so we don't create and immediately delete it.\n      if (cap.instance === \"lightScene\" || cap.instance === \"diyScene\" || cap.instance === \"snapshot\") {\n        return null;\n      }\n      return [\n        {\n          id: sanitizeId(cap.instance),\n          name: humanize(cap.instance),\n          type: \"string\",\n          role: \"json\",\n          write: true,\n          def: \"\",\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n\n    case \"work_mode\":\n      return mapWorkMode(cap);\n\n    case \"temperature_setting\":\n      return mapTemperatureSetting(cap);\n\n    case \"event\":\n      return mapEvent(cap);\n\n    case \"music_setting\":\n      return mapMusicSetting(cap);\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Map range capability (brightness, humidity, etc.)\n *\n * @param cap Cloud range capability\n */\nfunction mapRange(cap: CloudCapability): StateDefinition[] {\n  const range = cap.parameters?.range;\n  const isBrightness = cap.instance.toLowerCase().includes(\"brightness\");\n\n  return [\n    {\n      id: sanitizeId(cap.instance),\n      name: humanize(cap.instance),\n      type: \"number\",\n      role: isBrightness ? \"level.brightness\" : \"level\",\n      write: true,\n      min: range?.min ?? 0,\n      max: range?.max ?? 100,\n      unit: normalizeUnit(cap.parameters?.unit),\n      def: range?.min ?? 0,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    },\n  ];\n}\n\n/**\n * Map color_setting capability (RGB or color temperature)\n *\n * @param cap Cloud color setting capability\n */\nfunction mapColorSetting(cap: CloudCapability): StateDefinition[] {\n  if (cap.instance === \"colorRgb\") {\n    return [\n      {\n        id: \"colorRgb\",\n        name: tName(\"colorRgb\"),\n        type: \"string\",\n        role: \"level.color.rgb\",\n        write: true,\n        def: \"#000000\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  if (cap.instance === \"colorTemperatureK\" || cap.instance.includes(\"colorTem\")) {\n    const range = cap.parameters?.range;\n    return [\n      {\n        id: \"colorTemperature\",\n        name: tName(\"colorTemperature\"),\n        type: \"number\",\n        role: \"level.color.temperature\",\n        write: true,\n        min: range?.min ?? 2000,\n        max: range?.max ?? 9000,\n        unit: \"K\",\n        def: range?.min ?? 2000,\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  return [];\n}\n\n/**\n * Map mode capability (scenes with ENUM options)\n *\n * @param cap Cloud mode capability\n */\nfunction mapMode(cap: CloudCapability): StateDefinition[] {\n  if (cap.instance !== \"presetScene\" || !Array.isArray(cap.parameters?.options)) {\n    return [];\n  }\n\n  const states: Record<string, string> = {};\n  for (const opt of cap.parameters.options) {\n    if (!opt || typeof opt.name !== \"string\") {\n      continue;\n    }\n    const val = typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value);\n    states[val] = opt.name;\n  }\n\n  return [\n    {\n      id: \"scene\",\n      name: tName(\"scene\"),\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states,\n      def: \"\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    },\n  ];\n}\n\n/**\n * Map property capability (read-only sensors). Routes to the `sensor`\n * channel so a Heater's temperature reading sits cleanly next to other\n * sensor-style states instead of in `control`.\n *\n * @param cap Cloud property capability\n */\nfunction mapProperty(cap: CloudCapability): StateDefinition[] {\n  const instance = cap.instance.toLowerCase();\n  let role = \"value\";\n  let unit: string | undefined;\n\n  if (instance.includes(\"temperature\")) {\n    role = \"value.temperature\";\n    unit = \"\u00B0C\";\n  } else if (instance.includes(\"humidity\")) {\n    role = \"value.humidity\";\n    unit = \"%\";\n  } else if (instance.includes(\"battery\")) {\n    role = \"value.battery\";\n    unit = \"%\";\n  } else if (instance.includes(\"co2\") || instance.includes(\"carbondioxide\")) {\n    role = \"value.co2\";\n    unit = \"ppm\";\n  }\n\n  return [\n    {\n      id: sanitizeId(cap.instance),\n      name: humanize(cap.instance),\n      type: \"number\",\n      role,\n      write: false,\n      unit: normalizeUnit(cap.parameters?.unit) ?? unit,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n      channel: \"sensor\",\n    },\n  ];\n}\n\n/**\n * Map work_mode capability (STRUCT \u2014 Govee Heater/Humidifier/Fan/...).\n *\n * Two states max:\n *   - `work_mode` \u2014 main mode dropdown (mixed type so users can write\n *     either the numeric mode value or the label name)\n *   - `mode_value` \u2014 secondary parameter (e.g. fan-speed level for the\n *     \"manual\" mode); only created if the API actually exposes one\n *\n * @param cap Cloud work_mode capability\n */\nfunction mapWorkMode(cap: CloudCapability): StateDefinition[] {\n  const fields = cap.parameters?.fields;\n  if (!fields || fields.length === 0) {\n    return [\n      {\n        id: \"work_mode\",\n        name: tName(\"workMode\"),\n        type: \"mixed\",\n        role: \"level.mode\",\n        write: true,\n        def: \"\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  const states: StateDefinition[] = [];\n  const modeField = fields.find(f => f && f.fieldName === \"workMode\");\n  if (modeField?.options && modeField.options.length > 0) {\n    const modeStates: Record<string, string> = {};\n    for (const opt of modeField.options) {\n      if (opt && typeof opt.name === \"string\") {\n        modeStates[typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value)] = opt.name;\n      }\n    }\n    states.push({\n      id: \"work_mode\",\n      name: tName(\"workMode\"),\n      type: \"mixed\",\n      role: \"level.mode\",\n      write: true,\n      states: modeStates,\n      def: modeField.options[0] ? safeStringify(modeField.options[0].value) : \"\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  const valueField = fields.find(f => f && f.fieldName === \"modeValue\");\n  if (valueField) {\n    if (valueField.options && valueField.options.length > 0) {\n      const valStates: Record<string, string> = {};\n      for (const opt of valueField.options) {\n        if (opt && typeof opt.name === \"string\") {\n          valStates[typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value)] = opt.name;\n        }\n      }\n      states.push({\n        id: \"mode_value\",\n        name: tName(\"modeValue\"),\n        type: \"mixed\",\n        role: \"level\",\n        write: true,\n        states: valStates,\n        def: valueField.options[0] ? safeStringify(valueField.options[0].value) : \"\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      });\n    } else if (valueField.range) {\n      states.push({\n        id: \"mode_value\",\n        name: tName(\"modeValue\"),\n        type: \"number\",\n        role: \"level\",\n        write: true,\n        min: valueField.range.min,\n        max: valueField.range.max,\n        def: valueField.range.min,\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      });\n    }\n  }\n\n  return states;\n}\n\n/**\n * Map temperature_setting capability \u2014 Heater target-temp slider.\n * Honours the unit reported by the API (\u00B0F or \u00B0C); falls back to \u00B0F\n * because that's the more common Govee Heater default.\n *\n * @param cap Cloud temperature_setting capability\n */\nfunction mapTemperatureSetting(cap: CloudCapability): StateDefinition[] {\n  const fields = cap.parameters?.fields;\n  if (Array.isArray(fields) && fields.length > 0) {\n    const tempField = fields.find(f => {\n      if (!f || typeof f.fieldName !== \"string\") {\n        return false;\n      }\n      if (f.fieldName === \"targetTemperature\") {\n        return true;\n      }\n      return f.fieldName.toLowerCase().includes(\"temperature\");\n    });\n    if (tempField?.range) {\n      const unit = normalizeUnit(cap.parameters?.unit) ?? \"\u00B0F\";\n      return [\n        {\n          id: \"target_temperature\",\n          name: tName(\"targetTemperature\"),\n          type: \"number\",\n          role: \"level.temperature\",\n          write: true,\n          min: tempField.range.min,\n          max: tempField.range.max,\n          unit,\n          def: tempField.range.min,\n          capabilityType: cap.type,\n          capabilityInstance: cap.instance,\n        },\n      ];\n    }\n  }\n\n  const range = cap.parameters?.range;\n  if (range) {\n    const unit = normalizeUnit(cap.parameters?.unit) ?? \"\u00B0F\";\n    return [\n      {\n        id: \"target_temperature\",\n        name: tName(\"targetTemperature\"),\n        type: \"number\",\n        role: \"level.temperature\",\n        write: true,\n        min: range.min,\n        max: range.max,\n        unit,\n        def: range.min,\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      },\n    ];\n  }\n\n  // No usable schema \u2014 expose the raw payload so the user at least sees\n  // the attempt and can report it. Stays JSON to avoid pretending we\n  // understand the structure.\n  return [\n    {\n      id: \"target_temperature\",\n      name: tName(\"targetTemperature\"),\n      type: \"string\",\n      role: \"json\",\n      write: true,\n      def: \"\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    },\n  ];\n}\n\n/**\n * Map event capability (asynchronous OpenAPI-MQTT alarms \u2014 read-only).\n * Each event becomes a boolean indicator in the events/ channel\n * (lackWater, iceFull, bodyAppeared, dirtDetected, \u2026).\n *\n * @param cap Cloud event capability\n */\nfunction mapEvent(cap: CloudCapability): StateDefinition[] {\n  return [\n    {\n      id: sanitizeId(cap.instance),\n      name: humanize(cap.instance),\n      type: \"boolean\",\n      role: \"indicator.alarm\",\n      write: false,\n      def: false,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n      channel: \"events\",\n    },\n  ];\n}\n\n/**\n * Map music_setting capability to user-friendly states.\n * Parses STRUCT fields into: mode dropdown, sensitivity slider, auto-color toggle.\n *\n * @param cap Cloud music_setting capability\n */\nfunction mapMusicSetting(cap: CloudCapability): StateDefinition[] {\n  const fields = cap.parameters?.fields;\n  if (!Array.isArray(fields) || fields.length === 0) {\n    // No field details from API \u2014 can't create usable states\n    return [];\n  }\n\n  const states: StateDefinition[] = [];\n\n  // Mode dropdown \u2014 only if API provides actual mode options\n  const modeField = fields.find(f => f && typeof f.fieldName === \"string\" && f.fieldName === \"musicMode\");\n  if (modeField?.options && Array.isArray(modeField.options) && modeField.options.length > 0) {\n    const modeStates: Record<string, string> = { 0: \"---\" };\n    for (const opt of modeField.options) {\n      if (!opt || typeof opt.name !== \"string\") {\n        continue;\n      }\n      modeStates[typeof opt.value === \"object\" ? JSON.stringify(opt.value) : String(opt.value)] = opt.name;\n    }\n    states.push({\n      id: \"music_mode\",\n      name: tName(\"musicMode\"),\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: modeStates,\n      def: \"0\",\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  // Sensitivity slider\n  const sensField = fields.find(f => f && typeof f.fieldName === \"string\" && f.fieldName === \"sensitivity\");\n  if (sensField?.range) {\n    states.push({\n      id: \"music_sensitivity\",\n      name: tName(\"musicSensitivity\"),\n      type: \"number\",\n      role: \"level\",\n      write: true,\n      min: sensField.range.min,\n      max: sensField.range.max,\n      unit: \"%\",\n      def: sensField.range.max,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  // Auto color toggle\n  const autoColorField = fields.find(f => f && typeof f.fieldName === \"string\" && f.fieldName === \"autoColor\");\n  if (autoColorField) {\n    states.push({\n      id: \"music_auto_color\",\n      name: tName(\"musicAutoColor\"),\n      type: \"boolean\",\n      role: \"switch\",\n      write: true,\n      def: true,\n      capabilityType: cap.type,\n      capabilityInstance: cap.instance,\n    });\n  }\n\n  // All music states belong to the music channel\n  for (const s of states) {\n    s.channel = \"music\";\n  }\n  return states;\n}\n\n/**\n * Apply device quirks to mapped state definitions.\n * Corrects wrong API data (e.g. color temperature range) for specific SKUs.\n *\n * @param sku Device model (e.g. \"H60A1\")\n * @param states State definitions to adjust\n * @param log Adapter logger \u2014 quirk-applied events land on debug.\n */\nexport function applyQuirksToStates(sku: string, states: StateDefinition[], log: ioBroker.Logger): StateDefinition[] {\n  for (const state of states) {\n    if (state.id === \"colorTemperature\" && state.min != null && state.max != null) {\n      const corrected = applyColorTempQuirk(sku, state.min, state.max);\n      if (corrected.min !== state.min || corrected.max !== state.max) {\n        log.debug(\n          `Quirk applied for ${sku}: colorTemperature range ${state.min}-${state.max}K \u2192 ${corrected.min}-${corrected.max}K`,\n        );\n      }\n      state.min = corrected.min;\n      state.max = corrected.max;\n      state.def = corrected.min;\n    }\n  }\n  return states;\n}\n\n/** Known Govee API unit strings \u2192 ioBroker units */\nconst UNIT_MAP: Record<string, string> = {\n  \"unit.percent\": \"%\",\n  \"unit.kelvin\": \"K\",\n  \"unit.celsius\": \"\u00B0C\",\n  \"unit.fahrenheit\": \"\u00B0F\",\n};\n\n/**\n * Normalize Govee API unit string to ioBroker standard\n *\n * @param unit Raw unit string from API\n */\nfunction normalizeUnit(unit?: string): string | undefined {\n  if (!unit) {\n    return undefined;\n  }\n  return UNIT_MAP[unit] ?? unit;\n}\n\n/**\n * Sanitize a string for use as ioBroker state ID\n *\n * @param str Input string to sanitize\n */\nfunction sanitizeId(str: string): string {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1_$2\")\n    .replace(/[^a-zA-Z0-9_]/g, \"_\")\n    .toLowerCase();\n}\n\n/**\n * Convert camelCase to human-readable name\n *\n * @param str camelCase input string\n */\nfunction humanize(str: string): string {\n  // Reihenfolge: erst Underscore \u2192 Space, dann camelCase-split, dann\n  // trim + erstes Zeichen uppercase. Vorher: leading-underscore-IDs\n  // (z.B. `_segment_color`) wurden zu ` segment color` mit leading\n  // Space und ohne Capitalization (^\\w matched space, nicht word-char).\n  return str\n    .replace(/_/g, \" \")\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .trim()\n    .replace(/^./, c => c.toUpperCase());\n}\n\n/** Mapped Cloud state value: state ID + converted value */\nexport interface CloudStateValue {\n  /** State ID in control/ channel (e.g. \"power\", \"brightness\", \"gradient_toggle\") */\n  stateId: string;\n  /** Converted value ready for ioBroker setStateAsync */\n  value: ioBroker.StateValue;\n}\n\n/**\n * Map a Cloud device state capability to a state ID + converted value.\n * Uses the same ID logic as mapCapabilities so IDs always match.\n *\n * @param cap Cloud state capability with current value\n */\nexport function mapCloudStateValue(cap: CloudStateCapability): CloudStateValue | null {\n  if (!cap || typeof cap.type !== \"string\" || typeof cap.instance !== \"string\") {\n    return null;\n  }\n  const shortType = cap.type.replace(\"devices.capabilities.\", \"\");\n  const raw = cap.state?.value;\n  if (raw === undefined || raw === null) {\n    return null;\n  }\n\n  switch (shortType) {\n    case \"on_off\":\n      return { stateId: \"power\", value: coerceBool(raw) };\n\n    case \"range\": {\n      const n = coerceNum(raw);\n      if (n === null) {\n        return null;\n      }\n      return { stateId: sanitizeId(cap.instance), value: n };\n    }\n\n    case \"color_setting\":\n      if (cap.instance === \"colorRgb\") {\n        const num = coerceNum(raw) ?? 0;\n        return {\n          stateId: \"colorRgb\",\n          value: rgbToHex((num >> 16) & 0xff, (num >> 8) & 0xff, num & 0xff),\n        };\n      }\n      if (cap.instance.includes(\"colorTem\")) {\n        const n = coerceNum(raw);\n        if (n === null) {\n          return null;\n        }\n        return { stateId: \"colorTemperature\", value: n };\n      }\n      return null;\n\n    case \"toggle\":\n      return { stateId: sanitizeId(cap.instance), value: coerceBool(raw) };\n\n    case \"mode\":\n      if (cap.instance === \"presetScene\") {\n        return {\n          stateId: \"scene\",\n          value: safeStringify(raw),\n        };\n      }\n      return null;\n\n    case \"dynamic_scene\":\n      return {\n        stateId: sanitizeId(cap.instance),\n        value: safeStringify(raw),\n      };\n\n    case \"work_mode\": {\n      // STRUCT: { workMode: <number>, modeValue?: <number> }. Cloud\n      // /device/state only returns the primary mode here \u2014 mode_value\n      // (sub-parameter) follows via MQTT status push when the device\n      // reports it, so we don't lose it just because it isn't in the\n      // initial state response.\n      if (typeof raw === \"object\" && raw !== null) {\n        const struct = raw as Record<string, unknown>;\n        const n = coerceNum(struct.workMode);\n        if (n !== null) {\n          return { stateId: \"work_mode\", value: n };\n        }\n      }\n      const direct = coerceNum(raw);\n      if (direct !== null) {\n        return { stateId: \"work_mode\", value: direct };\n      }\n      return null;\n    }\n\n    case \"temperature_setting\": {\n      // STRUCT: { targetTemperature: <number>, temperatureUnit?: ... }\n      // \u2014 fall back to direct number for adapters that simplify.\n      const direct = coerceNum(raw);\n      if (direct !== null) {\n        return { stateId: \"target_temperature\", value: direct };\n      }\n      if (typeof raw === \"object\" && raw !== null) {\n        const struct = raw as Record<string, unknown>;\n        const temp = struct.targetTemperature ?? struct.temperature ?? struct.temp;\n        const n = coerceNum(temp);\n        if (n !== null) {\n          return { stateId: \"target_temperature\", value: n };\n        }\n      }\n      return null;\n    }\n\n    case \"event\":\n      return {\n        stateId: sanitizeId(cap.instance),\n        value: coerceBool(raw),\n      };\n\n    case \"music_setting\":\n      // Extract mode value from STRUCT state\n      if (typeof raw === \"object\" && raw !== null) {\n        const struct = raw as Record<string, unknown>;\n        const mode = coerceNum(struct.musicMode);\n        return {\n          stateId: \"music_mode\",\n          value: mode !== null ? String(mode) : \"0\",\n        };\n      }\n      return null;\n\n    case \"property\": {\n      const n = coerceNum(raw);\n      if (n === null) {\n        return null;\n      }\n      return { stateId: sanitizeId(cap.instance), value: n };\n    }\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Plan the per-state writes for a list of synthesised Cloud-state\n * capabilities. Used by the App-API poll and the OpenAPI-MQTT event\n * handler (both call into `applyCloudCapabilities` on the adapter side).\n *\n * Returns the resolved `(stateId, value)` pairs for capabilities that:\n *   - decode via `mapCloudStateValue` to a non-null result, AND\n *   - aren't shadowed by the LAN-state set when the device is LAN-capable\n *     (lights with `lanIp` shouldn't have their LAN sub-second updates\n *      overwritten by a Cloud-source value).\n *\n * Pure function \u2014 no adapter state, no I/O \u2014 so the LAN-shadow logic is\n * unit-testable independent of the live state-write pipeline.\n *\n * @param caps Capabilities to consider\n * @param hasLanIp Whether the target device has a known LAN IP\n * @param lanStateIds Default-LAN state IDs that LAN delivers authoritatively\n */\nexport function planCloudCapabilityWrites(\n  caps: CloudStateCapability[],\n  hasLanIp: boolean,\n  lanStateIds: ReadonlySet<string>,\n): CloudStateValue[] {\n  const writes: CloudStateValue[] = [];\n  if (!Array.isArray(caps)) {\n    return writes;\n  }\n  for (const cap of caps) {\n    const mapped = mapCloudStateValue(cap);\n    if (!mapped) {\n      continue;\n    }\n    if (hasLanIp && lanStateIds.has(mapped.stateId)) {\n      continue;\n    }\n    writes.push(mapped);\n  }\n  return writes;\n}\n\n/**\n * Scene-dropdown rules \u2014 three states with identical shape (dropdown over a\n * device-content array, capabilityType `dynamic_scene`). Adding a new\n * scene-style dropdown means: append one entry here. The 8 other Cloud-derived\n * states (scene_speed, refresh_cloud, snapshot_local/save/delete, diag.*)\n * have genuinely different shapes and stay inline \u2014 not the same anti-pattern.\n */\nconst SCENE_DROPDOWN_RULES: ReadonlyArray<{\n  id: string;\n  cap: \"lightScene\" | \"diyScene\" | \"snapshot\";\n  nameKey: Parameters<typeof tName>[0];\n  descKey?: Parameters<typeof tDesc>[0];\n  channel: \"scenes\" | \"snapshots\";\n  source: (d: GoveeDevice) => { name: string }[];\n}> = [\n  { id: \"light_scene\", cap: \"lightScene\", nameKey: \"lightScene\", channel: \"scenes\", source: d => d.scenes },\n  { id: \"diy_scene\", cap: \"diyScene\", nameKey: \"diyScene\", channel: \"scenes\", source: d => d.diyScenes },\n  {\n    id: \"snapshot_cloud\",\n    cap: \"snapshot\",\n    nameKey: \"cloudSnapshot\",\n    descKey: \"cloudSnapshotDesc\",\n    channel: \"snapshots\",\n    source: d => d.snapshots,\n  },\n];\n\n/**\n * Build LAN-owned state definitions for a device. Returns the four\n * lan-default states (power/brightness/colorRgb/colorTemperature) with quirks\n * applied, or [] for devices without a LAN address (sensors, appliances,\n * groups).\n *\n * Phase-Architektur: geh\u00F6rt zur LAN-Phase. Wird gerufen wenn ein Ger\u00E4t per\n * LAN-Discovery sichtbar wird oder mit lanIp aus dem Cache geladen wird.\n *\n * @param device Govee device\n * @param log Adapter logger \u2014 forwarded to applyQuirksToStates.\n */\nexport function buildLanStateDefs(device: GoveeDevice, log: ioBroker.Logger): StateDefinition[] {\n  if (!device.lanIp) {\n    return [];\n  }\n  const stateDefs = getDefaultLanStates();\n  applyQuirksToStates(device.sku, stateDefs, log);\n  return stateDefs;\n}\n\n/**\n * Build Cloud-owned state definitions for a device \u2014 everything that needs\n * Cloud capabilities or local synthetic decoration. Excludes LAN-default IDs\n * (the LAN phase owns those). Returns intersection state for BaseGroup\n * devices.\n *\n * Phase-Architektur: geh\u00F6rt zur Cloud-Phase. Wird gerufen wenn capabilities\n * f\u00FCr ein Ger\u00E4t aus dem Cache oder einem frischen Cloud-Load verf\u00FCgbar sind.\n *\n * @param device Govee device\n * @param log Adapter logger \u2014 forwarded to mapCapabilities / applyQuirksToStates.\n * @param localSnapshots Optional local snapshot names\n * @param memberDevices Resolved member devices (only for BaseGroup)\n */\nexport function buildCloudStateDefs(\n  device: GoveeDevice,\n  log: ioBroker.Logger,\n  localSnapshots?: { name: string }[],\n  memberDevices?: GoveeDevice[],\n): StateDefinition[] {\n  if (device.sku === \"BaseGroup\") {\n    return buildGroupStateDefs(memberDevices || []);\n  }\n\n  // Capability-derived states with LAN-default IDs filtered out \u2014 the LAN\n  // phase owns those, capability mapper duplicates would land in the same\n  // channel and confuse cleanup. Single source of truth: LAN_STATE_IDS.\n  const stateDefs: StateDefinition[] = mapCapabilities(device.capabilities, log).filter(d => !LAN_STATE_IDS.has(d.id));\n\n  applyQuirksToStates(device.sku, stateDefs, log);\n\n  // Light-only synthetic state defs \u2014 scenes / snapshots / music / scene_speed\n  // only make sense for lights. Sensors and appliances would otherwise see\n  // empty snapshot dropdowns and a useless save/delete button pair.\n  const isLight = device.type === \"devices.types.light\";\n\n  // Three structurally-identical Cloud dropdowns \u2014 collapsed into one loop.\n  for (const r of SCENE_DROPDOWN_RULES) {\n    if (!isLight || !hasDynamicSceneCapability(device.capabilities, r.cap)) {\n      continue;\n    }\n    stateDefs.push({\n      id: r.id,\n      name: tName(r.nameKey),\n      desc: r.descKey ? tDesc(r.descKey) : undefined,\n      // mixed lets users write the index (\"1\"), the index as number (1),\n      // or the entry name (\"Aurora\") \u2014 the onStateChange handler resolves\n      // all three forms via the common.states map.\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(r.source(device)),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: r.cap,\n      channel: r.channel,\n    });\n  }\n\n  // Scene speed slider \u2014 only if any scene supports speed adjustment.\n  // Stays inline: depends on a computed maxSpeedLevel that doesn't fit the\n  // dropdown-rule shape.\n  const maxSpeedLevel = device.sceneLibrary.reduce((max, entry) => {\n    if (entry.speedInfo?.supSpeed && entry.speedInfo.config) {\n      try {\n        const parsed = JSON.parse(entry.speedInfo.config) as unknown;\n        // Config can drift \u2014 if not an array, skip this entry silently\n        if (!Array.isArray(parsed)) {\n          return max;\n        }\n        for (const cfg of parsed as Array<{ moveIn?: number[] }>) {\n          if (cfg && Array.isArray(cfg.moveIn) && cfg.moveIn.length - 1 > max) {\n            max = cfg.moveIn.length - 1;\n          }\n        }\n      } catch {\n        /* ignore invalid config JSON */\n      }\n    }\n    return max;\n  }, -1);\n  if (isLight && maxSpeedLevel > 0) {\n    stateDefs.push({\n      id: \"scene_speed\",\n      name: tName(\"sceneSpeed\"),\n      type: \"number\",\n      role: \"level\",\n      write: true,\n      min: 0,\n      max: maxSpeedLevel,\n      def: 0,\n      capabilityType: \"local\",\n      capabilityInstance: \"sceneSpeed\",\n      channel: \"scenes\",\n    });\n  }\n\n  // Per-device refresh button \u2014 gated on ANY dynamic-scene capability.\n  // OR-gate over three caps doesn't fit a rules-table.\n  if (\n    isLight &&\n    (hasDynamicSceneCapability(device.capabilities, \"lightScene\") ||\n      hasDynamicSceneCapability(device.capabilities, \"diyScene\") ||\n      hasDynamicSceneCapability(device.capabilities, \"snapshot\"))\n  ) {\n    stateDefs.push({\n      id: \"refresh_cloud\",\n      name: tName(\"refreshCloud\"),\n      desc: tDesc(\"refreshCloudDesc\"),\n      type: \"boolean\",\n      role: \"button\",\n      write: true,\n      def: false,\n      capabilityType: \"local\",\n      capabilityInstance: \"refreshCloud\",\n      channel: \"snapshots\",\n    });\n  }\n\n  // Local snapshots \u2014 three states with different shapes (mixed dropdown vs\n  // plain string-write fields). Inline because a rules-table would need a\n  // discriminator field with no payoff.\n  if (isLight) {\n    stateDefs.push({\n      id: \"snapshot_local\",\n      name: tName(\"localSnapshot\"),\n      desc: tDesc(\"localSnapshotDesc\"),\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(localSnapshots ?? []),\n      def: \"0\",\n      capabilityType: \"local\",\n      capabilityInstance: \"snapshotLocal\",\n      channel: \"snapshots\",\n    });\n    stateDefs.push({\n      id: \"snapshot_save\",\n      name: tName(\"saveLocalSnapshot\"),\n      desc: tDesc(\"saveLocalSnapshotDesc\"),\n      type: \"string\",\n      role: \"text\",\n      write: true,\n      def: \"\",\n      capabilityType: \"local\",\n      capabilityInstance: \"snapshotSave\",\n      channel: \"snapshots\",\n    });\n    stateDefs.push({\n      id: \"snapshot_delete\",\n      name: tName(\"deleteLocalSnapshot\"),\n      desc: tDesc(\"deleteLocalSnapshotDesc\"),\n      type: \"string\",\n      role: \"text\",\n      write: true,\n      def: \"\",\n      capabilityType: \"local\",\n      capabilityInstance: \"snapshotDelete\",\n      channel: \"snapshots\",\n    });\n  }\n\n  // Diagnostics \u2014 three states with different shapes (boolean button vs\n  // read-only string vs string with fixed states map). Inline for same\n  // reason as local snapshots.\n  stateDefs.push({\n    id: \"export\",\n    name: tName(\"exportDiagnostics\"),\n    type: \"boolean\",\n    role: \"button\",\n    write: true,\n    def: false,\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsExport\",\n    channel: \"diag\",\n  });\n  stateDefs.push({\n    id: \"result\",\n    name: tName(\"diagnosticsJson\"),\n    type: \"string\",\n    role: \"json\",\n    write: false,\n    def: \"\",\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsResult\",\n    channel: \"diag\",\n  });\n  // Trust tier for the user \u2014 verified/reported/seed/unknown. Tells\n  // power users whether the experimental toggle would buy them anything,\n  // and lets unknown-SKU users see at a glance that their device isn't\n  // in the catalogue yet.\n  stateDefs.push({\n    id: \"tier\",\n    name: tName(\"deviceTier\"),\n    type: \"string\",\n    role: \"text\",\n    write: false,\n    def: \"unknown\",\n    states: {\n      verified: tLabel(\"deviceTierVerified\"),\n      reported: tLabel(\"deviceTierReported\"),\n      seed: tLabel(\"deviceTierSeed\"),\n      unknown: tLabel(\"deviceTierUnknown\"),\n    },\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsTier\",\n    channel: \"diag\",\n  });\n\n  return stateDefs;\n}\n\n/**\n * Check if a member device supports a given control state.\n * LAN-capable devices support all basic controls.\n *\n * @param member Group member device\n * @param stateId Control state ID (e.g. \"power\", \"brightness\")\n */\nfunction memberHasControlState(member: GoveeDevice, stateId: string): boolean {\n  if (member.lanIp) {\n    return true;\n  }\n  const caps = Array.isArray(member.capabilities) ? member.capabilities : [];\n  switch (stateId) {\n    case \"power\":\n      return caps.some(c => c && typeof c.type === \"string\" && c.type.endsWith(\"on_off\"));\n    case \"brightness\":\n      return caps.some(\n        c =>\n          c &&\n          typeof c.type === \"string\" &&\n          typeof c.instance === \"string\" &&\n          c.type.endsWith(\"range\") &&\n          c.instance === \"brightness\",\n      );\n    case \"colorRgb\":\n      return caps.some(\n        c =>\n          c &&\n          typeof c.type === \"string\" &&\n          typeof c.instance === \"string\" &&\n          c.type.endsWith(\"color_setting\") &&\n          c.instance === \"colorRgb\",\n      );\n    case \"colorTemperature\":\n      return caps.some(\n        c =>\n          c &&\n          typeof c.type === \"string\" &&\n          typeof c.instance === \"string\" &&\n          c.type.endsWith(\"color_setting\") &&\n          (c.instance === \"colorTem\" || c.instance === \"colorTemperatureK\"),\n      );\n    default:\n      return false;\n  }\n}\n\n/**\n * Build state definitions for a BaseGroup device.\n * Capabilities = intersection of controllable member devices.\n * No snapshots, no diagnostics, no segments.\n *\n * @param members Resolved member devices\n */\nfunction buildGroupStateDefs(members: GoveeDevice[]): StateDefinition[] {\n  const controllable = members.filter(m => m.lanIp || m.channels.cloud);\n  if (controllable.length === 0) {\n    return [];\n  }\n\n  const stateDefs: StateDefinition[] = [];\n\n  // Control states: intersection of member capabilities\n  for (const ld of getDefaultLanStates()) {\n    if (controllable.every(m => memberHasControlState(m, ld.id))) {\n      stateDefs.push(ld);\n    }\n  }\n\n  // Scenes: intersection of member scene names\n  if (controllable.every(m => m.scenes.length > 0)) {\n    const firstNames = controllable[0].scenes.map(s => s.name);\n    const commonNames = firstNames.filter(name => controllable.every(m => m.scenes.some(s => s.name === name)));\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"light_scene\",\n        name: tName(\"lightScene\"),\n        type: \"mixed\",\n        role: \"text\",\n        write: true,\n        states: buildUniqueLabelMap(commonNames.map(name => ({ name }))),\n        def: \"0\",\n        capabilityType: \"devices.capabilities.dynamic_scene\",\n        capabilityInstance: \"lightScene\",\n        channel: \"scenes\",\n      });\n    }\n  }\n\n  // Music: intersection of member music libraries\n  if (controllable.every(m => m.musicLibrary.length > 0)) {\n    const firstNames = controllable[0].musicLibrary.map(m => m.name);\n    const commonNames = firstNames.filter(name => controllable.every(m => m.musicLibrary.some(ml => ml.name === name)));\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"music_mode\",\n        name: tName(\"musicMode\"),\n        type: \"mixed\",\n        role: \"text\",\n        write: true,\n        states: buildUniqueLabelMap(commonNames.map(name => ({ name }))),\n        def: \"0\",\n        capabilityType: \"devices.capabilities.music_setting\",\n        capabilityInstance: \"musicMode\",\n        channel: \"music\",\n      });\n    }\n  }\n\n  return stateDefs;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/lib/device-manager.js

@@ -234,9 +234,12 @@ class DeviceManager {
       return false;
     }
     let changed = false;
+    const nowMs = Date.now();
     for (const entry of cached) {
       const key = this.deviceKey(entry.sku, entry.deviceId);
       const existing = this.devices.get(key);
+      const ageDays = typeof entry.lastSeenOnNetwork === "number" ? Math.round((nowMs - entry.lastSeenOnNetwork) / 864e5) : null;
+      const ageInfo = ageDays === null ? "no age data (legacy entry)" : `${ageDays}d since last seen`;
       if (existing) {
         existing.name = entry.name || existing.name;
         existing.type = entry.type || existing.type;
@@ -256,9 +259,15 @@ class DeviceManager {
         existing.manualSegments = entry.manualSegments;
         existing.channels.cloud = entry.capabilities.length > 0;
         changed = true;
+        this.log.debug(
+          `Cache merged into LAN-discovered device ${entry.sku} ${entry.deviceId} (${ageInfo}, caps=${entry.capabilities.length})`
+        );
       } else {
         this.devices.set(key, cacheHelpers.cachedToGoveeDevice(entry));
         changed = true;
+        this.log.debug(
+          `Cache restored (no LAN discovery yet) for ${entry.sku} ${entry.deviceId} (${ageInfo}, caps=${entry.capabilities.length})`
+        );
       }
     }
     if (changed) {
@@ -532,10 +541,12 @@ class DeviceManager {
         try {
           const lib = await this.apiClient.fetchSceneLibrary(sku);
           this.diagnostics.recordApiSuccess(device.deviceId, ep, { count: lib.length, names: lib.map((s) => s.name) });
+          this.log.debug(
+            `Scene library for ${sku}: ${lib.length} scene(s)${lib.length === 0 ? " \u2014 empty (Govee returned no data for this SKU)" : ""}`
+          );
           if (lib.length > 0) {
             device.sceneLibrary = lib;
             changed = true;
-            this.log.debug(`Scene library for ${sku}: ${lib.length} scenes`);
           }
         } catch (e) {
           this.diagnostics.recordApiFailure(device.deviceId, ep, e, this.extractStatus(e));
@@ -549,10 +560,12 @@ class DeviceManager {
         try {
           const lib = await this.apiClient.fetchMusicLibrary(sku);
           this.diagnostics.recordApiSuccess(device.deviceId, ep, { count: lib.length, names: lib.map((m) => m.name) });
+          this.log.debug(
+            `Music library for ${sku}: ${lib.length} mode(s)${lib.length === 0 ? " \u2014 empty (Govee returned no data for this SKU)" : ""}`
+          );
           if (lib.length > 0) {
             device.musicLibrary = lib;
             changed = true;
-            this.log.debug(`Music library for ${sku}: ${lib.length} modes`);
           }
         } catch (e) {
           this.diagnostics.recordApiFailure(device.deviceId, ep, e, this.extractStatus(e));
@@ -566,10 +579,12 @@ class DeviceManager {
         try {
           const lib = await this.apiClient.fetchDiyLibrary(sku);
           this.diagnostics.recordApiSuccess(device.deviceId, ep, { count: lib.length, names: lib.map((d) => d.name) });
+          this.log.debug(
+            `DIY library for ${sku}: ${lib.length} effect(s)${lib.length === 0 ? " \u2014 empty (Govee returned no data for this SKU)" : ""}`
+          );
           if (lib.length > 0) {
             device.diyLibrary = lib;
             changed = true;
-            this.log.debug(`DIY library for ${sku}: ${lib.length} effects`);
           }
         } catch (e) {
           this.diagnostics.recordApiFailure(device.deviceId, ep, e, this.extractStatus(e));
@@ -587,6 +602,8 @@ class DeviceManager {
             device.skuFeatures = features;
             changed = true;
             this.log.debug(`SKU features for ${sku}: ${JSON.stringify(features).slice(0, 200)}`);
+          } else {
+            this.log.debug(`SKU features for ${sku}: null \u2014 Govee returned no data for this SKU`);
           }
         } catch (e) {
           this.diagnostics.recordApiFailure(device.deviceId, ep, e, this.extractStatus(e));
@@ -598,6 +615,9 @@ class DeviceManager {
       await runLimited(async () => {
         try {
           const snaps = await this.apiClient.fetchSnapshots(sku, device.deviceId);
+          this.log.debug(
+            `Snapshot BLE for ${sku}: ${snaps.length} snapshot(s) with local data${snaps.length === 0 ? " \u2014 Govee returned no BLE-cmds for this SKU/device" : ""}`
+          );
           if (snaps.length > 0) {
             device.snapshotBleCmds = device.snapshots.map((ds) => {
               var _a;
@@ -605,7 +625,6 @@ class DeviceManager {
               return (_a = match == null ? void 0 : match.bleCmds) != null ? _a : [];
             });
             changed = true;
-            this.log.debug(`Snapshot BLE for ${sku}: ${snaps.length} snapshots with local data`);
           }
         } catch (e) {
           this.log.debug(`Could not load snapshot BLE for ${sku}: ${(0, import_types.errMessage)(e)}`);