homey-api 1.10.17 → 3.0.0-rc.2

package/index.js

@@ -20,5 +20,5 @@ module.exports = {
   AthomWeatherAPI: require('./lib/AthomWeatherAPI'),
   AthomWebhooksAPI: require('./lib/AthomWebhooksAPI'),
   HomeyCloudAPI: require('./lib/HomeyCloudAPI'),
-  HomeyAPIApp: require('./lib/HomeyAPI/HomeyAPIApp'),
+  HomeyAPI: require('./lib/HomeyAPI/HomeyAPI'),
 };

package/lib/APIErrorNotFound.js

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

package/lib/AthomCloudAPI/Homey.js

@@ -41,8 +41,10 @@ class Homey extends APIDefinition {
     const homey = new HomeyAPI({
       strategy,
       api: this.__api,
-      debug: this.__api.__debugEnabled,
       properties: this.__properties,
+      debug: (...props) => {
+        return this.__api.__debug(`[${HomeyAPI.name}:${this.__properties.id}]`, ...props);
+      },
     });
 
     await homey.login();

package/lib/EventEmitter.js

@@ -43,8 +43,6 @@ class EventEmitter {
    * @param {function} callback
    */
   on(event, callback) {
-    this.__debug(`.on('${event}')`);
-
     this.__listeners[event] = this.__listeners[event] || [];
     this.__listeners[event].push(callback);
 
@@ -56,8 +54,6 @@ class EventEmitter {
    * @param {function} callback
    */
   once(event, callback) {
-    this.__debug(`.once('${event}')`);
-
     const callback_ = (...args) => {
       this.__listeners[event] = this.__listeners[event].filter(cb => cb !== callback_);
       callback(...args);
@@ -74,8 +70,6 @@ class EventEmitter {
    * @param {function} callback
    */
   off(event, callback) {
-    this.__debug(`.off('${event}')`);
-
     this.__listeners[event] = this.__listeners[event].filter(cb => cb !== callback);
 
     return this;

package/lib/HomeyAPI/HomeyAPI.js

@@ -27,11 +27,11 @@ class HomeyAPI {
   constructor({
     api,
     properties,
-    debug = false,
+    debug = () => { },
   }) {
     // Set Debug Enabled
-    Object.defineProperty(this, '__debugEnabled', {
-      value: !!debug,
+    Object.defineProperty(this, '__debugFunction', {
+      value: debug,
       enumerable: false,
       writable: true,
     });
@@ -45,7 +45,7 @@ class HomeyAPI {
 
     // Set ID
     Object.defineProperty(this, 'id', {
-      value: properties._id || null,
+      value: properties.id || properties._id || null,
       enumerable: true,
       writable: true,
     });
@@ -66,7 +66,8 @@ class HomeyAPI {
   }
 
   __debug(...props) {
-    this.__api.__debug(`[${this.constructor.name}:${this.id}]`, ...props);
+    if (!this.__debugFunction) return;
+    this.__debugFunction(...props);
   }
 
   /*
@@ -124,6 +125,49 @@ class HomeyAPI {
     return null;
   }
 
+  /**
+   * Create a {@link HomeyAPIV3Local} instance for use in the Apps SDK.
+   * @param {Object} opts
+   * @param {Homey} opts.homey — Homey instance
+   * @param {Function} opts.debug — Debug method, defaults to `homey.app.log`
+   */
+  static async createAppAPI({
+    homey,
+    debug = (...props) => homey.app.log('[homey-api]', ...props),
+  } = {}) {
+    if (!homey) {
+      throw new Error('Invalid Homey');
+    }
+
+    const props = {
+      debug,
+      token: await homey.api.getOwnerApiToken(),
+      baseUrl: await homey.api.getLocalUrl(),
+      strategy: [],
+      properties: {
+        id: await homey.cloud.getHomeyId(),
+        softwareVersion: homey.version,
+      },
+    };
+
+    if (homey.platform === 'local' && homey.platformVersion === 1) {
+      const HomeyAPIV2 = require('./HomeyAPIV2');
+      return new HomeyAPIV2(props);
+    }
+
+    if (homey.platform === 'local' && homey.platformVersion === 2) {
+      const HomeyAPIV3Local = require('./HomeyAPIV3Local');
+      return new HomeyAPIV3Local(props);
+    }
+
+    if (homey.platform === 'cloud' && homey.platformVersion === 2) {
+      const HomeyAPIV3Cloud = require('./HomeyAPIV3Cloud');
+      return new HomeyAPIV3Cloud(props);
+    }
+
+    throw new Error(`Invalid Homey Platform Version: ${homey.platformVersion}`);
+  }
+
 }
 
 module.exports = HomeyAPI;

package/lib/HomeyAPI/HomeyAPIErrorNotFound.js

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