homebridge-philips-airplus-cloud 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 The Home Assistant integration in `custom_components/` is unchanged from upstream and keeps its own history.
 
+## 0.3.3 — 2026-10-11
+
+- Fix: the plugin could stop updating when the cloud connection stayed open but stopped delivering data. If the purifier sends nothing for three status polls (at least 6 minutes), the connection is now rebuilt.
+- Fix: a new accessory is announced to HomeKit only once all its services exist, so the Home app sees the labelled, linked components from the start.
+
 ## 0.3.2 — 2026-10-11
 
 - Option `homekitIdentity`: gives the purifier a new HomeKit identity when the Home app keeps a stuck record of it (rooms and names cannot be changed). The previous accessory is removed automatically.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-philips-airplus-cloud",
   "displayName": "Philips Air+",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Homebridge plugin for Philips Air+ / PureProtect air purifiers via the Philips (Versuni) cloud — the same MQTT protocol used by the Air+ app and Google Home.",
   "main": "src/index.js",
   "license": "MIT",

package/src/accessory.js

@@ -91,9 +91,28 @@ class PurifierAccessory {
   start() {
     this.conn.start();
     const pollS = Math.max(30, Number(this.platform.config.pollInterval) || C.STATUS_POLL_INTERVAL_S);
+    // Watchdog: the cloud connection can stay open but stop delivering data.
+    // Every poll asks the device for its status, so if nothing has arrived for
+    // three polls (at least 6 minutes) the connection is rebuilt.
+    const silenceMs = Math.max(3 * pollS, 360) * 1000;
     this.pollTimer = setInterval(async () => {
       await this.conn.refreshIfNeeded();
-      if (this.conn.connected) this.conn.getPort(this.conn.ports.status);
+      if (!this.conn.connected) return;
+      const silent = Date.now() - this.conn.lastMessageAt;
+      if (silent > silenceMs) {
+        // Warn once; if the purifier is simply unplugged keep retrying quietly.
+        const msg = `No data from the purifier for ${Math.round(silent / 60000)} min; reconnecting to the Philips cloud`;
+        if (this._silenceWarned) this.log.debug(msg);
+        else this.log.warn(msg);
+        this._silenceWarned = true;
+        this.conn.reconnect();
+        return;
+      }
+      if (this._silenceWarned) {
+        this._silenceWarned = false;
+        this.log.info('Receiving data from the purifier again');
+      }
+      this.conn.getPort(this.conn.ports.status);
     }, pollS * 1000);
     this.filterTimer = setInterval(() => {
       if (this.conn.connected) this.conn.getPort(this.conn.ports.filter_read);
@@ -125,6 +144,11 @@ class PurifierAccessory {
     this._setInfo();
     this._pushAll();
     this.log.info(`Using model profile "${this.model.name}" (${this.speeds.length} manual speeds${this.hasAuto ? ' + Auto' : ''})`);
+    if (this.onModelReady) {
+      const cb = this.onModelReady;
+      this.onModelReady = null;
+      cb();
+    }
   }
 
   _prop(name) {

package/src/connection.js

@@ -70,6 +70,16 @@ class DeviceConnection extends EventEmitter {
     this.attempt = 0;
     this.timer = null;
     this.ports = { ...C.DEFAULT_PORTS };
+    this.lastMessageAt = Date.now();
+  }
+
+  /** Drop the current connection and connect again with fresh credentials. */
+  reconnect() {
+    if (this.stopped) return;
+    this.connected = false;
+    this.attempt = 0;
+    clearTimeout(this.timer);
+    this._connect();
   }
 
   setPorts(ports) {
@@ -161,12 +171,15 @@ class DeviceConnection extends EventEmitter {
       if (client !== this.client) return;
       this.connected = true;
       this.attempt = 0;
+      this.lastMessageAt = Date.now();
       client.subscribe(C.TOPIC_STATUS(this.deviceId), { qos: 0 });
       this.log.info('Connected to Philips cloud');
       this.emit('connected');
     });
 
     client.on('message', (topic, payload) => {
+      if (client !== this.client) return;
+      this.lastMessageAt = Date.now();
       let messages;
       try {
         messages = parseConcatenatedJson(payload.toString('utf8'));

package/src/platform.js

@@ -72,17 +72,27 @@ class PhilipsAirPlusPlatform {
       const hbUuid = this.api.hap.uuid.generate(`${C.PLATFORM_NAME}:${dev.uuid}${identity ? `:${identity}` : ''}`);
       keep.add(hbUuid);
       let acc = this.cached.get(hbUuid);
-      if (!acc) {
+      const isNew = !acc;
+      if (isNew) {
         acc = new this.api.platformAccessory(dev.name, hbUuid, this.api.hap.Categories.AIR_PURIFIER);
         acc.context.uuid = dev.uuid;
         if (dev.model) acc.context.model = dev.model;
-        this.log.info(`Adding ${dev.name}`);
-        this.api.registerPlatformAccessories(C.PLUGIN_NAME, C.PLATFORM_NAME, [acc]);
       } else if (!acc.context.model && dev.model) {
         acc.context.model = dev.model;
       }
       const handler = new PurifierAccessory(this, acc, { account: this.account });
       this.handlers.set(hbUuid, handler);
+      if (isNew) {
+        // Announce a new accessory to HomeKit only once all its services exist:
+        // the Home app records names and links when it first sees an accessory,
+        // and services added to an already published accessory may show unlabelled.
+        const register = () => {
+          this.log.info(`Adding ${dev.name}`);
+          this.api.registerPlatformAccessories(C.PLUGIN_NAME, C.PLATFORM_NAME, [acc]);
+        };
+        if (handler.model) register();
+        else handler.onModelReady = register;
+      }
       handler.conn.on('authExpired', () => this._authExpired());
       handler.start();
     }