homey-api 3.0.0-rc.14 → 3.0.0-rc.16

package/assets/types/homey-api.d.ts

@@ -287,6 +287,33 @@
   
 
         
+      ):
+        Promise<any>;
+    
+      createLocalAPI(
+        
+          
+  
+    
+      opts: {
+  
+    
+      address: String,
+    
+  
+    
+      token: String,
+    
+  
+    
+      debug: function | null,
+    
+  
+},
+    
+  
+
+        
       ):
         Promise<any>;
     

package/assets/types/homey-api.private.d.ts

@@ -5402,6 +5402,33 @@
   
 
         
+      ):
+        Promise<any>;
+    
+      createLocalAPI(
+        
+          
+  
+    
+      opts: {
+  
+    
+      address: String,
+    
+  
+    
+      token: String,
+    
+  
+    
+      debug: function | null,
+    
+  
+},
+    
+  
+
+        
       ):
         Promise<any>;
     

package/index.js

@@ -2,23 +2,22 @@
 
 'use strict';
 
-module.exports = {
-  AthomAppsAPI: require('./lib/AthomAppsAPI'),
-  AthomBackupAPI: require('./lib/AthomBackupAPI'),
-  AthomCallbackAPI: require('./lib/AthomCallbackAPI'),
-  AthomCloudAPI: require('./lib/AthomCloudAPI'),
-  AthomConnectAPI: require('./lib/AthomConnectAPI'),
-  AthomDNSAPI: require('./lib/AthomDNSAPI'),
-  AthomFirmwareAPI: require('./lib/AthomFirmwareAPI'),
-  AthomFlowAPI: require('./lib/AthomFlowAPI'),
-  AthomGeolocateAPI: require('./lib/AthomGeolocateAPI'),
-  AthomIconsAPI: require('./lib/AthomIconsAPI'),
-  AthomInfraredAPI: require('./lib/AthomInfraredAPI'),
-  AthomNotificationsAPI: require('./lib/AthomNotificationsAPI'),
-  AthomSetupAPI: require('./lib/AthomSetupAPI'),
-  AthomStoreAPI: require('./lib/AthomStoreAPI'),
-  AthomWeatherAPI: require('./lib/AthomWeatherAPI'),
-  AthomWebhooksAPI: require('./lib/AthomWebhooksAPI'),
-  HomeyCloudAPI: require('./lib/HomeyCloudAPI'),
-  HomeyAPI: require('./lib/HomeyAPI/HomeyAPI'),
-};
+module.exports = {};
+module.exports.AthomAppsAPI = require('./lib/AthomAppsAPI');
+module.exports.AthomBackupAPI = require('./lib/AthomBackupAPI');
+module.exports.AthomCallbackAPI = require('./lib/AthomCallbackAPI');
+module.exports.AthomCloudAPI = require('./lib/AthomCloudAPI');
+module.exports.AthomConnectAPI = require('./lib/AthomConnectAPI');
+module.exports.AthomDNSAPI = require('./lib/AthomDNSAPI');
+module.exports.AthomFirmwareAPI = require('./lib/AthomFirmwareAPI');
+module.exports.AthomFlowAPI = require('./lib/AthomFlowAPI');
+module.exports.AthomGeolocateAPI = require('./lib/AthomGeolocateAPI');
+module.exports.AthomIconsAPI = require('./lib/AthomIconsAPI');
+module.exports.AthomInfraredAPI = require('./lib/AthomInfraredAPI');
+module.exports.AthomNotificationsAPI = require('./lib/AthomNotificationsAPI');
+module.exports.AthomSetupAPI = require('./lib/AthomSetupAPI');
+module.exports.AthomStoreAPI = require('./lib/AthomStoreAPI');
+module.exports.AthomWeatherAPI = require('./lib/AthomWeatherAPI');
+module.exports.AthomWebhooksAPI = require('./lib/AthomWebhooksAPI');
+module.exports.HomeyCloudAPI = require('./lib/HomeyCloudAPI');
+module.exports.HomeyAPI = require('./lib/HomeyAPI/HomeyAPI');

package/lib/HomeyAPI/HomeyAPI.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const Util = require('../Util');
+
 /**
  * A Homey API, to be extended.
  * @hideconstructor
@@ -126,10 +128,10 @@ class HomeyAPI {
   }
 
   /**
-   * Create a {@link HomeyAPIV3Local} instance for use in the Apps SDK.
+   * Creates a {@link HomeyAPIV3Local} or {@link HomeyAPIV2} instance for use in the Apps SDK.
    * @param {Object} opts
-   * @param {Homey} opts.homey — Homey instance
-   * @param {Function|null} opts.debug — Debug function, defaults to `null`
+   * @param {Homey} opts.homey — Homey (Apps SDK) instance.
+   * @param {Function|null} opts.debug — Debug function, defaults to `null`.
    */
   static async createAppAPI({
     homey,
@@ -172,6 +174,53 @@ class HomeyAPI {
     throw new Error(`Invalid Homey Platform Version: ${homey.platformVersion}`);
   }
 
+  /**
+   * Creates a {@link HomeyAPIV3Local} instance for use in a project.
+   * @param {Object} opts
+   * @param {String} opts.address — The address of the Homey, e.g. `http://192.168.1.123:80`.
+   * @param {String} opts.token — A Personal Access Token created in the Homey Web App.
+   * @param {Function|null} opts.debug — Debug function, defaults to `null`.
+   * @example
+   * import { HomeyAPI } from 'homey-api';
+   * const homeyApi = await HomeyAPI.createLocalAPI({
+   *   address: 'http://192.169.1.123',
+   *   token: '<my_personal_access_token>',
+   * });
+   * const devices = await homeyApi.devices.getDevices();
+   */
+  static async createLocalAPI({
+    address,
+    token,
+    debug = null,
+  }) {
+    if (!address) {
+      throw new Error('Invalid Address');
+    }
+
+    if (!token) {
+      throw new Error('Invalid Token');
+    }
+
+    const res = await Util.fetch(`${address}/api/manager/system/ping`);
+    if (!res.headers.has('X-Homey-ID')) {
+      throw new Error(`No Homey Found At Address: ${address}`);
+    }
+
+    const props = {
+      token,
+      debug: debug ?? function debug() { },
+      baseUrl: address,
+      strategy: [],
+      properties: {
+        id: res.headers.get('X-Homey-ID'),
+        softwareVersion: res.headers.get('X-Homey-Version'),
+      },
+    };
+
+    const HomeyAPIV3Local = require('./HomeyAPIV3Local');
+    return new HomeyAPIV3Local(props);
+  }
+
 }
 
 module.exports = HomeyAPI;

package/lib/HomeyAPI/HomeyAPIV3/Manager.js

@@ -424,7 +424,7 @@ class Manager extends EventEmitter {
                   });
                   this.__cache[itemId][data.id] = item;
 
-                  break;
+                  return this.emit(event, item);
                 }
                 case 'update': {
                   data = Item.transformGet(data);
@@ -432,6 +432,7 @@ class Manager extends EventEmitter {
                   if (this.__cache[itemId][data.id]) {
                     const item = this.__cache[itemId][data.id];
                     item.__update(data);
+                    return this.emit(event, item);
                   }
 
                   break;
@@ -443,6 +444,9 @@ class Manager extends EventEmitter {
                     const item = this.__cache[itemId][data.id];
                     item.__delete();
                     delete this.__cache[itemId][item.id];
+                    return this.emit(event, {
+                      id: item.id,
+                    });
                   }
 
                   break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homey-api",
-  "version": "3.0.0-rc.14",
+  "version": "3.0.0-rc.16",
   "description": "Homey API",
   "main": "index.js",
   "files": [