@homebridge-plugins/homebridge-eufy-security 0.0.1

package/homebridge-ui/public/utils/countries.js

@@ -0,0 +1,73 @@
+/**
+ * Country list for login form dropdown.
+ * Ported from src/configui/app/countries.ts
+ */
+// eslint-disable-next-line no-unused-vars
+const COUNTRIES = {
+  AF: 'Afghanistan', AX: 'Aland Islands', AL: 'Albania', DZ: 'Algeria',
+  AS: 'American Samoa', AD: 'Andorra', AO: 'Angola', AI: 'Anguilla',
+  AQ: 'Antarctica', AG: 'Antigua and Barbuda', AR: 'Argentina', AM: 'Armenia',
+  AW: 'Aruba', AU: 'Australia', AT: 'Austria', AZ: 'Azerbaijan',
+  BS: 'Bahamas', BH: 'Bahrain', BD: 'Bangladesh', BB: 'Barbados',
+  BY: 'Belarus', BE: 'Belgium', BZ: 'Belize', BJ: 'Benin', BM: 'Bermuda',
+  BT: 'Bhutan', BO: 'Bolivia', BA: 'Bosnia and Herzegovina', BW: 'Botswana',
+  BR: 'Brazil', BN: 'Brunei Darussalam', BG: 'Bulgaria', BF: 'Burkina Faso',
+  BI: 'Burundi', KH: 'Cambodia', CM: 'Cameroon', CA: 'Canada',
+  CV: 'Cape Verde', KY: 'Cayman Islands', CF: 'Central African Republic',
+  TD: 'Chad', CL: 'Chile', CN: 'China', CO: 'Colombia', KM: 'Comoros',
+  CG: 'Congo', CD: 'Congo, the Democratic Republic of the', CK: 'Cook Islands',
+  CR: 'Costa Rica', CI: "Cote D'Ivoire", HR: 'Croatia', CU: 'Cuba',
+  CW: 'Curacao', CY: 'Cyprus', CZ: 'Czech Republic', DK: 'Denmark',
+  DJ: 'Djibouti', DM: 'Dominica', DO: 'Dominican Republic', EC: 'Ecuador',
+  EG: 'Egypt', SV: 'El Salvador', GQ: 'Equatorial Guinea', ER: 'Eritrea',
+  EE: 'Estonia', ET: 'Ethiopia', FK: 'Falkland Islands (Malvinas)',
+  FO: 'Faroe Islands', FJ: 'Fiji', FI: 'Finland', FR: 'France',
+  GF: 'French Guiana', PF: 'French Polynesia', GA: 'Gabon', GM: 'Gambia',
+  GE: 'Georgia', DE: 'Germany', GH: 'Ghana', GI: 'Gibraltar', GR: 'Greece',
+  GL: 'Greenland', GD: 'Grenada', GP: 'Guadeloupe', GU: 'Guam',
+  GT: 'Guatemala', GG: 'Guernsey', GN: 'Guinea', GW: 'Guinea-Bissau',
+  GY: 'Guyana', HT: 'Haiti', VA: 'Holy See (Vatican City State)',
+  HN: 'Honduras', HK: 'Hong Kong', HU: 'Hungary', IS: 'Iceland', IN: 'India',
+  ID: 'Indonesia', IR: 'Iran, Islamic Republic of', IQ: 'Iraq', IE: 'Ireland',
+  IM: 'Isle of Man', IL: 'Israel', IT: 'Italy', JM: 'Jamaica', JP: 'Japan',
+  JE: 'Jersey', JO: 'Jordan', KZ: 'Kazakhstan', KE: 'Kenya', KI: 'Kiribati',
+  KP: "Korea, Democratic People's Republic of", KR: 'Korea, Republic of',
+  XK: 'Kosovo', KW: 'Kuwait', KG: 'Kyrgyzstan',
+  LA: "Lao People's Democratic Republic", LV: 'Latvia', LB: 'Lebanon',
+  LS: 'Lesotho', LR: 'Liberia', LY: 'Libyan Arab Jamahiriya',
+  LI: 'Liechtenstein', LT: 'Lithuania', LU: 'Luxembourg', MO: 'Macao',
+  MK: 'Macedonia, the Former Yugoslav Republic of', MG: 'Madagascar',
+  MW: 'Malawi', MY: 'Malaysia', MV: 'Maldives', ML: 'Mali', MT: 'Malta',
+  MH: 'Marshall Islands', MQ: 'Martinique', MR: 'Mauritania', MU: 'Mauritius',
+  YT: 'Mayotte', MX: 'Mexico', FM: 'Micronesia, Federated States of',
+  MD: 'Moldova, Republic of', MC: 'Monaco', MN: 'Mongolia', ME: 'Montenegro',
+  MS: 'Montserrat', MA: 'Morocco', MZ: 'Mozambique', MM: 'Myanmar',
+  NA: 'Namibia', NR: 'Nauru', NP: 'Nepal', NL: 'Netherlands',
+  NC: 'New Caledonia', NZ: 'New Zealand', NI: 'Nicaragua', NE: 'Niger',
+  NG: 'Nigeria', NU: 'Niue', NF: 'Norfolk Island',
+  MP: 'Northern Mariana Islands', NO: 'Norway', OM: 'Oman', PK: 'Pakistan',
+  PW: 'Palau', PS: 'Palestinian Territory, Occupied', PA: 'Panama',
+  PG: 'Papua New Guinea', PY: 'Paraguay', PE: 'Peru', PH: 'Philippines',
+  PN: 'Pitcairn', PL: 'Poland', PT: 'Portugal', PR: 'Puerto Rico',
+  QA: 'Qatar', RE: 'Reunion', RO: 'Romania', RU: 'Russian Federation',
+  RW: 'Rwanda', BL: 'Saint Barthelemy', SH: 'Saint Helena',
+  KN: 'Saint Kitts and Nevis', LC: 'Saint Lucia', MF: 'Saint Martin',
+  PM: 'Saint Pierre and Miquelon', VC: 'Saint Vincent and the Grenadines',
+  WS: 'Samoa', SM: 'San Marino', ST: 'Sao Tome and Principe',
+  SA: 'Saudi Arabia', SN: 'Senegal', RS: 'Serbia', SC: 'Seychelles',
+  SL: 'Sierra Leone', SG: 'Singapore', SX: 'Sint Maarten', SK: 'Slovakia',
+  SI: 'Slovenia', SB: 'Solomon Islands', SO: 'Somalia', ZA: 'South Africa',
+  SS: 'South Sudan', ES: 'Spain', LK: 'Sri Lanka', SD: 'Sudan',
+  SR: 'Suriname', SZ: 'Swaziland', SE: 'Sweden', CH: 'Switzerland',
+  SY: 'Syrian Arab Republic', TW: 'Taiwan, Province of China',
+  TJ: 'Tajikistan', TZ: 'Tanzania, United Republic of', TH: 'Thailand',
+  TL: 'Timor-Leste', TG: 'Togo', TK: 'Tokelau', TO: 'Tonga',
+  TT: 'Trinidad and Tobago', TN: 'Tunisia', TR: 'Turkey',
+  TM: 'Turkmenistan', TC: 'Turks and Caicos Islands', TV: 'Tuvalu',
+  UG: 'Uganda', UA: 'Ukraine', AE: 'United Arab Emirates',
+  GB: 'United Kingdom', US: 'United States', UY: 'Uruguay', UZ: 'Uzbekistan',
+  VU: 'Vanuatu', VE: 'Venezuela', VN: 'Viet Nam',
+  VG: 'Virgin Islands, British', VI: 'Virgin Islands, U.S.',
+  WF: 'Wallis and Futuna', EH: 'Western Sahara', YE: 'Yemen',
+  ZM: 'Zambia', ZW: 'Zimbabwe',
+};

package/homebridge-ui/public/utils/device-images.js

@@ -0,0 +1,89 @@
+/**
+ * Device type → image filename mapping.
+ * Ported from src/configui/app/util/deviceToImagesMap.ts
+ */
+// eslint-disable-next-line no-unused-vars
+const DeviceImages = {
+  getImage(deviceType) {
+    switch (deviceType) {
+      case 0: return 'homebase2_large.png';
+      case 1: case 4: return 'eufycam_large.jpg';
+      case 2: return 'sensor_large.png';
+      case 3: return 'floodlight_large.jpg';
+      case 5: return 'wireddoorbell2k_large.png';
+      case 7: case 16: return 'batterydoorbell2k_large.png';
+      case 8: return 'eufycam2c_large.jpg';
+      case 9: return 'eufycam2_large.png';
+      case 10: return 'motionsensor_large.png';
+      case 11: return 'keypad_large.png';
+      case 14: return 'eufycam2pro_large.jpg';
+      case 15: return 'eufycam2cpro_large.jpg';
+      case 18: return 'homebase3_large.png';
+      case 19: return 'eufycam3_large.jpg';
+      case 23: return 'eufycam3c_large.jpg';
+      case 24: return 'eufycame330_large.jpg';
+      case 25: return 'minibase_chime_T8023_large.jpg';
+      case 26: return 'eufycam3pro_large.png';
+      case 28: return 'homebasemini_large.jpg';
+      case 30: return 'indoorcamc120_large.png';
+      case 31: case 35: return 'indoorcamp24_large.png';
+      case 32: case 33: return 'solocame20_large.jpg';
+      case 34: return 'soloindoorcamc24_large.jpg';
+      case 37: return 'floodlight_large.jpg';
+      case 38: return 'floodlight2pro_large.jpg';
+      case 39: return 'floodlight_large.jpg';
+      case 44: case 46: return 'solooutdoorcamc22_large.png';
+      case 45: return 'solooutdoorcamc24_large.jpg';
+      case 47: return 'floodlightcame340_large.jpg';
+      case 48: return 'solocams340_large.png';
+      case 49: return 'solocame40_large.jpg';
+      case 50: return 'smartlock_touch_t8510_large.png';
+      case 51: return 'smartlock_touch_and_wifi_t8520_large.png';
+      case 52: case 53: return 'smartlock_t8500_large.png';
+      case 54: return 'smartlock_t8503_large.png';
+      case 55: return 'smartlock_video_t8530_large.png';
+      case 56: case 57: return 'smartlock_t8510P_t8520P_large.png';
+      case 58: return 'smartlock_t8504_large.jpg';
+      case 60: return 'solocaml20_large.jpg';
+      case 61: return 'solooutdoorcamc24_large.jpg';
+      case 62: return 'solocams40_large.jpg';
+      case 63: return 'solocams220_large.jpg';
+      case 64: return 'solocamc210_large.jpg';
+      case 87: return 'floodlight2_large.jpg';
+      case 88: return 'solocame30_large.png';
+      case 90: return 'smartdrop_t8790_large.png';
+      case 91: return 'batterydoorbell2kdual_large.jpg';
+      case 93: return 'wireddoorbelldual_large.jpg';
+      case 94: return 'batterydoorbell_e340_large.png';
+      case 95: return 'BATTERY_DOORBELL_C30.png';
+      case 96: return 'BATTERY_DOORBELL_C31.png';
+      case 100: return 'indoorcammini_large.jpg';
+      case 104: return 'indoorcams350_large.jpg';
+      case 105: return 'indoorcamE30_large.png';
+      case 101: case 102:
+      case 131: case 132: case 133:
+        return 'garage_camera_t8452_large.jpg';
+      case 110: return '4g_lte_starlight_large.jpg';
+      case 126: return 'sensor_large.png';
+      case 140: return 'smartsafe_s10_t7400_large.png';
+      case 141: return 'smartsafe_s12_t7401_large.png';
+      case 142: case 143: return 'smartsafe_s10_t7400_large.png';
+      case 151: return 'walllight_s100_large.jpg';
+      case 157: return 'smarttrack_link_t87B0_large.png';
+      case 159: return 'smarttrack_card_t87B2_large.png';
+      case 180: return 'smartlock_touch_and_wifi_t8502_large.png';
+      case 184: return 'smartlock_touch_and_wifi_t8506_large.png';
+      case 10005: return 'walllight_s120_large.jpg';
+      case 10008: return 'indoorcamC220_large.png';
+      case 10009: return 'indoorcamC210_large.png';
+      case 10010: return 'indoorcamC220_large.png';
+      case 10035: return 'solocamc35_large.png';
+      default: return 'unknown.png';
+    }
+  },
+
+  /** Returns full relative path to device image */
+  getPath(deviceType) {
+    return 'assets/devices/' + this.getImage(deviceType);
+  },
+};

package/homebridge-ui/public/utils/helpers.js

@@ -0,0 +1,87 @@
+/**
+ * Shared utility functions used across views and components.
+ */
+// eslint-disable-next-line no-unused-vars
+const Helpers = {
+  /**
+   * Escape HTML to prevent XSS when inserting user-supplied strings.
+   * @param {string} str
+   * @returns {string}
+   */
+  escHtml(str) {
+    const div = document.createElement('div');
+    div.textContent = str;
+    return div.innerHTML;
+  },
+
+  /**
+   * Append Node.js version warning text nodes to the given parent element.
+   * Uses DOM APIs exclusively — no innerHTML — to satisfy static-analysis security rules.
+   * @param {HTMLElement} parent
+   */
+  appendNodeVersionWarning(parent) {
+    const parts = [
+      ['text', 'Your Node.js version has removed '],
+      ['code', 'RSA_PKCS1_PADDING'],
+      ['text', ' support, which breaks streaming features. The rest of the plugin works fine. Use '],
+      ['strong', 'Node.js v20.11.0'],
+      ['text', ' or earlier, or upgrade to '],
+      ['strong', 'v24.5.0+'],
+      ['text', '. '],
+    ];
+    for (const [type, value] of parts) {
+      if (type === 'text') {
+        parent.appendChild(document.createTextNode(value));
+      } else {
+        const el = document.createElement(type);
+        el.textContent = value;
+        parent.appendChild(el);
+      }
+    }
+    const link = document.createElement('a');
+    link.href = 'https://github.com/homebridge-plugins/homebridge-eufy-security/wiki/Node.js-Compatibility-with-Eufy-Security-Plugin';
+    link.target = '_blank';
+    link.textContent = 'Learn more';
+    parent.appendChild(link);
+  },
+
+  /**
+   * Create an inline SVG icon <img> element from the assets/icons/ folder.
+   * @param {string}  name  Icon filename without path, e.g. 'warning.svg'
+   * @param {number}  [size=16]  Width/height in px
+   * @param {string}  [alt='']   Alt text
+   * @returns {HTMLImageElement}
+   */
+  icon(name, size = 16, alt = '') {
+    const img = document.createElement('img');
+    img.src = 'assets/icons/' + name;
+    img.alt = alt;
+    img.width = size;
+    img.height = size;
+    img.style.verticalAlign = 'middle';
+    return img;
+  },
+
+  /**
+   * Return an HTML string for an inline SVG icon.
+   * Useful inside innerHTML / insertAdjacentHTML templates.
+   * @param {string}  name  Icon filename, e.g. 'warning.svg'
+   * @param {number}  [size=16]  Width/height in px
+   * @param {string}  [alt='']   Alt text
+   * @returns {string}
+   */
+  iconHtml(name, size = 16, alt = '') {
+    return `<img src="assets/icons/${name}" alt="${alt}" width="${size}" height="${size}" style="vertical-align:middle">`;
+  },
+
+  /**
+   * Return the correct battery icon filename for a given percentage.
+   * Maps 0-100% to battery_0.svg … battery_6.svg (7 levels).
+   * @param {number} pct  Battery percentage (0-100)
+   * @returns {string}  e.g. 'battery_3.svg'
+   */
+  batteryIcon(pct) {
+    const level = Math.max(0, Math.min(6, Math.round((pct / 100) * 6)));
+    return 'battery_' + level + '.svg';
+  },
+};

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

@@ -0,0 +1,226 @@
+/**
+ * Dashboard View — displays device/station grid.
+ * Main screen after login. Shows all discovered devices as cards.
+ */
+// eslint-disable-next-line no-unused-vars
+const DashboardView = {
+
+  _container: null,
+
+  async render(container) {
+    this._container = container;
+    container.innerHTML = '';
+
+    const config = await Config.get();
+
+    // Header
+    const header = document.createElement('div');
+    header.className = 'eufy-header';
+
+    const titleEl = document.createElement('h4');
+    titleEl.textContent = 'Eufy Security';
+    header.appendChild(titleEl);
+
+    const headerRight = document.createElement('div');
+    headerRight.className = 'eufy-header__right';
+
+    // Cache date label
+    if (App.state.cacheDate) {
+      const cacheLabel = document.createElement('span');
+      cacheLabel.className = 'eufy-cache-date';
+      const d = new Date(App.state.cacheDate);
+      cacheLabel.textContent = 'Cached: ' + d.toLocaleDateString(undefined, { year: 'numeric', month: 'short', day: 'numeric' });
+      cacheLabel.title = 'Last fetched: ' + d.toLocaleString();
+      headerRight.appendChild(cacheLabel);
+    }
+
+    const btnGroup = document.createElement('div');
+    btnGroup.className = 'd-flex gap-2';
+
+    const btnRefresh = this._headerBtn('refresh.svg', 'Re-login / Re-fetch', 'btn-success', () => App.navigate('login'));
+    const btnDiagnostic = this._headerBtn('bug-report.svg', 'Diagnostics', 'btn-warning', () => App.navigate('diagnostics'));
+    const btnSettings = this._headerBtn('settings.svg', 'Global Settings', 'btn-danger', () => App.navigate('settings'));
+
+    btnGroup.appendChild(btnRefresh);
+    btnGroup.appendChild(btnDiagnostic);
+    btnGroup.appendChild(btnSettings);
+    headerRight.appendChild(btnGroup);
+    header.appendChild(headerRight);
+    container.appendChild(header);
+
+    // Node.js version warning banner (shown if affected)
+    const warning = App.state.nodeVersionWarning;
+    if (warning && warning.affected) {
+      const banner = document.createElement('div');
+      banner.className = 'node-version-banner';
+
+      const iconDiv = document.createElement('div');
+      iconDiv.className = 'node-version-banner__icon';
+      iconDiv.appendChild(Helpers.icon('warning.svg', 24));
+      banner.appendChild(iconDiv);
+
+      const contentDiv = document.createElement('div');
+      contentDiv.className = 'node-version-banner__content';
+
+      const title = document.createElement('strong');
+      title.textContent = `Node.js ${warning.nodeVersion} — Streaming Incompatible`;
+      contentDiv.appendChild(title);
+
+      const textDiv = document.createElement('div');
+      textDiv.className = 'node-version-banner__text';
+      Helpers.appendNodeVersionWarning(textDiv);
+      contentDiv.appendChild(textDiv);
+
+      banner.appendChild(contentDiv);
+      container.appendChild(banner);
+    }
+
+    // Device grid
+    const stations = App.state.stations || [];
+
+    if (stations.length === 0) {
+      container.insertAdjacentHTML('beforeend', `
+        <div class="text-center text-muted py-5">
+          <div style="font-size: 2rem; margin-bottom: 12px;">${Helpers.iconHtml('inventory.svg', 32)}</div>
+          <p><strong>Your account is connected but no devices were found.</strong></p>
+          <p style="font-size: 0.85rem; max-width: 480px; margin: 0 auto;">
+            If you are using a guest admin account, make sure you have:<br>
+            1. Logged into the <strong>official Eufy Security app</strong> with the guest account<br>
+            2. <strong>Accepted the invitation</strong> from the main account<br>
+            3. <strong>Logged out</strong> of the official app before refreshing here
+          </p>
+          <button class="btn btn-primary btn-sm mt-3" id="btn-go-login">Refresh Devices</button>
+        </div>
+      `);
+      container.querySelector('#btn-go-login').addEventListener('click', () => App.navigate('login'));
+      return;
+    }
+
+    const grid = document.createElement('div');
+    grid.className = 'row';
+
+    // Flatten: stations + their devices
+    const ignoreDevices = config.ignoreDevices || [];
+    const ignoreStations = config.ignoreStations || [];
+
+    // Separate supported and unsupported
+    const supported = [];
+    const unsupported = [];
+
+    stations.forEach((station) => {
+      // Check if station has a standalone device (device serial === station serial)
+      const standaloneDevice = (station.devices || []).find(
+        (d) => d.uniqueId === station.uniqueId
+      );
+
+      if (standaloneDevice) {
+        // Standalone: show as single card (the device IS the station)
+        const item = { ...standaloneDevice, type: standaloneDevice.type };
+        if (station.unsupported || item.unsupported) {
+          item.unsupported = true;
+          unsupported.push({ item, isStation: false, station });
+        } else {
+          supported.push({ item, isStation: false, station });
+        }
+      } else {
+        // Station card
+        if (!station.disabled) {
+          const stationItem = {
+            uniqueId: station.uniqueId,
+            displayName: station.displayName,
+            type: station.type,
+            typename: station.typename,
+            unsupported: station.unsupported,
+            ignored: station.ignored,
+            power: station.power,
+          };
+          if (station.unsupported) {
+            unsupported.push({ item: stationItem, isStation: true, station });
+          } else {
+            supported.push({ item: stationItem, isStation: true, station });
+          }
+        }
+
+        // Device cards for this station
+        (station.devices || []).forEach((device) => {
+          if (station.unsupported || device.unsupported) {
+            unsupported.push({ item: { ...device, unsupported: true }, isStation: false, station });
+          } else {
+            supported.push({ item: device, isStation: false, station });
+          }
+        });
+      }
+    });
+
+    // Render supported devices
+    supported.forEach(({ item, isStation }) => {
+      const isIgnored = isStation
+        ? ignoreStations.includes(item.uniqueId)
+        : ignoreDevices.includes(item.uniqueId);
+
+      DeviceCard.render(grid, {
+        device: { ...item, ignored: isIgnored },
+        isStation: isStation,
+        enabled: !isIgnored,
+        onClick: (d) => {
+          const type = isStation ? 'station' : 'device';
+          App.navigate('detail/' + type + '/' + d.uniqueId);
+        },
+        onToggle: (d, enabled) => {
+          const type = isStation ? 'station' : 'device';
+          Config.toggleIgnore(d.uniqueId, !enabled, type);
+          // Re-render to update visual state
+          this.render(this._container);
+        },
+      });
+    });
+
+    container.appendChild(grid);
+
+    // Unsupported section
+    if (unsupported.length > 0) {
+      const section = document.createElement('div');
+      section.className = 'mt-4';
+      section.innerHTML = `
+        <div class="detail-section__title">Unsupported Devices</div>
+        <p class="text-muted" style="font-size: 0.8rem;">
+          These devices were detected but are not yet fully supported by the eufy-security-client library.
+          Click on a device to find out how you can help us add support for it.
+        </p>
+      `;
+
+      const unsupportedGrid = document.createElement('div');
+      unsupportedGrid.className = 'row';
+
+      unsupported.forEach(({ item, isStation }) => {
+        DeviceCard.render(unsupportedGrid, {
+          device: { ...item, unsupported: true },
+          isStation: isStation,
+          enabled: false,
+          onClick: (d) => {
+            App.navigate('unsupported/' + d.uniqueId);
+          },
+          onToggle: () => {},
+        });
+      });
+
+      section.appendChild(unsupportedGrid);
+      container.appendChild(section);
+    }
+  },
+
+  _headerBtn(iconFile, label, btnClass, onClick) {
+    const btn = document.createElement('button');
+    btn.className = 'btn ' + btnClass + ' btn-sm eufy-tooltip';
+    btn.setAttribute('data-tooltip', label);
+    const img = document.createElement('img');
+    img.src = 'assets/icons/' + iconFile;
+    img.alt = label;
+    img.style.width = '24px';
+    img.style.height = '24px';
+    img.style.filter = 'brightness(0) invert(1)';
+    btn.appendChild(img);
+    btn.addEventListener('click', onClick);
+    return btn;
+  },
+};