homey-api 1.5.9 → 1.5.12

package/lib/APIErrorTimeout.js

@@ -0,0 +1,21 @@
+/* eslint-disable camelcase */
+
+'use strict';
+
+const APIError = require('./APIError');
+
+/**
+ * @class
+ * @hideconstructor
+ * @extends APIError
+ * @memberof HomeyAPI
+ */
+class APIErrorTimeout extends APIError {
+
+  constructor(message, statusCode = 408) {
+    super(message, statusCode);
+  }
+
+}
+
+module.exports = APIErrorTimeout;

package/lib/EventEmitter.js

@@ -26,6 +26,16 @@ class EventEmitter {
         listener(...data);
       });
     }
+
+    return this;
+  }
+
+  /**
+   * @param {string} event
+   * @param {function} callback
+   */
+  addListener(event, callback) {
+    return this.on(event, callback);
   }
 
   /**
@@ -37,6 +47,8 @@ class EventEmitter {
 
     this.__listeners[event] = this.__listeners[event] || [];
     this.__listeners[event].push(callback);
+
+    return this;
   }
 
   /**
@@ -53,6 +65,8 @@ class EventEmitter {
 
     this.__listeners[event] = this.__listeners[event] || [];
     this.__listeners[event].push(callback_);
+
+    return this;
   }
 
   /**
@@ -63,6 +77,8 @@ class EventEmitter {
     this.__debug(`.off('${event}')`);
 
     this.__listeners[event] = this.__listeners[event].filter(cb => cb !== callback);
+
+    return this;
   }
 
   /**
@@ -71,7 +87,7 @@ class EventEmitter {
    * @param {function} callback
    */
   removeListener(event, callback) {
-    this.off(event, callback);
+    return this.off(event, callback);
   }
 
   /**
@@ -79,6 +95,8 @@ class EventEmitter {
    */
   removeAllListeners(event) {
     this.__listeners[event] = [];
+
+    return this;
   }
 
 }

package/lib/HomeyAPI/HomeyAPIV2/Device.js

@@ -76,7 +76,16 @@ class Device extends Item {
    * @returns {Promise<void>}
    * @function HomeyAPIV2.ManagerDevices.Device#setCapabilityValue
    */
-  async setCapabilityValue({
+  async setCapabilityValue(options, ...args) {
+    // Legacy compatibility from node-athom-api
+    if (typeof options === 'string') {
+      return this.setCapabilityValueLegacy(options, ...args);
+    }
+
+    return this.__setCapabilityValue(options);
+  }
+
+  async __setCapabilityValue({
     capabilityId,
     value,
     opts,
@@ -93,6 +102,14 @@ class Device extends Item {
     });
   }
 
+  async setCapabilityValueLegacy(capabilityId, value, opts) {
+    return this.__setCapabilityValue({
+      capabilityId,
+      value,
+      opts,
+    });
+  }
+
   async connect() {
     this.__debug('connect');
 

package/lib/HomeyAPI/HomeyAPIV2/Manager.js

@@ -215,15 +215,15 @@ class Manager extends EventEmitter {
                 case 'getAll': {
                   // If array (uri + id)
                   if (this.__cache[itemId]
-                   && this.__cacheAllComplete[itemId]
-                   && itemType === 'filter') {
+                    && this.__cacheAllComplete[itemId]
+                    && itemType === 'filter') {
                     this.__debug(`Serving ${itemId}:all from cache`);
                     return Object.values(this.__cache[itemId]);
                   }
 
                   // If object (id)
                   if (this.__cache[itemId]
-                   && this.__cacheAllComplete[itemId]) {
+                    && this.__cacheAllComplete[itemId]) {
                     this.__debug(`Serving ${itemId}:all from cache`);
                     return this.__cache[itemId];
                   }
@@ -382,8 +382,8 @@ class Manager extends EventEmitter {
 
           // Transform & add to cache if this is a CRUD event
           if (event.endsWith('.create')
-           || event.endsWith('.update')
-           || event.endsWith('.delete')) {
+            || event.endsWith('.update')
+            || event.endsWith('.delete')) {
             const [itemId, operation] = event.split('.');
             const ItemClass = this.constructor.ITEMS[itemId] || Item;
             const itemType = this.__itemsById[itemId].type;
@@ -449,6 +449,18 @@ class Manager extends EventEmitter {
     }
   }
 
+  destroy() {
+    for (const id of Object.keys(this.__cache)) {
+      this.__cache[id] = {};
+    }
+
+    for (const id of Object.keys(this.__cacheAllComplete)) {
+      this.__cacheAllComplete[id] = false;
+    }
+
+    this.disconnect().catch(() => { });
+  }
+
 }
 
 module.exports = Manager;

package/lib/Util.js

@@ -2,6 +2,8 @@
 
 'use strict';
 
+const APIErrorTimeout = require('./APIErrorTimeout');
+
 /**
  * Helper Utility Class
  * @class
@@ -43,7 +45,7 @@ class Util {
    * @returns {Promise}
    */
   static async timeout(promise, timeoutMillis = 5000, message = `Timeout after ${timeoutMillis}ms`) {
-    const timeoutError = new Error(message);
+    const timeoutError = new APIErrorTimeout(message);
     let timeoutRef;
     return Promise.race([
       promise,
@@ -86,6 +88,13 @@ class Util {
     return (typeof window !== 'undefined');
   }
 
+  /**
+   * @returns {boolean}
+   */
+  static isNodeJS() {
+    return (typeof process !== 'undefined');
+  }
+
   /**
    * @param {string} name - Query parameter name
    * @returns {string|null}
@@ -148,7 +157,11 @@ class Util {
       return window.localStorage.getItem(key) || null;
     }
 
-    return process.env[key] || null;
+    if (this.isNodeJS()) {
+      return process.env[key] || null;
+    }
+
+    return null;
   }
 
   static envKey(key) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homey-api",
-  "version": "1.5.9",
+  "version": "1.5.12",
   "description": "Homey API",
   "main": "src/index.js",
   "types": "assets/types/homey-api.d.ts",