node-switchbot 4.0.0-beta.9 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/BLE.md +215 -838
- package/CHANGELOG.md +96 -1371
- package/OpenAPI.md +169 -135
- package/README.md +1 -1
- package/dist/ble.d.ts +14 -1
- package/dist/ble.d.ts.map +1 -1
- package/dist/ble.js +241 -39
- package/dist/ble.js.map +1 -1
- package/dist/devices/base.d.ts +97 -1
- package/dist/devices/base.d.ts.map +1 -1
- package/dist/devices/base.js +204 -2
- package/dist/devices/base.js.map +1 -1
- package/dist/devices/device-override-state-during-connection.d.ts +27 -0
- package/dist/devices/device-override-state-during-connection.d.ts.map +1 -0
- package/dist/devices/device-override-state-during-connection.js +45 -0
- package/dist/devices/device-override-state-during-connection.js.map +1 -0
- package/dist/devices/index.d.ts +36 -0
- package/dist/devices/index.d.ts.map +1 -1
- package/dist/devices/index.js +36 -0
- package/dist/devices/index.js.map +1 -1
- package/dist/devices/sequence-device.d.ts +52 -0
- package/dist/devices/sequence-device.d.ts.map +1 -0
- package/dist/devices/sequence-device.js +91 -0
- package/dist/devices/sequence-device.js.map +1 -0
- package/dist/devices/wo-ai-hub.d.ts +9 -0
- package/dist/devices/wo-ai-hub.d.ts.map +1 -0
- package/dist/devices/wo-ai-hub.js +25 -0
- package/dist/devices/wo-ai-hub.js.map +1 -0
- package/dist/devices/wo-air-purifier-pm25.d.ts +29 -0
- package/dist/devices/wo-air-purifier-pm25.d.ts.map +1 -0
- package/dist/devices/wo-air-purifier-pm25.js +144 -0
- package/dist/devices/wo-air-purifier-pm25.js.map +1 -0
- package/dist/devices/wo-air-purifier.d.ts +21 -4
- package/dist/devices/wo-air-purifier.d.ts.map +1 -1
- package/dist/devices/wo-air-purifier.js +111 -61
- package/dist/devices/wo-air-purifier.js.map +1 -1
- package/dist/devices/wo-art-frame.d.ts +8 -0
- package/dist/devices/wo-art-frame.d.ts.map +1 -0
- package/dist/devices/wo-art-frame.js +12 -0
- package/dist/devices/wo-art-frame.js.map +1 -0
- package/dist/devices/wo-blind-tilt.d.ts +2 -16
- package/dist/devices/wo-blind-tilt.d.ts.map +1 -1
- package/dist/devices/wo-blind-tilt.js +135 -62
- package/dist/devices/wo-blind-tilt.js.map +1 -1
- package/dist/devices/wo-bulb.d.ts +37 -1
- package/dist/devices/wo-bulb.d.ts.map +1 -1
- package/dist/devices/wo-bulb.js +196 -51
- package/dist/devices/wo-bulb.js.map +1 -1
- package/dist/devices/wo-candle-warmer-lamp.d.ts +25 -0
- package/dist/devices/wo-candle-warmer-lamp.d.ts.map +1 -0
- package/dist/devices/wo-candle-warmer-lamp.js +81 -0
- package/dist/devices/wo-candle-warmer-lamp.js.map +1 -0
- package/dist/devices/wo-circulator-fan.d.ts +8 -0
- package/dist/devices/wo-circulator-fan.d.ts.map +1 -0
- package/dist/devices/wo-circulator-fan.js +12 -0
- package/dist/devices/wo-circulator-fan.js.map +1 -0
- package/dist/devices/wo-climate-panel.d.ts +8 -0
- package/dist/devices/wo-climate-panel.d.ts.map +1 -0
- package/dist/devices/wo-climate-panel.js +12 -0
- package/dist/devices/wo-climate-panel.js.map +1 -0
- package/dist/devices/wo-contact.d.ts +1 -1
- package/dist/devices/wo-contact.d.ts.map +1 -1
- package/dist/devices/wo-contact.js +19 -35
- package/dist/devices/wo-contact.js.map +1 -1
- package/dist/devices/wo-curtain.d.ts +17 -1
- package/dist/devices/wo-curtain.d.ts.map +1 -1
- package/dist/devices/wo-curtain.js +119 -27
- package/dist/devices/wo-curtain.js.map +1 -1
- package/dist/devices/wo-floor-lamp.d.ts +8 -0
- package/dist/devices/wo-floor-lamp.d.ts.map +1 -0
- package/dist/devices/wo-floor-lamp.js +12 -0
- package/dist/devices/wo-floor-lamp.js.map +1 -0
- package/dist/devices/wo-garage-door-opener.d.ts +8 -0
- package/dist/devices/wo-garage-door-opener.d.ts.map +1 -0
- package/dist/devices/wo-garage-door-opener.js +12 -0
- package/dist/devices/wo-garage-door-opener.js.map +1 -0
- package/dist/devices/wo-hand.d.ts +22 -6
- package/dist/devices/wo-hand.d.ts.map +1 -1
- package/dist/devices/wo-hand.js +55 -39
- package/dist/devices/wo-hand.js.map +1 -1
- package/dist/devices/wo-hub2.d.ts +1 -1
- package/dist/devices/wo-hub2.d.ts.map +1 -1
- package/dist/devices/wo-hub2.js +17 -33
- package/dist/devices/wo-hub2.js.map +1 -1
- package/dist/devices/wo-hubmini-matter.d.ts +8 -0
- package/dist/devices/wo-hubmini-matter.d.ts.map +1 -0
- package/dist/devices/wo-hubmini-matter.js +12 -0
- package/dist/devices/wo-hubmini-matter.js.map +1 -0
- package/dist/devices/wo-humi.d.ts +18 -2
- package/dist/devices/wo-humi.d.ts.map +1 -1
- package/dist/devices/wo-humi.js +60 -36
- package/dist/devices/wo-humi.js.map +1 -1
- package/dist/devices/wo-humi2.d.ts.map +1 -1
- package/dist/devices/wo-humi2.js.map +1 -1
- package/dist/devices/wo-keypad-vision-pro.d.ts +18 -0
- package/dist/devices/wo-keypad-vision-pro.d.ts.map +1 -0
- package/dist/devices/wo-keypad-vision-pro.js +15 -0
- package/dist/devices/wo-keypad-vision-pro.js.map +1 -0
- package/dist/devices/wo-keypad-vision.d.ts +8 -0
- package/dist/devices/wo-keypad-vision.d.ts.map +1 -0
- package/dist/devices/wo-keypad-vision.js +12 -0
- package/dist/devices/wo-keypad-vision.js.map +1 -0
- package/dist/devices/wo-keypad.d.ts +1 -1
- package/dist/devices/wo-keypad.d.ts.map +1 -1
- package/dist/devices/wo-keypad.js +14 -30
- package/dist/devices/wo-keypad.js.map +1 -1
- package/dist/devices/wo-leak.d.ts +1 -1
- package/dist/devices/wo-leak.d.ts.map +1 -1
- package/dist/devices/wo-leak.js +15 -31
- package/dist/devices/wo-leak.js.map +1 -1
- package/dist/devices/wo-lock-lite.d.ts +7 -0
- package/dist/devices/wo-lock-lite.d.ts.map +1 -0
- package/dist/devices/wo-lock-lite.js +11 -0
- package/dist/devices/wo-lock-lite.js.map +1 -0
- package/dist/devices/wo-lock-pro-wifi.d.ts +7 -0
- package/dist/devices/wo-lock-pro-wifi.d.ts.map +1 -0
- package/dist/devices/wo-lock-pro-wifi.js +11 -0
- package/dist/devices/wo-lock-pro-wifi.js.map +1 -0
- package/dist/devices/wo-lock-pro.d.ts +12 -3
- package/dist/devices/wo-lock-pro.d.ts.map +1 -1
- package/dist/devices/wo-lock-pro.js +83 -37
- package/dist/devices/wo-lock-pro.js.map +1 -1
- package/dist/devices/wo-lock-vision-pro.d.ts +7 -0
- package/dist/devices/wo-lock-vision-pro.d.ts.map +1 -0
- package/dist/devices/wo-lock-vision-pro.js +11 -0
- package/dist/devices/wo-lock-vision-pro.js.map +1 -0
- package/dist/devices/wo-lock-vision.d.ts +7 -0
- package/dist/devices/wo-lock-vision.d.ts.map +1 -0
- package/dist/devices/wo-lock-vision.js +11 -0
- package/dist/devices/wo-lock-vision.js.map +1 -0
- package/dist/devices/wo-lock.d.ts +8 -3
- package/dist/devices/wo-lock.d.ts.map +1 -1
- package/dist/devices/wo-lock.js +75 -36
- package/dist/devices/wo-lock.js.map +1 -1
- package/dist/devices/wo-pan-tilt-cam-plus-3k.d.ts +21 -0
- package/dist/devices/wo-pan-tilt-cam-plus-3k.d.ts.map +1 -0
- package/dist/devices/wo-pan-tilt-cam-plus-3k.js +87 -0
- package/dist/devices/wo-pan-tilt-cam-plus-3k.js.map +1 -0
- package/dist/devices/wo-plug-mini-us.d.ts +3 -3
- package/dist/devices/wo-plug-mini-us.d.ts.map +1 -1
- package/dist/devices/wo-plug-mini-us.js +25 -35
- package/dist/devices/wo-plug-mini-us.js.map +1 -1
- package/dist/devices/wo-presence.d.ts +1 -1
- package/dist/devices/wo-presence.d.ts.map +1 -1
- package/dist/devices/wo-presence.js +17 -33
- package/dist/devices/wo-presence.js.map +1 -1
- package/dist/devices/wo-relay-switch-1.d.ts +19 -3
- package/dist/devices/wo-relay-switch-1.d.ts.map +1 -1
- package/dist/devices/wo-relay-switch-1.js +90 -42
- package/dist/devices/wo-relay-switch-1.js.map +1 -1
- package/dist/devices/wo-relay-switch-2pm.d.ts +21 -0
- package/dist/devices/wo-relay-switch-2pm.d.ts.map +1 -0
- package/dist/devices/wo-relay-switch-2pm.js +37 -0
- package/dist/devices/wo-relay-switch-2pm.js.map +1 -0
- package/dist/devices/wo-remote-with-screen.d.ts +9 -0
- package/dist/devices/wo-remote-with-screen.d.ts.map +1 -0
- package/dist/devices/wo-remote-with-screen.js +22 -0
- package/dist/devices/wo-remote-with-screen.js.map +1 -0
- package/dist/devices/wo-remote.d.ts +1 -1
- package/dist/devices/wo-remote.d.ts.map +1 -1
- package/dist/devices/wo-remote.js +13 -29
- package/dist/devices/wo-remote.js.map +1 -1
- package/dist/devices/wo-rgbic-bulb.d.ts +29 -0
- package/dist/devices/wo-rgbic-bulb.d.ts.map +1 -0
- package/dist/devices/wo-rgbic-bulb.js +84 -0
- package/dist/devices/wo-rgbic-bulb.js.map +1 -0
- package/dist/devices/wo-rgbic-neon-wire-rope-light.d.ts +29 -0
- package/dist/devices/wo-rgbic-neon-wire-rope-light.d.ts.map +1 -0
- package/dist/devices/wo-rgbic-neon-wire-rope-light.js +113 -0
- package/dist/devices/wo-rgbic-neon-wire-rope-light.js.map +1 -0
- package/dist/devices/wo-rgbicww-floor-lamp.d.ts +8 -0
- package/dist/devices/wo-rgbicww-floor-lamp.d.ts.map +1 -0
- package/dist/devices/wo-rgbicww-floor-lamp.js +12 -0
- package/dist/devices/wo-rgbicww-floor-lamp.js.map +1 -0
- package/dist/devices/wo-rgbicww-strip-light.d.ts +8 -0
- package/dist/devices/wo-rgbicww-strip-light.d.ts.map +1 -0
- package/dist/devices/wo-rgbicww-strip-light.js +12 -0
- package/dist/devices/wo-rgbicww-strip-light.js.map +1 -0
- package/dist/devices/wo-roller-shade.d.ts +8 -0
- package/dist/devices/wo-roller-shade.d.ts.map +1 -0
- package/dist/devices/wo-roller-shade.js +12 -0
- package/dist/devices/wo-roller-shade.js.map +1 -0
- package/dist/devices/wo-sensor-th.d.ts +1 -1
- package/dist/devices/wo-sensor-th.d.ts.map +1 -1
- package/dist/devices/wo-sensor-th.js +18 -34
- package/dist/devices/wo-sensor-th.js.map +1 -1
- package/dist/devices/wo-smart-thermostat-radiator.d.ts +8 -0
- package/dist/devices/wo-smart-thermostat-radiator.d.ts.map +1 -0
- package/dist/devices/wo-smart-thermostat-radiator.js +12 -0
- package/dist/devices/wo-smart-thermostat-radiator.js.map +1 -0
- package/dist/devices/wo-strip-light-3.d.ts +8 -0
- package/dist/devices/wo-strip-light-3.d.ts.map +1 -0
- package/dist/devices/wo-strip-light-3.js +12 -0
- package/dist/devices/wo-strip-light-3.js.map +1 -0
- package/dist/devices/wo-vacuum-k10-plus.d.ts +7 -0
- package/dist/devices/wo-vacuum-k10-plus.d.ts.map +1 -0
- package/dist/devices/wo-vacuum-k10-plus.js +11 -0
- package/dist/devices/wo-vacuum-k10-plus.js.map +1 -0
- package/dist/devices/wo-vacuum-k10-pro-combo.d.ts +7 -0
- package/dist/devices/wo-vacuum-k10-pro-combo.d.ts.map +1 -0
- package/dist/devices/wo-vacuum-k10-pro-combo.js +11 -0
- package/dist/devices/wo-vacuum-k10-pro-combo.js.map +1 -0
- package/dist/devices/wo-vacuum-k10-pro.d.ts +7 -0
- package/dist/devices/wo-vacuum-k10-pro.d.ts.map +1 -0
- package/dist/devices/wo-vacuum-k10-pro.js +11 -0
- package/dist/devices/wo-vacuum-k10-pro.js.map +1 -0
- package/dist/devices/wo-vacuum-k11-plus.d.ts +7 -0
- package/dist/devices/wo-vacuum-k11-plus.d.ts.map +1 -0
- package/dist/devices/wo-vacuum-k11-plus.js +11 -0
- package/dist/devices/wo-vacuum-k11-plus.js.map +1 -0
- package/dist/devices/wo-vacuum-k20.d.ts +7 -0
- package/dist/devices/wo-vacuum-k20.d.ts.map +1 -0
- package/dist/devices/wo-vacuum-k20.js +11 -0
- package/dist/devices/wo-vacuum-k20.js.map +1 -0
- package/dist/devices/wo-vacuum-s10.d.ts +7 -0
- package/dist/devices/wo-vacuum-s10.d.ts.map +1 -0
- package/dist/devices/wo-vacuum-s10.js +11 -0
- package/dist/devices/wo-vacuum-s10.js.map +1 -0
- package/dist/devices/wo-vacuum-s20.d.ts +7 -0
- package/dist/devices/wo-vacuum-s20.d.ts.map +1 -0
- package/dist/devices/wo-vacuum-s20.js +11 -0
- package/dist/devices/wo-vacuum-s20.js.map +1 -0
- package/dist/devices/wo-vacuum.d.ts +44 -0
- package/dist/devices/wo-vacuum.d.ts.map +1 -0
- package/dist/devices/wo-vacuum.js +143 -0
- package/dist/devices/wo-vacuum.js.map +1 -0
- package/dist/devices/wo-water-detector.d.ts +9 -0
- package/dist/devices/wo-water-detector.d.ts.map +1 -0
- package/dist/devices/wo-water-detector.js +20 -0
- package/dist/devices/wo-water-detector.js.map +1 -0
- package/dist/errors.d.ts +20 -0
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +31 -1
- package/dist/errors.js.map +1 -1
- package/dist/index.d.ts +4 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/settings.d.ts +25 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +85 -6
- package/dist/settings.js.map +1 -1
- package/dist/switchbot.d.ts +1 -0
- package/dist/switchbot.d.ts.map +1 -1
- package/dist/switchbot.js +152 -34
- package/dist/switchbot.js.map +1 -1
- package/dist/types/ble.d.ts +6 -0
- package/dist/types/ble.d.ts.map +1 -1
- package/dist/types/ble.js.map +1 -1
- package/dist/types/device.d.ts +81 -2
- package/dist/types/device.d.ts.map +1 -1
- package/dist/types/index.d.ts +18 -0
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js.map +1 -1
- package/dist/utils/fallback-handler.js +0 -1
- package/dist/utils/fallback-handler.js.map +1 -1
- package/dist/utils/index.d.ts +21 -1
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/index.js +49 -0
- package/dist/utils/index.js.map +1 -1
- package/dist/utils/relay-encryption.d.ts +10 -0
- package/dist/utils/relay-encryption.d.ts.map +1 -0
- package/dist/utils/relay-encryption.js +23 -0
- package/dist/utils/relay-encryption.js.map +1 -0
- package/dist/utils/retry.d.ts.map +1 -1
- package/dist/utils/retry.js +49 -6
- package/dist/utils/retry.js.map +1 -1
- package/package.json +30 -14
- package/.gitattributes +0 -2
- package/.github/copilot-instructions.md +0 -179
- package/.github/dependabot.yml +0 -17
- package/.github/labeler.yml +0 -38
- package/.github/npm-version-script-esm.js +0 -97
- package/.github/workflows/beta-release.yml +0 -52
- package/.github/workflows/release.yml +0 -71
- package/.github/workflows/stale.yml +0 -12
- package/branding/Node_x_SwitchBot.svg +0 -8
- package/branding/icon.png +0 -0
- package/branding/switchbot.png +0 -0
- package/docs/.nojekyll +0 -1
- package/docs/assets/hierarchy.js +0 -1
- package/docs/assets/highlight.css +0 -85
- package/docs/assets/icons.js +0 -18
- package/docs/assets/icons.svg +0 -1
- package/docs/assets/main.js +0 -60
- package/docs/assets/navigation.js +0 -1
- package/docs/assets/search.js +0 -1
- package/docs/assets/style.css +0 -1633
- package/docs/classes/APIError.html +0 -6
- package/docs/classes/APINotAvailableError.html +0 -4
- package/docs/classes/BLEConnection.html +0 -21
- package/docs/classes/BLENotAvailableError.html +0 -4
- package/docs/classes/BLEScanner.html +0 -17
- package/docs/classes/CommandFailedError.html +0 -6
- package/docs/classes/ConnectionTimeoutError.html +0 -5
- package/docs/classes/DeviceManager.html +0 -25
- package/docs/classes/DeviceNotFoundError.html +0 -4
- package/docs/classes/DiscoveryError.html +0 -5
- package/docs/classes/OpenAPIClient.html +0 -66
- package/docs/classes/SwitchBot.html +0 -22
- package/docs/classes/SwitchBotDevice.html +0 -56
- package/docs/classes/SwitchBotError.html +0 -4
- package/docs/classes/ValidationError.html +0 -5
- package/docs/classes/WoAirPurifier.html +0 -63
- package/docs/classes/WoAirPurifierTable.html +0 -64
- package/docs/classes/WoBlindTilt.html +0 -67
- package/docs/classes/WoBulb.html +0 -65
- package/docs/classes/WoCeilingLight.html +0 -66
- package/docs/classes/WoContact.html +0 -55
- package/docs/classes/WoCurtain.html +0 -63
- package/docs/classes/WoHand.html +0 -69
- package/docs/classes/WoHub2.html +0 -55
- package/docs/classes/WoHub3.html +0 -56
- package/docs/classes/WoHumi.html +0 -63
- package/docs/classes/WoHumi2.html +0 -64
- package/docs/classes/WoIOSensorTH.html +0 -56
- package/docs/classes/WoKeypad.html +0 -56
- package/docs/classes/WoLeak.html +0 -55
- package/docs/classes/WoPlugMiniJP.html +0 -62
- package/docs/classes/WoPlugMiniUS.html +0 -61
- package/docs/classes/WoPresence.html +0 -55
- package/docs/classes/WoRelaySwitch1.html +0 -61
- package/docs/classes/WoRelaySwitch1PM.html +0 -62
- package/docs/classes/WoRemote.html +0 -56
- package/docs/classes/WoSensorTH.html +0 -55
- package/docs/classes/WoSensorTHPlus.html +0 -56
- package/docs/classes/WoSensorTHPro.html +0 -56
- package/docs/classes/WoSensorTHProCO2.html +0 -56
- package/docs/classes/WoSmartLock.html +0 -59
- package/docs/classes/WoSmartLockPro.html +0 -61
- package/docs/classes/WoStrip.html +0 -66
- package/docs/enums/LogLevel.html +0 -7
- package/docs/enums/SwitchBotBLEModel.html +0 -40
- package/docs/enums/SwitchBotBLEModelName.html +0 -40
- package/docs/functions/updateBaseURL.html +0 -3
- package/docs/hierarchy.html +0 -1
- package/docs/index.html +0 -55
- package/docs/interfaces/APICommandRequest.html +0 -5
- package/docs/interfaces/APICommandResponse.html +0 -5
- package/docs/interfaces/APIDevice.html +0 -18
- package/docs/interfaces/APIDeviceStatus.html +0 -36
- package/docs/interfaces/APIErrorResponse.html +0 -5
- package/docs/interfaces/APIResponse.html +0 -5
- package/docs/interfaces/AirPurifierCommands.html +0 -5
- package/docs/interfaces/AirPurifierServiceData.html +0 -29
- package/docs/interfaces/AirPurifierStatus.html +0 -17
- package/docs/interfaces/BLEAdvertisement.html +0 -7
- package/docs/interfaces/BLEScanOptions.html +0 -10
- package/docs/interfaces/BLEServiceData.html +0 -27
- package/docs/interfaces/BlindTiltCommands.html +0 -7
- package/docs/interfaces/BlindTiltServiceData.html +0 -30
- package/docs/interfaces/BlindTiltStatus.html +0 -15
- package/docs/interfaces/BotCommands.html +0 -4
- package/docs/interfaces/BotServiceData.html +0 -27
- package/docs/interfaces/BotStatus.html +0 -14
- package/docs/interfaces/BulbCommands.html +0 -6
- package/docs/interfaces/BulbServiceData.html +0 -35
- package/docs/interfaces/BulbStatus.html +0 -16
- package/docs/interfaces/CeilingLightCommands.html +0 -6
- package/docs/interfaces/CeilingLightServiceData.html +0 -35
- package/docs/interfaces/CeilingLightStatus.html +0 -16
- package/docs/interfaces/CommandResult.html +0 -12
- package/docs/interfaces/ContactServiceData.html +0 -30
- package/docs/interfaces/ContactStatus.html +0 -15
- package/docs/interfaces/CurtainCommands.html +0 -5
- package/docs/interfaces/CurtainServiceData.html +0 -31
- package/docs/interfaces/CurtainStatus.html +0 -17
- package/docs/interfaces/DeviceInfo.html +0 -36
- package/docs/interfaces/DeviceListResponse.html +0 -4
- package/docs/interfaces/DeviceStatus.html +0 -12
- package/docs/interfaces/DiscoveryOptions.html +0 -14
- package/docs/interfaces/HubServiceData.html +0 -31
- package/docs/interfaces/HubStatus.html +0 -15
- package/docs/interfaces/HumidifierCommands.html +0 -5
- package/docs/interfaces/HumidifierServiceData.html +0 -31
- package/docs/interfaces/HumidifierStatus.html +0 -18
- package/docs/interfaces/KeypadStatus.html +0 -13
- package/docs/interfaces/LeakServiceData.html +0 -28
- package/docs/interfaces/LeakStatus.html +0 -13
- package/docs/interfaces/LockCommands.html +0 -3
- package/docs/interfaces/LockServiceData.html +0 -29
- package/docs/interfaces/LockStatus.html +0 -15
- package/docs/interfaces/MeterServiceData.html +0 -30
- package/docs/interfaces/MeterStatus.html +0 -15
- package/docs/interfaces/MotionServiceData.html +0 -30
- package/docs/interfaces/MotionStatus.html +0 -14
- package/docs/interfaces/PlugCommands.html +0 -4
- package/docs/interfaces/PlugServiceData.html +0 -33
- package/docs/interfaces/PlugStatus.html +0 -16
- package/docs/interfaces/PresenceServiceData.html +0 -29
- package/docs/interfaces/PresenceStatus.html +0 -14
- package/docs/interfaces/RelaySwitchCommands.html +0 -4
- package/docs/interfaces/RelaySwitchServiceData.html +0 -30
- package/docs/interfaces/RelaySwitchStatus.html +0 -16
- package/docs/interfaces/RemoteStatus.html +0 -12
- package/docs/interfaces/SceneListResponse.html +0 -3
- package/docs/interfaces/StripCommands.html +0 -6
- package/docs/interfaces/StripServiceData.html +0 -35
- package/docs/interfaces/StripStatus.html +0 -16
- package/docs/interfaces/SwitchBotConfig.html +0 -30
- package/docs/interfaces/WebhookConfig.html +0 -4
- package/docs/interfaces/WebhookDetails.html +0 -7
- package/docs/interfaces/WebhookQueryResponse.html +0 -5
- package/docs/interfaces/WebhookSetupResponse.html +0 -5
- package/docs/media/BLE.md +0 -1259
- package/docs/media/OpenAPI.md +0 -186
- package/docs/modules.html +0 -1
- package/docs/types/ConnectionType.html +0 -2
- package/docs/types/PhysicalDeviceType.html +0 -2
- package/docs/types/VirtualDeviceType.html +0 -2
- package/docs/variables/urls.html +0 -1
- package/tmp-switchbot-scan.mjs +0 -79
- package/todo/PYSWITCHBOT_COMPARISON.md +0 -484
- package/todo/README.md +0 -68
- package/todo/completed.md +0 -65
- package/todo/todo.md +0 -369
- package/tsconfig.build.json +0 -17
package/dist/types/index.d.ts
CHANGED
|
@@ -44,6 +44,24 @@ export interface SwitchBotConfig {
|
|
|
44
44
|
retryInitialDelayMs?: number;
|
|
45
45
|
/** Maximum retry delay in milliseconds (default: 5000) */
|
|
46
46
|
retryMaxDelayMs?: number;
|
|
47
|
+
/** Enable detailed error reporting in command results (default: false) */
|
|
48
|
+
detailedErrors?: boolean;
|
|
49
|
+
/** Custom logger instance (optional) */
|
|
50
|
+
logger?: {
|
|
51
|
+
error: (message: string, ...args: any[]) => void;
|
|
52
|
+
warn: (message: string, ...args: any[]) => void;
|
|
53
|
+
info: (message: string, ...args: any[]) => void;
|
|
54
|
+
debug: (message: string, ...args: any[]) => void;
|
|
55
|
+
};
|
|
56
|
+
/** Additional custom options can be added as needed */
|
|
57
|
+
[key: string]: any;
|
|
58
|
+
/** Internal options for testing and advanced use (not part of public API) */
|
|
59
|
+
_internal?: {
|
|
60
|
+
/** Force use of BLE for testing (overrides intelligent selection) */
|
|
61
|
+
forceBLE?: boolean;
|
|
62
|
+
/** Force use of API for testing (overrides intelligent selection) */
|
|
63
|
+
forceAPI?: boolean;
|
|
64
|
+
};
|
|
47
65
|
}
|
|
48
66
|
/**
|
|
49
67
|
* Device discovery options
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,oBAAY,QAAQ;IAClB,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,GAAG,CAAA;IACX,uFAAuF;IACvF,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAA;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
|
package/dist/types/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAqJD,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}
|
|
@@ -38,7 +38,6 @@ export class FallbackHandlerManager {
|
|
|
38
38
|
*/
|
|
39
39
|
async emit(event) {
|
|
40
40
|
// Sort handlers by priority (descending)
|
|
41
|
-
// eslint-disable-next-line e18e/prefer-array-to-sorted
|
|
42
41
|
const sortedHandlers = [...this.handlers.entries()].sort((a, b) => b[1].priority - a[1].priority);
|
|
43
42
|
this.logger.debug(`Emitting fallback event to ${sortedHandlers.length} handlers`, {
|
|
44
43
|
device: event.deviceId,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fallback-handler.js","sourceRoot":"","sources":["../../src/utils/fallback-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AA8BnC;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACzB,QAAQ,GAGZ,IAAI,GAAG,EAAE,CAAA;IAEL,MAAM,CAAQ;IACd,cAAc,GAAG,CAAC,CAAA;IAE1B,YAAY,QAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAA;IAC9D,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,OAAwB,EACxB,UAAkC,EAAE;QAEpC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE,CAAA;QAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAA;QAEtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,eAAe,QAAQ,GAAG,CAAC,CAAA;QAE/E,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAU;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAA;QAC3D,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,KAAoB;QAC7B,yCAAyC;
|
|
1
|
+
{"version":3,"file":"fallback-handler.js","sourceRoot":"","sources":["../../src/utils/fallback-handler.ts"],"names":[],"mappings":"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"}
|
package/dist/utils/index.d.ts
CHANGED
|
@@ -1,5 +1,25 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Recursively merges two objects, preserving old values when new values are null or undefined.
|
|
3
|
+
* Arrays are not deeply merged (new array replaces old).
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* Merges two BLEAdvertisement objects recursively, preserving old values when new are null/undefined.
|
|
7
|
+
*/
|
|
8
|
+
import type { BLEAdvertisement } from '../types/ble.js';
|
|
9
|
+
/**
|
|
10
|
+
* Extracts all device-relevant options from a SwitchBotConfig object.
|
|
11
|
+
* Ensures future config fields are automatically supported for device instantiation.
|
|
12
|
+
*/
|
|
13
|
+
import type { LogLevel, SwitchBotConfig } from '../types/index.js';
|
|
14
|
+
/**
|
|
15
|
+
* Validates that a Buffer has at least the expected minimum length.
|
|
16
|
+
* Throws an error if the buffer is too short, including actual vs expected length and context.
|
|
17
|
+
*/
|
|
2
18
|
import { Buffer } from 'node:buffer';
|
|
19
|
+
export declare function extractDeviceOptionsFromConfig(config: SwitchBotConfig): Record<string, unknown>;
|
|
20
|
+
export declare function deepMerge<T extends Record<string, any>>(oldObj: T, newObj: Partial<T>): T;
|
|
21
|
+
export declare function mergeAdvertisement<T extends BLEAdvertisement>(oldAdv: T, newAdv: Partial<T>): T;
|
|
22
|
+
export declare function validateResponseLength(buffer: Buffer, minLength: number, context: string): void;
|
|
3
23
|
/**
|
|
4
24
|
* Logger utility for consistent logging across the library
|
|
5
25
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}
|
package/dist/utils/index.js
CHANGED
|
@@ -1,8 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Validates that a Buffer has at least the expected minimum length.
|
|
3
|
+
* Throws an error if the buffer is too short, including actual vs expected length and context.
|
|
4
|
+
*/
|
|
1
5
|
/* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
|
|
2
6
|
*
|
|
3
7
|
* utils/index.ts: SwitchBot v4.0.0 - Utility Functions
|
|
4
8
|
*/
|
|
5
9
|
import { Buffer } from 'node:buffer';
|
|
10
|
+
export function extractDeviceOptionsFromConfig(config) {
|
|
11
|
+
return {
|
|
12
|
+
bleConnection: config.bleConnection,
|
|
13
|
+
apiClient: config.apiClient,
|
|
14
|
+
enableFallback: config.enableFallback,
|
|
15
|
+
preferredConnection: config.preferredConnection,
|
|
16
|
+
enableConnectionIntelligence: config.enableConnectionIntelligence,
|
|
17
|
+
enableCircuitBreaker: config.enableCircuitBreaker,
|
|
18
|
+
enableRetry: config.enableRetry,
|
|
19
|
+
retryConfig: config.retryConfig,
|
|
20
|
+
circuitBreakerConfig: config.circuitBreakerConfig,
|
|
21
|
+
logLevel: config.logLevel,
|
|
22
|
+
// Add more fields here as needed in the future
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
export function deepMerge(oldObj, newObj) {
|
|
26
|
+
const result = Array.isArray(oldObj) ? [...oldObj] : { ...oldObj };
|
|
27
|
+
for (const key of Object.keys(newObj)) {
|
|
28
|
+
const newVal = newObj[key];
|
|
29
|
+
const oldVal = oldObj[key];
|
|
30
|
+
if (newVal === undefined || newVal === null) {
|
|
31
|
+
// Preserve old value
|
|
32
|
+
result[key] = oldVal;
|
|
33
|
+
}
|
|
34
|
+
else if (typeof oldVal === 'object' && oldVal !== null
|
|
35
|
+
&& typeof newVal === 'object' && newVal !== null
|
|
36
|
+
&& !Array.isArray(newVal) && !Array.isArray(oldVal)) {
|
|
37
|
+
// Recursively merge nested objects
|
|
38
|
+
result[key] = deepMerge(oldVal, newVal);
|
|
39
|
+
}
|
|
40
|
+
else {
|
|
41
|
+
// Use new value
|
|
42
|
+
result[key] = newVal;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return result;
|
|
46
|
+
}
|
|
47
|
+
export function mergeAdvertisement(oldAdv, newAdv) {
|
|
48
|
+
return deepMerge(oldAdv, newAdv);
|
|
49
|
+
}
|
|
50
|
+
export function validateResponseLength(buffer, minLength, context) {
|
|
51
|
+
if (!buffer || buffer.length < minLength) {
|
|
52
|
+
throw new Error(`Truncated response in ${context}: expected at least ${minLength} bytes, got ${buffer ? buffer.length : 0}`);
|
|
53
|
+
}
|
|
54
|
+
}
|
|
6
55
|
/**
|
|
7
56
|
* Logger utility for consistent logging across the library
|
|
8
57
|
*/
|
package/dist/utils/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { Buffer } from 'node:buffer';
|
|
2
|
+
/**
|
|
3
|
+
* Encrypts a relay switch BLE command using AES-128-CTR if key is provided.
|
|
4
|
+
* @param cmd - Command as Buffer or number[]
|
|
5
|
+
* @param keyHex - 16-byte hex string
|
|
6
|
+
* @param ivHex - 16-byte hex string (optional, defaults to 0)
|
|
7
|
+
* @returns Encrypted command as Buffer
|
|
8
|
+
*/
|
|
9
|
+
export declare function encryptRelayCommandIfNeeded(cmd: Buffer | number[], keyHex: string, ivHex?: string): Buffer;
|
|
10
|
+
//# sourceMappingURL=relay-encryption.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relay-encryption.d.ts","sourceRoot":"","sources":["../../src/utils/relay-encryption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAYR"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { Buffer } from 'node:buffer';
|
|
2
|
+
import crypto from 'node:crypto';
|
|
3
|
+
/**
|
|
4
|
+
* Encrypts a relay switch BLE command using AES-128-CTR if key is provided.
|
|
5
|
+
* @param cmd - Command as Buffer or number[]
|
|
6
|
+
* @param keyHex - 16-byte hex string
|
|
7
|
+
* @param ivHex - 16-byte hex string (optional, defaults to 0)
|
|
8
|
+
* @returns Encrypted command as Buffer
|
|
9
|
+
*/
|
|
10
|
+
export function encryptRelayCommandIfNeeded(cmd, keyHex, ivHex) {
|
|
11
|
+
const key = Buffer.from(keyHex, 'hex');
|
|
12
|
+
if (key.length !== 16) {
|
|
13
|
+
throw new Error('Relay encryptionKey must be 16 bytes (32 hex chars)');
|
|
14
|
+
}
|
|
15
|
+
const iv = ivHex ? Buffer.from(ivHex, 'hex') : Buffer.alloc(16, 0);
|
|
16
|
+
const input = Buffer.isBuffer(cmd) ? cmd : Buffer.from(cmd);
|
|
17
|
+
// For now, always use CTR mode (SwitchBot default for relay/lock)
|
|
18
|
+
const cipher = crypto.createCipheriv('aes-128-ctr', key, iv);
|
|
19
|
+
const encrypted = Buffer.concat([cipher.update(input), cipher.final()]);
|
|
20
|
+
// Prepend 0x11 to indicate encrypted command (SwitchBot convention)
|
|
21
|
+
return Buffer.concat([Buffer.from([0x11]), encrypted]);
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=relay-encryption.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relay-encryption.js","sourceRoot":"","sources":["../../src/utils/relay-encryption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,MAAM,MAAM,aAAa,CAAA;AAEhC;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,GAAsB,EACtB,MAAc,EACd,KAAc;IAEd,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACtC,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;IACxE,CAAC;IACD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3D,kEAAkE;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAA;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACvE,oEAAoE;IACpE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;AACxD,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,4BAA4B;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;CACpB;AAOD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,GAAE,WAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAYvD;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IAEG,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,SAAc,GACxB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IA8E1B;;OAEG;IACG,cAAc,CAAC,CAAC,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,SAAc,GACxB,OAAO,CAAC,CAAC,CAAC;CASd;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,WAAgB,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAGZ"}
|
package/dist/utils/retry.js
CHANGED
|
@@ -3,6 +3,30 @@
|
|
|
3
3
|
* utils/retry.ts: SwitchBot v4.0.0 - Retry Logic with Exponential Backoff
|
|
4
4
|
*/
|
|
5
5
|
import { Logger } from './index.js';
|
|
6
|
+
// BLEAK_RETRY_EXCEPTIONS: error messages/types that should trigger a retry
|
|
7
|
+
const BLEAK_RETRY_EXCEPTIONS = [
|
|
8
|
+
'Device with address',
|
|
9
|
+
'Failed to connect to peripheral',
|
|
10
|
+
'org.freedesktop.DBus.Error',
|
|
11
|
+
'org.bluez.Error',
|
|
12
|
+
'Connection was reset',
|
|
13
|
+
'Connection timed out',
|
|
14
|
+
'Operation already in progress',
|
|
15
|
+
'Operation failed',
|
|
16
|
+
'Not connected',
|
|
17
|
+
'No such device',
|
|
18
|
+
'Resource temporarily unavailable',
|
|
19
|
+
'Software caused connection abort',
|
|
20
|
+
'Connection refused',
|
|
21
|
+
'Connection reset by peer',
|
|
22
|
+
'Connection aborted',
|
|
23
|
+
'Connection error',
|
|
24
|
+
'TimeoutError',
|
|
25
|
+
];
|
|
26
|
+
/**
|
|
27
|
+
* DBus/BlueZ error regex (moved to module scope for performance)
|
|
28
|
+
*/
|
|
29
|
+
const DBUS_ERROR_REGEX = /org\.freedesktop\.DBus|org\.bluez|DBus|BlueZ/i;
|
|
6
30
|
/**
|
|
7
31
|
* Retry executor with exponential backoff
|
|
8
32
|
*/
|
|
@@ -54,23 +78,42 @@ export class RetryExecutor {
|
|
|
54
78
|
}
|
|
55
79
|
catch (error) {
|
|
56
80
|
lastError = error instanceof Error ? error : new Error(String(error));
|
|
81
|
+
const errorMsg = lastError.message || String(lastError);
|
|
82
|
+
const isDBusError = DBUS_ERROR_REGEX.test(errorMsg);
|
|
83
|
+
const isBleakRetry = BLEAK_RETRY_EXCEPTIONS.some(msg => errorMsg.includes(msg));
|
|
57
84
|
const elapsedMs = Date.now() - (Date.now() - totalTimeMs);
|
|
58
85
|
totalTimeMs += elapsedMs;
|
|
59
|
-
if (attemptNumber < this.config.maxAttempts) {
|
|
86
|
+
if (attemptNumber < this.config.maxAttempts && (isDBusError || isBleakRetry || attemptNumber < this.config.maxAttempts)) {
|
|
87
|
+
// DBus error: always backoff 0.25s (250ms) before normal backoff
|
|
88
|
+
if (isDBusError) {
|
|
89
|
+
this.logger.warn(`${description} DBus error detected on attempt ${attemptNumber}, applying 250ms backoff`, { error: errorMsg });
|
|
90
|
+
await new Promise(resolve => setTimeout(resolve, 250));
|
|
91
|
+
}
|
|
60
92
|
const delayMs = this.calculateDelay(attemptNumber);
|
|
61
|
-
this.logger.warn(`${description} failed on attempt ${attemptNumber}/${this.config.maxAttempts}, retrying in ${delayMs}ms`, {
|
|
62
|
-
|
|
93
|
+
this.logger.warn(`${description} failed on attempt ${attemptNumber}/${this.config.maxAttempts}, retrying in ${delayMs}ms`, {
|
|
94
|
+
error: errorMsg,
|
|
95
|
+
attempt: attemptNumber,
|
|
96
|
+
errorType: lastError.name,
|
|
97
|
+
isDBusError,
|
|
98
|
+
isBleakRetry,
|
|
99
|
+
});
|
|
63
100
|
await new Promise(resolve => setTimeout(resolve, delayMs));
|
|
64
101
|
}
|
|
65
102
|
else {
|
|
66
|
-
this.logger.error(`${description} failed after ${attemptNumber} attempts`, {
|
|
103
|
+
this.logger.error(`${description} failed after ${attemptNumber} attempts`, {
|
|
104
|
+
error: errorMsg,
|
|
105
|
+
attempt: attemptNumber,
|
|
106
|
+
errorType: lastError.name,
|
|
107
|
+
isDBusError,
|
|
108
|
+
isBleakRetry,
|
|
109
|
+
});
|
|
67
110
|
}
|
|
68
111
|
}
|
|
69
112
|
}
|
|
70
113
|
return {
|
|
71
114
|
success: false,
|
|
72
|
-
error: lastError ||
|
|
73
|
-
attemptsCount: attemptNumber,
|
|
115
|
+
error: new Error(`Retry failed after ${attemptNumber - 1} attempts. Last error: ${lastError?.name || 'Unknown'}: ${lastError?.message || 'Unknown error'}`),
|
|
116
|
+
attemptsCount: attemptNumber - 1,
|
|
74
117
|
totalTimeMs,
|
|
75
118
|
};
|
|
76
119
|
}
|
package/dist/utils/retry.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;
|
|
1
|
+
{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "node-switchbot",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "4.0.0
|
|
4
|
+
"version": "4.0.0",
|
|
5
5
|
"description": "The node-switchbot is a Node.js module which allows you to control your Switchbot Devices through Bluetooth (BLE) with automatic OpenAPI fallback.",
|
|
6
6
|
"author": "OpenWonderLabs (https://github.com/OpenWonderLabs)",
|
|
7
7
|
"license": "MIT",
|
|
@@ -31,13 +31,24 @@
|
|
|
31
31
|
],
|
|
32
32
|
"main": "dist/index.js",
|
|
33
33
|
"types": "dist/index.d.ts",
|
|
34
|
+
"files": [
|
|
35
|
+
"BLE.md",
|
|
36
|
+
"CHANGELOG.md",
|
|
37
|
+
"LICENSE",
|
|
38
|
+
"OpenAPI.md",
|
|
39
|
+
"README.md",
|
|
40
|
+
"dist/"
|
|
41
|
+
],
|
|
34
42
|
"engines": {
|
|
35
43
|
"node": "^20 || ^22 || ^24"
|
|
36
44
|
},
|
|
37
45
|
"scripts": {
|
|
38
46
|
"check": "npm install && npm outdated",
|
|
39
|
-
"
|
|
40
|
-
"lint
|
|
47
|
+
"type-check": "tsc --noEmit",
|
|
48
|
+
"lint": "eslint src/**/*.ts test/**/*.ts && npm run type-check",
|
|
49
|
+
"lint:fix": "eslint src/**/*.ts test/**/*.ts --fix && npm run type-check",
|
|
50
|
+
"lint:src": "eslint src/**/*.ts",
|
|
51
|
+
"lint:test": "eslint test/**/*.ts",
|
|
41
52
|
"watch": "npm run build && npm link && nodemon",
|
|
42
53
|
"build": "npm run clean && tsc -p tsconfig.build.json",
|
|
43
54
|
"prepublishOnly": "npm run lint && npm run build && npm run docs && npm run lint-docs",
|
|
@@ -52,23 +63,28 @@
|
|
|
52
63
|
},
|
|
53
64
|
"readmeFilename": "README.md",
|
|
54
65
|
"dependencies": {
|
|
55
|
-
"@stoprocent/noble": "^2.
|
|
56
|
-
"undici": "^
|
|
66
|
+
"@stoprocent/noble": "^2.4.0",
|
|
67
|
+
"undici": "^8.0.2"
|
|
57
68
|
},
|
|
58
69
|
"optionalDependencies": {
|
|
59
70
|
"@stoprocent/bluetooth-hci-socket": "^2.2.5"
|
|
60
71
|
},
|
|
61
72
|
"devDependencies": {
|
|
62
|
-
"@antfu/eslint-config": "^
|
|
63
|
-
"@types/node": "^25.
|
|
64
|
-
"@vitest/coverage-v8": "^4.
|
|
65
|
-
"eslint": "^
|
|
73
|
+
"@antfu/eslint-config": "^8.1.1",
|
|
74
|
+
"@types/node": "^25.6.0",
|
|
75
|
+
"@vitest/coverage-v8": "^4.1.4",
|
|
76
|
+
"eslint": "^10.2.0",
|
|
66
77
|
"eslint-plugin-format": "^2.0.1",
|
|
67
|
-
"eslint-plugin-
|
|
68
|
-
"eslint-plugin-import-x": "^4.16.1",
|
|
78
|
+
"eslint-plugin-perfectionist": "^5.8.0",
|
|
69
79
|
"shx": "^0.4.0",
|
|
70
|
-
"typedoc": "^0.28.
|
|
71
|
-
"typescript": "^
|
|
72
|
-
"vitest": "^4.
|
|
80
|
+
"typedoc": "^0.28.18",
|
|
81
|
+
"typescript": "^6.0.2",
|
|
82
|
+
"vitest": "^4.1.4"
|
|
83
|
+
},
|
|
84
|
+
"overrides": {
|
|
85
|
+
"brace-expansion": "^5.0.5",
|
|
86
|
+
"flatted": "^3.4.0",
|
|
87
|
+
"picomatch": "^2.3.2",
|
|
88
|
+
"yaml": "^2.8.3"
|
|
73
89
|
}
|
|
74
90
|
}
|
package/.gitattributes
DELETED
|
@@ -1,179 +0,0 @@
|
|
|
1
|
-
# Node-SwitchBot Development Instructions
|
|
2
|
-
|
|
3
|
-
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.
|
|
4
|
-
|
|
5
|
-
## Working Effectively
|
|
6
|
-
|
|
7
|
-
### Bootstrap and Setup
|
|
8
|
-
- Install Node.js (^20 || ^22 || ^24): Use the existing version if available
|
|
9
|
-
- Install dependencies: `npm install` -- takes ~5-25 seconds (varies by cache). **NEVER CANCEL**
|
|
10
|
-
- Build the project: `npm run build` -- takes ~5 seconds. **NEVER CANCEL**
|
|
11
|
-
- Run tests: `npm run test` -- takes ~1 second with 12 tests. **NEVER CANCEL**
|
|
12
|
-
|
|
13
|
-
### Development Workflow
|
|
14
|
-
- **ALWAYS run these commands in order when starting work:**
|
|
15
|
-
1. `npm install`
|
|
16
|
-
2. `npm run build`
|
|
17
|
-
3. `npm run test`
|
|
18
|
-
4. `npm run lint`
|
|
19
|
-
- **Build and validate EVERY change**: After any code modification, always run `npm run build && npm run test && npm run lint`
|
|
20
|
-
- **NEVER skip linting**: Run `npm run lint` before committing or the CI (.github/workflows/build.yml) will fail
|
|
21
|
-
- **Use lint:fix for automatic fixes**: `npm run lint:fix` to automatically fix ESLint issues
|
|
22
|
-
|
|
23
|
-
### Platform Requirements and Constraints
|
|
24
|
-
- **BLE functionality requires Linux or macOS** (Raspbian, Ubuntu, macOS, etc.)
|
|
25
|
-
- **Windows is NOT supported** for BLE operations (use OpenAPI instead)
|
|
26
|
-
- **Node.js versions**: Must use ^20, ^22, or ^24 (currently using v20.19.4)
|
|
27
|
-
- **ES Modules**: This project uses `"type": "module"` - always use ES import/export syntax
|
|
28
|
-
|
|
29
|
-
#### BLE Prerequisites
|
|
30
|
-
|
|
31
|
-
**macOS:**
|
|
32
|
-
- Xcode installed
|
|
33
|
-
- Bluetooth permissions enabled for terminal app in System Preferences
|
|
34
|
-
|
|
35
|
-
**Linux (Ubuntu/Debian/Raspbian):**
|
|
36
|
-
- Required packages: `sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev`
|
|
37
|
-
- For non-root access: `sudo setcap cap_net_raw+eip $(eval readlink -f \`which node\`)`
|
|
38
|
-
- Raspberry Pi: May need to disable pnat plugin in `/etc/bluetooth/main.conf`
|
|
39
|
-
|
|
40
|
-
**Linux (Fedora/RPM):**
|
|
41
|
-
- Required packages: `sudo yum install bluez bluez-libs bluez-libs-devel`
|
|
42
|
-
|
|
43
|
-
### Testing and Validation
|
|
44
|
-
- **Basic functionality test**: After any changes to core classes, run this validation:
|
|
45
|
-
```javascript
|
|
46
|
-
const { SwitchBotBLE, SwitchBotOpenAPI } = require('./dist/index.js');
|
|
47
|
-
const ble = new SwitchBotBLE(); // Should not throw
|
|
48
|
-
const api = new SwitchBotOpenAPI('test', 'test'); // Should not throw
|
|
49
|
-
```
|
|
50
|
-
- **Complete test suite**: `npm run test` (12 tests) -- should always pass before committing
|
|
51
|
-
- **Test coverage**: `npm run test-coverage` to see coverage report (~15% coverage is normal)
|
|
52
|
-
- **Documentation generation**: `npm run docs` generates TypeDoc documentation in ./docs/
|
|
53
|
-
|
|
54
|
-
### Build and Timing Expectations
|
|
55
|
-
- **npm install**: ~5-25 seconds (varies by cache) -- **NEVER CANCEL**. Set timeout to 5+ minutes for safety
|
|
56
|
-
- **npm run build**: ~5 seconds -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety
|
|
57
|
-
- **npm run test**: ~1 second (12 tests) -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety
|
|
58
|
-
- **npm run lint**: ~3 seconds -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety
|
|
59
|
-
- **npm run docs**: ~2 seconds -- **NEVER CANCEL**. Set timeout to 2+ minutes for safety
|
|
60
|
-
|
|
61
|
-
## Project Structure and Key Files
|
|
62
|
-
|
|
63
|
-
### Source Code Organization
|
|
64
|
-
- **src/index.ts**: Main export file - exports SwitchBotBLE, SwitchBotOpenAPI, and device classes
|
|
65
|
-
- **src/switchbot-ble.ts**: Bluetooth Low Energy interface for direct device control
|
|
66
|
-
- **src/switchbot-openapi.ts**: HTTP API interface for cloud-based SwitchBot control
|
|
67
|
-
- **src/device.ts**: Individual device classes (WoHand, WoCurtain, WoSmartLock, etc.)
|
|
68
|
-
- **src/types/**: TypeScript type definitions for all device interfaces
|
|
69
|
-
- **src/settings.ts**: Configuration constants and API URLs
|
|
70
|
-
- **dist/**: Compiled JavaScript output (generated by `npm run build`)
|
|
71
|
-
|
|
72
|
-
### Configuration Files
|
|
73
|
-
- **package.json**: Main project config - scripts, dependencies, ES module config
|
|
74
|
-
- **tsconfig.json**: TypeScript compilation settings (target: ES2022, module: ES2022)
|
|
75
|
-
- **eslint.config.js**: ESLint configuration using @antfu/eslint-config
|
|
76
|
-
- **jest.config.js**: Test configuration (uses Vitest, not Jest)
|
|
77
|
-
- **.gitignore**: Excludes dist/, node_modules/, coverage/, and build artifacts
|
|
78
|
-
|
|
79
|
-
### Documentation
|
|
80
|
-
- **README.md**: Main project documentation and installation instructions
|
|
81
|
-
- **BLE.md**: Comprehensive BLE usage documentation and device examples
|
|
82
|
-
- **OpenAPI.md**: OpenAPI usage documentation and authentication setup
|
|
83
|
-
- **CHANGELOG.md**: Version history and release notes
|
|
84
|
-
- **docs/**: Generated TypeDoc API documentation (HTML format)
|
|
85
|
-
|
|
86
|
-
## Common Development Tasks
|
|
87
|
-
|
|
88
|
-
### Adding New Device Support
|
|
89
|
-
- **Add device class**: Create new class in src/device.ts extending SwitchbotDevice
|
|
90
|
-
- **Update exports**: Add export to src/index.ts
|
|
91
|
-
- **Add type definitions**: Create types in src/types/ if needed
|
|
92
|
-
- **Test basic instantiation**: Ensure the device class can be imported and instantiated
|
|
93
|
-
- **Always run full build and test cycle**: `npm run build && npm run test && npm run lint`
|
|
94
|
-
|
|
95
|
-
### API Changes and Extensions
|
|
96
|
-
- **OpenAPI changes**: Modify src/switchbot-openapi.ts
|
|
97
|
-
- **BLE changes**: Modify src/switchbot-ble.ts
|
|
98
|
-
- **Update type definitions**: Modify corresponding files in src/types/
|
|
99
|
-
- **Always verify exports**: Check that new functionality is exported in src/index.ts
|
|
100
|
-
- **Test import functionality**: Verify new exports can be imported correctly
|
|
101
|
-
|
|
102
|
-
### Working with Dependencies
|
|
103
|
-
- **Noble (BLE)**: @stoprocent/noble for Bluetooth functionality - Linux only
|
|
104
|
-
- **HTTP requests**: Uses undici for HTTP calls (not axios or fetch)
|
|
105
|
-
- **Async operations**: Uses async-mutex for concurrency control
|
|
106
|
-
- **Adding dependencies**: Use `npm install --save` for runtime deps, `--save-dev` for dev deps
|
|
107
|
-
|
|
108
|
-
## Validation and Quality Assurance
|
|
109
|
-
|
|
110
|
-
### Pre-commit Checklist
|
|
111
|
-
1. **Build succeeds**: `npm run build` completes without errors
|
|
112
|
-
2. **All tests pass**: `npm run test` shows all 12 tests passing
|
|
113
|
-
3. **Linting passes**: `npm run lint` shows no errors
|
|
114
|
-
4. **Documentation builds**: `npm run docs` generates without warnings
|
|
115
|
-
5. **Basic import works**: Can import and instantiate main classes
|
|
116
|
-
|
|
117
|
-
### Manual Testing Scenarios
|
|
118
|
-
- **SwitchBotBLE instantiation**: `new SwitchBotBLE()` should not throw errors
|
|
119
|
-
- **SwitchBotOpenAPI instantiation**: `new SwitchBotOpenAPI('token', 'secret')` should not throw
|
|
120
|
-
- **Module exports**: All exported classes should be importable from main package
|
|
121
|
-
- **TypeScript compilation**: No TypeScript errors in dist/ output
|
|
122
|
-
- **Documentation completeness**: Check that new public APIs appear in generated docs
|
|
123
|
-
|
|
124
|
-
### CI/CD Integration
|
|
125
|
-
- **GitHub Actions**: Build runs on push to 'latest' branch and PRs
|
|
126
|
-
- **External workflows**: Uses OpenWonderLabs/.github/.github/workflows/nodejs-build-and-test.yml
|
|
127
|
-
- **Required checks**: Build, test, and lint must all pass
|
|
128
|
-
- **Coverage reporting**: Test coverage is tracked and reported
|
|
129
|
-
|
|
130
|
-
## Troubleshooting Common Issues
|
|
131
|
-
|
|
132
|
-
### BLE Not Working
|
|
133
|
-
- **Check OS**: BLE works on Linux and macOS systems only
|
|
134
|
-
- **Install noble prerequisites**: May need additional system libraries for @stoprocent/noble
|
|
135
|
-
- **Use OpenAPI instead**: For Windows development, use SwitchBotOpenAPI class
|
|
136
|
-
|
|
137
|
-
### Build Failures
|
|
138
|
-
- **Check Node.js version**: Must be ^20, ^22, or ^24
|
|
139
|
-
- **Clean and rebuild**: `npm run clean && npm install && npm run build`
|
|
140
|
-
- **TypeScript errors**: Check tsconfig.json settings and type definitions
|
|
141
|
-
|
|
142
|
-
### Test Failures
|
|
143
|
-
- **Run individual tests**: Use `npm run test:watch` for interactive testing
|
|
144
|
-
- **Check imports**: Ensure all imports use correct ES module syntax
|
|
145
|
-
- **Verify exports**: Check that src/index.ts exports all necessary components
|
|
146
|
-
|
|
147
|
-
### Linting Errors
|
|
148
|
-
- **Auto-fix**: Use `npm run lint:fix` to automatically fix many issues
|
|
149
|
-
- **ESLint config**: Review eslint.config.js for current rules
|
|
150
|
-
- **Import sorting**: ESLint enforces specific import order - use lint:fix
|
|
151
|
-
|
|
152
|
-
## Frequently Referenced Information
|
|
153
|
-
|
|
154
|
-
### Package Scripts (from package.json)
|
|
155
|
-
```bash
|
|
156
|
-
npm run build # Clean and compile TypeScript
|
|
157
|
-
npm run test # Run test suite with Vitest
|
|
158
|
-
npm run lint # Run ESLint on src/**/*.ts
|
|
159
|
-
npm run lint:fix # Auto-fix ESLint issues
|
|
160
|
-
npm run docs # Generate TypeDoc documentation
|
|
161
|
-
npm run clean # Remove dist/ directory
|
|
162
|
-
npm run watch # Build and link for development
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
### Main Exports (from src/index.ts)
|
|
166
|
-
- **SwitchBotBLE**: Bluetooth interface class
|
|
167
|
-
- **SwitchBotOpenAPI**: HTTP API interface class
|
|
168
|
-
- **SwitchbotDevice**: Base device class
|
|
169
|
-
- **Device classes**: WoHand, WoCurtain, WoSmartLock, etc.
|
|
170
|
-
- **Type definitions**: All device status and response types
|
|
171
|
-
|
|
172
|
-
### Dependencies Summary
|
|
173
|
-
- **@stoprocent/noble**: BLE functionality (Linux/macOS)
|
|
174
|
-
- **undici**: HTTP client for API requests
|
|
175
|
-
- **async-mutex**: Concurrency control
|
|
176
|
-
- **TypeScript**: Language and compilation
|
|
177
|
-
- **Vitest**: Testing framework
|
|
178
|
-
- **ESLint**: Code linting with @antfu/eslint-config
|
|
179
|
-
- **TypeDoc**: API documentation generation
|