homebridge-viessmann-vicare 2.0.70 → 2.0.71

package/config.schema.json

@@ -520,10 +520,10 @@
       "reportServerTimeout": {
         "title": "Report Server Generation Timeout",
         "type": "integer",
-        "default": 300,
-        "minimum": 60,
-        "maximum": 1800,
-        "description": "Maximum time in seconds allowed for viessmann-report.js to generate a report. Increase for large CSV files (90+ days). Default: 300s (5 min). Range: 60–1800s."
+        "default": 600,
+        "minimum": 120,
+        "maximum": 3600,
+        "description": "Maximum time in seconds for report generation. RPi 3 benchmark: ~365s for 90 days / ~1460s for 365 days. Default: 600s. Range: 120–3600s."
       }
     },
     "required": [

package/dist/platform.d.ts

@@ -57,6 +57,7 @@ export declare class ViessmannPlatform implements DynamicPlatformPlugin {
     private setupRoomSensorDiscovery;
     updateAllDevices(): Promise<void>;
     private updateCycleComplete;
+    private writeApiStatusFile;
     private adjustRefreshInterval;
     private sleep;
     private startHealthMonitoring;

package/dist/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"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"}

package/dist/platform.js

@@ -41,6 +41,7 @@ const dhw_accessory_1 = require("./accessories/dhw-accessory");
 const heating_circuit_accessory_1 = require("./accessories/heating-circuit-accessory");
 const energy_accessory_1 = require("./accessories/energy-accessory");
 const room_sensor_accessory_1 = require("./accessories/room-sensor-accessory");
+const fs = __importStar(require("fs"));
 const settings_1 = require("./settings");
 class ViessmannPlatform {
     log;
@@ -864,9 +865,51 @@ class ViessmannPlatform {
                 const healthScore = this.viessmannAPI.getAPIHealthScore();
                 const healthStatus = this.viessmannAPI.getAPIHealthStatus();
                 this.log.debug(`📊 API Health: ${healthScore}/100 (${healthStatus})`);
+                this.writeApiStatusFile(healthScore, healthStatus);
             }
         }
     }
+    // ── API Status File ─────────────────────────────────────────────────────────
+    // Written after each successful update cycle.
+    // Read by viessmann-report-server.js and auth-manager status page to show
+    // API usage percentage, health score, and rate limit info in the web UI.
+    // Viessmann documented daily limit: 1450 requests/day.
+    writeApiStatusFile(healthScore, healthStatus) {
+        try {
+            const storagePath = this.api.user.storagePath();
+            const metrics = this.viessmannAPI.getAPIMetrics();
+            const rateLimitSt = this.viessmannAPI.getRateLimitStatus();
+            const DAILY_LIMIT = 1450; // Viessmann API documented daily quota
+            const status = {
+                timestamp: new Date().toISOString(),
+                healthScore,
+                healthStatus,
+                totalRequests: metrics.totalRequests,
+                successfulRequests: metrics.successfulRequests,
+                failedRequests: metrics.failedRequests,
+                rateLimitHits: metrics.rateLimitHits,
+                errorRate: parseFloat(metrics.errorRate.toFixed(1)),
+                avgResponseTime: Math.round(metrics.averageResponseTime),
+                requestsPerMinute: metrics.requestsPerMinute,
+                isRateLimited: rateLimitSt.isLimited,
+                rateLimitWaitSec: rateLimitSt.waitSeconds ?? 0,
+                dailyQuotaExceeded: rateLimitSt.dailyQuotaExceeded,
+                // Estimated daily usage — resets with metrics (every 24h)
+                // requestsPerMinute × 60 × 24 gives a rough projection
+                dailyEstimatedReqs: Math.round(metrics.requestsPerMinute * 60 * 24),
+                dailyLimitTotal: DAILY_LIMIT,
+                dailyUsagePct: Math.min(100, parseFloat((metrics.totalRequests / DAILY_LIMIT * 100).toFixed(1))),
+                pluginVersion: '2.0.71',
+                refreshInterval: this.config.refreshInterval || 120000,
+            };
+            const filePath = require('path').join(storagePath, 'viessmann-api-status.json');
+            fs.writeFileSync(filePath, JSON.stringify(status, null, 2), 'utf8');
+            this.log.debug(`📊 API status written: health=${healthScore}/100, dailyUsage=${status.dailyUsagePct}%`);
+        }
+        catch (e) {
+            this.log.debug(`📊 Could not write API status file: ${e.message}`);
+        }
+    }
     adjustRefreshInterval(increase) {
         if (this.config.enableRateLimitProtection === false) {
             return;

package/dist/settings.d.ts

@@ -9,7 +9,7 @@ export declare const PLUGIN_NAME = "homebridge-viessmann-vicare";
 /**
  * Plugin version for User-Agent and logging
  */
-export declare const PLUGIN_VERSION = "2.0.70";
+export declare const PLUGIN_VERSION = "2.0.71";
 /**
  * Default configuration values
  */

package/dist/settings.js

@@ -12,7 +12,7 @@ exports.PLUGIN_NAME = 'homebridge-viessmann-vicare';
 /**
  * Plugin version for User-Agent and logging
  */
-exports.PLUGIN_VERSION = '2.0.70';
+exports.PLUGIN_VERSION = '2.0.71';
 /**
  * Default configuration values
  */
@@ -61,7 +61,7 @@ exports.DEFAULT_CONFIG = {
         deviceUpdateDelay: 1000,
         userAgent: `homebridge-viessmann-vicare/${exports.PLUGIN_VERSION}`,
     },
-    reportServerTimeout: 300, // seconds — max time for report generation (default 5 min)
+    reportServerTimeout: 600, // seconds — default 10 min; RPi3: ~365s/90days ~1460s/365days
     monitoring: {
         enableHealthReports: true,
         healthReportInterval: 3600000, // 1 hour

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-viessmann-vicare",
-  "version": "2.0.70",
+  "version": "2.0.71",
   "description": "Complete Homebridge plugin for Viessmann ViCare heating systems with full control capabilities, advanced rate limiting protection, and intelligent cache management",
   "main": "dist/index.js",
   "scripts": {

package/viessmann-report-server.js

@@ -195,7 +195,7 @@ function generateReport(params) {
 
 // ── UI HTML ────────────────────────────────────────────────────────────────
 
-function buildUI(installations) {
+function buildUI(installations, apiStatus) {
   const today = new Date().toLocaleDateString('en-GB', { day:'2-digit', month:'short', year:'numeric' });
   const instOptions = installations.length === 0
     ? '<option value="">No CSV found — check path</option>'
@@ -203,6 +203,51 @@ function buildUI(installations) {
         '<option value="' + id + '">' + (id ? 'Installation ' + id : 'Default (no ID)') + '</option>'
       ).join('');
 
+
+  // Build API status card from shared status file
+  const apiCardHtml = (() => {
+    if (!apiStatus) {
+      return `<div class="api-card">
+        <div class="api-card-title">🌐 API Usage</div>
+        <div class="api-row"><span class="api-lbl">Status</span><span class="api-val" style="color:var(--muted)">No data yet — waiting for first update cycle</span></div>
+      </div>`;
+    }
+    const pct     = apiStatus.dailyUsagePct ?? 0;
+    const health  = apiStatus.healthScore ?? 0;
+    const pctCls  = pct > 80 ? 'bad' : pct > 50 ? 'warn' : 'ok';
+    const hCls    = health >= 85 ? 'ok' : health >= 60 ? 'warn' : 'bad';
+    const rlTxt   = apiStatus.isRateLimited
+      ? `<span class="api-val bad">🚫 Rate limited — wait ${apiStatus.rateLimitWaitSec}s</span>`
+      : (apiStatus.dailyQuotaExceeded
+          ? `<span class="api-val bad">🚫 Daily quota exceeded</span>`
+          : `<span class="api-val ok">✓ OK</span>`);
+    const age     = Math.round((Date.now() - new Date(apiStatus.timestamp).getTime()) / 1000);
+    const ageStr  = age < 120 ? `${age}s ago` : `${Math.round(age/60)}m ago`;
+    return `<div class="api-card">
+      <div class="api-card-title">🌐 API Usage (Viessmann limit: ${apiStatus.dailyLimitTotal ?? 1450} req/day)</div>
+      <div class="api-row">
+        <span class="api-lbl">Daily usage (est.)</span>
+        <span class="api-val">
+          <span class="bar-wrap"><span class="bar-fill ${pctCls}" style="width:${Math.min(pct,100)}%"></span></span>
+          <span class="${pctCls}">${pct}%</span>
+          &nbsp;<span style="color:var(--muted);font-size:10px">(~${apiStatus.dailyEstimatedReqs ?? '?'} req/day)</span>
+        </span>
+      </div>
+      <div class="api-row">
+        <span class="api-lbl">Health score</span>
+        <span class="api-val">
+          <span class="bar-wrap"><span class="bar-fill ${hCls}" style="width:${health}%"></span></span>
+          <span class="${hCls}">${health}/100</span>
+          &nbsp;<span style="color:var(--muted);font-size:10px">${apiStatus.healthStatus ?? ''}</span>
+        </span>
+      </div>
+      <div class="api-row"><span class="api-lbl">Rate limit</span>${rlTxt}</div>
+      <div class="api-row"><span class="api-lbl">Avg response</span><span class="api-val">${apiStatus.avgResponseTime ?? 0} ms</span></div>
+      <div class="api-row"><span class="api-lbl">Error rate</span><span class="api-val ${apiStatus.errorRate > 10 ? 'bad' : apiStatus.errorRate > 5 ? 'warn' : 'ok'}">${apiStatus.errorRate ?? 0}%</span></div>
+      <div class="api-row"><span class="api-lbl">Last updated</span><span class="api-val" style="color:var(--muted)">${ageStr}</span></div>
+    </div>`;
+  })();
+
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -256,6 +301,16 @@ input:focus,select:focus{outline:none;border-color:var(--accent)}
 @keyframes spin{to{transform:rotate(360deg)}}
 .spinner{display:inline-block;width:13px;height:13px;border:2px solid rgba(249,115,22,.3);border-top-color:var(--accent);border-radius:50%;animation:spin .7s linear infinite;vertical-align:middle;margin-right:6px}
 footer{margin-top:36px;font-family:'Space Mono',monospace;font-size:10px;color:var(--muted);text-align:center;opacity:.4}
+.api-card{background:var(--surface);border:1px solid var(--border);border-radius:var(--r);padding:16px 20px;width:100%;max-width:560px;margin-bottom:14px}
+.api-card-title{font-family:'Space Mono',monospace;font-size:10px;text-transform:uppercase;letter-spacing:2px;color:var(--accent);margin-bottom:12px}
+.api-row{display:flex;justify-content:space-between;align-items:center;padding:6px 0;border-bottom:1px solid var(--border);font-size:12px}
+.api-row:last-child{border-bottom:none}
+.api-lbl{color:var(--muted);font-family:'Space Mono',monospace;font-size:11px}
+.api-val{font-weight:600;font-family:'Space Mono',monospace;font-size:11px}
+.api-val.ok{color:var(--good)}.api-val.warn{color:var(--warn)}.api-val.bad{color:var(--bad)}
+.bar-wrap{width:100px;height:6px;background:var(--border);border-radius:3px;overflow:hidden;display:inline-block;vertical-align:middle;margin-right:6px}
+.bar-fill{height:100%;border-radius:3px}
+.bar-fill.ok{background:var(--good)}.bar-fill.warn{background:var(--warn)}.bar-fill.bad{background:var(--bad)}
 </style>
 </head>
 <body>
@@ -345,6 +400,7 @@ footer{margin-top:36px;font-family:'Space Mono',monospace;font-size:10px;color:v
   Generate Report
 </button>
 <div id="status"></div>
+${apiCardHtml}
 <footer>homebridge-viessmann-vicare &nbsp;·&nbsp; report server &nbsp;·&nbsp; ${HB_PATH} &nbsp;·&nbsp; ${LAN_IP}:${PORT}</footer>
 
 <script>
@@ -424,7 +480,8 @@ const server = http.createServer(async (req, res) => {
 
   if (pathname === '/' || pathname === '') {
     const installations = detectInstallations();
-    const html = buildUI(installations);
+    const apiStatus = readApiStatus(HB_PATH);
+    const html = buildUI(installations, apiStatus);
     res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
     res.end(html);
     dbg(`← 200 / (${Date.now()-t0}ms, ${installations.length} installation(s))`);