@homebridge-plugins/homebridge-updater 3.1.7 → 3.1.9-beta.0

package/CHANGELOG.md

@@ -0,0 +1,287 @@
+## v3.1.9 (Pending Release)
+
+### Changed
+
+- chore(github): release on a published github release, not every push to latest
+- chore(github): align workflows, funding and issue templates with the other org plugins
+- chore: standardise the eslint setup and apply the org lint rules
+- chore: align the npm publishing files with the other org plugins
+- chore: standardise the package manifest with the other org plugins
+- docs: add claude and copilot instructions files
+- docs: use the standard org readme banner
+- chore(deps): dependency updates
+- fix(matter): register a carbon dioxide sensor on the air quality cluster so its state updates instead of failing (#256)
+- fix: propagate a renamed sensor from the config to the cached accessory so the new name reaches homekit (#251)
+- feat: detect homebridge ui beta updates when the ui update policy is set to beta (#255)
+- fix: stop auto-update restarting homebridge in a loop when an update installs but is still reported as out of date (#257)
+- feat: add an option to auto-update only minor and patch versions, leaving major versions to install manually (#263)
+- fix: perform auto-updates through the homebridge ui so they install to the correct plugin path and actually take effect on hb-service and docker setups (#257)
+- fix: detect when running under the homebridge docker image so docker image updates are actually checked (#264)
+
+## [3.1.7](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.1.7) (2026-06-03)
+
+### Changes
+
+* chore: update `.gitignore` to ignore webstorm files
+* chore: dependency updates
+* fix(ui-api): send correct instanceId so JWTs pass UI auth on v5.24.0+
+
+## [3.1.2](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.1.2) (2026-05-05)
+
+### Bug Fixes
+
+* persist failureSensorType to JSON config by marking it required in schema ([#245](https://github.com/homebridge-plugins/homebridge-updater/issues/245)) ([accf14b](https://github.com/homebridge-plugins/homebridge-updater/commit/accf14b8343609b4534bdf9224d9866505dd056f))
+* fix scoped plugin upgrade clearing config: migrate `PluginUpdate` → `HomebridgeUpdater` by reading `config.json` directly instead of relying on the Homebridge UI API, which cannot return legacy platform entries for the new plugin name ([#246](https://github.com/homebridge-plugins/homebridge-updater/issues/246))
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.1.0...v3.1.2
+
+## [3.1.0](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.1.0) (2026-05-04)
+
+### Enhancements
+
+* **Config `Platform` must be manually updated to `HomebridgeUpdater` instead of `PluginUpdate`.**
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.7...v3.1.0
+
+## [3.0.7](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.0.7) (2026-05-04)
+
+### Bug Fixes
+
+* Fixed Homebridge Config UI layout rendering by moving `layout` to the top level of `config.schema.json` so the collapsible **Advanced Settings** fieldset is shown and applied correctly.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.6...v3.0.7
+
+## [3.0.6](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.0.6) (2026-05-03)
+
+### Enhancements
+
+* Added npm update support:
+  * New `checkNpmUpdates` option to detect newer npm versions.
+  * New `autoUpdateNpm` option to automatically update npm.
+* npm support is now environment-safe:
+  * If npm is unavailable, npm checks are skipped without crashing.
+  * If `autoUpdateNpm` is enabled but npm is unavailable, a clear warning is logged and failure state is tracked.
+* Simplified Matter selection config:
+  * Removed `preferMatter` from user config and schema.
+  * Protocol selection now auto-prefers Matter when available and `enableMatter` is true.
+* Reordered Config UI fields in `config.schema.json` into a more logical top-to-bottom flow.
+
+### Bug Fixes
+
+* Improved Homebridge UI action request compatibility for restart/backup flows:
+  * Added JSON request headers/content-length for action endpoints.
+  * Added restart method fallback (`PUT` then `POST`) to support API variations across UI versions.
+  * Reduces `HTTP 415 Unsupported Media Type` restart failures.
+
+### Documentation
+
+* Updated README for new npm options and behavior when npm is not installed.
+* Removed `preferMatter` from README examples and option table.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.5...v3.0.6
+
+## [3.0.5](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.0.5) (2026-05-03)
+
+### Bug Fixes
+
+* Fixed restart API calls not detecting HTTP error responses (4xx/5xx) — error responses are now properly rejected instead of treated as successful
+* Improved restart logging to show actual API response details and endpoint-specific error messages for better diagnostics
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.4...v3.0.5
+
+## [3.0.4](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.0.4) (2026-05-03)
+
+### Bug Fixes
+
+* Fix update checks not starting after Homebridge restart ([#233](https://github.com/homebridge-plugins/homebridge-updater/pull/233)) — Cached accessory restoration was preventing scheduled checks and cron jobs from being initialized. Now checks are always started regardless of whether the accessory was newly created or restored from cache.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.3...v3.0.4
+
+## [3.0.3](https://github.com/homebridge-plugins/homebridge-updater/compare/tag/v3.0.3) (2026-05-03)
+### Bug Fixes
+
+* respect `failureSensorType: "none"` and auto-disable failure sensor when no auto-updates are configured ([#231](https://github.com/homebridge-plugins/homebridge-updater/issues/231)) ([c007709](https://github.com/homebridge-plugins/homebridge-updater/commit/c007709301063abe5df1ca3b24fae12c1f50e75e))
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.2...v3.0.3
+
+## [3.0.2](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v3.0.2) (2026-05-02)
+
+### Enhancements
+- Refactored sensor handling into shared protocol abstractions with a new unified sensor base:
+  - Added `MatterSensor` and `HAPSensor` implementations in `src/sensorBase.ts`.
+  - Added `UpdateSensor` orchestration in `src/updateSensor.ts`.
+  - Simplified platform classes by delegating sensor behavior to shared abstractions.
+- Improved runtime platform selection and startup behavior:
+  - Strengthened HAP/Matter proxy logic in `src/utils.ts`.
+  - Added explicit protocol selection flow from platform constructors to update sensor initialization.
+  - Added debug-level protocol selection logs for easier troubleshooting without noisy normal logs.
+
+### Bug Fixes
+- Fixed Matter startup regression where cached Matter accessories could be treated as orphaned on restart:
+  - Ensured stable proxy instantiation/delegation for Homebridge platform lifecycle handling.
+  - Improved Matter capability detection compatibility across Homebridge API shapes.
+  - Prevented mixed protocol registration by explicitly selecting `hap` or `matter` for sensor wiring.
+- Hardened accessory handling across platform implementations:
+  - Improved update/failure sensor registration and restore behavior in both HAP and Matter paths.
+
+### Other
+- Updated tests for platform proxy behavior and protocol selection edge cases in `src/utils.test.ts`.
+- Updated dependencies and lockfile metadata.
+- Regenerated docs and TypeDoc assets.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.1...v3.0.2
+
+## [3.0.1](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v3.0.1) (2026-04-29)
+
+### Bug Fixes
+- Fixed crash in Matter platform when running under ESM: removed use of `require` and now initialize Docker detection synchronously for compatibility with Homebridge v2.0+ and Node.js ESM environments.
+
+### Other
+- Internal refactor: clarified ESM limitations for Docker detection in Matter platform constructor.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v3.0.0...v3.0.1
+
+## [3.0.0](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v3.0.0) (2026-04-29)
+
+## What's Changed
+### Enhancements
+- Node.js update check and auto-update:
+  - The plugin can now check for new Node.js LTS versions and notify if an update is available. Controlled by the new `checkNodeUpdates` config option. Implements [#206](https://github.com/homebridge-plugins/homebridge-updater/issues/206).
+  - New config option: `autoUpdateNode` — If enabled, the plugin will attempt to automatically update Node.js using `hb-service update-node` when a new LTS version is detected and the system supports it.
+  - The plugin checks for `hb-service update-node` support before attempting the update, and logs the result (success or failure).
+  - If a Node.js update is available, a log line is emitted when the HomeKit/Matter sensor is tripped due to Node.js.
+  - The HomeKit/Matter sensor is now tripped if any update is available, including Node.js, Homebridge, UI, plugins, or Docker.
+- Suppress or log at debug level when no updates are found, instead of always logging "Found 0 available update(s)". Fixes [#224](https://github.com/homebridge-plugins/homebridge-updater/issues/224).
+- Log level for update notifications is now correct per update type (Homebridge, UI, plugins, Docker). Each update logs as info only if a new update is found for that type, otherwise as debug. Fixes [#225](https://github.com/homebridge-plugins/homebridge-updater/issues/225).
+- Full Homebridge v2.0 Matter support with HAP fallback. Matter is now the default platform when available and enabled, with seamless fallback to HAP if not.
+- Refactored to use a runtime proxy/factory pattern for platform selection (HAP vs Matter).
+- Added `preferMatter`, `enableMatter`, `disableMatter`, and `externalAccessory` options to configuration and schema.
+- Improved accessory registration and cleanup logic for both HAP and Matter, including external accessory support.
+- Switched all HTTP(S) requests to native Node.js http/https modules with manual retry and DNS caching (cacheable-lookup). Removed axios and axios-retry dependencies.
+- Updated documentation and schema for new features and options.
+
+### Bug Fixes
+- Croner cron jobs are now unref'd so they do not prevent Node.js from exiting cleanly. Fixes [#222](https://github.com/homebridge-plugins/homebridge-updater/issues/222).
+- Accessory/device name now uses the configured `name` property as the HomeKit/Matter accessory name, not just the platform name. Fixes [#223](https://github.com/homebridge-plugins/homebridge-updater/issues/223).
+
+### Other
+- Added and updated tests for new config options and proxy logic. All tests pass.
+- Updated all dependencies and removed unused packages for improved security and compatibility.
+- General code cleanup, improved file/class naming, and import clarity.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.7...v3.0.0
+
+## [2.3.7](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.7) (2025-12-01)
+
+### What's Changed
+- Clamp max DNS cache TTL to prevent excessive warnings ([#208](https://github.com/homebridge-plugins/homebridge-updater/pull/208))
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.6...v2.3.7
+
+## [2.3.6](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.6) (2025-11-01)
+
+### What's Changed
+- Add explicit warning when an outdated Homebridge UI (homebridge-config-ui-x) is detected, explaining that a newer UI version is required for full functionality ([#200](https://github.com/homebridge-plugins/homebridge-updater/pull/200))
+- Clarify the requirement notice to better guide users on updating the Homebridge UI
+- Housekeeping and updated dependencies.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.5...v2.3.6
+
+## [2.3.5](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.5) (2025-11-01)
+
+### What's Changed
+- Fix error where current Docker version is not found by @justjam2013 in https://github.com/homebridge-plugins/homebridge-updater/pull/166
+- v2.3.5 by @donavanbecker in https://github.com/homebridge-plugins/homebridge-updater/pull/189
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.4...v2.3.5
+
+## [2.3.4](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.4) (2025-09-14)
+
+### What's Changed
+- Fix error where current Docker version is not found by @justjam2013 in https://github.com/homebridge-plugins/homebridge-updater/pull/166
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.3...v2.3.4
+
+## [2.3.3](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.3) (2025-09-14)
+
+### What's Changed
+- v2.3.3 ([b7a4c9e](https://github.com/homebridge-plugins/homebridge-updater/commit/b7a4c9ec2b079b6f3e51411311573080b281d97c))
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.2...v2.3.3
+
+## [2.3.2](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.2) (2025-09-13)
+
+### What's Changed
+- Remove double variables for file and directory paths (#115) ([4743e21](https://github.com/homebridge-plugins/homebridge-updater/commit/4743e21c40bac30c1084d6ca0642f1d9ad723579))
+- Remove npm-check-updates (NCU) option as it doesn't add value (#117) ([d8f5ee5](https://github.com/homebridge-plugins/homebridge-updater/commit/d8f5ee5dfc3886d665b646803fa48c1f6506abdb))
+- Added cached dns lookup and retries (#118) ([f375adb](https://github.com/homebridge-plugins/homebridge-updater/commit/f375adb8c7a3bae35ff548c86c16a34e7daa037c))
+- Add NodeJS 24 support by updating engines.node to ^20 || ^22 || ^24 (rebased against beta-2.3.2) (#123) ([f64de4d](https://github.com/homebridge-plugins/homebridge-updater/commit/f64de4d1f3f6d4bf46102b9ca14716360aba6ce0))
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.1...v2.3.2
+
+## [2.3.1](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.1) (2025-09-03)
+
+### What's Changed
+- Merge branch 'latest' into beta-2.3.1 ([f30d910](https://github.com/homebridge-plugins/homebridge-updater/commit/f30d91080dd11fecafc84275bd078ce30e15fe2d))
+- Fix NCU filter regex construction to detect plugin updates correctly (#92) ([32733d8](https://github.com/homebridge-plugins/homebridge-updater/commit/32733d889fc9bdcf0d58f279f387b105a36bfc06))
+- v2.3.1 ([c6b1af1](https://github.com/homebridge-plugins/homebridge-updater/commit/c6b1af1844f90520bb9217171d6117c6425f58d9))
+- Fix Homebridge restart failure: use PUT method and implement endpoint fallback (#101) ([feb32be](https://github.com/homebridge-plugins/homebridge-updater/commit/feb32befefd97a5f87155ca95f58ebb105a83471))
+- Add name validation to prevent HomeKit pairing issues with child bridges (#91) ([4db28af](https://github.com/homebridge-plugins/homebridge-updater/commit/4db28afd90f4f5c21c10579d8d0da08e022ea8f6))
+- Patch ncu (#99) ([d3b7a3f](https://github.com/homebridge-plugins/homebridge-updater/commit/d3b7a3f5326142f1aa54a6d5247546e6803d8b48))
+- Parenthesis & patch ncu (#98) ([7796773](https://github.com/homebridge-plugins/homebridge-updater/commit/7796773d376e3ff936a9724109125fc1c671dd7f))
+- resolve __dirname is not defined (#97) ([c295a20](https://github.com/homebridge-plugins/homebridge-updater/commit/c295a20962e982b449bd1296b0b02708e1fde058))
+- Add automatic update functionality with configurable npm support, restart capability, automatic backup creation, and configurable failure notifications for Homebridge, UI, and plugins (#94) ([e58b488](https://github.com/homebridge-plugins/homebridge-updater/commit/e58b488edf02eccf801627314107a70f08c36693))
+- Fix npm-check-updates CLI path for v16+ compatibility (#96) ([acf607c](https://github.com/homebridge-plugins/homebridge-updater/commit/acf607c9cd5944eb418b88a8465744cb942d1460))
+- Update available update list (#89) ([bd84b83](https://github.com/homebridge-plugins/homebridge-updater/commit/bd84b83556c3bffdac0d35f15e1047f7c54e8887))
+- Fix ReferenceError: __dirname is not defined in ESM module (#86) ([5668b01](https://github.com/homebridge-plugins/homebridge-updater/commit/5668b015900d708bbeb4a38d82fac14a7215f022))
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.3.0...v2.3.1
+
+## [2.3.0](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.3.0) (2025-08-18)
+
+### What's Changed
+- Display newer updates in logs
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.2.1...v2.3.0
+
+## [2.2.1](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.2.1) (2025-08-09)
+
+### What's Changed
+- Change logging to daily
+- Fix log info output
+
+## [2.1.0](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.1.0) (2025-08-09)
+
+### What's Changed
+- Output available updates to log
+- Fix plugin update check
+- Fixed version checks and added debug output
+- Add docker version check and fixed NCU search
+- Fixed field names
+- Fix default check value
+- Select which components to check for updates
+- Fix Labler
+- Build fixes and improvements
+
+## [2.0.2](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.0.2) (2025-03-04)
+
+### What's Changes
+- Housekeeping and updated dependencies.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.0.1...v2.0.2
+
+## [2.0.1](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.0.1) (2025-01-25)
+
+### What's Changes
+- Housekeeping and updated dependencies.
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v2.0.0...v2.0.1
+
+## [2.0.0](https://github.com/homebridge-plugins/homebridge-updater/releases/tag/v2.0.0) (2025-01-16)
+
+### What's Changes
+- This plugins has moved to a scoped plugin under the `@homebridge-plugins` org.
+  - Homebridge UI is designed to transition you to the new scoped plugin.
+- Updated to ES Module
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-updater/compare/v1.0.2...v2.0.0

package/CLAUDE.md

@@ -0,0 +1,43 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+- `npm run build` — `rimraf ./dist && tsc && npm run plugin-ui`. The `plugin-ui` step rsyncs `src/homebridge-ui/public/index.html` into `dist/` (the custom settings UI). Skipping it produces a broken published package.
+- `npm run lint` — ESLint over the whole repo with `--max-warnings=0`. CI fails on any warning. `npm run lint:fix` to autofix.
+- `npm test` — vitest, colocated `src/**/*.test.ts` files (see `vitest.config.ts`). `npm run test:watch` and `npm run test-coverage` also available.
+- `npm run watch` — build, `npm link`, then `nodemon`: recompiles and restarts on `src/**/*.ts` changes (see `nodemon.json`).
+- `npm run docs` — typedoc into `docs/` (gitignored — generated output is never committed).
+- `npm run prepublishOnly` — lint then build; runs automatically on publish.
+
+CI (`.github/workflows/build.yml`) runs install + lint on Node 22.x/24.x. Releases publish via `.github/workflows/release.yml`: a GitHub release (tag `vX.Y.Z`) publishes to npm's `latest` tag; pushes to `beta-X.Y.Z` / `alpha-X.Y.Z` branches publish incrementing prerelease versions to the `beta` / `alpha` tags.
+
+Supported Node: `^22.12.0 || ^24.0.0`. Homebridge: `^1.11.4 || ^2.0.0`.
+
+## Architecture
+
+Homebridge dynamic platform plugin (`platform: "HomebridgeUpdater"`, package `@homebridge-plugins/homebridge-updater`) that checks npm for newer versions of Homebridge itself and of installed plugins, and surfaces "an update is available" to HomeKit as a sensor. Unlike the other plugins it talks to no device — it reads the local Homebridge install and the public npm registry.
+
+### HAP/Matter platform selection
+
+`src/index.ts` registers a runtime proxy (`createPlatformProxy` in `src/utils.ts`) that instantiates the Matter platform (`src/Platform.Matter.ts`) when Homebridge reports Matter available+enabled, otherwise the HAP `src/Platform.HAP.ts`. Matter API calls must stay optional-chained.
+
+### Update checking (`src/updateCheckCore.ts`)
+
+Enumerates installed plugins and queries `registry.npmjs.org` (over `https` with a `cacheable-lookup` DNS cache) for the latest published version of each, plus the running Node/Homebridge versions. Checks are scheduled with `croner`. Results feed the sensors.
+
+### Sensors (`src/updateSensor.ts`, `src/failureSensor.ts`, `src/sensorBase.ts`)
+
+Each "update available" indicator is exposed as a HomeKit sensor whose **type is user-selectable** via `sensorType` in `PluginUpdatePlatformConfig` (`src/configTypes.ts`) — motion, contact, leak, occupancy, smoke, etc. `failureSensor.ts` reports when a check itself failed. `configMigration.ts` upgrades older config shapes on load.
+
+### Custom UI backend (`src/ui-api.ts`)
+
+The settings UI server signs a short-lived JWT (`jsonwebtoken`) to authenticate its own requests. `Buffer`/`process` are imported from `node:*` rather than used as globals.
+
+## Conventions
+
+- TypeScript ESM (`"type": "module"`): relative imports use `.js` extensions even from `.ts` source.
+- ESLint is `@antfu/eslint-config` (flat config in `eslint.config.js`): single quotes, 1tbs braces, `curly` multi-line only (single-line guards must use full multi-line braces), sorted imports. Run `npm run lint:fix` before committing.
+- `config.schema.json` defines the Homebridge UI form and must stay in sync with `PluginUpdatePlatformConfig` in `src/configTypes.ts`.
+- Licensed BSD-2-Clause — keep the LICENSE and upstream attribution intact.

package/README.md

@@ -1,117 +1,59 @@
-# homebridge-updater
-
-[![npm](https://img.shields.io/npm/v/@homebridge-plugins/homebridge-updater) ![npm](https://img.shields.io/npm/dt/@homebridge-plugins/homebridge-updater)](https://www.npmjs.com/package/@homebridge-plugins/homebridge-updater) [![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
-
-A [Homebridge](https://github.com/nfarina/homebridge) plugin that reports update availability as sensors and can optionally run automatic updates.
-
-## Features
-
-- Works with both HomeKit Accessory Protocol (HAP) and Matter at runtime
-- Exposes an update availability sensor
-- Exposes an optional failure sensor for automatic update/restart failures
-- Checks for updates to Node.js (LTS), Homebridge, Homebridge UI, plugins, and Docker images
-- Supports optional auto-updates for Node.js, Homebridge, Homebridge UI, and plugins
-- Intentionally does not auto-update Docker containers (check-only)
-
-## Installation
-
-1. Install Homebridge using the [official instructions](https://github.com/homebridge/homebridge/wiki).
-2. Install this plugin using: `sudo npm install -g @homebridge-plugins/homebridge-updater`.
-3. Update your configuration file. See sample config.json snippet below.
-
-### Configuration
-
-Configuration sample:
-
-```json
-"platforms": [
-    {
-        "platform": "HomebridgeUpdater",
-        "name": "Plugin Update",
-        "sensorType": "contact",
-        "failureSensorType": "motion",
-        "checkNodeUpdates": true,
-        "checkNpmUpdates": true,
-        "checkHomebridgeUpdates": true,
-        "checkHomebridgeUIUpdates": true,
-        "checkPluginUpdates": true,
-        "checkDockerUpdates": false,
-        "initialCheckDelay": 10,
-        "autoUpdateNode": false,
-        "autoUpdateNpm": false,
-        "autoUpdateHomebridge": false,
-        "autoUpdateHomebridgeUI": false,
-        "autoUpdatePlugins": false,
-        "allowDirectNpmUpdates": false,
-        "autoRestartAfterUpdates": false,
-        "respectDisabledPlugins": true,
-        "enableMatter": true
-    }
-]
-```
-
-#### Fields
-
-All sensor type options are:
-
-- `motion`
-- `contact`
-- `occupancy`
-- `humidity`
-- `light`
-- `air`
-- `leak`
-- `smoke`
-- `dioxide`
-- `monoxide`
-
-`failureSensorType` also supports `none` to disable the failure sensor.
-
-| Field | Description | Default |
-| --- | --- | --- |
-| `platform` | Must always be `HomebridgeUpdater` | Required |
-| `name` | Accessory name shown in Home app | `Plugin Update` |
-| `sensorType` | Sensor type for the main update sensor | `motion` |
-| `failureSensorType` | Sensor type for auto-update failure status, or `none` to disable | `motion` |
-| `checkNodeUpdates` | Check for newer Node.js LTS versions | `false` |
-| `checkNpmUpdates` | Check for newer npm versions when npm is installed | `false` |
-| `checkHomebridgeUpdates` | Check for Homebridge server updates | `true` |
-| `checkHomebridgeUIUpdates` | Check for Homebridge Config UI updates | `true` |
-| `checkPluginUpdates` | Check for installed plugin updates | `true` |
-| `checkDockerUpdates` | Check for newer Docker image versions when running in Docker | `false` |
-| `initialCheckDelay` | Delay in seconds before the first check after startup | `10` |
-| `autoUpdateNode` | Automatically run Node.js updates using `hb-service update-node` when supported | `false` |
-| `autoUpdateNpm` | Automatically update npm when a newer version is available | `false` |
-| `autoUpdateHomebridge` | Automatically update Homebridge | `false` |
-| `autoUpdateHomebridgeUI` | Automatically update Homebridge Config UI | `false` |
-| `autoUpdatePlugins` | Automatically update plugins | `false` |
-| `allowDirectNpmUpdates` | Allow direct npm update commands when UI API is unavailable | `false` |
-| `autoRestartAfterUpdates` | Restart Homebridge after successful auto-updates | `false` |
-| `respectDisabledPlugins` | Respect hidden update notifications configured in Homebridge UI | `true` |
-| `enableMatter` | Enable Matter support when available in Homebridge | `true` |
-
-## How It Works
-
-- The plugin checks selected update sources on a schedule.
-- If any enabled source has updates, the main sensor is set to active.
-- If automatic updates are enabled and an update/restart fails, the failure sensor is set to active.
-- If no auto-update options are enabled, the failure sensor is automatically not exposed.
-
-## Automatic Updates
-
-When automatic updates are enabled, the plugin will:
-
-1. Attempt to create a backup before updates when Homebridge UI is available.
-2. Perform configured updates (Node.js, Homebridge, Homebridge UI, plugins).
-3. Optionally restart Homebridge if `autoRestartAfterUpdates` is enabled.
-4. Surface failures through the failure sensor.
-
-Automatic updates are disabled by default. Enable them only if your environment has appropriate permissions and you are comfortable with unattended updates.
-
-If Homebridge UI is not configured, automatic updates require `allowDirectNpmUpdates: true`.
-
-If npm is not installed in your environment, npm checks and npm auto-update are skipped safely.
-
-## Docker Notes
-
-Docker update checks are notification-only. The plugin does not attempt in-container self-updates by design, to avoid interrupting or corrupting the running container.
+<p align="center">
+   <a href="https://github.com/homebridge-plugins/homebridge-updater"><img alt="homebridge-updater" src="https://raw.githubusercontent.com/homebridge-plugins/homebridge-updater/latest/branding/Homebridge_x_Updater.png" width="600px"></a>
+</p>
+<span align="center">
+
+## homebridge-updater
+
+Homebridge plugin that surfaces available Homebridge and plugin updates as HomeKit sensors
+
+[![npm](https://img.shields.io/npm/v/@homebridge-plugins/homebridge-updater/latest?label=latest)](https://www.npmjs.com/package/@homebridge-plugins/homebridge-updater)
+[![npm](https://img.shields.io/npm/v/@homebridge-plugins/homebridge-updater/beta?label=beta)](https://github.com/homebridge/homebridge/wiki/How-to-Install-Alternate-Plugin-Versions)<br>
+[![npm](https://img.shields.io/npm/dt/@homebridge-plugins/homebridge-updater)](https://www.npmjs.com/package/@homebridge-plugins/homebridge-updater)
+[![Discord](https://img.shields.io/discord/432663330281226270?color=728ED5&logo=discord&label=hb-discord)](https://discord.gg/bHjKNkN)
+
+</span>
+
+### Plugin Information
+
+- This plugin checks for updates to Homebridge and your installed plugins, and exposes the result to HomeKit. The plugin:
+  - reads your local Homebridge install and queries the public npm registry - no account or device is required
+  - lets you choose which HomeKit sensor type represents "an update is available" (for example a motion, contact or occupancy sensor)
+  - can optionally expose the sensors over Matter as well as HomeKit
+
+### Prerequisites
+
+- To use this plugin, you will need to already have:
+  - [Node](https://nodejs.org): latest version of `v22` or `v24` - any other major version is not supported.
+  - [Homebridge](https://homebridge.io): `v2` - refer to link for more information and installation instructions.
+
+### Setup
+
+- [Installation](https://github.com/homebridge-plugins/homebridge-updater/wiki/Installation)
+- [Configuration](https://github.com/homebridge-plugins/homebridge-updater/wiki/Configuration)
+- [Beta Version](https://github.com/homebridge-plugins/homebridge-updater/wiki/Beta-Version)
+- [Node Version](https://github.com/homebridge-plugins/homebridge-updater/wiki/Node-Version)
+
+### Features
+
+- A HomeKit sensor that trips when a Homebridge or plugin update is available
+- Your choice of sensor type for the indicator
+- A separate sensor that reports when an update check itself failed
+- Scheduled, automatic re-checks
+
+### Help/About
+
+- [Common Errors](https://github.com/homebridge-plugins/homebridge-updater/wiki/Common-Errors)
+- [Support Request](https://github.com/homebridge-plugins/homebridge-updater/issues/new/choose)
+- [Changelog](https://github.com/homebridge-plugins/homebridge-updater/blob/latest/CHANGELOG.md)
+- [About Me](https://github.com/sponsors/bwp91)
+
+### Credits
+
+- To David Maher (Sunoo): the original creator of this plugin.
+- To the creators/contributors of [Homebridge](https://homebridge.io) who make this plugin possible.
+
+### Disclaimer
+
+- This plugin is a personal project that I maintain in my free time.
+- Use this plugin entirely at your own risk - please see licence for more information.

package/config.schema.json

@@ -215,6 +215,12 @@
         "description": "Automatically restart Homebridge after successful automatic updates to apply changes",
         "default": false
       },
+      "autoUpdateSkipMajorVersions": {
+        "title": "Skip major versions when auto-updating",
+        "type": "boolean",
+        "description": "Only auto-update minor and patch versions. New major versions are still shown as available but are left for you to install manually, to avoid unexpected breaking changes.",
+        "default": false
+      },
       "uiNotice": {
         "title": "",
         "description": "Note: This feature may require updating Homebridge UI to a newer version. It is recommended to update to the latest version.",
@@ -250,6 +256,7 @@
         "autoUpdatePlugins",
         "allowDirectNpmUpdates",
         "autoRestartAfterUpdates",
+        "autoUpdateSkipMajorVersions",
         "uiNotice"
       ]
     }

package/dist/Platform.HAP.js

@@ -31,7 +31,7 @@ export class PluginUpdatePlatform {
         api.on('didFinishLaunching', this.handleLegacyMigration.bind(this));
         this.updateSensor = new UpdateSensor(log, config, api, {
             protocol: 'hap',
-            onFailureStateChange: isFailureSensorEnabled(config) ? (failed) => this.failureSensor.setState(failed) : undefined,
+            onFailureStateChange: isFailureSensorEnabled(config) ? failed => this.failureSensor.setState(failed) : undefined,
         });
         // Register the failure sensor accessory
         api.on('didFinishLaunching', this.addFailureSensor.bind(this));

package/dist/Platform.HAP.js.map

@@ -1 +1 @@
-{"version":3,"file":"Platform.HAP.js","sourceRoot":"","sources":["../src/Platform.HAP.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Platform.HAP.js","sourceRoot":"","sources":["../src/Platform.HAP.ts"],"names":[],"mappings":"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"}