homebridge-envoy-solar-sensor 0.1.6 → 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

@@ -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);

package/package.json

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