@homebridge-plugins/homebridge-eufy-security 4.6.0-beta.7 → 4.6.0-beta.8

package/.claude/skills/new-device-support/SKILL.md

@@ -96,6 +96,7 @@ case <type_number>: return '<image_large>.png';
 Execute the plan. Key implementation notes:
 
 - **Property mapping**: Use the output from `map-properties.mjs` (Phase 1) as the primary guide. When multiple property constants match the same `param_type` (e.g. `DeviceWatermarkProperty` vs `DeviceWatermarkSoloWiredDoorbellProperty`), pick the variant used by the closest existing device. Check the "Used by DeviceTypes" column in the script output.
+- **Companion custom properties**: Some properties have required companions with `custom_*` keys that never appear in raw device data (they're populated at runtime). The script detects these and marks them with `⚠ companion`. Always include them — omitting a companion breaks functionality silently. Key pairs: `DeviceRTSPStream` → `DeviceRTSPStreamUrl`, `DeviceWifiRSSI` → `DeviceWifiSignalLevel`, `DeviceCellularRSSI` → `DeviceCellularSignalLevel`.
 - **Insert in order**: When adding to enums, switch statements, or `if` chains, maintain numeric ordering by device type number.
 - **Audio recording property**: Different device families use different audio recording property constants (e.g. `DeviceAudioRecordingProperty`, `DeviceAudioRecordingStarlight4gLTEProperty`). Match the closest existing device.
 - **No Co-Authored-By**: Do not add co-author lines to commits.

package/.claude/skills/new-device-support/map-properties.mjs

@@ -298,12 +298,39 @@ if (unmatched.length > 0) {
   }
 }
 
+// ── Step 6: Companion custom properties ─────────────────────────────────────
+// Some param_type-based properties require a companion custom (runtime) property
+// that never appears in raw device data. Define those pairings here so the
+// suggested block always includes both.
+
+const COMPANION_PROPERTIES = new Map([
+  // DeviceRTSPStream (CMD_NAS_SWITCH) → DeviceRTSPStreamUrl (custom_rtspStreamUrl)
+  ["PropertyName.DeviceRTSPStream", {
+    propertyName: "PropertyName.DeviceRTSPStreamUrl",
+    constName: "DeviceRTSPStreamUrlProperty",
+    reason: "RTSP URL is set at runtime by the station — must accompany DeviceRTSPStream",
+  }],
+  // DeviceWifiRSSI → DeviceWifiSignalLevel (custom_wifiSignalLevel)
+  ["PropertyName.DeviceWifiRSSI", {
+    propertyName: "PropertyName.DeviceWifiSignalLevel",
+    constName: "DeviceWifiSignalLevelProperty",
+    reason: "WiFi signal level is derived at runtime from RSSI",
+  }],
+  // DeviceCellularRSSI → DeviceCellularSignalLevel (custom_cellularSignalLevel)
+  ["PropertyName.DeviceCellularRSSI", {
+    propertyName: "PropertyName.DeviceCellularSignalLevel",
+    constName: "DeviceCellularSignalLevelProperty",
+    reason: "Cellular signal level is derived at runtime from RSSI",
+  }],
+]);
+
 // Output a suggested PropertyName list for use in DeviceProperties block
 console.log();
 console.log("=".repeat(80));
 console.log("SUGGESTED DeviceProperties block entries:");
 console.log("=".repeat(80));
 const seen = new Set();
+const companionsAdded = [];
 for (const m of matched) {
   for (let i = 0; i < m.constNames.length; i++) {
     const pn = m.propertyNames[0]; // Use first PropertyName
@@ -311,6 +338,24 @@ for (const m of matched) {
     if (pn && !seen.has(pn)) {
       seen.add(pn);
       console.log(`  [${pn}]: ${cn},`);
+
+      // Check if this property has a required companion
+      const companion = COMPANION_PROPERTIES.get(pn);
+      if (companion && !seen.has(companion.propertyName)) {
+        seen.add(companion.propertyName);
+        console.log(`  [${companion.propertyName}]: ${companion.constName},  // ⚠ companion (custom/runtime)`);
+        companionsAdded.push(companion);
+      }
     }
   }
 }
+
+if (companionsAdded.length > 0) {
+  console.log();
+  console.log("=".repeat(80));
+  console.log("⚠  COMPANION PROPERTIES (custom/runtime — not in raw device data):");
+  console.log("=".repeat(80));
+  for (const c of companionsAdded) {
+    console.log(`  ${c.constName}: ${c.reason}`);
+  }
+}

package/dist/version.js

@@ -1,2 +1,2 @@
-export const LIB_VERSION = "4.6.0-beta.7";
+export const LIB_VERSION = "4.6.0-beta.8";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "displayName": "Homebridge Eufy Security",
   "name": "@homebridge-plugins/homebridge-eufy-security",
-  "version": "4.6.0-beta.7",
+  "version": "4.6.0-beta.8",
   "description": "Control Eufy Security from homebridge.",
   "type": "module",
   "license": "Apache-2.0",