homebridge-viessmann-vicare 2.0.2 → 2.0.4

package/README.md

@@ -263,7 +263,7 @@ npm install -g homebridge-viessmann-vicare
         "maxDelay": 300000,
         "maxConsecutiveErrors": 5,
         "deviceUpdateDelay": 1000,
-        "userAgent": "homebridge-viessmann-vicare/2.0.0"
+        "userAgent": "homebridge-viessmann-vicare/2.0.4"
     },
     "debug": false
 }
@@ -841,6 +841,18 @@ For issues and questions:
 
 ## 📈 Changelog
 
+### [2.0.4] - 2025-10-06
+**Added**
+- ✨ `logEnvDiagnostics()` for better detection of graphical environment (X11, Wayland, systemd, headless).
+- ✨ New fallback page `/login` for authentication via another device on the same LAN.
+- ✨ Auto-authentication now supported even in headless environments (Raspberry Pi, systemd, Docker).
+**Changed**
+- ✨ Default `authMethod` is now `"auto"` in all examples and documentation.
+- ✨ Improved resilience in `openBrowser()` on Linux with fallback to `xdg-open`, `gio`, and `xdg-desktop-portal`.
+**Fixed**
+- 🐛 Timeout and fallback flow now properly logged when auto-auth fails.
+- 🐛 Documentation and setup guide reflect the new authentication behavior.
+
 ### v2.0.0
 - ✨ **Major Release**: Complete rewrite with advanced features
 - ✨ **Complete Localization Support**: Custom names for all accessories in any language

package/SETUP-GUIDE.md

@@ -967,7 +967,7 @@ When reporting issues, include:
 
 ```json
 {
-    "plugin_version": "2.0.0",
+    "plugin_version": "2.0.4",
     "homebridge_version": "1.8.x",
     "node_version": "18.x.x",
     "heating_system": "Viessmann Model",

package/dist/auth-manager.d.ts

@@ -45,6 +45,33 @@ export declare class AuthManager {
     private clearStoredTokens;
     private scheduleTokenRefresh;
     authenticate(): Promise<void>;
+    /**
+      private shouldUseManualAuth(): boolean {
+        if (this.config.authMethod === 'manual') {
+          return true;
+        }
+    
+        // Check if we're in a headless environment
+        if (!process.env.DISPLAY && process.platform === 'linux') {
+          this.log.debug('🖥️ Detected headless Linux environment, using manual auth');
+          return true;
+        }
+    
+        // Check if we're in Docker
+        if (process.env.DOCKER || process.env.CONTAINER) {
+          this.log.debug('🐳 Detected container environment, using manual auth');
+          return true;
+        }
+    
+        // Check if we're running as a service (systemd)
+        if (process.env.SYSTEMD_EXEC_PID || process.env.INVOCATION_ID) {
+          this.log.debug('⚙️ Detected systemd service environment, using manual auth');
+          return true;
+        }
+    
+        return false;
+      }
+    **/
     private shouldUseManualAuth;
     private performAutoAuth;
     private handleManualAuth;
@@ -102,6 +129,7 @@ export declare class AuthManager {
         scope?: string;
         issuedAt?: Date;
     };
+    private logEnvDiagnostics;
     cleanup(): void;
 }
 //# sourceMappingURL=auth-manager.d.ts.map

package/dist/auth-manager.d.ts.map

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

package/dist/auth-manager.js

@@ -275,6 +275,7 @@ class AuthManager {
     }
     async authenticate() {
         try {
+            this.logEnvDiagnostics();
             if (this.isTokenValid()) {
                 this.log.debug('✅ Using existing valid token');
                 return;
@@ -292,11 +293,24 @@ class AuthManager {
             }
             // Determine authentication method
             const authMethod = this.config.authMethod || 'auto';
+            /**
             if (authMethod === 'manual' || this.shouldUseManualAuth()) {
+              await this.handleManualAuth();
+            } else {
+              await this.performAutoAuth();
+            }
+            **/
+            if (authMethod === 'manual') {
                 await this.handleManualAuth();
+                return;
+            }
+            // Prova sempre l'auto-auth; se fallisce, fallback a manual
+            try {
+                await this.performAutoAuth(); // avvia server di callback + openBrowser()
             }
-            else {
-                await this.performAutoAuth();
+            catch (e) {
+                this.log.warn('⚠️ Auto auth failed, falling back to manual:', e instanceof Error ? e.message : String(e));
+                await this.handleManualAuth();
             }
         }
         catch (error) {
@@ -304,25 +318,48 @@ class AuthManager {
             throw error;
         }
     }
-    shouldUseManualAuth() {
+    /**
+      private shouldUseManualAuth(): boolean {
         if (this.config.authMethod === 'manual') {
-            return true;
+          return true;
         }
+    
         // Check if we're in a headless environment
         if (!process.env.DISPLAY && process.platform === 'linux') {
-            this.log.debug('🖥️ Detected headless Linux environment, using manual auth');
-            return true;
+          this.log.debug('🖥️ Detected headless Linux environment, using manual auth');
+          return true;
         }
+    
         // Check if we're in Docker
         if (process.env.DOCKER || process.env.CONTAINER) {
-            this.log.debug('🐳 Detected container environment, using manual auth');
-            return true;
+          this.log.debug('🐳 Detected container environment, using manual auth');
+          return true;
         }
+    
         // Check if we're running as a service (systemd)
         if (process.env.SYSTEMD_EXEC_PID || process.env.INVOCATION_ID) {
-            this.log.debug('⚙️ Detected systemd service environment, using manual auth');
+          this.log.debug('⚙️ Detected systemd service environment, using manual auth');
+          return true;
+        }
+    
+        return false;
+      }
+    **/
+    shouldUseManualAuth() {
+        // Rispetta la scelta esplicita dell’utente
+        if (this.config.authMethod === 'manual') {
+            this.log.debug('🔧 Auth method explicitly set to "manual" in config.');
             return true;
         }
+        // Diagnostica non-bloccante: non forziamo più il manual in headless/systemd/container
+        const isHeadlessLinux = (process.platform === 'linux' && !process.env.DISPLAY);
+        const isContainer = !!(process.env.DOCKER || process.env.CONTAINER);
+        const isSystemd = !!(process.env.SYSTEMD_EXEC_PID || process.env.INVOCATION_ID);
+        if (isHeadlessLinux || isContainer || isSystemd) {
+            this.log.debug(`ℹ️ Environment detected (headlessLinux=${isHeadlessLinux}, container=${isContainer}, systemd=${isSystemd}) — ` +
+                'proceeding with AUTO auth first; will fallback to MANUAL if AUTO fails.');
+        }
+        // Di default tentiamo sempre AUTO
         return false;
     }
     async performAutoAuth() {
@@ -717,6 +754,19 @@ class AuthManager {
             issuedAt: this.tokenIssuedAt ? new Date(this.tokenIssuedAt) : undefined
         };
     }
+    logEnvDiagnostics() {
+        const env = process.env;
+        this.log.warn([
+            '🧪 ENV DIAGNOSTICS',
+            `platform=${process.platform}`,
+            `DISPLAY=${env.DISPLAY ?? '(unset)'}`,
+            `WAYLAND_DISPLAY=${env.WAYLAND_DISPLAY ?? '(unset)'}`,
+            `XDG_RUNTIME_DIR=${env.XDG_RUNTIME_DIR ?? '(unset)'}`,
+            `DBUS_SESSION_BUS_ADDRESS=${env.DBUS_SESSION_BUS_ADDRESS ? '(set)' : '(unset)'}`,
+            `SYSTEMD_EXEC_PID=${env.SYSTEMD_EXEC_PID ? '(set)' : '(unset)'}`,
+            `INVOCATION_ID=${env.INVOCATION_ID ? '(set)' : '(unset)'}`
+        ].join(' | '));
+    }
     cleanup() {
         if (this.tokenRefreshTimer) {
             clearTimeout(this.tokenRefreshTimer);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-viessmann-vicare",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "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": {
@@ -58,4 +58,4 @@
     "type": "individual",
     "url": "https://github.com/sponsors/diegoweb100"
   }
-}
+}