initial Commit

__init__.py

@@ -0,0 +1,113 @@
+"""Support for Alexa skill service end point."""
+
+from typing import Any
+
+import voluptuous as vol
+
+from homeassistant.const import (
+    CONF_CLIENT_ID,
+    CONF_CLIENT_SECRET,
+    CONF_DESCRIPTION,
+    CONF_NAME,
+    CONF_PASSWORD,
+)
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers import config_validation as cv, entityfilter
+from homeassistant.helpers.typing import ConfigType
+
+from . import flash_briefings, intent, smart_home
+from .const import (
+    CONF_AUDIO,
+    CONF_DISPLAY_CATEGORIES,
+    CONF_DISPLAY_URL,
+    CONF_ENDPOINT,
+    CONF_ENTITY_CONFIG,
+    CONF_FILTER,
+    CONF_LOCALE,
+    CONF_SUPPORTED_LOCALES,
+    CONF_TEXT,
+    CONF_TITLE,
+    CONF_UID,
+    DOMAIN,
+)
+
+CONF_FLASH_BRIEFINGS = "flash_briefings"
+CONF_SMART_HOME = "smart_home"
+DEFAULT_LOCALE = "en-US"
+
+# Alexa Smart Home API send events gateway endpoints
+# https://developer.amazon.com/en-US/docs/alexa/smarthome/send-events.html#endpoints
+VALID_ENDPOINTS = [
+    "https://api.amazonalexa.com/v3/events",
+    "https://api.eu.amazonalexa.com/v3/events",
+    "https://api.fe.amazonalexa.com/v3/events",
+]
+
+
+ALEXA_ENTITY_SCHEMA = vol.Schema(
+    {
+        vol.Optional(CONF_DESCRIPTION): cv.string,
+        vol.Optional(CONF_DISPLAY_CATEGORIES): cv.string,
+        vol.Optional(CONF_NAME): cv.string,
+    }
+)
+
+SMART_HOME_SCHEMA = vol.Schema(
+    {
+        vol.Optional(CONF_ENDPOINT): vol.All(vol.Lower, vol.In(VALID_ENDPOINTS)),
+        vol.Optional(CONF_CLIENT_ID): cv.string,
+        vol.Optional(CONF_CLIENT_SECRET): cv.string,
+        vol.Optional(CONF_LOCALE, default=DEFAULT_LOCALE): vol.In(
+            CONF_SUPPORTED_LOCALES
+        ),
+        vol.Optional(CONF_FILTER, default={}): entityfilter.FILTER_SCHEMA,
+        vol.Optional(CONF_ENTITY_CONFIG): {cv.entity_id: ALEXA_ENTITY_SCHEMA},
+    }
+)
+
+CONFIG_SCHEMA = vol.Schema(
+    {
+        DOMAIN: {
+            CONF_FLASH_BRIEFINGS: {
+                vol.Required(CONF_PASSWORD): cv.string,
+                cv.string: vol.All(
+                    cv.ensure_list,
+                    [
+                        {
+                            vol.Optional(CONF_UID): cv.string,
+                            vol.Required(CONF_TITLE): cv.template,
+                            vol.Optional(CONF_AUDIO): cv.template,
+                            vol.Required(CONF_TEXT, default=""): cv.template,
+                            vol.Optional(CONF_DISPLAY_URL): cv.template,
+                        }
+                    ],
+                ),
+            },
+            # vol.Optional here would mean we couldn't distinguish between an empty
+            # smart_home: and none at all.
+            CONF_SMART_HOME: vol.Any(SMART_HOME_SCHEMA, None),
+        }
+    },
+    extra=vol.ALLOW_EXTRA,
+)
+
+
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
+    """Activate the Alexa component."""
+    if DOMAIN not in config:
+        return True
+
+    config = config[DOMAIN]
+
+    intent.async_setup(hass)
+
+    if flash_briefings_config := config.get(CONF_FLASH_BRIEFINGS):
+        flash_briefings.async_setup(hass, flash_briefings_config)
+
+    # smart_home being absent is not the same as smart_home being None
+    if CONF_SMART_HOME in config:
+        smart_home_config: dict[str, Any] | None = config[CONF_SMART_HOME]
+        smart_home_config = smart_home_config or SMART_HOME_SCHEMA({})
+        await smart_home.async_setup(hass, smart_home_config)
+
+    return True