iobroker.govee-smart 2.3.1 → 2.4.1

package/README.md

@@ -124,6 +124,14 @@ This adapter's MQTT authentication and BLE-over-LAN (ptReal) protocol implementa
 ---
 
 ## Changelog
+### 2.4.1 (2026-05-04)
+
+- Group-Fan-Out-Pfad (Mitglieder-Steuerung beim Schalten der Gruppe) ist jetzt eine eigene Klasse mit Host-Interface — `main.ts` nochmal kleiner. Verhalten identisch.
+
+### 2.4.0 (2026-05-04)
+
+- Lokaler Snapshot-Manager (Save/Restore/Delete) ist jetzt eine eigene Klasse mit Host-Interface — `main.ts` ist kleiner und der Snapshot-Pfad ist isoliert testbar. Verhalten identisch.
+
 ### 2.3.1 (2026-05-04)
 
 - Smoke-Tests für GoveeCloudClient + GoveeMqttClient — Initial-State-Checks für getFailureReason, token, connected, plus Setter-Smoke-Tests (637 → 637+9 Tests). Volle Pfade über https/mqtt-Mocks kommen separat.
@@ -141,18 +149,6 @@ This adapter's MQTT authentication and BLE-over-LAN (ptReal) protocol implementa
 - Memory-Leaks beim Device-Remove geschlossen — Diagnostics-Buffer und State-Tree werden gemeinsam aufgeräumt wenn ein Gerät aus dem Govee-Account verschwindet.
 - Kein WARN-Spam mehr für Group-State `info.membersUnreachable`. Plus XOR-Validierung für MQTT-BLE-Pakete, type-Guards an allen API-Boundaries, `tier: 2`.
 
-### 2.1.4 (2026-05-03)
-
-- Online status correct again after adapter restart — lights flip to online with the first LAN scan, sensors with the first cloud poll (5 s after start instead of 2 minutes).
-
-### 2.1.3 (2026-05-03)
-
-- Critical fix: no more restart-loop after entering the verification code. The cached login is now stored in a state, not in the adapter config — saving the config doesn't trigger a restart anymore.
-- Saving email + password in the adapter config works again. The previous loop made it look like only the "Test login" button worked.
-- Honest startup messages: when MQTT really doesn't connect within the first minute, the log says why ("login rejected", "verification needed", etc.) instead of "still pending".
-- Verification warning shortened. The full step-by-step instructions live in the Wiki, the log only states the action.
-- "MQTT connected to AWS IoT" → "MQTT connected". "OpenAPI MQTT" → "Cloud-events" in user-facing logs.
-
 Older entries are in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
 
 ## Support

package/build/lib/group-fanout.js

@@ -0,0 +1,136 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var group_fanout_exports = {};
+__export(group_fanout_exports, {
+  GroupFanoutHandler: () => GroupFanoutHandler
+});
+module.exports = __toCommonJS(group_fanout_exports);
+var import_types = require("./types");
+class GroupFanoutHandler {
+  /**
+   * @param host Adapter dependencies via Host-Interface
+   */
+  constructor(host) {
+    this.host = host;
+  }
+  /**
+   * Fan out a group command to all online member devices.
+   * Basic controls (power/brightness/color) gehen direkt durch.
+   * Scenes/music werden Name-basiert gemappt.
+   *
+   * @param group BaseGroup-Device
+   * @param stateSuffix State-Suffix (z.B. "control.power" oder "scenes.light_scene")
+   * @param value Command-Value
+   */
+  async fanOut(group, stateSuffix, value) {
+    if (!group.groupMembers) {
+      return;
+    }
+    const devices = this.host.getDevices();
+    const members = this.resolveMembers(group, devices).filter((d) => d.state.online);
+    if (members.length === 0) {
+      this.host.log.debug(`Group "${group.name}": no reachable members for fan-out`);
+      return;
+    }
+    const command = this.host.stateToCommand(stateSuffix);
+    if (!command) {
+      return;
+    }
+    if ((command === "lightScene" || command === "music") && (value === "0" || value === 0)) {
+      return;
+    }
+    for (const member of members) {
+      try {
+        if (command === "lightScene") {
+          await this.fanOutScene(group, member, value);
+        } else if (command === "music") {
+          await this.fanOutMusic(group, member, stateSuffix, value);
+        } else {
+          await this.host.sendCommand(member, command, value);
+        }
+      } catch (err) {
+        this.host.log.debug(`Group fan-out to ${member.name}: ${(0, import_types.errMessage)(err)}`);
+      }
+    }
+  }
+  /**
+   * Resolve group member references to actual device objects.
+   *
+   * @param group BaseGroup device with groupMembers
+   * @param devices Full device list to search
+   */
+  resolveMembers(group, devices) {
+    if (!group.groupMembers) {
+      return [];
+    }
+    return group.groupMembers.map((m) => devices.find((d) => d.sku === m.sku && d.deviceId === m.deviceId)).filter((d) => d !== void 0);
+  }
+  /**
+   * Fan out a scene command: match group scene name → member scene index.
+   *
+   * @param group BaseGroup device
+   * @param member Target member device
+   * @param value Dropdown index value
+   */
+  async fanOutScene(group, member, value) {
+    var _a;
+    const groupPrefix = this.host.devicePrefix(group);
+    const obj = await this.host.getObject(`${this.host.namespace}.${groupPrefix}.scenes.light_scene`);
+    const groupStates = (_a = obj == null ? void 0 : obj.common) == null ? void 0 : _a.states;
+    const sceneName = groupStates == null ? void 0 : groupStates[String(value)];
+    if (!sceneName) {
+      return;
+    }
+    const memberIdx = member.scenes.findIndex((s) => s.name === sceneName);
+    if (memberIdx >= 0) {
+      await this.host.sendCommand(member, "lightScene", memberIdx + 1);
+    }
+  }
+  /**
+   * Fan out a music command: match group music name → member music index.
+   *
+   * @param group BaseGroup device
+   * @param member Target member device
+   * @param stateSuffix Music-state-suffix
+   * @param value Command value
+   */
+  async fanOutMusic(group, member, stateSuffix, value) {
+    var _a;
+    if (stateSuffix !== "music.music_mode") {
+      await this.host.sendMusicCommand(member, this.host.devicePrefix(member), stateSuffix, value);
+      return;
+    }
+    const groupPrefix = this.host.devicePrefix(group);
+    const obj = await this.host.getObject(`${this.host.namespace}.${groupPrefix}.music.music_mode`);
+    const groupStates = (_a = obj == null ? void 0 : obj.common) == null ? void 0 : _a.states;
+    const musicName = groupStates == null ? void 0 : groupStates[String(value)];
+    if (!musicName) {
+      return;
+    }
+    const memberIdx = member.musicLibrary.findIndex((m) => m.name === musicName);
+    if (memberIdx >= 0) {
+      await this.host.sendMusicCommand(member, this.host.devicePrefix(member), "music.music_mode", memberIdx + 1);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GroupFanoutHandler
+});
+//# sourceMappingURL=group-fanout.js.map

package/build/lib/group-fanout.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/group-fanout.ts"],
+  "sourcesContent": ["import { errMessage, type GoveeDevice } from \"./types\";\n\n/**\n * Host-Interface f\u00FCr GroupFanoutHandler \u2014 die Adapter-Funktionen die der\n * Handler braucht ohne von der Adapter-Klasse direkt zu h\u00E4ngen.\n *\n * Pattern analog `WizardHost` und `SnapshotHandlerHost`. main.ts bleibt\n * schlank, der Group-Fan-Out-Pfad ist isoliert testbar.\n */\nexport interface GroupFanoutHost {\n  /** Adapter logger. */\n  log: ioBroker.Logger;\n  /** Adapter-namespace prefix (z.B. \"govee-smart.0\"). */\n  namespace: string;\n  /** Device-Liste \u2014 typisch DeviceManager.getDevices(). */\n  getDevices: () => GoveeDevice[];\n  /** Send-command via LAN\u2192Cloud-Routing (DeviceManager.sendCommand). */\n  sendCommand: (device: GoveeDevice, command: string, value: unknown) => Promise<void>;\n  /** Resolved object-prefix f\u00FCr ein Ger\u00E4t. */\n  devicePrefix: (device: GoveeDevice) => string;\n  /** State-Suffix \u2192 Command-Name lookup (main.ts STATE_TO_COMMAND-Map). */\n  stateToCommand: (stateSuffix: string) => string | undefined;\n  /** Get-object \u2014 f\u00FCr common.states-Lookup beim scene/music Mapping. */\n  getObject: (id: string) => Promise<ioBroker.Object | null | undefined>;\n  /** Music-Command-Sender (kapselt die music_mode/sensitivity/auto_color STRUCT). */\n  sendMusicCommand: (\n    device: GoveeDevice,\n    devicePrefix: string,\n    stateSuffix: string,\n    value: ioBroker.StateValue,\n  ) => Promise<void>;\n}\n\n/**\n * Group fan-out handler \u2014 dispatcht Group-Commands an die einzelnen\n * Mitglieder mit Capability-Match. Vorher in main.ts als 4 private\n * Methoden mit ~100 Zeilen.\n *\n * Die scene/music-Spezial-Pfade matchen den Group-Dropdown-Namen gegen\n * den Member-Dropdown-Namen \u2014 nicht 1:1-Indizes, weil die Member\n * verschiedene Scene-Listen haben k\u00F6nnen.\n */\nexport class GroupFanoutHandler {\n  /**\n   * @param host Adapter dependencies via Host-Interface\n   */\n  constructor(private readonly host: GroupFanoutHost) {}\n\n  /**\n   * Fan out a group command to all online member devices.\n   * Basic controls (power/brightness/color) gehen direkt durch.\n   * Scenes/music werden Name-basiert gemappt.\n   *\n   * @param group BaseGroup-Device\n   * @param stateSuffix State-Suffix (z.B. \"control.power\" oder \"scenes.light_scene\")\n   * @param value Command-Value\n   */\n  async fanOut(group: GoveeDevice, stateSuffix: string, value: ioBroker.StateValue): Promise<void> {\n    if (!group.groupMembers) {\n      return;\n    }\n    const devices = this.host.getDevices();\n    const members = this.resolveMembers(group, devices).filter(d => d.state.online);\n    if (members.length === 0) {\n      this.host.log.debug(`Group \"${group.name}\": no reachable members for fan-out`);\n      return;\n    }\n    const command = this.host.stateToCommand(stateSuffix);\n    if (!command) {\n      return;\n    }\n    // Dropdown-Reset \u2014 kein Command n\u00F6tig\n    if ((command === \"lightScene\" || command === \"music\") && (value === \"0\" || value === 0)) {\n      return;\n    }\n    for (const member of members) {\n      try {\n        if (command === \"lightScene\") {\n          await this.fanOutScene(group, member, value);\n        } else if (command === \"music\") {\n          await this.fanOutMusic(group, member, stateSuffix, value);\n        } else {\n          await this.host.sendCommand(member, command, value);\n        }\n      } catch (err) {\n        this.host.log.debug(`Group fan-out to ${member.name}: ${errMessage(err)}`);\n      }\n    }\n  }\n\n  /**\n   * Resolve group member references to actual device objects.\n   *\n   * @param group BaseGroup device with groupMembers\n   * @param devices Full device list to search\n   */\n  resolveMembers(group: GoveeDevice, devices: GoveeDevice[]): GoveeDevice[] {\n    if (!group.groupMembers) {\n      return [];\n    }\n    return group.groupMembers\n      .map(m => devices.find(d => d.sku === m.sku && d.deviceId === m.deviceId))\n      .filter((d): d is GoveeDevice => d !== undefined);\n  }\n\n  /**\n   * Fan out a scene command: match group scene name \u2192 member scene index.\n   *\n   * @param group BaseGroup device\n   * @param member Target member device\n   * @param value Dropdown index value\n   */\n  private async fanOutScene(group: GoveeDevice, member: GoveeDevice, value: ioBroker.StateValue): Promise<void> {\n    const groupPrefix = this.host.devicePrefix(group);\n    const obj = await this.host.getObject(`${this.host.namespace}.${groupPrefix}.scenes.light_scene`);\n    const groupStates = obj?.common?.states as Record<string, string> | undefined;\n    const sceneName = groupStates?.[String(value)];\n    if (!sceneName) {\n      return;\n    }\n    const memberIdx = member.scenes.findIndex(s => s.name === sceneName);\n    if (memberIdx >= 0) {\n      await this.host.sendCommand(member, \"lightScene\", memberIdx + 1);\n    }\n  }\n\n  /**\n   * Fan out a music command: match group music name \u2192 member music index.\n   *\n   * @param group BaseGroup device\n   * @param member Target member device\n   * @param stateSuffix Music-state-suffix\n   * @param value Command value\n   */\n  private async fanOutMusic(\n    group: GoveeDevice,\n    member: GoveeDevice,\n    stateSuffix: string,\n    value: ioBroker.StateValue,\n  ): Promise<void> {\n    // Sensitivity/auto_color werden direkt forwarded\n    if (stateSuffix !== \"music.music_mode\") {\n      await this.host.sendMusicCommand(member, this.host.devicePrefix(member), stateSuffix, value);\n      return;\n    }\n    const groupPrefix = this.host.devicePrefix(group);\n    const obj = await this.host.getObject(`${this.host.namespace}.${groupPrefix}.music.music_mode`);\n    const groupStates = obj?.common?.states as Record<string, string> | undefined;\n    const musicName = groupStates?.[String(value)];\n    if (!musicName) {\n      return;\n    }\n    const memberIdx = member.musicLibrary.findIndex(m => m.name === musicName);\n    if (memberIdx >= 0) {\n      await this.host.sendMusicCommand(member, this.host.devicePrefix(member), \"music.music_mode\", memberIdx + 1);\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/lib/snapshot-handler.js

@@ -0,0 +1,132 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var snapshot_handler_exports = {};
+__export(snapshot_handler_exports, {
+  SnapshotHandler: () => SnapshotHandler
+});
+module.exports = __toCommonJS(snapshot_handler_exports);
+class SnapshotHandler {
+  /**
+   * @param host Adapter dependencies via Host-Interface (testbar via Mocks)
+   */
+  constructor(host) {
+    this.host = host;
+  }
+  /**
+   * Save current device state as a local snapshot.
+   *
+   * @param device Target device
+   * @param name Snapshot name
+   */
+  async save(device, name) {
+    var _a;
+    const prefix = this.host.devicePrefix(device);
+    const ns = this.host.namespace;
+    const [powerState, brightState, colorState, ctState] = await Promise.all([
+      this.host.getState(`${ns}.${prefix}.control.power`),
+      this.host.getState(`${ns}.${prefix}.control.brightness`),
+      this.host.getState(`${ns}.${prefix}.control.colorRgb`),
+      this.host.getState(`${ns}.${prefix}.control.colorTemperature`)
+    ]);
+    let segments;
+    const segCount = (_a = device.segmentCount) != null ? _a : 0;
+    if (segCount > 0) {
+      const segReads = [];
+      for (let i = 0; i < segCount; i++) {
+        segReads.push(
+          Promise.all([
+            this.host.getState(`${ns}.${prefix}.segments.${i}.color`),
+            this.host.getState(`${ns}.${prefix}.segments.${i}.brightness`)
+          ])
+        );
+      }
+      const segResults = await Promise.all(segReads);
+      segments = segResults.map(([segColor, segBright]) => ({
+        color: typeof (segColor == null ? void 0 : segColor.val) === "string" ? segColor.val : "#000000",
+        brightness: typeof (segBright == null ? void 0 : segBright.val) === "number" ? segBright.val : 100
+      }));
+    }
+    const snapshot = {
+      name,
+      power: (powerState == null ? void 0 : powerState.val) === true,
+      brightness: typeof (brightState == null ? void 0 : brightState.val) === "number" ? brightState.val : 0,
+      colorRgb: typeof (colorState == null ? void 0 : colorState.val) === "string" ? colorState.val : "#000000",
+      colorTemperature: typeof (ctState == null ? void 0 : ctState.val) === "number" ? ctState.val : 0,
+      segments,
+      savedAt: Date.now()
+    };
+    this.host.store.saveSnapshot(device.sku, device.deviceId, snapshot);
+    this.host.log.info(`Local snapshot saved: "${name}" for ${device.name}`);
+    this.host.refreshDeviceStates(device);
+  }
+  /**
+   * Restore a local snapshot by index.
+   *
+   * @param device Target device
+   * @param val Dropdown index value
+   */
+  async restore(device, val) {
+    const idx = parseInt(String(val), 10);
+    if (idx < 1) {
+      return;
+    }
+    const snaps = this.host.store.getSnapshots(device.sku, device.deviceId);
+    const snap = snaps[idx - 1];
+    if (!snap) {
+      this.host.log.warn(`Local snapshot index ${idx} not found for ${device.name}`);
+      return;
+    }
+    this.host.log.info(`Restoring local snapshot "${snap.name}" for ${device.name}`);
+    await this.host.sendCommand(device, "power", snap.power);
+    if (snap.power) {
+      await this.host.sendCommand(device, "brightness", snap.brightness);
+      if (snap.colorTemperature > 0) {
+        await this.host.sendCommand(device, "colorTemperature", snap.colorTemperature);
+      } else {
+        await this.host.sendCommand(device, "colorRgb", snap.colorRgb);
+      }
+      if (snap.segments && snap.segments.length > 0) {
+        for (let i = 0; i < snap.segments.length; i++) {
+          const seg = snap.segments[i];
+          await this.host.sendCommand(device, `segmentColor:${i}`, seg.color);
+          await this.host.sendCommand(device, `segmentBrightness:${i}`, seg.brightness);
+        }
+      }
+    }
+  }
+  /**
+   * Delete a local snapshot by name.
+   *
+   * @param device Target device
+   * @param name Snapshot name to delete
+   */
+  delete(device, name) {
+    if (this.host.store.deleteSnapshot(device.sku, device.deviceId, name)) {
+      this.host.log.info(`Local snapshot deleted: "${name}" for ${device.name}`);
+      this.host.refreshDeviceStates(device);
+    } else {
+      this.host.log.warn(`Local snapshot "${name}" not found for ${device.name}`);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SnapshotHandler
+});
+//# sourceMappingURL=snapshot-handler.js.map

package/build/lib/snapshot-handler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/snapshot-handler.ts"],
+  "sourcesContent": ["import type { LocalSnapshot, LocalSnapshotStore, SnapshotSegment } from \"./local-snapshots\";\nimport type { GoveeDevice } from \"./types\";\n\n/**\n * Host-Interface \u2014 die Adapter-Funktionen die der SnapshotHandler braucht\n * ohne von der Adapter-Klasse direkt zu h\u00E4ngen.\n *\n * Pattern analog `WizardHost` in segment-wizard.ts. Vorteil: testbar mit\n * Mocks, dependencies-flow ist explizit.\n */\nexport interface SnapshotHandlerHost {\n  /** Adapter logger. */\n  log: ioBroker.Logger;\n  /** Local snapshot persistence (file-based JSON store). */\n  store: LocalSnapshotStore;\n  /** Adapter-namespace prefix (z.B. \"govee-smart.0\"). */\n  namespace: string;\n  /** Resolved object-prefix f\u00FCr ein Ger\u00E4t (z.B. \"devices.h61be_525f\"). */\n  devicePrefix: (device: GoveeDevice) => string;\n  /** State-read (volles ID `<namespace>.<prefix>.<channel>.<state>`). */\n  getState: (id: string) => Promise<ioBroker.State | null | undefined>;\n  /** Send-command via LAN\u2192Cloud-Routing (DeviceManager.sendCommand). */\n  sendCommand: (device: GoveeDevice, command: string, value: unknown) => Promise<void>;\n  /** Targeted state-tree refresh nach save/delete (snapshot_local Dropdown). */\n  refreshDeviceStates: (device: GoveeDevice) => void;\n}\n\n/**\n * Lokaler Snapshot-Manager \u2014 kapselt save/restore/delete f\u00FCr die\n * snapshot_save / snapshot_local / snapshot_delete Dropdown-States.\n *\n * Vorher in `main.ts` als 3 private Methoden mit ~105 Zeilen. Hier in\n * eigenen Klasse mit Host-Interface \u2014 testbar isoliert, main.ts wird\n * kleiner, Maintainability gesteigert.\n */\nexport class SnapshotHandler {\n  /**\n   * @param host Adapter dependencies via Host-Interface (testbar via Mocks)\n   */\n  constructor(private readonly host: SnapshotHandlerHost) {}\n\n  /**\n   * Save current device state as a local snapshot.\n   *\n   * @param device Target device\n   * @param name Snapshot name\n   */\n  async save(device: GoveeDevice, name: string): Promise<void> {\n    const prefix = this.host.devicePrefix(device);\n    const ns = this.host.namespace;\n\n    // Read device-level state in parallel\n    const [powerState, brightState, colorState, ctState] = await Promise.all([\n      this.host.getState(`${ns}.${prefix}.control.power`),\n      this.host.getState(`${ns}.${prefix}.control.brightness`),\n      this.host.getState(`${ns}.${prefix}.control.colorRgb`),\n      this.host.getState(`${ns}.${prefix}.control.colorTemperature`),\n    ]);\n\n    // Read per-segment states in parallel \u2014 sequenziell w\u00E4ren 20\u00D72 reads\n    // ~80 ms; parallel = single round-trip.\n    let segments: SnapshotSegment[] | undefined;\n    const segCount = device.segmentCount ?? 0;\n    if (segCount > 0) {\n      const segReads: Promise<[ioBroker.State | null | undefined, ioBroker.State | null | undefined]>[] = [];\n      for (let i = 0; i < segCount; i++) {\n        segReads.push(\n          Promise.all([\n            this.host.getState(`${ns}.${prefix}.segments.${i}.color`),\n            this.host.getState(`${ns}.${prefix}.segments.${i}.brightness`),\n          ]),\n        );\n      }\n      const segResults = await Promise.all(segReads);\n      segments = segResults.map(([segColor, segBright]) => ({\n        color: typeof segColor?.val === \"string\" ? segColor.val : \"#000000\",\n        brightness: typeof segBright?.val === \"number\" ? segBright.val : 100,\n      }));\n    }\n\n    const snapshot: LocalSnapshot = {\n      name,\n      power: powerState?.val === true,\n      brightness: typeof brightState?.val === \"number\" ? brightState.val : 0,\n      colorRgb: typeof colorState?.val === \"string\" ? colorState.val : \"#000000\",\n      colorTemperature: typeof ctState?.val === \"number\" ? ctState.val : 0,\n      segments,\n      savedAt: Date.now(),\n    };\n\n    this.host.store.saveSnapshot(device.sku, device.deviceId, snapshot);\n    this.host.log.info(`Local snapshot saved: \"${name}\" for ${device.name}`);\n    // Targeted refresh \u2014 only this device's snapshot_local dropdown changed.\n    this.host.refreshDeviceStates(device);\n  }\n\n  /**\n   * Restore a local snapshot by index.\n   *\n   * @param device Target device\n   * @param val Dropdown index value\n   */\n  async restore(device: GoveeDevice, val: ioBroker.StateValue): Promise<void> {\n    const idx = parseInt(String(val), 10);\n    if (idx < 1) {\n      return;\n    }\n    const snaps = this.host.store.getSnapshots(device.sku, device.deviceId);\n    const snap = snaps[idx - 1];\n    if (!snap) {\n      this.host.log.warn(`Local snapshot index ${idx} not found for ${device.name}`);\n      return;\n    }\n    this.host.log.info(`Restoring local snapshot \"${snap.name}\" for ${device.name}`);\n\n    // Send each state via LAN \u2192 Cloud routing\n    await this.host.sendCommand(device, \"power\", snap.power);\n    if (snap.power) {\n      await this.host.sendCommand(device, \"brightness\", snap.brightness);\n      if (snap.colorTemperature > 0) {\n        await this.host.sendCommand(device, \"colorTemperature\", snap.colorTemperature);\n      } else {\n        await this.host.sendCommand(device, \"colorRgb\", snap.colorRgb);\n      }\n      // Restore per-segment states via ptReal\n      if (snap.segments && snap.segments.length > 0) {\n        for (let i = 0; i < snap.segments.length; i++) {\n          const seg = snap.segments[i];\n          await this.host.sendCommand(device, `segmentColor:${i}`, seg.color);\n          await this.host.sendCommand(device, `segmentBrightness:${i}`, seg.brightness);\n        }\n      }\n    }\n  }\n\n  /**\n   * Delete a local snapshot by name.\n   *\n   * @param device Target device\n   * @param name Snapshot name to delete\n   */\n  delete(device: GoveeDevice, name: string): void {\n    if (this.host.store.deleteSnapshot(device.sku, device.deviceId, name)) {\n      this.host.log.info(`Local snapshot deleted: \"${name}\" for ${device.name}`);\n      // Targeted refresh \u2014 only this device's snapshot_local dropdown changed.\n      this.host.refreshDeviceStates(device);\n    } else {\n      this.host.log.warn(`Local snapshot \"${name}\" not found for ${device.name}`);\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/main.js

@@ -31,6 +31,8 @@ var import_govee_lan_client = require("./lib/govee-lan-client");
 var import_govee_mqtt_client = require("./lib/govee-mqtt-client");
 var import_govee_openapi_mqtt_client = require("./lib/govee-openapi-mqtt-client");
 var import_local_snapshots = require("./lib/local-snapshots");
+var import_snapshot_handler = require("./lib/snapshot-handler");
+var import_group_fanout = require("./lib/group-fanout");
 var import_cloud_retry = require("./lib/cloud-retry");
 var import_rate_limiter = require("./lib/rate-limiter");
 var import_segment_wizard = require("./lib/segment-wizard");
@@ -101,6 +103,8 @@ class GoveeAdapter extends utils.Adapter {
   // === Sub-Komponenten ===
   skuCache = null;
   localSnapshots = null;
+  snapshotHandler = null;
+  groupFanout = null;
   stateCreationQueue = [];
   lanScanTimer;
   cleanupTimer;
@@ -183,6 +187,8 @@ class GoveeAdapter extends utils.Adapter {
     });
     this.skuCache = new import_sku_cache.SkuCache(dataDir, this.log);
     this.localSnapshots = new import_local_snapshots.LocalSnapshotStore(dataDir, this.log);
+    this.snapshotHandler = new import_snapshot_handler.SnapshotHandler(this.buildSnapshotHost());
+    this.groupFanout = new import_group_fanout.GroupFanoutHandler(this.buildGroupFanoutHost());
     this.deviceManager.setSkuCache(this.skuCache);
     const apiClient = new import_govee_api_client.GoveeApiClient();
     apiClient.setEmail(config.goveeEmail);
@@ -589,7 +595,7 @@ class GoveeAdapter extends utils.Adapter {
     }
     const val = resolved.val;
     if (device.sku === "BaseGroup" && device.groupMembers) {
-      await this.handleGroupFanOut(device, stateSuffix, val);
+      await this.groupFanout.fanOut(device, stateSuffix, val);
       await this.setStateAsync(id, { val, ack: true });
       if (stateSuffix === "scenes.light_scene" || stateSuffix === "music.music_mode") {
         await this.resetRelatedDropdowns(prefix, stateSuffix === "scenes.light_scene" ? "lightScene" : "music");
@@ -597,20 +603,20 @@ class GoveeAdapter extends utils.Adapter {
       return;
     }
     if (stateSuffix === "snapshots.snapshot_save" && typeof val === "string" && val.trim()) {
-      await this.handleSnapshotSave(device, val.trim());
+      await this.snapshotHandler.save(device, val.trim());
       await this.setStateAsync(id, { val: "", ack: true });
       return;
     }
     if (stateSuffix === "snapshots.snapshot_local") {
       if (val !== "0" && val !== 0) {
-        await this.handleSnapshotRestore(device, val);
+        await this.snapshotHandler.restore(device, val);
         await this.resetRelatedDropdowns(prefix, "snapshotLocal");
       }
       await this.setStateAsync(id, { val, ack: true });
       return;
     }
     if (stateSuffix === "snapshots.snapshot_delete" && typeof val === "string" && val.trim()) {
-      this.handleSnapshotDelete(device, val.trim());
+      this.snapshotHandler.delete(device, val.trim());
       await this.setStateAsync(id, { val: "", ack: true });
       return;
     }
@@ -776,93 +782,35 @@ class GoveeAdapter extends utils.Adapter {
    * @param stateSuffix State path suffix (e.g. "control.power")
    * @param value Command value
    */
-  async handleGroupFanOut(group, stateSuffix, value) {
-    if (!this.deviceManager || !group.groupMembers) {
-      return;
-    }
-    const devices = this.deviceManager.getDevices();
-    const members = this.resolveGroupMembers(group, devices).filter((d) => d.state.online);
-    if (members.length === 0) {
-      this.log.debug(`Group "${group.name}": no reachable members for fan-out`);
-      return;
-    }
-    const command = this.stateToCommand(stateSuffix);
-    if (!command) {
-      return;
-    }
-    if ((command === "lightScene" || command === "music") && (value === "0" || value === 0)) {
-      return;
-    }
-    for (const member of members) {
-      try {
-        if (command === "lightScene") {
-          await this.fanOutScene(group, member, value);
-        } else if (command === "music") {
-          await this.fanOutMusic(group, member, stateSuffix, value);
-        } else {
-          await this.deviceManager.sendCommand(member, command, value);
-        }
-      } catch (err) {
-        this.log.debug(`Group fan-out to ${member.name}: ${(0, import_types.errMessage)(err)}`);
-      }
-    }
-  }
-  /**
-   * Fan out a scene command: match group scene name to member scene index.
-   *
-   * @param group BaseGroup device
-   * @param member Target member device
-   * @param value Dropdown index value
-   */
-  async fanOutScene(group, member, value) {
-    var _a;
-    if (!this.deviceManager || !this.stateManager) {
-      return;
-    }
-    const groupPrefix = this.stateManager.devicePrefix(group);
-    const obj = await this.getObjectAsync(`${this.namespace}.${groupPrefix}.scenes.light_scene`);
-    const groupStates = (_a = obj == null ? void 0 : obj.common) == null ? void 0 : _a.states;
-    const sceneName = groupStates == null ? void 0 : groupStates[String(value)];
-    if (!sceneName) {
-      return;
-    }
-    const memberIdx = member.scenes.findIndex((s) => s.name === sceneName);
-    if (memberIdx >= 0) {
-      await this.deviceManager.sendCommand(member, "lightScene", memberIdx + 1);
-    }
-  }
-  /**
-   * Fan out a music command: match group music name to member music index.
-   *
-   * @param group BaseGroup device
-   * @param member Target member device
-   * @param stateSuffix Music state path suffix
-   * @param value Command value
-   */
-  async fanOutMusic(group, member, stateSuffix, value) {
-    var _a;
-    if (!this.deviceManager || !this.stateManager) {
-      return;
-    }
-    if (stateSuffix !== "music.music_mode") {
-      await this.sendMusicCommand(member, this.stateManager.devicePrefix(member), stateSuffix, value);
-      return;
-    }
-    const groupPrefix = this.stateManager.devicePrefix(group);
-    const obj = await this.getObjectAsync(`${this.namespace}.${groupPrefix}.music.music_mode`);
-    const groupStates = (_a = obj == null ? void 0 : obj.common) == null ? void 0 : _a.states;
-    const musicName = groupStates == null ? void 0 : groupStates[String(value)];
-    if (!musicName) {
-      return;
-    }
-    const memberIdx = member.musicLibrary.findIndex((m) => m.name === musicName);
-    if (memberIdx >= 0) {
-      const memberPrefix = this.stateManager.devicePrefix(member);
-      await this.sendMusicCommand(member, memberPrefix, "music.music_mode", memberIdx + 1);
-    }
+  /** Construct host object for GroupFanoutHandler. */
+  buildGroupFanoutHost() {
+    return {
+      log: this.log,
+      namespace: this.namespace,
+      getDevices: () => {
+        var _a, _b;
+        return (_b = (_a = this.deviceManager) == null ? void 0 : _a.getDevices()) != null ? _b : [];
+      },
+      sendCommand: async (device, command, value) => {
+        var _a;
+        await ((_a = this.deviceManager) == null ? void 0 : _a.sendCommand(device, command, value));
+      },
+      devicePrefix: (device) => {
+        var _a, _b;
+        return (_b = (_a = this.stateManager) == null ? void 0 : _a.devicePrefix(device)) != null ? _b : "";
+      },
+      stateToCommand: (suffix) => {
+        var _a;
+        return (_a = this.stateToCommand(suffix)) != null ? _a : void 0;
+      },
+      getObject: (id) => this.getObjectAsync(id),
+      sendMusicCommand: (device, devicePrefix, stateSuffix, value) => this.sendMusicCommand(device, devicePrefix, stateSuffix, value)
+    };
   }
   /**
    * Resolve group member references to actual device objects.
+   * Bleibt in main.ts weil `updateGroupReachability` (auch in main.ts) das
+   * direkt nutzt — Helper-Pfad ist von der Fan-Out-Klasse unabhängig.
    *
    * @param group BaseGroup device with groupMembers
    * @param devices Full device list to search
@@ -1649,110 +1597,26 @@ class GoveeAdapter extends utils.Adapter {
     });
     return response;
   }
-  /**
-   * Save current device state as a local snapshot.
-   *
-   * @param device Target device
-   * @param name Snapshot name
-   */
-  async handleSnapshotSave(device, name) {
-    var _a;
-    if (!this.localSnapshots || !this.stateManager) {
-      return;
-    }
-    const prefix = this.stateManager.devicePrefix(device);
-    const ns = this.namespace;
-    const [powerState, brightState, colorState, ctState] = await Promise.all([
-      this.getStateAsync(`${ns}.${prefix}.control.power`),
-      this.getStateAsync(`${ns}.${prefix}.control.brightness`),
-      this.getStateAsync(`${ns}.${prefix}.control.colorRgb`),
-      this.getStateAsync(`${ns}.${prefix}.control.colorTemperature`)
-    ]);
-    let segments;
-    const segCount = (_a = device.segmentCount) != null ? _a : 0;
-    if (segCount > 0) {
-      const segReads = [];
-      for (let i = 0; i < segCount; i++) {
-        segReads.push(
-          Promise.all([
-            this.getStateAsync(`${ns}.${prefix}.segments.${i}.color`),
-            this.getStateAsync(`${ns}.${prefix}.segments.${i}.brightness`)
-          ])
-        );
+  /** Construct host object for SnapshotHandler — adapter dependencies injected. */
+  buildSnapshotHost() {
+    return {
+      log: this.log,
+      store: this.localSnapshots,
+      namespace: this.namespace,
+      devicePrefix: (device) => {
+        var _a, _b;
+        return (_b = (_a = this.stateManager) == null ? void 0 : _a.devicePrefix(device)) != null ? _b : "";
+      },
+      getState: (id) => this.getStateAsync(id),
+      sendCommand: async (device, command, value) => {
+        var _a;
+        await ((_a = this.deviceManager) == null ? void 0 : _a.sendCommand(device, command, value));
+      },
+      refreshDeviceStates: (device) => {
+        var _a, _b;
+        this.refreshDeviceStates(device, (_b = (_a = this.deviceManager) == null ? void 0 : _a.getDevices()) != null ? _b : []);
       }
-      const segResults = await Promise.all(segReads);
-      segments = segResults.map(([segColor, segBright]) => ({
-        color: typeof (segColor == null ? void 0 : segColor.val) === "string" ? segColor.val : "#000000",
-        brightness: typeof (segBright == null ? void 0 : segBright.val) === "number" ? segBright.val : 100
-      }));
-    }
-    const snapshot = {
-      name,
-      power: (powerState == null ? void 0 : powerState.val) === true,
-      brightness: typeof (brightState == null ? void 0 : brightState.val) === "number" ? brightState.val : 0,
-      colorRgb: typeof (colorState == null ? void 0 : colorState.val) === "string" ? colorState.val : "#000000",
-      colorTemperature: typeof (ctState == null ? void 0 : ctState.val) === "number" ? ctState.val : 0,
-      segments,
-      savedAt: Date.now()
     };
-    this.localSnapshots.saveSnapshot(device.sku, device.deviceId, snapshot);
-    this.log.info(`Local snapshot saved: "${name}" for ${device.name}`);
-    this.refreshDeviceStates(device, this.deviceManager.getDevices());
-  }
-  /**
-   * Restore a local snapshot by index.
-   *
-   * @param device Target device
-   * @param val Dropdown index value
-   */
-  async handleSnapshotRestore(device, val) {
-    if (!this.localSnapshots || !this.deviceManager) {
-      return;
-    }
-    const idx = parseInt(String(val), 10);
-    if (idx < 1) {
-      return;
-    }
-    const snaps = this.localSnapshots.getSnapshots(device.sku, device.deviceId);
-    const snap = snaps[idx - 1];
-    if (!snap) {
-      this.log.warn(`Local snapshot index ${idx} not found for ${device.name}`);
-      return;
-    }
-    this.log.info(`Restoring local snapshot "${snap.name}" for ${device.name}`);
-    await this.deviceManager.sendCommand(device, "power", snap.power);
-    if (snap.power) {
-      await this.deviceManager.sendCommand(device, "brightness", snap.brightness);
-      if (snap.colorTemperature > 0) {
-        await this.deviceManager.sendCommand(device, "colorTemperature", snap.colorTemperature);
-      } else {
-        await this.deviceManager.sendCommand(device, "colorRgb", snap.colorRgb);
-      }
-      if (snap.segments && snap.segments.length > 0) {
-        for (let i = 0; i < snap.segments.length; i++) {
-          const seg = snap.segments[i];
-          await this.deviceManager.sendCommand(device, `segmentColor:${i}`, seg.color);
-          await this.deviceManager.sendCommand(device, `segmentBrightness:${i}`, seg.brightness);
-        }
-      }
-    }
-  }
-  /**
-   * Delete a local snapshot by name.
-   *
-   * @param device Target device
-   * @param name Snapshot name to delete
-   */
-  handleSnapshotDelete(device, name) {
-    if (!this.localSnapshots) {
-      return;
-    }
-    if (this.localSnapshots.deleteSnapshot(device.sku, device.deviceId, name)) {
-      this.log.info(`Local snapshot deleted: "${name}" for ${device.name}`);
-      this.refreshDeviceStates(device, this.deviceManager.getDevices());
-    } else {
-      this.log.warn(`Local snapshot "${name}" not found for ${device.name}`);
-    }
   }
   /** Dropdowns whose value is a mode-selection — reset to "---" (0) when the mode stops. */
   static MODE_DROPDOWNS = [