tsvesync 1.3.8 → 1.3.10

package/dist/lib/fans/airBaseV2.d.ts

@@ -30,10 +30,9 @@ export declare class VeSyncAirBaseV2 extends VeSyncAirBypass {
         action: string;
     } | null);
     /**
-     * Check response for Vital series devices
-     * These devices return success at API level but may have inner errors
+     * Check response for bypassV2 purifiers that surface nested result codes.
      */
-    protected checkVitalResponse(response: any, status: number, method: string): boolean;
+    protected checkV2Response(response: any, status: number, method: string): boolean;
     /**
      * Get device details
      */
@@ -43,24 +42,23 @@ export declare class VeSyncAirBaseV2 extends VeSyncAirBypass {
      */
     protected buildPurifierDict(devDict: Record<string, any>): void;
     /**
-     * Check if the current device is a Vital series model
-     * @returns true if this is a LAP-V102S or LAP-V201S device
+     * Determine whether this purifier requires the powerSwitch payload and nested response handling.
      */
-    private isVitalSeries;
+    private requiresPowerSwitchPayload;
     /**
-     * Override turn on method to handle Vital series special cases
+     * Override turn on to use the powerSwitch payload required by bypassV2 purifiers.
      */
     turnOn(): Promise<boolean>;
     /**
-     * Override turn off method to handle Vital series special cases
+     * Override turn off to use the powerSwitch payload required by bypassV2 purifiers.
      */
     turnOff(): Promise<boolean>;
     /**
-     * Override setMode method to handle Vital series special cases
+     * Override setMode to send workMode payloads for bypassV2 purifiers.
      */
     setMode(mode: string): Promise<boolean>;
     /**
-     * Override changeFanSpeed method to handle Vital series special cases
+     * Override changeFanSpeed to use manualSpeedLevel for bypassV2 purifiers.
      */
     changeFanSpeed(speed: number): Promise<boolean>;
     /**

package/dist/lib/fans/airBaseV2.js

@@ -46,26 +46,21 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         this._timer = value;
     }
     /**
-     * Check response for Vital series devices
-     * These devices return success at API level but may have inner errors
+     * Check response for bypassV2 purifiers that surface nested result codes.
      */
-    checkVitalResponse(response, status, method) {
-        // First check basic response
+    checkV2Response(response, status, method) {
+        // First check basic response structure
         if (!this.checkResponse([response, status], method)) {
             return false;
         }
-        // Check if this is a Vital series device
-        const isVitalSeries = this.deviceType.includes('LAP-V102S') || this.deviceType.includes('LAP-V201S');
-        if (!isVitalSeries) {
-            return true; // Not a Vital series device, standard check is enough
+        // Only apply extended handling to bypassV2 purifiers (Vital/Everest)
+        if (!this.requiresPowerSwitchPayload()) {
+            return true;
         }
-        // For Vital series, we need to check the inner result code
+        // These devices frequently succeed with a nested non-zero code
         if (response.result && response.result.code !== undefined && response.result.code !== 0) {
-            // Vital series often returns code -1 but still succeeds
-            // Let's update the state optimistically
-            logger_1.logger.debug(`Vital series device ${this.deviceName} returned inner code ${response.result.code} for ${method}`);
-            logger_1.logger.debug('This is normal for Vital series devices - proceeding with operation');
-            // Keep the device online despite inner error
+            logger_1.logger.debug(`${this.deviceName} returned inner code ${response.result.code} for ${method}`);
+            logger_1.logger.debug('BypassV2 purifier reports non-zero inner code but request still succeeded');
             this.connectionStatus = 'online';
             return true;
         }
@@ -79,22 +74,20 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         logger_1.logger.debug(`Getting details for device: ${this.deviceName}`);
         const [head, body] = this.buildApiDict('getPurifierStatus');
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
-        // Check if this is a Vital series device (LAP-V102S or LAP-V201S)
-        const isVitalSeries = this.deviceType.includes('LAP-V102S') || this.deviceType.includes('LAP-V201S');
+        const needsV2Handling = this.requiresPowerSwitchPayload();
         // First check the outer response
         if (!response || status !== 200) {
             logger_1.logger.debug(`Error getting purifier details for ${this.deviceName}: Invalid response`);
             this.connectionStatus = 'offline';
             return false;
         }
-        // For Vital series, we need special handling as they return inner code -1 for details
-        // but still provide valid status information
-        if (isVitalSeries && response.result) {
+        // For bypassV2 purifier families the API nests the result and may surface non-zero codes
+        if (needsV2Handling && response.result) {
             // Check if we have a valid getPurifierStatus response
             if (response.code === 0 && ((_a = response.result) === null || _a === void 0 ? void 0 : _a.result)) {
                 const statusResponse = response.result.result;
                 // If we have valid status data, use it regardless of inner result code
-                logger_1.logger.debug(`Using status data for Vital series device: ${this.deviceName}`);
+                logger_1.logger.debug(`Using nested status data for bypassV2 purifier: ${this.deviceName}`);
                 this.buildPurifierDict(statusResponse);
                 if (statusResponse.configuration) {
                     this.buildConfigDict(statusResponse.configuration);
@@ -104,7 +97,7 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
                 return true;
             }
         }
-        // Standard processing for non-Vital devices or when no status data is available
+        // Standard processing for non-bypassV2 devices or when no status data is available
         if (!this.checkResponse([response, status], 'getDetails') || !(response === null || response === void 0 ? void 0 : response.result)) {
             logger_1.logger.debug('Error getting purifier details');
             this.connectionStatus = 'offline';
@@ -133,7 +126,9 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         this.enabled = powerSwitch;
         this.deviceStatus = powerSwitch ? 'on' : 'off';
         this.mode = (_b = devDict.workMode) !== null && _b !== void 0 ? _b : 'manual';
-        this.speed = (_c = devDict.fanSpeedLevel) !== null && _c !== void 0 ? _c : 0;
+        const reportedFanSpeed = (_c = devDict.fanSpeedLevel) !== null && _c !== void 0 ? _c : 0;
+        const isAutoSentinel = reportedFanSpeed === 255;
+        this.speed = isAutoSentinel ? 0 : reportedFanSpeed;
         this.setSpeedLevel = (_d = devDict.manualSpeedLevel) !== null && _d !== void 0 ? _d : 1;
         // Parse filter life with proper fallback handling and logging
         let filterLife = 0;
@@ -159,7 +154,11 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             light_detection_switch: Boolean((_g = devDict.lightDetectionSwitch) !== null && _g !== void 0 ? _g : 0),
             environment_light_state: Boolean((_h = devDict.environmentLightState) !== null && _h !== void 0 ? _h : 0),
             screen_switch: Boolean((_j = devDict.screenSwitch) !== null && _j !== void 0 ? _j : 0),
-            screenStatus: Boolean((_k = devDict.screenSwitch) !== null && _k !== void 0 ? _k : 0) ? 'on' : 'off'
+            screenStatus: Boolean((_k = devDict.screenSwitch) !== null && _k !== void 0 ? _k : 0) ? 'on' : 'off',
+            manualSpeedLevel: this.setSpeedLevel,
+            mode: this.mode,
+            speed: this.speed,
+            isAutoSentinel
         };
         if (this.hasFeature('air_quality')) {
             this.details.air_quality_value = (_l = devDict.PM25) !== null && _l !== void 0 ? _l : 0;
@@ -186,29 +185,28 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         }
     }
     /**
-     * Check if the current device is a Vital series model
-     * @returns true if this is a LAP-V102S or LAP-V201S device
+     * Determine whether this purifier requires the powerSwitch payload and nested response handling.
      */
-    isVitalSeries() {
-        return this.deviceType.includes('LAP-V102S') || this.deviceType.includes('LAP-V201S');
+    requiresPowerSwitchPayload() {
+        const type = (this.deviceType || '').toUpperCase();
+        return type.startsWith('LAP-V') || type.startsWith('LAP-EL');
     }
     /**
-     * Override turn on method to handle Vital series special cases
+     * Override turn on to use the powerSwitch payload required by bypassV2 purifiers.
      */
     async turnOn() {
         logger_1.logger.info(`Turning on device: ${this.deviceName}`);
         const [head, body] = this.buildApiDict('setSwitch');
-        // For Vital series, use powerSwitch per YAML spec
-        // For other models, use the parent class implementation
-        if (this.isVitalSeries()) {
-            logger_1.logger.debug(`Using Vital series specific payload for ${this.deviceName}`);
+        // BypassV2 purifiers require powerSwitch toggles; others fall back to the base implementation
+        if (this.requiresPowerSwitchPayload()) {
+            logger_1.logger.debug(`Using bypassV2 power payload for ${this.deviceName}`);
             body.payload.data = {
                 powerSwitch: 1,
                 switchIdx: 0
             };
             const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
-            // Use Vital-specific response checking
-            const success = this.checkVitalResponse(response, status, 'turnOn');
+            // Use bypassV2 response checking
+            const success = this.checkV2Response(response, status, 'turnOn');
             if (success) {
                 this.deviceStatus = 'on';
                 // Force a details update to sync state
@@ -221,27 +219,26 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             return success;
         }
         else {
-            // Use parent implementation for non-Vital models
+            // Use parent implementation for non-bypassV2 models
             return super.turnOn();
         }
     }
     /**
-     * Override turn off method to handle Vital series special cases
+     * Override turn off to use the powerSwitch payload required by bypassV2 purifiers.
      */
     async turnOff() {
         logger_1.logger.info(`Turning off device: ${this.deviceName}`);
         const [head, body] = this.buildApiDict('setSwitch');
-        // For Vital series, use powerSwitch per YAML spec
-        // For other models, use the parent class implementation
-        if (this.isVitalSeries()) {
-            logger_1.logger.debug(`Using Vital series specific payload for ${this.deviceName}`);
+        // BypassV2 purifiers require powerSwitch toggles; others fall back to the base implementation
+        if (this.requiresPowerSwitchPayload()) {
+            logger_1.logger.debug(`Using bypassV2 power payload for ${this.deviceName}`);
             body.payload.data = {
                 powerSwitch: 0,
                 switchIdx: 0
             };
             const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
-            // Use Vital-specific response checking
-            const success = this.checkVitalResponse(response, status, 'turnOff');
+            // Use bypassV2 response checking
+            const success = this.checkV2Response(response, status, 'turnOff');
             if (success) {
                 this.deviceStatus = 'off';
                 // Force a details update to sync state
@@ -254,12 +251,12 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             return success;
         }
         else {
-            // Use parent implementation for non-Vital models
+            // Use parent implementation for non-bypassV2 models
             return super.turnOff();
         }
     }
     /**
-     * Override setMode method to handle Vital series special cases
+     * Override setMode to send workMode payloads for bypassV2 purifiers.
      */
     async setMode(mode) {
         if (!this.modes.includes(mode)) {
@@ -272,16 +269,15 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             logger_1.logger.warn(`Auto mode not supported for ${this.deviceType}, using manual mode instead`);
             return this.setMode('manual');
         }
-        // For Vital series, use special response handling
-        // For other models, use the parent implementation
-        if (this.isVitalSeries()) {
-            logger_1.logger.debug(`Using Vital series specific response handling for ${this.deviceName}`);
+        // BypassV2 purifiers need the workMode payload; other models use the base implementation
+        if (this.requiresPowerSwitchPayload()) {
+            logger_1.logger.debug(`Using bypassV2 mode payload for ${this.deviceName}`);
             const [head, body] = this.buildApiDict('setPurifierMode');
             body.payload.data = {
                 workMode: mode
             };
             const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
-            const success = this.checkVitalResponse(response, status, 'setMode');
+            const success = this.checkV2Response(response, status, 'setMode');
             if (success) {
                 this.details.mode = mode;
                 this._mode = mode;
@@ -299,12 +295,12 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             }
         }
         else {
-            // Use parent implementation for non-Vital models
+            // Use parent implementation for non-bypassV2 models
             return super.setMode(mode);
         }
     }
     /**
-     * Override changeFanSpeed method to handle Vital series special cases
+     * Override changeFanSpeed to use manualSpeedLevel for bypassV2 purifiers.
      */
     async changeFanSpeed(speed) {
         var _a;
@@ -315,17 +311,17 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         }
         logger_1.logger.info(`Changing fan speed to ${speed} for device: ${this.deviceName}`);
         const [head, body] = this.buildApiDict('setLevel');
-        // Specific handling for Vital series devices
-        if (this.isVitalSeries()) {
-            logger_1.logger.debug(`Using Vital series specific payload for ${this.deviceName}`);
-            // For Vital series, use levelIdx, levelType, and manualSpeedLevel per YAML spec
+        // Specific handling for bypassV2 devices
+        if (this.requiresPowerSwitchPayload()) {
+            logger_1.logger.debug(`Using bypassV2 speed payload for ${this.deviceName}`);
+            // For these devices, use levelIdx, levelType, and manualSpeedLevel per YAML spec
             body.payload.data = {
                 levelIdx: 0,
                 levelType: 'wind',
                 manualSpeedLevel: speed
             };
             const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
-            const success = this.checkVitalResponse(response, status, 'changeFanSpeed');
+            const success = this.checkV2Response(response, status, 'changeFanSpeed');
             if (success) {
                 this.speed = speed;
                 this.details.manualSpeedLevel = speed;
@@ -343,7 +339,7 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
             }
         }
         else {
-            // For non-Vital models, use id, level, mode, and type
+            // For non-bypassV2 models, use id, level, mode, and type
             body.payload.data = {
                 id: 0,
                 level: speed,
@@ -378,14 +374,14 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         };
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
         // Use the appropriate response checking method based on device type
-        const success = this.isVitalSeries()
-            ? this.checkVitalResponse(response, status, 'setAutoPreference')
+        const success = this.requiresPowerSwitchPayload()
+            ? this.checkV2Response(response, status, 'setAutoPreference')
             : this.checkResponse([response, status], 'setAutoPreference');
         if (success) {
             this.details.auto_preference = preference;
             this.details.auto_preference_type = preference;
-            // Force a details update to sync state for Vital series
-            if (this.isVitalSeries()) {
+            // Force a details update to sync state for bypassV2 purifiers
+            if (this.requiresPowerSwitchPayload()) {
                 setTimeout(() => {
                     this.getDetails().catch(e => {
                         logger_1.logger.debug(`Background state refresh failed: ${e}`);
@@ -405,13 +401,13 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         };
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
         // Use the appropriate response checking method based on device type
-        const success = this.isVitalSeries()
-            ? this.checkVitalResponse(response, status, 'setLightDetection')
+        const success = this.requiresPowerSwitchPayload()
+            ? this.checkV2Response(response, status, 'setLightDetection')
             : this.checkResponse([response, status], 'setLightDetection');
         if (success) {
             this.details.light_detection_switch = enabled;
-            // Force a details update to sync state for Vital series
-            if (this.isVitalSeries()) {
+            // Force a details update to sync state for bypassV2 purifiers
+            if (this.requiresPowerSwitchPayload()) {
                 setTimeout(() => {
                     this.getDetails().catch(e => {
                         logger_1.logger.debug(`Background state refresh failed: ${e}`);
@@ -486,8 +482,8 @@ class VeSyncAirBaseV2 extends airBypass_1.VeSyncAirBypass {
         };
         const [response, status] = await this.callApi('/cloud/v2/deviceManaged/bypassV2', 'post', body, head);
         // Use the appropriate response checking method based on device type
-        const success = this.isVitalSeries()
-            ? this.checkVitalResponse(response, status, 'setOscillation')
+        const success = this.requiresPowerSwitchPayload()
+            ? this.checkV2Response(response, status, 'setOscillation')
             : this.checkResponse([response, status], 'setOscillation');
         if (success) {
             this.details.oscillationState = toggle;

package/dist/lib/vesyncBulb.d.ts

@@ -3,6 +3,11 @@
  */
 import { VeSyncBaseDevice } from './vesyncBaseDevice';
 import { VeSync } from './vesync';
+interface RgbValues {
+    red: number;
+    green: number;
+    blue: number;
+}
 interface BulbConfig {
     [key: string]: {
         module: string;
@@ -22,12 +27,11 @@ export declare abstract class VeSyncBulb extends VeSyncBaseDevice {
     protected colorSaturation: number;
     protected colorMode: string;
     protected features: string[];
-    protected rgbValues: {
-        red: number;
-        green: number;
-        blue: number;
-    };
+    protected rgbValues: RgbValues;
     constructor(details: Record<string, any>, manager: VeSync);
+    hasFeature(feature: string): boolean;
+    getColorModel(): string;
+    getBrightness(): number;
     /**
      * Get bulb details
      */
@@ -51,7 +55,6 @@ export declare abstract class VeSyncBulb extends VeSyncBaseDevice {
     /**
      * Get bulb brightness
      */
-    getBrightness(): number;
     /**
      * Get color temperature in Kelvin
      */
@@ -80,9 +83,23 @@ export declare abstract class VeSyncBulb extends VeSyncBaseDevice {
         green: number;
         blue: number;
     };
+    /**
+     * Set color temperature wrapper to maintain compatibility with consumers
+     */
+    setColorTemperature(colorTemp: number): Promise<boolean>;
+    /**
+     * Set color via hue/saturation/value when supported
+     */
+    setColor(hue: number, saturation: number, value?: number): Promise<boolean>;
+    /**
+     * Process standard bypass (v1) detail responses shared by multiple bulbs
+     */
+    protected processStandardBypassDetails(response: any, statusCode: number): boolean;
     /**
      * Set color temperature - Abstract method to be implemented by subclasses
      */
     abstract setColorTemp(colorTemp: number): Promise<boolean>;
+    protected static clamp(value: number, min: number, max: number): number;
+    protected static hsvToRgb(h: number, s: number, v: number): RgbValues;
 }
 export {};

package/dist/lib/vesyncBulb.js

@@ -50,6 +50,16 @@ class VeSyncBulb extends vesyncBaseDevice_1.VeSyncBaseDevice {
             blue: 0
         };
     }
+    hasFeature(feature) {
+        return this.features.includes(feature);
+    }
+    getColorModel() {
+        var _a, _b;
+        return (_b = (_a = exports.bulbConfig[this.deviceType]) === null || _a === void 0 ? void 0 : _a.colorModel) !== null && _b !== void 0 ? _b : 'none';
+    }
+    getBrightness() {
+        return this.brightness;
+    }
     /**
      * Get bulb details
      */
@@ -75,30 +85,7 @@ class VeSyncBulb extends vesyncBaseDevice_1.VeSyncBaseDevice {
             }
         };
         const [response, statusCode] = await this.callApi(endpoint, 'post', body, helpers_1.Helpers.reqHeaders(this.manager));
-        const success = this.checkResponse([response, statusCode], 'getDetails');
-        if (success && (response === null || response === void 0 ? void 0 : response.result)) {
-            this.deviceStatus = response.result.enabled ? 'on' : 'off';
-            this.brightness = response.result.brightness || this.brightness;
-            if (this.features.includes('color_temp')) {
-                this.colorTemp = response.result.colorTemp || this.colorTemp;
-            }
-            if (this.features.includes('rgb_shift')) {
-                if (exports.bulbConfig[this.deviceType].colorModel === 'rgb') {
-                    this.rgbValues = {
-                        red: response.result.red || this.rgbValues.red,
-                        green: response.result.green || this.rgbValues.green,
-                        blue: response.result.blue || this.rgbValues.blue
-                    };
-                }
-                else {
-                    this.colorHue = response.result.hue || this.colorHue;
-                    this.colorSaturation = response.result.saturation || this.colorSaturation;
-                    this.colorValue = response.result.value || this.colorValue;
-                }
-            }
-            logger_1.logger.debug(`[${this.deviceName}] Successfully retrieved bulb details`);
-        }
-        return success;
+        return this.processStandardBypassDetails(response, statusCode);
     }
     /**
      * Update bulb details
@@ -193,7 +180,8 @@ class VeSyncBulb extends vesyncBaseDevice_1.VeSyncBaseDevice {
             logger_1.logger.error(`[${this.deviceName}] Dimming not supported`);
             return false;
         }
-        logger_1.logger.debug(`[${this.deviceName}] Setting brightness to ${brightness}`);
+        const brightnessLevel = VeSyncBulb.clamp(Math.round(brightness), 0, 100);
+        logger_1.logger.debug(`[${this.deviceName}] Setting brightness to ${brightnessLevel}`);
         const isV2Device = this.deviceType === 'XYD0001';
         const endpoint = isV2Device ? '/cloud/v2/deviceManaged/bypassV2' : '/cloud/v1/deviceManaged/bypass';
         const body = isV2Device ? {
@@ -202,7 +190,7 @@ class VeSyncBulb extends vesyncBaseDevice_1.VeSyncBaseDevice {
             configModule: this.configModule,
             payload: {
                 data: {
-                    brightness: brightness,
+                    brightness: brightnessLevel,
                     colorMode: '',
                     colorTemp: '',
                     force: 0,
@@ -219,14 +207,14 @@ class VeSyncBulb extends vesyncBaseDevice_1.VeSyncBaseDevice {
             configModule: this.configModule,
             jsonCmd: {
                 light: {
-                    brightness: brightness
+                    brightness: brightnessLevel
                 }
             }
         };
         const [response] = await this.callApi(endpoint, 'post', body, helpers_1.Helpers.reqHeaders(this.manager));
         if ((response === null || response === void 0 ? void 0 : response.code) === 0) {
-            this.brightness = brightness;
-            logger_1.logger.info(`[${this.deviceName}] Successfully set brightness to ${brightness}`);
+            this.brightness = brightnessLevel;
+            logger_1.logger.info(`[${this.deviceName}] Successfully set brightness to ${brightnessLevel}`);
             return true;
         }
         logger_1.logger.error(`[${this.deviceName}] Failed to set brightness: ${JSON.stringify(response)}`);
@@ -235,9 +223,6 @@ class VeSyncBulb extends vesyncBaseDevice_1.VeSyncBaseDevice {
     /**
      * Get bulb brightness
      */
-    getBrightness() {
-        return this.brightness;
-    }
     /**
      * Get color temperature in Kelvin
      */
@@ -292,5 +277,132 @@ class VeSyncBulb extends vesyncBaseDevice_1.VeSyncBaseDevice {
         }
         return this.rgbValues;
     }
+    /**
+     * Set color temperature wrapper to maintain compatibility with consumers
+     */
+    async setColorTemperature(colorTemp) {
+        return this.setColorTemp(colorTemp);
+    }
+    /**
+     * Set color via hue/saturation/value when supported
+     */
+    async setColor(hue, saturation, value = 100) {
+        var _a;
+        if (!this.features.includes('rgb_shift')) {
+            logger_1.logger.error(`[${this.deviceName}] Color control not supported`);
+            return false;
+        }
+        const colorModel = (_a = exports.bulbConfig[this.deviceType]) === null || _a === void 0 ? void 0 : _a.colorModel;
+        if (colorModel === 'rgb' && typeof this.setRgb === 'function') {
+            const rgb = VeSyncBulb.hsvToRgb(hue, saturation, value);
+            return this.setRgb(rgb.red, rgb.green, rgb.blue);
+        }
+        if (typeof this.setHsv === 'function') {
+            return this.setHsv(hue, saturation, value);
+        }
+        logger_1.logger.error(`[${this.deviceName}] No compatible color handler found`);
+        return false;
+    }
+    /**
+     * Process standard bypass (v1) detail responses shared by multiple bulbs
+     */
+    processStandardBypassDetails(response, statusCode) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const success = this.checkResponse([response, statusCode], 'getDetails');
+        if (success && (response === null || response === void 0 ? void 0 : response.result)) {
+            const innerResult = ((_a = response.result) === null || _a === void 0 ? void 0 : _a.result) || response.result;
+            if (innerResult) {
+                if (typeof innerResult.enabled === 'boolean') {
+                    this.deviceStatus = innerResult.enabled ? 'on' : 'off';
+                }
+                else if (innerResult.action) {
+                    this.deviceStatus = innerResult.action === 'on' ? 'on' : 'off';
+                }
+                if (innerResult.connectionStatus) {
+                    this.connectionStatus = innerResult.connectionStatus;
+                }
+                if (this.features.includes('dimmable') && innerResult.brightness !== undefined) {
+                    this.brightness = Number(innerResult.brightness);
+                }
+                if (this.features.includes('color_temp')) {
+                    if (innerResult.colorTemp !== undefined) {
+                        this.colorTemp = Number(innerResult.colorTemp);
+                    }
+                    else if (innerResult.colorTempe !== undefined) {
+                        this.colorTemp = Number(innerResult.colorTempe);
+                    }
+                }
+                if (this.features.includes('rgb_shift')) {
+                    if (((_b = exports.bulbConfig[this.deviceType]) === null || _b === void 0 ? void 0 : _b.colorModel) === 'rgb') {
+                        this.rgbValues = {
+                            red: Number((_c = innerResult.red) !== null && _c !== void 0 ? _c : this.rgbValues.red),
+                            green: Number((_d = innerResult.green) !== null && _d !== void 0 ? _d : this.rgbValues.green),
+                            blue: Number((_e = innerResult.blue) !== null && _e !== void 0 ? _e : this.rgbValues.blue)
+                        };
+                    }
+                    else {
+                        this.colorHue = Number((_f = innerResult.hue) !== null && _f !== void 0 ? _f : this.colorHue);
+                        this.colorSaturation = Number((_g = innerResult.saturation) !== null && _g !== void 0 ? _g : this.colorSaturation);
+                        this.colorValue = Number((_h = innerResult.value) !== null && _h !== void 0 ? _h : this.colorValue);
+                    }
+                }
+            }
+            logger_1.logger.debug(`[${this.deviceName}] Successfully retrieved bulb details`);
+        }
+        return success;
+    }
+    static clamp(value, min, max) {
+        return Math.min(Math.max(value, min), max);
+    }
+    static hsvToRgb(h, s, v) {
+        const saturation = VeSyncBulb.clamp(s, 0, 100) / 100;
+        const value = VeSyncBulb.clamp(v, 0, 100) / 100;
+        const hue = ((h % 360) + 360) % 360 / 60;
+        const i = Math.floor(hue);
+        const f = hue - i;
+        const p = value * (1 - saturation);
+        const q = value * (1 - saturation * f);
+        const t = value * (1 - saturation * (1 - f));
+        let r = 0;
+        let g = 0;
+        let b = 0;
+        switch (i) {
+            case 0:
+                r = value;
+                g = t;
+                b = p;
+                break;
+            case 1:
+                r = q;
+                g = value;
+                b = p;
+                break;
+            case 2:
+                r = p;
+                g = value;
+                b = t;
+                break;
+            case 3:
+                r = p;
+                g = q;
+                b = value;
+                break;
+            case 4:
+                r = t;
+                g = p;
+                b = value;
+                break;
+            default:
+                r = value;
+                g = p;
+                b = q;
+                break;
+        }
+        return {
+            red: Math.round(r * 255),
+            green: Math.round(g * 255),
+            blue: Math.round(b * 255)
+        };
+    }
 }
 exports.VeSyncBulb = VeSyncBulb;