Add handler for when a device has been saved. (#56)

References WebThingsIO/gateway#2109

lib/adapter.js

@@ -75,7 +75,7 @@ class Adapter {
   }
 
   /**
-   * @method deviceAdded
+   * @method handleDeviceAdded
    *
    * Called to indicate that a device is now being managed by this adapter.
    */
@@ -85,7 +85,7 @@ class Adapter {
   }
 
   /**
-   * @method deviceRemoved
+   * @method handleDeviceRemoved
    *
    * Called to indicate that a device is no longer managed by this adapter.
    */
@@ -94,6 +94,23 @@ class Adapter {
     this.manager.handleDeviceRemoved(device);
   }
 
+  /**
+   * @method handleDeviceSaved
+   *
+   * Called to indicate that the user has saved a device to their gateway. This
+   * is also called when the adapter starts up for every device which has
+   * already been saved.
+   *
+   * This can be used for keeping track of what devices have previously been
+   * discovered, such that the adapter can rebuild those, clean up old nodes,
+   * etc.
+   *
+   * @param {string} deviceId - ID of the device
+   * @param {object} device - the saved device description
+   */
+  handleDeviceSaved(_deviceId, _device) {
+  }
+
   // eslint-disable-next-line
   startPairing(timeoutSeconds) {
     console.log('Adapter:', this.name, 'id', this.id, 'pairing started');

lib/addon-manager-proxy.js

@@ -393,6 +393,9 @@ class AddonManagerProxy extends EventEmitter {
         adapter.unpairDevice(msg.data.deviceId);
         return;
 
+      case MessageType.DEVICE_SAVED_NOTIFICATION:
+        adapter.handleDeviceSaved(msg.data.deviceId, msg.data.device);
+        return;
     }
 
     // All messages from here on are assumed to require a valid deviceId.

package.json

@@ -28,7 +28,7 @@
   },
   "devDependencies": {
     "babel-eslint": "^10.0.3",
-    "eslint": "^6.4.0"
+    "eslint": "^6.6.0"
   },
   "files": [
     "LICENSE",