homey-api 3.0.10 → 3.0.12

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

@@ -1359,6 +1359,10 @@ export namespace HomeyAPIV3Local.ManagerVirtualDevice {
     id: string;
   }
 
+  export class VirtualDeviceMatter {
+    id: string;
+  }
+
   export class VirtualDeviceVirtualButton {
     id: string;
   }
@@ -1391,6 +1395,10 @@ export namespace HomeyAPIV3Local.ManagerVirtualDevice {
     id: string;
   }
 
+  export class VirtualDriverMatter {
+    id: string;
+  }
+
   export class VirtualDriverVirtualButton {
     id: string;
   }
@@ -1783,7 +1791,7 @@ export namespace HomeyAPIV3Cloud {
 
       id: string;
 
-      value: object;
+      value: any;
     }): Promise<any>;
 
     unsetAppSetting(opts: {
@@ -1955,7 +1963,7 @@ export namespace HomeyAPIV3Cloud {
 
       event: string;
 
-      data?: object;
+      data?: any;
     }): Promise<any>;
 
     emitPairingCallback(opts: {
@@ -1963,7 +1971,7 @@ export namespace HomeyAPIV3Cloud {
 
       callbackId: string;
 
-      data?: object;
+      data?: any;
     }): Promise<any>;
 
     createPairSessionDevice(opts: {
@@ -2138,10 +2146,22 @@ export namespace HomeyAPIV3Cloud {
 
     deleteFlowFolder(opts: { id: string }): Promise<any>;
 
+    getFlowCardTrigger(opts: {
+      id: string;
+
+      uri: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlow.FlowCardTrigger>;
+
     getFlowCardTriggers(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlow.FlowCardTrigger;
     }>;
 
+    getFlowCardCondition(opts: {
+      id: string;
+
+      uri: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlow.FlowCardCondition>;
+
     getFlowCardConditions(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlow.FlowCardCondition;
     }>;
@@ -2160,6 +2180,12 @@ export namespace HomeyAPIV3Cloud {
       droptoken?: string;
     }): Promise<any>;
 
+    getFlowCardAction(opts: {
+      id: string;
+
+      uri: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlow.FlowCardAction>;
+
     getFlowCardActions(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlow.FlowCardAction;
     }>;
@@ -2223,6 +2249,12 @@ export namespace HomeyAPIV3Cloud {
     getFlowTokens(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlowToken.FlowToken;
     }>;
+
+    getFlowToken(opts: {
+      id: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlowToken.FlowToken>;
+
+    getFlowTokenValue(opts: { id: string }): Promise<any>;
   }
 
   export class ManagerGeolocation extends HomeyAPIV3.ManagerGeolocation {
@@ -2238,12 +2270,6 @@ export namespace HomeyAPIV3Cloud {
 
     unsetOptionLocation(): Promise<any>;
 
-    getOptionMode(): Promise<any>;
-
-    setOptionMode(opts: { value: any }): Promise<any>;
-
-    unsetOptionMode(): Promise<any>;
-
     getState(): Promise<any>;
   }
 
@@ -2306,6 +2332,10 @@ export namespace HomeyAPIV3Cloud {
   export class ManagerLogic extends HomeyAPIV3.ManagerLogic {
     getState(): Promise<any>;
 
+    getVariable(opts: {
+      id: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerLogic.Variable>;
+
     getVariables(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerLogic.Variable;
     }>;
@@ -2396,6 +2426,8 @@ export namespace HomeyAPIV3Cloud {
       value?: boolean;
     }): Promise<any>;
 
+    getPresent(opts: { id: string }): Promise<any>;
+
     setAsleepMe(opts: {
       value?: boolean;
 
@@ -2409,6 +2441,8 @@ export namespace HomeyAPIV3Cloud {
 
       value?: boolean;
     }): Promise<any>;
+
+    getAsleep(opts: { id: string }): Promise<any>;
   }
 
   export class ManagerRF extends HomeyAPIV3.ManagerRF {
@@ -2572,6 +2606,8 @@ export namespace HomeyAPIV3Cloud {
 
     getZones(): Promise<{ [key: string]: HomeyAPIV3Cloud.ManagerZones.Zone }>;
 
+    getZone(opts: { id: string }): Promise<HomeyAPIV3Cloud.ManagerZones.Zone>;
+
     createZone(opts: {
       zone: {
         name: string;
@@ -3492,9 +3528,9 @@ export namespace HomeyAPIV3Local {
 
     getExperiments(): Promise<any>;
 
-    enableExperiment(opts: { experimentId: string }): Promise<any>;
+    enableExperiment(opts: { id: string }): Promise<any>;
 
-    disableExperiment(opts: { experimentId: string }): Promise<any>;
+    disableExperiment(opts: { id: string }): Promise<any>;
   }
 
   export class ManagerFlow extends HomeyAPIV3.ManagerFlow {
@@ -3828,6 +3864,12 @@ export namespace HomeyAPIV3Local {
   }
 
   export class ManagerMatter extends HomeyAPIV3.ManagerMatter {
+    getOptionPaaSettings(): Promise<any>;
+
+    setOptionPaaSettings(opts: { value: any }): Promise<any>;
+
+    unsetOptionPaaSettings(): Promise<any>;
+
     getState(): Promise<any>;
   }
 
@@ -3987,6 +4029,10 @@ export namespace HomeyAPIV3Local {
     rebootOTA(): Promise<any>;
 
     setDebug(opts: { namespace: string }): Promise<any>;
+
+    enableWifi(): Promise<any>;
+
+    disableWifi(): Promise<any>;
   }
 
   export class ManagerThread extends HomeyAPIV3.ManagerThread {

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

@@ -1409,6 +1409,10 @@ export namespace HomeyAPIV3Local.ManagerVirtualDevice {
     id: string;
   }
 
+  export class VirtualDeviceMatter {
+    id: string;
+  }
+
   export class VirtualDeviceVirtualButton {
     id: string;
   }
@@ -1441,6 +1445,10 @@ export namespace HomeyAPIV3Local.ManagerVirtualDevice {
     id: string;
   }
 
+  export class VirtualDriverMatter {
+    id: string;
+  }
+
   export class VirtualDriverVirtualButton {
     id: string;
   }
@@ -7545,7 +7553,7 @@ export namespace HomeyAPIV3Cloud {
 
       id: string;
 
-      value: object;
+      value: any;
     }): Promise<any>;
 
     unsetAppSetting(opts: {
@@ -7753,7 +7761,7 @@ export namespace HomeyAPIV3Cloud {
 
       event: string;
 
-      data?: object;
+      data?: any;
     }): Promise<any>;
 
     emitPairingCallback(opts: {
@@ -7761,7 +7769,7 @@ export namespace HomeyAPIV3Cloud {
 
       callbackId: string;
 
-      data?: object;
+      data?: any;
     }): Promise<any>;
 
     createPairSessionDevice(opts: {
@@ -7936,10 +7944,22 @@ export namespace HomeyAPIV3Cloud {
 
     deleteFlowFolder(opts: { id: string }): Promise<any>;
 
+    getFlowCardTrigger(opts: {
+      id: string;
+
+      uri: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlow.FlowCardTrigger>;
+
     getFlowCardTriggers(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlow.FlowCardTrigger;
     }>;
 
+    getFlowCardCondition(opts: {
+      id: string;
+
+      uri: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlow.FlowCardCondition>;
+
     getFlowCardConditions(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlow.FlowCardCondition;
     }>;
@@ -7958,6 +7978,12 @@ export namespace HomeyAPIV3Cloud {
       droptoken?: string;
     }): Promise<any>;
 
+    getFlowCardAction(opts: {
+      id: string;
+
+      uri: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlow.FlowCardAction>;
+
     getFlowCardActions(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlow.FlowCardAction;
     }>;
@@ -8021,6 +8047,12 @@ export namespace HomeyAPIV3Cloud {
     getFlowTokens(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerFlowToken.FlowToken;
     }>;
+
+    getFlowToken(opts: {
+      id: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerFlowToken.FlowToken>;
+
+    getFlowTokenValue(opts: { id: string }): Promise<any>;
   }
 
   export class ManagerGeolocation extends HomeyAPIV3.ManagerGeolocation {
@@ -8036,12 +8068,6 @@ export namespace HomeyAPIV3Cloud {
 
     unsetOptionLocation(): Promise<any>;
 
-    getOptionMode(): Promise<any>;
-
-    setOptionMode(opts: { value: any }): Promise<any>;
-
-    unsetOptionMode(): Promise<any>;
-
     getState(): Promise<any>;
   }
 
@@ -8104,6 +8130,10 @@ export namespace HomeyAPIV3Cloud {
   export class ManagerLogic extends HomeyAPIV3.ManagerLogic {
     getState(): Promise<any>;
 
+    getVariable(opts: {
+      id: string;
+    }): Promise<HomeyAPIV3Cloud.ManagerLogic.Variable>;
+
     getVariables(): Promise<{
       [key: string]: HomeyAPIV3Cloud.ManagerLogic.Variable;
     }>;
@@ -8194,6 +8224,8 @@ export namespace HomeyAPIV3Cloud {
       value?: boolean;
     }): Promise<any>;
 
+    getPresent(opts: { id: string }): Promise<any>;
+
     setAsleepMe(opts: {
       value?: boolean;
 
@@ -8207,6 +8239,8 @@ export namespace HomeyAPIV3Cloud {
 
       value?: boolean;
     }): Promise<any>;
+
+    getAsleep(opts: { id: string }): Promise<any>;
   }
 
   export class ManagerRF extends HomeyAPIV3.ManagerRF {
@@ -8363,6 +8397,14 @@ export namespace HomeyAPIV3Cloud {
 
       opts?: object;
     }): Promise<any>;
+
+    verifyFirmware(): Promise<any>;
+
+    flashFirmware(opts: { keepNV: boolean }): Promise<any>;
+
+    getLastFlashResult(): Promise<any>;
+
+    eraseNV(): Promise<any>;
   }
 
   export class ManagerZones extends HomeyAPIV3.ManagerZones {
@@ -8370,6 +8412,8 @@ export namespace HomeyAPIV3Cloud {
 
     getZones(): Promise<{ [key: string]: HomeyAPIV3Cloud.ManagerZones.Zone }>;
 
+    getZone(opts: { id: string }): Promise<HomeyAPIV3Cloud.ManagerZones.Zone>;
+
     createZone(opts: {
       zone: {
         name: string;
@@ -9356,9 +9400,9 @@ export namespace HomeyAPIV3Local {
 
     getExperiments(): Promise<any>;
 
-    enableExperiment(opts: { experimentId: string }): Promise<any>;
+    enableExperiment(opts: { id: string }): Promise<any>;
 
-    disableExperiment(opts: { experimentId: string }): Promise<any>;
+    disableExperiment(opts: { id: string }): Promise<any>;
   }
 
   export class ManagerFlow extends HomeyAPIV3.ManagerFlow {
@@ -9692,7 +9736,27 @@ export namespace HomeyAPIV3Local {
   }
 
   export class ManagerMatter extends HomeyAPIV3.ManagerMatter {
+    getOptionPaaSettings(): Promise<any>;
+
+    setOptionPaaSettings(opts: { value: any }): Promise<any>;
+
+    unsetOptionPaaSettings(): Promise<any>;
+
     getState(): Promise<any>;
+
+    pairApi(opts: {
+      code: string;
+
+      zone?: string;
+    }): Promise<any>;
+
+    updateDCLPaaCerts(): Promise<any>;
+
+    interview(opts: { nodeId: string }): Promise<any>;
+
+    makeDeviceApi(opts: { nodeId: string }): Promise<any>;
+
+    readBasicInformation(opts: { nodeId: string }): Promise<any>;
   }
 
   export class ManagerMobile extends HomeyAPIV3.ManagerMobile {
@@ -9851,6 +9915,10 @@ export namespace HomeyAPIV3Local {
     rebootOTA(): Promise<any>;
 
     setDebug(opts: { namespace: string }): Promise<any>;
+
+    enableWifi(): Promise<any>;
+
+    disableWifi(): Promise<any>;
   }
 
   export class ManagerThread extends HomeyAPIV3.ManagerThread {
@@ -10009,6 +10077,8 @@ export namespace HomeyAPIV3Local {
     getLog(): Promise<any>;
 
     setLogEnabled(opts: { enabled: boolean }): Promise<any>;
+
+    setLBTThreshold(opts: { threshold: number }): Promise<any>;
   }
 }
 

package/lib/AthomCloudAPI/User.js

@@ -40,6 +40,7 @@ class User extends APIDefinition {
    */
   getHomeyById(id) {
     const homey = this.homeys.find(homey => homey.id === id);
+
     if (!homey) {
       throw new Error(`Homey Not Found: ${id}`);
     }
@@ -52,6 +53,7 @@ class User extends APIDefinition {
    */
   getFirstHomey() {
     const homey = this.homeys[0];
+    
     if (!homey) {
       throw new Error('No Homey Available');
     }

package/lib/AthomCloudAPI.js

@@ -126,17 +126,10 @@ for(const {@link HomeyAPIV2.ManagerDevices.Device device} of Object.values(devic
    */
   async isLoggedIn() {
     const store = await this.__getStore();
-    if (!store.token
-      || !store.token.access_token) return false;
 
-    try {
-      this.__user = await this.getAuthenticatedUser({
-        $cache: false,
-      });
-      return true;
-    } catch (err) {
-      return false;
-    }
+    if (!store.token || !store.token.access_token) return false;
+
+    return true;
   }
 
   /**
@@ -145,20 +138,56 @@ for(const {@link HomeyAPIV2.ManagerDevices.Device device} of Object.values(devic
    * @param {object} [opts.$cache=true] - Use the cache
    * @returns {Promise<AthomCloudAPI.User>}
    */
-  async getAuthenticatedUser({
-    $cache = true,
-  } = {}) {
+  async getAuthenticatedUser({ $cache = true } = {}) {
     if ($cache === true && this.__user instanceof User) {
       return this.__user;
     }
 
+    const properties = await this.call({
+      method: 'get',
+      path: '/user/me',
+    });
+
     this.__user = new User({
       api: this,
-      properties: await this.call({
-        method: 'get',
-        path: '/user/me',
-      }),
+      properties: properties,
     });
+  
+    return this.__user;
+  }
+
+  async getAuthenticatedUserFromStore({ $cache = true } = {}) {
+    if ($cache === true && this.__user instanceof User) {
+      return this.__user;
+    }
+
+    if ($cache === true && this.__user == null) {
+      const store = await this.__getStore();
+
+      if (store.user) {
+        this.__user = new User({
+          api: this,
+          properties: store.user,
+        });
+
+        return this.__user;
+      }
+    }
+
+    const properties = await this.call({
+      method: 'get',
+      path: '/user/me',
+    });
+
+    this.__user = new User({
+      api: this,
+      properties: properties,
+    });
+
+    await this.__setStore({
+      user: properties,
+    })
+
     return this.__user;
   }
 
@@ -201,6 +230,31 @@ for(const {@link HomeyAPIV2.ManagerDevices.Device device} of Object.values(devic
     return `${this.baseUrl}/oauth2/authorise?${search.toString()}`;
   }
 
+  async getDelegatedLoginUrl(args = {}) {
+    if (args.baseUrl == null) {
+      throw new TypeError('baseUrl is required');
+    }
+
+    const token = await this.createDelegationToken({
+      audience: args.audience,
+      meta: args.meta,
+    });
+
+    const search = new URLSearchParams();
+    search.append('user_token', token);
+
+    if (typeof args.state === 'string') {
+      search.append('state', args.state);
+    }
+
+    if (typeof args.resource === 'string') {
+      search.append('resource', args.resource);
+    }
+
+    const seperator = args.baseUrl.indexOf('?') >= 0 ? '&' : '?';
+    return args.baseUrl + seperator + search.toString();
+  }
+
   /**
    * Logout and delete the local token.
    * @returns {Promise<void>}

package/lib/EventEmitter.js

@@ -70,6 +70,7 @@ class EventEmitter {
    * @param {function} callback
    */
   off(event, callback) {
+    this.__listeners[event] = this.__listeners[event] || [];
     this.__listeners[event] = this.__listeners[event].filter(cb => cb !== callback);
 
     return this;

package/lib/HomeyAPI/HomeyAPIV2/ManagerDevices/Device.js

@@ -13,7 +13,6 @@ class Device extends DeviceV3 {
     delete item.zoneName;
     return item;
   }
-
 }
 
 module.exports = Device;

package/lib/HomeyAPI/HomeyAPIV2/ManagerDrivers/Driver.js

@@ -19,7 +19,7 @@ class Driver extends DriverV3 {
 
     return item;
   }
-
+  
 }
 
 module.exports = Driver;