* see changelog

* prepare release
Apollon77 · Jul 6, 2022 · ba68474 · ba68474
1 parent de63ff2
commit ba68474
Show file tree

Hide file tree

Showing 5 changed files with 249 additions and 82 deletions.
diff --git a/README.md b/README.md
@@ -23,6 +23,23 @@ Thank you for that work.
 * docu docu docu (sorry ... will come)
 
 ## Changelog:
+
+### __WORK IN PROGRESS__
+* (Apollon77) Query API endpoints (including new method getEndpoints()) from Amazon on start and use this API endpoint for the calls
+* (Apollon77) Enhance getDevicePreferences() to request preferences for one device
+* (Apollon77) Add setDevicePreferences() to set the device preferences for a device
+* (Apollon77) Add getDeviceWifiDetails() to get the Wifi definitions (including SSID and MAC) for a device
+* (Apollon77) Load Device Preferences on startup and make accessible via device.preferences on the device objects
+* (Apollon77) Add methods getDevicePreferences() and setDevicePreferences() to the alexa class and to the device objects
+* (Apollon77) Add new Media Message "jump" (in sendMessage() method) with a mediaId as value (can be used to jump to another queue item)
+* (Apollon77) Add getRoutineSoundList() to query available sound IDs for a routine
+* (Apollon77) Add new command "sound" when creating/sending sequence nodes to play sounds
+* (Apollon77) Add method getWholeHomeAudioGroups() to query information about the current Audio groups
+* (Apollon77) Enhance sending "notification" sequence node to allow providing an object as value with keys title and text to specify the title for displaying the message too
+* (Apollon77) Add setEnablementForSmarthomeDevice() to enable/disable a smart home device
+* (Apollon77) Log Response with status code also when no callback is provided (but without body content)
+* (Apollon77) Slightly adjust the calculated timeout when getting many smart home device values
+
 ### 5.1.0 (2022-07-04)
 * (Apollon77) Detect Rate limit exceeded response and do one automatic request retry 10s later (plus a random part)
 * (Apollon77) Calculate the timeout of querySmarthomeDevices dynamically between 10s and 60s (maximum overrideable by new optional parameter) depending on the number of devices to query

diff --git a/alexa-remote.d.ts b/alexa-remote.d.ts
@@ -80,6 +80,11 @@ declare module "alexa-remote2" {
 
     export type Value = string | number | boolean;
 
+    export type SequenceValue = Value | {
+        title: string
+        text: string
+    };
+
     export type Sound = {
         displayName: string;
         folder: string;
@@ -165,7 +170,8 @@ declare module "alexa-remote2" {
         | "rewind"
         | "volume"
         | "shuffle"
-        | "repeat";
+        | "repeat"
+        | "jump";
 
     export type SequenceNodeCommand =
         | "weather"
@@ -196,7 +202,7 @@ declare module "alexa-remote2" {
 
     export type SequenceNodeDetails = {
         command: SequenceNodeCommand;
-        value: Value;
+        value: SequenceValue;
         device?: SerialOrNameOrArray;
     }
 
@@ -315,6 +321,8 @@ declare module "alexa-remote2" {
 
         getSkills(callback: CallbackWithErrorAndBody): void;
 
+        getRoutineSoundList(callback: CallbackWithErrorAndBody): void;
+
         createNotificationObject(
             serialOrName: SerialOrName,
             type: string,
@@ -427,7 +435,7 @@ declare module "alexa-remote2" {
 
         createSequenceNode(
             command: SequenceNodeCommand,
-            value: Value,
+            value: SequenceValue,
             serialOrName: SerialOrNameOrArray,
             overrideCustomerId?: string
         ): void;
@@ -450,7 +458,7 @@ declare module "alexa-remote2" {
         sendSequenceCommand(
             serialOrName: SerialOrNameOrArray,
             command: SequenceNodeCommand,
-            value: Value,
+            value: SequenceValue,
             overrideCustomerId?: string | CallbackWithErrorAndBody,
             callback?: CallbackWithErrorAndBody
         ): void;
@@ -495,7 +503,20 @@ declare module "alexa-remote2" {
 
         getHomeGroup(callback: CallbackWithErrorAndBody): void;
 
-        getDevicePreferences(callback: CallbackWithErrorAndBody): void;
+        getDevicePreferences(
+            serialOrName: SerialOrName | CallbackWithErrorAndBody,
+            callback?: CallbackWithErrorAndBody
+        ): void;
+
+        setDevicePreferences(
+            serialOrName: SerialOrName,
+            preferences: Record<string, unknown>,
+            callback: CallbackWithErrorAndBody
+        ): void;
+
+        getDeviceWifiDetails(serialOrName: SerialOrName, callback: CallbackWithErrorAndBody): void;
+
+        getAllDoNotDisturbDeviceStatus(callback: CallbackWithErrorAndBody): void;
 
         getAllDeviceVolumes(callback: CallbackWithErrorAndBody): void;
 
@@ -520,6 +541,12 @@ declare module "alexa-remote2" {
             callback: CallbackWithErrorAndBody
         ): void;
 
+        setEnablementForSmarthomeDevice(
+            smarthomeDevice: string,
+            enabled: boolean,
+            callback: CallbackWithErrorAndBody
+        ): void;
+
         deleteSmarthomeGroup(
             smarthomeGroup: string,
             callback: CallbackWithErrorAndBody
@@ -559,5 +586,9 @@ declare module "alexa-remote2" {
         isWsMqttConnected(): boolean;
 
         stopProxyServer(callback: CallbackWithError): void
+
+        getWholeHomeAudioGroups(callback: CallbackWithErrorAndBody): void
+
+        getEndpoints(callback: CallbackWithErrorAndBody): void
     }
 }