node-switchbot 4.0.0-beta.14 → 4.0.0-beta.15

package/todo/todo.md

@@ -1,195 +1 @@
-# Completed
-
-
 # TODO (Prioritized)
-
-
-
-
-## ⭐ Medium Priority
-
-  - `getCurrentTimeAndStartTime()` - For energy calculations
-  - Command: `0x57 0x0F 0x51 0x01 0x05 0x01 0x00 0x00 0x00`
-  
-  
-  
-# TODO: pySwitchBot Feature Parity Roadmap
-
-Implementation tasks to achieve feature parity with pySwitchBot.
-
-Last Updated: March 7, 2026  
-Source: [PYSWITCHBOT_COMPARISON.md](./PYSWITCHBOT_COMPARISON.md)
-
----
-
-## 📅 Phase 2: Command Enhancement (Q2 2026)
-
-### 🤖 Bot (WoHand) Commands
-
-### 🔒 Lock Commands
-
-### Task 18.8: Implement key verification ✅
-**Completed: March 7, 2026**
-- Ensures users get immediate feedback on key validity before encrypted operations.
-- See PR/commit: Task 18.8 implementation, March 7, 2026.
-
-
-- ✅ Phase 2 completed. See `todo/completed.md` for completed task details.
-
----
-
-
-✅ **Phase 3 completed!** All vacuum cleaners, lock variants, power/climate devices, lighting variants, and other devices implemented. See `todo/completed.md` for detailed task completion records.
-
----
-## 📅 Phase 4: Advanced Features (Q4 2026)
-
-
-- ✅ Task 6.4 completed. See `todo/completed.md` for implementation details.
- 
-
-### 💧 Humidifier Commands
-
-- ✅ Task 7.1 completed. See `todo/completed.md` for implementation details.
-
-<!-- Task 7.2 moved to completed.md -->
-
-
-### 🌬️ Air Purifier Commands
-
-<!-- Task 8.1 moved to completed.md -->
-
-<!-- Task 8.2 moved to completed.md -->
-
-### 🔐 Encryption Enhancements
-
-
-
-
-
-
-
-<!-- Task 18.7 moved to completed.md -->
-
-- [x] **Task 18.8**: Implement key verification
-  - `verifyEncryptionKey()` - Test key validity
-  - Try commands with key before assuming valid
-  - Better error messages for invalid keys
-
-### 📊 Status & Response Parsing
-
-- [x] **Task 10.1**: Implement passive status from advertisements ✅
-  - Parse device state from BLE advertisements
-  - No connection needed for basic status
-  - Cache last known state
-
-- [x] **Task 10.2**: Add sequence number tracking ✅
-  - Monitor `sequence_number` in advertisements
-  - Auto-trigger status update when sequence changes
-  - Implement for: locks, relay switches, vacuums, air purifiers
-
-
-
-
-
-### 🔗 Connection & Error Improvements
-
-
-
-- [x] **Task 19.4**: Enhance retry logic
-  - DBus error backoff (0.25s)
-  - `BLEAK_RETRY_EXCEPTIONS` handling
-  - Better context in retry errors
-
-- [x] **Task 19.5**: Add response length validation ✅
-  - Check minimum expected length
-  - Throw errors for truncated responses
-  - Include actual vs expected length in error
-
-- [x] **Task 20.3**: Implement command batching ✅
-  - Queue multiple commands
-  - Send in sequence on single connection
-  - Share connection overhead
-
-  - `_expected_disconnect` flag
-  - Differentiate expected vs unexpected disconnects
-  - Better error handling for unexpected disconnects
-
-  - Per-command notification futures
-  - Timeout handling (5s default)
-  - Log unsolicited notifications
-
-  - Cache read/write characteristics
-  - Clear cache on characteristic missing error
-  - Avoid repeated characteristic discovery
-### 🎯 Advanced Patterns
-
-
-
-
-
----
-
-## 📈 Medium Priority Enhancements
-
-## 🏆 High Priority
-
-- [ ] **Task 1.4**: Enhance advertisement data structure
-  - Add `rawAdvData` field
-  - Add `isEncrypted` flag
-  - Add `modelFriendlyName` field
-
-- [ ] **Task 1.5**: Add advertisement data merging
-  - Preserve old values when new data is None
-  - Recursive dict merging for nested structures
-  - Implement `_merge_data()` helper
-
-## ⭐ Medium Priority
-
-- [ ] **Task 5.4**: Add time/energy tracking
-  - `getCurrentTimeAndStartTime()` - For energy calculations
-  - Command: `0x57 0x0F 0x51 0x01 0x05 0x01 0x00 0x00 0x00`
-
-
-### Status Parsing
-
-
----
-
-## 🎯 Success Metrics
-
-- **Feature Parity**: 90%+ of pySwitchBot commands implemented
-- **Device Coverage**: 95%+ of SwitchBot device types supported
-- **Status Accuracy**: Advertisement-based status for all devices
-- **Connection Efficiency**: 50% reduction in connection overhead via batching
-- **Error Clarity**: Specific error types for all failure modes
-
----
-
-## 📝 Notes
-
-### Task Completion Process
-1. Move completed task from this file to `completed.md`
-2. Add completion date and any notes
-3. Update "Last Updated" timestamp
-4. Reference any relevant PRs or commits
-
-### Priority Levels
-- **High Priority**: Core functionality, user-facing features
-- **Medium Priority**: Enhancements, optimizations
-- **Low Priority**: Nice-to-have features
-
-### Reference
-- Full comparison details: [PYSWITCHBOT_COMPARISON.md](../PYSWITCHBOT_COMPARISON.md)
-- pySwitchBot Repository: https://github.com/Danielhiversen/pySwitchbot
-- SwitchBot BLE API: https://github.com/OpenWonderLabs/SwitchBotAPI-BLE
-
----
-
-## 📋 Todo List
-
-- [x] Enhance retry logic: DBus backoff, BLEAK exceptions, error context
-- [x] Add/expand tests for retry logic (DBus, BLEAK, error context)
-- [x] Add response length validation (min length, error for truncated, actual vs expected)
-- [x] Implement command batching (queue, sequence, share connection)
-- [x] Implement expected disconnect tracking (track disconnects that are expected as part of command flow)

package/todo/completed-task-5.4.md

@@ -1,7 +0,0 @@
-### Task 5.4: Add time/energy tracking ✅
-**Completed: March 7, 2026**
-**Implementation Details:**
-- Implemented `getCurrentTimeAndStartTime()` in WoRelaySwitch1 to send BLE command `0x57 0x0F 0x51 0x01 0x05 0x01 0x00 0x00 0x00` and parse the response for current time, start time, and energy.
-- Updated `RelaySwitchCommands` type in `src/types/device.ts` to include the new method.
-- Validated by full build (`npm run build`), lint (`npm run lint`), and test (`npm run test`) cycle: all passed with no errors.
-- See PR/commit: Task 5.4 implementation, March 7, 2026.