homebridge-pax-calima 2.4.3 → 2.4.4

package/README.md

@@ -192,6 +192,10 @@ This plugin meets all Homebridge 2.0 requirements:
 
 ## Release notes
 
+### 2.4.4
+- **Fixed:** Silent Hours time fields no longer show a raw regex pattern as validation hint in the Homebridge UI — replaced with plain human-readable placeholder text (e.g. `23:00`) and a description
+- **Improved:** Invalid time format now logs a clear warning message rather than silently disabling the schedule
+
 ### 2.4.3
 - **Silent Hours** reworked — now supports a config schedule (`silentHoursStart` / `silentHoursEnd`) that runs automatically, an optional HomeKit switch (`showSilentSwitch: true`) for Goodnight scenes and irregular schedules, or both together. The switch takes priority when toggled manually; the schedule runs as a background default. Any existing Silent Hours switch from earlier versions is automatically removed unless `showSilentSwitch` is enabled.
 - **Light sensor** (`showLight`) added as opt-in — confirmed via live testing that the characteristic returns a static value regardless of lighting conditions.

package/config.schema.json

@@ -13,22 +13,20 @@
       "silentHoursStart": {
         "title": "Silent Hours — Start Time",
         "type": "string",
-        "pattern": "^([01]?[0-9]|2[0-3]):[0-5][0-9]$",
-        "placeholder": "e.g. 23:00",
-        "description": "When the fan stops boosting at night. 24-hour format. Leave blank to disable the schedule."
+        "placeholder": "23:00",
+        "description": "When the fan stops boosting at night. Enter in 24-hour format, e.g. 23:00. Leave blank to disable the schedule."
       },
       "silentHoursEnd": {
         "title": "Silent Hours — End Time",
         "type": "string",
-        "pattern": "^([01]?[0-9]|2[0-3]):[0-5][0-9]$",
-        "placeholder": "e.g. 07:00",
-        "description": "When the fan resumes boosting in the morning. Both start and end must be set for the schedule to activate."
+        "placeholder": "07:00",
+        "description": "When the fan resumes boosting in the morning. Enter in 24-hour format, e.g. 07:00. Both start and end must be set for the schedule to activate."
       },
       "showSilentSwitch": {
         "title": "Show Silent Hours Switch in Home",
         "type": "boolean",
         "default": false,
-        "description": "Adds a Silent Hours on/off switch to your accessory in the Home app. Useful for including in a Goodnight scene or automation. If a schedule is also set, the switch takes priority when toggled manually. Good for shift workers or irregular schedules."
+        "description": "Adds a Silent Hours on/off switch to your accessory in the Home app. Useful for including in a Goodnight scene or automation. Good for shift workers or irregular schedules."
       },
       "showHumidity": {
         "title": "Show Humidity Sensor",
@@ -57,8 +55,8 @@
             "mac": {
               "title": "MAC Address",
               "type": "string",
-              "pattern": "^([0-9A-Fa-f]{2}:){5}([0-9A-Fa-f]{2})$",
-              "description": "MAC address of the fan (e.g. 58:2b:db:xx:xx:xx)"
+              "placeholder": "58:2b:db:xx:xx:xx",
+              "description": "MAC address of the fan — found in the official Pax or Vent-Axia app under About Device."
             },
             "pin": {
               "title": "PIN Code",

package/index.js

@@ -15,13 +15,19 @@ const MAC_PREFIX   = '58:2b:db';
 const POLL_MS      = 10000;
 const RECONNECT_MS = 15000;
 
-function parseTime(str) {
+function parseTime(str, label) {
   if (!str || typeof str !== 'string') return null;
   const parts = str.split(':');
-  if (parts.length !== 2) return null;
+  if (parts.length !== 2 || parts[0] === '' || parts[1] === '') {
+    console.warn('[PaxCalima] ' + (label || 'Silent Hours') + ' time "' + str + '" is not valid — use 24-hour format e.g. 23:00. Silent Hours schedule disabled.');
+    return null;
+  }
   const hour   = parseInt(parts[0], 10);
   const minute = parseInt(parts[1], 10);
-  if (isNaN(hour) || isNaN(minute) || hour < 0 || hour > 23 || minute < 0 || minute > 59) return null;
+  if (isNaN(hour) || isNaN(minute) || hour < 0 || hour > 23 || minute < 0 || minute > 59) {
+    console.warn('[PaxCalima] ' + (label || 'Silent Hours') + ' time "' + str + '" is out of range — use 24-hour format e.g. 23:00. Silent Hours schedule disabled.');
+    return null;
+  }
   return { hour, minute };
 }
 
@@ -124,8 +130,8 @@ class PaxCalimaAccessory {
     this.showHumidity     = options.showHumidity     || false;
     this.showLight        = options.showLight        || false;
     this.showSilentSwitch = options.showSilentSwitch || false;
-    this.silentStart      = parseTime(options.silentHoursStart);
-    this.silentEnd        = parseTime(options.silentHoursEnd);
+    this.silentStart      = parseTime(options.silentHoursStart, 'silentHoursStart');
+    this.silentEnd        = parseTime(options.silentHoursEnd, 'silentHoursEnd');
 
     this.currentRPM  = 0;
     this.humidity    = 0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-pax-calima",
   "displayName": "Vent-Axia Svara / Pax Calima",
-  "version": "2.4.3",
+  "version": "2.4.4",
   "description": "Bring your Pax Calima or Vent-Axia Svara bathroom fan into Apple Home via Bluetooth — live temperature and fan speed with Silent Hours scheduling and full automation support.",
   "main": "index.js",
   "keywords": [