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
@@ -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":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
@@ -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;AAmID,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}
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":"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"}
1
+ {"version":3,"file":"fallback-handler.js","sourceRoot":"","sources":["../../src/utils/fallback-handler.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,25 @@
1
- import type { LogLevel } from '../types/index.js';
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":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}
@@ -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
  */
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC;;GAEG;AACH,MAAM,OAAO,MAAM;IAEE;IACT;IAFV,YACmB,IAAY,EACrB,QAAkB,CAAC;QADV,SAAI,GAAJ,IAAI,CAAQ;QACrB,UAAK,GAAL,KAAK,CAAc;IAC1B,CAAC;IAEJ,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;QACxD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;QACxD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,SAAS,GAAG,sCAAsC,CAAA;AACxD,MAAM,UAAU,GAAG,IAAI,CAAA;AACvB,MAAM,WAAW,GAAG,IAAI,CAAA;AAExB;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,mBAA6B;IAC1E,IAAI,CAAC,mBAAmB,IAAI,OAAO,mBAAmB,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,+EAA+E;IAC/E,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,2EAA2E;IAC3E,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACzB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,mDAAmD;IACnD,OAAO;QACL,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;QACvB,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC;KACzB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAiB,EACjB,YAAY,GAAG,qBAAqB;IAEpC,IAAI,aAA6B,CAAA;IAEjC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAA;QAC5D,YAAY,CAAC,aAAc,CAAC,CAAA;QAC5B,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,aAAc,CAAC,CAAA;QAC5B,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,UAKI,EAAE;IAEN,MAAM,EACJ,WAAW,GAAG,CAAC,EACf,OAAO,GAAG,IAAI,EACd,OAAO,GAAG,IAAI,EACd,OAAO,GACR,GAAG,OAAO,CAAA;IAEX,IAAI,SAA4B,CAAA;IAEhC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAA;YAE1B,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;gBACtD,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;gBAC7B,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;UAC9C,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAa,EACb,MAAc,EACd,SAAiB,EACjB,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IAC1C,MAAM,IAAI,GAAG,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,EAAE,CAAA;IAC3C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,IAAY,EAAE,QAAW;IACxD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAA;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,KAAU;IACrC,OAAO,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,GAAM;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,OAAe;IAEf,IAAI,SAAS,GAA0B,IAAI,CAAA;IAE3C,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAA;QACzB,CAAC;QACD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YACX,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,EAAE,OAAO,CAAC,CAAA;IACb,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,OAAe;IAEf,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;YAC7B,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YACX,OAAO,GAAG,GAAG,CAAA;QACf,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,oCAAoC;AACpC,OAAO,EACL,eAAe,EAEf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAA6B,mBAAmB,EAA4B,MAAM,sBAAsB,CAAA;AAC/H,OAAO,EAAwB,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACjF,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAG9B,sBAAsB,GAEvB,MAAM,uBAAuB,CAAA;AAC9B,4BAA4B;AAC5B,OAAO,EAAoB,aAAa,EAAoB,MAAM,YAAY,CAAA"}
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":"AAOA;;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;AAED;;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;IACG,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,SAAc,GACxB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAuD1B;;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"}
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"}
@@ -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`, { error: lastError.message });
62
- // Wait before retrying
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`, { error: lastError.message });
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 || new Error('Unknown error'),
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
  }
@@ -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;AAkCnC;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAQ;IACd,MAAM,CAAuB;IAErC,YAAY,SAAsB,EAAE,EAAE,QAAiB;QACrD,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC;YACpC,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,GAAG;YAC5C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;YACrC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC;YAChD,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,GAAG;SACzC,CAAA;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;IACrD,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,aAAqB;QAC1C,MAAM,gBAAgB,GAClB,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAA;QACrF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAEtE,wCAAwC;QACxC,MAAM,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QAC/E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,EAAoB,EACpB,WAAW,GAAG,WAAW;QAEzB,IAAI,SAA4B,CAAA;QAChC,IAAI,WAAW,GAAG,CAAC,CAAA;QACnB,IAAI,aAAa,GAAG,CAAC,CAAA;QAErB,KAAK,aAAa,GAAG,CAAC,EAAE,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE,CAAC;YAClF,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAA;gBACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;gBACxC,WAAW,IAAI,SAAS,CAAA;gBAExB,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;oBACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,GAAG,WAAW,yBAAyB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAClF,CAAA;gBACH,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM;oBACN,aAAa,EAAE,aAAa;oBAC5B,WAAW;iBACZ,CAAA;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;gBACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,CAAA;gBACzD,WAAW,IAAI,SAAS,CAAA;gBAExB,IAAI,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;oBAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;oBAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,GAAG,WAAW,sBAAsB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,iBAAiB,OAAO,IAAI,EACxG,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,CAC7B,CAAA;oBAED,uBAAuB;oBACvB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;gBAC5D,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,GAAG,WAAW,iBAAiB,aAAa,WAAW,EACvD,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,CAC7B,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,SAAS,IAAI,IAAI,KAAK,CAAC,eAAe,CAAC;YAC9C,aAAa,EAAE,aAAa;YAC5B,WAAW;SACZ,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,EAAoB,EACpB,WAAW,GAAG,WAAW;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;QAElD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,MAAO,CAAA;QACvB,CAAC;QAED,MAAM,MAAM,CAAC,KAAK,CAAA;IACpB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,SAAsB,EAAE,EACxB,QAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACpD,OAAO,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;AACpC,CAAC"}
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-beta.9",
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
- "lint": "eslint src/**/*.ts",
40
- "lint:fix": "eslint src/**/*.ts --fix",
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.3.17",
56
- "undici": "^7.15.0"
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": "^7.7.0",
63
- "@types/node": "^25.3.5",
64
- "@vitest/coverage-v8": "^4.0.18",
65
- "eslint": "^9.39.4",
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-import": "^2.32.0",
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.11",
71
- "typescript": "^5.9.3",
72
- "vitest": "^4.0.18"
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,2 +0,0 @@
1
- # Auto detect text files and perform LF normalization
2
- * text=auto
@@ -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