homebridge-nest-accfactory 0.2.9 → 0.3.0

package/CHANGELOG.md

@@ -2,7 +2,35 @@
 
 All notable changes to `homebridge-nest-accfactory` will be documented in this file. This project tries to adhere to [Semantic Versioning](http://semver.org/).
 
-## v0.2.8 (2025/03/23)
+## v0.3.0 (2025/06/14)
+
+- General code cleanup and stability improvements
+- Introduced plugin-style architecture for Nest/Google devices
+- Updated README.md to reflect changes to the devices section in configuration
+- Prevent excluded devices from being restored from Homebridge cache
+- Added internal support for selecting active temperature sensor (not yet exposed to HomeKit)
+- Fixed loss of custom devices section when using the plugin config UI
+- Fixed motion services being recreated when restored from Homebridge cache
+- Fixed missing devices for Nest FieldTest accounts
+- Added hot water heating boost (on/off) support for compatible EU/UK Thermostats
+- Added support for Nest Heat Link devices as room temperature sensors
+
+### Deprecation Notice
+- Support for the standalone Docker version of this plugin is planned to be deprecated in an upcoming release. While it currently remains functional, future updates may no longer include Docker-specific build support. Users are encouraged to transition to standard Homebridge installations where possible.
+
+### Known Issues
+
+- Audio from newer Nest/Google cameras and doorbells is currently silent (blank audio output)
+- The ip npm package has a known security advisory [GHSA-2p57-rm9w-gvfp](https://github.com/advisories/GHSA-2p57-rm9w-gvfp); this is used indirectly via the werift library
+
+### Thanks
+Special thanks to [@Daniel](https://github.com/no1knows) and [@Brad](https://github.com/bcullman) for testing and feedback on this release!
+
+## v0.2.11 (2025/04/17)
+
+- General code cleanup and bug fixes
+
+## v0.2.9 (2025/03/23)
 
 - General code cleanup and bug fixes
 - Support for Nest Protect(s) in Google Home app

package/README.md

@@ -23,8 +23,12 @@ The following Nest devices are known to be supported
 * Nest Temp Sensors (1st gen)
 * Nest Cameras (Cam Indoor, IQ Indoor, Outdoor, IQ Outdoor, Cam with Floodlight)
 * Nest Doorbells (wired 1st gen)
+* Nest HeatLink
 
-The accessory supports connection to Nest using a Nest account OR a Google (migrated Nest account) account.
+**Note:** Google has announced it will discontinue support for 1st and 2nd generation Nest Thermostats as of **October 25, 2025**.  
+Based on their stated intentions, these models are expected to stop functioning with this Homebridge plugin after that date.
+
+The accessory supports connection to Nest using a Nest account AND/OR a Google (migrated Nest account) account.
 
 ## Configuration
 
@@ -79,14 +83,15 @@ Sample config.json entries below
         "elevation": 600,
         "hksv": false
     },
-    "devices": {
-        "XXXXXXXX": {
+    "devices": [
+        {
+            "serialNumber": "XXXXXXXX",
             "exclude": false
         },
-        "YYYYYYYY" : {
+            "serialNumber": "YYYYYYYY",
             "hksv" : true
         }
-    },
+    ],
     "platform": "NestAccfactory"
 }
 ```
@@ -99,15 +104,15 @@ The following options are available in the config.json options object. These app
 |-------------------|-----------------------------------------------------------------------------------------------|----------------|
 | elevation         | Height above sea level for the weather station                                                | 0              |
 | eveHistory        | Provide history in EveHome application where applicable                                       | true           |
+| exclude           | Exclude ALL devices                                                                           | false          |
 | ffmegDebug        | Turns on specific debugging output for when ffmpeg is envoked                                 | false          |
 | ffmegPath         | Path to an ffmpeg binary for us to use                                                        | /usr/local/bin |
 | hksv              | Enable HomeKit Secure Video for supported camera(s) and doorbell(s)                           | false          |
-| maxStreams        | Maximum number of concurrent video streams in HomeKit for supported camera(s) and doorbell(s) | 2              |
 | weather           | Virtual weather station for each Nest/Google home we discover                                 | false          |
 
 #### devices
 
-The following options are available on a per-device level in the config.json devices object. The device is specified by using its serial number (in uppercase)
+The following options are available on a per-device level in the `config.json` `devices` array. Each device is specified as a JSON object, and the device is identified using the `"serialNumber"` key with the value of its serial number (in uppercase).
 
 | Name              | Description                                                                                   | Default        |
 |-------------------|-----------------------------------------------------------------------------------------------|----------------|
@@ -118,10 +123,12 @@ The following options are available on a per-device level in the config.json dev
 | exclude           | Exclude the device                                                                            | false          |
 | ffmegDebug        | Turns on specific debugging output for when ffmpeg is envoked                                 | false          |
 | hksv              | Enable HomeKit Secure Video for supported camera(s) and doorbell(s)                           | false          |
+| hotWaterBoostTime | Time in seconds for hotwater boost heating                                                    | 1800           |
 | humiditySensor    | Create a seperate humidity sensor for supported thermostat(s)                                 | false          |
 | localAccess       | Use direct access to supported camera(s) and doorbell(s) for video streaming and recording    | false          |    
 | motionCooldown    | Time in seconds between detected motion events                                                | 60             |
 | personCooldown    | Time in seconds between detected person events                                                | 120            |
+| serialNumber      | Device serial number to which these settings belong too                                       |                |
 
 ## ffmpeg
 

package/config.schema.json

@@ -15,6 +15,9 @@
                 "title": "Nest Account",
                 "type": "object",
                 "expandable": true,
+                "expanded": {
+                    "functionBody": "return model.nest && model.nest.access_token"
+                },
                 "properties": {
                     "access_token": {
                         "title": "Access Token",
@@ -36,6 +39,9 @@
                 "title": "Google Account",
                 "type": "object",
                 "expandable": true,
+                "expanded": {
+                    "functionBody": "return model.google && model.google.issuetoken && model.google.cookie"
+                },
                 "properties": {
                     "issuetoken": {
                         "title": "Issue Token",
@@ -57,12 +63,13 @@
                             "functionBody": "return model.google.issuetoken && model.google.cookie"
                         }
                     }
-                }   
+                }
             },
             "options": {
                 "title": "Options",
                 "type": "object",
                 "expandable": true,
+                "expanded": true,
                 "properties": {
                     "eveHistory": {
                         "title": "EveHome History",
@@ -98,6 +105,84 @@
                         "type": "string",
                         "placeholder": "Path to an ffmpeg binary",
                         "default": "/usr/local/bin/ffmpeg"
+                    },
+                    "ffmegDebug": {
+                        "type": "boolean"
+                    },
+                    "maxStreams": {
+                        "type": "integer"
+                    },
+                    "exclude": {
+                        "type": "boolean"
+                    },
+                    "useNestAPI": {
+                        "type": "boolean"
+                    },
+                    "useGoogleAPI": {
+                        "type": "boolean"
+                    }
+                }
+            },
+            "devices": {
+                "title": "Per device configuration options",
+                "type": "array",
+                "items": {
+                    "title": "Device",
+                    "type": "object",
+                    "properties": {
+                        "serialNumber": {
+                            "title": "Device Serial Number",
+                            "type": "string",
+                            "required": true
+                        },
+                        "chimeSwitch": {
+                            "type": "boolean"
+                        },
+                        "doorbellCooldown": {
+                            "type": "number"
+                        },
+                        "elevation": {
+                            "type": "number"
+                        },
+                        "eveHistory": {
+                            "type": "boolean"
+                        },
+                        "exclude": {
+                            "type": "boolean"
+                        },
+                        "externalCool": {
+                            "type": "string"
+                        },
+                        "externalDehumidifier": {
+                            "type": "string"
+                        },
+                        "externalFan": {
+                            "type": "string"
+                        },
+                        "externalHeat": {
+                            "type": "string"
+                        },
+                        "ffmegDebug": {
+                            "type": "boolean"
+                        },
+                        "hkPairingCode": {
+                            "type": "string"
+                        },
+                        "hksv": {
+                            "type": "boolean"
+                        },
+                        "humiditySensor": {
+                            "type": "boolean"
+                        },
+                        "localAccess": {
+                            "type": "boolean"
+                        },
+                        "motionCooldown": {
+                            "type": "number"
+                        },
+                        "personCooldown": {
+                            "type": "number"
+                        }
                     }
                 }
             }
@@ -110,5 +195,45 @@
         {
             "required": ["google"]
         }
+    ],
+    "layout": [
+        {
+            "type": "fieldset",
+            "title": "Nest Account",
+            "expandable": true,
+            "expanded": {
+                "functionBody": "return model.nest && model.nest.access_token"
+            },
+            "items": [
+                "nest.access_token",
+                "nest.fieldTest"
+            ]
+        },
+        {
+            "type": "fieldset",
+            "title": "Google Account",
+            "expandable": true,
+            "expanded": {
+                "functionBody": "return model.google && model.google.issuetoken && model.google.cookie"
+            },
+            "items": [
+                "google.issuetoken",
+                "google.cookie",
+                "google.fieldTest"
+            ]
+        },
+        {
+            "type": "fieldset",
+            "title": "Options",
+            "expandable": true,
+            "expanded": true,
+            "items": [
+                "options.eveHistory",
+                "options.weather",
+                "options.elevation",
+                "options.hksv",
+                "options.ffmpegPath"
+            ]
+        }
     ]
 }