homebridge-envoy-solar-sensor 0.1.5 → 0.1.7

package/config.schema.json

@@ -74,6 +74,20 @@
         "type": "string",
         "default": "",
         "description": "Bearer token from Enphase Entrez, paste token only without the word Bearer"
+      },
+      "debugLogging": {
+        "title": "Debug Logging",
+        "type": "boolean",
+        "default": false,
+        "description": "Log production watts on every poll"
+      },
+      "debugBurstCount": {
+        "title": "Debug Burst Count",
+        "type": "integer",
+        "default": 0,
+        "minimum": 0,
+        "maximum": 200,
+        "description": "If set, logs the next N polls at INFO level for easier debugging"
       }
     }
   }

package/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { Agent } = require('undici');
+const { Agent, request } = require('undici');
 
 const PLUGIN_NAME = 'homebridge-envoy-solar-sensor';
 const PLATFORM_NAME = 'EnvoySolarSensor';
@@ -83,6 +83,7 @@ class EnvoySolarPlatform {
     const tick = async () => {
       try {
         const watts = await this.readProductionWatts();
+        this.logWatts(watts);
         this.updateState(watts);
       } catch (err) {
         const msg = err && err.message ? err.message : String(err);
@@ -124,6 +125,38 @@ class EnvoySolarPlatform {
     return Boolean(this.config.allowInsecureTLS);
   }
 
+  isDebugLoggingEnabled() {
+    return Boolean(this.config.debugLogging);
+  }
+
+  getDebugBurstCount() {
+    const n = Number(this.config.debugBurstCount ?? 0);
+    if (!Number.isFinite(n) || n < 0) return 0;
+    return Math.floor(n);
+  }
+
+  consumeDebugBurst() {
+    const n = this.getDebugBurstCount();
+    if (n <= 0) return 0;
+    this.config.debugBurstCount = n - 1;
+    return n;
+  }
+
+  logWatts(productionWatts) {
+    const burst = this.getDebugBurstCount();
+    const debugEnabled = this.isDebugLoggingEnabled();
+
+    if (burst > 0) {
+      const before = this.consumeDebugBurst();
+      this.log.info(`Envoy production: ${productionWatts} W (debug burst remaining: ${before - 1})`);
+      return;
+    }
+
+    if (debugEnabled) {
+      this.log.debug(`Envoy production: ${productionWatts} W`);
+    }
+  }
+
   markFault() {
     if (!this.accessory) return;
     const service = this.accessory.getService(this.Service.ContactSensor);
@@ -203,10 +236,7 @@ class EnvoySolarPlatform {
     const candidate = eim || production || inverters || productionArray[0];
     const wNow = candidate && candidate.wNow;
 
-    if (typeof wNow !== 'number') {
-      throw new Error('production.json mist wNow in production items');
-    }
-
+    if (typeof wNow !== 'number') throw new Error('production.json mist wNow in production items');
     return Math.max(0, wNow);
   }
 
@@ -232,13 +262,23 @@ class EnvoySolarPlatform {
       ? new Agent({ connect: { rejectUnauthorized: !allowInsecureTLS } })
       : undefined;
 
-    const res = await fetch(url, { headers, dispatcher });
+    try {
+      const res = await request(url, { method: 'GET', headers, dispatcher });
 
-    if (!res.ok) {
-      const text = await res.text().catch(() => '');
-      throw new Error(`HTTP ${res.status} op ${url} ${text}`);
-    }
+      if (res.statusCode === 401 || res.statusCode === 403) {
+        throw new Error(`HTTP ${res.statusCode} unauthorized. Check token and that you pasted token only, without 'Bearer'.`);
+      }
 
-    return await res.json();
+      if (res.statusCode < 200 || res.statusCode >= 300) {
+        const body = await res.body.text().catch(() => '');
+        throw new Error(`HTTP ${res.statusCode} op ${url} ${body}`);
+      }
+
+      const text = await res.body.text();
+      return JSON.parse(text);
+    } catch (e) {
+      const msg = e && e.message ? e.message : String(e);
+      throw new Error(`fetch failed: ${msg} url=${url} insecureTLS=${allowInsecureTLS}`);
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-envoy-solar-sensor",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Expose Enphase Envoy solar production as a HomeKit sensor for daylight-based automations",
   "main": "index.js",
   "license": "MIT",