@switchbot/homebridge-switchbot 5.0.0-beta.7 → 5.0.0-beta.71

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 (446) hide show
  1. package/.github/ISSUE_TEMPLATE/e2e-verification.md +36 -0
  2. package/.github/workflows/ci.yml +61 -0
  3. package/.github/workflows/manual-e2e.yml +103 -0
  4. package/CHANGELOG.md +35 -0
  5. package/E2E-VERIFICATION.md +121 -0
  6. package/MIGRATION.md +44 -0
  7. package/README.md +56 -3
  8. package/config.schema.json +99 -14823
  9. package/dist/deviceFactory.d.ts +13 -0
  10. package/dist/deviceFactory.d.ts.map +1 -0
  11. package/dist/deviceFactory.js +81 -0
  12. package/dist/deviceFactory.js.map +1 -0
  13. package/dist/devices/deviceBase.d.ts +50 -0
  14. package/dist/devices/deviceBase.d.ts.map +1 -0
  15. package/dist/devices/deviceBase.js +119 -0
  16. package/dist/devices/deviceBase.js.map +1 -0
  17. package/dist/devices/genericDevice.d.ts +283 -0
  18. package/dist/devices/genericDevice.d.ts.map +1 -0
  19. package/dist/devices/genericDevice.js +1035 -0
  20. package/dist/devices/genericDevice.js.map +1 -0
  21. package/dist/homebridge-ui/public/index.html +77 -245
  22. package/dist/homebridge-ui/server.d.ts +3 -1
  23. package/dist/homebridge-ui/server.d.ts.map +1 -1
  24. package/dist/homebridge-ui/server.js +42 -36
  25. package/dist/homebridge-ui/server.js.map +1 -1
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +5 -12
  28. package/dist/index.js.map +1 -1
  29. package/dist/platform.d.ts +27 -0
  30. package/dist/platform.d.ts.map +1 -0
  31. package/dist/platform.js +404 -0
  32. package/dist/platform.js.map +1 -0
  33. package/dist/settings.d.ts +10 -249
  34. package/dist/settings.d.ts.map +1 -1
  35. package/dist/settings.js +5 -30
  36. package/dist/settings.js.map +1 -1
  37. package/dist/switchbotClient.d.ts +32 -0
  38. package/dist/switchbotClient.d.ts.map +1 -0
  39. package/dist/switchbotClient.js +259 -0
  40. package/dist/switchbotClient.js.map +1 -0
  41. package/dist/utils.d.ts +39 -50
  42. package/dist/utils.d.ts.map +1 -1
  43. package/dist/utils.js +39 -688
  44. package/dist/utils.js.map +1 -1
  45. package/docs/assets/highlight.css +14 -0
  46. package/docs/assets/icons.js +1 -1
  47. package/docs/assets/icons.svg +1 -1
  48. package/docs/assets/main.js +2 -2
  49. package/docs/assets/style.css +3 -3
  50. package/docs/index.html +77 -13
  51. package/docs/variables/default.html +1 -1
  52. package/package.json +22 -21
  53. package/scripts/e2e/README.md +25 -0
  54. package/scripts/e2e/curtain-e2e.sh +70 -0
  55. package/scripts/e2e/fan-e2e.sh +75 -0
  56. package/scripts/e2e/light-advanced-e2e.sh +97 -0
  57. package/scripts/e2e/light-e2e.sh +75 -0
  58. package/scripts/e2e/list-accessories.sh +19 -0
  59. package/scripts/e2e/lock-e2e.sh +65 -0
  60. package/scripts/generate-matter-maps.js +60 -0
  61. package/scripts/run-e2e-local.sh +14 -0
  62. package/src/deviceFactory.ts +122 -0
  63. package/src/devices/deviceBase.ts +141 -0
  64. package/src/devices/genericDevice.ts +965 -0
  65. package/src/homebridge-ui/public/index.html +77 -245
  66. package/src/homebridge-ui/server.ts +49 -41
  67. package/src/index.ts +5 -13
  68. package/src/platform.ts +395 -0
  69. package/src/settings.ts +12 -277
  70. package/src/switchbotClient.ts +266 -0
  71. package/src/utils.ts +45 -713
  72. package/test/accessory-restore.spec.ts +73 -0
  73. package/test/device-mapping.spec.ts +37 -0
  74. package/test/deviceFactory.spec.ts +18 -0
  75. package/test/e2e/run-e2e.spec.ts +50 -0
  76. package/test/fan-swing.spec.ts +29 -0
  77. package/test/helpers/matter-harness.ts +53 -0
  78. package/test/lock-users.spec.ts +44 -0
  79. package/test/matter-childbridge.spec.ts +55 -0
  80. package/test/matter-descriptors.spec.ts +97 -0
  81. package/test/matter-device-state.spec.ts +101 -0
  82. package/test/matter-integration.spec.ts +70 -0
  83. package/test/platform.integration.spec.ts +55 -0
  84. package/test/switchbot-client-debounce.spec.ts +131 -0
  85. package/test/switchbot-client-openapi.spec.ts +56 -0
  86. package/test/switchbotClient.spec.ts +10 -0
  87. package/test/utils.spec.ts +20 -0
  88. package/vitest.config.ts +7 -0
  89. package/coverage/base.css +0 -224
  90. package/coverage/block-navigation.js +0 -87
  91. package/coverage/clover.xml +0 -15847
  92. package/coverage/coverage-final.json +0 -42
  93. package/coverage/docs/assets/dmt/dmt-component-data.js.html +0 -85
  94. package/coverage/docs/assets/dmt/dmt-components.js.html +0 -286
  95. package/coverage/docs/assets/dmt/index.html +0 -131
  96. package/coverage/docs/assets/hierarchy.js.html +0 -85
  97. package/coverage/docs/assets/icons.js.html +0 -136
  98. package/coverage/docs/assets/index.html +0 -146
  99. package/coverage/docs/assets/main.js.html +0 -265
  100. package/coverage/favicon.png +0 -0
  101. package/coverage/index.html +0 -191
  102. package/coverage/prettify.css +0 -1
  103. package/coverage/prettify.js +0 -2
  104. package/coverage/sort-arrow-sprite.png +0 -0
  105. package/coverage/sorter.js +0 -196
  106. package/coverage/src/device/blindtilt.ts.html +0 -3238
  107. package/coverage/src/device/bot.ts.html +0 -2803
  108. package/coverage/src/device/ceilinglight.ts.html +0 -2338
  109. package/coverage/src/device/colorbulb.ts.html +0 -2824
  110. package/coverage/src/device/contact.ts.html +0 -1465
  111. package/coverage/src/device/curtain.ts.html +0 -2869
  112. package/coverage/src/device/device.ts.html +0 -2500
  113. package/coverage/src/device/fan.ts.html +0 -2242
  114. package/coverage/src/device/hub.ts.html +0 -1408
  115. package/coverage/src/device/humidifier.ts.html +0 -2116
  116. package/coverage/src/device/index.html +0 -416
  117. package/coverage/src/device/iosensor.ts.html +0 -1375
  118. package/coverage/src/device/lightstrip.ts.html +0 -2617
  119. package/coverage/src/device/lock.ts.html +0 -1963
  120. package/coverage/src/device/meter.ts.html +0 -1372
  121. package/coverage/src/device/meterplus.ts.html +0 -1384
  122. package/coverage/src/device/meterpro.ts.html +0 -1618
  123. package/coverage/src/device/motion.ts.html +0 -1264
  124. package/coverage/src/device/plug.ts.html +0 -1372
  125. package/coverage/src/device/relayswitch.ts.html +0 -2284
  126. package/coverage/src/device/robotvacuumcleaner.ts.html +0 -1810
  127. package/coverage/src/device/waterdetector.ts.html +0 -1294
  128. package/coverage/src/homebridge-ui/index.html +0 -116
  129. package/coverage/src/homebridge-ui/server.ts.html +0 -229
  130. package/coverage/src/index.html +0 -161
  131. package/coverage/src/index.ts.html +0 -124
  132. package/coverage/src/irdevice/airconditioner.ts.html +0 -1687
  133. package/coverage/src/irdevice/airpurifier.ts.html +0 -844
  134. package/coverage/src/irdevice/camera.ts.html +0 -475
  135. package/coverage/src/irdevice/fan.ts.html +0 -766
  136. package/coverage/src/irdevice/index.html +0 -251
  137. package/coverage/src/irdevice/irdevice.ts.html +0 -1117
  138. package/coverage/src/irdevice/light.ts.html +0 -826
  139. package/coverage/src/irdevice/other.ts.html +0 -2458
  140. package/coverage/src/irdevice/tv.ts.html +0 -1222
  141. package/coverage/src/irdevice/vacuumcleaner.ts.html +0 -466
  142. package/coverage/src/irdevice/waterheater.ts.html +0 -469
  143. package/coverage/src/platform.ts.html +0 -8776
  144. package/coverage/src/settings.ts.html +0 -934
  145. package/coverage/src/utils.ts.html +0 -2092
  146. package/dist/devices-hap/airpurifier.d.ts +0 -54
  147. package/dist/devices-hap/airpurifier.d.ts.map +0 -1
  148. package/dist/devices-hap/airpurifier.js +0 -527
  149. package/dist/devices-hap/airpurifier.js.map +0 -1
  150. package/dist/devices-hap/blindtilt.d.ts +0 -90
  151. package/dist/devices-hap/blindtilt.d.ts.map +0 -1
  152. package/dist/devices-hap/blindtilt.js +0 -974
  153. package/dist/devices-hap/blindtilt.js.map +0 -1
  154. package/dist/devices-hap/bot.d.ts +0 -102
  155. package/dist/devices-hap/bot.d.ts.map +0 -1
  156. package/dist/devices-hap/bot.js +0 -811
  157. package/dist/devices-hap/bot.js.map +0 -1
  158. package/dist/devices-hap/ceilinglight.d.ts +0 -85
  159. package/dist/devices-hap/ceilinglight.d.ts.map +0 -1
  160. package/dist/devices-hap/ceilinglight.js +0 -701
  161. package/dist/devices-hap/ceilinglight.js.map +0 -1
  162. package/dist/devices-hap/colorbulb.d.ts +0 -88
  163. package/dist/devices-hap/colorbulb.d.ts.map +0 -1
  164. package/dist/devices-hap/colorbulb.js +0 -881
  165. package/dist/devices-hap/colorbulb.js.map +0 -1
  166. package/dist/devices-hap/contact.d.ts +0 -44
  167. package/dist/devices-hap/contact.d.ts.map +0 -1
  168. package/dist/devices-hap/contact.js +0 -409
  169. package/dist/devices-hap/contact.js.map +0 -1
  170. package/dist/devices-hap/curtain.d.ts +0 -73
  171. package/dist/devices-hap/curtain.d.ts.map +0 -1
  172. package/dist/devices-hap/curtain.js +0 -869
  173. package/dist/devices-hap/curtain.js.map +0 -1
  174. package/dist/devices-hap/device.d.ts +0 -98
  175. package/dist/devices-hap/device.d.ts.map +0 -1
  176. package/dist/devices-hap/device.js +0 -749
  177. package/dist/devices-hap/device.js.map +0 -1
  178. package/dist/devices-hap/fan.d.ts +0 -69
  179. package/dist/devices-hap/fan.d.ts.map +0 -1
  180. package/dist/devices-hap/fan.js +0 -649
  181. package/dist/devices-hap/fan.js.map +0 -1
  182. package/dist/devices-hap/hub.d.ts +0 -37
  183. package/dist/devices-hap/hub.d.ts.map +0 -1
  184. package/dist/devices-hap/hub.js +0 -392
  185. package/dist/devices-hap/hub.js.map +0 -1
  186. package/dist/devices-hap/humidifier.d.ts +0 -68
  187. package/dist/devices-hap/humidifier.d.ts.map +0 -1
  188. package/dist/devices-hap/humidifier.js +0 -628
  189. package/dist/devices-hap/humidifier.js.map +0 -1
  190. package/dist/devices-hap/iosensor.d.ts +0 -42
  191. package/dist/devices-hap/iosensor.d.ts.map +0 -1
  192. package/dist/devices-hap/iosensor.js +0 -382
  193. package/dist/devices-hap/iosensor.js.map +0 -1
  194. package/dist/devices-hap/lightstrip.d.ts +0 -79
  195. package/dist/devices-hap/lightstrip.d.ts.map +0 -1
  196. package/dist/devices-hap/lightstrip.js +0 -797
  197. package/dist/devices-hap/lightstrip.js.map +0 -1
  198. package/dist/devices-hap/lock.d.ts +0 -53
  199. package/dist/devices-hap/lock.d.ts.map +0 -1
  200. package/dist/devices-hap/lock.js +0 -561
  201. package/dist/devices-hap/lock.js.map +0 -1
  202. package/dist/devices-hap/meter.d.ts +0 -37
  203. package/dist/devices-hap/meter.d.ts.map +0 -1
  204. package/dist/devices-hap/meter.js +0 -379
  205. package/dist/devices-hap/meter.js.map +0 -1
  206. package/dist/devices-hap/meterplus.d.ts +0 -42
  207. package/dist/devices-hap/meterplus.d.ts.map +0 -1
  208. package/dist/devices-hap/meterplus.js +0 -384
  209. package/dist/devices-hap/meterplus.js.map +0 -1
  210. package/dist/devices-hap/meterpro.d.ts +0 -43
  211. package/dist/devices-hap/meterpro.d.ts.map +0 -1
  212. package/dist/devices-hap/meterpro.js +0 -468
  213. package/dist/devices-hap/meterpro.js.map +0 -1
  214. package/dist/devices-hap/motion.d.ts +0 -42
  215. package/dist/devices-hap/motion.d.ts.map +0 -1
  216. package/dist/devices-hap/motion.js +0 -345
  217. package/dist/devices-hap/motion.js.map +0 -1
  218. package/dist/devices-hap/plug.d.ts +0 -49
  219. package/dist/devices-hap/plug.d.ts.map +0 -1
  220. package/dist/devices-hap/plug.js +0 -395
  221. package/dist/devices-hap/plug.js.map +0 -1
  222. package/dist/devices-hap/relayswitch.d.ts +0 -96
  223. package/dist/devices-hap/relayswitch.d.ts.map +0 -1
  224. package/dist/devices-hap/relayswitch.js +0 -642
  225. package/dist/devices-hap/relayswitch.js.map +0 -1
  226. package/dist/devices-hap/robotvacuumcleaner.d.ts +0 -54
  227. package/dist/devices-hap/robotvacuumcleaner.d.ts.map +0 -1
  228. package/dist/devices-hap/robotvacuumcleaner.js +0 -523
  229. package/dist/devices-hap/robotvacuumcleaner.js.map +0 -1
  230. package/dist/devices-hap/waterdetector.d.ts +0 -41
  231. package/dist/devices-hap/waterdetector.d.ts.map +0 -1
  232. package/dist/devices-hap/waterdetector.js +0 -356
  233. package/dist/devices-hap/waterdetector.js.map +0 -1
  234. package/dist/devices-matter/BaseMatterAccessory.d.ts +0 -63
  235. package/dist/devices-matter/BaseMatterAccessory.d.ts.map +0 -1
  236. package/dist/devices-matter/BaseMatterAccessory.js +0 -100
  237. package/dist/devices-matter/BaseMatterAccessory.js.map +0 -1
  238. package/dist/devices-matter/ColorLightAccessory.d.ts +0 -20
  239. package/dist/devices-matter/ColorLightAccessory.d.ts.map +0 -1
  240. package/dist/devices-matter/ColorLightAccessory.js +0 -95
  241. package/dist/devices-matter/ColorLightAccessory.js.map +0 -1
  242. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts +0 -18
  243. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts.map +0 -1
  244. package/dist/devices-matter/ColorTemperatureLightAccessory.js +0 -78
  245. package/dist/devices-matter/ColorTemperatureLightAccessory.js.map +0 -1
  246. package/dist/devices-matter/ContactSensorAccessory.d.ts +0 -12
  247. package/dist/devices-matter/ContactSensorAccessory.d.ts.map +0 -1
  248. package/dist/devices-matter/ContactSensorAccessory.js +0 -34
  249. package/dist/devices-matter/ContactSensorAccessory.js.map +0 -1
  250. package/dist/devices-matter/DimmableLightAccessory.d.ts +0 -58
  251. package/dist/devices-matter/DimmableLightAccessory.d.ts.map +0 -1
  252. package/dist/devices-matter/DimmableLightAccessory.js +0 -167
  253. package/dist/devices-matter/DimmableLightAccessory.js.map +0 -1
  254. package/dist/devices-matter/DoorLockAccessory.d.ts +0 -14
  255. package/dist/devices-matter/DoorLockAccessory.d.ts.map +0 -1
  256. package/dist/devices-matter/DoorLockAccessory.js +0 -50
  257. package/dist/devices-matter/DoorLockAccessory.js.map +0 -1
  258. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts +0 -21
  259. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts.map +0 -1
  260. package/dist/devices-matter/ExtendedColorLightAccessory.js +0 -107
  261. package/dist/devices-matter/ExtendedColorLightAccessory.js.map +0 -1
  262. package/dist/devices-matter/FanAccessory.d.ts +0 -16
  263. package/dist/devices-matter/FanAccessory.d.ts.map +0 -1
  264. package/dist/devices-matter/FanAccessory.js +0 -81
  265. package/dist/devices-matter/FanAccessory.js.map +0 -1
  266. package/dist/devices-matter/HumiditySensorAccessory.d.ts +0 -12
  267. package/dist/devices-matter/HumiditySensorAccessory.d.ts.map +0 -1
  268. package/dist/devices-matter/HumiditySensorAccessory.js +0 -34
  269. package/dist/devices-matter/HumiditySensorAccessory.js.map +0 -1
  270. package/dist/devices-matter/LeakSensorAccessory.d.ts +0 -12
  271. package/dist/devices-matter/LeakSensorAccessory.d.ts.map +0 -1
  272. package/dist/devices-matter/LeakSensorAccessory.js +0 -33
  273. package/dist/devices-matter/LeakSensorAccessory.js.map +0 -1
  274. package/dist/devices-matter/LightSensorAccessory.d.ts +0 -12
  275. package/dist/devices-matter/LightSensorAccessory.d.ts.map +0 -1
  276. package/dist/devices-matter/LightSensorAccessory.js +0 -34
  277. package/dist/devices-matter/LightSensorAccessory.js.map +0 -1
  278. package/dist/devices-matter/OccupancySensorAccessory.d.ts +0 -12
  279. package/dist/devices-matter/OccupancySensorAccessory.d.ts.map +0 -1
  280. package/dist/devices-matter/OccupancySensorAccessory.js +0 -39
  281. package/dist/devices-matter/OccupancySensorAccessory.js.map +0 -1
  282. package/dist/devices-matter/OnOffLightAccessory.d.ts +0 -38
  283. package/dist/devices-matter/OnOffLightAccessory.d.ts.map +0 -1
  284. package/dist/devices-matter/OnOffLightAccessory.js +0 -118
  285. package/dist/devices-matter/OnOffLightAccessory.js.map +0 -1
  286. package/dist/devices-matter/OnOffOutletAccessory.d.ts +0 -12
  287. package/dist/devices-matter/OnOffOutletAccessory.d.ts.map +0 -1
  288. package/dist/devices-matter/OnOffOutletAccessory.js +0 -40
  289. package/dist/devices-matter/OnOffOutletAccessory.js.map +0 -1
  290. package/dist/devices-matter/OnOffSwitchAccessory.d.ts +0 -14
  291. package/dist/devices-matter/OnOffSwitchAccessory.d.ts.map +0 -1
  292. package/dist/devices-matter/OnOffSwitchAccessory.js +0 -42
  293. package/dist/devices-matter/OnOffSwitchAccessory.js.map +0 -1
  294. package/dist/devices-matter/RoboticVacuumAccessory.d.ts +0 -68
  295. package/dist/devices-matter/RoboticVacuumAccessory.d.ts.map +0 -1
  296. package/dist/devices-matter/RoboticVacuumAccessory.js +0 -334
  297. package/dist/devices-matter/RoboticVacuumAccessory.js.map +0 -1
  298. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts +0 -11
  299. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts.map +0 -1
  300. package/dist/devices-matter/SmokeCOAlarmAccessory.js +0 -49
  301. package/dist/devices-matter/SmokeCOAlarmAccessory.js.map +0 -1
  302. package/dist/devices-matter/TemperatureSensorAccessory.d.ts +0 -12
  303. package/dist/devices-matter/TemperatureSensorAccessory.d.ts.map +0 -1
  304. package/dist/devices-matter/TemperatureSensorAccessory.js +0 -36
  305. package/dist/devices-matter/TemperatureSensorAccessory.js.map +0 -1
  306. package/dist/devices-matter/ThermostatAccessory.d.ts +0 -19
  307. package/dist/devices-matter/ThermostatAccessory.d.ts.map +0 -1
  308. package/dist/devices-matter/ThermostatAccessory.js +0 -95
  309. package/dist/devices-matter/ThermostatAccessory.js.map +0 -1
  310. package/dist/devices-matter/VenetianBlindAccessory.d.ts +0 -19
  311. package/dist/devices-matter/VenetianBlindAccessory.d.ts.map +0 -1
  312. package/dist/devices-matter/VenetianBlindAccessory.js +0 -99
  313. package/dist/devices-matter/VenetianBlindAccessory.js.map +0 -1
  314. package/dist/devices-matter/WindowBlindAccessory.d.ts +0 -17
  315. package/dist/devices-matter/WindowBlindAccessory.d.ts.map +0 -1
  316. package/dist/devices-matter/WindowBlindAccessory.js +0 -80
  317. package/dist/devices-matter/WindowBlindAccessory.js.map +0 -1
  318. package/dist/devices-matter/custom/PowerStripAccessory.d.ts +0 -97
  319. package/dist/devices-matter/custom/PowerStripAccessory.d.ts.map +0 -1
  320. package/dist/devices-matter/custom/PowerStripAccessory.js +0 -265
  321. package/dist/devices-matter/custom/PowerStripAccessory.js.map +0 -1
  322. package/dist/devices-matter/custom/index.d.ts +0 -8
  323. package/dist/devices-matter/custom/index.d.ts.map +0 -1
  324. package/dist/devices-matter/custom/index.js +0 -8
  325. package/dist/devices-matter/custom/index.js.map +0 -1
  326. package/dist/devices-matter/index.d.ts +0 -29
  327. package/dist/devices-matter/index.d.ts.map +0 -1
  328. package/dist/devices-matter/index.js +0 -28
  329. package/dist/devices-matter/index.js.map +0 -1
  330. package/dist/index.test.d.ts +0 -2
  331. package/dist/index.test.d.ts.map +0 -1
  332. package/dist/index.test.js +0 -14
  333. package/dist/index.test.js.map +0 -1
  334. package/dist/irdevice/airconditioner.d.ts +0 -61
  335. package/dist/irdevice/airconditioner.d.ts.map +0 -1
  336. package/dist/irdevice/airconditioner.js +0 -472
  337. package/dist/irdevice/airconditioner.js.map +0 -1
  338. package/dist/irdevice/airpurifier.d.ts +0 -50
  339. package/dist/irdevice/airpurifier.d.ts.map +0 -1
  340. package/dist/irdevice/airpurifier.js +0 -213
  341. package/dist/irdevice/airpurifier.js.map +0 -1
  342. package/dist/irdevice/camera.d.ts +0 -32
  343. package/dist/irdevice/camera.d.ts.map +0 -1
  344. package/dist/irdevice/camera.js +0 -107
  345. package/dist/irdevice/camera.js.map +0 -1
  346. package/dist/irdevice/fan.d.ts +0 -36
  347. package/dist/irdevice/fan.d.ts.map +0 -1
  348. package/dist/irdevice/fan.js +0 -200
  349. package/dist/irdevice/fan.js.map +0 -1
  350. package/dist/irdevice/irdevice.d.ts +0 -68
  351. package/dist/irdevice/irdevice.d.ts.map +0 -1
  352. package/dist/irdevice/irdevice.js +0 -298
  353. package/dist/irdevice/irdevice.js.map +0 -1
  354. package/dist/irdevice/light.d.ts +0 -36
  355. package/dist/irdevice/light.d.ts.map +0 -1
  356. package/dist/irdevice/light.js +0 -206
  357. package/dist/irdevice/light.js.map +0 -1
  358. package/dist/irdevice/other.d.ts +0 -57
  359. package/dist/irdevice/other.d.ts.map +0 -1
  360. package/dist/irdevice/other.js +0 -778
  361. package/dist/irdevice/other.js.map +0 -1
  362. package/dist/irdevice/tv.d.ts +0 -45
  363. package/dist/irdevice/tv.d.ts.map +0 -1
  364. package/dist/irdevice/tv.js +0 -327
  365. package/dist/irdevice/tv.js.map +0 -1
  366. package/dist/irdevice/vacuumcleaner.d.ts +0 -28
  367. package/dist/irdevice/vacuumcleaner.d.ts.map +0 -1
  368. package/dist/irdevice/vacuumcleaner.js +0 -104
  369. package/dist/irdevice/vacuumcleaner.js.map +0 -1
  370. package/dist/irdevice/waterheater.d.ts +0 -30
  371. package/dist/irdevice/waterheater.d.ts.map +0 -1
  372. package/dist/irdevice/waterheater.js +0 -105
  373. package/dist/irdevice/waterheater.js.map +0 -1
  374. package/dist/platform-hap.d.ts +0 -149
  375. package/dist/platform-hap.d.ts.map +0 -1
  376. package/dist/platform-hap.js +0 -2861
  377. package/dist/platform-hap.js.map +0 -1
  378. package/dist/platform-matter.d.ts +0 -101
  379. package/dist/platform-matter.d.ts.map +0 -1
  380. package/dist/platform-matter.js +0 -896
  381. package/dist/platform-matter.js.map +0 -1
  382. package/dist/verifyconfig.test.d.ts +0 -2
  383. package/dist/verifyconfig.test.d.ts.map +0 -1
  384. package/dist/verifyconfig.test.js +0 -167
  385. package/dist/verifyconfig.test.js.map +0 -1
  386. package/src/custom.d.ts +0 -7
  387. package/src/devices-hap/airpurifier.ts +0 -563
  388. package/src/devices-hap/blindtilt.ts +0 -1049
  389. package/src/devices-hap/bot.ts +0 -900
  390. package/src/devices-hap/ceilinglight.ts +0 -742
  391. package/src/devices-hap/colorbulb.ts +0 -904
  392. package/src/devices-hap/contact.ts +0 -457
  393. package/src/devices-hap/curtain.ts +0 -944
  394. package/src/devices-hap/device.ts +0 -811
  395. package/src/devices-hap/fan.ts +0 -711
  396. package/src/devices-hap/hub.ts +0 -439
  397. package/src/devices-hap/humidifier.ts +0 -669
  398. package/src/devices-hap/iosensor.ts +0 -427
  399. package/src/devices-hap/lightstrip.ts +0 -836
  400. package/src/devices-hap/lock.ts +0 -620
  401. package/src/devices-hap/meter.ts +0 -426
  402. package/src/devices-hap/meterplus.ts +0 -430
  403. package/src/devices-hap/meterpro.ts +0 -522
  404. package/src/devices-hap/motion.ts +0 -390
  405. package/src/devices-hap/plug.ts +0 -423
  406. package/src/devices-hap/relayswitch.ts +0 -727
  407. package/src/devices-hap/robotvacuumcleaner.ts +0 -568
  408. package/src/devices-hap/waterdetector.ts +0 -400
  409. package/src/devices-matter/BaseMatterAccessory.ts +0 -131
  410. package/src/devices-matter/ColorLightAccessory.ts +0 -110
  411. package/src/devices-matter/ColorTemperatureLightAccessory.ts +0 -92
  412. package/src/devices-matter/ContactSensorAccessory.ts +0 -41
  413. package/src/devices-matter/DimmableLightAccessory.ts +0 -192
  414. package/src/devices-matter/DoorLockAccessory.ts +0 -60
  415. package/src/devices-matter/ExtendedColorLightAccessory.ts +0 -123
  416. package/src/devices-matter/FanAccessory.ts +0 -95
  417. package/src/devices-matter/HumiditySensorAccessory.ts +0 -41
  418. package/src/devices-matter/LeakSensorAccessory.ts +0 -40
  419. package/src/devices-matter/LightSensorAccessory.ts +0 -41
  420. package/src/devices-matter/OccupancySensorAccessory.ts +0 -48
  421. package/src/devices-matter/OnOffLightAccessory.ts +0 -133
  422. package/src/devices-matter/OnOffOutletAccessory.ts +0 -46
  423. package/src/devices-matter/OnOffSwitchAccessory.ts +0 -51
  424. package/src/devices-matter/RoboticVacuumAccessory.ts +0 -407
  425. package/src/devices-matter/SmokeCOAlarmAccessory.ts +0 -59
  426. package/src/devices-matter/TemperatureSensorAccessory.ts +0 -43
  427. package/src/devices-matter/ThermostatAccessory.ts +0 -110
  428. package/src/devices-matter/VenetianBlindAccessory.ts +0 -115
  429. package/src/devices-matter/WindowBlindAccessory.ts +0 -92
  430. package/src/devices-matter/custom/PowerStripAccessory.ts +0 -309
  431. package/src/devices-matter/custom/index.ts +0 -8
  432. package/src/devices-matter/index.ts +0 -29
  433. package/src/index.test.ts +0 -19
  434. package/src/irdevice/airconditioner.ts +0 -533
  435. package/src/irdevice/airpurifier.ts +0 -252
  436. package/src/irdevice/camera.ts +0 -129
  437. package/src/irdevice/fan.ts +0 -226
  438. package/src/irdevice/irdevice.ts +0 -344
  439. package/src/irdevice/light.ts +0 -246
  440. package/src/irdevice/other.ts +0 -790
  441. package/src/irdevice/tv.ts +0 -378
  442. package/src/irdevice/vacuumcleaner.ts +0 -126
  443. package/src/irdevice/waterheater.ts +0 -127
  444. package/src/platform-hap.ts +0 -2997
  445. package/src/platform-matter.ts +0 -1010
  446. 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
- }