@homebridge-plugins/homebridge-eufy-security 5.0.0-beta.14 → 5.0.0-beta.16

package/homebridge-ui/public/js/dashboard.js

@@ -37,8 +37,10 @@
    *
    * A row is the whole control — the state names itself and the select beside it says what it means. An
    * unassigned state shows a dash, which is what keeps Night out of HomeKit until it is given a mode.
+   *
+   * It is withheld while the security system it maps is turned off, and the stored map is kept for when it is back.
    */
-  function armingModeControl(device, assigned, messages) {
+  function armingModeControl(device, assigned, messages, securitySystem) {
     const summary = ARMING_SLOTS.map(
       ({ slot, label }) => `${messages[label]} → ${EUFY_MODES.find((mode) => mode.value === assigned[slot])?.label ?? '—'}`,
     ).join(' · ');
@@ -52,17 +54,18 @@
       return `<tr><th scope="row"><label for="${id}">${escapeHtml(messages[label])}</label></th><td><select id="${id}" data-preference="armingModes" data-slot="${slot}" data-serial="${escapeHtml(device.serial)}" data-original="${escapeHtml(value)}"><option value=""${value === '' ? ' selected' : ''}>—</option>${options}</select></td></tr>`;
     }).join('');
     const assignedItself = ARMING_SLOTS.some(({ slot }) => assigned[slot] !== DEFAULT_ARMING_MODES[slot]);
-    return `<details class="arming-setting" data-setting${assignedItself ? ' open' : ''}${device.represented ? '' : ' hidden'} data-requires-representation><summary><span class="setting-label">${escapeHtml(messages.preferenceArmingModes)}</span><span class="arming-summary">${escapeHtml(summary)}</span></summary><table class="arming-table"><thead><tr><th scope="col">HomeKit</th><th scope="col">eufy</th></tr></thead><tbody>${rows}</tbody></table><p class="snapshot-help">${escapeHtml(messages.armingModesHelp)}</p></details>`;
+    return `<details class="arming-setting" data-setting${assignedItself ? ' open' : ''}${device.represented && securitySystem ? '' : ' hidden'} data-requires-representation data-requires-security-system><summary><span class="setting-label">${escapeHtml(messages.preferenceArmingModes)}</span><span class="arming-summary">${escapeHtml(summary)}</span></summary><table class="arming-table"><thead><tr><th scope="col">HomeKit</th><th scope="col">eufy</th></tr></thead><tbody>${rows}</tbody></table><p class="snapshot-help">${escapeHtml(messages.armingModesHelp)}</p></details>`;
   }
 
   function preferenceControl(device, key, preference, messages) {
     const labels = {
       represented: messages.preferenceRepresented,
       audio: messages.preferenceAudio,
+      securitySystem: messages.preferenceSecuritySystem,
       snapshotMode: messages.preferenceSnapshotMode,
     };
     if (key === 'armingModes') {
-      return armingModeControl(device, preference.armingModes, messages);
+      return armingModeControl(device, preference.armingModes, messages, preference.securitySystem);
     }
     const represented = preference.represented;
     const dependent = key === 'represented' ? '' : ` data-requires-representation${represented ? '' : ' hidden'}`;
@@ -254,10 +257,11 @@
   }
 
   /*
-   * The states a diagnostic run can shed light on. Sign-in, another process holding the session, and a pending
-   * restart each have their own remedy stated on the page, so sending those to the wizard would be a detour.
+   * The states a diagnostic run can shed light on. Sign-in, another process holding the session, a pending
+   * restart, a plugin that stopped on an error, a page that could not load, and a connection that recovers on its
+   * own each have their own remedy stated on the page, so sending those to the wizard would be a detour.
    */
-  const DIAGNOSABLE = new Set(['degraded', 'incomplete', 'missing', 'stale']);
+  const DIAGNOSABLE = new Set(['incomplete', 'missing', 'stale']);
 
   function render(result, config, messages, elements) {
     const suffix = result.state
@@ -310,7 +314,7 @@
       const key = control?.dataset?.preference;
       const existing = getConfig();
       if (!existing || !serial || !key) return;
-      const defaults = { represented: true, audio: true, snapshotMode: 'Refresh' };
+      const defaults = { represented: true, audio: true, securitySystem: true, snapshotMode: 'Refresh' };
       if (key === 'armingModes') {
         await saveArmingMode(control, serial, existing, saveConfig, getMessages, elements);
         return;
@@ -336,9 +340,16 @@
             (candidate) => candidate.dataset.serial === serial,
           );
           tile?.classList.toggle('device-tile-disabled', !value);
+          const grid = control.closest('.preference-grid');
+          const securityOff = grid?.querySelector('[data-preference="securitySystem"]')?.checked === false;
+          grid?.querySelectorAll('[data-requires-representation]').forEach((setting) => {
+            setting.hidden = !value || (securityOff && setting.hasAttribute('data-requires-security-system'));
+          });
+        }
+        if (key === 'securitySystem') {
           control
             .closest('.preference-grid')
-            ?.querySelectorAll('[data-requires-representation]')
+            ?.querySelectorAll('[data-requires-security-system]')
             .forEach((setting) => {
               setting.hidden = !value;
             });
@@ -390,6 +401,7 @@
     const preference = {
       represented: preferences[device.serial]?.represented ?? true,
       audio: preferences[device.serial]?.audio ?? true,
+      securitySystem: preferences[device.serial]?.securitySystem ?? true,
       snapshotMode: preferences[device.serial]?.snapshotMode ?? 'Refresh',
       armingModes: { ...DEFAULT_ARMING_MODES, ...preferences[device.serial]?.armingModes },
     };

package/i18n/runtime/en.json

@@ -9,17 +9,19 @@
   "log.action.checkCameraControl": "Check the camera in the Eufy app; this control is unavailable until it reports its state",
   "log.action.retryCameraControl": "Try the control again; the camera did not confirm the change",
   "log.action.enableCamera": "Turn the camera on in the Eufy app, then open live view again",
-  "log.action.openDashboard": "Review device representation in the Homebridge Eufy dashboard",
+  "log.action.notSupportedYet": "No action is needed; these devices are not supported in HomeKit yet",
   "log.action.reduceConcurrentMedia": "Open live view again; if it keeps happening, close a camera already open or raise the concurrent camera media limit in the plugin settings",
   "log.action.reauthenticate": "Authenticate again in the Homebridge Eufy dashboard, then restart Homebridge",
   "log.action.retryArming": "Retry the security-system control manually",
   "log.action.retryLight": "Retry the smart-light control manually",
   "log.action.retryLiveView": "Open live view again, and check network access between Homebridge and the camera",
+  "log.action.setFfmpegPath": "Set a custom FFmpeg path in Advanced settings in the Homebridge Eufy dashboard",
+  "log.action.checkFfmpegPath": "FFmpeg could not be started; check the custom FFmpeg path in Advanced settings in the Homebridge Eufy dashboard",
   "log.action.retryLock": "Retry the lock control manually",
   "log.action.retryTalkback": "Close and reopen the camera, then try speaking again",
   "log.action.reviewRuntime": "Review Homebridge Eufy health in the dashboard and restart Homebridge",
   "log.action.stopOtherOwner": "Stop the other Homebridge Eufy owner before restarting Homebridge",
-  "log.action.selectSupportedArmingMode": "Select Stay, Away, or Disarm to leave the unsupported mode",
+  "log.action.mapArmingMode": "Assign this mode to a HomeKit state under HomeKit guard modes in the device's settings in the Homebridge Eufy dashboard",
   "log.action.waitBattery": "Wait for complete battery capability evidence",
   "log.action.waitArming": "Wait for complete arming capability evidence",
   "log.action.waitBatteryObservation": "Wait for a valid battery observation",

package/package.json

@@ -1,7 +1,7 @@
 {
   "displayName": "Homebridge Eufy",
   "name": "@homebridge-plugins/homebridge-eufy-security",
-  "version": "5.0.0-beta.14",
+  "version": "5.0.0-beta.16",
   "description": "Control Eufy Security from homebridge.",
   "type": "module",
   "license": "Apache-2.0",
@@ -47,17 +47,17 @@
   ],
   "dependencies": {
     "@homebridge/plugin-ui-utils": "^2.2.6",
-    "@mega-yfue/eufy-sdk": "0.2.0",
+    "@mega-yfue/eufy-sdk": "0.3.0",
     "ffmpeg-for-homebridge": "2.2.2"
   },
   "devDependencies": {
     "@homebridge/hap-nodejs": "2.2.3",
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.3",
     "homebridge": "^2.4.0",
     "prettier": "^3.9.9",
     "rimraf": "^6.1.3",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.1"
+    "vitest": "^5.0.2"
   },
   "homepage": "https://homebridge-plugins.github.io/homebridge-eufy/",
   "author": "homebridge-eufy",