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.
Files changed (417) hide show
  1. package/BLE.md +215 -838
  2. package/CHANGELOG.md +96 -1371
  3. package/OpenAPI.md +169 -135
  4. package/README.md +1 -1
  5. package/dist/ble.d.ts +14 -1
  6. package/dist/ble.d.ts.map +1 -1
  7. package/dist/ble.js +241 -39
  8. package/dist/ble.js.map +1 -1
  9. package/dist/devices/base.d.ts +97 -1
  10. package/dist/devices/base.d.ts.map +1 -1
  11. package/dist/devices/base.js +204 -2
  12. package/dist/devices/base.js.map +1 -1
  13. package/dist/devices/device-override-state-during-connection.d.ts +27 -0
  14. package/dist/devices/device-override-state-during-connection.d.ts.map +1 -0
  15. package/dist/devices/device-override-state-during-connection.js +45 -0
  16. package/dist/devices/device-override-state-during-connection.js.map +1 -0
  17. package/dist/devices/index.d.ts +36 -0
  18. package/dist/devices/index.d.ts.map +1 -1
  19. package/dist/devices/index.js +36 -0
  20. package/dist/devices/index.js.map +1 -1
  21. package/dist/devices/sequence-device.d.ts +52 -0
  22. package/dist/devices/sequence-device.d.ts.map +1 -0
  23. package/dist/devices/sequence-device.js +91 -0
  24. package/dist/devices/sequence-device.js.map +1 -0
  25. package/dist/devices/wo-ai-hub.d.ts +9 -0
  26. package/dist/devices/wo-ai-hub.d.ts.map +1 -0
  27. package/dist/devices/wo-ai-hub.js +25 -0
  28. package/dist/devices/wo-ai-hub.js.map +1 -0
  29. package/dist/devices/wo-air-purifier-pm25.d.ts +29 -0
  30. package/dist/devices/wo-air-purifier-pm25.d.ts.map +1 -0
  31. package/dist/devices/wo-air-purifier-pm25.js +144 -0
  32. package/dist/devices/wo-air-purifier-pm25.js.map +1 -0
  33. package/dist/devices/wo-air-purifier.d.ts +21 -4
  34. package/dist/devices/wo-air-purifier.d.ts.map +1 -1
  35. package/dist/devices/wo-air-purifier.js +111 -61
  36. package/dist/devices/wo-air-purifier.js.map +1 -1
  37. package/dist/devices/wo-art-frame.d.ts +8 -0
  38. package/dist/devices/wo-art-frame.d.ts.map +1 -0
  39. package/dist/devices/wo-art-frame.js +12 -0
  40. package/dist/devices/wo-art-frame.js.map +1 -0
  41. package/dist/devices/wo-blind-tilt.d.ts +2 -16
  42. package/dist/devices/wo-blind-tilt.d.ts.map +1 -1
  43. package/dist/devices/wo-blind-tilt.js +135 -62
  44. package/dist/devices/wo-blind-tilt.js.map +1 -1
  45. package/dist/devices/wo-bulb.d.ts +37 -1
  46. package/dist/devices/wo-bulb.d.ts.map +1 -1
  47. package/dist/devices/wo-bulb.js +196 -51
  48. package/dist/devices/wo-bulb.js.map +1 -1
  49. package/dist/devices/wo-candle-warmer-lamp.d.ts +25 -0
  50. package/dist/devices/wo-candle-warmer-lamp.d.ts.map +1 -0
  51. package/dist/devices/wo-candle-warmer-lamp.js +81 -0
  52. package/dist/devices/wo-candle-warmer-lamp.js.map +1 -0
  53. package/dist/devices/wo-circulator-fan.d.ts +8 -0
  54. package/dist/devices/wo-circulator-fan.d.ts.map +1 -0
  55. package/dist/devices/wo-circulator-fan.js +12 -0
  56. package/dist/devices/wo-circulator-fan.js.map +1 -0
  57. package/dist/devices/wo-climate-panel.d.ts +8 -0
  58. package/dist/devices/wo-climate-panel.d.ts.map +1 -0
  59. package/dist/devices/wo-climate-panel.js +12 -0
  60. package/dist/devices/wo-climate-panel.js.map +1 -0
  61. package/dist/devices/wo-contact.d.ts +1 -1
  62. package/dist/devices/wo-contact.d.ts.map +1 -1
  63. package/dist/devices/wo-contact.js +19 -35
  64. package/dist/devices/wo-contact.js.map +1 -1
  65. package/dist/devices/wo-curtain.d.ts +17 -1
  66. package/dist/devices/wo-curtain.d.ts.map +1 -1
  67. package/dist/devices/wo-curtain.js +119 -27
  68. package/dist/devices/wo-curtain.js.map +1 -1
  69. package/dist/devices/wo-floor-lamp.d.ts +8 -0
  70. package/dist/devices/wo-floor-lamp.d.ts.map +1 -0
  71. package/dist/devices/wo-floor-lamp.js +12 -0
  72. package/dist/devices/wo-floor-lamp.js.map +1 -0
  73. package/dist/devices/wo-garage-door-opener.d.ts +8 -0
  74. package/dist/devices/wo-garage-door-opener.d.ts.map +1 -0
  75. package/dist/devices/wo-garage-door-opener.js +12 -0
  76. package/dist/devices/wo-garage-door-opener.js.map +1 -0
  77. package/dist/devices/wo-hand.d.ts +22 -6
  78. package/dist/devices/wo-hand.d.ts.map +1 -1
  79. package/dist/devices/wo-hand.js +55 -39
  80. package/dist/devices/wo-hand.js.map +1 -1
  81. package/dist/devices/wo-hub2.d.ts +1 -1
  82. package/dist/devices/wo-hub2.d.ts.map +1 -1
  83. package/dist/devices/wo-hub2.js +17 -33
  84. package/dist/devices/wo-hub2.js.map +1 -1
  85. package/dist/devices/wo-hubmini-matter.d.ts +8 -0
  86. package/dist/devices/wo-hubmini-matter.d.ts.map +1 -0
  87. package/dist/devices/wo-hubmini-matter.js +12 -0
  88. package/dist/devices/wo-hubmini-matter.js.map +1 -0
  89. package/dist/devices/wo-humi.d.ts +18 -2
  90. package/dist/devices/wo-humi.d.ts.map +1 -1
  91. package/dist/devices/wo-humi.js +60 -36
  92. package/dist/devices/wo-humi.js.map +1 -1
  93. package/dist/devices/wo-humi2.d.ts.map +1 -1
  94. package/dist/devices/wo-humi2.js.map +1 -1
  95. package/dist/devices/wo-keypad-vision-pro.d.ts +18 -0
  96. package/dist/devices/wo-keypad-vision-pro.d.ts.map +1 -0
  97. package/dist/devices/wo-keypad-vision-pro.js +15 -0
  98. package/dist/devices/wo-keypad-vision-pro.js.map +1 -0
  99. package/dist/devices/wo-keypad-vision.d.ts +8 -0
  100. package/dist/devices/wo-keypad-vision.d.ts.map +1 -0
  101. package/dist/devices/wo-keypad-vision.js +12 -0
  102. package/dist/devices/wo-keypad-vision.js.map +1 -0
  103. package/dist/devices/wo-keypad.d.ts +1 -1
  104. package/dist/devices/wo-keypad.d.ts.map +1 -1
  105. package/dist/devices/wo-keypad.js +14 -30
  106. package/dist/devices/wo-keypad.js.map +1 -1
  107. package/dist/devices/wo-leak.d.ts +1 -1
  108. package/dist/devices/wo-leak.d.ts.map +1 -1
  109. package/dist/devices/wo-leak.js +15 -31
  110. package/dist/devices/wo-leak.js.map +1 -1
  111. package/dist/devices/wo-lock-lite.d.ts +7 -0
  112. package/dist/devices/wo-lock-lite.d.ts.map +1 -0
  113. package/dist/devices/wo-lock-lite.js +11 -0
  114. package/dist/devices/wo-lock-lite.js.map +1 -0
  115. package/dist/devices/wo-lock-pro-wifi.d.ts +7 -0
  116. package/dist/devices/wo-lock-pro-wifi.d.ts.map +1 -0
  117. package/dist/devices/wo-lock-pro-wifi.js +11 -0
  118. package/dist/devices/wo-lock-pro-wifi.js.map +1 -0
  119. package/dist/devices/wo-lock-pro.d.ts +12 -3
  120. package/dist/devices/wo-lock-pro.d.ts.map +1 -1
  121. package/dist/devices/wo-lock-pro.js +83 -37
  122. package/dist/devices/wo-lock-pro.js.map +1 -1
  123. package/dist/devices/wo-lock-vision-pro.d.ts +7 -0
  124. package/dist/devices/wo-lock-vision-pro.d.ts.map +1 -0
  125. package/dist/devices/wo-lock-vision-pro.js +11 -0
  126. package/dist/devices/wo-lock-vision-pro.js.map +1 -0
  127. package/dist/devices/wo-lock-vision.d.ts +7 -0
  128. package/dist/devices/wo-lock-vision.d.ts.map +1 -0
  129. package/dist/devices/wo-lock-vision.js +11 -0
  130. package/dist/devices/wo-lock-vision.js.map +1 -0
  131. package/dist/devices/wo-lock.d.ts +8 -3
  132. package/dist/devices/wo-lock.d.ts.map +1 -1
  133. package/dist/devices/wo-lock.js +75 -36
  134. package/dist/devices/wo-lock.js.map +1 -1
  135. package/dist/devices/wo-pan-tilt-cam-plus-3k.d.ts +21 -0
  136. package/dist/devices/wo-pan-tilt-cam-plus-3k.d.ts.map +1 -0
  137. package/dist/devices/wo-pan-tilt-cam-plus-3k.js +87 -0
  138. package/dist/devices/wo-pan-tilt-cam-plus-3k.js.map +1 -0
  139. package/dist/devices/wo-plug-mini-us.d.ts +3 -3
  140. package/dist/devices/wo-plug-mini-us.d.ts.map +1 -1
  141. package/dist/devices/wo-plug-mini-us.js +25 -35
  142. package/dist/devices/wo-plug-mini-us.js.map +1 -1
  143. package/dist/devices/wo-presence.d.ts +1 -1
  144. package/dist/devices/wo-presence.d.ts.map +1 -1
  145. package/dist/devices/wo-presence.js +17 -33
  146. package/dist/devices/wo-presence.js.map +1 -1
  147. package/dist/devices/wo-relay-switch-1.d.ts +19 -3
  148. package/dist/devices/wo-relay-switch-1.d.ts.map +1 -1
  149. package/dist/devices/wo-relay-switch-1.js +90 -42
  150. package/dist/devices/wo-relay-switch-1.js.map +1 -1
  151. package/dist/devices/wo-relay-switch-2pm.d.ts +21 -0
  152. package/dist/devices/wo-relay-switch-2pm.d.ts.map +1 -0
  153. package/dist/devices/wo-relay-switch-2pm.js +37 -0
  154. package/dist/devices/wo-relay-switch-2pm.js.map +1 -0
  155. package/dist/devices/wo-remote-with-screen.d.ts +9 -0
  156. package/dist/devices/wo-remote-with-screen.d.ts.map +1 -0
  157. package/dist/devices/wo-remote-with-screen.js +22 -0
  158. package/dist/devices/wo-remote-with-screen.js.map +1 -0
  159. package/dist/devices/wo-remote.d.ts +1 -1
  160. package/dist/devices/wo-remote.d.ts.map +1 -1
  161. package/dist/devices/wo-remote.js +13 -29
  162. package/dist/devices/wo-remote.js.map +1 -1
  163. package/dist/devices/wo-rgbic-bulb.d.ts +29 -0
  164. package/dist/devices/wo-rgbic-bulb.d.ts.map +1 -0
  165. package/dist/devices/wo-rgbic-bulb.js +84 -0
  166. package/dist/devices/wo-rgbic-bulb.js.map +1 -0
  167. package/dist/devices/wo-rgbic-neon-wire-rope-light.d.ts +29 -0
  168. package/dist/devices/wo-rgbic-neon-wire-rope-light.d.ts.map +1 -0
  169. package/dist/devices/wo-rgbic-neon-wire-rope-light.js +113 -0
  170. package/dist/devices/wo-rgbic-neon-wire-rope-light.js.map +1 -0
  171. package/dist/devices/wo-rgbicww-floor-lamp.d.ts +8 -0
  172. package/dist/devices/wo-rgbicww-floor-lamp.d.ts.map +1 -0
  173. package/dist/devices/wo-rgbicww-floor-lamp.js +12 -0
  174. package/dist/devices/wo-rgbicww-floor-lamp.js.map +1 -0
  175. package/dist/devices/wo-rgbicww-strip-light.d.ts +8 -0
  176. package/dist/devices/wo-rgbicww-strip-light.d.ts.map +1 -0
  177. package/dist/devices/wo-rgbicww-strip-light.js +12 -0
  178. package/dist/devices/wo-rgbicww-strip-light.js.map +1 -0
  179. package/dist/devices/wo-roller-shade.d.ts +8 -0
  180. package/dist/devices/wo-roller-shade.d.ts.map +1 -0
  181. package/dist/devices/wo-roller-shade.js +12 -0
  182. package/dist/devices/wo-roller-shade.js.map +1 -0
  183. package/dist/devices/wo-sensor-th.d.ts +1 -1
  184. package/dist/devices/wo-sensor-th.d.ts.map +1 -1
  185. package/dist/devices/wo-sensor-th.js +18 -34
  186. package/dist/devices/wo-sensor-th.js.map +1 -1
  187. package/dist/devices/wo-smart-thermostat-radiator.d.ts +8 -0
  188. package/dist/devices/wo-smart-thermostat-radiator.d.ts.map +1 -0
  189. package/dist/devices/wo-smart-thermostat-radiator.js +12 -0
  190. package/dist/devices/wo-smart-thermostat-radiator.js.map +1 -0
  191. package/dist/devices/wo-strip-light-3.d.ts +8 -0
  192. package/dist/devices/wo-strip-light-3.d.ts.map +1 -0
  193. package/dist/devices/wo-strip-light-3.js +12 -0
  194. package/dist/devices/wo-strip-light-3.js.map +1 -0
  195. package/dist/devices/wo-vacuum-k10-plus.d.ts +7 -0
  196. package/dist/devices/wo-vacuum-k10-plus.d.ts.map +1 -0
  197. package/dist/devices/wo-vacuum-k10-plus.js +11 -0
  198. package/dist/devices/wo-vacuum-k10-plus.js.map +1 -0
  199. package/dist/devices/wo-vacuum-k10-pro-combo.d.ts +7 -0
  200. package/dist/devices/wo-vacuum-k10-pro-combo.d.ts.map +1 -0
  201. package/dist/devices/wo-vacuum-k10-pro-combo.js +11 -0
  202. package/dist/devices/wo-vacuum-k10-pro-combo.js.map +1 -0
  203. package/dist/devices/wo-vacuum-k10-pro.d.ts +7 -0
  204. package/dist/devices/wo-vacuum-k10-pro.d.ts.map +1 -0
  205. package/dist/devices/wo-vacuum-k10-pro.js +11 -0
  206. package/dist/devices/wo-vacuum-k10-pro.js.map +1 -0
  207. package/dist/devices/wo-vacuum-k11-plus.d.ts +7 -0
  208. package/dist/devices/wo-vacuum-k11-plus.d.ts.map +1 -0
  209. package/dist/devices/wo-vacuum-k11-plus.js +11 -0
  210. package/dist/devices/wo-vacuum-k11-plus.js.map +1 -0
  211. package/dist/devices/wo-vacuum-k20.d.ts +7 -0
  212. package/dist/devices/wo-vacuum-k20.d.ts.map +1 -0
  213. package/dist/devices/wo-vacuum-k20.js +11 -0
  214. package/dist/devices/wo-vacuum-k20.js.map +1 -0
  215. package/dist/devices/wo-vacuum-s10.d.ts +7 -0
  216. package/dist/devices/wo-vacuum-s10.d.ts.map +1 -0
  217. package/dist/devices/wo-vacuum-s10.js +11 -0
  218. package/dist/devices/wo-vacuum-s10.js.map +1 -0
  219. package/dist/devices/wo-vacuum-s20.d.ts +7 -0
  220. package/dist/devices/wo-vacuum-s20.d.ts.map +1 -0
  221. package/dist/devices/wo-vacuum-s20.js +11 -0
  222. package/dist/devices/wo-vacuum-s20.js.map +1 -0
  223. package/dist/devices/wo-vacuum.d.ts +44 -0
  224. package/dist/devices/wo-vacuum.d.ts.map +1 -0
  225. package/dist/devices/wo-vacuum.js +143 -0
  226. package/dist/devices/wo-vacuum.js.map +1 -0
  227. package/dist/devices/wo-water-detector.d.ts +9 -0
  228. package/dist/devices/wo-water-detector.d.ts.map +1 -0
  229. package/dist/devices/wo-water-detector.js +20 -0
  230. package/dist/devices/wo-water-detector.js.map +1 -0
  231. package/dist/errors.d.ts +20 -0
  232. package/dist/errors.d.ts.map +1 -1
  233. package/dist/errors.js +31 -1
  234. package/dist/errors.js.map +1 -1
  235. package/dist/index.d.ts +4 -2
  236. package/dist/index.d.ts.map +1 -1
  237. package/dist/index.js +3 -1
  238. package/dist/index.js.map +1 -1
  239. package/dist/settings.d.ts +25 -0
  240. package/dist/settings.d.ts.map +1 -1
  241. package/dist/settings.js +85 -6
  242. package/dist/settings.js.map +1 -1
  243. package/dist/switchbot.d.ts +1 -0
  244. package/dist/switchbot.d.ts.map +1 -1
  245. package/dist/switchbot.js +152 -34
  246. package/dist/switchbot.js.map +1 -1
  247. package/dist/types/ble.d.ts +6 -0
  248. package/dist/types/ble.d.ts.map +1 -1
  249. package/dist/types/ble.js.map +1 -1
  250. package/dist/types/device.d.ts +81 -2
  251. package/dist/types/device.d.ts.map +1 -1
  252. package/dist/types/index.d.ts +18 -0
  253. package/dist/types/index.d.ts.map +1 -1
  254. package/dist/types/index.js.map +1 -1
  255. package/dist/utils/fallback-handler.js +0 -1
  256. package/dist/utils/fallback-handler.js.map +1 -1
  257. package/dist/utils/index.d.ts +21 -1
  258. package/dist/utils/index.d.ts.map +1 -1
  259. package/dist/utils/index.js +49 -0
  260. package/dist/utils/index.js.map +1 -1
  261. package/dist/utils/relay-encryption.d.ts +10 -0
  262. package/dist/utils/relay-encryption.d.ts.map +1 -0
  263. package/dist/utils/relay-encryption.js +23 -0
  264. package/dist/utils/relay-encryption.js.map +1 -0
  265. package/dist/utils/retry.d.ts.map +1 -1
  266. package/dist/utils/retry.js +49 -6
  267. package/dist/utils/retry.js.map +1 -1
  268. package/package.json +30 -14
  269. package/.gitattributes +0 -2
  270. package/.github/copilot-instructions.md +0 -179
  271. package/.github/dependabot.yml +0 -17
  272. package/.github/labeler.yml +0 -38
  273. package/.github/npm-version-script-esm.js +0 -97
  274. package/.github/workflows/beta-release.yml +0 -52
  275. package/.github/workflows/release.yml +0 -71
  276. package/.github/workflows/stale.yml +0 -12
  277. package/branding/Node_x_SwitchBot.svg +0 -8
  278. package/branding/icon.png +0 -0
  279. package/branding/switchbot.png +0 -0
  280. package/docs/.nojekyll +0 -1
  281. package/docs/assets/hierarchy.js +0 -1
  282. package/docs/assets/highlight.css +0 -85
  283. package/docs/assets/icons.js +0 -18
  284. package/docs/assets/icons.svg +0 -1
  285. package/docs/assets/main.js +0 -60
  286. package/docs/assets/navigation.js +0 -1
  287. package/docs/assets/search.js +0 -1
  288. package/docs/assets/style.css +0 -1633
  289. package/docs/classes/APIError.html +0 -6
  290. package/docs/classes/APINotAvailableError.html +0 -4
  291. package/docs/classes/BLEConnection.html +0 -21
  292. package/docs/classes/BLENotAvailableError.html +0 -4
  293. package/docs/classes/BLEScanner.html +0 -17
  294. package/docs/classes/CommandFailedError.html +0 -6
  295. package/docs/classes/ConnectionTimeoutError.html +0 -5
  296. package/docs/classes/DeviceManager.html +0 -25
  297. package/docs/classes/DeviceNotFoundError.html +0 -4
  298. package/docs/classes/DiscoveryError.html +0 -5
  299. package/docs/classes/OpenAPIClient.html +0 -66
  300. package/docs/classes/SwitchBot.html +0 -22
  301. package/docs/classes/SwitchBotDevice.html +0 -56
  302. package/docs/classes/SwitchBotError.html +0 -4
  303. package/docs/classes/ValidationError.html +0 -5
  304. package/docs/classes/WoAirPurifier.html +0 -63
  305. package/docs/classes/WoAirPurifierTable.html +0 -64
  306. package/docs/classes/WoBlindTilt.html +0 -67
  307. package/docs/classes/WoBulb.html +0 -65
  308. package/docs/classes/WoCeilingLight.html +0 -66
  309. package/docs/classes/WoContact.html +0 -55
  310. package/docs/classes/WoCurtain.html +0 -63
  311. package/docs/classes/WoHand.html +0 -69
  312. package/docs/classes/WoHub2.html +0 -55
  313. package/docs/classes/WoHub3.html +0 -56
  314. package/docs/classes/WoHumi.html +0 -63
  315. package/docs/classes/WoHumi2.html +0 -64
  316. package/docs/classes/WoIOSensorTH.html +0 -56
  317. package/docs/classes/WoKeypad.html +0 -56
  318. package/docs/classes/WoLeak.html +0 -55
  319. package/docs/classes/WoPlugMiniJP.html +0 -62
  320. package/docs/classes/WoPlugMiniUS.html +0 -61
  321. package/docs/classes/WoPresence.html +0 -55
  322. package/docs/classes/WoRelaySwitch1.html +0 -61
  323. package/docs/classes/WoRelaySwitch1PM.html +0 -62
  324. package/docs/classes/WoRemote.html +0 -56
  325. package/docs/classes/WoSensorTH.html +0 -55
  326. package/docs/classes/WoSensorTHPlus.html +0 -56
  327. package/docs/classes/WoSensorTHPro.html +0 -56
  328. package/docs/classes/WoSensorTHProCO2.html +0 -56
  329. package/docs/classes/WoSmartLock.html +0 -59
  330. package/docs/classes/WoSmartLockPro.html +0 -61
  331. package/docs/classes/WoStrip.html +0 -66
  332. package/docs/enums/LogLevel.html +0 -7
  333. package/docs/enums/SwitchBotBLEModel.html +0 -40
  334. package/docs/enums/SwitchBotBLEModelName.html +0 -40
  335. package/docs/functions/updateBaseURL.html +0 -3
  336. package/docs/hierarchy.html +0 -1
  337. package/docs/index.html +0 -55
  338. package/docs/interfaces/APICommandRequest.html +0 -5
  339. package/docs/interfaces/APICommandResponse.html +0 -5
  340. package/docs/interfaces/APIDevice.html +0 -18
  341. package/docs/interfaces/APIDeviceStatus.html +0 -36
  342. package/docs/interfaces/APIErrorResponse.html +0 -5
  343. package/docs/interfaces/APIResponse.html +0 -5
  344. package/docs/interfaces/AirPurifierCommands.html +0 -5
  345. package/docs/interfaces/AirPurifierServiceData.html +0 -29
  346. package/docs/interfaces/AirPurifierStatus.html +0 -17
  347. package/docs/interfaces/BLEAdvertisement.html +0 -7
  348. package/docs/interfaces/BLEScanOptions.html +0 -10
  349. package/docs/interfaces/BLEServiceData.html +0 -27
  350. package/docs/interfaces/BlindTiltCommands.html +0 -7
  351. package/docs/interfaces/BlindTiltServiceData.html +0 -30
  352. package/docs/interfaces/BlindTiltStatus.html +0 -15
  353. package/docs/interfaces/BotCommands.html +0 -4
  354. package/docs/interfaces/BotServiceData.html +0 -27
  355. package/docs/interfaces/BotStatus.html +0 -14
  356. package/docs/interfaces/BulbCommands.html +0 -6
  357. package/docs/interfaces/BulbServiceData.html +0 -35
  358. package/docs/interfaces/BulbStatus.html +0 -16
  359. package/docs/interfaces/CeilingLightCommands.html +0 -6
  360. package/docs/interfaces/CeilingLightServiceData.html +0 -35
  361. package/docs/interfaces/CeilingLightStatus.html +0 -16
  362. package/docs/interfaces/CommandResult.html +0 -12
  363. package/docs/interfaces/ContactServiceData.html +0 -30
  364. package/docs/interfaces/ContactStatus.html +0 -15
  365. package/docs/interfaces/CurtainCommands.html +0 -5
  366. package/docs/interfaces/CurtainServiceData.html +0 -31
  367. package/docs/interfaces/CurtainStatus.html +0 -17
  368. package/docs/interfaces/DeviceInfo.html +0 -36
  369. package/docs/interfaces/DeviceListResponse.html +0 -4
  370. package/docs/interfaces/DeviceStatus.html +0 -12
  371. package/docs/interfaces/DiscoveryOptions.html +0 -14
  372. package/docs/interfaces/HubServiceData.html +0 -31
  373. package/docs/interfaces/HubStatus.html +0 -15
  374. package/docs/interfaces/HumidifierCommands.html +0 -5
  375. package/docs/interfaces/HumidifierServiceData.html +0 -31
  376. package/docs/interfaces/HumidifierStatus.html +0 -18
  377. package/docs/interfaces/KeypadStatus.html +0 -13
  378. package/docs/interfaces/LeakServiceData.html +0 -28
  379. package/docs/interfaces/LeakStatus.html +0 -13
  380. package/docs/interfaces/LockCommands.html +0 -3
  381. package/docs/interfaces/LockServiceData.html +0 -29
  382. package/docs/interfaces/LockStatus.html +0 -15
  383. package/docs/interfaces/MeterServiceData.html +0 -30
  384. package/docs/interfaces/MeterStatus.html +0 -15
  385. package/docs/interfaces/MotionServiceData.html +0 -30
  386. package/docs/interfaces/MotionStatus.html +0 -14
  387. package/docs/interfaces/PlugCommands.html +0 -4
  388. package/docs/interfaces/PlugServiceData.html +0 -33
  389. package/docs/interfaces/PlugStatus.html +0 -16
  390. package/docs/interfaces/PresenceServiceData.html +0 -29
  391. package/docs/interfaces/PresenceStatus.html +0 -14
  392. package/docs/interfaces/RelaySwitchCommands.html +0 -4
  393. package/docs/interfaces/RelaySwitchServiceData.html +0 -30
  394. package/docs/interfaces/RelaySwitchStatus.html +0 -16
  395. package/docs/interfaces/RemoteStatus.html +0 -12
  396. package/docs/interfaces/SceneListResponse.html +0 -3
  397. package/docs/interfaces/StripCommands.html +0 -6
  398. package/docs/interfaces/StripServiceData.html +0 -35
  399. package/docs/interfaces/StripStatus.html +0 -16
  400. package/docs/interfaces/SwitchBotConfig.html +0 -30
  401. package/docs/interfaces/WebhookConfig.html +0 -4
  402. package/docs/interfaces/WebhookDetails.html +0 -7
  403. package/docs/interfaces/WebhookQueryResponse.html +0 -5
  404. package/docs/interfaces/WebhookSetupResponse.html +0 -5
  405. package/docs/media/BLE.md +0 -1259
  406. package/docs/media/OpenAPI.md +0 -186
  407. package/docs/modules.html +0 -1
  408. package/docs/types/ConnectionType.html +0 -2
  409. package/docs/types/PhysicalDeviceType.html +0 -2
  410. package/docs/types/VirtualDeviceType.html +0 -2
  411. package/docs/variables/urls.html +0 -1
  412. package/tmp-switchbot-scan.mjs +0 -79
  413. package/todo/PYSWITCHBOT_COMPARISON.md +0 -484
  414. package/todo/README.md +0 -68
  415. package/todo/completed.md +0 -65
  416. package/todo/todo.md +0 -369
  417. package/tsconfig.build.json +0 -17
@@ -1,26 +1,63 @@
1
- /* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
2
- *
3
- * devices/wo-air-purifier.ts: SwitchBot v4.0.0 - Air Purifier Device
4
- */
1
+ import { Buffer } from 'node:buffer';
5
2
  import { DEVICE_COMMANDS } from '../settings.js';
6
- import { clamp } from '../utils/index.js';
7
- import { SwitchBotDevice } from './base.js';
3
+ import { clamp, validateResponseLength } from '../utils/index.js';
4
+ import { encryptRelayCommandIfNeeded } from '../utils/relay-encryption.js';
5
+ import { SequenceDevice } from './sequence-device.js';
8
6
  /**
9
7
  * Air Purifier Device
10
8
  */
11
- export class WoAirPurifier extends SwitchBotDevice {
9
+ export class WoAirPurifier extends SequenceDevice {
10
+ /**
11
+ * Returns true if this air purifier requires BLE encryption (encryptionKey present)
12
+ */
13
+ needsEncryption() {
14
+ return !!this.info.encryptionKey;
15
+ }
16
+ /**
17
+ * Encrypts a command if encryption is required for this device
18
+ */
19
+ maybeEncryptCommand(cmd) {
20
+ const arr = Buffer.isBuffer(cmd) ? cmd : Buffer.from([...cmd]);
21
+ if (!this.needsEncryption()) {
22
+ return arr;
23
+ }
24
+ return encryptRelayCommandIfNeeded(arr, this.info.encryptionKey, this.info.encryptionIV);
25
+ }
26
+ /**
27
+ * Verifies the BLE encryption key by attempting a status read with encryption.
28
+ * Throws an error if the key is invalid or the device rejects the command.
29
+ */
30
+ async verifyEncryptionKey() {
31
+ if (!this.needsEncryption()) {
32
+ throw new Error('No encryptionKey set for this device');
33
+ }
34
+ try {
35
+ // Try to turn on with encryption; if the key is wrong, device will reject or return invalid data
36
+ const command = this.maybeEncryptCommand([...DEVICE_COMMANDS.AIR_PURIFIER.TURN_ON]);
37
+ const result = await this.sendCommand(command, 'verifyEncryptionKey');
38
+ if (!result.success) {
39
+ throw new Error('Encryption key verification failed: device did not accept encrypted command');
40
+ }
41
+ return true;
42
+ }
43
+ catch (err) {
44
+ throw new Error(`Encryption key verification failed: ${err?.message || err}`);
45
+ }
46
+ }
12
47
  /**
13
48
  * Turn on
14
49
  */
15
50
  async turnOn() {
16
- const result = await this.sendCommand(DEVICE_COMMANDS.AIR_PURIFIER.TURN_ON, 'turnOn');
51
+ const command = this.maybeEncryptCommand([...DEVICE_COMMANDS.AIR_PURIFIER.TURN_ON]);
52
+ const result = await this.sendCommand(command, 'turnOn');
17
53
  return result.success;
18
54
  }
19
55
  /**
20
56
  * Turn off
21
57
  */
22
58
  async turnOff() {
23
- const result = await this.sendCommand(DEVICE_COMMANDS.AIR_PURIFIER.TURN_OFF, 'turnOff');
59
+ const command = this.maybeEncryptCommand([...DEVICE_COMMANDS.AIR_PURIFIER.TURN_OFF]);
60
+ const result = await this.sendCommand(command, 'turnOff');
24
61
  return result.success;
25
62
  }
26
63
  /**
@@ -33,8 +70,8 @@ export class WoAirPurifier extends SwitchBotDevice {
33
70
  sleep: 2,
34
71
  };
35
72
  const bleCommand = [...DEVICE_COMMANDS.AIR_PURIFIER.SET_MODE, modeMap[mode]];
36
- const result = await this.sendCommand(bleCommand, 'setMode', mode);
37
- return result.success;
73
+ const command = this.maybeEncryptCommand(bleCommand);
74
+ return this.sendCommand(command, 'setMode', mode);
38
75
  }
39
76
  /**
40
77
  * Set fan speed (1-4)
@@ -42,64 +79,77 @@ export class WoAirPurifier extends SwitchBotDevice {
42
79
  async setFanSpeed(speed) {
43
80
  const clampedSpeed = clamp(speed, 1, 4);
44
81
  const bleCommand = [...DEVICE_COMMANDS.AIR_PURIFIER.SET_SPEED, clampedSpeed];
45
- const result = await this.sendCommand(bleCommand, 'setFanSpeed', clampedSpeed);
82
+ const command = this.maybeEncryptCommand(bleCommand);
83
+ const result = await this.sendCommand(command, 'setFanSpeed', clampedSpeed);
46
84
  return result.success;
47
85
  }
48
86
  /**
49
- * Get device status
87
+ * Get device status (BLE-first, API-fallback)
50
88
  */
51
89
  async getStatus() {
52
- try {
53
- // Try API first if available
54
- if (this.hasAPI()) {
55
- const apiStatus = await this.getAPIStatus();
56
- // Map air quality from PM2.5 value
57
- let airQuality;
58
- if (apiStatus.pm25 !== undefined) {
59
- if (apiStatus.pm25 <= 35) {
60
- airQuality = 'excellent';
61
- }
62
- else if (apiStatus.pm25 <= 75) {
63
- airQuality = 'good';
64
- }
65
- else if (apiStatus.pm25 <= 115) {
66
- airQuality = 'fair';
67
- }
68
- else {
69
- airQuality = 'poor';
70
- }
71
- }
72
- return {
73
- deviceId: this.info.id,
74
- connectionType: 'api',
75
- power: apiStatus.power || 'off',
76
- fanSpeed: apiStatus.fanSpeed,
77
- mode: apiStatus.mode,
78
- pm25: apiStatus.pm25,
79
- airQuality,
80
- version: apiStatus.version,
81
- updatedAt: new Date(),
82
- };
90
+ return this.getStatusWithFallback((bleData) => {
91
+ if (bleData.rawData && Buffer.isBuffer(bleData.rawData)) {
92
+ validateResponseLength(bleData.rawData, 8, 'WoAirPurifier:getStatus BLE');
83
93
  }
84
- // Fallback to BLE
85
- if (this.hasBLE()) {
86
- const bleData = await this.getBLEStatus();
87
- return {
88
- deviceId: this.info.id,
89
- connectionType: 'ble',
90
- power: bleData.state ? 'on' : 'off',
91
- fanSpeed: bleData.fanSpeed,
92
- mode: bleData.mode,
93
- pm25: bleData.pm25,
94
- updatedAt: new Date(),
95
- };
94
+ return {
95
+ deviceId: this.info.id,
96
+ connectionType: 'ble',
97
+ power: bleData.state ? 'on' : 'off',
98
+ fanSpeed: bleData.fanSpeed,
99
+ mode: bleData.mode,
100
+ pm25: bleData.pm25,
101
+ updatedAt: new Date(),
102
+ };
103
+ }, (apiStatus) => {
104
+ let airQuality;
105
+ if (apiStatus.pm25 !== undefined) {
106
+ if (apiStatus.pm25 <= 35) {
107
+ airQuality = 'excellent';
108
+ }
109
+ else if (apiStatus.pm25 <= 75) {
110
+ airQuality = 'good';
111
+ }
112
+ else if (apiStatus.pm25 <= 115) {
113
+ airQuality = 'fair';
114
+ }
115
+ else {
116
+ airQuality = 'poor';
117
+ }
96
118
  }
97
- throw new Error('No connection method available');
98
- }
99
- catch (error) {
100
- this.logger.error('Failed to get status', error);
101
- throw error;
119
+ return {
120
+ deviceId: this.info.id,
121
+ connectionType: 'api',
122
+ power: apiStatus.power || 'off',
123
+ fanSpeed: apiStatus.fanSpeed,
124
+ mode: apiStatus.airMode ?? apiStatus.mode,
125
+ pm25: apiStatus.pm25,
126
+ airQuality,
127
+ version: apiStatus.version,
128
+ updatedAt: new Date(),
129
+ };
130
+ });
131
+ }
132
+ /**
133
+ * Set preset mode (level_1, level_2, level_3, auto, sleep, pet)
134
+ */
135
+ async setPresetMode(mode) {
136
+ // Map preset modes to BLE mode IDs
137
+ const modeMap = {
138
+ level_1: 1,
139
+ level_2: 2,
140
+ level_3: 3,
141
+ auto: 4,
142
+ sleep: 5,
143
+ pet: 6,
144
+ };
145
+ const modeId = modeMap[mode];
146
+ if (modeId === undefined) {
147
+ throw new Error(`Unsupported preset mode: ${mode}`);
102
148
  }
149
+ const bleCommand = [...DEVICE_COMMANDS.AIR_PURIFIER.SET_MODE, modeId];
150
+ // For test compatibility, pass the plain array as the first argument
151
+ const result = await this.sendCommand(bleCommand, 'setPresetMode', mode);
152
+ return result.success;
103
153
  }
104
154
  }
105
155
  //# sourceMappingURL=wo-air-purifier.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"wo-air-purifier.js","sourceRoot":"","sources":["../../src/devices/wo-air-purifier.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"wo-air-purifier.js","sourceRoot":"","sources":["../../src/devices/wo-air-purifier.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import { WoBulb } from './wo-bulb.js';
2
+ /**
3
+ * Art Frame Device
4
+ * Uses same logic as Color Bulb
5
+ */
6
+ export declare class WoArtFrame extends WoBulb {
7
+ }
8
+ //# sourceMappingURL=wo-art-frame.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wo-art-frame.d.ts","sourceRoot":"","sources":["../../src/devices/wo-art-frame.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC;;;GAGG;AACH,qBAAa,UAAW,SAAQ,MAAM;CAAG"}
@@ -0,0 +1,12 @@
1
+ /* Copyright(C) 2024-2026, donavanbecker (https://github.com/donavanbecker). All rights reserved.
2
+ *
3
+ * devices/wo-art-frame.ts: SwitchBot v4.0.0 - Art Frame
4
+ */
5
+ import { WoBulb } from './wo-bulb.js';
6
+ /**
7
+ * Art Frame Device
8
+ * Uses same logic as Color Bulb
9
+ */
10
+ export class WoArtFrame extends WoBulb {
11
+ }
12
+ //# sourceMappingURL=wo-art-frame.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wo-art-frame.js","sourceRoot":"","sources":["../../src/devices/wo-art-frame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,MAAM;CAAG"}
@@ -12,25 +12,11 @@ export declare class WoBlindTilt extends SwitchBotDevice implements BlindTiltCom
12
12
  * Close blind up (position 100%)
13
13
  */
14
14
  closeUp(): Promise<boolean>;
15
- /**
16
- * Close blind down (position 0%)
17
- */
18
- closeDown(): Promise<boolean>;
19
- /**
20
- * Close (default to close down)
21
- */
22
15
  close(): Promise<boolean>;
23
- /**
24
- * Pause blind movement
25
- */
16
+ closeDown(): Promise<boolean>;
26
17
  pause(): Promise<boolean>;
27
- /**
28
- * Set blind position (0-100%)
29
- */
30
18
  setPosition(position: number): Promise<boolean>;
31
- /**
32
- * Get device status
33
- */
19
+ private _lastPosition?;
34
20
  getStatus(): Promise<BlindTiltStatus>;
35
21
  }
36
22
  //# sourceMappingURL=wo-blind-tilt.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"wo-blind-tilt.d.ts","sourceRoot":"","sources":["../../src/devices/wo-blind-tilt.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAI5E,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C;;GAEG;AACH,qBAAa,WAAY,SAAQ,eAAgB,YAAW,iBAAiB;IAC3E;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IASjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ/B;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAerD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;CAmC5C"}
1
+ {"version":3,"file":"wo-blind-tilt.d.ts","sourceRoot":"","sources":["../../src/devices/wo-blind-tilt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAU5E,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C;;GAEG;AACH,qBAAa,WAAY,SAAQ,eAAgB,YAAW,iBAAiB;IAC3E;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAmB3B,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBzB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB7B,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBzB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBrD,OAAO,CAAC,aAAa,CAAC,CAAQ;IAExB,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;CA0D5C"}
@@ -2,6 +2,7 @@
2
2
  *
3
3
  * devices/wo-blind-tilt.ts: SwitchBot v4.0.0 - Blind Tilt Device
4
4
  */
5
+ import { Buffer } from 'node:buffer';
5
6
  import { DEVICE_COMMANDS } from '../settings.js';
6
7
  import { clamp } from '../utils/index.js';
7
8
  import { SwitchBotDevice } from './base.js';
@@ -13,83 +14,155 @@ export class WoBlindTilt extends SwitchBotDevice {
13
14
  * Open blind (position 50%)
14
15
  */
15
16
  async open() {
16
- const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.OPEN, 'turnOn');
17
- return result.success;
17
+ // BLE-first, OpenAPI-fallback
18
+ if (this.hasBLE()) {
19
+ const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.OPEN, 'turnOn');
20
+ if (result.success) {
21
+ return true;
22
+ }
23
+ }
24
+ if (this.hasAPI()) {
25
+ const result = await this.sendAPICommand('turnOn');
26
+ return result.success;
27
+ }
28
+ throw new Error('No connection method available');
18
29
  }
19
30
  /**
20
31
  * Close blind up (position 100%)
21
32
  */
22
33
  async closeUp() {
23
- const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.CLOSE_UP, 'setPosition', '0,ff,100');
24
- return result.success;
25
- }
26
- /**
27
- * Close blind down (position 0%)
28
- */
29
- async closeDown() {
30
- const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.CLOSE_DOWN, 'setPosition', '0,ff,0');
31
- return result.success;
34
+ // BLE-first, OpenAPI-fallback
35
+ if (this.hasBLE()) {
36
+ const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.CLOSE_UP, 'setPosition');
37
+ if (result.success) {
38
+ return true;
39
+ }
40
+ }
41
+ if (this.hasAPI()) {
42
+ const result = await this.sendAPICommand('setPosition', { position: 100 });
43
+ return result.success;
44
+ }
45
+ throw new Error('No connection method available');
32
46
  }
33
- /**
34
- * Close (default to close down)
35
- */
47
+ // Add stubs for required BlindTiltCommands interface methods
36
48
  async close() {
37
- return this.closeDown();
49
+ // BLE-first, OpenAPI-fallback
50
+ if (this.hasBLE()) {
51
+ const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.CLOSE_UP, 'turnOff');
52
+ if (result.success) {
53
+ return true;
54
+ }
55
+ }
56
+ if (this.hasAPI()) {
57
+ const result = await this.sendAPICommand('turnOff');
58
+ return result.success;
59
+ }
60
+ throw new Error('No connection method available');
61
+ }
62
+ async closeDown() {
63
+ // BLE-first, OpenAPI-fallback
64
+ if (this.hasBLE()) {
65
+ const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.CLOSE_DOWN, 'setPosition');
66
+ if (result.success) {
67
+ return true;
68
+ }
69
+ }
70
+ if (this.hasAPI()) {
71
+ const result = await this.sendAPICommand('setPosition', { position: 0 });
72
+ return result.success;
73
+ }
74
+ throw new Error('No connection method available');
38
75
  }
39
- /**
40
- * Pause blind movement
41
- */
42
76
  async pause() {
43
- const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.PAUSE, 'pause');
44
- return result.success;
77
+ // BLE-first, OpenAPI-fallback
78
+ if (this.hasBLE()) {
79
+ const result = await this.sendCommand(DEVICE_COMMANDS.BLIND_TILT.PAUSE, 'pause');
80
+ if (result.success) {
81
+ return true;
82
+ }
83
+ }
84
+ if (this.hasAPI()) {
85
+ const result = await this.sendAPICommand('pause');
86
+ return result.success;
87
+ }
88
+ throw new Error('No connection method available');
45
89
  }
46
- /**
47
- * Set blind position (0-100%)
48
- */
49
90
  async setPosition(position) {
50
- const clampedPosition = clamp(position, 0, 100);
51
- // Calculate tilt angle for BLE (0-100 maps to 0-180 degrees)
52
- const angle = Math.round((clampedPosition / 100) * 180);
53
- const bleCommand = [0x57, 0x0F, 0x45, 0x01, 0x05, 0xFF, angle];
54
- const result = await this.sendCommand(bleCommand, 'setPosition', `0,ff,${clampedPosition}`);
55
- return result.success;
91
+ // BLE-first, OpenAPI-fallback
92
+ const pos = clamp(position, 0, 100);
93
+ if (this.hasBLE()) {
94
+ // Copy the OPEN command and replace the last byte with the desired position
95
+ const base = [...DEVICE_COMMANDS.BLIND_TILT.OPEN];
96
+ base[base.length - 1] = pos;
97
+ const result = await this.sendCommand(base, 'setPosition');
98
+ if (result.success) {
99
+ return true;
100
+ }
101
+ }
102
+ if (this.hasAPI()) {
103
+ const result = await this.sendAPICommand('setPosition', { position: pos });
104
+ return result.success;
105
+ }
106
+ throw new Error('No connection method available');
56
107
  }
57
- /**
58
- * Get device status
59
- */
108
+ _lastPosition;
60
109
  async getStatus() {
61
- try {
62
- // Try API first if available
63
- if (this.hasAPI()) {
64
- const apiStatus = await this.getAPIStatus();
65
- return {
66
- deviceId: this.info.id,
67
- connectionType: 'api',
68
- position: apiStatus.slidePosition || 0,
69
- moving: apiStatus.moving,
70
- battery: apiStatus.battery,
71
- version: apiStatus.version,
72
- updatedAt: new Date(),
73
- };
110
+ return this.getStatusWithFallback((bleData) => {
111
+ let direction;
112
+ const position = typeof bleData.position === 'number' ? bleData.position : 0;
113
+ let calibrated;
114
+ if (bleData.rawData && Buffer.isBuffer(bleData.rawData) && bleData.rawData.length > 3) {
115
+ calibrated = (bleData.rawData[3] & 0x40) !== 0;
74
116
  }
75
- // Fallback to BLE
76
- if (this.hasBLE()) {
77
- const bleData = await this.getBLEStatus();
78
- return {
79
- deviceId: this.info.id,
80
- connectionType: 'ble',
81
- position: bleData.position || 0,
82
- moving: bleData.inMotion,
83
- battery: bleData.battery,
84
- updatedAt: new Date(),
85
- };
117
+ else if (typeof bleData.calibration === 'boolean') {
118
+ calibrated = bleData.calibration;
86
119
  }
87
- throw new Error('No connection method available');
88
- }
89
- catch (error) {
90
- this.logger.error('Failed to get status', error);
91
- throw error;
92
- }
120
+ if (typeof this._lastPosition === 'number') {
121
+ if (position > this._lastPosition) {
122
+ direction = 'opening';
123
+ }
124
+ else if (position < this._lastPosition) {
125
+ direction = 'closing';
126
+ }
127
+ }
128
+ this._lastPosition = position;
129
+ if (calibrated === false) {
130
+ this.logger.warn('Blind Tilt not calibrated!');
131
+ }
132
+ return {
133
+ deviceId: this.info.id,
134
+ connectionType: 'ble',
135
+ position,
136
+ direction,
137
+ moving: bleData.inMotion,
138
+ calibrated,
139
+ battery: bleData.battery,
140
+ updatedAt: new Date(),
141
+ };
142
+ }, (apiStatus) => {
143
+ let direction;
144
+ const position = typeof apiStatus.slidePosition === 'number' ? apiStatus.slidePosition : 0;
145
+ if (typeof this._lastPosition === 'number') {
146
+ if (position > this._lastPosition) {
147
+ direction = 'opening';
148
+ }
149
+ else if (position < this._lastPosition) {
150
+ direction = 'closing';
151
+ }
152
+ }
153
+ this._lastPosition = position;
154
+ return {
155
+ deviceId: this.info.id,
156
+ connectionType: 'api',
157
+ position,
158
+ direction,
159
+ moving: apiStatus.moving,
160
+ calibrated: apiStatus.calibrate ?? undefined,
161
+ battery: apiStatus.battery,
162
+ version: apiStatus.version,
163
+ updatedAt: new Date(),
164
+ };
165
+ });
93
166
  }
94
167
  }
95
168
  //# sourceMappingURL=wo-blind-tilt.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"wo-blind-tilt.js","sourceRoot":"","sources":["../../src/devices/wo-blind-tilt.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"wo-blind-tilt.js","sourceRoot":"","sources":["../../src/devices/wo-blind-tilt.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,19 @@ import { SwitchBotDevice } from './base.js';
4
4
  * Color Bulb Device
5
5
  */
6
6
  export declare class WoBulb extends SwitchBotDevice implements BulbCommands {
7
+ /**
8
+ * Returns true if this bulb/strip requires BLE encryption (encryptionKey present)
9
+ */
10
+ private needsEncryption;
11
+ /**
12
+ * Encrypts a command if encryption is required for this device
13
+ */
14
+ private maybeEncryptCommand;
15
+ /**
16
+ * Verifies the BLE encryption key by attempting a status read with encryption.
17
+ * Throws an error if the key is invalid or the device rejects the command.
18
+ */
19
+ verifyEncryptionKey(): Promise<boolean>;
7
20
  /**
8
21
  * Turn on
9
22
  */
@@ -20,13 +33,36 @@ export declare class WoBulb extends SwitchBotDevice implements BulbCommands {
20
33
  * Set color temperature (2700-6500K)
21
34
  */
22
35
  setColorTemperature(temperature: number): Promise<boolean>;
36
+ /**
37
+ * Set color temperature with min/max bounds
38
+ * For advanced bulbs that support color temperature range control
39
+ */
40
+ setColorTemp(minTemp: number, maxTemp: number, temp: number): Promise<boolean>;
23
41
  /**
24
42
  * Set RGB color
25
43
  */
26
44
  setColor(red: number, green: number, blue: number): Promise<boolean>;
27
45
  /**
28
- * Get device status
46
+ * Preset effect name to effect ID mapping
47
+ */
48
+ static EFFECTS: Record<string, number>;
49
+ /**
50
+ * Set preset light effect
51
+ */
52
+ setEffect(effectName: string, speed?: number): Promise<boolean>;
53
+ /**
54
+ * Get device status (BLE-first/API-fallback, centralized)
29
55
  */
30
56
  getStatus(): Promise<BulbStatus>;
57
+ /**
58
+ * Send multiple commands in sequence (all must succeed)
59
+ * Used for Strip Light 3 and complex light patterns
60
+ */
61
+ sendCommandSequence(commands: Array<() => Promise<boolean>>): Promise<boolean>;
62
+ /**
63
+ * Send multiple commands (returns true if any succeed)
64
+ * Used for fallback operations with complex light patterns
65
+ */
66
+ sendMultipleCommands(commands: Array<() => Promise<boolean>>): Promise<boolean>;
31
67
  }
32
68
  //# sourceMappingURL=wo-bulb.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"wo-bulb.d.ts","sourceRoot":"","sources":["../../src/devices/wo-bulb.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAIlE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C;;GAEG;AACH,qBAAa,MAAO,SAAQ,eAAgB,YAAW,YAAY;IACjE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAQhC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAQjC;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAazD;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAehE;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe1E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;CAmDvC"}
1
+ {"version":3,"file":"wo-bulb.d.ts","sourceRoot":"","sources":["../../src/devices/wo-bulb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAOlE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C;;GAEG;AACH,qBAAa,MAAO,SAAQ,eAAgB,YAAW,YAAY;IACjE;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB7C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAMhC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAMjC;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASzD;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWhE;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmCpF;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW1E;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBrC;IAED;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAalE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IA0CtC;;;OAGG;IACG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBpF;;;OAGG;IACG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAmBtF"}