@homebridge-plugins/homebridge-updater 3.0.7

package/LICENSE

@@ -0,0 +1,25 @@
+BSD 2-Clause License
+
+Copyright (c) 2021-2024, David Maher
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,117 @@
+# 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.

package/config.schema.json

@@ -0,0 +1,257 @@
+{
+  "pluginAlias": "HomebridgeUpdater",
+  "pluginType": "platform",
+  "singular": true,
+  "customUi": true,
+  "customUiPath": "./dist/homebridge-ui",
+  "headerDisplay": "A Homebridge plugin for checking for updates to Homebridge and plugins.",
+  "footerDisplay": "Raise [Issues](https://github.com/homebridge-plugins/homebridge-updater/issues) or submit [Pull Requests](https://github.com/homebridge-plugins/homebridge-updater/pulls) on [Project Page](https://github.com/homebridge-plugins/homebridge-updater).",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Plugin Update",
+        "description": "A unique name for the accessory. It will be used as the accessory name in HomeKit. Can only contain letters, numbers, spaces, hyphens, and underscores. Periods and other special characters are not allowed as they can cause HomeKit pairing issues.",
+        "pattern": "^[a-zA-Z0-9\\s_-]+$",
+        "minLength": 1,
+        "maxLength": 64
+      },
+      "sensorType": {
+        "title": "Sensor Type",
+        "type": "string",
+        "default": "motion",
+        "description": "What type of sensor will be exposed to HomeKit.",
+        "oneOf": [
+          {
+            "title": "Motion Sensor",
+            "enum": ["motion"]
+          },
+          {
+            "title": "Contact Sensor",
+            "enum": ["contact"]
+          },
+          {
+            "title": "Occupancy Sensor",
+            "enum": ["occupancy"]
+          },
+          {
+            "title": "Humidity Sensor",
+            "enum": ["humidity"]
+          },
+          {
+            "title": "Light Sensor",
+            "enum": ["light"]
+          },
+          {
+            "title": "Air Quality Sensor",
+            "enum": ["air"]
+          },
+          {
+            "title": "Leak Sensor",
+            "enum": ["leak"]
+          },
+          {
+            "title": "Smoke Sensor",
+            "enum": ["smoke"]
+          },
+          {
+            "title": "Carbon Dioxide Sensor",
+            "enum": ["dioxide"]
+          },
+          {
+            "title": "Carbon Monoxide Sensor",
+            "enum": ["monoxide"]
+          }
+        ]
+      },
+      "failureSensorType": {
+        "title": "Failure Sensor Type",
+        "type": "string",
+        "default": "motion",
+        "description": "What type of sensor will be used for update/restart failure notifications (only shown when auto-updates are enabled).",
+        "oneOf": [
+          {
+            "title": "Motion Sensor",
+            "enum": ["motion"]
+          },
+          {
+            "title": "Contact Sensor",
+            "enum": ["contact"]
+          },
+          {
+            "title": "Occupancy Sensor",
+            "enum": ["occupancy"]
+          },
+          {
+            "title": "Humidity Sensor",
+            "enum": ["humidity"]
+          },
+          {
+            "title": "Light Sensor",
+            "enum": ["light"]
+          },
+          {
+            "title": "Air Quality Sensor",
+            "enum": ["air"]
+          },
+          {
+            "title": "Leak Sensor",
+            "enum": ["leak"]
+          },
+          {
+            "title": "Smoke Sensor",
+            "enum": ["smoke"]
+          },
+          {
+            "title": "Carbon Dioxide Sensor",
+            "enum": ["dioxide"]
+          },
+          {
+            "title": "Carbon Monoxide Sensor",
+            "enum": ["monoxide"]
+          },
+          {
+            "title": "None (Disabled)",
+            "enum": ["none"]
+          }
+        ]
+      },
+      "enableMatter": {
+        "title": "Enable Matter support",
+        "type": "boolean",
+        "description": "Enable Homebridge Matter support when running on Homebridge v2.0 or later with Matter enabled.",
+        "default": true
+      },
+      "initialCheckDelay": {
+        "title": "Initial Check Delay (seconds)",
+        "type": "integer",
+        "description": "Delay in seconds before performing the initial update check after startup",
+        "default": 10,
+        "minimum": 0,
+        "maximum": 300
+      },
+      "checkNodeUpdates": {
+        "title": "Check for Node.js updates",
+        "type": "boolean",
+        "description": "Check if a newer LTS version of Node.js is available.",
+        "default": false
+      },
+      "checkNpmUpdates": {
+        "title": "Check for npm updates",
+        "type": "boolean",
+        "description": "Check if a newer npm version is available. Ignored when npm is not installed.",
+        "default": false
+      },
+      "checkHomebridgeUpdates": {
+        "title": "Check for Homebridge updates",
+        "type": "boolean",
+        "description": "Check if an update is available for the Homebridge server",
+        "default": true
+      },
+      "checkHomebridgeUIUpdates": {
+        "title": "Check for Homebridge Config UI updates",
+        "type": "boolean",
+        "description": "Check if an update is available for the Homebridge UI",
+        "default": true
+      },
+      "checkPluginUpdates": {
+        "title": "Check for plugin updates",
+        "type": "boolean",
+        "description": "Check if updates are available for any installed plugins",
+        "default": true
+      },
+      "checkDockerUpdates": {
+        "title": "Check for Docker image updates",
+        "type": "boolean",
+        "description": "Check if Docker image updates are available (ignored if not running in Docker container)"
+      },
+      "respectDisabledPlugins": {
+        "title": "Respect disabled plugin update notifications",
+        "type": "boolean",
+        "description": "When enabled, respects the 'Hide update notifications for this plugin' setting from homebridge-config-ui-x. Plugins marked to hide updates will not trigger notifications.",
+        "default": true
+      },
+      "autoUpdateNode": {
+        "title": "Auto-update Node.js",
+        "type": "boolean",
+        "description": "Automatically update Node.js using hb-service update-node when a new LTS version is available and supported.",
+        "default": false
+      },
+      "autoUpdateNpm": {
+        "title": "Auto-update npm",
+        "type": "boolean",
+        "description": "Automatically update npm when a newer version is available. Ignored when npm is not installed.",
+        "default": false
+      },
+      "autoUpdateHomebridge": {
+        "title": "Auto-update Homebridge",
+        "type": "boolean",
+        "description": "Automatically install Homebridge updates when available (requires homebridge-config-ui-x and sufficient npm privileges)",
+        "default": false
+      },
+      "autoUpdateHomebridgeUI": {
+        "title": "Auto-update Homebridge Config UI",
+        "type": "boolean",
+        "description": "Automatically install Homebridge Config UI updates when available (requires homebridge-config-ui-x and sufficient npm privileges)",
+        "default": false
+      },
+      "autoUpdatePlugins": {
+        "title": "Auto-update plugins",
+        "type": "boolean",
+        "description": "Automatically install plugin updates when available (requires homebridge-config-ui-x and sufficient npm privileges)",
+        "default": false
+      },
+      "allowDirectNpmUpdates": {
+        "title": "Allow direct npm updates",
+        "type": "boolean",
+        "description": "Allow automatic updates using direct npm commands even when homebridge-config-ui-x is not available (requires sufficient npm privileges)",
+        "default": false
+      },
+      "autoRestartAfterUpdates": {
+        "title": "Auto-restart after updates",
+        "type": "boolean",
+        "description": "Automatically restart Homebridge after successful automatic updates to apply 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.",
+        "type": "object",
+        "properties": {}
+      }
+    },
+    "required": ["name", "sensorType"]
+  },
+  "layout": [
+    "name",
+    "sensorType",
+    "failureSensorType",
+    {
+      "type": "fieldset",
+      "title": "Advanced Settings",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        "enableMatter",
+        "initialCheckDelay",
+        "checkNodeUpdates",
+        "checkNpmUpdates",
+        "checkHomebridgeUpdates",
+        "checkHomebridgeUIUpdates",
+        "checkPluginUpdates",
+        "checkDockerUpdates",
+        "respectDisabledPlugins",
+        "autoUpdateNode",
+        "autoUpdateNpm",
+        "autoUpdateHomebridge",
+        "autoUpdateHomebridgeUI",
+        "autoUpdatePlugins",
+        "allowDirectNpmUpdates",
+        "autoRestartAfterUpdates",
+        "uiNotice"
+      ]
+    }
+  ]
+}

package/dist/Platform.HAP.d.ts

@@ -0,0 +1,16 @@
+import type { API, DynamicPlatformPlugin, Logging, PlatformConfig } from 'homebridge';
+export declare class PluginUpdatePlatform implements DynamicPlatformPlugin {
+    private readonly log;
+    private readonly config;
+    private readonly api;
+    private updateSensor;
+    private failureSensor;
+    private readonly updateSensorUuid;
+    private readonly failureSensorUuid;
+    private failureSensorRegistered;
+    private cachedFailureAccessory?;
+    constructor(log: Logging, config: PlatformConfig, api: API);
+    private addFailureSensor;
+    configureAccessory(accessory: any): void;
+}
+//# sourceMappingURL=Platform.HAP.d.ts.map

package/dist/Platform.HAP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.HAP.d.ts","sourceRoot":"","sources":["../src/Platform.HAP.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAqB,cAAc,EAAE,MAAM,YAAY,CAAA;AAOxG,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAK;IACzB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,uBAAuB,CAAQ;IACvC,OAAO,CAAC,sBAAsB,CAAC,CAAmB;gBAEtC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG;IAe1D,OAAO,CAAC,gBAAgB;IAuBxB,kBAAkB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;CA4BzC"}

package/dist/Platform.HAP.js

@@ -0,0 +1,77 @@
+import { FailureSensor } from './failureSensor.js';
+import { FAILURE_SENSOR_UUID_KEY, PLATFORM_NAME, PLUGIN_NAME, UPDATE_SENSOR_UUID_KEY } from './settings.js';
+import { UpdateSensor } from './updateSensor.js';
+import { isFailureSensorEnabled } from './utils.js';
+export class PluginUpdatePlatform {
+    log;
+    config;
+    api;
+    updateSensor;
+    failureSensor;
+    updateSensorUuid;
+    failureSensorUuid;
+    failureSensorRegistered = false;
+    cachedFailureAccessory;
+    constructor(log, config, api) {
+        this.log = log;
+        this.config = config;
+        this.api = api;
+        this.updateSensorUuid = api.hap.uuid.generate(UPDATE_SENSOR_UUID_KEY);
+        this.failureSensorUuid = api.hap.uuid.generate(FAILURE_SENSOR_UUID_KEY);
+        this.failureSensor = new FailureSensor(log, api, config.failureSensorType || config.sensorType, 'hap');
+        this.updateSensor = new UpdateSensor(log, config, api, {
+            protocol: 'hap',
+            onFailureStateChange: isFailureSensorEnabled(config) ? (failed) => this.failureSensor.setState(failed) : undefined,
+        });
+        // Register the failure sensor accessory
+        api.on('didFinishLaunching', this.addFailureSensor.bind(this));
+    }
+    addFailureSensor() {
+        // If the failure sensor has been disabled, remove any previously cached accessory
+        if (!isFailureSensorEnabled(this.config)) {
+            if (this.cachedFailureAccessory) {
+                this.api.unregisterPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [this.cachedFailureAccessory]);
+                this.cachedFailureAccessory = undefined;
+                this.log.info('Removed cached failure sensor accessory (failure sensor is disabled)');
+            }
+            return;
+        }
+        if (this.failureSensorRegistered) {
+            return;
+        }
+        const Accessory = this.api.platformAccessory;
+        const failureAccessory = new Accessory('Plugin Update Failure', this.failureSensorUuid);
+        this.failureSensor.configure(failureAccessory);
+        this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [failureAccessory]);
+        this.failureSensorRegistered = true;
+    }
+    // Handle cached accessories: restore event and delegate configuration
+    configureAccessory(accessory) {
+        if (accessory && typeof accessory.on === 'function') {
+            accessory.on('identify', () => {
+                if (this.updateSensor && this.updateSensor.log) {
+                    this.updateSensor.log(`${accessory.displayName} identify requested!`);
+                }
+            });
+        }
+        // Restore for update sensor
+        if (accessory.UUID === this.updateSensorUuid) {
+            this.updateSensor.configureAccessory(accessory);
+            return;
+        }
+        // Restore for failure sensor
+        if (accessory.UUID === this.failureSensorUuid) {
+            if (!isFailureSensorEnabled(this.config)) {
+                // Sensor is disabled — keep track of the cached accessory so it can be
+                // unregistered once `didFinishLaunching` fires.
+                this.cachedFailureAccessory = accessory;
+                return;
+            }
+            this.failureSensor.configure(accessory);
+            this.failureSensorRegistered = true;
+            return;
+        }
+        this.log.warn(`Ignoring unknown cached accessory: ${accessory.displayName}`);
+    }
+}
+//# sourceMappingURL=Platform.HAP.js.map

package/dist/Platform.HAP.js.map

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

package/dist/Platform.Matter.d.ts

@@ -0,0 +1,7 @@
+import type { API, Logging, PlatformConfig } from 'homebridge';
+export declare class PluginUpdateMatterPlatform {
+    private updateSensor;
+    private failureSensor;
+    constructor(log: Logging, config: PlatformConfig, api: API);
+}
+//# sourceMappingURL=Platform.Matter.d.ts.map

package/dist/Platform.Matter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.Matter.d.ts","sourceRoot":"","sources":["../src/Platform.Matter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAM9D,qBAAa,0BAA0B;IACrC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAe;gBAExB,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG;CAa3D"}

package/dist/Platform.Matter.js

@@ -0,0 +1,21 @@
+import { FailureSensor } from './failureSensor.js';
+import { UpdateSensor } from './updateSensor.js';
+import { isFailureSensorEnabled } from './utils.js';
+export class PluginUpdateMatterPlatform {
+    updateSensor;
+    failureSensor;
+    constructor(log, config, api) {
+        this.failureSensor = new FailureSensor(log, api, config.failureSensorType || config.sensorType, 'matter');
+        this.updateSensor = new UpdateSensor(log, config, api, {
+            protocol: 'matter',
+            onFailureStateChange: isFailureSensorEnabled(config) ? (failed) => this.failureSensor.setState(failed) : undefined,
+        });
+        // Register the failure sensor as a separate Matter device only when enabled
+        if (isFailureSensorEnabled(config)) {
+            const deviceName = config.name || 'Plugin Update Check';
+            const failureDeviceName = `${deviceName} Failure`;
+            this.failureSensor.configure({ displayName: failureDeviceName });
+        }
+    }
+}
+//# sourceMappingURL=Platform.Matter.js.map

package/dist/Platform.Matter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.Matter.js","sourceRoot":"","sources":["../src/Platform.Matter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,OAAO,0BAA0B;IAC7B,YAAY,CAAc;IAC1B,aAAa,CAAe;IAEpC,YAAY,GAAY,EAAE,MAAsB,EAAE,GAAQ;QACxD,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QACzG,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;YACrD,QAAQ,EAAE,QAAQ;YAClB,oBAAoB,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;SACnH,CAAC,CAAA;QACF,4EAA4E;QAC5E,IAAI,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,MAAM,UAAU,GAAI,MAAc,CAAC,IAAI,IAAI,qBAAqB,CAAA;YAChE,MAAM,iBAAiB,GAAG,GAAG,UAAU,UAAU,CAAA;YACjD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAS,CAAC,CAAA;QACzE,CAAC;IACH,CAAC;CACF"}

package/dist/configMigration.d.ts

@@ -0,0 +1,4 @@
+import type { API } from 'homebridge';
+export declare function migratePlatformAliasInPluginConfigs(configs: Array<Record<string, unknown>>): number;
+export declare function migrateLegacyPlatformAlias(api: API): Promise<void>;
+//# sourceMappingURL=configMigration.d.ts.map

package/dist/configMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configMigration.d.ts","sourceRoot":"","sources":["../src/configMigration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAOrC,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAcnG;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxE"}

package/dist/configMigration.js

@@ -0,0 +1,45 @@
+import { PLUGIN_NAME, PLATFORM_NAME } from './settings.js';
+import { UiApi } from './ui-api.js';
+const LEGACY_PLATFORM_NAME = 'PluginUpdate';
+export function migratePlatformAliasInPluginConfigs(configs) {
+    if (!Array.isArray(configs)) {
+        return 0;
+    }
+    let updated = 0;
+    for (const platformConfig of configs) {
+        if (platformConfig?.platform === LEGACY_PLATFORM_NAME) {
+            platformConfig.platform = PLATFORM_NAME;
+            updated++;
+        }
+    }
+    return updated;
+}
+export async function migrateLegacyPlatformAlias(api) {
+    const hbStoragePath = api.user?.storagePath?.();
+    if (!hbStoragePath) {
+        return;
+    }
+    const silentLog = {
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+        debug: () => { },
+    };
+    try {
+        const uiApi = new UiApi(hbStoragePath, silentLog);
+        if (!uiApi.isConfigured()) {
+            return;
+        }
+        const pluginConfigs = await uiApi.getPluginConfig(PLUGIN_NAME);
+        const updated = migratePlatformAliasInPluginConfigs(pluginConfigs);
+        if (!updated) {
+            return;
+        }
+        await uiApi.updatePluginConfig(PLUGIN_NAME, pluginConfigs);
+        await uiApi.savePluginConfig(PLUGIN_NAME);
+    }
+    catch {
+        // Ignore migration errors so plugin startup is never blocked.
+    }
+}
+//# sourceMappingURL=configMigration.js.map

package/dist/configMigration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configMigration.js","sourceRoot":"","sources":["../src/configMigration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC,MAAM,oBAAoB,GAAG,cAAc,CAAA;AAE3C,MAAM,UAAU,mCAAmC,CAAC,OAAuC;IACzF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,cAAc,IAAI,OAAO,EAAE,CAAC;QACrC,IAAI,cAAc,EAAE,QAAQ,KAAK,oBAAoB,EAAE,CAAC;YACtD,cAAc,CAAC,QAAQ,GAAG,aAAa,CAAA;YACvC,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,GAAQ;IACvD,MAAM,aAAa,GAAI,GAAG,CAAC,IAAY,EAAE,WAAW,EAAE,EAAE,CAAA;IACxD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAM;IACR,CAAC;IAED,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;KAChB,CAAA;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,aAAa,EAAE,SAAgB,CAAC,CAAA;QACxD,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;YAC1B,OAAM;QACR,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC,CAAA;QAC9D,MAAM,OAAO,GAAG,mCAAmC,CAAC,aAAa,CAAC,CAAA;QAClE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,MAAM,KAAK,CAAC,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;QAC1D,MAAM,KAAK,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC"}

package/dist/configMigration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=configMigration.test.d.ts.map

package/dist/configMigration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configMigration.test.d.ts","sourceRoot":"","sources":["../src/configMigration.test.ts"],"names":[],"mappings":""}

package/dist/configMigration.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { migratePlatformAliasInPluginConfigs } from './configMigration.js';
+describe('config migration', () => {
+    it('should migrate legacy platform alias in plugin config entries', () => {
+        const pluginConfigs = [
+            { platform: 'PluginUpdate', name: 'Legacy Updater' },
+            { platform: 'OtherPlugin', name: 'Other' },
+        ];
+        const updated = migratePlatformAliasInPluginConfigs(pluginConfigs);
+        expect(updated).toBe(1);
+        expect(pluginConfigs[0].platform).toBe('HomebridgeUpdater');
+        expect(pluginConfigs[1].platform).toBe('OtherPlugin');
+    });
+    it('should keep entries unchanged when no legacy alias exists', () => {
+        const pluginConfigs = [
+            { platform: 'HomebridgeUpdater', name: 'Updater' },
+        ];
+        const updated = migratePlatformAliasInPluginConfigs(pluginConfigs);
+        expect(updated).toBe(0);
+        expect(pluginConfigs[0].platform).toBe('HomebridgeUpdater');
+    });
+});
+//# sourceMappingURL=configMigration.test.js.map

package/dist/configMigration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configMigration.test.js","sourceRoot":"","sources":["../src/configMigration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,mCAAmC,EAAE,MAAM,sBAAsB,CAAA;AAE1E,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,aAAa,GAAmC;YACpD,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE;YACpD,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;SAC3C,CAAA;QAED,MAAM,OAAO,GAAG,mCAAmC,CAAC,aAAa,CAAC,CAAA;QAElE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACvB,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAC3D,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,aAAa,GAAmC;YACpD,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE;SACnD,CAAA;QAED,MAAM,OAAO,GAAG,mCAAmC,CAAC,aAAa,CAAC,CAAA;QAElE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACvB,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}