meross-iot 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-01-16
+
+### Changed
+- **BREAKING**: Renamed `getDevices()` to `initializeDevices()` in `ManagerMeross`
+  - The method name better reflects that it performs full device discovery, initialization, and connection setup, not just retrieval
+  - Updated `login()` and `connect()` to use `initializeDevices()`
+  - Updated all examples and TypeScript definitions
+- **BREAKING**: Simplified device API by establishing single source of truth
+  - Removed `deviceDef` parameter from `deviceInitialized` event - now just `(deviceId, device)`
+  - Removed `cachedHttpInfo` property; all properties are now directly accessible on `MerossDevice`
+  - Converted simple getters to direct properties (`macAddress`, `lanIp`, `mqttHost`, etc.)
+  - Updated all feature files to use public properties (`abilities`, `lastFullUpdateTimestamp`)
+  - Removed unnecessary defensive fallback patterns (`device.dev?.uuid` → `device.uuid`)
+  - Fixed subdevice property consistency
+- **BREAKING**: Removed snake_case handling, standardized on camelCase
+  - Removed snake_case property mappings from `HttpDeviceInfo`, `HttpSubdeviceInfo`, `HardwareInfo`, `FirmwareInfo`, and `TimeInfo`
+  - Updated filter parameters to camelCase (`deviceUuids`, `deviceType`, `onlineStatus`, etc.)
+  - Changed `subdevice_id` getter to `subdeviceId` in push notification classes
+  - Updated `TokenData` interface: `issued_on` → `issuedOn`
+  - All JSDoc comments now reflect direct camelCase acceptance
+
+### Updated
+- Updated all examples to use camelCase consistently
+- Updated all examples to use `initializeDevices()` instead of `getDevices()`
+
+## [0.3.1] - 2026-01-15
+
+### Fixed
+- Fixed `ManagerSubscription` constructor bug: now properly calls `super()` before accessing `this` to correctly initialize EventEmitter parent class
+
 ## [0.3.0] - 2026-01-15
 
 ### Changed

package/README.md

@@ -26,7 +26,7 @@ The library can control devices locally via HTTP or via cloud MQTT server.
 npm install meross-iot@alpha
 
 # Or install specific version
-npm install meross-iot@0.3.0
+npm install meross-iot@0.4.0
 ```
 
 ## Usage & Documentation
@@ -51,8 +51,8 @@ const { ManagerMeross, MerossHttpClient } = require('meross-iot');
   });
 
   // Listen for device events
-  meross.on('deviceInitialized', (deviceId, deviceDef, device) => {
-    console.log(`Device found: ${deviceDef.devName} (${deviceDef.deviceType})`);
+  meross.on('deviceInitialized', (deviceId, device) => {
+    console.log(`Device found: ${device.name} (${device.deviceType})`);
   });
 
   // Connect and discover devices
@@ -120,6 +120,39 @@ Please create an issue on GitHub and include:
 
 ## Changelog
 
+### [0.4.0] - 2026-01-16
+
+#### Changed
+- **BREAKING**: Renamed `getDevices()` to `initializeDevices()` in `ManagerMeross`
+  - The method name better reflects that it performs full device discovery, initialization, and connection setup, not just retrieval
+  - Updated `login()` and `connect()` to use `initializeDevices()`
+  - Updated all examples and TypeScript definitions
+- **BREAKING**: Simplified device API by establishing single source of truth
+  - Removed `deviceDef` parameter from `deviceInitialized` event - now just `(deviceId, device)`
+  - Removed `cachedHttpInfo` property; all properties are now directly accessible on `MerossDevice`
+  - Converted simple getters to direct properties (`macAddress`, `lanIp`, `mqttHost`, etc.)
+  - Updated all feature files to use public properties (`abilities`, `lastFullUpdateTimestamp`)
+  - Removed unnecessary defensive fallback patterns (`device.dev?.uuid` → `device.uuid`)
+  - Fixed subdevice property consistency
+- **BREAKING**: Removed snake_case handling, standardized on camelCase
+  - Removed snake_case property mappings from `HttpDeviceInfo`, `HttpSubdeviceInfo`, `HardwareInfo`, `FirmwareInfo`, and `TimeInfo`
+  - Updated filter parameters to camelCase (`deviceUuids`, `deviceType`, `onlineStatus`, etc.)
+  - Changed `subdevice_id` getter to `subdeviceId` in push notification classes
+  - Updated `TokenData` interface: `issued_on` → `issuedOn`
+  - All JSDoc comments now reflect direct camelCase acceptance
+
+#### Updated
+- Updated all examples to use camelCase consistently
+- Updated all examples to use `initializeDevices()` instead of `getDevices()`
+
+<details>
+<summary>Older</summary>
+
+### [0.3.1] - 2026-01-15
+
+#### Fixed
+- Fixed `ManagerSubscription` constructor bug: now properly calls `super()` before accessing `this` to correctly initialize EventEmitter parent class
+
 ### [0.3.0] - 2026-01-15
 
 #### Changed
@@ -189,11 +222,6 @@ Please create an issue on GitHub and include:
 - This is an initial, pre-stable release. Please expect bugs. 
 - Some edge cases may not be fully handled yet.
 
-<details>
-<summary>Older</summary>
-
-<!-- Older changelog entries will appear here -->
-
 </details>
 
 ## Disclaimer

package/index.d.ts

@@ -164,10 +164,10 @@ declare module 'meross-iot' {
         /**
          * Creates an HttpDeviceInfo instance from a dictionary object.
          * 
-         * Normalizes incoming keys (handles camelCase and snake_case) to camelCase.
+         * Accepts camelCase API response format directly (no normalization needed).
          * This is the only way to create instances.
          * 
-         * @param jsonDict - Dictionary object from the API response
+         * @param jsonDict - Dictionary object from the API response with camelCase keys
          * @returns New HttpDeviceInfo instance
          */
         static fromDict(jsonDict: { [key: string]: any }): HttpDeviceInfo
@@ -223,7 +223,8 @@ declare module 'meross-iot' {
         readonly subDeviceIconId: string | null
         /**
          * Creates an HttpSubdeviceInfo instance from a dictionary object.
-         * Normalizes incoming keys (handles camelCase, snake_case, and generic keys) to camelCase.
+         * Accepts camelCase API response format. Generic keys ('id', 'type', 'name') are supported
+         * as fallbacks for API variations and are normalized to camelCase properties.
          * This is the only way to create instances.
          */
         static fromDict(jsonDict: { [key: string]: any }): HttpSubdeviceInfo
@@ -252,7 +253,7 @@ declare module 'meross-iot' {
         readonly chipType: string | null
         /**
          * Creates a HardwareInfo instance from a dictionary object.
-         * Normalizes incoming keys (handles camelCase and snake_case) to camelCase.
+         * Accepts camelCase API response format directly (no normalization needed).
          * This is the only way to create instances.
          */
         static fromDict(jsonDict: { [key: string]: any }): HardwareInfo | null
@@ -280,7 +281,7 @@ declare module 'meross-iot' {
         readonly compileTime: string | null
         /**
          * Creates a FirmwareInfo instance from a dictionary object.
-         * Normalizes incoming keys (handles camelCase and snake_case) to camelCase.
+         * Accepts camelCase API response format directly (no normalization needed).
          * This is the only way to create instances.
          */
         static fromDict(jsonDict: { [key: string]: any }): FirmwareInfo | null
@@ -305,7 +306,7 @@ declare module 'meross-iot' {
         readonly timeRule: string | null
         /**
          * Creates a TimeInfo instance from a dictionary object.
-         * Normalizes incoming keys (handles camelCase and snake_case) to camelCase.
+         * Accepts camelCase API response format directly (no normalization needed).
          * This is the only way to create instances.
          */
         static fromDict(jsonDict: { [key: string]: any }): TimeInfo | null
@@ -386,7 +387,7 @@ declare module 'meross-iot' {
         /** MQTT domain */
         mqttDomain: string;
         /** Token issue timestamp (optional) */
-        issued_on?: string;
+        issuedOn?: string;
     }
 
     /**
@@ -875,7 +876,7 @@ declare module 'meross-iot' {
         readonly value?: number | string | Record<string, any>;
         readonly timestamp?: number;
         readonly channel?: number;
-        readonly subdevice_id?: string;
+        readonly subdeviceId?: string;
         constructor(originatingDeviceUuid: string, rawData: any);
     }
 
@@ -894,7 +895,7 @@ declare module 'meross-iot' {
         readonly syncedTime?: number | Record<string, any>;
         readonly latestSampleTime?: number;
         readonly latestSampleIsLeak?: number;
-        readonly subdevice_id?: string;
+        readonly subdeviceId?: string;
         readonly samples?: Array<{ time: number; isLeak: number; [key: string]: any }>;
         constructor(originatingDeviceUuid: string, rawData: any);
     }
@@ -965,7 +966,7 @@ declare module 'meross-iot' {
     }
 
     export class HubSensorSmokePushNotification extends GenericPushNotification {
-        readonly subdevice_id?: string | number;
+        readonly subdeviceId?: string | number;
         readonly status?: number;
         readonly interConn?: number | Record<string, any>;
         readonly timestamp?: number;
@@ -1106,7 +1107,7 @@ declare module 'meross-iot' {
     export type ErrorCallback = (error: Error | null) => void
     export type DeviceInitializedEvent = 'deviceInitialized'
 
-    export type DeviceInitializedCallback = (deviceId: string, deviceDef: DeviceDefinition, device: MerossDevice) => void
+    export type DeviceInitializedCallback = (deviceId: string, device: MerossDevice) => void
 
     export type PushNotificationEvent = 'pushNotification'
     export type PushNotificationCallback = (deviceId: string, notification: GenericPushNotification, device: MerossDevice) => void
@@ -1122,30 +1123,30 @@ declare module 'meross-iot' {
      * @example
      * ```typescript
      * // Find online devices
-     * const onlineDevices = manager.devices.find({ online_status: 1 });
+     * const onlineDevices = manager.devices.find({ onlineStatus: 1 });
      * 
      * // Find specific device types
-     * const plugs = manager.devices.find({ device_type: 'mss310' });
+     * const plugs = manager.devices.find({ deviceType: 'mss310' });
      * 
      * // Find by custom filter function
      * const customDevices = manager.devices.find({
-     *   device_class: (device) => device.deviceType.startsWith('mss')
+     *   deviceClass: (device) => device.deviceType.startsWith('mss')
      * });
      * ```
      */
     export interface FindDevicesFilters {
         /** Array of device UUIDs to filter by */
-        device_uuids?: string[];
+        deviceUuids?: string[];
         /** Array of internal device IDs to filter by */
-        internal_ids?: string[];
+        internalIds?: string[];
         /** Device type to filter by */
-        device_type?: string;
+        deviceType?: string;
         /** Device name to filter by */
-        device_name?: string;
+        deviceName?: string;
         /** Online status to filter by (0=connecting, 1=online, 2=offline, -1=unknown, 3=upgrading) */
-        online_status?: number;
+        onlineStatus?: number;
         /** Device class filter - can be a string, function, or array of filters */
-        device_class?: string | ((device: MerossDevice) => boolean) | Array<string | ((device: MerossDevice) => boolean)>;
+        deviceClass?: string | ((device: MerossDevice) => boolean) | Array<string | ((device: MerossDevice) => boolean)>;
     }
 
     /**
@@ -1168,7 +1169,7 @@ declare module 'meross-iot' {
      * const subdevice = manager.devices.get({ hubUuid: 'hub-uuid', id: 'subdevice-id' });
      * 
      * // Find devices matching filters
-     * const lights = manager.devices.find({ device_class: 'light' });
+     * const lights = manager.devices.find({ deviceClass: 'light' });
      * 
      * // Get all devices
      * const allDevices = manager.devices.list();
@@ -1500,8 +1501,8 @@ declare module 'meross-iot' {
      * const manager = new ManagerMeross({ httpClient });
      * await manager.connect();
      * 
-     * manager.on('deviceInitialized', (deviceId, deviceDef, device) => {
-     *   console.log(`Device ${deviceId} initialized`);
+     * manager.on('deviceInitialized', (deviceId, device) => {
+     *   console.log(`Device ${deviceId} initialized: ${device.name}`);
      * });
      * 
      * const devices = manager.devices.list();
@@ -1523,6 +1524,30 @@ declare module 'meross-iot' {
          */
         connect(): Promise<number>
         
+        /**
+         * Initializes all devices from the Meross cloud.
+         * 
+         * Fetches device list from cloud API, creates device instances, and sets up
+         * MQTT connections. Emits 'deviceInitialized' event for each device.
+         * 
+         * @returns Promise resolving to the number of devices initialized
+         * @throws {HttpApiError} If API request fails
+         * @throws {TokenExpiredError} If authentication token has expired
+         */
+        initializeDevices(): Promise<number>
+        
+        /**
+         * Authenticates with Meross cloud and discovers devices.
+         * 
+         * Alias for initializeDevices(). Retrieves device list and initializes device connections.
+         * The httpClient should already be authenticated when passed to the constructor.
+         * 
+         * @returns Promise resolving to the number of devices discovered
+         * @throws {HttpApiError} If API request fails
+         * @throws {TokenExpiredError} If authentication token has expired
+         */
+        login(): Promise<number>
+        
         /**
          * Registers a handler for device initialization events.
          * 
@@ -1934,7 +1959,22 @@ declare module 'meross-iot' {
         readonly isOnline: boolean
         readonly internalId: string
         readonly channels: ChannelInfo[]
-        readonly cachedHttpInfo: HttpDeviceInfo | null
+        /** Reserved MQTT domain (fallback domain) */
+        readonly reservedDomain: string | null
+        /** Device sub-type */
+        readonly subType: string | null
+        /** When the device was bound to the account */
+        readonly bindTime: Date | null
+        /** Skill number */
+        readonly skillNumber: string | null
+        /** User-defined device icon */
+        readonly userDevIcon: string | null
+        /** Icon type */
+        readonly iconType: number | null
+        /** Device region */
+        readonly region: string | null
+        /** Device icon ID */
+        readonly devIconId: string | null
 
         /**
          * Validates the current device state.

package/lib/controller/device.js

@@ -96,14 +96,24 @@ class MerossDevice extends EventEmitter {
             this.onlineStatus = dev.onlineStatus !== undefined ? dev.onlineStatus : OnlineStatus.UNKNOWN;
         }
 
-        this._abilities = null;
-        this._macAddress = null;
-        this._lanIp = null;
-        this._mqttHost = null;
-        this._mqttPort = port;
-        this._lastFullUpdateTimestamp = null;
+        this.abilities = null;
+        this.macAddress = null;
+        this.lanIp = null;
+        this.mqttHost = null;
+        this.mqttPort = port;
+        this.lastFullUpdateTimestamp = null;
         // Lazy initialization avoids registry computation during construction
         this._internalId = null;
+        
+        // Extended HTTP device info properties (populated from HttpDeviceInfo when available)
+        this.reservedDomain = null;
+        this.subType = null;
+        this.bindTime = null;
+        this.skillNumber = null;
+        this.userDevIcon = null;
+        this.iconType = null;
+        this.region = null;
+        this.devIconId = null;
     }
 
     /**
@@ -149,24 +159,34 @@ class MerossDevice extends EventEmitter {
     }
 
     /**
-     * Initializes HTTP device info and channels.
+     * Initializes HTTP device info and channels from raw API data.
      *
-     * Only creates HttpDeviceInfo when a full device object is available (not just UUID),
-     * as subdevices may be initialized with UUID only and lack HTTP API metadata.
+     * Uses HttpDeviceInfo.fromDict() to normalize data types (bindTime from Unix timestamp
+     * to Date, onlineStatus validation) before copying properties directly to the device
+     * instance. The HttpDeviceInfo instance is not stored to avoid redundancy.
      *
      * @private
-     * @param {Object} dev - Device information object
+     * @param {Object} dev - Device information object from API response
      */
     _initializeHttpInfo(dev) {
-        this._cachedHttpInfo = null;
-        this._channels = [];
+        this.channels = [];
 
         if (dev && dev.uuid && typeof dev === 'object' && dev.deviceType !== undefined) {
             try {
-                this._cachedHttpInfo = HttpDeviceInfo.fromDict(dev);
-                this._channels = MerossDevice._parseChannels(dev.channels);
+                const httpInfo = HttpDeviceInfo.fromDict(dev);
+                this.channels = MerossDevice._parseChannels(dev.channels);
+                
+                // Copy extended properties directly to device instance (bindTime already normalized to Date)
+                this.reservedDomain = httpInfo.reservedDomain || null;
+                this.subType = httpInfo.subType || null;
+                this.bindTime = httpInfo.bindTime || null;
+                this.skillNumber = httpInfo.skillNumber || null;
+                this.userDevIcon = httpInfo.userDevIcon || null;
+                this.iconType = httpInfo.iconType || null;
+                this.region = httpInfo.region || null;
+                this.devIconId = httpInfo.devIconId || null;
             } catch (error) {
-                // Continue without HttpDeviceInfo if parsing fails
+                // Device may be created without HTTP info (e.g., subdevices with UUID only)
             }
         }
     }
@@ -213,7 +233,7 @@ class MerossDevice extends EventEmitter {
      * @param {Object} abilities - Device abilities object
      */
     updateAbilities(abilities) {
-        this._abilities = abilities;
+        this.abilities = abilities;
         if (typeof this._updateAbilitiesWithEncryption === 'function') {
             this._updateAbilitiesWithEncryption(abilities);
         }
@@ -227,59 +247,12 @@ class MerossDevice extends EventEmitter {
      * @param {string} mac - MAC address string
      */
     updateMacAddress(mac) {
-        this._macAddress = mac;
+        this.macAddress = mac;
         if (typeof this._updateMacAddressWithEncryption === 'function') {
             this._updateMacAddressWithEncryption(mac);
         }
     }
 
-    /**
-     * Gets the device's MAC address
-     * @returns {string|null} MAC address or null if not available
-     */
-    get macAddress() {
-        return this._macAddress;
-    }
-
-    /**
-     * Gets the device's local network IP address
-     * @returns {string|null} LAN IP address or null if not available
-     */
-    get lanIp() {
-        return this._lanIp;
-    }
-
-    /**
-     * Gets the MQTT broker hostname
-     * @returns {string|null} MQTT hostname or null if not available
-     */
-    get mqttHost() {
-        return this._mqttHost;
-    }
-
-    /**
-     * Gets the MQTT broker port
-     * @returns {number|null} MQTT port or null if not available
-     */
-    get mqttPort() {
-        return this._mqttPort;
-    }
-
-    /**
-     * Gets the device's abilities dictionary
-     * @returns {Object|null} Abilities object or null if not available
-     */
-    get abilities() {
-        return this._abilities;
-    }
-
-    /**
-     * Gets the timestamp of the last full state update
-     * @returns {number|null} Timestamp in milliseconds or null if never updated
-     */
-    get lastFullUpdateTimestamp() {
-        return this._lastFullUpdateTimestamp;
-    }
 
     /**
      * Gets the internal ID used for device registry.
@@ -303,29 +276,6 @@ class MerossDevice extends EventEmitter {
         return this._internalId;
     }
 
-    /**
-     * Gets the list of channels exposed by this device
-     *
-     * Multi-channel devices might expose a master switch at index 0.
-     * Channels are parsed from the HTTP device info during device initialization.
-     *
-     * @returns {Array<ChannelInfo>} Array of ChannelInfo objects
-     */
-    get channels() {
-        return this._channels;
-    }
-
-    /**
-     * Gets the cached HTTP device info
-     *
-     * Returns the original device information object from the HTTP API,
-     * or null if not available (e.g., for subdevices created without HTTP info).
-     *
-     * @returns {HttpDeviceInfo|null} Cached HTTP device info or null
-     */
-    get cachedHttpInfo() {
-        return this._cachedHttpInfo;
-    }
 
     /**
      * Validates that the device state has been refreshed.
@@ -336,7 +286,7 @@ class MerossDevice extends EventEmitter {
      * @returns {boolean} True if state has been refreshed, false otherwise
      */
     validateState() {
-        const updateDone = this._lastFullUpdateTimestamp !== null;
+        const updateDone = this.lastFullUpdateTimestamp !== null;
         if (!updateDone) {
             const deviceName = this.name || this.uuid || 'unknown device';
             const logger = this.cloudInst?.options?.logger || console.error;
@@ -359,7 +309,7 @@ class MerossDevice extends EventEmitter {
             await this.getSystemAllData();
 
             this.emit('stateRefreshed', {
-                timestamp: this._lastFullUpdateTimestamp || Date.now(),
+                timestamp: this.lastFullUpdateTimestamp || Date.now(),
                 state: this.getUnifiedState()
             });
         } else {
@@ -378,7 +328,7 @@ class MerossDevice extends EventEmitter {
     getUnifiedState() {
         const state = {
             online: this.onlineStatus,
-            timestamp: this._lastFullUpdateTimestamp || Date.now()
+            timestamp: this.lastFullUpdateTimestamp || Date.now()
         };
 
         this._collectFeatureStates(state);
@@ -698,15 +648,15 @@ class MerossDevice extends EventEmitter {
         const firmware = system.firmware;
         if (firmware) {
             if (firmware.innerIp) {
-                this._lanIp = firmware.innerIp;
+                this.lanIp = firmware.innerIp;
             }
             if (firmware.server) {
-                this._mqttHost = firmware.server;
+                this.mqttHost = firmware.server;
             }
             if (firmware.port) {
-                this._mqttPort = firmware.port;
+                this.mqttPort = firmware.port;
             }
-            this._lastFullUpdateTimestamp = Date.now();
+            this.lastFullUpdateTimestamp = Date.now();
         }
 
         if (system.online) {
@@ -1092,14 +1042,14 @@ class MerossDevice extends EventEmitter {
      * @param {string} ip - Local IP address
      */
     setKnownLocalIp(ip) {
-        this._lanIp = ip;
+        this.lanIp = ip;
     }
 
     /**
      * Removes the known local IP address
      */
     removeKnownLocalIp() {
-        this._lanIp = null;
+        this.lanIp = null;
     }
 
     /**
@@ -1126,7 +1076,7 @@ class MerossDevice extends EventEmitter {
                     return reject(new UnconnectedError('Device is not connected', this.uuid));
                 }
 
-                const res = await this.cloudInst.requestMessage(this, this._lanIp, data, transportMode);
+                const res = await this.cloudInst.requestMessage(this, this.lanIp, data, transportMode);
                 if (!res) {
                     return reject(new UnconnectedError('Device has no data connection available', this.uuid));
                 }
@@ -1232,9 +1182,9 @@ class MerossDevice extends EventEmitter {
     lookupChannel(channelIdOrName) {
         let res = [];
         if (typeof channelIdOrName === 'string') {
-            res = this._channels.filter(c => c.name === channelIdOrName);
+            res = this.channels.filter(c => c.name === channelIdOrName);
         } else if (typeof channelIdOrName === 'number') {
-            res = this._channels.filter(c => c.index === channelIdOrName);
+            res = this.channels.filter(c => c.index === channelIdOrName);
         }
 
         if (res.length === 1) {
@@ -1245,14 +1195,16 @@ class MerossDevice extends EventEmitter {
     }
 
     /**
-     * Updates device information from HTTP device info
+     * Updates device properties from HttpDeviceInfo object.
      *
-     * Updates the device's cached HTTP info, channels, and all device properties
-     * from an HttpDeviceInfo object (created via HttpDeviceInfo.fromDict()). Validates that the UUID matches before updating.
+     * Synchronizes the device instance with updated HTTP device info, including channels,
+     * core properties, and extended metadata. Validates UUID match to prevent updating
+     * the wrong device. Properties are copied directly to the device instance; the
+     * HttpDeviceInfo object is not stored.
      *
-     * @param {HttpDeviceInfo} deviceInfo - HttpDeviceInfo object from HTTP API
+     * @param {HttpDeviceInfo} deviceInfo - HttpDeviceInfo object created via HttpDeviceInfo.fromDict()
      * @returns {Promise<MerossDevice>} Promise that resolves with this device instance
-     * @throws {Error} If device UUID doesn't match
+     * @throws {Error} If device info is missing or UUID doesn't match
      * @example
      * const updatedInfo = HttpDeviceInfo.fromDict(deviceDataFromApi);
      * await device.updateFromHttpState(updatedInfo);
@@ -1266,13 +1218,9 @@ class MerossDevice extends EventEmitter {
             throw new Error(`Cannot update device (${this.uuid}) with HttpDeviceInfo for device id ${deviceInfo.uuid}`);
         }
 
-        // Update cached HTTP info
-        this._cachedHttpInfo = deviceInfo;
+        this.channels = MerossDevice._parseChannels(deviceInfo.channels);
 
-        // Update channels
-        this._channels = MerossDevice._parseChannels(deviceInfo.channels);
-
-        // Update device properties
+        // Subdevices override name and onlineStatus as getter-only properties
         if (!MerossDevice._isGetterOnly(this, 'name')) {
             this.name = deviceInfo.devName || this.uuid || 'unknown';
         }
@@ -1286,6 +1234,16 @@ class MerossDevice extends EventEmitter {
             this.onlineStatus = deviceInfo.onlineStatus !== undefined ? deviceInfo.onlineStatus : OnlineStatus.UNKNOWN;
         }
 
+        // Extended HTTP device info properties (bindTime already normalized to Date by HttpDeviceInfo)
+        this.reservedDomain = deviceInfo.reservedDomain || null;
+        this.subType = deviceInfo.subType || null;
+        this.bindTime = deviceInfo.bindTime || null;
+        this.skillNumber = deviceInfo.skillNumber || null;
+        this.userDevIcon = deviceInfo.userDevIcon || null;
+        this.iconType = deviceInfo.iconType || null;
+        this.region = deviceInfo.region || null;
+        this.devIconId = deviceInfo.devIconId || null;
+
         return this;
     }
 }

package/lib/controller/features/diffuser-feature.js

@@ -37,10 +37,10 @@ module.exports = {
 
         if (response && response.light) {
             this._updateDiffuserLightState(response.light);
-            this._lastFullUpdateTimestamp = Date.now();
+            this.lastFullUpdateTimestamp = Date.now();
         } else if (light) {
             this._updateDiffuserLightState([light]);
-            this._lastFullUpdateTimestamp = Date.now();
+            this.lastFullUpdateTimestamp = Date.now();
         }
 
         return response;
@@ -69,10 +69,10 @@ module.exports = {
 
         if (response && response.spray) {
             this._updateDiffuserSprayState(response.spray, 'response');
-            this._lastFullUpdateTimestamp = Date.now();
+            this.lastFullUpdateTimestamp = Date.now();
         } else {
             this._updateDiffuserSprayState([{ channel, mode: options.mode || 0 }], 'response');
-            this._lastFullUpdateTimestamp = Date.now();
+            this.lastFullUpdateTimestamp = Date.now();
         }
 
         return response;
@@ -91,7 +91,7 @@ module.exports = {
         const response = await this.publishMessage('GET', 'Appliance.Control.Diffuser.Light', {});
         if (response && response.light) {
             this._updateDiffuserLightState(response.light, 'response');
-            this._lastFullUpdateTimestamp = Date.now();
+            this.lastFullUpdateTimestamp = Date.now();
         }
         return response;
     },
@@ -109,7 +109,7 @@ module.exports = {
         const response = await this.publishMessage('GET', 'Appliance.Control.Diffuser.Spray', {});
         if (response && response.spray) {
             this._updateDiffuserSprayState(response.spray, 'response');
-            this._lastFullUpdateTimestamp = Date.now();
+            this.lastFullUpdateTimestamp = Date.now();
         }
         return response;
     },