Automated clean up and removal devices that are not responding or orphan devices. (#768)

Changes

Major improvement in the handling of missing or orphan devices in Alexa. When deviceCleanup is enabled the plugin will inform Alexa when a request is received for a missing or orphan device, and tell Alexa to remove the device.
Bug Fix

Fix for Routines not working Alexa Routines no longer working #761
Fix for missing Mute function with Apple TV
Changes

Increased test case coverage

Author: NorthernMan54

.gitignore

@@ -18,3 +18,4 @@ gh-md-toc
 /test/hbConfig/persist
 test/hbConfig/config.json
 test/hbConfig/homebridge-alexa-discovery.json
+test/hbConfig/homebridge-alexa-endpoints.json

CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to this project will be documented in this file. This project uses [Semantic Versioning](https://semver.org/).
 
+## 0.9.0 (2025-03-30)
+
+## [Version 0.9.0](https://github.com/northernman54/homebridge-alexa/compare/v0.8.2...v0.9.0)
+
+#### Changes
+
+- Major improvement in the handling of missing or orphan devices in Alexa.  When `deviceCleanup` is enabled the plugin will inform Alexa when a request is received for a missing or orphan device, and tell Alexa to remove the device.
+
+#### Bug Fix
+
+- Fix for Routines not working #761
+- Fix for missing Mute function with Apple TV
+
+#### Changes
+
+- Increased test case coverage
+
 ## 0.8.2 (2024-12-27)
 
 ## [Version 0.8.2](https://github.com/northernman54/homebridge-alexa/compare/v0.8.1...v0.8.2)

Installation.md

@@ -18,6 +18,7 @@ Installation and Configuration of Homebridge Alexa
       * [Required Settings](#required-settings)
       * [Optional Settings](#optional-settings)
          * [debug](#debug)
+         * [deviceCleanup](#devicecleanup)
          * [pin](#pin)
          * [routines](#routines)
          * [deviceList & deviceListHandling - Filtering of devices by name, either allow or allow](#devicelist--devicelisthandling---filtering-of-devices-by-name-either-allow-or-allow)
@@ -188,6 +189,21 @@ sudo npm install -g homebridge-alexa
 ],
 ```
 
+#### deviceCleanup
+  - This enables automated cleanup of missing or orphan devices within the Alexa environment.  When this is enabled, if a request is received from Alexa for a device that is no longer in homebridge, the plugin will send a request to Alexa to delete the device.
+
+```
+"platforms": [
+  {
+    "platform": "Alexa",
+    "name": "Alexa",
+    "username": "....",
+    "password": "....",
+    "deviceCleanup": true
+  }
+],
+```
+
 #### pin
   - If you had changed your homebridge pin from the default of "pin": "031-45-154" ie
 

package-lock.json

@@ -1,10 +1,10 @@
 {
   "name": "homebridge-alexa",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Control your Homebridge devices with Amazon Alexa.",
   "main": "src/plugin.js",
   "scripts": {
-    "test": "jest --forceExit --detectOpenHandles --verbose=true --silent ",
+    "test": "jest --forceExit --detectOpenHandles --verbose=true  ",
     "api": "documentation build plugin.js lib/alexaActions.js lib/alexaLocal.js lib/alexaMessages.js lib/alexaTranslator.js -f md --config docs/documentation.yml > docs/API.md",
     "document": "./gh-md-toc --hide-footer README.md ;./gh-md-toc --hide-footer Troubleshooting.md ;./gh-md-toc --hide-footer Installation.md; rm README.md.orig.* README.md.toc.* Troubleshooting.md.orig.* Troubleshooting.md.toc.* Installation.md.orig.* Installation.md.toc.*",
     "watch": "nodemon",