aioamazondevices 1.4.2__tar.gz → 1.6.0__tar.gz

{aioamazondevices-1.4.2 → aioamazondevices-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aioamazondevices
-Version: 1.4.2
+Version: 1.6.0
 Summary: Python library to control Amazon devices
 License: Apache-2.0
 Author: Simone Chemelli
@@ -82,7 +82,8 @@ The script accept command line arguments or a library_test.json config file:
   "country": "IT",
   "email": "<my_address@gmail.com>",
   "password": "<my_password>",
-  "device_name": "Echo Dot Livingroom",
+  "single_device_name": "Echo Dot Livingroom",
+  "cluster_device_name": "Everywhere",
   "login_data_file": "out/login_data.json",
   "save_raw_data": "True"
 }

{aioamazondevices-1.4.2 → aioamazondevices-1.6.0}/README.md

@@ -54,7 +54,8 @@ The script accept command line arguments or a library_test.json config file:
   "country": "IT",
   "email": "<my_address@gmail.com>",
   "password": "<my_password>",
-  "device_name": "Echo Dot Livingroom",
+  "single_device_name": "Echo Dot Livingroom",
+  "cluster_device_name": "Everywhere",
   "login_data_file": "out/login_data.json",
   "save_raw_data": "True"
 }

{aioamazondevices-1.4.2 → aioamazondevices-1.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "aioamazondevices"
-version = "1.4.2"
+version = "1.6.0"
 description = "Python library to control Amazon devices"
 authors = ["Simone Chemelli <simone.chemelli@gmail.com>"]
 license = "Apache-2.0"

{aioamazondevices-1.4.2 → aioamazondevices-1.6.0}/src/aioamazondevices/__init__.py

@@ -1,6 +1,6 @@
 """aioamazondevices library."""
 
-__version__ = "1.4.2"
+__version__ = "1.6.0"
 
 
 from .api import AmazonDevice, AmazonEchoApi

{aioamazondevices-1.4.2 → aioamazondevices-1.6.0}/src/aioamazondevices/api.py

@@ -7,7 +7,9 @@ import secrets
 import uuid
 from dataclasses import dataclass
 from datetime import UTC, datetime, timedelta
+from enum import StrEnum
 from http import HTTPStatus
+from http.cookies import Morsel
 from pathlib import Path
 from typing import Any, cast
 from urllib.parse import parse_qs, urlencode
@@ -53,6 +55,7 @@ class AmazonDevice:
     device_family: str
     device_type: str
     device_owner_customer_id: str
+    device_cluster_members: list[str]
     online: bool
     serial_number: str
     software_version: str
@@ -61,6 +64,14 @@ class AmazonDevice:
     bluetooth_state: bool
 
 
+class AmazonSequenceType(StrEnum):
+    """Amazon sequence types."""
+
+    Announcement = "AlexaAnnouncement"
+    Speak = "Alexa.Speak"
+    Sound = "Alexa.Sound"
+
+
 class AmazonEchoApi:
     """Queries Amazon for Echo devices."""
 
@@ -95,6 +106,7 @@ class AmazonEchoApi:
         self._save_raw_data = save_raw_data
         self._login_stored_data = login_data
         self._serial = self._serial_number()
+        self._list_for_clusters: dict[str, str] = {}
 
         self.session: ClientSession
 
@@ -254,7 +266,6 @@ class AmazonEchoApi:
             data=input_data if not json_data else orjson.dumps(input_data),
             cookies=self._load_website_cookies(),
             headers=headers,
-            allow_redirects=True,
         )
         content_type: str = resp.headers.get("Content-Type", "")
         _LOGGER.debug(
@@ -520,7 +531,8 @@ class AmazonEchoApi:
             _LOGGER.debug("Response data: |%s|", response_data)
 
             if not self._csrf_cookie:
-                self._csrf_cookie = raw_resp.cookies.get(CSRF_COOKIE).value
+                self._csrf_cookie = raw_resp.cookies.get(CSRF_COOKIE, Morsel()).value
+                _LOGGER.error("CSRF cookie value: <%s>", self._csrf_cookie)
 
             json_data = {} if len(response_data) == 0 else await raw_resp.json()
 
@@ -535,29 +547,44 @@ class AmazonEchoApi:
 
         final_devices_list: dict[str, AmazonDevice] = {}
         for device in devices.values():
+            devices_node = device[NODE_DEVICES]
+            preferences_node = device.get(NODE_PREFERENCES)
+            do_not_disturb_node = device[NODE_DO_NOT_DISTURB]
+            bluetooth_node = device[NODE_BLUETOOTH]
             # Remove stale, orphaned and virtual devices
             if (
                 NODE_DEVICES not in device
-                or device[NODE_DEVICES].get("deviceType") == AMAZON_DEVICE_TYPE
+                or devices_node.get("deviceType") == AMAZON_DEVICE_TYPE
             ):
                 continue
 
-            serial_number: str = device[NODE_DEVICES]["serialNumber"]
-            preferences = device.get(NODE_PREFERENCES)
+            serial_number: str = devices_node["serialNumber"]
             final_devices_list[serial_number] = AmazonDevice(
-                account_name=device[NODE_DEVICES]["accountName"],
-                capabilities=device[NODE_DEVICES]["capabilities"],
-                device_family=device[NODE_DEVICES]["deviceFamily"],
-                device_type=device[NODE_DEVICES]["deviceType"],
-                device_owner_customer_id=device[NODE_DEVICES]["deviceOwnerCustomerId"],
-                online=device[NODE_DEVICES]["online"],
+                account_name=devices_node["accountName"],
+                capabilities=devices_node["capabilities"],
+                device_family=devices_node["deviceFamily"],
+                device_type=devices_node["deviceType"],
+                device_owner_customer_id=devices_node["deviceOwnerCustomerId"],
+                device_cluster_members=(
+                    devices_node["clusterMembers"] or [serial_number]
+                ),
+                online=devices_node["online"],
                 serial_number=serial_number,
-                software_version=device[NODE_DEVICES]["softwareVersion"],
-                do_not_disturb=device[NODE_DO_NOT_DISTURB]["enabled"],
-                response_style=preferences["responseStyle"] if preferences else None,
-                bluetooth_state=device[NODE_BLUETOOTH]["online"],
+                software_version=devices_node["softwareVersion"],
+                do_not_disturb=do_not_disturb_node["enabled"],
+                response_style=(
+                    preferences_node["responseStyle"] if preferences_node else None
+                ),
+                bluetooth_state=bluetooth_node["online"],
             )
 
+        self._list_for_clusters.update(
+            {
+                device.serial_number: device.device_type
+                for device in final_devices_list.values()
+            }
+        )
+
         return final_devices_list
 
     async def auth_check_status(self) -> bool:
@@ -582,18 +609,78 @@ class AmazonEchoApi:
         _LOGGER.debug("Session authenticated: %s", authenticated)
         return bool(authenticated)
 
-    async def call_alexa_speak(
-        self,
-        device: AmazonDevice,
-        message_body: str,
-    ) -> dict[str, Any]:
-        """Call Alexa.Speak to send a message."""
+    async def _send_message(
+        self, device: AmazonDevice, message_type: str, message_body: str
+    ) -> None:
+        """Send message to specific device."""
         locale_data = Locale.parse(f"und_{self._login_country_code}")
         locale = f"{locale_data.language}-{locale_data.language}"
 
         if not self._login_stored_data:
             _LOGGER.warning("Trying to send message before login")
-            return {}
+            return
+
+        base_payload = {
+            "deviceType": device.device_type,
+            "deviceSerialNumber": device.serial_number,
+            "locale": locale,
+            "customerId": device.device_owner_customer_id,
+        }
+
+        payload: dict[str, Any]
+        if message_type == AmazonSequenceType.Speak:
+            payload = {
+                **base_payload,
+                "textToSpeak": message_body,
+                "target": {
+                    "customerId": device.device_owner_customer_id,
+                    "devices": [
+                        {
+                            "deviceSerialNumber": device.serial_number,
+                            "deviceTypeId": device.device_type,
+                        },
+                    ],
+                },
+                "skillId": "amzn1.ask.1p.saysomething",
+            }
+        elif message_type == AmazonSequenceType.Announcement:
+            playback_devices: list[dict[str, str]] = [
+                {
+                    "deviceSerialNumber": serial,
+                    "deviceTypeId": self._list_for_clusters[serial],
+                }
+                for serial in device.device_cluster_members
+                if serial in self._list_for_clusters
+            ]
+
+            payload = {
+                **base_payload,
+                "expireAfter": "PT5S",
+                "content": [
+                    {
+                        "locale": locale,
+                        "display": {
+                            "title": "Home Assistant",
+                            "body": message_body,
+                        },
+                        "speak": {
+                            "type": "text",
+                            "value": message_body,
+                        },
+                    }
+                ],
+                "target": {
+                    "customerId": device.device_owner_customer_id,
+                    "devices": playback_devices,
+                },
+                "skillId": "amzn1.ask.1p.routines.messaging",
+            }
+        elif message_type == AmazonSequenceType.Sound:
+            payload = {
+                **base_payload,
+                "soundStringId": message_body,
+                "skillId": "amzn1.ask.1p.sound",
+            }
 
         sequence = {
             "@type": "com.amazon.alexa.behaviors.model.Sequence",
@@ -602,28 +689,13 @@ class AmazonEchoApi:
                 "nodesToExecute": [
                     {
                         "@type": "com.amazon.alexa.behaviors.model.OpaquePayloadOperationNode",  # noqa: E501
-                        "type": "Alexa.Speak",
-                        "operationPayload": {
-                            "deviceType": device.device_type,
-                            "deviceSerialNumber": device.serial_number,
-                            "locale": locale,
-                            "customerId": device.device_owner_customer_id,
-                            "textToSpeak": message_body,
-                            "target": {
-                                "customerId": device.device_owner_customer_id,
-                                "devices": [
-                                    {
-                                        "deviceSerialNumber": device.serial_number,
-                                        "deviceTypeId": device.device_type,
-                                    },
-                                ],
-                            },
-                            "skillId": "amzn1.ask.1p.saysomething",
-                        },
+                        "type": message_type,
+                        "operationPayload": payload,
                     },
                 ],
             },
         }
+
         node_data = {
             "behaviorId": "PREVIEW",
             "sequenceJson": orjson.dumps(sequence).decode("utf-8"),
@@ -638,4 +710,30 @@ class AmazonEchoApi:
             json_data=True,
         )
 
-        return node_data
+        return
+
+    async def call_alexa_speak(
+        self,
+        device: AmazonDevice,
+        message_body: str,
+    ) -> None:
+        """Call Alexa.Speak to send a message."""
+        return await self._send_message(device, AmazonSequenceType.Speak, message_body)
+
+    async def call_alexa_announcement(
+        self,
+        device: AmazonDevice,
+        message_body: str,
+    ) -> None:
+        """Call AlexaAnnouncement to send a message."""
+        return await self._send_message(
+            device, AmazonSequenceType.Announcement, message_body
+        )
+
+    async def call_alexa_sound(
+        self,
+        device: AmazonDevice,
+        message_body: str,
+    ) -> None:
+        """Call Alexa.Sound to send a message."""
+        return await self._send_message(device, AmazonSequenceType.Sound, message_body)