@switchbot/homebridge-switchbot 5.0.0-beta.9 → 5.0.0-beta.91

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 (448) hide show
  1. package/.github/ISSUE_TEMPLATE/e2e-verification.md +36 -0
  2. package/.github/workflows/ci.yml +32 -0
  3. package/.github/workflows/manual-e2e.yml +115 -0
  4. package/.github/workflows/release.yml +0 -4
  5. package/CHANGELOG.md +35 -0
  6. package/E2E-VERIFICATION.md +121 -0
  7. package/MIGRATION.md +44 -0
  8. package/README.md +56 -3
  9. package/config.schema.json +91 -14787
  10. package/dist/deviceFactory.d.ts +13 -0
  11. package/dist/deviceFactory.d.ts.map +1 -0
  12. package/dist/deviceFactory.js +81 -0
  13. package/dist/deviceFactory.js.map +1 -0
  14. package/dist/devices/deviceBase.d.ts +50 -0
  15. package/dist/devices/deviceBase.d.ts.map +1 -0
  16. package/dist/devices/deviceBase.js +119 -0
  17. package/dist/devices/deviceBase.js.map +1 -0
  18. package/dist/devices/genericDevice.d.ts +283 -0
  19. package/dist/devices/genericDevice.d.ts.map +1 -0
  20. package/dist/devices/genericDevice.js +1035 -0
  21. package/dist/devices/genericDevice.js.map +1 -0
  22. package/dist/homebridge-ui/public/index.html +630 -246
  23. package/dist/homebridge-ui/server.d.ts +3 -1
  24. package/dist/homebridge-ui/server.d.ts.map +1 -1
  25. package/dist/homebridge-ui/server.js +367 -36
  26. package/dist/homebridge-ui/server.js.map +1 -1
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +4 -32
  29. package/dist/index.js.map +1 -1
  30. package/dist/platform.d.ts +35 -0
  31. package/dist/platform.d.ts.map +1 -0
  32. package/dist/platform.js +514 -0
  33. package/dist/platform.js.map +1 -0
  34. package/dist/settings.d.ts +10 -249
  35. package/dist/settings.d.ts.map +1 -1
  36. package/dist/settings.js +5 -30
  37. package/dist/settings.js.map +1 -1
  38. package/dist/switchbotClient.d.ts +32 -0
  39. package/dist/switchbotClient.d.ts.map +1 -0
  40. package/dist/switchbotClient.js +194 -0
  41. package/dist/switchbotClient.js.map +1 -0
  42. package/dist/utils.d.ts +39 -50
  43. package/dist/utils.d.ts.map +1 -1
  44. package/dist/utils.js +39 -688
  45. package/dist/utils.js.map +1 -1
  46. package/docs/assets/highlight.css +14 -0
  47. package/docs/assets/icons.js +1 -1
  48. package/docs/assets/icons.svg +1 -1
  49. package/docs/assets/main.js +2 -2
  50. package/docs/assets/style.css +3 -3
  51. package/docs/index.html +77 -13
  52. package/docs/variables/default.html +1 -1
  53. package/eslint.config.js +2 -8
  54. package/package.json +21 -28
  55. package/scripts/e2e/README.md +25 -0
  56. package/scripts/e2e/curtain-e2e.sh +70 -0
  57. package/scripts/e2e/fan-e2e.sh +75 -0
  58. package/scripts/e2e/light-advanced-e2e.sh +97 -0
  59. package/scripts/e2e/light-e2e.sh +75 -0
  60. package/scripts/e2e/list-accessories.sh +19 -0
  61. package/scripts/e2e/lock-e2e.sh +65 -0
  62. package/scripts/generate-matter-maps.js +60 -0
  63. package/scripts/run-e2e-local.sh +14 -0
  64. package/src/deviceFactory.ts +122 -0
  65. package/src/devices/deviceBase.ts +141 -0
  66. package/src/devices/genericDevice.ts +965 -0
  67. package/src/homebridge-ui/public/index.html +630 -246
  68. package/src/homebridge-ui/server.ts +434 -41
  69. package/src/index.ts +4 -33
  70. package/src/platform.ts +515 -0
  71. package/src/settings.ts +12 -277
  72. package/src/switchbotClient.ts +203 -0
  73. package/src/utils.ts +45 -713
  74. package/test/accessory-restore.spec.ts +73 -0
  75. package/test/device-mapping.spec.ts +37 -0
  76. package/test/deviceFactory.spec.ts +18 -0
  77. package/test/e2e/run-e2e.spec.ts +50 -0
  78. package/test/fan-swing.spec.ts +29 -0
  79. package/test/helpers/matter-harness.ts +53 -0
  80. package/test/lock-users.spec.ts +44 -0
  81. package/test/matter-childbridge.spec.ts +55 -0
  82. package/test/matter-descriptors.spec.ts +97 -0
  83. package/test/matter-device-state.spec.ts +101 -0
  84. package/test/matter-integration.spec.ts +70 -0
  85. package/test/platform.integration.spec.ts +55 -0
  86. package/test/switchbot-client-debounce.spec.ts +131 -0
  87. package/test/switchbot-client-openapi.spec.ts +56 -0
  88. package/test/switchbotClient.spec.ts +10 -0
  89. package/test/utils.spec.ts +20 -0
  90. package/vitest.config.ts +7 -0
  91. package/coverage/base.css +0 -224
  92. package/coverage/block-navigation.js +0 -87
  93. package/coverage/clover.xml +0 -15847
  94. package/coverage/coverage-final.json +0 -42
  95. package/coverage/docs/assets/dmt/dmt-component-data.js.html +0 -85
  96. package/coverage/docs/assets/dmt/dmt-components.js.html +0 -286
  97. package/coverage/docs/assets/dmt/index.html +0 -131
  98. package/coverage/docs/assets/hierarchy.js.html +0 -85
  99. package/coverage/docs/assets/icons.js.html +0 -136
  100. package/coverage/docs/assets/index.html +0 -146
  101. package/coverage/docs/assets/main.js.html +0 -265
  102. package/coverage/favicon.png +0 -0
  103. package/coverage/index.html +0 -191
  104. package/coverage/prettify.css +0 -1
  105. package/coverage/prettify.js +0 -2
  106. package/coverage/sort-arrow-sprite.png +0 -0
  107. package/coverage/sorter.js +0 -196
  108. package/coverage/src/device/blindtilt.ts.html +0 -3238
  109. package/coverage/src/device/bot.ts.html +0 -2803
  110. package/coverage/src/device/ceilinglight.ts.html +0 -2338
  111. package/coverage/src/device/colorbulb.ts.html +0 -2824
  112. package/coverage/src/device/contact.ts.html +0 -1465
  113. package/coverage/src/device/curtain.ts.html +0 -2869
  114. package/coverage/src/device/device.ts.html +0 -2500
  115. package/coverage/src/device/fan.ts.html +0 -2242
  116. package/coverage/src/device/hub.ts.html +0 -1408
  117. package/coverage/src/device/humidifier.ts.html +0 -2116
  118. package/coverage/src/device/index.html +0 -416
  119. package/coverage/src/device/iosensor.ts.html +0 -1375
  120. package/coverage/src/device/lightstrip.ts.html +0 -2617
  121. package/coverage/src/device/lock.ts.html +0 -1963
  122. package/coverage/src/device/meter.ts.html +0 -1372
  123. package/coverage/src/device/meterplus.ts.html +0 -1384
  124. package/coverage/src/device/meterpro.ts.html +0 -1618
  125. package/coverage/src/device/motion.ts.html +0 -1264
  126. package/coverage/src/device/plug.ts.html +0 -1372
  127. package/coverage/src/device/relayswitch.ts.html +0 -2284
  128. package/coverage/src/device/robotvacuumcleaner.ts.html +0 -1810
  129. package/coverage/src/device/waterdetector.ts.html +0 -1294
  130. package/coverage/src/homebridge-ui/index.html +0 -116
  131. package/coverage/src/homebridge-ui/server.ts.html +0 -229
  132. package/coverage/src/index.html +0 -161
  133. package/coverage/src/index.ts.html +0 -124
  134. package/coverage/src/irdevice/airconditioner.ts.html +0 -1687
  135. package/coverage/src/irdevice/airpurifier.ts.html +0 -844
  136. package/coverage/src/irdevice/camera.ts.html +0 -475
  137. package/coverage/src/irdevice/fan.ts.html +0 -766
  138. package/coverage/src/irdevice/index.html +0 -251
  139. package/coverage/src/irdevice/irdevice.ts.html +0 -1117
  140. package/coverage/src/irdevice/light.ts.html +0 -826
  141. package/coverage/src/irdevice/other.ts.html +0 -2458
  142. package/coverage/src/irdevice/tv.ts.html +0 -1222
  143. package/coverage/src/irdevice/vacuumcleaner.ts.html +0 -466
  144. package/coverage/src/irdevice/waterheater.ts.html +0 -469
  145. package/coverage/src/platform.ts.html +0 -8776
  146. package/coverage/src/settings.ts.html +0 -934
  147. package/coverage/src/utils.ts.html +0 -2092
  148. package/dist/devices-hap/airpurifier.d.ts +0 -54
  149. package/dist/devices-hap/airpurifier.d.ts.map +0 -1
  150. package/dist/devices-hap/airpurifier.js +0 -527
  151. package/dist/devices-hap/airpurifier.js.map +0 -1
  152. package/dist/devices-hap/blindtilt.d.ts +0 -90
  153. package/dist/devices-hap/blindtilt.d.ts.map +0 -1
  154. package/dist/devices-hap/blindtilt.js +0 -974
  155. package/dist/devices-hap/blindtilt.js.map +0 -1
  156. package/dist/devices-hap/bot.d.ts +0 -102
  157. package/dist/devices-hap/bot.d.ts.map +0 -1
  158. package/dist/devices-hap/bot.js +0 -811
  159. package/dist/devices-hap/bot.js.map +0 -1
  160. package/dist/devices-hap/ceilinglight.d.ts +0 -85
  161. package/dist/devices-hap/ceilinglight.d.ts.map +0 -1
  162. package/dist/devices-hap/ceilinglight.js +0 -701
  163. package/dist/devices-hap/ceilinglight.js.map +0 -1
  164. package/dist/devices-hap/colorbulb.d.ts +0 -88
  165. package/dist/devices-hap/colorbulb.d.ts.map +0 -1
  166. package/dist/devices-hap/colorbulb.js +0 -881
  167. package/dist/devices-hap/colorbulb.js.map +0 -1
  168. package/dist/devices-hap/contact.d.ts +0 -44
  169. package/dist/devices-hap/contact.d.ts.map +0 -1
  170. package/dist/devices-hap/contact.js +0 -409
  171. package/dist/devices-hap/contact.js.map +0 -1
  172. package/dist/devices-hap/curtain.d.ts +0 -73
  173. package/dist/devices-hap/curtain.d.ts.map +0 -1
  174. package/dist/devices-hap/curtain.js +0 -869
  175. package/dist/devices-hap/curtain.js.map +0 -1
  176. package/dist/devices-hap/device.d.ts +0 -98
  177. package/dist/devices-hap/device.d.ts.map +0 -1
  178. package/dist/devices-hap/device.js +0 -749
  179. package/dist/devices-hap/device.js.map +0 -1
  180. package/dist/devices-hap/fan.d.ts +0 -69
  181. package/dist/devices-hap/fan.d.ts.map +0 -1
  182. package/dist/devices-hap/fan.js +0 -649
  183. package/dist/devices-hap/fan.js.map +0 -1
  184. package/dist/devices-hap/hub.d.ts +0 -37
  185. package/dist/devices-hap/hub.d.ts.map +0 -1
  186. package/dist/devices-hap/hub.js +0 -392
  187. package/dist/devices-hap/hub.js.map +0 -1
  188. package/dist/devices-hap/humidifier.d.ts +0 -68
  189. package/dist/devices-hap/humidifier.d.ts.map +0 -1
  190. package/dist/devices-hap/humidifier.js +0 -628
  191. package/dist/devices-hap/humidifier.js.map +0 -1
  192. package/dist/devices-hap/iosensor.d.ts +0 -42
  193. package/dist/devices-hap/iosensor.d.ts.map +0 -1
  194. package/dist/devices-hap/iosensor.js +0 -382
  195. package/dist/devices-hap/iosensor.js.map +0 -1
  196. package/dist/devices-hap/lightstrip.d.ts +0 -79
  197. package/dist/devices-hap/lightstrip.d.ts.map +0 -1
  198. package/dist/devices-hap/lightstrip.js +0 -797
  199. package/dist/devices-hap/lightstrip.js.map +0 -1
  200. package/dist/devices-hap/lock.d.ts +0 -53
  201. package/dist/devices-hap/lock.d.ts.map +0 -1
  202. package/dist/devices-hap/lock.js +0 -561
  203. package/dist/devices-hap/lock.js.map +0 -1
  204. package/dist/devices-hap/meter.d.ts +0 -37
  205. package/dist/devices-hap/meter.d.ts.map +0 -1
  206. package/dist/devices-hap/meter.js +0 -379
  207. package/dist/devices-hap/meter.js.map +0 -1
  208. package/dist/devices-hap/meterplus.d.ts +0 -42
  209. package/dist/devices-hap/meterplus.d.ts.map +0 -1
  210. package/dist/devices-hap/meterplus.js +0 -384
  211. package/dist/devices-hap/meterplus.js.map +0 -1
  212. package/dist/devices-hap/meterpro.d.ts +0 -43
  213. package/dist/devices-hap/meterpro.d.ts.map +0 -1
  214. package/dist/devices-hap/meterpro.js +0 -468
  215. package/dist/devices-hap/meterpro.js.map +0 -1
  216. package/dist/devices-hap/motion.d.ts +0 -42
  217. package/dist/devices-hap/motion.d.ts.map +0 -1
  218. package/dist/devices-hap/motion.js +0 -345
  219. package/dist/devices-hap/motion.js.map +0 -1
  220. package/dist/devices-hap/plug.d.ts +0 -49
  221. package/dist/devices-hap/plug.d.ts.map +0 -1
  222. package/dist/devices-hap/plug.js +0 -395
  223. package/dist/devices-hap/plug.js.map +0 -1
  224. package/dist/devices-hap/relayswitch.d.ts +0 -96
  225. package/dist/devices-hap/relayswitch.d.ts.map +0 -1
  226. package/dist/devices-hap/relayswitch.js +0 -642
  227. package/dist/devices-hap/relayswitch.js.map +0 -1
  228. package/dist/devices-hap/robotvacuumcleaner.d.ts +0 -54
  229. package/dist/devices-hap/robotvacuumcleaner.d.ts.map +0 -1
  230. package/dist/devices-hap/robotvacuumcleaner.js +0 -523
  231. package/dist/devices-hap/robotvacuumcleaner.js.map +0 -1
  232. package/dist/devices-hap/waterdetector.d.ts +0 -41
  233. package/dist/devices-hap/waterdetector.d.ts.map +0 -1
  234. package/dist/devices-hap/waterdetector.js +0 -356
  235. package/dist/devices-hap/waterdetector.js.map +0 -1
  236. package/dist/devices-matter/BaseMatterAccessory.d.ts +0 -63
  237. package/dist/devices-matter/BaseMatterAccessory.d.ts.map +0 -1
  238. package/dist/devices-matter/BaseMatterAccessory.js +0 -100
  239. package/dist/devices-matter/BaseMatterAccessory.js.map +0 -1
  240. package/dist/devices-matter/ColorLightAccessory.d.ts +0 -20
  241. package/dist/devices-matter/ColorLightAccessory.d.ts.map +0 -1
  242. package/dist/devices-matter/ColorLightAccessory.js +0 -95
  243. package/dist/devices-matter/ColorLightAccessory.js.map +0 -1
  244. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts +0 -18
  245. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts.map +0 -1
  246. package/dist/devices-matter/ColorTemperatureLightAccessory.js +0 -78
  247. package/dist/devices-matter/ColorTemperatureLightAccessory.js.map +0 -1
  248. package/dist/devices-matter/ContactSensorAccessory.d.ts +0 -12
  249. package/dist/devices-matter/ContactSensorAccessory.d.ts.map +0 -1
  250. package/dist/devices-matter/ContactSensorAccessory.js +0 -34
  251. package/dist/devices-matter/ContactSensorAccessory.js.map +0 -1
  252. package/dist/devices-matter/DimmableLightAccessory.d.ts +0 -58
  253. package/dist/devices-matter/DimmableLightAccessory.d.ts.map +0 -1
  254. package/dist/devices-matter/DimmableLightAccessory.js +0 -167
  255. package/dist/devices-matter/DimmableLightAccessory.js.map +0 -1
  256. package/dist/devices-matter/DoorLockAccessory.d.ts +0 -14
  257. package/dist/devices-matter/DoorLockAccessory.d.ts.map +0 -1
  258. package/dist/devices-matter/DoorLockAccessory.js +0 -50
  259. package/dist/devices-matter/DoorLockAccessory.js.map +0 -1
  260. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts +0 -21
  261. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts.map +0 -1
  262. package/dist/devices-matter/ExtendedColorLightAccessory.js +0 -107
  263. package/dist/devices-matter/ExtendedColorLightAccessory.js.map +0 -1
  264. package/dist/devices-matter/FanAccessory.d.ts +0 -16
  265. package/dist/devices-matter/FanAccessory.d.ts.map +0 -1
  266. package/dist/devices-matter/FanAccessory.js +0 -81
  267. package/dist/devices-matter/FanAccessory.js.map +0 -1
  268. package/dist/devices-matter/HumiditySensorAccessory.d.ts +0 -12
  269. package/dist/devices-matter/HumiditySensorAccessory.d.ts.map +0 -1
  270. package/dist/devices-matter/HumiditySensorAccessory.js +0 -34
  271. package/dist/devices-matter/HumiditySensorAccessory.js.map +0 -1
  272. package/dist/devices-matter/LeakSensorAccessory.d.ts +0 -12
  273. package/dist/devices-matter/LeakSensorAccessory.d.ts.map +0 -1
  274. package/dist/devices-matter/LeakSensorAccessory.js +0 -33
  275. package/dist/devices-matter/LeakSensorAccessory.js.map +0 -1
  276. package/dist/devices-matter/LightSensorAccessory.d.ts +0 -12
  277. package/dist/devices-matter/LightSensorAccessory.d.ts.map +0 -1
  278. package/dist/devices-matter/LightSensorAccessory.js +0 -34
  279. package/dist/devices-matter/LightSensorAccessory.js.map +0 -1
  280. package/dist/devices-matter/OccupancySensorAccessory.d.ts +0 -12
  281. package/dist/devices-matter/OccupancySensorAccessory.d.ts.map +0 -1
  282. package/dist/devices-matter/OccupancySensorAccessory.js +0 -39
  283. package/dist/devices-matter/OccupancySensorAccessory.js.map +0 -1
  284. package/dist/devices-matter/OnOffLightAccessory.d.ts +0 -38
  285. package/dist/devices-matter/OnOffLightAccessory.d.ts.map +0 -1
  286. package/dist/devices-matter/OnOffLightAccessory.js +0 -118
  287. package/dist/devices-matter/OnOffLightAccessory.js.map +0 -1
  288. package/dist/devices-matter/OnOffOutletAccessory.d.ts +0 -12
  289. package/dist/devices-matter/OnOffOutletAccessory.d.ts.map +0 -1
  290. package/dist/devices-matter/OnOffOutletAccessory.js +0 -40
  291. package/dist/devices-matter/OnOffOutletAccessory.js.map +0 -1
  292. package/dist/devices-matter/OnOffSwitchAccessory.d.ts +0 -14
  293. package/dist/devices-matter/OnOffSwitchAccessory.d.ts.map +0 -1
  294. package/dist/devices-matter/OnOffSwitchAccessory.js +0 -42
  295. package/dist/devices-matter/OnOffSwitchAccessory.js.map +0 -1
  296. package/dist/devices-matter/RoboticVacuumAccessory.d.ts +0 -68
  297. package/dist/devices-matter/RoboticVacuumAccessory.d.ts.map +0 -1
  298. package/dist/devices-matter/RoboticVacuumAccessory.js +0 -334
  299. package/dist/devices-matter/RoboticVacuumAccessory.js.map +0 -1
  300. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts +0 -11
  301. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts.map +0 -1
  302. package/dist/devices-matter/SmokeCOAlarmAccessory.js +0 -49
  303. package/dist/devices-matter/SmokeCOAlarmAccessory.js.map +0 -1
  304. package/dist/devices-matter/TemperatureSensorAccessory.d.ts +0 -12
  305. package/dist/devices-matter/TemperatureSensorAccessory.d.ts.map +0 -1
  306. package/dist/devices-matter/TemperatureSensorAccessory.js +0 -36
  307. package/dist/devices-matter/TemperatureSensorAccessory.js.map +0 -1
  308. package/dist/devices-matter/ThermostatAccessory.d.ts +0 -19
  309. package/dist/devices-matter/ThermostatAccessory.d.ts.map +0 -1
  310. package/dist/devices-matter/ThermostatAccessory.js +0 -95
  311. package/dist/devices-matter/ThermostatAccessory.js.map +0 -1
  312. package/dist/devices-matter/VenetianBlindAccessory.d.ts +0 -19
  313. package/dist/devices-matter/VenetianBlindAccessory.d.ts.map +0 -1
  314. package/dist/devices-matter/VenetianBlindAccessory.js +0 -99
  315. package/dist/devices-matter/VenetianBlindAccessory.js.map +0 -1
  316. package/dist/devices-matter/WindowBlindAccessory.d.ts +0 -17
  317. package/dist/devices-matter/WindowBlindAccessory.d.ts.map +0 -1
  318. package/dist/devices-matter/WindowBlindAccessory.js +0 -80
  319. package/dist/devices-matter/WindowBlindAccessory.js.map +0 -1
  320. package/dist/devices-matter/custom/PowerStripAccessory.d.ts +0 -97
  321. package/dist/devices-matter/custom/PowerStripAccessory.d.ts.map +0 -1
  322. package/dist/devices-matter/custom/PowerStripAccessory.js +0 -265
  323. package/dist/devices-matter/custom/PowerStripAccessory.js.map +0 -1
  324. package/dist/devices-matter/custom/index.d.ts +0 -8
  325. package/dist/devices-matter/custom/index.d.ts.map +0 -1
  326. package/dist/devices-matter/custom/index.js +0 -8
  327. package/dist/devices-matter/custom/index.js.map +0 -1
  328. package/dist/devices-matter/index.d.ts +0 -29
  329. package/dist/devices-matter/index.d.ts.map +0 -1
  330. package/dist/devices-matter/index.js +0 -28
  331. package/dist/devices-matter/index.js.map +0 -1
  332. package/dist/index.test.d.ts +0 -2
  333. package/dist/index.test.d.ts.map +0 -1
  334. package/dist/index.test.js +0 -14
  335. package/dist/index.test.js.map +0 -1
  336. package/dist/irdevice/airconditioner.d.ts +0 -61
  337. package/dist/irdevice/airconditioner.d.ts.map +0 -1
  338. package/dist/irdevice/airconditioner.js +0 -472
  339. package/dist/irdevice/airconditioner.js.map +0 -1
  340. package/dist/irdevice/airpurifier.d.ts +0 -50
  341. package/dist/irdevice/airpurifier.d.ts.map +0 -1
  342. package/dist/irdevice/airpurifier.js +0 -213
  343. package/dist/irdevice/airpurifier.js.map +0 -1
  344. package/dist/irdevice/camera.d.ts +0 -32
  345. package/dist/irdevice/camera.d.ts.map +0 -1
  346. package/dist/irdevice/camera.js +0 -107
  347. package/dist/irdevice/camera.js.map +0 -1
  348. package/dist/irdevice/fan.d.ts +0 -36
  349. package/dist/irdevice/fan.d.ts.map +0 -1
  350. package/dist/irdevice/fan.js +0 -200
  351. package/dist/irdevice/fan.js.map +0 -1
  352. package/dist/irdevice/irdevice.d.ts +0 -68
  353. package/dist/irdevice/irdevice.d.ts.map +0 -1
  354. package/dist/irdevice/irdevice.js +0 -298
  355. package/dist/irdevice/irdevice.js.map +0 -1
  356. package/dist/irdevice/light.d.ts +0 -36
  357. package/dist/irdevice/light.d.ts.map +0 -1
  358. package/dist/irdevice/light.js +0 -206
  359. package/dist/irdevice/light.js.map +0 -1
  360. package/dist/irdevice/other.d.ts +0 -57
  361. package/dist/irdevice/other.d.ts.map +0 -1
  362. package/dist/irdevice/other.js +0 -778
  363. package/dist/irdevice/other.js.map +0 -1
  364. package/dist/irdevice/tv.d.ts +0 -45
  365. package/dist/irdevice/tv.d.ts.map +0 -1
  366. package/dist/irdevice/tv.js +0 -327
  367. package/dist/irdevice/tv.js.map +0 -1
  368. package/dist/irdevice/vacuumcleaner.d.ts +0 -28
  369. package/dist/irdevice/vacuumcleaner.d.ts.map +0 -1
  370. package/dist/irdevice/vacuumcleaner.js +0 -104
  371. package/dist/irdevice/vacuumcleaner.js.map +0 -1
  372. package/dist/irdevice/waterheater.d.ts +0 -30
  373. package/dist/irdevice/waterheater.d.ts.map +0 -1
  374. package/dist/irdevice/waterheater.js +0 -105
  375. package/dist/irdevice/waterheater.js.map +0 -1
  376. package/dist/platform-hap.d.ts +0 -149
  377. package/dist/platform-hap.d.ts.map +0 -1
  378. package/dist/platform-hap.js +0 -2861
  379. package/dist/platform-hap.js.map +0 -1
  380. package/dist/platform-matter.d.ts +0 -120
  381. package/dist/platform-matter.d.ts.map +0 -1
  382. package/dist/platform-matter.js +0 -966
  383. package/dist/platform-matter.js.map +0 -1
  384. package/dist/verifyconfig.test.d.ts +0 -2
  385. package/dist/verifyconfig.test.d.ts.map +0 -1
  386. package/dist/verifyconfig.test.js +0 -167
  387. package/dist/verifyconfig.test.js.map +0 -1
  388. package/src/custom.d.ts +0 -7
  389. package/src/devices-hap/airpurifier.ts +0 -563
  390. package/src/devices-hap/blindtilt.ts +0 -1049
  391. package/src/devices-hap/bot.ts +0 -900
  392. package/src/devices-hap/ceilinglight.ts +0 -742
  393. package/src/devices-hap/colorbulb.ts +0 -904
  394. package/src/devices-hap/contact.ts +0 -457
  395. package/src/devices-hap/curtain.ts +0 -944
  396. package/src/devices-hap/device.ts +0 -811
  397. package/src/devices-hap/fan.ts +0 -711
  398. package/src/devices-hap/hub.ts +0 -439
  399. package/src/devices-hap/humidifier.ts +0 -669
  400. package/src/devices-hap/iosensor.ts +0 -427
  401. package/src/devices-hap/lightstrip.ts +0 -836
  402. package/src/devices-hap/lock.ts +0 -620
  403. package/src/devices-hap/meter.ts +0 -426
  404. package/src/devices-hap/meterplus.ts +0 -430
  405. package/src/devices-hap/meterpro.ts +0 -522
  406. package/src/devices-hap/motion.ts +0 -390
  407. package/src/devices-hap/plug.ts +0 -423
  408. package/src/devices-hap/relayswitch.ts +0 -727
  409. package/src/devices-hap/robotvacuumcleaner.ts +0 -568
  410. package/src/devices-hap/waterdetector.ts +0 -400
  411. package/src/devices-matter/BaseMatterAccessory.ts +0 -131
  412. package/src/devices-matter/ColorLightAccessory.ts +0 -110
  413. package/src/devices-matter/ColorTemperatureLightAccessory.ts +0 -92
  414. package/src/devices-matter/ContactSensorAccessory.ts +0 -41
  415. package/src/devices-matter/DimmableLightAccessory.ts +0 -192
  416. package/src/devices-matter/DoorLockAccessory.ts +0 -60
  417. package/src/devices-matter/ExtendedColorLightAccessory.ts +0 -123
  418. package/src/devices-matter/FanAccessory.ts +0 -95
  419. package/src/devices-matter/HumiditySensorAccessory.ts +0 -41
  420. package/src/devices-matter/LeakSensorAccessory.ts +0 -40
  421. package/src/devices-matter/LightSensorAccessory.ts +0 -41
  422. package/src/devices-matter/OccupancySensorAccessory.ts +0 -48
  423. package/src/devices-matter/OnOffLightAccessory.ts +0 -133
  424. package/src/devices-matter/OnOffOutletAccessory.ts +0 -46
  425. package/src/devices-matter/OnOffSwitchAccessory.ts +0 -51
  426. package/src/devices-matter/RoboticVacuumAccessory.ts +0 -407
  427. package/src/devices-matter/SmokeCOAlarmAccessory.ts +0 -59
  428. package/src/devices-matter/TemperatureSensorAccessory.ts +0 -43
  429. package/src/devices-matter/ThermostatAccessory.ts +0 -110
  430. package/src/devices-matter/VenetianBlindAccessory.ts +0 -115
  431. package/src/devices-matter/WindowBlindAccessory.ts +0 -92
  432. package/src/devices-matter/custom/PowerStripAccessory.ts +0 -309
  433. package/src/devices-matter/custom/index.ts +0 -8
  434. package/src/devices-matter/index.ts +0 -29
  435. package/src/index.test.ts +0 -19
  436. package/src/irdevice/airconditioner.ts +0 -533
  437. package/src/irdevice/airpurifier.ts +0 -252
  438. package/src/irdevice/camera.ts +0 -129
  439. package/src/irdevice/fan.ts +0 -226
  440. package/src/irdevice/irdevice.ts +0 -344
  441. package/src/irdevice/light.ts +0 -246
  442. package/src/irdevice/other.ts +0 -790
  443. package/src/irdevice/tv.ts +0 -378
  444. package/src/irdevice/vacuumcleaner.ts +0 -126
  445. package/src/irdevice/waterheater.ts +0 -127
  446. package/src/platform-hap.ts +0 -2997
  447. package/src/platform-matter.ts +0 -1092
  448. package/src/verifyconfig.test.ts +0 -197
@@ -1,811 +0,0 @@
1
- /* Copyright(C) 2021-2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
2
- *
3
- * device.ts: @switchbot/homebridge-switchbot.
4
- */
5
-
6
- import type { API, CharacteristicValue, HAP, Logging, PlatformAccessory, Service } from 'homebridge'
7
- import type { MqttClient } from 'mqtt'
8
- import type { ad, bodyChange, device, deviceStatus, deviceStatusRequest, pushResponse, SwitchBotBLE } from 'node-switchbot'
9
-
10
- import type { SwitchBotHAPPlatform } from '../platform-hap.js'
11
- import type { blindTiltConfig, botConfig, ceilingLightConfig, colorBulbConfig, contactConfig, curtainConfig, devicesConfig, hubConfig, humidifierConfig, indoorOutdoorSensorConfig, lockConfig, meterConfig, motionConfig, plugConfig, relaySwitch1Config, relaySwitch1PMConfig, stripLightConfig, SwitchBotPlatformConfig, waterDetectorConfig } from '../settings.js'
12
-
13
- import { hostname } from 'node:os'
14
-
15
- import { SwitchBotBLEModel, SwitchBotBLEModelFriendlyName, SwitchBotBLEModelName, SwitchBotModel } from 'node-switchbot'
16
-
17
- import { formatDeviceIdAsMac, safeStringify, sleep } from '../utils.js'
18
-
19
- export abstract class deviceBase {
20
- public readonly api: API
21
- public readonly log: Logging
22
- public readonly config!: SwitchBotPlatformConfig
23
- protected readonly hap: HAP
24
-
25
- // Config
26
- protected deviceLogging!: string
27
- protected deviceRefreshRate!: number
28
- protected deviceUpdateRate!: number
29
- protected devicePushRate!: number
30
- protected deviceMaxRetries!: number
31
- protected deviceDelayBetweenRetries!: number
32
-
33
- // Connection
34
- protected readonly BLE: boolean
35
- protected readonly OpenAPI: boolean
36
-
37
- // Accsrroy Information
38
- protected deviceModel!: SwitchBotModel
39
- protected deviceBLEModel!: SwitchBotBLEModel
40
-
41
- // MQTT
42
- protected deviceMqttURL!: string
43
- protected deviceMqttOptions!: any
44
- protected deviceMqttPubOptions!: any
45
-
46
- // BLE
47
- protected scanDuration!: number
48
-
49
- // EVE history service handler
50
- protected historyService?: any = null
51
-
52
- // MQTT stuff
53
- protected mqttClient: MqttClient | null = null
54
-
55
- constructor(
56
- protected readonly platform: SwitchBotHAPPlatform,
57
- protected accessory: PlatformAccessory,
58
- protected device: device & devicesConfig,
59
- ) {
60
- this.api = this.platform.api
61
- this.log = this.platform.log
62
- this.config = this.platform.config
63
- this.hap = this.api.hap
64
-
65
- // Connection
66
- this.BLE = this.device.connectionType === 'BLE' || this.device.connectionType === 'BLE/OpenAPI'
67
- this.OpenAPI = this.device.connectionType === 'OpenAPI' || this.device.connectionType === 'BLE/OpenAPI'
68
-
69
- this.getDeviceLogSettings(device)
70
- this.getDeviceRateSettings(device)
71
- this.getDeviceConfigSettings(device)
72
- this.getDeviceContext(accessory, device)
73
- this.getMqttSettings(device)
74
-
75
- // Set accessory information
76
- accessory
77
- .getService(this.hap.Service.AccessoryInformation)!
78
- .setCharacteristic(this.hap.Characteristic.Manufacturer, 'SwitchBot')
79
- .setCharacteristic(this.hap.Characteristic.AppMatchingIdentifier, 'id1087374760')
80
- .setCharacteristic(this.hap.Characteristic.Name, accessory.displayName)
81
- .setCharacteristic(this.hap.Characteristic.ConfiguredName, accessory.displayName)
82
- .setCharacteristic(this.hap.Characteristic.Model, device.model)
83
- .setCharacteristic(this.hap.Characteristic.ProductData, device.deviceId)
84
- .setCharacteristic(this.hap.Characteristic.SerialNumber, device.deviceId)
85
- }
86
-
87
- async getDeviceLogSettings(device: device & devicesConfig): Promise<void> {
88
- this.deviceLogging = this.platform.debugMode ? 'debugMode' : device.logging ?? this.platform.platformLogging ?? 'standard'
89
- const logging = this.platform.debugMode ? 'Debug Mode' : device.logging ? 'Device Config' : this.platform.platformLogging ? 'Platform Config' : 'Default'
90
- this.debugLog(`Using ${logging} Logging: ${this.deviceLogging}`)
91
- }
92
-
93
- async getDeviceRateSettings(device: device & devicesConfig): Promise<void> {
94
- // refreshRate
95
- this.deviceRefreshRate = device.refreshRate ?? this.platform.platformRefreshRate ?? 300
96
- const refreshRate = device.refreshRate ? 'Device Config' : this.platform.platformRefreshRate ? 'Platform Config' : 'Default'
97
- this.accessory.context.refreshRate = this.deviceRefreshRate
98
- // updateRate
99
- this.deviceUpdateRate = device.updateRate ?? this.platform.platformUpdateRate ?? 5
100
- const updateRate = device.updateRate ? 'Device Config' : this.platform.platformUpdateRate ? 'Platform Config' : 'Default'
101
- this.accessory.context.updateRate = this.deviceUpdateRate
102
- // pushRate
103
- this.devicePushRate = device.pushRate ?? this.platform.platformPushRate ?? 0.1
104
- const pushRate = device.pushRate ? 'Device Config' : this.platform.platformPushRate ? 'Platform Config' : 'Default'
105
- this.accessory.context.pushRate = this.devicePushRate
106
- this.debugLog(`Using ${refreshRate} refreshRate: ${this.deviceRefreshRate}, ${updateRate} updateRate: ${this.deviceUpdateRate}, ${pushRate} pushRate: ${this.devicePushRate}`)
107
- // maxRetries
108
- this.deviceMaxRetries = device.maxRetries ?? this.platform.platformMaxRetries ?? 2
109
- const maxRetries = device.maxRetries ? 'Device' : this.platform.platformMaxRetries ? 'Platform' : 'Default'
110
- this.debugLog(`Using ${maxRetries} Max Retries: ${this.deviceMaxRetries}`)
111
- // delayBetweenRetries
112
- this.deviceDelayBetweenRetries = device.delayBetweenRetries ? (device.delayBetweenRetries * 1000) : this.platform.platformDelayBetweenRetries ?? 3000
113
- const delayBetweenRetries = device.delayBetweenRetries ? 'Device' : this.platform.platformDelayBetweenRetries ? 'Platform' : 'Default'
114
- this.debugLog(`Using ${delayBetweenRetries} Delay Between Retries: ${this.deviceDelayBetweenRetries}`)
115
- // scanDuration
116
- this.scanDuration = Math.max(device.scanDuration ?? 1, this.deviceUpdateRate > 1 ? this.deviceUpdateRate : 1)
117
- if (this.BLE) {
118
- this.debugLog(`Using ${device.scanDuration ? 'Device Config' : 'Default'} scanDuration: ${this.scanDuration}`)
119
- if (device.scanDuration && this.deviceUpdateRate > device.scanDuration) {
120
- this.warnLog('scanDuration is less than updateRate, overriding scanDuration with updateRate')
121
- }
122
- }
123
- }
124
-
125
- async retryBLE({ max, fn }: { max: number, fn: { (): any, (): Promise<any> } }): Promise<null> {
126
- return fn().catch(async (e: any) => {
127
- if (max === 0) {
128
- throw e
129
- }
130
- this.warnLog(e)
131
- this.infoLog('Retrying')
132
- await sleep(1000)
133
- return this.retryBLE({ max: max - 1, fn })
134
- })
135
- }
136
-
137
- maxRetryBLE(): number {
138
- return this.device.maxRetry !== undefined ? this.device.maxRetry : 5
139
- }
140
-
141
- async getDeviceConfigSettings(device: device & devicesConfig): Promise<void> {
142
- const deviceConfig = Object.assign(
143
- {},
144
- device.logging !== 'standard' && { logging: device.logging },
145
- device.refreshRate !== 0 && { refreshRate: device.refreshRate },
146
- device.updateRate !== 0 && { updateRate: device.updateRate },
147
- device.scanDuration !== 0 && { scanDuration: device.scanDuration },
148
- device.offline === true && { offline: device.offline },
149
- device.maxRetry !== 0 && { maxRetry: device.maxRetry },
150
- device.webhook === true && { webhook: device.webhook },
151
- device.connectionType !== '' && { connectionType: device.connectionType },
152
- device.disablePlatformBLE !== false && { disablePlatformBLE: device.disablePlatformBLE },
153
- device.external === true && { external: device.external },
154
- device.mqttURL !== '' && { mqttURL: device.mqttURL },
155
- device.mqttOptions && { mqttOptions: device.mqttOptions },
156
- device.mqttPubOptions && { mqttPubOptions: device.mqttPubOptions },
157
- device.maxRetries !== 0 && { maxRetries: device.maxRetries },
158
- device.delayBetweenRetries !== 0 && { delayBetweenRetries: device.delayBetweenRetries },
159
- )
160
- let deviceSpecificConfig = {}
161
- switch (device.configDeviceType) {
162
- case 'Bot':
163
- deviceSpecificConfig = device as botConfig
164
- break
165
- case 'Relay Switch 1':
166
- deviceSpecificConfig = device as relaySwitch1Config
167
- break
168
- case 'Relay Switch 1PM':
169
- deviceSpecificConfig = device as relaySwitch1PMConfig
170
- break
171
- case 'Meter':
172
- case 'MeterPlus':
173
- deviceSpecificConfig = device as meterConfig
174
- break
175
- case 'WoIOSensor':
176
- deviceSpecificConfig = device as indoorOutdoorSensorConfig
177
- break
178
- case 'Humidifier':
179
- case 'Humidifier2':
180
- deviceSpecificConfig = device as humidifierConfig
181
- break
182
- case 'Curtain':
183
- case 'Curtain3':
184
- deviceSpecificConfig = device as curtainConfig
185
- break
186
- case 'Blind Tilt':
187
- deviceSpecificConfig = device as blindTiltConfig
188
- break
189
- case 'Contact Sensor':
190
- deviceSpecificConfig = device as contactConfig
191
- break
192
- case 'Motion Sensor':
193
- deviceSpecificConfig = device as motionConfig
194
- break
195
- case 'Water Detector':
196
- deviceSpecificConfig = device as waterDetectorConfig
197
- break
198
- case 'Plug':
199
- case 'Plug Mini (US)':
200
- case 'Plug Mini (JP)':
201
- deviceSpecificConfig = device as plugConfig
202
- break
203
- case 'Color Bulb':
204
- deviceSpecificConfig = device as colorBulbConfig
205
- break
206
- case 'Strip Light':
207
- deviceSpecificConfig = device as stripLightConfig
208
- break
209
- case 'Ceiling Light':
210
- case 'Ceiling Light Pro':
211
- deviceSpecificConfig = device as ceilingLightConfig
212
- break
213
- case 'Smart Lock':
214
- case 'Smart Lock Pro':
215
- deviceSpecificConfig = device as lockConfig
216
- break
217
- case 'Hub 2':
218
- deviceSpecificConfig = device as hubConfig
219
- break
220
- default:
221
- }
222
- const config = Object.assign(
223
- {},
224
- deviceConfig,
225
- deviceSpecificConfig,
226
- )
227
-
228
- if (Object.keys(config).length !== 0) {
229
- this.debugSuccessLog(`Config: ${JSON.stringify(config)}`)
230
- }
231
- }
232
-
233
- /**
234
- * Get the current ambient light level based on the light level, set_minLux, set_maxLux, and spaceBetweenLevels.
235
- * @param lightLevel number
236
- * @param set_minLux number
237
- * @param set_maxLux number
238
- * @param spaceBetweenLevels number
239
- * @returns CurrentAmbientLightLevel
240
- */
241
- getLightLevel(lightLevel: number, set_minLux: number, set_maxLux: number, spaceBetweenLevels: number): number {
242
- const numberOfLevels = spaceBetweenLevels + 1
243
- this.debugLog(`LightLevel: ${lightLevel}, set_minLux: ${set_minLux}, set_maxLux: ${set_maxLux}, spaceBetweenLevels: ${spaceBetweenLevels}, numberOfLevels: ${numberOfLevels}`)
244
- const CurrentAmbientLightLevel = lightLevel === 1
245
- ? set_minLux
246
- : lightLevel === numberOfLevels
247
- ? set_maxLux
248
- : ((set_maxLux - set_minLux) / spaceBetweenLevels) * (Number(lightLevel) - 1)
249
- this.debugLog(`CurrentAmbientLightLevel: ${CurrentAmbientLightLevel}, LightLevel: ${lightLevel}, set_minLux: ${set_minLux}, set_maxLux: ${set_maxLux}`)
250
- return CurrentAmbientLightLevel
251
- }
252
-
253
- /*
254
- * Publish MQTT message for topics of
255
- * 'homebridge-switchbot/${this.device.deviceType}/xx:xx:xx:xx:xx:xx'
256
- */
257
- async mqttPublish(message: string, topic?: string) {
258
- const mac = this.device.deviceId?.toLowerCase().match(/[\s\S]{1,2}/g)?.join(':')
259
- const options = this.deviceMqttPubOptions ?? {}
260
- const mqttTopic = topic ? `/${topic}` : ''
261
- const mqttMessageTopic = topic ? `${topic}/` : ''
262
- this.mqttClient?.publish(`homebridge-switchbot/${this.device.deviceType}/${mac}${mqttTopic}`, `${message}`, options)
263
- this.debugLog(`MQTT message: ${mqttMessageTopic}${message} options:${JSON.stringify(options)}`)
264
- }
265
-
266
- /*
267
- * MQTT Settings
268
- */
269
- async getMqttSettings(device: device & devicesConfig): Promise<void> {
270
- // mqttURL
271
- this.deviceMqttURL = device.mqttURL ?? this.config.options?.mqttURL ?? ''
272
- const mqttURL = device.mqttURL ? 'Device Config' : this.config.options?.mqttURL ? 'Platform Config' : 'Default'
273
- // mqttOptions
274
- this.deviceMqttOptions = device.mqttOptions ?? this.config.options?.mqttOptions ?? {}
275
- const mqttOptions = device.mqttOptions ? 'Device Config' : this.config.options?.mqttOptions ? 'Platform Config' : 'Default'
276
- // mqttPubOptions
277
- this.deviceMqttPubOptions = device.mqttPubOptions ?? this.config.options?.mqttPubOptions ?? {}
278
- const mqttPubOptions = device.mqttPubOptions ? 'Device Config' : this.config.options?.mqttPubOptions ? 'Platform Config' : 'Default'
279
- this.debugLog(`Using ${mqttURL} MQTT URL: ${this.deviceMqttURL}, ${mqttOptions} mqttOptions: ${JSON.stringify(this.deviceMqttOptions)}, ${mqttPubOptions} mqttPubOptions: ${JSON.stringify(this.deviceMqttPubOptions)}`)
280
- }
281
-
282
- /*
283
- * Setup EVE history graph feature if enabled.
284
- */
285
- async setupHistoryService(accessory: PlatformAccessory, device: device & devicesConfig): Promise<void> {
286
- try {
287
- const formattedDeviceId = formatDeviceIdAsMac(this.device.deviceId)
288
- this.device.bleMac = formattedDeviceId
289
- this.debugLog(`bleMac: ${this.device.bleMac}`)
290
- this.historyService = device.history
291
- ? new this.platform.fakegatoAPI('room', accessory, {
292
- log: this.platform.log,
293
- storage: 'fs',
294
- filename: `${hostname().split('.')[0]}_${this.device.bleMac}_persist.json`,
295
- })
296
- : null
297
- } catch (error) {
298
- this.errorLog(`failed to format device ID as MAC, Error: ${error}`)
299
- }
300
- }
301
-
302
- async switchbotBLE(): Promise<any> {
303
- const switchBotBLE = await this.platform.connectBLE(this.accessory, this.device)
304
- // Convert to BLE Address
305
- try {
306
- const formattedDeviceId = formatDeviceIdAsMac(this.device.deviceId)
307
- this.device.bleMac = formattedDeviceId
308
- await this.getCustomBLEAddress(switchBotBLE)
309
- this.debugLog(`bleMac: ${this.device.bleMac}`)
310
- return switchBotBLE
311
- } catch (error) {
312
- this.errorLog(`failed to format device ID as MAC, Error: ${error}`)
313
- }
314
- }
315
-
316
- async monitorAdvertisementPackets(switchbot: SwitchBotBLE): Promise<ad['serviceData']> {
317
- this.debugLog(`Scanning for deviceID: ${this.device.bleMac} Model: ${this.device.bleModel} ModelName: ${this.device.bleModelName}...`)
318
- try {
319
- await switchbot.startScan({ model: this.device.bleModel, id: this.device.bleMac })
320
- } catch (e: any) {
321
- this.errorLog(`Failed to start BLE scanning. Error: ${e.message ?? e}`)
322
- }
323
- // Set an event handler
324
- let serviceData = { model: this.device.bleModel, modelName: this.device.bleModelName } as ad['serviceData']
325
- switchbot.onadvertisement = (ad: ad) => {
326
- if (ad.address === this.device.bleMac && ad.serviceData.model === this.device.bleModel) {
327
- this.debugLog(`ad: ${safeStringify(ad)}`)
328
- this.debugLog(`${JSON.stringify(ad, null, ' ')}`)
329
- this.debugLog(`address: ${ad.address}, model: ${ad.serviceData.model}`)
330
- this.debugLog(`serviceData: ${JSON.stringify(ad.serviceData)}`)
331
- serviceData = ad.serviceData
332
- }
333
- }
334
- // Wait
335
- await switchbot.wait(this.scanDuration * 1000)
336
- // Stop to monitor
337
- try {
338
- await switchbot.stopScan()
339
- } catch (e: any) {
340
- this.errorLog(`Failed to stop BLE scanning. Error: ${e.message ?? e}`)
341
- }
342
- return serviceData
343
- }
344
-
345
- async getCustomBLEAddress(switchbot: SwitchBotBLE): Promise<void> {
346
- if (this.device.customBLEaddress && this.deviceLogging.includes('debug')) {
347
- this.debugLog(`customBLEaddress: ${this.device.customBLEaddress}`);
348
- (async () => {
349
- // Start to monitor advertisement packets
350
- try {
351
- await switchbot.startScan({ model: this.device.bleModel })
352
- } catch (e: any) {
353
- this.errorLog(`Failed to start BLE scanning. Error: ${e.message ?? e}`)
354
- }
355
- // Set an event handler
356
- switchbot.onadvertisement = (ad: ad) => {
357
- this.warnLog(`ad: ${JSON.stringify(ad, null, ' ')}`)
358
- }
359
- await sleep(10000)
360
- // Stop to monitor
361
- try {
362
- switchbot.stopScan()
363
- } catch (e: any) {
364
- this.errorLog(`Failed to stop BLE scanning. Error: ${e.message ?? e}`)
365
- }
366
- })()
367
- }
368
- }
369
-
370
- async pushChangeRequest<T extends pushResponse['body']>(bodyChange: bodyChange): Promise<{ body: T, statusCode: pushResponse['statusCode'] }> {
371
- const { response, statusCode } = await this.platform.retryCommand(this.device, bodyChange, this.deviceMaxRetries, this.deviceDelayBetweenRetries)
372
- return { body: response, statusCode }
373
- }
374
-
375
- async deviceRefreshStatus<T extends deviceStatus>(): Promise<{ body: T, statusCode: deviceStatusRequest['statusCode'] }> {
376
- const { response, statusCode } = await this.platform.retryRequest(this.device, this.deviceMaxRetries, this.deviceDelayBetweenRetries)
377
- return { body: response, statusCode }
378
- }
379
-
380
- async successfulStatusCodes<T extends { statusCode: number }>(deviceStatus: T) {
381
- return (deviceStatus.statusCode === 200 || deviceStatus.statusCode === 100)
382
- }
383
-
384
- /**
385
- * Update the characteristic value and log the change.
386
- *
387
- * @param Service Service
388
- * @param Characteristic Characteristic
389
- * @param CharacteristicValue CharacteristicValue | undefined
390
- * @param CharacteristicName string
391
- * @param history object
392
- * @return: void
393
- *
394
- */
395
- async updateCharacteristic(Service: Service, Characteristic: any, CharacteristicValue: CharacteristicValue | undefined, CharacteristicName: string, history?: object): Promise<void> {
396
- if (CharacteristicValue === undefined || CharacteristicValue === null) {
397
- this.debugLog(`${CharacteristicName}: ${CharacteristicValue}`)
398
- } else {
399
- await this.mqtt(CharacteristicName, CharacteristicValue)
400
- if (this.device.history) {
401
- this.historyService?.addEntry(history)
402
- }
403
- Service.updateCharacteristic(Characteristic, CharacteristicValue)
404
- this.debugLog(`updateCharacteristic ${CharacteristicName}: ${CharacteristicValue}`)
405
- this.debugWarnLog(`${CharacteristicName} context before: ${this.accessory.context[CharacteristicName]}`)
406
- this.accessory.context[CharacteristicName] = CharacteristicValue
407
- this.debugWarnLog(`${CharacteristicName} context after: ${this.accessory.context[CharacteristicName]}`)
408
- }
409
- }
410
-
411
- async mqtt(CharacteristicName: string, CharacteristicValue: CharacteristicValue) {
412
- if (this.device.mqttURL) {
413
- this.mqttPublish(CharacteristicName, CharacteristicValue.toString())
414
- }
415
- }
416
-
417
- async getDeviceContext(accessory: PlatformAccessory, device: device & devicesConfig): Promise<void> {
418
- const deviceMapping = {
419
- 'Humidifier': {
420
- model: SwitchBotModel.Humidifier,
421
- bleModel: SwitchBotBLEModel.Humidifier,
422
- bleModelName: SwitchBotBLEModelName.Humidifier,
423
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Humidifier,
424
- },
425
- 'Humidifier2': {
426
- model: SwitchBotModel.Humidifier2,
427
- bleModel: SwitchBotBLEModel.Humidifier2,
428
- bleModelName: SwitchBotBLEModelName.Humidifier2,
429
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Humidifier2,
430
- },
431
- 'Hub Mini': {
432
- model: SwitchBotModel.HubMini,
433
- bleModel: SwitchBotBLEModel.Unknown,
434
- bleModelName: SwitchBotBLEModelName.Unknown,
435
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
436
- },
437
- 'Hub Plus': {
438
- model: SwitchBotModel.HubPlus,
439
- bleModel: SwitchBotBLEModel.Unknown,
440
- bleModelName: SwitchBotBLEModelName.Unknown,
441
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
442
- },
443
- 'Hub 2': {
444
- model: SwitchBotModel.Hub2,
445
- bleModel: SwitchBotBLEModel.Hub2,
446
- bleModelName: SwitchBotBLEModelName.Hub2,
447
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Hub2,
448
- },
449
- 'Hub 3': {
450
- model: SwitchBotModel.Hub3,
451
- bleModel: SwitchBotBLEModel.Hub3,
452
- bleModelName: SwitchBotBLEModelName.Hub3,
453
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Hub3,
454
- },
455
- 'Bot': {
456
- model: SwitchBotModel.Bot,
457
- bleModel: SwitchBotBLEModel.Bot,
458
- bleModelName: SwitchBotBLEModelName.Bot,
459
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Bot,
460
- },
461
- 'Relay Switch 1': {
462
- model: SwitchBotModel.RelaySwitch1,
463
- bleModel: SwitchBotBLEModel.RelaySwitch1,
464
- bleModelName: SwitchBotBLEModelName.RelaySwitch1,
465
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.RelaySwitch1,
466
- },
467
- 'Relay Switch 1PM': {
468
- model: SwitchBotModel.RelaySwitch1PM,
469
- bleModel: SwitchBotBLEModel.RelaySwitch1PM,
470
- bleModelName: SwitchBotBLEModelName.RelaySwitch1PM,
471
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.RelaySwitch1PM,
472
- },
473
- 'Meter': {
474
- model: SwitchBotModel.Meter,
475
- bleModel: SwitchBotBLEModel.Meter,
476
- bleModelName: SwitchBotBLEModelName.Meter,
477
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Meter,
478
- },
479
- 'MeterPlus': {
480
- model: SwitchBotModel.MeterPlusUS,
481
- bleModel: SwitchBotBLEModel.MeterPlus,
482
- bleModelName: SwitchBotBLEModelName.MeterPlus,
483
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterPlus,
484
- },
485
- 'Meter Plus (JP)': {
486
- model: SwitchBotModel.MeterPlusJP,
487
- bleModel: SwitchBotBLEModel.MeterPlus,
488
- bleModelName: SwitchBotBLEModelName.MeterPlus,
489
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterPlus,
490
- },
491
- 'MeterPro': {
492
- model: SwitchBotModel.MeterPro,
493
- bleModel: SwitchBotBLEModel.MeterPro,
494
- bleModelName: SwitchBotBLEModelName.MeterPro,
495
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterPro,
496
- },
497
- 'MeterPro(CO2)': {
498
- model: SwitchBotModel.MeterProCO2,
499
- bleModel: SwitchBotBLEModel.MeterProCO2,
500
- bleModelName: SwitchBotBLEModelName.MeterProCO2,
501
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MeterProCO2,
502
- },
503
- 'WoIOSensor': {
504
- model: SwitchBotModel.OutdoorMeter,
505
- bleModel: SwitchBotBLEModel.OutdoorMeter,
506
- bleModelName: SwitchBotBLEModelName.OutdoorMeter,
507
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.OutdoorMeter,
508
- },
509
- 'Water Detector': {
510
- model: SwitchBotModel.WaterDetector,
511
- bleModel: SwitchBotBLEModel.Leak,
512
- bleModelName: SwitchBotBLEModelName.Leak,
513
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Leak,
514
- },
515
- 'Motion Sensor': {
516
- model: SwitchBotModel.MotionSensor,
517
- bleModel: SwitchBotBLEModel.MotionSensor,
518
- bleModelName: SwitchBotBLEModelName.MotionSensor,
519
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.MotionSensor,
520
- },
521
- 'Contact Sensor': {
522
- model: SwitchBotModel.ContactSensor,
523
- bleModel: SwitchBotBLEModel.ContactSensor,
524
- bleModelName: SwitchBotBLEModelName.ContactSensor,
525
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.ContactSensor,
526
- },
527
- 'Curtain': {
528
- model: SwitchBotModel.Curtain,
529
- bleModel: SwitchBotBLEModel.Curtain,
530
- bleModelName: SwitchBotBLEModelName.Curtain,
531
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain,
532
- },
533
- 'Curtain3': {
534
- model: SwitchBotModel.Curtain3,
535
- bleModel: SwitchBotBLEModel.Curtain3,
536
- bleModelName: SwitchBotBLEModelName.Curtain3,
537
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain3,
538
- },
539
- 'WoRollerShade': {
540
- model: SwitchBotModel.Curtain3,
541
- bleModel: SwitchBotBLEModel.Curtain3,
542
- bleModelName: SwitchBotBLEModelName.Curtain3,
543
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain3,
544
- },
545
- 'Roller Shade': {
546
- model: SwitchBotModel.Curtain3,
547
- bleModel: SwitchBotBLEModel.Curtain3,
548
- bleModelName: SwitchBotBLEModelName.Curtain3,
549
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Curtain3,
550
- },
551
- 'Blind Tilt': {
552
- model: SwitchBotModel.BlindTilt,
553
- bleModel: SwitchBotBLEModel.BlindTilt,
554
- bleModelName: SwitchBotBLEModelName.BlindTilt,
555
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.BlindTilt,
556
- },
557
- 'Plug': {
558
- model: SwitchBotModel.Plug,
559
- bleModel: SwitchBotBLEModel.PlugMiniUS,
560
- bleModelName: SwitchBotBLEModelName.PlugMini,
561
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
562
- },
563
- 'Plug Mini (US)': {
564
- model: SwitchBotModel.PlugMiniUS,
565
- bleModel: SwitchBotBLEModel.PlugMiniUS,
566
- bleModelName: SwitchBotBLEModelName.PlugMini,
567
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
568
- },
569
- 'Plug Mini (JP)': {
570
- model: SwitchBotModel.PlugMiniJP,
571
- bleModel: SwitchBotBLEModel.PlugMiniJP,
572
- bleModelName: SwitchBotBLEModelName.PlugMini,
573
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.PlugMini,
574
- },
575
- 'Smart Lock': {
576
- model: SwitchBotModel.Lock,
577
- bleModel: SwitchBotBLEModel.Lock,
578
- bleModelName: SwitchBotBLEModelName.Lock,
579
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Lock,
580
- },
581
- 'Smart Lock Pro': {
582
- model: SwitchBotModel.LockPro,
583
- bleModel: SwitchBotBLEModel.LockPro,
584
- bleModelName: SwitchBotBLEModelName.LockPro,
585
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.LockPro,
586
- },
587
- 'Color Bulb': {
588
- model: SwitchBotModel.ColorBulb,
589
- bleModel: SwitchBotBLEModel.ColorBulb,
590
- bleModelName: SwitchBotBLEModelName.ColorBulb,
591
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.ColorBulb,
592
- },
593
- 'K10+': {
594
- model: SwitchBotModel.K10,
595
- bleModel: SwitchBotBLEModel.Unknown,
596
- bleModelName: SwitchBotBLEModelName.Unknown,
597
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
598
- },
599
- 'K10+ Pro': {
600
- model: SwitchBotModel.K10Pro,
601
- bleModel: SwitchBotBLEModel.Unknown,
602
- bleModelName: SwitchBotBLEModelName.Unknown,
603
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
604
- },
605
- 'WoSweeper': {
606
- model: SwitchBotModel.WoSweeper,
607
- bleModel: SwitchBotBLEModel.Unknown,
608
- bleModelName: SwitchBotBLEModelName.Unknown,
609
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
610
- },
611
- 'WoSweeperMini': {
612
- model: SwitchBotModel.WoSweeperMini,
613
- bleModel: SwitchBotBLEModel.Unknown,
614
- bleModelName: SwitchBotBLEModelName.Unknown,
615
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
616
- },
617
- 'Robot Vacuum Cleaner S1': {
618
- model: SwitchBotModel.RobotVacuumCleanerS1,
619
- bleModel: SwitchBotBLEModel.Unknown,
620
- bleModelName: SwitchBotBLEModelName.Unknown,
621
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
622
- },
623
- 'Robot Vacuum Cleaner S1 Plus': {
624
- model: SwitchBotModel.RobotVacuumCleanerS1Plus,
625
- bleModel: SwitchBotBLEModel.Unknown,
626
- bleModelName: SwitchBotBLEModelName.Unknown,
627
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
628
- },
629
- 'Robot Vacuum Cleaner S10': {
630
- model: SwitchBotModel.RobotVacuumCleanerS10,
631
- bleModel: SwitchBotBLEModel.Unknown,
632
- bleModelName: SwitchBotBLEModelName.Unknown,
633
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
634
- },
635
- 'Ceiling Light': {
636
- model: SwitchBotModel.CeilingLight,
637
- bleModel: SwitchBotBLEModel.CeilingLight,
638
- bleModelName: SwitchBotBLEModelName.CeilingLight,
639
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.CeilingLight,
640
- },
641
- 'Ceiling Light Pro': {
642
- model: SwitchBotModel.CeilingLightPro,
643
- bleModel: SwitchBotBLEModel.CeilingLightPro,
644
- bleModelName: SwitchBotBLEModelName.CeilingLightPro,
645
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.CeilingLightPro,
646
- },
647
- 'Strip Light': {
648
- model: SwitchBotModel.StripLight,
649
- bleModel: SwitchBotBLEModel.StripLight,
650
- bleModelName: SwitchBotBLEModelName.StripLight,
651
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.StripLight,
652
- },
653
- 'Indoor Cam': {
654
- model: SwitchBotModel.IndoorCam,
655
- bleModel: SwitchBotBLEModel.Unknown,
656
- bleModelName: SwitchBotBLEModelName.Unknown,
657
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
658
- },
659
- 'Remote': {
660
- model: SwitchBotModel.Remote,
661
- bleModel: SwitchBotBLEModel.Unknown,
662
- bleModelName: SwitchBotBLEModelName.Unknown,
663
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
664
- },
665
- 'remote with screen+': {
666
- model: SwitchBotModel.UniversalRemote,
667
- bleModel: SwitchBotBLEModel.Unknown,
668
- bleModelName: SwitchBotBLEModelName.Unknown,
669
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
670
- },
671
- 'Battery Circulator Fan': {
672
- model: SwitchBotModel.BatteryCirculatorFan,
673
- bleModel: SwitchBotBLEModel.Unknown,
674
- bleModelName: SwitchBotBLEModelName.Unknown,
675
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
676
- },
677
- }
678
- const defaultDevice = {
679
- model: SwitchBotModel.Unknown,
680
- bleModel: SwitchBotBLEModel.Unknown,
681
- bleModelName: SwitchBotBLEModelName.Unknown,
682
- bleModelFriendlyName: SwitchBotBLEModelFriendlyName.Unknown,
683
- }
684
- const deviceConfig = deviceMapping[device.deviceType] || defaultDevice
685
- device.model = deviceConfig.model
686
- device.bleModel = deviceConfig.bleModel
687
- device.bleModelName = deviceConfig.bleModelName
688
- device.bleModelFriednlyName = deviceConfig.bleModelFriednlyName
689
- this.debugLog(`Model: ${device.model}, BLE Model: ${device.bleModel}, BLE Model Name: ${device.bleModelName}, BLE Model Friendly Name: ${device.bleModelFriednlyName}`)
690
-
691
- const deviceFirmwareVersion = device.firmware ?? device.version ?? accessory.context.version ?? this.platform.version ?? '0.0.0'
692
- const version = deviceFirmwareVersion.toString()
693
- this.debugLog(`Firmware Version: ${version.replace(/^V|-.*$/g, '')}`)
694
- let deviceVersion: string
695
- if (version?.includes('.') === false) {
696
- const replace = version?.replace(/^V|-.*$/g, '')
697
- const match = replace?.match(/./g)
698
- const validVersion = match?.join('.')
699
- deviceVersion = validVersion ?? '0.0.0'
700
- } else {
701
- deviceVersion = version.replace(/^V|-.*$/g, '') ?? '0.0.0'
702
- }
703
- accessory
704
- .getService(this.hap.Service.AccessoryInformation)!
705
- .setCharacteristic(this.hap.Characteristic.HardwareRevision, deviceVersion)
706
- .setCharacteristic(this.hap.Characteristic.SoftwareRevision, deviceVersion)
707
- .setCharacteristic(this.hap.Characteristic.FirmwareRevision, deviceVersion)
708
- .getCharacteristic(this.hap.Characteristic.FirmwareRevision)
709
- .updateValue(deviceVersion)
710
- accessory.context.version = deviceVersion
711
- this.debugSuccessLog(`version: ${accessory.context.version}`)
712
- }
713
-
714
- async statusCode(statusCode: number): Promise<void> {
715
- const statusMessages = {
716
- 151: 'Command not supported by this deviceType',
717
- 152: 'Device not found',
718
- 160: 'Command is not supported',
719
- 161: 'Device is offline',
720
- 171: `Hub Device is offline. Hub: ${this.device.hubDeviceId}`,
721
- 190: 'Device internal error due to device states not synchronized with server, or command format is invalid',
722
- 100: 'Command successfully sent',
723
- 200: 'Request successful',
724
- 400: 'Bad Request, an invalid payload request',
725
- 401: 'Unauthorized, Authorization for the API is required, but the request has not been authenticated',
726
- 403: 'Forbidden, The request has been authenticated but does not have appropriate permissions, or a requested resource is not found',
727
- 404: 'Not Found, Specifies the requested path does not exist',
728
- 406: 'Not Acceptable, a MIME type has been requested via the Accept header for a value not supported by the server',
729
- 415: 'Unsupported Media Type, a contentType header has been defined that is not supported by the server',
730
- 422: 'Unprocessable Entity: The server cannot process the request, often due to exceeded API limits.',
731
- 429: 'Too Many Requests, exceeded the number of requests allowed for a given time window',
732
- 500: 'Internal Server Error, An unexpected error occurred. These errors should be rare',
733
- }
734
- if (statusCode === 171 && (this.device.hubDeviceId === this.device.deviceId || this.device.hubDeviceId === '000000000000')) {
735
- this.debugErrorLog(`statusCode 171 changed to 161: hubDeviceId ${this.device.hubDeviceId} matches deviceId ${this.device.deviceId}, device is its own hub.`)
736
- statusCode = 161
737
- }
738
- const logMessage = statusMessages[statusCode] || `Unknown statusCode: ${statusCode}, Submit Bugs Here: https://tinyurl.com/SwitchBotBug`
739
- const logMethod = [100, 200].includes(statusCode) ? 'debugLog' : statusMessages[statusCode] ? 'errorLog' : 'infoLog'
740
- this[logMethod](`${logMessage}, statusCode: ${statusCode}`)
741
- }
742
-
743
- /**
744
- * Logging for Device
745
- */
746
- infoLog(...log: any[]): void {
747
- if (this.enablingDeviceLogging()) {
748
- this.log.info(`${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
749
- }
750
- }
751
-
752
- successLog(...log: any[]): void {
753
- if (this.enablingDeviceLogging()) {
754
- this.log.success(`${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
755
- }
756
- }
757
-
758
- debugSuccessLog(...log: any[]): void {
759
- if (this.enablingDeviceLogging()) {
760
- if (this.loggingIsDebug()) {
761
- this.log.success(`[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
762
- }
763
- }
764
- }
765
-
766
- warnLog(...log: any[]): void {
767
- if (this.enablingDeviceLogging()) {
768
- this.log.warn(`${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
769
- }
770
- }
771
-
772
- debugWarnLog(...log: any[]): void {
773
- if (this.enablingDeviceLogging()) {
774
- if (this.loggingIsDebug()) {
775
- this.log.warn(`[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
776
- }
777
- }
778
- }
779
-
780
- errorLog(...log: any[]): void {
781
- if (this.enablingDeviceLogging()) {
782
- this.log.error(`${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
783
- }
784
- }
785
-
786
- debugErrorLog(...log: any[]): void {
787
- if (this.enablingDeviceLogging()) {
788
- if (this.loggingIsDebug()) {
789
- this.log.error(`[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
790
- }
791
- }
792
- }
793
-
794
- debugLog(...log: any[]): void {
795
- if (this.enablingDeviceLogging()) {
796
- if (this.deviceLogging === 'debug') {
797
- this.log.info(`[DEBUG] ${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
798
- } else if (this.deviceLogging === 'debugMode') {
799
- this.log.debug(`${this.device.deviceType}: ${this.accessory.displayName}`, String(...log))
800
- }
801
- }
802
- }
803
-
804
- loggingIsDebug(): boolean {
805
- return this.deviceLogging === 'debugMode' || this.deviceLogging === 'debug'
806
- }
807
-
808
- enablingDeviceLogging(): boolean {
809
- return this.deviceLogging === 'debugMode' || this.deviceLogging === 'debug' || this.deviceLogging === 'standard'
810
- }
811
- }