homebridge-lib 5.2.2 → 5.3.0

package/index.js

@@ -196,6 +196,13 @@ class homebridgeLib {
     */
   static get SystemInfo () { return require('./lib/SystemInfo') }
 
+  /** Server for dynamic configuration settings through Homebridge UI.
+    * <br>See {@link UiServer}.
+    * @type {Class}
+    * @memberof module:homebridgeLib
+    */
+  static get UiServer () { return require('./lib/UiServer') }
+
   /** Universal Plug and Play client.
     * <br>See {@link UpnpClient}.
     * @type {Class}

package/lib/CommandLineTool.js

@@ -150,8 +150,9 @@ class CommandLineTool {
     return !!this._options.debug
   }
 
-  /* Usage string.
-   */
+  /** Usage string.
+    * @type {string}
+    */
   get usage () { return this._usage }
   set usage (usage) {
     this._usage = usage
@@ -167,6 +168,9 @@ class CommandLineTool {
   // ===== Logging =============================================================
 
   /** Print debug message to stderr.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   debug (format, ...args) {
     if (this._options.debug) {
@@ -175,12 +179,18 @@ class CommandLineTool {
   }
 
   /** Print error message to stderr.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   error (format, ...args) {
     this._log({ label: 'error', chalk: chalk.bold.red }, format, ...args)
   }
 
   /** Print error message to stderr and abort program.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   async fatal (format, ...args) {
     this._log({ label: 'fatal', chalk: chalk.bold.red }, format, ...args)
@@ -195,24 +205,36 @@ class CommandLineTool {
   }
 
   /** Print log message to stderr.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   log (format, ...args) {
     this._log({}, format, ...args)
   }
 
   /** Print log message continuation to stderr.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   logc (format, ...args) {
     this._log({ noLabel: true }, format, ...args)
   }
 
   /** Print message to stdout.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   print (format, ...args) {
     this._log({ noLabel: true, stdout: true }, format, ...args)
   }
 
   /** Print verbose debug message to stderr.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   vdebug (format, ...args) {
     if (this._options.vdebug) {
@@ -221,6 +243,9 @@ class CommandLineTool {
   }
 
   /** Print very verbose debug message to stderr.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   vvdebug (format, ...args) {
     if (this._options.vvdebug) {
@@ -229,6 +254,9 @@ class CommandLineTool {
   }
 
   /** Print warning message to stderr.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
     */
   warn (format, ...args) {
     this._log({ label: 'warning', chalk: chalk.yellow }, format, ...args)

package/lib/EveHomeKitTypes.js

@@ -40,13 +40,12 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
     super(homebridge)
 
     /** @member EveHomeKitTypes#Characteristics
-      * @property {Class} AirParticulateDensity - Density (in ppm) of air
-      * particulates.
-      * <br>Used by: Eve Room.
+      * @property {Class} AirParticulateDensity - Deprecated. use `VOCLevel`
+      * instead.
       * @property {Class} AirPressure - Air pressure (in hPa).
       * <br>Used by: Eve Weather.
-      * @property {Class} ClosedDuration - Time in seconds that door has been
-      * open.
+      * @property {Class} ClosedDuration - Duration (in seconds) that door has
+      * been closed.
       * <br>Used by: Eve Door.
       * @property {Class} Clouds - Cloud coverage (in %).
       * <br>Used by: weather station.
@@ -59,6 +58,10 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
       * @property {Class} ConditionCategory - Weather condition
       * (as numberic code).
       * <br>Used by: weather station.
+      * @property {Class} ConfigCommand - Used by Eve app to set configuration.
+      * <br> Used by: `History` service.
+      * @property {Class} ConfigData - Used by Eve app to read configuration.
+      * <br> Used by: `History` service.
       * @property {Class} CurrentConsumption - Current electric consumption
       * (in W).
       * <br>Used by: Eve Energy.
@@ -98,7 +101,7 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
       * @property {Class} ObservationTime - Time of observation.
       * <br>Used by: weather station.
       * @property {Class} OpenDuration - Duration (in seconds) that door has
-      * been closed.
+      * been open.
       * <br>Used by: Eve Door.
       * @property {Class} Ozone - Ozone level (in DU).
       * <br>Used by: weather station.
@@ -138,6 +141,8 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
       * <br>Used by: Eve Thermo.
       * @property {Class} Visibility - Visibility (in km).
       * <br>Used by: weather station.
+      * @property {Class} VOCLevel - Volatile Organic Compound level (in ppm).
+      * <br>Used by: Eve Room (1st gen).
       * @property {Class} Voltage - Electric voltage (in V).
       * <br>Used by: Eve Energy.
       * @property {Class} WindDirection - Wind direction (as text).
@@ -167,23 +172,32 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
       maxValue: 5000,
       minStep: 1,
       perms: [this.Perms.READ, this.Perms.NOTIFY]
-    }, 'Air Particulate Density')
+    }, 'VOC Level')
+
+    this.createCharacteristicClass('VOCLevel', uuid('10B'), {
+      format: this.Formats.INT16,
+      unit: 'ppm',
+      minValue: 5,
+      maxValue: 5000,
+      minStep: 5,
+      perms: [this.Perms.READ, this.Perms.NOTIFY]
+    }, 'VOC Level')
 
     this.createCharacteristicClass('TotalConsumption', uuid('10C'), {
       format: this.Formats.FLOAT,
+      unit: 'kWh',
       minValue: 0,
       maxValue: 1000000,
       minStep: 0.1,
-      unit: 'kWh',
       perms: [this.Perms.READ, this.Perms.NOTIFY]
     }, 'Total Consumption')
 
     this.createCharacteristicClass('CurrentConsumption', uuid('10D'), {
       format: this.Formats.FLOAT,
+      unit: 'W',
       minValue: 0,
       maxValue: 12000,
       minStep: 0.1,
-      unit: 'W',
       perms: [this.Perms.READ, this.Perms.NOTIFY]
     }, 'Current Consumption')
 
@@ -236,6 +250,11 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
       perms: [this.Perms.WRITE, this.Perms.HIDDEN]
     }, 'History Request')
 
+    this.createCharacteristicClass('ConfigCommand', uuid('11D'), {
+      format: this.Formats.DATA,
+      perms: [this.Perms.WRITE, this.Perms.HIDDEN]
+    }, 'Config Command')
+
     this.createCharacteristicClass('Sensitivity', uuid('120'), {
       format: this.Formats.UINT8,
       minValue: 0,
@@ -314,6 +333,11 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
       adminOnlyAccess: [this.Access.WRITE]
     })
 
+    this.createCharacteristicClass('ConfigData', uuid('131'), {
+      format: this.Formats.DATA,
+      perms: [this.Perms.READ, this.Perms.NOTIFY, this.Perms.HIDDEN]
+    }, 'Config Data')
+
     // =========================================================================
 
     // The following custom characteristics are supported by the Eve app.
@@ -541,10 +565,10 @@ class EveHomeKitTypes extends homebridgeLib.CustomHomeKitTypes {
       this.Characteristics.HistoryStatus,
       this.Characteristics.HistoryEntries
     ], [
-      // this.Characteristics.Char11E,
+      // this.Characteristics.Char11E, // Used for firmware update?
       this.Characteristics.ResetTotal
-      // this.Characteristics.Char11D,
-      // this.Characteristics.Char131
+      // this.Characteristics.ConfigCommand,
+      // this.Characteristics.ConfigData
     ])
 
     this.createServiceClass('AirPressureSensor', uuid('00A'), [

package/lib/Platform.js

@@ -9,8 +9,10 @@ const homebridgeLib = require('../index')
 
 const events = require('events')
 const fs = require('fs')
+const http = require('http')
 const semver = require('semver')
 const util = require('util')
+
 const libPackageJson = require('../package.json')
 
 const uuid = /^[0-9A-F]{8}-[0-9A-F]{4}-[1-5][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/
@@ -37,7 +39,8 @@ const context = {
   * the plugin through Homebridge;
   * - Persist HomeKit accessories across Homebridge restarts;
   * - Support for device polling by providing a heartbeat;
-  * - Support for UPnP device discovery.
+  * - Support for UPnP device discovery;
+  * - Support dynamic configuration through the Homebridge UI.
   * @abstract
   * @extends Delegate
   */
@@ -172,11 +175,7 @@ class Platform extends homebridgeLib.Delegate {
     this.log('os: %s', this.systemInfo.osInfo.prettyName)
     this._heartbeatStart = new Date()
     setTimeout(() => { this._beat(-1) }, 1000)
-    this.on('exit', () => {
-      this.debug('flush cachedAccessories')
-      this._homebridge.updatePlatformAccessories()
-      this.log('goodbye')
-    })
+    this.on('exit', () => { this._flushCachedAccessories() })
 
     const n = Object.keys(this._accessories).length
     if (n > 0) {
@@ -188,7 +187,13 @@ class Platform extends homebridgeLib.Delegate {
     if (this.listenerCount('upnpDeviceFound') > 0) {
       this._upnpMonitor.search()
     }
+    if (typeof this.onUiRequest === 'function') {
+      try {
+        await this._createUiServer()
+      } catch (error) { this.error(error) }
+    }
     await events.once(this, 'initialised')
+    this._flushCachedAccessories()
     for (const id in this._accessories) {
       if (this._accessoryDelegates[id] == null) {
         const accessory = this._accessories[id]
@@ -205,6 +210,12 @@ class Platform extends homebridgeLib.Delegate {
     }
   }
 
+  // Write `cachedAccessories` to disk.
+  _flushCachedAccessories () {
+    this.debug('flush cachedAccessories')
+    this._homebridge.updatePlatformAccessories()
+  }
+
   // Called every second.
   _beat (beat) {
     beat += 1
@@ -221,9 +232,7 @@ class Platform extends homebridgeLib.Delegate {
     }, 1000 - drift)
 
     if (beat % context.saveInterval === 30) {
-      // Persist dynamic platform accessories to cachedAccessories
-      this.debug('flush cachedAccessories')
-      this._homebridge.updatePlatformAccessories()
+      this._flushCachedAccessories()
     }
 
     if (beat % context.checkInterval === 0) {
@@ -255,6 +264,9 @@ class Platform extends homebridgeLib.Delegate {
     this._shuttingDown = true
     this.removeAllListeners('upnpDeviceAlive')
     this.removeAllListeners('upnpDeviceFound')
+    if (this._ui != null && this._ui.abortController != null) {
+      this._ui.abortController.abort()
+    }
     for (const id in this._accessoryDelegates) {
       /** Emitted when Homebridge is shutting down.
         *
@@ -545,6 +557,97 @@ class Platform extends homebridgeLib.Delegate {
       })
   }
 
+  // ===== Dynamic Configuration through Homebridge UI =========================
+
+  /** Handler for requests from the Homebridge Plugin UI Server.
+    * @function Platform#onUiRequest
+    * @async
+    * @abstract
+    * @param {string} method - The request method.
+    * @param {string} resource - The request resource.
+    * @param {*} body - The request body.
+    * @returns {*} - The response body.
+    */
+
+  // Create HTTP server for Homebridge Plugin UI Settings.
+  async _createUiServer () {
+    this._ui = {}
+    this._ui.server = new http.Server()
+    this._ui.server
+      .on('listening', () => {
+        this._ui.port = this._ui.server.address().port
+        this.log('ui server: listening on http://127.0.0.1:%d/', this._ui.port)
+        for (const id in this._accessoryDelegates) {
+          this._accessoryDelegates[id]._context.uiPort = this._ui.port
+        }
+      })
+      .on('error', (error) => { this.error(error) })
+      .on('close', () => {
+        this.debug('ui server: closed port %d', this._ui.port)
+      })
+      .on('request', async (request, response) => {
+        let buffer = ''
+        request.on('data', (data) => { buffer += data })
+        request.on('end', async () => {
+          try {
+            if (buffer !== '') {
+              try {
+                request.body = JSON.parse(buffer)
+              } catch (error) {
+                this.log(
+                  'ui request %s: %s %s %s', ++this._ui.requestId,
+                  request.method, request.url, buffer
+                )
+                this.warn('ui request %d: %s', this._ui.requestId, error.message)
+                response.writeHead(400) // Bad Request
+                response.end()
+                return
+              }
+              this.debug(
+                'ui request %s: %s %s %j', ++this._ui.requestId,
+                request.method, request.url, request.body
+              )
+            } else {
+              this.debug(
+                'ui request %s: %s %s', ++this._ui.requestId,
+                request.method, request.url
+              )
+            }
+            const { status, body } =
+              request.method === 'GET' && request.url === '/ping'
+                ? { status: 200, body: 'pong' }
+                : await this.onUiRequest(
+                  request.method, request.url, request.body
+                )
+            this.debug(
+              'ui request %d: %d %s', this._ui.requestId,
+              status, http.STATUS_CODES[status]
+            )
+            if (status === 200) {
+              this.vdebug('ui request %d: response: %j', this._ui.requestId, body)
+              response.writeHead(status, { 'Content-Type': 'application/json' })
+              response.end(JSON.stringify(body))
+            } else {
+              response.writeHead(status)
+              response.end()
+            }
+          } catch (error) {
+            this.warn('ui request %d: %s', this._ui.requestId, error)
+            response.writeHead(500) // Internal Server Error
+            response.end()
+          }
+        })
+      })
+    this._ui.abortController = new AbortController() // eslint-disable-line no-undef
+    this._ui.requestId = 0
+    this._ui.server.listen({
+      port: 0,
+      host: '127.0.0.1',
+      signal: this._ui.abortController.signal
+    })
+    await events.once(this._ui.server, 'listening')
+  }
+
   // ===== Logging =============================================================
 
   // Do the heavy lifting for debug(), error(), fatal(), log(), and warn(),

package/lib/ServiceDelegate/History/Motion.js

@@ -75,15 +75,14 @@ class Motion extends History {
       const now = Math.round(new Date().valueOf() / 1000)
       lastActivationDelegate.value = now - this._h.initialTime
       this._entry.status = value
-      // Eve v5.4.2 fills in missing temperature at 0.00°C.
-      // if (this._entry.temp != null) {
-      //   const temp = this._entry.temp
-      //   this._entry.temp = null
-      //   this._addEntry(now)
-      //   this._entry.temp = temp
-      // } else {
-      this._addEntry(now)
-      // }
+      if (this._entry.temp != null) {
+        const temp = this._entry.temp
+        this._entry.temp = null
+        this._addEntry(now)
+        this._entry.temp = temp
+      } else {
+        this._addEntry(now)
+      }
     })
     if (temperatureDelegate != null) {
       this._entry.temp = temperatureDelegate.value
@@ -94,27 +93,24 @@ class Motion extends History {
   }
 
   get _fingerPrint () {
-    if (this._entry.temp != null) {
-      return '02 1c01 0102'
-    }
-    return '01 1c01'
+    return '02 1c01 0102'
   }
 
   _entryStream (entry) {
-    if (this._entry.temp != null) {
+    if (entry.temp == null) {
       return util.format(
-        '|0d %s %s 03 %s %s',
+        '|0b %s %s 01 %s',
         numToHex(swap32(this._h.currentEntry), 8),
         numToHex(swap32(entry.time - this._h.initialTime), 8),
-        numToHex(entry.status, 2),
-        numToHex(swap16(entry.temp * 100), 4)
+        numToHex(entry.status, 2)
       )
     }
     return util.format(
-      '|0b %s %s 01 %s',
+      '|0d %s %s 03 %s %s',
       numToHex(swap32(this._h.currentEntry), 8),
       numToHex(swap32(entry.time - this._h.initialTime), 8),
-      numToHex(entry.status, 2)
+      numToHex(entry.status, 2),
+      numToHex(swap16(entry.temp * 100), 4)
     )
   }
 }

package/lib/ServiceDelegate/History/Weather.js

@@ -74,9 +74,7 @@ class Weather extends ServiceDelegate.History {
     }
     this._entry = {
       time: 0,
-      temp: temperatureDelegate.value,
-      humidity: 0,
-      pressure: 0
+      temp: temperatureDelegate.value
     }
     temperatureDelegate.on('didSet', (value) => {
       this._entry.temp = value
@@ -95,11 +93,26 @@ class Weather extends ServiceDelegate.History {
     }
   }
 
-  get _fingerPrint () {
-    return '03 0102 0202 0302'
-  }
+  get _fingerPrint () { return '03 0102 0202 0302' }
 
   _entryStream (entry) {
+    if (entry.humidity == null) {
+      return util.format(
+        '|0c %s %s 01 %s',
+        numToHex(swap32(this._h.currentEntry), 8),
+        numToHex(swap32(entry.time - this._h.initialTime), 8),
+        numToHex(swap16(entry.temp * 100), 4)
+      )
+    }
+    if (entry.pressure == null) {
+      return util.format(
+        '|0e %s %s 03 %s %s',
+        numToHex(swap32(this._h.currentEntry), 8),
+        numToHex(swap32(entry.time - this._h.initialTime), 8),
+        numToHex(swap16(entry.temp * 100), 4),
+        numToHex(swap16(entry.humidity * 100), 4)
+      )
+    }
     return util.format(
       '|10 %s %s 07 %s %s %s',
       numToHex(swap32(this._h.currentEntry), 8),

package/lib/ServiceDelegate/History/index.js

@@ -144,6 +144,7 @@ class History extends ServiceDelegate {
       setter: this._onSetHistoryRequest.bind(this),
       silent: true
     })
+
     this.addCharacteristicDelegate({
       key: 'setTime',
       Characteristic: this.Characteristics.eve.SetTime,
@@ -155,12 +156,14 @@ class History extends ServiceDelegate {
       const date = dateToString(buffer.readUInt32LE())
       this.debug('SetTime changed to %s', date)
     })
+
     this.addCharacteristicDelegate({
       key: 'historyStatus',
       Characteristic: this.Characteristics.eve.HistoryStatus,
       value: params.historyStatus,
       silent: true
     })
+
     this.addCharacteristicDelegate({
       key: 'historyEntries',
       Characteristic: this.Characteristics.eve.HistoryEntries,
@@ -168,6 +171,21 @@ class History extends ServiceDelegate {
       getter: this._onGetEntries.bind(this),
       silent: true
     })
+
+    // this.addCharacteristicDelegate({
+    //   key: 'configCommand',
+    //   Characteristic: this.Characteristics.eve.ConfigCommand,
+    //   setter: this._onSetConfig.bind(this)
+    //   // silent: true
+    // })
+
+    // this.addCharacteristicDelegate({
+    //   key: 'configData',
+    //   Characteristic: this.Characteristics.eve.ConfigData,
+    //   getter: this._onGetConfig.bind(this)
+    //   // silent: true
+    // })
+
     this._accessoryDelegate.heartbeatEnabled = true
     this._accessoryDelegate
       .once('heartbeat', (beat) => {
@@ -214,30 +232,31 @@ class History extends ServiceDelegate {
 
     const usedMemeoryOffset = this._h.usedMemory < this._memorySize ? 1 : 0
     const firstEntryOffset = this._h.usedMemory < this._memorySize ? 0 : 1
-    const buffer = Buffer.alloc(1024)
-    let offset = 0
-    buffer.writeUInt32LE(this._entry.time - this._h.initialTime, offset)
-    offset += 4
-    buffer.writeUInt32LE(0, offset)
-    offset += 4
-    buffer.writeUInt32LE(this._h.initialTime - epoch, offset)
-    offset += 4
-    buffer.write(this._fingerPrint.replace(/[^0-9A-F]/ig, ''), offset, 'hex')
-    const length = 1 + 2 * parseInt(this._fingerPrint.slice(0, 2))
-    this.debug('fingerprint length: %d', length)
-    offset += length
-    buffer.writeUInt16LE(this._h.usedMemory + usedMemeoryOffset, offset)
-    offset += 2
-    buffer.writeUInt16LE(this._memorySize, offset)
-    offset += 2
-    buffer.writeUInt32LE(this._h.firstEntry + firstEntryOffset, offset)
-    offset += 4
-    buffer.writeUInt32LE(0, offset)
-    offset += 4
-    buffer.writeUint8(1, offset)
-    offset += 1
-    buffer.writeUint8(1, offset)
-    offset += 1
+
+    // const buffer = Buffer.alloc(1024)
+    // let offset = 0
+    // buffer.writeUInt32LE(this._entry.time - this._h.initialTime, offset)
+    // offset += 4
+    // buffer.writeUInt32LE(0, offset)
+    // offset += 4
+    // buffer.writeUInt32LE(this._h.initialTime - epoch, offset)
+    // offset += 4
+    // buffer.write(this._fingerPrint.replace(/[^0-9A-F]/ig, ''), offset, 'hex')
+    // const length = 1 + 2 * parseInt(this._fingerPrint.slice(0, 2))
+    // this.debug('fingerprint length: %d', length)
+    // offset += length
+    // buffer.writeUInt16LE(this._h.usedMemory + usedMemeoryOffset, offset)
+    // offset += 2
+    // buffer.writeUInt16LE(this._memorySize, offset)
+    // offset += 2
+    // buffer.writeUInt32LE(this._h.firstEntry + firstEntryOffset, offset)
+    // offset += 4
+    // buffer.writeUInt32LE(0, offset)
+    // offset += 4
+    // buffer.writeUint8(1, offset)
+    // offset += 1
+    // buffer.writeUint8(1, offset)
+    // offset += 1
 
     const value = util.format(
       '%s 00000000 %s [%s] %s %s %s 000000000101',
@@ -251,7 +270,7 @@ class History extends ServiceDelegate {
 
     this.debug('add entry %d: %j', this._h.lastEntry, this._entry)
     this.debug('set history status to: %j', value)
-    this.debug('set history status to: %j', buffer.slice(0, offset).toString('hex'))
+    // this.debug('set history status to: %j', buffer.slice(0, offset).toString('hex'))
     this.values.historyStatus = hexToBase64(value)
   }
 
@@ -313,6 +332,13 @@ class History extends ServiceDelegate {
     this.debug('send data: %s', dataStream)
     return hexToBase64(dataStream)
   }
+
+  // async _onGetConfig () {
+  //   return hexToBase64('D200')
+  // }
+
+  // async _onSetConfig () {
+  // }
 }
 
 module.exports = History

package/lib/UiServer.js

@@ -0,0 +1,237 @@
+// homebridge-deconz/homebridge-lib/UiServer.js
+//
+// Library for Homebridge plugins.
+// Copyright © 2022 Erik Baauw. All rights reserved.
+
+'use strict'
+
+const {
+  HomebridgePluginUiServer // , RequestError
+} = require('@homebridge/plugin-ui-utils')
+const { HttpClient, formatError } = require('../index')
+const chalk = require('chalk')
+const fs = require('fs/promises')
+const path = require('path')
+const util = require('util')
+
+/** Server for handling Homebridge Plugin UI requests.
+  *
+  * See {@link https://github.com/homebridge/plugin-ui-utils plugin-ui-utils}.
+  *
+  * The Homebridge Plugin UI Server runs in a separate process, which is spawned
+  * by the Homebridge UI when the plugin _Settings_ are opened.
+  * It implements an {@link HttpClient} to connect to the HTTP server provided
+  * by {@link Platform} to change plugin settings dynamically.
+  *
+  * `UiServer` implemensts the following requests, which are documented as events:
+  * - {@link UiServer#event:get get} - Send a GET request to the plugin instance.
+  * - {@link UiServer#event:put put} - Send a put request to the plugin instance.
+  * - {@link UiServer#event:cachedAccessories cachedAccessories} - Get the
+  * cachedAccessories for a (child) bridge instance.
+  * @extends HomebridgePluginUiServer
+  */
+class UiServer extends HomebridgePluginUiServer {
+  constructor () {
+    super()
+    this.clients = {}
+
+    /** Do a GET request to the plugin instance.
+      * @event UiServer#get
+      * @type {object}
+      * @property {integer} uiPort - The port of the plugin instance UI server.
+      * @property {string} resource - The requested resource.
+      * @returns {*} - The response body.
+      */
+    this.onRequest('get', async (params) => {
+      try {
+        const { uiPort, path } = params
+        const client = this._getClient(uiPort)
+        const { body } = await client.get(path)
+        return body
+      } catch (error) {
+        if (!(error instanceof HttpClient.HttpError)) {
+          this.error(error)
+        }
+      }
+    })
+
+    /** Do a PUT request to the plugin instance.
+      * @event UiServer#put
+      * @param {object}
+      * @property {integer} uiPort - The port of the plugin instance UI server.
+      * @property {string} resource - The requested resource.
+      * @property {*} body - The body of the request.
+      * @returns {HttpResponse} - The response.
+      */
+    this.onRequest('put', async (params) => {
+      try {
+        const { uiPort, path, body } = params
+        const client = this._getClient(uiPort)
+        const response = await client.put(path, JSON.stringify(body))
+        return response
+      } catch (error) {
+        if (!(error instanceof HttpClient.HttpError)) {
+          this.error(error)
+        }
+      }
+    })
+
+    /** Get the cached accessories for a single (child) bridge instance.
+      *
+      * This endpoint is needed because `homebridge.getCachedAccessories()` from
+      * `plugin-ui-utils` doesn't indicate to which child bridge an accessory
+      * belongs.
+      * @event UiServer#cachedAccessories
+      * @type {object}
+      * @property {?string} username - The virtual MAC address of the child
+      * bridge.  Use `null` for the main bridge.
+      * @returns {Object} cachedAccessories - The cached accessories.
+      */
+    this.onRequest('cachedAccessories', async (params) => {
+      try {
+        const { username } = params
+        let fileName = 'cachedAccessories'
+        if (username != null) {
+          fileName += '.' + username.replace(/:/g, '').toUpperCase()
+        }
+        const fullFileName = path.join(
+          this.homebridgeStoragePath,
+          'accessories',
+          fileName
+        )
+        const json = await fs.readFile(fullFileName)
+        const cachedAccessories = JSON.parse(json)
+        return cachedAccessories
+      } catch (error) {
+        this.error(error)
+      }
+      return []
+    })
+  }
+
+  _getClient (uiPort) {
+    if (this.clients[uiPort] == null) {
+      this.clients[uiPort] = new HttpClient({
+        host: 'localhost:' + uiPort,
+        json: true,
+        keepAlive: true
+      })
+      this.clients[uiPort]
+        .on('error', (error) => {
+          this.warn('request %d: %s', error.request.id, error)
+        })
+        .on('request', (request) => {
+          if (request.body == null) {
+            this.debug(
+              'request %d: %s %s', request.id, request.method, request.resource
+            )
+          } else {
+            this.debug(
+              'request %d: %s %s %j', request.id,
+              request.method, request.resource, request.body
+            )
+          }
+        })
+        .on('response', (response) => {
+          this.vdebug(
+            'request %d: response: %j', response.request.id, response.body
+          )
+          this.debug(
+            'request %d: %s %s', response.request.id,
+            response.statusCode, response.statusMessage
+          )
+        })
+    }
+    return this.clients[uiPort]
+  }
+
+  // ===== Logging =============================================================
+
+  /** Print debug message to stdout.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
+    */
+  debug (format, ...args) {
+    this._log({ chalk: chalk.grey }, format, ...args)
+  }
+
+  /** Print error message to stdout.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
+    */
+  error (format, ...args) {
+    this._log({ label: 'error', chalk: chalk.bold.red }, format, ...args)
+  }
+
+  /** Print log message to stdout.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
+    */
+  log (format, ...args) {
+    this._log({}, format, ...args)
+  }
+
+  /** Print verbose debug message to stdout.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
+    */
+  vdebug (format, ...args) {
+    this._log({ chalk: chalk.grey }, format, ...args)
+  }
+
+  /** Print very verbose debug message to stdout.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
+    */
+  vvdebug (format, ...args) {
+    this._log({ chalk: chalk.grey }, format, ...args)
+  }
+
+  /** Print warning message to stdout.
+    * @param {string|Error} format - The printf-style message or an instance of
+    * [Error](https://nodejs.org/dist/latest-v14.x/docs/api/errors.html#errors_class_error).
+    * @param {...string} args - Arguments to the printf-style message.
+    */
+  warn (format, ...args) {
+    this._log({ label: 'warning', chalk: chalk.yellow }, format, ...args)
+  }
+
+  // Do the heavy lifting for debug(), error(), fatal(), log(), and warn(),
+  // taking into account the options, and errors vs exceptions.
+  _log (params = {}, ...args) {
+    const output = process.stdout
+    let message = ''
+
+    // If last argument is Error convert it to string.
+    if (args.length > 0) {
+      let lastArg = args.pop()
+      if (lastArg instanceof Error) {
+        lastArg = formatError(lastArg, true)
+      }
+      args.push(lastArg)
+    }
+
+    // Format message.
+    if (args[0] == null) {
+      message = ''
+    } else if (typeof args[0] === 'string') {
+      message = util.format(...args)
+    } else {
+      message = util.format('%o', ...args)
+    }
+
+    // Handle colours.
+    if (params.chalk != null) {
+      message = params.chalk(message)
+    }
+
+    output.write(message)
+  }
+}
+
+module.exports = UiServer

package/package.json

@@ -3,7 +3,7 @@
   "description": "Library for homebridge plugins",
   "author": "Erik Baauw",
   "license": "Apache-2.0",
-  "version": "5.2.2",
+  "version": "5.3.0",
   "keywords": [
     "homekit",
     "homebridge"
@@ -22,9 +22,10 @@
   },
   "engines": {
     "homebridge": "^1.4.0",
-    "node": "^16.13.2"
+    "node": "^16.14.0"
   },
   "dependencies": {
+    "@homebridge/plugin-ui-utils": "~0.0.19",
     "bonjour-hap": "^3.6.3",
     "chalk": "^4.1.2",
     "semver": "^7.3.5"