node-switchbot 3.6.0-beta.1 → 3.6.0-beta.11

package/.github/copilot-instructions.md

@@ -0,0 +1,165 @@
+# Node-SwitchBot Development Instructions
+
+Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
+
+## Working Effectively
+
+### Bootstrap and Setup
+- Install Node.js (^20 || ^22 || ^24): Use the existing version if available
+- Install dependencies: `npm install` -- takes ~5-25 seconds (varies by cache). **NEVER CANCEL**
+- Build the project: `npm run build` -- takes ~5 seconds. **NEVER CANCEL**
+- Run tests: `npm run test` -- takes ~1 second with 12 tests. **NEVER CANCEL**
+
+### Development Workflow
+- **ALWAYS run these commands in order when starting work:**
+  1. `npm install` 
+  2. `npm run build`
+  3. `npm run test`
+  4. `npm run lint`
+- **Build and validate EVERY change**: After any code modification, always run `npm run build && npm run test && npm run lint`
+- **NEVER skip linting**: Run `npm run lint` before committing or the CI (.github/workflows/build.yml) will fail
+- **Use lint:fix for automatic fixes**: `npm run lint:fix` to automatically fix ESLint issues
+
+### Platform Requirements and Constraints
+- **BLE functionality requires Linux-based OS only** (Raspbian, Ubuntu, etc.)
+- **Windows and macOS are NOT supported** for BLE operations (use OpenAPI instead)
+- **Node.js versions**: Must use ^20, ^22, or ^24 (currently using v20.19.4)
+- **ES Modules**: This project uses `"type": "module"` - always use ES import/export syntax
+
+### Testing and Validation
+- **Basic functionality test**: After any changes to core classes, run this validation:
+  ```javascript
+  const { SwitchBotBLE, SwitchBotOpenAPI } = require('./dist/index.js');
+  const ble = new SwitchBotBLE(); // Should not throw
+  const api = new SwitchBotOpenAPI('test', 'test'); // Should not throw
+  ```
+- **Complete test suite**: `npm run test` (12 tests) -- should always pass before committing
+- **Test coverage**: `npm run test-coverage` to see coverage report (~15% coverage is normal)
+- **Documentation generation**: `npm run docs` generates TypeDoc documentation in ./docs/
+
+### Build and Timing Expectations
+- **npm install**: ~5-25 seconds (varies by cache) -- **NEVER CANCEL**. Set timeout to 5+ minutes for safety
+- **npm run build**: ~5 seconds -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety  
+- **npm run test**: ~1 second (12 tests) -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety
+- **npm run lint**: ~3 seconds -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety
+- **npm run docs**: ~2 seconds -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety
+
+## Project Structure and Key Files
+
+### Source Code Organization
+- **src/index.ts**: Main export file - exports SwitchBotBLE, SwitchBotOpenAPI, and device classes
+- **src/switchbot-ble.ts**: Bluetooth Low Energy interface for direct device control
+- **src/switchbot-openapi.ts**: HTTP API interface for cloud-based SwitchBot control
+- **src/device.ts**: Individual device classes (WoHand, WoCurtain, WoSmartLock, etc.)
+- **src/types/**: TypeScript type definitions for all device interfaces
+- **src/settings.ts**: Configuration constants and API URLs
+- **dist/**: Compiled JavaScript output (generated by `npm run build`)
+
+### Configuration Files  
+- **package.json**: Main project config - scripts, dependencies, ES module config
+- **tsconfig.json**: TypeScript compilation settings (target: ES2022, module: ES2022)
+- **eslint.config.js**: ESLint configuration using @antfu/eslint-config
+- **jest.config.js**: Test configuration (uses Vitest, not Jest)
+- **.gitignore**: Excludes dist/, node_modules/, coverage/, and build artifacts
+
+### Documentation
+- **README.md**: Main project documentation and installation instructions
+- **BLE.md**: Comprehensive BLE usage documentation and device examples
+- **OpenAPI.md**: OpenAPI usage documentation and authentication setup
+- **CHANGELOG.md**: Version history and release notes
+- **docs/**: Generated TypeDoc API documentation (HTML format)
+
+## Common Development Tasks
+
+### Adding New Device Support
+- **Add device class**: Create new class in src/device.ts extending SwitchbotDevice
+- **Update exports**: Add export to src/index.ts
+- **Add type definitions**: Create types in src/types/ if needed
+- **Test basic instantiation**: Ensure the device class can be imported and instantiated
+- **Always run full build and test cycle**: `npm run build && npm run test && npm run lint`
+
+### API Changes and Extensions
+- **OpenAPI changes**: Modify src/switchbot-openapi.ts
+- **BLE changes**: Modify src/switchbot-ble.ts
+- **Update type definitions**: Modify corresponding files in src/types/
+- **Always verify exports**: Check that new functionality is exported in src/index.ts
+- **Test import functionality**: Verify new exports can be imported correctly
+
+### Working with Dependencies
+- **Noble (BLE)**: @stoprocent/noble for Bluetooth functionality - Linux only
+- **HTTP requests**: Uses undici for HTTP calls (not axios or fetch)
+- **Async operations**: Uses async-mutex for concurrency control
+- **Adding dependencies**: Use `npm install --save` for runtime deps, `--save-dev` for dev deps
+
+## Validation and Quality Assurance
+
+### Pre-commit Checklist
+1. **Build succeeds**: `npm run build` completes without errors
+2. **All tests pass**: `npm run test` shows all 12 tests passing
+3. **Linting passes**: `npm run lint` shows no errors
+4. **Documentation builds**: `npm run docs` generates without warnings
+5. **Basic import works**: Can import and instantiate main classes
+
+### Manual Testing Scenarios
+- **SwitchBotBLE instantiation**: `new SwitchBotBLE()` should not throw errors
+- **SwitchBotOpenAPI instantiation**: `new SwitchBotOpenAPI('token', 'secret')` should not throw
+- **Module exports**: All exported classes should be importable from main package
+- **TypeScript compilation**: No TypeScript errors in dist/ output
+- **Documentation completeness**: Check that new public APIs appear in generated docs
+
+### CI/CD Integration
+- **GitHub Actions**: Build runs on push to 'latest' branch and PRs
+- **External workflows**: Uses OpenWonderLabs/.github/.github/workflows/nodejs-build-and-test.yml
+- **Required checks**: Build, test, and lint must all pass
+- **Coverage reporting**: Test coverage is tracked and reported
+
+## Troubleshooting Common Issues
+
+### BLE Not Working
+- **Check OS**: BLE only works on Linux-based systems
+- **Install noble prerequisites**: May need additional system libraries for @stoprocent/noble
+- **Use OpenAPI instead**: For Windows/macOS development, use SwitchBotOpenAPI class
+
+### Build Failures
+- **Check Node.js version**: Must be ^20, ^22, or ^24
+- **Clean and rebuild**: `npm run clean && npm install && npm run build`
+- **TypeScript errors**: Check tsconfig.json settings and type definitions
+
+### Test Failures
+- **Run individual tests**: Use `npm run test:watch` for interactive testing
+- **Check imports**: Ensure all imports use correct ES module syntax
+- **Verify exports**: Check that src/index.ts exports all necessary components
+
+### Linting Errors
+- **Auto-fix**: Use `npm run lint:fix` to automatically fix many issues
+- **ESLint config**: Review eslint.config.js for current rules
+- **Import sorting**: ESLint enforces specific import order - use lint:fix
+
+## Frequently Referenced Information
+
+### Package Scripts (from package.json)
+```bash
+npm run build       # Clean and compile TypeScript
+npm run test        # Run test suite with Vitest
+npm run lint        # Run ESLint on src/**/*.ts
+npm run lint:fix    # Auto-fix ESLint issues
+npm run docs        # Generate TypeDoc documentation
+npm run clean       # Remove dist/ directory
+npm run watch       # Build and link for development
+```
+
+### Main Exports (from src/index.ts)
+- **SwitchBotBLE**: Bluetooth interface class
+- **SwitchBotOpenAPI**: HTTP API interface class  
+- **SwitchbotDevice**: Base device class
+- **Device classes**: WoHand, WoCurtain, WoSmartLock, etc.
+- **Type definitions**: All device status and response types
+
+### Dependencies Summary
+- **@stoprocent/noble**: BLE functionality (Linux only)
+- **undici**: HTTP client for API requests
+- **async-mutex**: Concurrency control
+- **TypeScript**: Language and compilation
+- **Vitest**: Testing framework
+- **ESLint**: Code linting with @antfu/eslint-config
+- **TypeDoc**: API documentation generation

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project will be documented in this file. This project uses [Semantic Versioning](https://semver.org/)
 
+## [3.6.0](https://github.com/OpenWonderLabs/node-switchbot/releases/tag/v3.6.0) (2025-08-27)
+
+### What's Changed
+- Housekeeping and update dependencies
+- **BREAKING**: Fixed compatibility with `@stoprocent/noble` v2.3.4 and `@stoprocent/bluetooth-hci-socket` v2.2.3
+- **Enhancement**: Added comprehensive input validation utilities (`ValidationUtils` class)
+- **Enhancement**: Improved error handling with more descriptive error messages
+- **Enhancement**: Added command constants to replace magic numbers for better maintainability
+- **Enhancement**: Enhanced type safety with proper TypeScript assertions
+- **Enhancement**: Improved buffer validation with configurable minimum length
+- **Enhancement**: Better resource cleanup in error scenarios with try-catch-finally blocks
+- **Enhancement**: Removed deprecated parameter checker in favor of modern validation
+- **Fix**: Updated `noble._state` to `noble.state` for compatibility with newer noble versions
+- **Fix**: Enhanced NobleTypes interface to properly support newer noble version
+- **Code Quality**: Improved JSDoc documentation throughout device classes
+- **Code Quality**: Standardized validation across all device classes
+- **Docs**: Updated BLE.md and OpenAPI.md for new validation and error handling features
+- **Internal**: Refactored device instantiation logic for consistency
+- **Internal**: Improved test coverage for validation utilities and error scenarios
+- **Chore**: Synced package scripts and documentation with latest development workflow
+
+**Full Changelog**: https://github.com/OpenWonderLabs/node-switchbot/compare/v3.5.1...v3.6.0
+
 ## [3.5.1](https://github.com/OpenWonderLabs/node-switchbot/releases/tag/v3.5.1) (2025-07-25)
 
 ### What's Changed

package/dist/device.d.ts

@@ -1,6 +1,5 @@
-import type Noble from '@stoprocent/noble';
-import type { Characteristic, Peripheral } from '@stoprocent/noble';
-import type { batteryCirculatorFanServiceData, blindTiltServiceData, botServiceData, ceilingLightProServiceData, ceilingLightServiceData, colorBulbServiceData, contactSensorServiceData, curtain3ServiceData, curtainServiceData, hub2ServiceData, humidifier2ServiceData, humidifierServiceData, keypadDetectorServiceData, lockProServiceData, lockServiceData, meterPlusServiceData, meterProCO2ServiceData, meterProServiceData, meterServiceData, motionSensorServiceData, outdoorMeterServiceData, plugMiniJPServiceData, plugMiniUSServiceData, relaySwitch1PMServiceData, relaySwitch1ServiceData, remoteServiceData, robotVacuumCleanerServiceData, stripLightServiceData, waterLeakDetectorServiceData } from './types/bledevicestatus.js';
+import type { Characteristic, Noble, Peripheral } from '@stoprocent/noble';
+import type { airPurifierServiceData, airPurifierTableServiceData, batteryCirculatorFanServiceData, blindTiltServiceData, botServiceData, ceilingLightProServiceData, ceilingLightServiceData, colorBulbServiceData, contactSensorServiceData, curtain3ServiceData, curtainServiceData, hub2ServiceData, hub3ServiceData, humidifier2ServiceData, humidifierServiceData, keypadDetectorServiceData, lockProServiceData, lockServiceData, meterPlusServiceData, meterProCO2ServiceData, meterProServiceData, meterServiceData, motionSensorServiceData, outdoorMeterServiceData, plugMiniJPServiceData, plugMiniUSServiceData, relaySwitch1PMServiceData, relaySwitch1ServiceData, remoteServiceData, robotVacuumCleanerServiceData, stripLightServiceData, waterLeakDetectorServiceData } from './types/ble.js';
 import { Buffer } from 'node:buffer';
 import { EventEmitter } from 'node:events';
 export type MacAddress = string;
@@ -8,7 +7,7 @@ export interface ad {
     id: string;
     address: string;
     rssi: number;
-    serviceData: botServiceData | colorBulbServiceData | contactSensorServiceData | curtainServiceData | curtain3ServiceData | stripLightServiceData | lockServiceData | lockProServiceData | meterServiceData | meterPlusServiceData | meterProServiceData | meterProCO2ServiceData | motionSensorServiceData | outdoorMeterServiceData | plugMiniUSServiceData | plugMiniJPServiceData | blindTiltServiceData | ceilingLightServiceData | ceilingLightProServiceData | hub2ServiceData | batteryCirculatorFanServiceData | waterLeakDetectorServiceData | humidifierServiceData | humidifier2ServiceData | robotVacuumCleanerServiceData | keypadDetectorServiceData | relaySwitch1PMServiceData | relaySwitch1ServiceData | remoteServiceData;
+    serviceData: airPurifierServiceData | airPurifierTableServiceData | botServiceData | colorBulbServiceData | contactSensorServiceData | curtainServiceData | curtain3ServiceData | stripLightServiceData | lockServiceData | lockProServiceData | meterServiceData | meterPlusServiceData | meterProServiceData | meterProCO2ServiceData | motionSensorServiceData | outdoorMeterServiceData | plugMiniUSServiceData | plugMiniJPServiceData | blindTiltServiceData | ceilingLightServiceData | ceilingLightProServiceData | hub2ServiceData | hub3ServiceData | batteryCirculatorFanServiceData | waterLeakDetectorServiceData | humidifierServiceData | humidifier2ServiceData | robotVacuumCleanerServiceData | keypadDetectorServiceData | relaySwitch1PMServiceData | relaySwitch1ServiceData | remoteServiceData;
     [key: string]: unknown;
 }
 export type ondiscover = (device: SwitchbotDevice) => Promise<void> | void;
@@ -29,6 +28,7 @@ export declare interface SwitchBotBLEDevice {
     MeterPro: DeviceInfo;
     MeterProCO2: DeviceInfo;
     Hub2: DeviceInfo;
+    Hub3: DeviceInfo;
     OutdoorMeter: DeviceInfo;
     MotionSensor: DeviceInfo;
     ContactSensor: DeviceInfo;
@@ -42,11 +42,14 @@ export declare interface SwitchBotBLEDevice {
     CeilingLightPro: DeviceInfo;
     BlindTilt: DeviceInfo;
     Unknown: DeviceInfo;
+    AirPurifier: DeviceInfo;
+    AirPurifierTable: DeviceInfo;
 }
 export declare enum SwitchBotModel {
     HubMini = "W0202200",
     HubPlus = "SwitchBot Hub S1",
     Hub2 = "W3202100",
+    Hub3 = "W3302100",
     Bot = "SwitchBot S1",
     Curtain = "W0701600",
     Curtain3 = "W2400000",
@@ -89,7 +92,9 @@ export declare enum SwitchBotModel {
     WaterDetector = "W4402000",
     RelaySwitch1 = "W5502300",
     RelaySwitch1PM = "W5502310",
-    Unknown = "Unknown"
+    Unknown = "Unknown",
+    AirPurifier = "W5302300",
+    AirPurifierTable = "W5302310"
 }
 export declare enum SwitchBotBLEModel {
     Bot = "H",
@@ -102,6 +107,7 @@ export declare enum SwitchBotBLEModel {
     MeterPro = "4",
     MeterProCO2 = "5",
     Hub2 = "v",
+    Hub3 = "V",
     OutdoorMeter = "w",
     MotionSensor = "s",
     ContactSensor = "d",
@@ -119,11 +125,14 @@ export declare enum SwitchBotBLEModel {
     RelaySwitch1 = ";",
     RelaySwitch1PM = "<",
     Remote = "b",
-    Unknown = "Unknown"
+    Unknown = "Unknown",
+    AirPurifier = "+",
+    AirPurifierTable = "7"
 }
 export declare enum SwitchBotBLEModelName {
     Bot = "WoHand",
     Hub2 = "WoHub2",
+    Hub3 = "WoHub3",
     ColorBulb = "WoBulb",
     Curtain = "WoCurtain",
     Curtain3 = "WoCurtain3",
@@ -148,11 +157,14 @@ export declare enum SwitchBotBLEModelName {
     RelaySwitch1 = "WoRelaySwitch1Plus",
     RelaySwitch1PM = "WoRelaySwitch1PM",
     Remote = "WoRemote",
+    AirPurifier = "WoAirPurifier",
+    AirPurifierTable = "WoAirPurifierTable",
     Unknown = "Unknown"
 }
 export declare enum SwitchBotBLEModelFriendlyName {
     Bot = "Bot",
     Hub2 = "Hub 2",
+    Hub3 = "Hub 3",
     ColorBulb = "Color Bulb",
     Curtain = "Curtain",
     Curtain3 = "Curtain 3",
@@ -179,14 +191,20 @@ export declare enum SwitchBotBLEModelFriendlyName {
     RelaySwitch1 = "Relay Switch 1",
     RelaySwitch1PM = "Relay Switch 1PM",
     Remote = "Remote",
-    Unknown = "Unknown"
+    AirPurifier = "Air Purifier",
+    AirPurifierTable = "Air Purifier Table",
+    Unknown = "Unknown",
+    AirPurifierVOC = "Air Purifier VOC",
+    AirPurifierTableVOC = "Air Purifier Table VOC",
+    AirPurifierPM2_5 = "Air Purifier PM2.5",
+    AirPurifierTablePM2_5 = "Air Purifier Table PM2.5"
 }
 export interface Params {
     duration?: number;
     model?: string;
     id?: string;
     quick?: boolean;
-    noble?: typeof Noble;
+    noble?: Noble;
 }
 export interface ErrorObject {
     code: string;
@@ -198,8 +216,7 @@ export interface Chars {
     device: Characteristic | null;
 }
 export interface NobleTypes {
-    noble: typeof Noble;
-    state: 'unknown' | 'resetting' | 'unsupported' | 'unauthorized' | 'poweredOff' | 'poweredOn';
+    noble: Noble;
     peripheral: Peripheral;
 }
 export interface ServiceData {
@@ -233,6 +250,108 @@ export declare enum LogLevel {
     DEBUG = "debug",
     INFO = "info"
 }
+/**
+ * Utility class for comprehensive input validation with improved error messages.
+ */
+export declare class ValidationUtils {
+    /**
+     * Validates percentage value (0-100).
+     * @param value - The value to validate
+     * @param paramName - The parameter name for error reporting
+     * @throws {RangeError} When value is not within valid range
+     * @throws {TypeError} When value is not a number
+     */
+    static validatePercentage(value: number, paramName?: string): void;
+    /**
+     * Validates RGB color value (0-255).
+     * @param value - The color value to validate
+     * @param colorName - The color name for error reporting
+     * @throws {RangeError} When value is not within valid range
+     * @throws {TypeError} When value is not a number
+     */
+    static validateRGB(value: number, colorName?: string): void;
+    /**
+     * Validates buffer and throws descriptive error.
+     * @param buffer - The buffer to validate
+     * @param expectedLength - Optional expected length
+     * @param paramName - The parameter name for error reporting
+     * @throws {TypeError} When buffer is not a Buffer
+     * @throws {RangeError} When buffer length doesn't match expected
+     */
+    static validateBuffer(buffer: any, expectedLength?: number, paramName?: string): asserts buffer is Buffer;
+    /**
+     * Validates string input with comprehensive checks.
+     * @param value - The value to validate
+     * @param paramName - The parameter name for error reporting
+     * @param minLength - Minimum required length
+     * @param maxLength - Optional maximum length
+     * @throws {TypeError} When value is not a string
+     * @throws {RangeError} When string length is invalid
+     */
+    static validateString(value: any, paramName?: string, minLength?: number, maxLength?: number): asserts value is string;
+    /**
+     * Validates numeric range with enhanced checks.
+     * @param value - The value to validate
+     * @param min - Minimum allowed value
+     * @param max - Maximum allowed value
+     * @param paramName - The parameter name for error reporting
+     * @param mustBeInteger - Whether the value must be an integer
+     * @throws {TypeError} When value is not a number
+     * @throws {RangeError} When value is outside valid range
+     */
+    static validateRange(value: number, min: number, max: number, paramName?: string, mustBeInteger?: boolean): void;
+    /**
+     * Validates MAC address format.
+     * @param address - The MAC address to validate
+     * @param paramName - The parameter name for error reporting
+     * @throws {TypeError} When address is not a string
+     * @throws {Error} When address format is invalid
+     */
+    static validateMacAddress(address: any, paramName?: string): asserts address is string;
+    /**
+     * Validates that a value is one of the allowed enum values.
+     * @param value - The value to validate
+     * @param allowedValues - Array of allowed values
+     * @param paramName - The parameter name for error reporting
+     * @throws {Error} When value is not in allowed values
+     */
+    static validateEnum<T>(value: any, allowedValues: readonly T[], paramName?: string): asserts value is T;
+}
+/**
+ * Enhanced error handling utilities.
+ */
+export declare class ErrorUtils {
+    /**
+     * Creates a timeout error with context.
+     * @param operation - The operation that timed out
+     * @param timeoutMs - The timeout duration in milliseconds
+     * @returns A descriptive timeout error
+     */
+    static createTimeoutError(operation: string, timeoutMs: number): Error;
+    /**
+     * Creates a connection error with context.
+     * @param deviceId - The device ID that failed to connect
+     * @param cause - The underlying cause of the connection failure
+     * @returns A descriptive connection error
+     */
+    static createConnectionError(deviceId: string, cause?: Error): Error;
+    /**
+     * Creates a command error with context.
+     * @param command - The command that failed
+     * @param deviceId - The device ID
+     * @param cause - The underlying cause
+     * @returns A descriptive command error
+     */
+    static createCommandError(command: string, deviceId: string, cause?: Error): Error;
+    /**
+     * Wraps an async operation with timeout and enhanced error handling.
+     * @param operation - The async operation to wrap
+     * @param timeoutMs - Timeout in milliseconds
+     * @param operationName - Name of the operation for error messages
+     * @returns Promise that resolves with the operation result or rejects with timeout
+     */
+    static withTimeout<T>(operation: Promise<T>, timeoutMs: number, operationName: string): Promise<T>;
+}
 /**
  * Represents a Switchbot Device.
  */
@@ -255,7 +374,7 @@ export declare class SwitchbotDevice extends EventEmitter {
      * @param peripheral The peripheral object from noble.
      * @param noble The Noble object.
      */
-    constructor(peripheral: NobleTypes['peripheral'], noble: typeof Noble);
+    constructor(peripheral: NobleTypes['peripheral'], noble: Noble);
     /**
      * Logs a message with the specified log level.
      * @param level The severity level of the log (e.g., 'info', 'warn', 'error').
@@ -341,13 +460,13 @@ export declare class SwitchbotDevice extends EventEmitter {
      */
     private waitForCommandResponse;
     /**
-     * Reads data from a characteristic with a timeout.
+     * Reads data from a characteristic with enhanced timeout and error handling.
      * @param char The characteristic to read from.
      * @returns A Promise that resolves with the data buffer.
      */
     private readCharacteristic;
     /**
-     * Writes data to a characteristic with a timeout.
+     * Writes data to a characteristic with enhanced timeout and error handling.
      * @param char The characteristic to write to.
      * @param buf The data buffer.
      * @returns A Promise that resolves when the write is complete.
@@ -374,6 +493,7 @@ export declare class Advertising {
      * Validates if the buffer is a valid Buffer object with a minimum length.
      *
      * @param {any} buffer - The buffer to validate.
+     * @param {number} minLength - The minimum required length.
      * @returns {boolean} - True if the buffer is valid, false otherwise.
      */
     private static validateBuffer;
@@ -722,6 +842,20 @@ export declare class WoHub2 extends SwitchbotDevice {
     static parseServiceData(manufacturerData: Buffer, emitLog: (level: string, message: string) => void): Promise<hub2ServiceData | null>;
     constructor(peripheral: NobleTypes['peripheral'], noble: NobleTypes['noble']);
 }
+/**
+ * Class representing a WoHub3 device.
+ * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/meter.md
+ */
+export declare class WoHub3 extends SwitchbotDevice {
+    /**
+     * Parses the service data for WoHub3.
+     * @param {Buffer} manufacturerData - The manufacturer data buffer.
+     * @param {Function} emitLog - The function to emit log messages.
+     * @returns {Promise<hub3ServiceData | null>} - Parsed service data or null if invalid.
+     */
+    static parseServiceData(manufacturerData: Buffer, emitLog: (level: string, message: string) => void): Promise<hub3ServiceData | null>;
+    constructor(peripheral: NobleTypes['peripheral'], noble: NobleTypes['noble']);
+}
 /**
  * Class representing a WoHumi device.
  * @see https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/tree/latest/devicetypes
@@ -1314,5 +1448,105 @@ export declare class WoStrip extends SwitchbotDevice {
      */
     operateStripLight(bytes: number[]): Promise<boolean>;
 }
+/**
+ * Class representing a SwitchBot Air Purifier device.
+ * @extends SwitchbotDevice
+ */
+export declare class WoAirPurifier extends SwitchbotDevice {
+    /**
+     * Parses service data for air purifier devices.
+     * @param {Buffer | null} serviceData - The service data buffer.
+     * @param {Buffer | null} manufacturerData - The manufacturer data buffer.
+     * @param {Function} emitLog - The function to emit log messages.
+     * @returns {airPurifierServiceData | null} - The parsed service data or null.
+     */
+    static parseServiceData(serviceData: Buffer | null, manufacturerData: Buffer | null, emitLog?: (level: string, message: string) => void): airPurifierServiceData | null;
+    /**
+     * Sets the state of the air purifier.
+     * @param {number[]} reqByteArray - The request byte array.
+     * @returns {Promise<boolean>} - Resolves with a boolean indicating whether the operation was successful.
+     * @private
+     */
+    setState(reqByteArray: number[]): Promise<boolean>;
+    /**
+     * Turns the air purifier on.
+     * @returns {Promise<boolean>} - Resolves with true if the air purifier is turned on.
+     */
+    turnOn(): Promise<boolean>;
+    /**
+     * Turns the air purifier off.
+     * @returns {Promise<boolean>} - Resolves with true if the air purifier is turned off.
+     */
+    turnOff(): Promise<boolean>;
+    /**
+     * Sets the speed of the air purifier.
+     * @param {number} speed - The speed value (0-100).
+     * @returns {Promise<boolean>} - Resolves with true if the operation was successful.
+     */
+    setSpeed(speed: number): Promise<boolean>;
+    /**
+     * Sets the mode of the air purifier.
+     * @param {number} mode - The mode value (1-4).
+     * @returns {Promise<boolean>} - Resolves with true if the operation was successful.
+     */
+    setMode(mode: number): Promise<boolean>;
+    /**
+     * Operates the air purifier with the given byte array.
+     * @public
+     * @param {number[]} bytes - The byte array to send.
+     * @returns {Promise<boolean>} - Resolves with true if the operation was successful.
+     */
+    operateAirPurifier(bytes: number[]): Promise<boolean>;
+}
+/**
+ * Class representing a SwitchBot Air Purifier Table device.
+ * @extends SwitchbotDevice
+ */
+export declare class WoAirPurifierTable extends SwitchbotDevice {
+    /**
+     * Parses service data for air purifier table devices.
+     * @param {Buffer | null} serviceData - The service data buffer.
+     * @param {Buffer | null} manufacturerData - The manufacturer data buffer.
+     * @param {Function} emitLog - The function to emit log messages.
+     * @returns {airPurifierTableServiceData | null} - The parsed service data or null.
+     */
+    static parseServiceData(serviceData: Buffer | null, manufacturerData: Buffer | null, emitLog?: (level: string, message: string) => void): airPurifierTableServiceData | null;
+    /**
+     * Sets the state of the air purifier table.
+     * @param {number[]} reqByteArray - The request byte array.
+     * @returns {Promise<boolean>} - Resolves with a boolean indicating whether the operation was successful.
+     * @private
+     */
+    setState(reqByteArray: number[]): Promise<boolean>;
+    /**
+     * Turns the air purifier table on.
+     * @returns {Promise<boolean>} - Resolves with true if the air purifier table is turned on.
+     */
+    turnOn(): Promise<boolean>;
+    /**
+     * Turns the air purifier table off.
+     * @returns {Promise<boolean>} - Resolves with true if the air purifier table is turned off.
+     */
+    turnOff(): Promise<boolean>;
+    /**
+     * Sets the speed of the air purifier table.
+     * @param {number} speed - The speed value (0-100).
+     * @returns {Promise<boolean>} - Resolves with true if the operation was successful.
+     */
+    setSpeed(speed: number): Promise<boolean>;
+    /**
+     * Sets the mode of the air purifier table.
+     * @param {number} mode - The mode value (1-4).
+     * @returns {Promise<boolean>} - Resolves with true if the operation was successful.
+     */
+    setMode(mode: number): Promise<boolean>;
+    /**
+     * Operates the air purifier table with the given byte array.
+     * @public
+     * @param {number[]} bytes - The byte array to send.
+     * @returns {Promise<boolean>} - Resolves with true if the operation was successful.
+     */
+    operateAirPurifierTable(bytes: number[]): Promise<boolean>;
+}
 export {};
 //# sourceMappingURL=device.d.ts.map