homebridge-withings-environment-data 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -6,6 +6,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## [1.1.0] - 2026-07-27
+
+### Added
+- Air Quality threshold config fields (`airQualityExcellentMaxPpm`,
+  `airQualityGoodMaxPpm`, `airQualityFairMaxPpm`,
+  `airQualityInferiorMaxPpm`) to make the AirQualitySensor's ppm
+  boundaries configurable instead of hardcoded
+
+### Changed
+- ntfy notifications for an authentication failure now use a fixed,
+  generic message instead of the raw internal error text; other poll
+  failures still send the raw error message. The Homebridge log still
+  always shows the detailed error either way.
+
 ## [1.0.0] - 2026-07-26
 
 ### Changed

package/README.md

@@ -1,4 +1,4 @@
-# Homebridge Withings Environment Data v1.0.0
+# Homebridge Withings Environment Data v1.1.0
 
 **This Homebridge plugin has been 100% vibe coded with Claude.**
 
@@ -41,7 +41,8 @@ accessory:
 - **CarbonDioxideSensor**: precise CO2 level in ppm, plus a normal/abnormal
   detected alert based on a configurable threshold.
 - **AirQualitySensor**: the same CO2 reading mapped to HomeKit's
-  Excellent/Good/Fair/Inferior/Poor category.
+  Excellent/Good/Fair/Inferior/Poor category, based on configurable ppm
+  thresholds.
 - **TemperatureSensor**: room temperature in °C.
 
 These appear automatically in the Home app after Homebridge restarts, no
@@ -68,6 +69,9 @@ Fields:
   matching the scale's own upload cadence).
 - **CO2 Detected Threshold (ppm)**: ppm above which the CarbonDioxideSensor
   reports "abnormal" (default 1000).
+- **Air Quality: Excellent/Good/Fair/Inferior below (ppm)**: the four ppm
+  boundaries the AirQualitySensor category is based on (defaults 800, 1000,
+  1500, 2000).
 - **ntfy Topic (optional)**: if set, sends a push notification via
   [ntfy.sh](https://ntfy.sh) to this topic the first time a poll fails
   (not repeated on every subsequent failure in the same streak; only once

package/config.schema.json

@@ -49,6 +49,34 @@
         "default": 1000,
         "minimum": 400
       },
+      "airQualityExcellentMaxPpm": {
+        "title": "Air Quality: Excellent below (ppm)",
+        "type": "integer",
+        "default": 800,
+        "minimum": 1,
+        "description": "CO2 readings below this are reported as Excellent air quality."
+      },
+      "airQualityGoodMaxPpm": {
+        "title": "Air Quality: Good below (ppm)",
+        "type": "integer",
+        "default": 1000,
+        "minimum": 1,
+        "description": "CO2 readings below this are reported as Good."
+      },
+      "airQualityFairMaxPpm": {
+        "title": "Air Quality: Fair below (ppm)",
+        "type": "integer",
+        "default": 1500,
+        "minimum": 1,
+        "description": "CO2 readings below this are reported as Fair."
+      },
+      "airQualityInferiorMaxPpm": {
+        "title": "Air Quality: Inferior below (ppm)",
+        "type": "integer",
+        "default": 2000,
+        "minimum": 1,
+        "description": "CO2 readings below this are reported as Inferior. Anything above is reported as Poor."
+      },
       "noResponseAfterMissedPolls": {
         "title": "No Response After Missed Polls",
         "type": "integer",

package/index.js

@@ -63,11 +63,11 @@ async function fetchLatest({ cookieHeader, sessionToken, deviceId, userId }) {
   };
 }
 
-function mapCo2ToAirQuality(ppm, AirQuality) {
-  if (ppm < 800) return AirQuality.EXCELLENT;
-  if (ppm < 1000) return AirQuality.GOOD;
-  if (ppm < 1500) return AirQuality.FAIR;
-  if (ppm < 2000) return AirQuality.INFERIOR;
+function mapCo2ToAirQuality(ppm, AirQuality, thresholds) {
+  if (ppm < thresholds.excellentMaxPpm) return AirQuality.EXCELLENT;
+  if (ppm < thresholds.goodMaxPpm) return AirQuality.GOOD;
+  if (ppm < thresholds.fairMaxPpm) return AirQuality.FAIR;
+  if (ppm < thresholds.inferiorMaxPpm) return AirQuality.INFERIOR;
   return AirQuality.POOR;
 }
 
@@ -216,7 +216,13 @@ class WithingsEnvironmentDataPlatform {
 
   async poll() {
     try {
-      const { cookieHeader, sessionToken } = await this.authenticate();
+      let cookieHeader, sessionToken;
+      try {
+        ({ cookieHeader, sessionToken } = await this.authenticate());
+      } catch (err) {
+        err.isAuthFailure = true;
+        throw err;
+      }
 
       if (!this.deviceId || !this.userId) {
         const discovered = await discoverDevice(cookieHeader);
@@ -252,7 +258,10 @@ class WithingsEnvironmentDataPlatform {
 
       if (!this.hasNotifiedFailure) {
         this.hasNotifiedFailure = true;
-        await this.sendNtfyNotification(err.message);
+        const notificationMessage = err.isAuthFailure
+          ? 'Authentication for Withings account failed. Check the Homebridge logs for details.'
+          : err.message;
+        await this.sendNtfyNotification(notificationMessage);
       }
     }
   }
@@ -282,6 +291,19 @@ class WithingsEnvironmentDataPlatform {
     return Number.isFinite(threshold) && threshold >= 0 ? threshold : 2;
   }
 
+  getAirQualityThresholds() {
+    const excellentMaxPpm = Number(this.config.airQualityExcellentMaxPpm);
+    const goodMaxPpm = Number(this.config.airQualityGoodMaxPpm);
+    const fairMaxPpm = Number(this.config.airQualityFairMaxPpm);
+    const inferiorMaxPpm = Number(this.config.airQualityInferiorMaxPpm);
+    return {
+      excellentMaxPpm: Number.isFinite(excellentMaxPpm) && excellentMaxPpm > 0 ? excellentMaxPpm : 800,
+      goodMaxPpm: Number.isFinite(goodMaxPpm) && goodMaxPpm > 0 ? goodMaxPpm : 1000,
+      fairMaxPpm: Number.isFinite(fairMaxPpm) && fairMaxPpm > 0 ? fairMaxPpm : 1500,
+      inferiorMaxPpm: Number.isFinite(inferiorMaxPpm) && inferiorMaxPpm > 0 ? inferiorMaxPpm : 2000,
+    };
+  }
+
   isStale() {
     return !this.hasEverSucceeded || this.missedCycles > this.getNoResponseThreshold();
   }
@@ -306,7 +328,7 @@ class WithingsEnvironmentDataPlatform {
 
   getAirQualityOrThrow() {
     this.throwIfStale();
-    return mapCo2ToAirQuality(this.lastReading.co2, this.Characteristic.AirQuality);
+    return mapCo2ToAirQuality(this.lastReading.co2, this.Characteristic.AirQuality, this.getAirQualityThresholds());
   }
 
   getTemperatureOrThrow() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-withings-environment-data",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Homebridge plugin exposing ambient CO2/air-quality and room temperature readings from a Withings WS-50 scale as HomeKit sensors",
   "main": "index.js",
   "files": [