homey-api 3.8.0 → 3.10.0

package/assets/specifications/AthomCloudAPI.json

@@ -599,6 +599,32 @@
         }
       }
     },
+    "getAuthenticatedUserNewsletterStatus": {
+      "path": "/user/me/newsletter",
+      "method": "get",
+      "parameters": {}
+    },
+    "subscribeAuthenticatedUserToNewsletter": {
+      "path": "/user/me/newsletter",
+      "method": "post",
+      "parameters": {
+        "data": {
+          "in": "body",
+          "type": "object",
+          "unpack": true,
+          "properties": {
+            "language": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "unsubscribeAuthenticatedUserFromNewsletter": {
+      "path": "/user/me/newsletter",
+      "method": "delete",
+      "parameters": {}
+    },
     "getBridges": {
       "path": "/bridge/",
       "method": "get",

package/assets/specifications/HomeyAPIV3Cloud.json

@@ -1313,8 +1313,145 @@
     "ManagerEnergy": {
       "id": "energy",
       "idCamelCase": "energy",
-      "items": {},
+      "items": {
+        "EnergyReportHour": {
+          "id": "energyreporthour",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportDay": {
+          "id": "energyreportday",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportWeek": {
+          "id": "energyreportweek",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportMonth": {
+          "id": "energyreportmonth",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportYear": {
+          "id": "energyreportyear",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
       "operations": {
+        "getOptionElectricityPriceFixed": {
+          "method": "GET",
+          "path": "/option/electricityPriceFixed",
+          "scopes": [
+            "homey.energy.readonly"
+          ]
+        },
+        "setOptionElectricityPriceFixed": {
+          "method": "PUT",
+          "path": "/option/electricityPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "value": {
+              "in": "body",
+              "required": true
+            }
+          }
+        },
+        "unsetOptionElectricityPriceFixed": {
+          "method": "DELETE",
+          "path": "/option/electricityPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ]
+        },
+        "getOptionGasPriceFixed": {
+          "method": "GET",
+          "path": "/option/gasPriceFixed",
+          "scopes": [
+            "homey.energy.readonly"
+          ]
+        },
+        "setOptionGasPriceFixed": {
+          "method": "PUT",
+          "path": "/option/gasPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "value": {
+              "in": "body",
+              "required": true
+            }
+          }
+        },
+        "unsetOptionGasPriceFixed": {
+          "method": "DELETE",
+          "path": "/option/gasPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ]
+        },
+        "getOptionWaterPriceFixed": {
+          "method": "GET",
+          "path": "/option/waterPriceFixed",
+          "scopes": [
+            "homey.energy.readonly"
+          ]
+        },
+        "setOptionWaterPriceFixed": {
+          "method": "PUT",
+          "path": "/option/waterPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "value": {
+              "in": "body",
+              "required": true
+            }
+          }
+        },
+        "unsetOptionWaterPriceFixed": {
+          "method": "DELETE",
+          "path": "/option/waterPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ]
+        },
         "getState": {
           "method": "get",
           "path": "/state",
@@ -1329,7 +1466,7 @@
           "path": "/live",
           "private": false,
           "scopes": [
-            "homey.insights.readonly"
+            "homey.energy.readonly"
           ],
           "parameters": {
             "zone": {
@@ -1337,6 +1474,150 @@
               "type": "string"
             }
           }
+        },
+        "getReportDay": {
+          "method": "get",
+          "path": "/report/day",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "date": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportWeek": {
+          "method": "get",
+          "path": "/report/week",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "isoWeek": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportMonth": {
+          "method": "get",
+          "path": "/report/month",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "yearMonth": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportYear": {
+          "method": "get",
+          "path": "/report/year",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "year": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportsAvailable": {
+          "method": "get",
+          "path": "/reports/available",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {}
+        },
+        "getCurrency": {
+          "method": "get",
+          "path": "/currency",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {}
+        },
+        "deleteReports": {
+          "method": "delete",
+          "path": "/reports",
+          "private": false,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {}
+        },
+        "resetReportDayCategories": {
+          "method": "put",
+          "path": "/report/day/reset/categories",
+          "private": false,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "options": {
+              "in": "body",
+              "type": "object",
+              "required": true,
+              "properties": {
+                "date": {
+                  "type": "string"
+                },
+                "categories": {
+                  "type": "array"
+                },
+                "deviceIds": {
+                  "type": "array"
+                }
+              }
+            }
+          }
+        },
+        "enableDummyEnergyReports": {
+          "method": "post",
+          "path": "/reports/dummy/enable",
+          "private": true,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "fromDate": {
+              "in": "query",
+              "type": "string"
+            },
+            "toDate": {
+              "in": "query",
+              "type": "string"
+            },
+            "randomness": {
+              "in": "query",
+              "type": "string"
+            },
+            "numTopConsumers": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "disableDummyEnergyReports": {
+          "method": "post",
+          "path": "/reports/dummy/disable",
+          "private": true,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {}
         }
       }
     },
@@ -1479,6 +1760,10 @@
             "persistent": {
               "in": "body",
               "type": "boolean"
+            },
+            "dataRequestActiveState": {
+              "in": "body",
+              "type": "string"
             }
           }
         },
@@ -4456,6 +4741,30 @@
               "type": "object"
             }
           }
+        },
+        "getLog": {
+          "method": "get",
+          "path": "/log",
+          "private": false,
+          "scopes": [
+            "homey.system"
+          ],
+          "parameters": {}
+        },
+        "setLogEnabled": {
+          "method": "put",
+          "path": "/log",
+          "private": false,
+          "scopes": [
+            "homey.system"
+          ],
+          "parameters": {
+            "enabled": {
+              "in": "body",
+              "type": "boolean",
+              "required": true
+            }
+          }
         }
       }
     },
@@ -4537,4 +4846,4 @@
       }
     }
   }
-}
+}

package/assets/specifications/HomeyAPIV3Local.json

@@ -1734,8 +1734,145 @@
     "ManagerEnergy": {
       "id": "energy",
       "idCamelCase": "energy",
-      "items": {},
+      "items": {
+        "EnergyReportHour": {
+          "id": "energyreporthour",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportDay": {
+          "id": "energyreportday",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportWeek": {
+          "id": "energyreportweek",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportMonth": {
+          "id": "energyreportmonth",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "EnergyReportYear": {
+          "id": "energyreportyear",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
       "operations": {
+        "getOptionElectricityPriceFixed": {
+          "method": "GET",
+          "path": "/option/electricityPriceFixed",
+          "scopes": [
+            "homey.energy.readonly"
+          ]
+        },
+        "setOptionElectricityPriceFixed": {
+          "method": "PUT",
+          "path": "/option/electricityPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "value": {
+              "in": "body",
+              "required": true
+            }
+          }
+        },
+        "unsetOptionElectricityPriceFixed": {
+          "method": "DELETE",
+          "path": "/option/electricityPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ]
+        },
+        "getOptionGasPriceFixed": {
+          "method": "GET",
+          "path": "/option/gasPriceFixed",
+          "scopes": [
+            "homey.energy.readonly"
+          ]
+        },
+        "setOptionGasPriceFixed": {
+          "method": "PUT",
+          "path": "/option/gasPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "value": {
+              "in": "body",
+              "required": true
+            }
+          }
+        },
+        "unsetOptionGasPriceFixed": {
+          "method": "DELETE",
+          "path": "/option/gasPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ]
+        },
+        "getOptionWaterPriceFixed": {
+          "method": "GET",
+          "path": "/option/waterPriceFixed",
+          "scopes": [
+            "homey.energy.readonly"
+          ]
+        },
+        "setOptionWaterPriceFixed": {
+          "method": "PUT",
+          "path": "/option/waterPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "value": {
+              "in": "body",
+              "required": true
+            }
+          }
+        },
+        "unsetOptionWaterPriceFixed": {
+          "method": "DELETE",
+          "path": "/option/waterPriceFixed",
+          "scopes": [
+            "homey.energy"
+          ]
+        },
         "getState": {
           "method": "get",
           "path": "/state",
@@ -1750,7 +1887,7 @@
           "path": "/live",
           "private": false,
           "scopes": [
-            "homey.insights.readonly"
+            "homey.energy.readonly"
           ],
           "parameters": {
             "zone": {
@@ -1758,6 +1895,150 @@
               "type": "string"
             }
           }
+        },
+        "getReportDay": {
+          "method": "get",
+          "path": "/report/day",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "date": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportWeek": {
+          "method": "get",
+          "path": "/report/week",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "isoWeek": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportMonth": {
+          "method": "get",
+          "path": "/report/month",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "yearMonth": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportYear": {
+          "method": "get",
+          "path": "/report/year",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {
+            "year": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "getReportsAvailable": {
+          "method": "get",
+          "path": "/reports/available",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {}
+        },
+        "getCurrency": {
+          "method": "get",
+          "path": "/currency",
+          "private": false,
+          "scopes": [
+            "homey.energy.readonly"
+          ],
+          "parameters": {}
+        },
+        "deleteReports": {
+          "method": "delete",
+          "path": "/reports",
+          "private": false,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {}
+        },
+        "resetReportDayCategories": {
+          "method": "put",
+          "path": "/report/day/reset/categories",
+          "private": false,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "options": {
+              "in": "body",
+              "type": "object",
+              "required": true,
+              "properties": {
+                "date": {
+                  "type": "string"
+                },
+                "categories": {
+                  "type": "array"
+                },
+                "deviceIds": {
+                  "type": "array"
+                }
+              }
+            }
+          }
+        },
+        "enableDummyEnergyReports": {
+          "method": "post",
+          "path": "/reports/dummy/enable",
+          "private": true,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {
+            "fromDate": {
+              "in": "query",
+              "type": "string"
+            },
+            "toDate": {
+              "in": "query",
+              "type": "string"
+            },
+            "randomness": {
+              "in": "query",
+              "type": "string"
+            },
+            "numTopConsumers": {
+              "in": "query",
+              "type": "string"
+            }
+          }
+        },
+        "disableDummyEnergyReports": {
+          "method": "post",
+          "path": "/reports/dummy/disable",
+          "private": true,
+          "scopes": [
+            "homey.energy"
+          ],
+          "parameters": {}
         }
       }
     },
@@ -1900,6 +2181,10 @@
             "persistent": {
               "in": "body",
               "type": "boolean"
+            },
+            "dataRequestActiveState": {
+              "in": "body",
+              "type": "string"
             }
           }
         },
@@ -5669,4 +5954,4 @@
       }
     }
   }
-}
+}

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

@@ -768,6 +768,28 @@ export namespace HomeyAPIV3Cloud.ManagerDrivers {
   }
 }
 
+export namespace HomeyAPIV3Cloud.ManagerEnergy {
+  export class EnergyReportDay {
+    id: string;
+  }
+
+  export class EnergyReportHour {
+    id: string;
+  }
+
+  export class EnergyReportMonth {
+    id: string;
+  }
+
+  export class EnergyReportWeek {
+    id: string;
+  }
+
+  export class EnergyReportYear {
+    id: string;
+  }
+}
+
 export namespace HomeyAPIV3Cloud.ManagerFlow {
   export class AdvancedFlow extends HomeyAPIV3.ManagerFlow.AdvancedFlow {
     id: string;
@@ -1181,6 +1203,28 @@ export namespace HomeyAPIV3Local.ManagerDrivers {
   }
 }
 
+export namespace HomeyAPIV3Local.ManagerEnergy {
+  export class EnergyReportDay {
+    id: string;
+  }
+
+  export class EnergyReportHour {
+    id: string;
+  }
+
+  export class EnergyReportMonth {
+    id: string;
+  }
+
+  export class EnergyReportWeek {
+    id: string;
+  }
+
+  export class EnergyReportYear {
+    id: string;
+  }
+}
+
 export namespace HomeyAPIV3Local.ManagerExperiments {
   export class ExperimentHomeKit {
     id: string;
@@ -1533,6 +1577,16 @@ export class AthomCloudAPI {
 
   getAuthenticatedUser(opts: { additionalScopes?: string }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   isLoggedIn(): Promise<boolean>;
 
   getAuthenticatedUser(opts?: { $cache?: object }): Promise<AthomCloudAPI.User>;
@@ -1555,6 +1609,16 @@ export class AthomCloudAPI {
 
   getAuthenticatedUser(opts: { additionalScopes?: string }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   isLoggedIn(): Promise<boolean>;
 
   getAuthenticatedUser(opts?: { $cache?: object }): Promise<AthomCloudAPI.User>;
@@ -1697,6 +1761,16 @@ export class AthomCloudAPI {
 
   getAuthenticatedUser(opts: { additionalScopes?: string }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   isLoggedIn(): Promise<boolean>;
 
   getAuthenticatedUser(opts?: { $cache?: object }): Promise<AthomCloudAPI.User>;
@@ -1719,6 +1793,16 @@ export class AthomCloudAPI {
 
   getAuthenticatedUser(opts: { additionalScopes?: string }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   isLoggedIn(): Promise<boolean>;
 
   getAuthenticatedUser(opts?: { $cache?: object }): Promise<AthomCloudAPI.User>;
@@ -2102,9 +2186,51 @@ export namespace HomeyAPIV3Cloud {
   }
 
   export class ManagerEnergy extends HomeyAPIV3.ManagerEnergy {
+    getOptionElectricityPriceFixed(): Promise<any>;
+
+    setOptionElectricityPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionElectricityPriceFixed(): Promise<any>;
+
+    getOptionGasPriceFixed(): Promise<any>;
+
+    setOptionGasPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionGasPriceFixed(): Promise<any>;
+
+    getOptionWaterPriceFixed(): Promise<any>;
+
+    setOptionWaterPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionWaterPriceFixed(): Promise<any>;
+
     getState(): Promise<any>;
 
     getLiveReport(opts: { zone?: string }): Promise<any>;
+
+    getReportDay(opts: { date?: string }): Promise<any>;
+
+    getReportWeek(opts: { isoWeek?: string }): Promise<any>;
+
+    getReportMonth(opts: { yearMonth?: string }): Promise<any>;
+
+    getReportYear(opts: { year?: string }): Promise<any>;
+
+    getReportsAvailable(): Promise<any>;
+
+    getCurrency(): Promise<any>;
+
+    deleteReports(): Promise<any>;
+
+    resetReportDayCategories(opts: {
+      options: {
+        date?: string;
+
+        categories?: Array<any>;
+
+        deviceIds?: Array<any>;
+      };
+    }): Promise<any>;
   }
 
   export class ManagerEnergyDongle extends HomeyAPIV3.ManagerEnergyDongle {
@@ -2715,6 +2841,10 @@ export namespace HomeyAPIV3Cloud {
 
       opts?: object;
     }): Promise<any>;
+
+    getLog(): Promise<any>;
+
+    setLogEnabled(opts: { enabled: boolean }): Promise<any>;
   }
 }
 
@@ -3592,9 +3722,51 @@ export namespace HomeyAPIV3Local {
   }
 
   export class ManagerEnergy extends HomeyAPIV3.ManagerEnergy {
+    getOptionElectricityPriceFixed(): Promise<any>;
+
+    setOptionElectricityPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionElectricityPriceFixed(): Promise<any>;
+
+    getOptionGasPriceFixed(): Promise<any>;
+
+    setOptionGasPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionGasPriceFixed(): Promise<any>;
+
+    getOptionWaterPriceFixed(): Promise<any>;
+
+    setOptionWaterPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionWaterPriceFixed(): Promise<any>;
+
     getState(): Promise<any>;
 
     getLiveReport(opts: { zone?: string }): Promise<any>;
+
+    getReportDay(opts: { date?: string }): Promise<any>;
+
+    getReportWeek(opts: { isoWeek?: string }): Promise<any>;
+
+    getReportMonth(opts: { yearMonth?: string }): Promise<any>;
+
+    getReportYear(opts: { year?: string }): Promise<any>;
+
+    getReportsAvailable(): Promise<any>;
+
+    getCurrency(): Promise<any>;
+
+    deleteReports(): Promise<any>;
+
+    resetReportDayCategories(opts: {
+      options: {
+        date?: string;
+
+        categories?: Array<any>;
+
+        deviceIds?: Array<any>;
+      };
+    }): Promise<any>;
   }
 
   export class ManagerEnergyDongle extends HomeyAPIV3.ManagerEnergyDongle {

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

@@ -837,6 +837,28 @@ export namespace HomeyAPIV3Cloud.ManagerDrivers {
   }
 }
 
+export namespace HomeyAPIV3Cloud.ManagerEnergy {
+  export class EnergyReportDay {
+    id: string;
+  }
+
+  export class EnergyReportHour {
+    id: string;
+  }
+
+  export class EnergyReportMonth {
+    id: string;
+  }
+
+  export class EnergyReportWeek {
+    id: string;
+  }
+
+  export class EnergyReportYear {
+    id: string;
+  }
+}
+
 export namespace HomeyAPIV3Cloud.ManagerFlow {
   export class AdvancedFlow extends HomeyAPIV3.ManagerFlow.AdvancedFlow {
     id: string;
@@ -1282,6 +1304,28 @@ export namespace HomeyAPIV3Local.ManagerDrivers {
   }
 }
 
+export namespace HomeyAPIV3Local.ManagerEnergy {
+  export class EnergyReportDay {
+    id: string;
+  }
+
+  export class EnergyReportHour {
+    id: string;
+  }
+
+  export class EnergyReportMonth {
+    id: string;
+  }
+
+  export class EnergyReportWeek {
+    id: string;
+  }
+
+  export class EnergyReportYear {
+    id: string;
+  }
+}
+
 export namespace HomeyAPIV3Local.ManagerExperiments {
   export class ExperimentHomeKit {
     id: string;
@@ -2710,6 +2754,16 @@ export class AthomCloudAPI {
     inviterId: string;
   }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   getBridges(opts: {
     serial?: string;
 
@@ -3286,6 +3340,16 @@ export class AthomCloudAPI {
     inviterId: string;
   }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   getBridges(opts: {
     serial?: string;
 
@@ -6062,6 +6126,16 @@ export class AthomCloudAPI {
     inviterId: string;
   }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   getBridges(opts: {
     serial?: string;
 
@@ -6638,6 +6712,16 @@ export class AthomCloudAPI {
     inviterId: string;
   }): Promise<any>;
 
+  getAuthenticatedUserNewsletterStatus(): Promise<any>;
+
+  subscribeAuthenticatedUserToNewsletter(opts: {
+    data?: {
+      language: string;
+    };
+  }): Promise<any>;
+
+  unsubscribeAuthenticatedUserFromNewsletter(): Promise<any>;
+
   getBridges(opts: {
     serial?: string;
 
@@ -8661,9 +8745,63 @@ export namespace HomeyAPIV3Cloud {
   }
 
   export class ManagerEnergy extends HomeyAPIV3.ManagerEnergy {
+    getOptionElectricityPriceFixed(): Promise<any>;
+
+    setOptionElectricityPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionElectricityPriceFixed(): Promise<any>;
+
+    getOptionGasPriceFixed(): Promise<any>;
+
+    setOptionGasPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionGasPriceFixed(): Promise<any>;
+
+    getOptionWaterPriceFixed(): Promise<any>;
+
+    setOptionWaterPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionWaterPriceFixed(): Promise<any>;
+
     getState(): Promise<any>;
 
     getLiveReport(opts: { zone?: string }): Promise<any>;
+
+    getReportDay(opts: { date?: string }): Promise<any>;
+
+    getReportWeek(opts: { isoWeek?: string }): Promise<any>;
+
+    getReportMonth(opts: { yearMonth?: string }): Promise<any>;
+
+    getReportYear(opts: { year?: string }): Promise<any>;
+
+    getReportsAvailable(): Promise<any>;
+
+    getCurrency(): Promise<any>;
+
+    deleteReports(): Promise<any>;
+
+    resetReportDayCategories(opts: {
+      options: {
+        date?: string;
+
+        categories?: Array<any>;
+
+        deviceIds?: Array<any>;
+      };
+    }): Promise<any>;
+
+    enableDummyEnergyReports(opts: {
+      fromDate?: string;
+
+      toDate?: string;
+
+      randomness?: string;
+
+      numTopConsumers?: string;
+    }): Promise<any>;
+
+    disableDummyEnergyReports(): Promise<any>;
   }
 
   export class ManagerEnergyDongle extends HomeyAPIV3.ManagerEnergyDongle {
@@ -8705,6 +8843,8 @@ export namespace HomeyAPIV3Cloud {
       dataTimeoutMs?: number;
 
       persistent?: boolean;
+
+      dataRequestActiveState?: string;
     }): Promise<any>;
 
     checkFirmwareUpdateAvailable(opts: { deviceId: string }): Promise<any>;
@@ -9370,6 +9510,10 @@ export namespace HomeyAPIV3Cloud {
 
       opts?: object;
     }): Promise<any>;
+
+    getLog(): Promise<any>;
+
+    setLogEnabled(opts: { enabled: boolean }): Promise<any>;
   }
 }
 
@@ -10345,9 +10489,63 @@ export namespace HomeyAPIV3Local {
   }
 
   export class ManagerEnergy extends HomeyAPIV3.ManagerEnergy {
+    getOptionElectricityPriceFixed(): Promise<any>;
+
+    setOptionElectricityPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionElectricityPriceFixed(): Promise<any>;
+
+    getOptionGasPriceFixed(): Promise<any>;
+
+    setOptionGasPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionGasPriceFixed(): Promise<any>;
+
+    getOptionWaterPriceFixed(): Promise<any>;
+
+    setOptionWaterPriceFixed(opts: { value: any }): Promise<any>;
+
+    unsetOptionWaterPriceFixed(): Promise<any>;
+
     getState(): Promise<any>;
 
     getLiveReport(opts: { zone?: string }): Promise<any>;
+
+    getReportDay(opts: { date?: string }): Promise<any>;
+
+    getReportWeek(opts: { isoWeek?: string }): Promise<any>;
+
+    getReportMonth(opts: { yearMonth?: string }): Promise<any>;
+
+    getReportYear(opts: { year?: string }): Promise<any>;
+
+    getReportsAvailable(): Promise<any>;
+
+    getCurrency(): Promise<any>;
+
+    deleteReports(): Promise<any>;
+
+    resetReportDayCategories(opts: {
+      options: {
+        date?: string;
+
+        categories?: Array<any>;
+
+        deviceIds?: Array<any>;
+      };
+    }): Promise<any>;
+
+    enableDummyEnergyReports(opts: {
+      fromDate?: string;
+
+      toDate?: string;
+
+      randomness?: string;
+
+      numTopConsumers?: string;
+    }): Promise<any>;
+
+    disableDummyEnergyReports(): Promise<any>;
   }
 
   export class ManagerEnergyDongle extends HomeyAPIV3.ManagerEnergyDongle {
@@ -10389,6 +10587,8 @@ export namespace HomeyAPIV3Local {
       dataTimeoutMs?: number;
 
       persistent?: boolean;
+
+      dataRequestActiveState?: string;
     }): Promise<any>;
 
     checkFirmwareUpdateAvailable(opts: { deviceId: string }): Promise<any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homey-api",
-  "version": "3.8.0",
+  "version": "3.10.0",
   "description": "Homey API",
   "main": "index.js",
   "files": [