[donavanbecker]

BLE transport changes to match pySwitchbot, shipped first as 6.0.0 betas (npm i node-switchbot@beta) so they can be tested on real devices before a stable release. Each change has tests; I couldn't test against hardware.

1. Replies come from notifications — fix(ble)

SwitchBot devices answer a command with a notification, which pySwitchbot waits for. node-switchbot read the notify characteristic after writing, which can return a stale value. Now:

• The wait is registered before writing, so a fast reply isn't missed. The existing expectNotification path wrote first, which was a race.
• One listener per notify characteristic: a notification answers the pending command, otherwise it goes to subscribeNotifications() handlers.
• A pending reply fails on disconnect; the timeout is pySwitchbot's 5 s.
• Backends without notification events still fall back to a read.

2. pySwitchbot's encryption protocol — feat(ble)!

node-switchbot's encryption didn't match the devices: it encrypted the whole command, prepended 0x11, and used an IV from config. BLEConnection.sendEncryptedCommand now implements SwitchbotEncryptedDevice:

• Session setup per connection: 57 000000 0F2103 <keyId> returns the AES mode (CTR or GCM) and the device's IV.
• Commands: sent as 57 <keyId> <2-byte header> <AES(rest)>.
• Replies: decrypted to status plus payload. GCM increments the IV per command, and the session resets on disconnect.

Also:

• Added setKey({ encryptionKey, keyId }). homebridge-switchbot already calls it, but it didn't exist, so encrypted devices never received their key.
• Bulbs, relay switches and air purifiers no longer pre-encrypt when a key id is set.
• The air purifier filter reset now works on encrypted devices, verified from the decrypted reply.

Tests use a simulated device implementing the protocol in both CTR and GCM, plus pySwitchbot's init and mode cases.

3. SwitchBotBLEModel values — feat!

Thirteen values were codes belonging to other products. Some examples:

• MeterPro 'o' was the Lock's code.
• WaterLeakDetector 'y' was the Keypad's.
• Remote 0x05 was HubMini Matter's.
• RelaySwitch1PM 0x0D was Lock Lite's.

Every value is now the product's primary pySwitchbot code. New members include RelaySwitch2PM, GarageDoorOpener, LockLite, RollerShade and PlugMiniEU.

Breaking changes / migration

• Encrypted devices need keyId alongside encryptionKey (both from the SwitchBot account, as for pySwitchbot). Without a key id the old scheme is used, which didn't work with real devices anyway.
• SwitchBotBLEModel values changed. KeypadTouch, RobotVacuumCleanerS1, RobotVacuumCleanerS1Plus and PresenceSensor are removed (no single-byte code; their values named other products). homebridge-switchbot doesn't use this enum.

Checks

Build, 429 tests (+27) and lint pass. Labelled major. Merging into beta-6.0.0 publishes 6.0.0-beta.x; promoting beta-6.0.0 to latest releases 6.0.0.

https://claude.ai/code/session_01TYWa2RXoWsaUTWh76oNv8s

---

Generated by Claude Code