matterbridge-homey 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-10-28
+
+### Added
+
+- [platform]: Devices added to Homey are exposed right away, without a Matterbridge restart. The new `exposeNewDevices` setting (default on) turns this off.
+
+### Fixed
+
+- [platform]: Homey device changes are applied one at a time, so a device that changes while the plugin starts or adds it isn't registered twice.
+
 ## [0.2.0] - 2026-10-18
 
 ### Added

package/README.md

@@ -36,6 +36,7 @@ The key is shown only once, so copy it right away.
 | `outletList`                | These devices are exposed as plugs, whatever their Homey class.                                                                                             |
 | `capabilityBlackList`       | These Homey capabilities are never exposed, e.g. `meter_power`.                                                                                             |
 | `deviceCapabilityBlackList` | Capabilities not exposed for one device: the device name (or ID) and its list of capabilities, e.g. `{ "Multisensor": ["alarm_occupancy"] }`.               |
+| `exposeNewDevices`          | Expose devices added to Homey right away, without a restart (default on). The lists above still apply. When off, new devices are exposed after a restart.   |
 | `debug`                     | Log the homey-api debug output.                                                                                                                             |
 | `unregisterOnShutdown`      | Remove all devices from the controllers on shutdown. For development only.                                                                                  |
 
@@ -113,7 +114,8 @@ The white and black lists accept Homey device IDs as well as names. Entries by n
 
 ### Limitations
 
-- New Homey devices need a Matterbridge restart; the frontend asks for it. Deleted devices are removed right away.
+- New Homey devices are exposed right away and deleted devices are removed right away. With `exposeNewDevices` off, new devices need a Matterbridge restart; the frontend asks for it. To keep new devices out entirely, use the white list.
+- A new device is exposed with the capabilities Homey reports for it. Capabilities that its app adds later appear after a restart.
 - Devices with the same name get their zone appended, e.g. `Ceiling light Kitchen`.
 - Not supported yet: buttons and remotes, media players and TVs (only their `onoff`), window covering tilt, plant moisture, `level_aqi`.
 

package/dist/module.js

@@ -54,6 +54,9 @@ export class HomeyPlatform extends MatterbridgeDynamicPlatform {
     homey;
     bridgedDevices = new Map();
     zones = [];
+    newDeviceIds = new Set();
+    areDevicesConfigured = false;
+    deviceChanges = Promise.resolve();
     constructor(matterbridge, log, config, homey) {
         super(matterbridge, log, config);
         this.config = config;
@@ -73,20 +76,26 @@ export class HomeyPlatform extends MatterbridgeDynamicPlatform {
         this.config.outletList = isValidArray(config.outletList) ? config.outletList : [];
         this.config.capabilityBlackList = isValidArray(config.capabilityBlackList) ? config.capabilityBlackList : [];
         this.config.deviceCapabilityBlackList = isValidObject(config.deviceCapabilityBlackList) ? config.deviceCapabilityBlackList : {};
+        this.config.exposeNewDevices ??= true;
         this.config.debug ??= false;
         this.config.unregisterOnShutdown ??= false;
         this.homey =
             homey ?? new HomeyApiConnection(config.address, config.token, 15000, config.debug ? (message) => this.log.debug(`[homey-api] ${message}`) : undefined);
         this.homey.on('device.create', (device) => {
-            this.log.notice(`New Homey device ${CYAN}${device.name}${nf}: restart Matterbridge to expose it`);
-            if (this.isConfigured)
-                this.wssSendRestartRequired();
+            if (!this.config.exposeNewDevices) {
+                this.log.notice(`New Homey device ${CYAN}${device.name}${nf}: restart Matterbridge to expose it`);
+                if (this.isConfigured)
+                    this.wssSendRestartRequired();
+                return;
+            }
+            this.log.notice(`New Homey device ${CYAN}${device.name}${nf}`);
+            fireAndForget(this.serialize(async () => this.addNewDevice(device)), this.log, `addition of ${device.name}`);
         });
         this.homey.on('device.update', (device) => {
-            fireAndForget(this.updateDevice(device), this.log, `update of ${device.name}`);
+            fireAndForget(this.serialize(async () => this.updateDevice(device)), this.log, `update of ${device.name}`);
         });
         this.homey.on('device.delete', (device) => {
-            fireAndForget(this.removeDevice(device.id), this.log, `removal of ${device.id}`);
+            fireAndForget(this.serialize(async () => this.removeDevice(device.id)), this.log, `removal of ${device.id}`);
         });
         this.homey.on('disconnected', () => {
             this.log.warn('Disconnected from Homey');
@@ -113,22 +122,27 @@ export class HomeyPlatform extends MatterbridgeDynamicPlatform {
             throw new Error(`Unable to connect to Homey at ${this.config.address}: ${getErrorMessage(error)}`, { cause: error });
         }
         this.log.notice(`Connected to Homey ${CYAN}${this.homey.homeyId ?? ''}${nf}`);
-        const [devices, zones] = await Promise.all([this.homey.getDevices(), this.homey.getZones()]);
-        this.zones = zones;
-        this.log.info(`Found ${CYAN}${devices.length}${nf} devices in ${CYAN}${zones.length}${nf} zones`);
-        const names = getUniqueDeviceNames(devices, zones);
-        for (const device of devices.toSorted((a, b) => a.name.localeCompare(b.name))) {
-            await this.addDevice(device, names.get(device.id) ?? device.name, zones);
-        }
+        await this.serialize(async () => {
+            const [devices, zones] = await Promise.all([this.homey.getDevices(), this.homey.getZones()]);
+            this.zones = zones;
+            this.log.info(`Found ${CYAN}${devices.length}${nf} devices in ${CYAN}${zones.length}${nf} zones`);
+            const names = getUniqueDeviceNames(devices, zones);
+            for (const device of devices.toSorted((a, b) => a.name.localeCompare(b.name))) {
+                await this.addDevice(device, names.get(device.id) ?? device.name, zones);
+            }
+        });
         this.log.info(`Started platform ${idn}${this.config.name}${rs}${nf} with ${CYAN}${this.bridgedDevices.size}${nf} devices`);
     }
     async onConfigure() {
         await super.onConfigure();
         this.log.info(`Configuring platform ${idn}${this.config.name}${rs}${nf}...`);
-        for (const bridgedDevice of this.bridgedDevices.values()) {
-            await bridgedDevice.applyAll();
-            bridgedDevice.subscribe();
-        }
+        await this.serialize(async () => {
+            for (const bridgedDevice of this.bridgedDevices.values()) {
+                await bridgedDevice.applyAll();
+                bridgedDevice.subscribe();
+            }
+            this.areDevicesConfigured = true;
+        });
         this.log.info(`Configured platform ${idn}${this.config.name}${rs}${nf}`);
     }
     async onChangeLoggerLevel(logLevel) {
@@ -203,10 +217,33 @@ export class HomeyPlatform extends MatterbridgeDynamicPlatform {
             inspectError(this.log, `Failed to register device ${name}`, error);
         }
     }
+    async addNewDevice(device) {
+        if (this.bridgedDevices.has(device.id))
+            return;
+        const [devices, zones] = await Promise.all([this.homey.getDevices(), this.homey.getZones()]);
+        this.zones = zones;
+        const names = getUniqueDeviceNames([...devices.filter((other) => other.id !== device.id), device], zones);
+        for (const [deviceId, bridged] of this.bridgedDevices)
+            await bridged.setName(names.get(deviceId) ?? bridged.device.name);
+        await this.addDevice(device, names.get(device.id) ?? device.name, zones);
+        const bridgedDevice = this.bridgedDevices.get(device.id);
+        if (!bridgedDevice) {
+            this.newDeviceIds.add(device.id);
+            return;
+        }
+        this.newDeviceIds.delete(device.id);
+        if (!this.areDevicesConfigured)
+            return;
+        await bridgedDevice.applyAll();
+        bridgedDevice.subscribe();
+    }
     async updateDevice(device) {
         const bridgedDevice = this.bridgedDevices.get(device.id);
-        if (!bridgedDevice)
+        if (!bridgedDevice) {
+            if (this.newDeviceIds.has(device.id))
+                await this.addNewDevice(device);
             return;
+        }
         const isRenamed = device.name !== bridgedDevice.homeyName;
         await bridgedDevice.update(device);
         if (!isRenamed)
@@ -216,6 +253,7 @@ export class HomeyPlatform extends MatterbridgeDynamicPlatform {
             await bridged.setName(names.get(deviceId) ?? bridged.device.name);
     }
     async removeDevice(deviceId) {
+        this.newDeviceIds.delete(deviceId);
         const bridgedDevice = this.bridgedDevices.get(deviceId);
         if (!bridgedDevice)
             return;
@@ -224,4 +262,10 @@ export class HomeyPlatform extends MatterbridgeDynamicPlatform {
         this.bridgedDevices.delete(deviceId);
         await this.unregisterDevice(bridgedDevice.endpoint);
     }
+    async serialize(change) {
+        const result = this.deviceChanges.then(change);
+        this.deviceChanges = result.catch(() => {
+        });
+        await result;
+    }
 }

package/matterbridge-homey.config.json

@@ -10,6 +10,7 @@
   "outletList": [],
   "capabilityBlackList": [],
   "deviceCapabilityBlackList": {},
+  "exposeNewDevices": true,
   "debug": false,
   "unregisterOnShutdown": false
 }

package/matterbridge-homey.schema.json

@@ -104,6 +104,12 @@
         "selectDeviceEntityFrom": "name"
       }
     },
+    "exposeNewDevices": {
+      "title": "Expose New Devices",
+      "description": "Expose the devices added to Homey right away, without restarting Matterbridge. The white list, black list and zone white list still apply. When off, new devices are exposed after the next restart.",
+      "type": "boolean",
+      "default": true
+    },
     "debug": {
       "title": "Enable Debug",
       "description": "Enable debug mode for the plugin. Only for debugging purposes, not recommended for production use.",

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-homey",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-homey",
-      "version": "0.2.0",
+      "version": "0.3.0",
       "license": "Apache-2.0",
       "dependencies": {
         "homey-api": "3.20.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-homey",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Matterbridge plugin that exposes Athom Homey Pro devices to Matter",
   "author": "Stefan Schweiger",
   "license": "Apache-2.0",