iobroker.govee-smart 2.0.0 → 2.0.2

package/README.md

@@ -61,7 +61,7 @@ Full user documentation lives in the **[Wiki](https://github.com/krobipd/ioBroke
 ## Requirements
 
 - Node.js >= 20
-- ioBroker js-controller >= 7.0.0
+- ioBroker js-controller >= 7.0.23
 - ioBroker Admin >= 7.6.20
 - A Govee account and at least one Govee WiFi device. LAN control needs a light with LAN mode enabled in the Govee Home app — see Govee's [LAN-supported device list](https://app-h5.govee.com/user-manual/wlan-guide).
 
@@ -107,51 +107,43 @@ This adapter's MQTT authentication and BLE-over-LAN (ptReal) protocol implementa
 
 ## Changelog
 
+### 2.0.2 (2026-04-26)
+- OpenAPI MQTT now keeps a stable client ID across reconnects (was `Date.now`-based, which Govee's broker treats as new connections).
+- Stop shipping the `manual-review` release-script plugin and the redundant `@iobroker/types` runtime dep — adapter-only consequences.
+- Bump min js-controller to `>=7.0.23` (matches latest-repo recommendation).
+- Audit-driven boilerplate sync with the other krobi adapters (`.vscode` json5 schemas, dependabot assignees + github-actions ecosystem, `tsconfig.test` looser test rules).
+- Repo hygiene: ignore `package/` (npm-pack artefact).
+
+### 2.0.1 (2026-04-26)
+- Sensor states route to `sensor/`, event states to `events/` (was `control/` for both); state objects are created lazily on first write to avoid `no existing object` warnings.
+- Snapshots and scenes only attach to lights now; thermometers, heaters and kettles no longer get `snapshot_local` / `snapshot_save` / `snapshot_delete`.
+- No more boot-time `N experimental device(s) detected` log dump — only triggers when an experimental SKU actually shows up, once per lifetime per SKU.
+- Routine `OpenAPI MQTT connected for sensor events` info line removed; reconnect-recovery log kept.
+
 ### 2.0.0 (2026-04-26)
-- Major release — Govee appliances and sensors are now handled by this adapter alongside lights. Govee thermometers (e.g. H5179), heaters, kettles, ice makers and more are imported through the App API (sensor states) and the OpenAPI-MQTT push channel (appliance events).
-- The standalone `iobroker.govee-appliances` adapter is deprecated and rolls into here. The old adapter still runs but receives no further updates — install govee-smart 2.0.0+ and uninstall govee-appliances at your convenience.
-- New checkbox **"Enable experimental device support"** in the adapter config makes it easier to try unconfirmed models. The Wiki page [Devices](https://github.com/krobipd/ioBroker.govee-smart/wiki/Devices) lists every supported SKU and its status (verified ✅ / user-confirmed 🟢 / experimental ⚪).
-- Devices catalog (`devices.json` in the repo root) tracks 36 SKUs at release time; the catalog is the single source of truth for the Wiki page and for runtime quirk-overrides like the per-SKU color-temperature ranges that Govee's API misreports.
-- New state `info.openapiMqttConnected` for the second MQTT channel that delivers appliance events. The existing `info.mqttConnected` keeps tracking AWS IoT MQTT for light status push.
+- Major release — Govee appliances and sensors (thermometers like H5179, heaters, kettles, ice makers) are now handled here alongside lights, via the App API and OpenAPI-MQTT push channel.
+- The standalone `iobroker.govee-appliances` adapter is deprecated and rolls into here. Install govee-smart 2.0.0+ and uninstall govee-appliances when convenient.
+- New **"Enable experimental device support"** checkbox in the adapter config. The Wiki [Devices](https://github.com/krobipd/ioBroker.govee-smart/wiki/Devices) page lists every SKU and its status.
+- `devices.json` in the repo root tracks 36 SKUs and is the single source of truth for the Wiki and for runtime quirk overrides.
+- New state `info.openapiMqttConnected` for the OpenAPI-MQTT channel; `info.mqttConnected` keeps tracking AWS IoT MQTT for lights.
 
 ### 1.11.0 (2026-04-25)
-- Scene / DIY-scene / snapshot / music-mode dropdowns now accept three input forms from Blockly and JS scripts: the index as a string (`"1"`), the index as a number (`1`), or the entry name (`"Aurora"`, case-insensitive, surrounding whitespace ignored). The state type changed from `string` to `mixed` so the js-controller no longer warns `expects type string but received number` when a script writes a numeric index.
-- Duplicate names from the cloud (Govee allows two scenes called "Movie") are now auto-disambiguated in the dropdown with `" (2)"`, `" (3)"` suffixes — the first occurrence keeps the original name, every label maps to exactly one index, and the reverse-lookup is deterministic.
-- After activation the adapter acks back the canonical key so the dropdown stays in sync regardless of how the user wrote the value — `setState(oid, "Aurora")` ends up showing "Aurora" in the dropdown just like `setState(oid, "1")` does.
+- Scene / DIY-scene / snapshot / music-mode dropdowns now accept index-as-number, index-as-string and the entry name (case-insensitive). The state type is `mixed` — no more `expects type string but received number` warning when scripts write a numeric index.
+- Duplicate scene names from the cloud are auto-disambiguated with `" (2)"`, `" (3)"` suffixes; reverse-lookup is deterministic.
+- The adapter acks back the canonical key after activation, so the dropdown stays in sync regardless of how the value was written.
 
 ### 1.10.1 (2026-04-20)
-- Fix — the `info.refresh_cloud_data` button was re-fetching every device's scene / music / DIY / SKU-features libraries on each click. Libraries never change for a given SKU, and several of those endpoints return 403 for many accounts, so running them again on every refresh only produced a multi-minute rate-limiter backlog — visible in the log as minute-spaced POSTs to `/device/scenes` and `/device/diy-scenes` in the minutes after each click. The button now only re-fetches the scene/snapshot endpoint, which is where new Govee-app snapshots actually show up. Call count per click drops from ~7 to 2 per light device.
+- Refresh button no longer re-fetches static SKU libraries (scene/music/DIY/features) — call count drops from ~7 to 2 per device per click. The endpoints returned 403 for many accounts and just produced minute-long rate-limiter backlogs.
 
 ### 1.10.0 (2026-04-20)
-- Scenes with a `scenceParam` (the multi-packet A3 BLE payload that drives per-segment animation) are now skipped on devices without segments and activated via the Govee Cloud instead. Curtain Lights (H70B3) and bulbs silently drop those A3 packets, which left complex scenes unplayed; the simple presets without `scenceParam` kept working. With this fix every scene reaches the device, at the cost of one Cloud call per scene change on non-segmented hardware.
-- Powering a device off now resets every mode dropdown (scene, DIY scene, Cloud/local snapshot, music) to "---", whether the off was triggered from ioBroker or from the Govee Home app. A device that is off cannot be "playing Aurora-A" — the UI now reflects that.
+- Multi-packet A3 BLE scenes (`scenceParam`) are now activated via Cloud on devices without segments; bulbs and Curtain Lights silently dropped those packets before, so complex scenes never played.
+- Powering a device off resets every mode dropdown to `"---"` — both ioBroker and Govee-app initiated off events.
 
 ### 1.9.1 (2026-04-20)
-- Hotfix — Govee's `/device/scenes` endpoint occasionally returns e.g. 149 scenes + 0 snapshots on the same device where a snapshot clearly exists. The old combined guard (`if any of the three lists is non-empty, overwrite all three`) wiped the snapshot list in that case, and the cloud-snapshot dropdown then errored out with `invalid snapshot index 1` on click. Each of scenes, DIY scenes and snapshots is now guarded independently — a lucky list no longer clobbers an unlucky one. Applies to every device with cloud-side snapshots, not just the device where it first surfaced.
-
-### 1.9.0 (2026-04-20)
-- **BREAKING** — the cloud-snapshot dropdown has been renamed from `snapshots.snapshot` to `snapshots.snapshot_cloud`. The new id is unambiguous next to `snapshots.snapshot_local`, `snapshots.snapshot_save` and `snapshots.snapshot_delete`. If your scripts or VIS widgets reference the old id, update them to the new one. The old state is simply removed on first start — nothing is migrated because the value (a dropdown index) is set again on the next selection anyway.
-- Fix — scenes and snapshots are now re-fetched from the Govee Cloud on every adapter start. Previously, once `scenesChecked` was set on the cache, the adapter skipped the Cloud round-trip even when you had created a new snapshot in the Govee Home app, so new snapshots only appeared after wiping the cache. This was a genuine bug. Scene data is essentially static, but snapshots are user content — refreshing is cheap (one call per light device per startup) and much less surprising.
-- New — `info.refresh_cloud_data` button at adapter level. Write `true` to trigger the same fresh fetch without restarting the adapter. Useful when you just created a snapshot in the Govee Home app and want to pick it in ioBroker right now.
-- All four snapshot states (`snapshot_cloud`, `snapshot_local`, `snapshot_save`, `snapshot_delete`) now carry a `common.desc` text that makes it clear in the object browser which is the Govee-app kind and which is the ioBroker kind.
-
-### 1.8.0 (2026-04-20)
-- Performance — `updateDeviceState` now fires every status write in parallel and drops the per-write object-existence probe; MQTT status pushes cost a fraction of what they used to on large device lists
-- Performance — `cleanupAllChannelStates` replaces its four per-device view queries with one broader view; device-list refresh scales with device count instead of 4 × device count
-- Performance — `handleSnapshotSave` reads device + per-segment state in parallel; saving a snapshot on a 20-segment strip no longer blocks on 40 sequential reads
-- Rate-limiter daily reset aligned to UTC midnight so the adapter's budget flips at the same instant Govee does — no more wasted quota when the adapter was started after midnight
-- Local snapshots now write with `fsync`, matching the SKU cache — SIGKILL during adapter stop no longer silently drops a just-saved snapshot
-- Library fetches (scene / music / DIY / SKU features) now go through the rate-limiter so a fresh install with many devices doesn't burst-call the undocumented `app2.govee.com` endpoints
-- Wizard text fully localised (EN / DE) and resolved against the Admin UI language from `system.config`; English is the fallback for other admin languages
-- govee-appliances coexistence covers every instance (`.0`, `.1`, …) not just `.0` — the shared-budget halving trips for any active sibling
-- MQTT client keeps a stable per-process session UUID across reconnects; AWS IoT can now take over cleanly from a lingering socket instead of refusing a new connection
-- Memory leak prevention — every adapter-level map (diagnostics throttle, state-channel map, device map) is now reaped when a device is removed so long-lived instances stay bounded
-- Internal — shared `govee-constants.ts` for Govee app-impersonation headers, `stateToCommand` collapsed to a lookup table, `crypto.randomUUID` replaces the legacy Math.random UUID, unused `total` parameter dropped from `flashSingleSegment`
+- Each Cloud list (scenes / DIY / snapshots) is now guarded independently. Govee's `/device/scenes` sometimes returns e.g. 149 scenes + 0 snapshots when a snapshot clearly exists; the old combined guard then wiped existing snapshots and the dropdown errored on click.
 
 Older entries have been moved to [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
 
----
-
 ## Support
 
 - [Wiki](https://github.com/krobipd/ioBroker.govee-smart/wiki) — user documentation (EN / DE)

package/build/lib/capability-mapper.js

@@ -698,7 +698,8 @@ function buildDeviceStateDefs(device, localSnapshots, memberDevices) {
     stateDefs = mapCapabilities(device.capabilities);
   }
   applyQuirksToStates(device.sku, stateDefs);
-  if (device.scenes.length > 0) {
+  const isLight = device.type === "devices.types.light";
+  if (isLight && device.scenes.length > 0) {
     stateDefs.push({
       id: "light_scene",
       name: "Light Scene",
@@ -733,7 +734,7 @@ function buildDeviceStateDefs(device, localSnapshots, memberDevices) {
     }
     return max;
   }, -1);
-  if (maxSpeedLevel > 0) {
+  if (isLight && maxSpeedLevel > 0) {
     stateDefs.push({
       id: "scene_speed",
       name: "Scene Speed",
@@ -748,7 +749,7 @@ function buildDeviceStateDefs(device, localSnapshots, memberDevices) {
       channel: "scenes"
     });
   }
-  if (device.diyScenes.length > 0) {
+  if (isLight && device.diyScenes.length > 0) {
     stateDefs.push({
       id: "diy_scene",
       name: "DIY Scene",
@@ -762,7 +763,7 @@ function buildDeviceStateDefs(device, localSnapshots, memberDevices) {
       channel: "scenes"
     });
   }
-  if (device.snapshots.length > 0) {
+  if (isLight && device.snapshots.length > 0) {
     stateDefs.push({
       id: "snapshot_cloud",
       name: "Cloud Snapshot",
@@ -777,43 +778,45 @@ function buildDeviceStateDefs(device, localSnapshots, memberDevices) {
       channel: "snapshots"
     });
   }
-  stateDefs.push({
-    id: "snapshot_local",
-    name: "Local Snapshot",
-    desc: "Snapshots saved by this adapter on the ioBroker server. Independent of the Govee Home app.",
-    type: "mixed",
-    role: "text",
-    write: true,
-    states: (0, import_types.buildUniqueLabelMap)(localSnapshots != null ? localSnapshots : []),
-    def: "0",
-    capabilityType: "local",
-    capabilityInstance: "snapshotLocal",
-    channel: "snapshots"
-  });
-  stateDefs.push({
-    id: "snapshot_save",
-    name: "Save Local Snapshot",
-    desc: "Write a name to save the current device state (power, brightness, colour, per-segment colours) as a new local snapshot.",
-    type: "string",
-    role: "text",
-    write: true,
-    def: "",
-    capabilityType: "local",
-    capabilityInstance: "snapshotSave",
-    channel: "snapshots"
-  });
-  stateDefs.push({
-    id: "snapshot_delete",
-    name: "Delete Local Snapshot",
-    desc: "Write a local snapshot name to delete it. Does not affect Govee Home app snapshots.",
-    type: "string",
-    role: "text",
-    write: true,
-    def: "",
-    capabilityType: "local",
-    capabilityInstance: "snapshotDelete",
-    channel: "snapshots"
-  });
+  if (isLight) {
+    stateDefs.push({
+      id: "snapshot_local",
+      name: "Local Snapshot",
+      desc: "Snapshots saved by this adapter on the ioBroker server. Independent of the Govee Home app.",
+      type: "mixed",
+      role: "text",
+      write: true,
+      states: (0, import_types.buildUniqueLabelMap)(localSnapshots != null ? localSnapshots : []),
+      def: "0",
+      capabilityType: "local",
+      capabilityInstance: "snapshotLocal",
+      channel: "snapshots"
+    });
+    stateDefs.push({
+      id: "snapshot_save",
+      name: "Save Local Snapshot",
+      desc: "Write a name to save the current device state (power, brightness, colour, per-segment colours) as a new local snapshot.",
+      type: "string",
+      role: "text",
+      write: true,
+      def: "",
+      capabilityType: "local",
+      capabilityInstance: "snapshotSave",
+      channel: "snapshots"
+    });
+    stateDefs.push({
+      id: "snapshot_delete",
+      name: "Delete Local Snapshot",
+      desc: "Write a local snapshot name to delete it. Does not affect Govee Home app snapshots.",
+      type: "string",
+      role: "text",
+      write: true,
+      def: "",
+      capabilityType: "local",
+      capabilityInstance: "snapshotDelete",
+      channel: "snapshots"
+    });
+  }
   stateDefs.push({
     id: "diagnostics_export",
     name: "Export Diagnostics",

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.js\";\nimport { applyColorTempQuirk } from \"./device-registry.js\";\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  /** Display name */\n  name: 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;\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  /** Predefined states for select (value \u2192 label) */\n  states?: 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 * 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(\n  capabilities: CloudCapability[],\n): 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 * Default state definitions for LAN-only devices (no Cloud capabilities).\n * All LAN-capable Govee lights support: power, brightness, color, color temperature.\n */\nexport function getDefaultLanStates(): StateDefinition[] {\n  return [\n    {\n      id: \"power\",\n      name: \"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: \"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: \"Color RGB\",\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: \"Color Temperature\",\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 (\n    !cap ||\n    typeof cap.type !== \"string\" ||\n    typeof cap.instance !== \"string\"\n  ) {\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: \"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      // buildDeviceStateDefs from the scenes/snapshots arrays \u2014 skip the\n      // generic stub here so we don't create and immediately delete it.\n      if (\n        cap.instance === \"lightScene\" ||\n        cap.instance === \"diyScene\" ||\n        cap.instance === \"snapshot\"\n      ) {\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: \"Color RGB\",\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 (\n    cap.instance === \"colorTemperatureK\" ||\n    cap.instance.includes(\"colorTem\")\n  ) {\n    const range = cap.parameters?.range;\n    return [\n      {\n        id: \"colorTemperature\",\n        name: \"Color Temperature\",\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 (\n    cap.instance !== \"presetScene\" ||\n    !Array.isArray(cap.parameters?.options)\n  ) {\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 =\n      typeof opt.value === \"object\"\n        ? JSON.stringify(opt.value)\n        : String(opt.value);\n    states[val] = opt.name;\n  }\n\n  return [\n    {\n      id: \"scene\",\n      name: \"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: \"Work Mode\",\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[\n          typeof opt.value === \"object\"\n            ? JSON.stringify(opt.value)\n            : String(opt.value as string | number | boolean)\n        ] = opt.name;\n      }\n    }\n    states.push({\n      id: \"work_mode\",\n      name: \"Work Mode\",\n      type: \"mixed\",\n      role: \"level.mode\",\n      write: true,\n      states: modeStates,\n      def: modeField.options[0]\n        ? String(modeField.options[0].value as string | number)\n        : \"\",\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[\n            typeof opt.value === \"object\"\n              ? JSON.stringify(opt.value)\n              : String(opt.value as string | number | boolean)\n          ] = opt.name;\n        }\n      }\n      states.push({\n        id: \"mode_value\",\n        name: \"Mode Value\",\n        type: \"mixed\",\n        role: \"level\",\n        write: true,\n        states: valStates,\n        def: valueField.options[0]\n          ? String(valueField.options[0].value as string | number)\n          : \"\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      });\n    } else if (valueField.range) {\n      states.push({\n        id: \"mode_value\",\n        name: \"Mode Value\",\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: \"Target Temperature\",\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: \"Target Temperature\",\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: \"Target Temperature\",\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(\n    (f) => f && typeof f.fieldName === \"string\" && f.fieldName === \"musicMode\",\n  );\n  if (\n    modeField?.options &&\n    Array.isArray(modeField.options) &&\n    modeField.options.length > 0\n  ) {\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[\n        typeof opt.value === \"object\"\n          ? JSON.stringify(opt.value)\n          : String(opt.value as string | number | boolean)\n      ] = opt.name;\n    }\n    states.push({\n      id: \"music_mode\",\n      name: \"Music Mode\",\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(\n    (f) =>\n      f && typeof f.fieldName === \"string\" && f.fieldName === \"sensitivity\",\n  );\n  if (sensField?.range) {\n    states.push({\n      id: \"music_sensitivity\",\n      name: \"Music Sensitivity\",\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(\n    (f) => f && typeof f.fieldName === \"string\" && f.fieldName === \"autoColor\",\n  );\n  if (autoColorField) {\n    states.push({\n      id: \"music_auto_color\",\n      name: \"Music Auto Color\",\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(\n  sku: string,\n  states: StateDefinition[],\n): StateDefinition[] {\n  for (const state of states) {\n    if (\n      state.id === \"colorTemperature\" &&\n      state.min != null &&\n      state.max != null\n    ) {\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  return str\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/_/g, \" \")\n    .replace(/^\\w/, (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(\n  cap: CloudStateCapability,\n): CloudStateValue | null {\n  if (\n    !cap ||\n    typeof cap.type !== \"string\" ||\n    typeof cap.instance !== \"string\"\n  ) {\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:\n            typeof raw === \"object\" || typeof raw === \"function\"\n              ? JSON.stringify(raw)\n              : String(raw as string | number | boolean | bigint),\n        };\n      }\n      return null;\n\n    case \"dynamic_scene\":\n      return {\n        stateId: sanitizeId(cap.instance),\n        value:\n          typeof raw === \"object\" || typeof raw === \"function\"\n            ? JSON.stringify(raw)\n            : String(raw as string | number | boolean | bigint),\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 =\n          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: Set<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 * Build complete state definitions for a device.\n * Combines LAN defaults, Cloud capabilities, quirks, scenes, snapshots, and diagnostics.\n * For groups: computes capability intersection of member devices (no snapshots/diagnostics).\n *\n * @param device Govee device with capabilities, scenes, etc.\n * @param localSnapshots Optional local snapshot names\n * @param memberDevices Resolved member devices (only for BaseGroup)\n */\nexport function buildDeviceStateDefs(\n  device: GoveeDevice,\n  localSnapshots?: { name: string }[],\n  memberDevices?: GoveeDevice[],\n): StateDefinition[] {\n  if (device.sku === \"BaseGroup\") {\n    return buildGroupStateDefs(memberDevices || []);\n  }\n  let stateDefs: StateDefinition[];\n\n  if (device.lanIp) {\n    stateDefs = getDefaultLanStates();\n    if (device.capabilities.length > 0) {\n      const lanIds = new Set(stateDefs.map((d) => d.id));\n      const cloudDefs = mapCapabilities(device.capabilities);\n      for (const cd of cloudDefs) {\n        if (!lanIds.has(cd.id)) {\n          stateDefs.push(cd);\n        }\n      }\n    }\n  } else {\n    stateDefs = mapCapabilities(device.capabilities);\n  }\n\n  applyQuirksToStates(device.sku, stateDefs);\n\n  if (device.scenes.length > 0) {\n    stateDefs.push({\n      id: \"light_scene\",\n      name: \"Light Scene\",\n      // mixed lets users write the index (\"1\"), the index as number (1),\n      // or the scene 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(device.scenes),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: \"lightScene\",\n      channel: \"scenes\",\n    });\n  }\n\n  // Scene speed slider \u2014 only if any scene supports speed adjustment\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 (maxSpeedLevel > 0) {\n    stateDefs.push({\n      id: \"scene_speed\",\n      name: \"Scene Speed\",\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  if (device.diyScenes.length > 0) {\n    stateDefs.push({\n      id: \"diy_scene\",\n      name: \"DIY Scene\",\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(device.diyScenes),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: \"diyScene\",\n      channel: \"scenes\",\n    });\n  }\n\n  if (device.snapshots.length > 0) {\n    stateDefs.push({\n      id: \"snapshot_cloud\",\n      name: \"Cloud Snapshot\",\n      desc: \"Snapshots you saved in the Govee Home app. Selecting one replays that state on the device.\",\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(device.snapshots),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: \"snapshot\",\n      channel: \"snapshots\",\n    });\n  }\n\n  // Local snapshots\n  stateDefs.push({\n    id: \"snapshot_local\",\n    name: \"Local Snapshot\",\n    desc: \"Snapshots saved by this adapter on the ioBroker server. Independent of the Govee Home app.\",\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: \"Save Local Snapshot\",\n    desc: \"Write a name to save the current device state (power, brightness, colour, per-segment colours) as a new local snapshot.\",\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: \"Delete Local Snapshot\",\n    desc: \"Write a local snapshot name to delete it. Does not affect Govee Home app snapshots.\",\n    type: \"string\",\n    role: \"text\",\n    write: true,\n    def: \"\",\n    capabilityType: \"local\",\n    capabilityInstance: \"snapshotDelete\",\n    channel: \"snapshots\",\n  });\n\n  // Diagnostics \u2014 under info/ because it exports ALL device data, not just snapshots\n  stateDefs.push({\n    id: \"diagnostics_export\",\n    name: \"Export Diagnostics\",\n    type: \"boolean\",\n    role: \"button\",\n    write: true,\n    def: false,\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsExport\",\n    channel: \"info\",\n  });\n  stateDefs.push({\n    id: \"diagnostics_result\",\n    name: \"Diagnostics JSON\",\n    type: \"string\",\n    role: \"json\",\n    write: false,\n    def: \"\",\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsResult\",\n    channel: \"info\",\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(\n        (c) => c && typeof c.type === \"string\" && c.type.endsWith(\"on_off\"),\n      );\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) =>\n      controllable.every((m) => m.scenes.some((s) => s.name === name)),\n    );\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"light_scene\",\n        name: \"Light Scene\",\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) =>\n      controllable.every((m) => m.musicLibrary.some((ml) => ml.name === name)),\n    );\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"music_mode\",\n        name: \"Music Mode\",\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.js\";\nimport { applyColorTempQuirk } from \"./device-registry.js\";\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  /** Display name */\n  name: 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;\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  /** Predefined states for select (value \u2192 label) */\n  states?: 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 * 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(\n  capabilities: CloudCapability[],\n): 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 * Default state definitions for LAN-only devices (no Cloud capabilities).\n * All LAN-capable Govee lights support: power, brightness, color, color temperature.\n */\nexport function getDefaultLanStates(): StateDefinition[] {\n  return [\n    {\n      id: \"power\",\n      name: \"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: \"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: \"Color RGB\",\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: \"Color Temperature\",\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 (\n    !cap ||\n    typeof cap.type !== \"string\" ||\n    typeof cap.instance !== \"string\"\n  ) {\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: \"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      // buildDeviceStateDefs from the scenes/snapshots arrays \u2014 skip the\n      // generic stub here so we don't create and immediately delete it.\n      if (\n        cap.instance === \"lightScene\" ||\n        cap.instance === \"diyScene\" ||\n        cap.instance === \"snapshot\"\n      ) {\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: \"Color RGB\",\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 (\n    cap.instance === \"colorTemperatureK\" ||\n    cap.instance.includes(\"colorTem\")\n  ) {\n    const range = cap.parameters?.range;\n    return [\n      {\n        id: \"colorTemperature\",\n        name: \"Color Temperature\",\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 (\n    cap.instance !== \"presetScene\" ||\n    !Array.isArray(cap.parameters?.options)\n  ) {\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 =\n      typeof opt.value === \"object\"\n        ? JSON.stringify(opt.value)\n        : String(opt.value);\n    states[val] = opt.name;\n  }\n\n  return [\n    {\n      id: \"scene\",\n      name: \"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: \"Work Mode\",\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[\n          typeof opt.value === \"object\"\n            ? JSON.stringify(opt.value)\n            : String(opt.value as string | number | boolean)\n        ] = opt.name;\n      }\n    }\n    states.push({\n      id: \"work_mode\",\n      name: \"Work Mode\",\n      type: \"mixed\",\n      role: \"level.mode\",\n      write: true,\n      states: modeStates,\n      def: modeField.options[0]\n        ? String(modeField.options[0].value as string | number)\n        : \"\",\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[\n            typeof opt.value === \"object\"\n              ? JSON.stringify(opt.value)\n              : String(opt.value as string | number | boolean)\n          ] = opt.name;\n        }\n      }\n      states.push({\n        id: \"mode_value\",\n        name: \"Mode Value\",\n        type: \"mixed\",\n        role: \"level\",\n        write: true,\n        states: valStates,\n        def: valueField.options[0]\n          ? String(valueField.options[0].value as string | number)\n          : \"\",\n        capabilityType: cap.type,\n        capabilityInstance: cap.instance,\n      });\n    } else if (valueField.range) {\n      states.push({\n        id: \"mode_value\",\n        name: \"Mode Value\",\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: \"Target Temperature\",\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: \"Target Temperature\",\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: \"Target Temperature\",\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(\n    (f) => f && typeof f.fieldName === \"string\" && f.fieldName === \"musicMode\",\n  );\n  if (\n    modeField?.options &&\n    Array.isArray(modeField.options) &&\n    modeField.options.length > 0\n  ) {\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[\n        typeof opt.value === \"object\"\n          ? JSON.stringify(opt.value)\n          : String(opt.value as string | number | boolean)\n      ] = opt.name;\n    }\n    states.push({\n      id: \"music_mode\",\n      name: \"Music Mode\",\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(\n    (f) =>\n      f && typeof f.fieldName === \"string\" && f.fieldName === \"sensitivity\",\n  );\n  if (sensField?.range) {\n    states.push({\n      id: \"music_sensitivity\",\n      name: \"Music Sensitivity\",\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(\n    (f) => f && typeof f.fieldName === \"string\" && f.fieldName === \"autoColor\",\n  );\n  if (autoColorField) {\n    states.push({\n      id: \"music_auto_color\",\n      name: \"Music Auto Color\",\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(\n  sku: string,\n  states: StateDefinition[],\n): StateDefinition[] {\n  for (const state of states) {\n    if (\n      state.id === \"colorTemperature\" &&\n      state.min != null &&\n      state.max != null\n    ) {\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  return str\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/_/g, \" \")\n    .replace(/^\\w/, (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(\n  cap: CloudStateCapability,\n): CloudStateValue | null {\n  if (\n    !cap ||\n    typeof cap.type !== \"string\" ||\n    typeof cap.instance !== \"string\"\n  ) {\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:\n            typeof raw === \"object\" || typeof raw === \"function\"\n              ? JSON.stringify(raw)\n              : String(raw as string | number | boolean | bigint),\n        };\n      }\n      return null;\n\n    case \"dynamic_scene\":\n      return {\n        stateId: sanitizeId(cap.instance),\n        value:\n          typeof raw === \"object\" || typeof raw === \"function\"\n            ? JSON.stringify(raw)\n            : String(raw as string | number | boolean | bigint),\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 =\n          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: Set<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 * Build complete state definitions for a device.\n * Combines LAN defaults, Cloud capabilities, quirks, scenes, snapshots, and diagnostics.\n * For groups: computes capability intersection of member devices (no snapshots/diagnostics).\n *\n * @param device Govee device with capabilities, scenes, etc.\n * @param localSnapshots Optional local snapshot names\n * @param memberDevices Resolved member devices (only for BaseGroup)\n */\nexport function buildDeviceStateDefs(\n  device: GoveeDevice,\n  localSnapshots?: { name: string }[],\n  memberDevices?: GoveeDevice[],\n): StateDefinition[] {\n  if (device.sku === \"BaseGroup\") {\n    return buildGroupStateDefs(memberDevices || []);\n  }\n  let stateDefs: StateDefinition[];\n\n  if (device.lanIp) {\n    stateDefs = getDefaultLanStates();\n    if (device.capabilities.length > 0) {\n      const lanIds = new Set(stateDefs.map((d) => d.id));\n      const cloudDefs = mapCapabilities(device.capabilities);\n      for (const cd of cloudDefs) {\n        if (!lanIds.has(cd.id)) {\n          stateDefs.push(cd);\n        }\n      }\n    }\n  } else {\n    stateDefs = mapCapabilities(device.capabilities);\n  }\n\n  applyQuirksToStates(device.sku, stateDefs);\n\n  // Light-only state defs \u2014 scenes / snapshots / music / scene_speed only\n  // 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  if (isLight && device.scenes.length > 0) {\n    stateDefs.push({\n      id: \"light_scene\",\n      name: \"Light Scene\",\n      // mixed lets users write the index (\"1\"), the index as number (1),\n      // or the scene 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(device.scenes),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: \"lightScene\",\n      channel: \"scenes\",\n    });\n  }\n\n  // Scene speed slider \u2014 only if any scene supports speed adjustment\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: \"Scene Speed\",\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  if (isLight && device.diyScenes.length > 0) {\n    stateDefs.push({\n      id: \"diy_scene\",\n      name: \"DIY Scene\",\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(device.diyScenes),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: \"diyScene\",\n      channel: \"scenes\",\n    });\n  }\n\n  if (isLight && device.snapshots.length > 0) {\n    stateDefs.push({\n      id: \"snapshot_cloud\",\n      name: \"Cloud Snapshot\",\n      desc: \"Snapshots you saved in the Govee Home app. Selecting one replays that state on the device.\",\n      type: \"mixed\",\n      role: \"text\",\n      write: true,\n      states: buildUniqueLabelMap(device.snapshots),\n      def: \"0\",\n      capabilityType: \"devices.capabilities.dynamic_scene\",\n      capabilityInstance: \"snapshot\",\n      channel: \"snapshots\",\n    });\n  }\n\n  // Local snapshots \u2014 light-only feature (capture+restore RGB/segments;\n  // makes no sense for thermometer/heater/kettle).\n  if (isLight) {\n    stateDefs.push({\n      id: \"snapshot_local\",\n      name: \"Local Snapshot\",\n      desc: \"Snapshots saved by this adapter on the ioBroker server. Independent of the Govee Home app.\",\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: \"Save Local Snapshot\",\n      desc: \"Write a name to save the current device state (power, brightness, colour, per-segment colours) as a new local snapshot.\",\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: \"Delete Local Snapshot\",\n      desc: \"Write a local snapshot name to delete it. Does not affect Govee Home app snapshots.\",\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 under info/ because it exports ALL device data, not just snapshots\n  stateDefs.push({\n    id: \"diagnostics_export\",\n    name: \"Export Diagnostics\",\n    type: \"boolean\",\n    role: \"button\",\n    write: true,\n    def: false,\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsExport\",\n    channel: \"info\",\n  });\n  stateDefs.push({\n    id: \"diagnostics_result\",\n    name: \"Diagnostics JSON\",\n    type: \"string\",\n    role: \"json\",\n    write: false,\n    def: \"\",\n    capabilityType: \"local\",\n    capabilityInstance: \"diagnosticsResult\",\n    channel: \"info\",\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(\n        (c) => c && typeof c.type === \"string\" && c.type.endsWith(\"on_off\"),\n      );\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) =>\n      controllable.every((m) => m.scenes.some((s) => s.name === name)),\n    );\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"light_scene\",\n        name: \"Light Scene\",\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) =>\n      controllable.every((m) => m.musicLibrary.some((ml) => ml.name === name)),\n    );\n    if (commonNames.length > 0) {\n      stateDefs.push({\n        id: \"music_mode\",\n        name: \"Music Mode\",\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

@@ -121,6 +121,8 @@ class DeviceManager {
   devices = /* @__PURE__ */ new Map();
   commandRouter;
   diagnostics;
+  /** SKUs we already nudged about — log only once per adapter lifetime, per SKU. */
+  nudgedSeedSkus = /* @__PURE__ */ new Set();
   cloudClient = null;
   apiClient = null;
   skuCache = null;
@@ -403,6 +405,7 @@ class DeviceManager {
         this.devices.set(this.deviceKey(cd.sku, cd.device), device);
         changed = true;
         this.log.debug(`Cloud: New device ${cd.deviceName} (${cd.sku})`);
+        this.maybeNudgeSeedSku(cd.sku, cd.deviceName);
       }
       const quirks = (0, import_device_registry.getDeviceQuirks)(cd.sku);
       if (quirks == null ? void 0 : quirks.brokenPlatformApi) {
@@ -727,9 +730,33 @@ class DeviceManager {
       };
       this.devices.set(this.deviceKey(lanDevice.sku, lanDevice.device), device);
       this.log.debug(`LAN: New device ${lanDevice.sku} at ${lanDevice.ip}`);
+      this.maybeNudgeSeedSku(lanDevice.sku, device.name);
       (_b = this.onDeviceListChanged) == null ? void 0 : _b.call(this, this.getDevices());
     }
   }
+  /**
+   * If the SKU is recognised as `seed` in `devices.json` and the user
+   * hasn't enabled the experimental toggle, log an info-level nudge
+   * pointing at the adapter config — but only once per adapter lifetime
+   * per SKU, so it doesn't spam the log when the device reconnects.
+   *
+   * @param sku Govee SKU
+   * @param displayName Device name as shown in Govee Home
+   */
+  maybeNudgeSeedSku(sku, displayName) {
+    const upper = (typeof sku === "string" ? sku : "").toUpperCase();
+    if (!upper || this.nudgedSeedSkus.has(upper)) {
+      return;
+    }
+    if (!(0, import_device_registry.isSeedAndDormant)(upper)) {
+      return;
+    }
+    this.nudgedSeedSkus.add(upper);
+    const label = displayName ? `${displayName} (${upper})` : upper;
+    this.log.info(
+      `Device ${label} is marked experimental and not yet confirmed by a tester. The adapter handles it generically; per-SKU corrections are gated behind the adapter-config switch "Experimentelle Ger\xE4te-Unterst\xFCtzung aktivieren".`
+    );
+  }
   /**
    * Handle MQTT status update — update device state.
    *