@switchbot/homebridge-switchbot 4.3.2-beta.8 → 5.0.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (410) hide show
  1. package/.github/copilot-instructions.md +328 -0
  2. package/.github/workflows/beta-release.yml +8 -12
  3. package/.github/workflows/release.yml +57 -21
  4. package/README.md +13 -10
  5. package/config.schema.json +1 -12
  6. package/coverage/base.css +224 -0
  7. package/coverage/block-navigation.js +87 -0
  8. package/coverage/clover.xml +15847 -0
  9. package/coverage/coverage-final.json +42 -0
  10. package/coverage/docs/assets/dmt/dmt-component-data.js.html +85 -0
  11. package/coverage/docs/assets/dmt/dmt-components.js.html +286 -0
  12. package/coverage/docs/assets/dmt/index.html +131 -0
  13. package/coverage/docs/assets/hierarchy.js.html +85 -0
  14. package/coverage/docs/assets/icons.js.html +136 -0
  15. package/coverage/docs/assets/index.html +146 -0
  16. package/coverage/docs/assets/main.js.html +265 -0
  17. package/coverage/favicon.png +0 -0
  18. package/coverage/index.html +191 -0
  19. package/coverage/prettify.css +1 -0
  20. package/coverage/prettify.js +2 -0
  21. package/coverage/sort-arrow-sprite.png +0 -0
  22. package/coverage/sorter.js +196 -0
  23. package/coverage/src/device/blindtilt.ts.html +3238 -0
  24. package/coverage/src/device/bot.ts.html +2803 -0
  25. package/coverage/src/device/ceilinglight.ts.html +2338 -0
  26. package/coverage/src/device/colorbulb.ts.html +2824 -0
  27. package/coverage/src/device/contact.ts.html +1465 -0
  28. package/coverage/src/device/curtain.ts.html +2869 -0
  29. package/coverage/src/device/device.ts.html +2500 -0
  30. package/coverage/src/device/fan.ts.html +2242 -0
  31. package/coverage/src/device/hub.ts.html +1408 -0
  32. package/coverage/src/device/humidifier.ts.html +2116 -0
  33. package/coverage/src/device/index.html +416 -0
  34. package/coverage/src/device/iosensor.ts.html +1375 -0
  35. package/coverage/src/device/lightstrip.ts.html +2617 -0
  36. package/coverage/src/device/lock.ts.html +1963 -0
  37. package/coverage/src/device/meter.ts.html +1372 -0
  38. package/coverage/src/device/meterplus.ts.html +1384 -0
  39. package/coverage/src/device/meterpro.ts.html +1618 -0
  40. package/coverage/src/device/motion.ts.html +1264 -0
  41. package/coverage/src/device/plug.ts.html +1372 -0
  42. package/coverage/src/device/relayswitch.ts.html +2284 -0
  43. package/coverage/src/device/robotvacuumcleaner.ts.html +1810 -0
  44. package/coverage/src/device/waterdetector.ts.html +1294 -0
  45. package/coverage/src/homebridge-ui/index.html +116 -0
  46. package/coverage/src/homebridge-ui/server.ts.html +229 -0
  47. package/coverage/src/index.html +161 -0
  48. package/coverage/src/index.ts.html +124 -0
  49. package/coverage/src/irdevice/airconditioner.ts.html +1687 -0
  50. package/coverage/src/irdevice/airpurifier.ts.html +844 -0
  51. package/coverage/src/irdevice/camera.ts.html +475 -0
  52. package/coverage/src/irdevice/fan.ts.html +766 -0
  53. package/coverage/src/irdevice/index.html +251 -0
  54. package/coverage/src/irdevice/irdevice.ts.html +1117 -0
  55. package/coverage/src/irdevice/light.ts.html +826 -0
  56. package/coverage/src/irdevice/other.ts.html +2458 -0
  57. package/coverage/src/irdevice/tv.ts.html +1222 -0
  58. package/coverage/src/irdevice/vacuumcleaner.ts.html +466 -0
  59. package/coverage/src/irdevice/waterheater.ts.html +469 -0
  60. package/coverage/src/platform.ts.html +8776 -0
  61. package/coverage/src/settings.ts.html +934 -0
  62. package/coverage/src/utils.ts.html +2092 -0
  63. package/dist/{device → devices-hap}/airpurifier.d.ts +3 -3
  64. package/dist/devices-hap/airpurifier.d.ts.map +1 -0
  65. package/dist/devices-hap/airpurifier.js.map +1 -0
  66. package/dist/{device → devices-hap}/blindtilt.d.ts +3 -3
  67. package/dist/devices-hap/blindtilt.d.ts.map +1 -0
  68. package/dist/{device → devices-hap}/blindtilt.js +6 -1
  69. package/dist/devices-hap/blindtilt.js.map +1 -0
  70. package/dist/{device → devices-hap}/bot.d.ts +3 -3
  71. package/dist/devices-hap/bot.d.ts.map +1 -0
  72. package/dist/devices-hap/bot.js.map +1 -0
  73. package/dist/{device → devices-hap}/ceilinglight.d.ts +3 -3
  74. package/dist/devices-hap/ceilinglight.d.ts.map +1 -0
  75. package/dist/devices-hap/ceilinglight.js.map +1 -0
  76. package/dist/{device → devices-hap}/colorbulb.d.ts +3 -3
  77. package/dist/devices-hap/colorbulb.d.ts.map +1 -0
  78. package/dist/devices-hap/colorbulb.js.map +1 -0
  79. package/dist/{device → devices-hap}/contact.d.ts +3 -3
  80. package/dist/devices-hap/contact.d.ts.map +1 -0
  81. package/dist/devices-hap/contact.js.map +1 -0
  82. package/dist/{device → devices-hap}/curtain.d.ts +3 -3
  83. package/dist/devices-hap/curtain.d.ts.map +1 -0
  84. package/dist/{device → devices-hap}/curtain.js +32 -8
  85. package/dist/devices-hap/curtain.js.map +1 -0
  86. package/dist/{device → devices-hap}/device.d.ts +3 -3
  87. package/dist/devices-hap/device.d.ts.map +1 -0
  88. package/dist/{device → devices-hap}/device.js +10 -4
  89. package/dist/devices-hap/device.js.map +1 -0
  90. package/dist/{device → devices-hap}/fan.d.ts +3 -3
  91. package/dist/devices-hap/fan.d.ts.map +1 -0
  92. package/dist/devices-hap/fan.js.map +1 -0
  93. package/dist/{device → devices-hap}/hub.d.ts +5 -5
  94. package/dist/devices-hap/hub.d.ts.map +1 -0
  95. package/dist/{device → devices-hap}/hub.js +2 -1
  96. package/dist/devices-hap/hub.js.map +1 -0
  97. package/dist/{device → devices-hap}/humidifier.d.ts +3 -3
  98. package/dist/devices-hap/humidifier.d.ts.map +1 -0
  99. package/dist/devices-hap/humidifier.js.map +1 -0
  100. package/dist/{device → devices-hap}/iosensor.d.ts +3 -3
  101. package/dist/devices-hap/iosensor.d.ts.map +1 -0
  102. package/dist/devices-hap/iosensor.js.map +1 -0
  103. package/dist/{device → devices-hap}/lightstrip.d.ts +3 -3
  104. package/dist/devices-hap/lightstrip.d.ts.map +1 -0
  105. package/dist/devices-hap/lightstrip.js.map +1 -0
  106. package/dist/{device → devices-hap}/lock.d.ts +3 -3
  107. package/dist/devices-hap/lock.d.ts.map +1 -0
  108. package/dist/devices-hap/lock.js.map +1 -0
  109. package/dist/{device → devices-hap}/meter.d.ts +3 -3
  110. package/dist/devices-hap/meter.d.ts.map +1 -0
  111. package/dist/devices-hap/meter.js.map +1 -0
  112. package/dist/{device → devices-hap}/meterplus.d.ts +3 -3
  113. package/dist/devices-hap/meterplus.d.ts.map +1 -0
  114. package/dist/devices-hap/meterplus.js.map +1 -0
  115. package/dist/{device → devices-hap}/meterpro.d.ts +3 -3
  116. package/dist/devices-hap/meterpro.d.ts.map +1 -0
  117. package/dist/{device → devices-hap}/meterpro.js +16 -3
  118. package/dist/devices-hap/meterpro.js.map +1 -0
  119. package/dist/{device → devices-hap}/motion.d.ts +3 -3
  120. package/dist/devices-hap/motion.d.ts.map +1 -0
  121. package/dist/devices-hap/motion.js.map +1 -0
  122. package/dist/{device → devices-hap}/plug.d.ts +3 -3
  123. package/dist/devices-hap/plug.d.ts.map +1 -0
  124. package/dist/devices-hap/plug.js.map +1 -0
  125. package/dist/{device → devices-hap}/relayswitch.d.ts +3 -3
  126. package/dist/devices-hap/relayswitch.d.ts.map +1 -0
  127. package/dist/devices-hap/relayswitch.js.map +1 -0
  128. package/dist/{device → devices-hap}/robotvacuumcleaner.d.ts +3 -3
  129. package/dist/devices-hap/robotvacuumcleaner.d.ts.map +1 -0
  130. package/dist/devices-hap/robotvacuumcleaner.js.map +1 -0
  131. package/dist/{device → devices-hap}/waterdetector.d.ts +3 -3
  132. package/dist/devices-hap/waterdetector.d.ts.map +1 -0
  133. package/dist/devices-hap/waterdetector.js.map +1 -0
  134. package/dist/devices-matter/BaseMatterAccessory.d.ts +63 -0
  135. package/dist/devices-matter/BaseMatterAccessory.d.ts.map +1 -0
  136. package/dist/devices-matter/BaseMatterAccessory.js +100 -0
  137. package/dist/devices-matter/BaseMatterAccessory.js.map +1 -0
  138. package/dist/devices-matter/ColorLightAccessory.d.ts +18 -0
  139. package/dist/devices-matter/ColorLightAccessory.d.ts.map +1 -0
  140. package/dist/devices-matter/ColorLightAccessory.js +96 -0
  141. package/dist/devices-matter/ColorLightAccessory.js.map +1 -0
  142. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts +16 -0
  143. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts.map +1 -0
  144. package/dist/devices-matter/ColorTemperatureLightAccessory.js +83 -0
  145. package/dist/devices-matter/ColorTemperatureLightAccessory.js.map +1 -0
  146. package/dist/devices-matter/ContactSensorAccessory.d.ts +10 -0
  147. package/dist/devices-matter/ContactSensorAccessory.d.ts.map +1 -0
  148. package/dist/devices-matter/ContactSensorAccessory.js +31 -0
  149. package/dist/devices-matter/ContactSensorAccessory.js.map +1 -0
  150. package/dist/devices-matter/DimmableLightAccessory.d.ts +56 -0
  151. package/dist/devices-matter/DimmableLightAccessory.d.ts.map +1 -0
  152. package/dist/devices-matter/DimmableLightAccessory.js +170 -0
  153. package/dist/devices-matter/DimmableLightAccessory.js.map +1 -0
  154. package/dist/devices-matter/DoorLockAccessory.d.ts +12 -0
  155. package/dist/devices-matter/DoorLockAccessory.d.ts.map +1 -0
  156. package/dist/devices-matter/DoorLockAccessory.js +47 -0
  157. package/dist/devices-matter/DoorLockAccessory.js.map +1 -0
  158. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts +19 -0
  159. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts.map +1 -0
  160. package/dist/devices-matter/ExtendedColorLightAccessory.js +108 -0
  161. package/dist/devices-matter/ExtendedColorLightAccessory.js.map +1 -0
  162. package/dist/devices-matter/FanAccessory.d.ts +14 -0
  163. package/dist/devices-matter/FanAccessory.d.ts.map +1 -0
  164. package/dist/devices-matter/FanAccessory.js +73 -0
  165. package/dist/devices-matter/FanAccessory.js.map +1 -0
  166. package/dist/devices-matter/HumiditySensorAccessory.d.ts +10 -0
  167. package/dist/devices-matter/HumiditySensorAccessory.d.ts.map +1 -0
  168. package/dist/devices-matter/HumiditySensorAccessory.js +33 -0
  169. package/dist/devices-matter/HumiditySensorAccessory.js.map +1 -0
  170. package/dist/devices-matter/LeakSensorAccessory.d.ts +10 -0
  171. package/dist/devices-matter/LeakSensorAccessory.d.ts.map +1 -0
  172. package/dist/devices-matter/LeakSensorAccessory.js +30 -0
  173. package/dist/devices-matter/LeakSensorAccessory.js.map +1 -0
  174. package/dist/devices-matter/LightSensorAccessory.d.ts +10 -0
  175. package/dist/devices-matter/LightSensorAccessory.d.ts.map +1 -0
  176. package/dist/devices-matter/LightSensorAccessory.js +33 -0
  177. package/dist/devices-matter/LightSensorAccessory.js.map +1 -0
  178. package/dist/devices-matter/OccupancySensorAccessory.d.ts +10 -0
  179. package/dist/devices-matter/OccupancySensorAccessory.d.ts.map +1 -0
  180. package/dist/devices-matter/OccupancySensorAccessory.js +43 -0
  181. package/dist/devices-matter/OccupancySensorAccessory.js.map +1 -0
  182. package/dist/devices-matter/OnOffLightAccessory.d.ts +36 -0
  183. package/dist/devices-matter/OnOffLightAccessory.d.ts.map +1 -0
  184. package/dist/devices-matter/OnOffLightAccessory.js +117 -0
  185. package/dist/devices-matter/OnOffLightAccessory.js.map +1 -0
  186. package/dist/devices-matter/OnOffOutletAccessory.d.ts +12 -0
  187. package/dist/devices-matter/OnOffOutletAccessory.d.ts.map +1 -0
  188. package/dist/devices-matter/OnOffOutletAccessory.js +43 -0
  189. package/dist/devices-matter/OnOffOutletAccessory.js.map +1 -0
  190. package/dist/devices-matter/OnOffSwitchAccessory.d.ts +12 -0
  191. package/dist/devices-matter/OnOffSwitchAccessory.d.ts.map +1 -0
  192. package/dist/devices-matter/OnOffSwitchAccessory.js +43 -0
  193. package/dist/devices-matter/OnOffSwitchAccessory.js.map +1 -0
  194. package/dist/devices-matter/RoboticVacuumAccessory.d.ts +66 -0
  195. package/dist/devices-matter/RoboticVacuumAccessory.d.ts.map +1 -0
  196. package/dist/devices-matter/RoboticVacuumAccessory.js +402 -0
  197. package/dist/devices-matter/RoboticVacuumAccessory.js.map +1 -0
  198. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts +11 -0
  199. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts.map +1 -0
  200. package/dist/devices-matter/SmokeCOAlarmAccessory.js +49 -0
  201. package/dist/devices-matter/SmokeCOAlarmAccessory.js.map +1 -0
  202. package/dist/devices-matter/TemperatureSensorAccessory.d.ts +10 -0
  203. package/dist/devices-matter/TemperatureSensorAccessory.d.ts.map +1 -0
  204. package/dist/devices-matter/TemperatureSensorAccessory.js +33 -0
  205. package/dist/devices-matter/TemperatureSensorAccessory.js.map +1 -0
  206. package/dist/devices-matter/ThermostatAccessory.d.ts +17 -0
  207. package/dist/devices-matter/ThermostatAccessory.d.ts.map +1 -0
  208. package/dist/devices-matter/ThermostatAccessory.js +87 -0
  209. package/dist/devices-matter/ThermostatAccessory.js.map +1 -0
  210. package/dist/devices-matter/VenetianBlindAccessory.d.ts +17 -0
  211. package/dist/devices-matter/VenetianBlindAccessory.d.ts.map +1 -0
  212. package/dist/devices-matter/VenetianBlindAccessory.js +100 -0
  213. package/dist/devices-matter/VenetianBlindAccessory.js.map +1 -0
  214. package/dist/devices-matter/WindowBlindAccessory.d.ts +15 -0
  215. package/dist/devices-matter/WindowBlindAccessory.d.ts.map +1 -0
  216. package/dist/devices-matter/WindowBlindAccessory.js +81 -0
  217. package/dist/devices-matter/WindowBlindAccessory.js.map +1 -0
  218. package/dist/devices-matter/custom/PowerStripAccessory.d.ts +97 -0
  219. package/dist/devices-matter/custom/PowerStripAccessory.d.ts.map +1 -0
  220. package/dist/devices-matter/custom/PowerStripAccessory.js +265 -0
  221. package/dist/devices-matter/custom/PowerStripAccessory.js.map +1 -0
  222. package/dist/devices-matter/custom/index.d.ts +8 -0
  223. package/dist/devices-matter/custom/index.d.ts.map +1 -0
  224. package/dist/devices-matter/custom/index.js +8 -0
  225. package/dist/devices-matter/custom/index.js.map +1 -0
  226. package/dist/devices-matter/index.d.ts +29 -0
  227. package/dist/devices-matter/index.d.ts.map +1 -0
  228. package/dist/devices-matter/index.js +28 -0
  229. package/dist/devices-matter/index.js.map +1 -0
  230. package/dist/homebridge-ui/public/index.html +1 -1
  231. package/dist/index.d.ts.map +1 -1
  232. package/dist/index.js +7 -2
  233. package/dist/index.js.map +1 -1
  234. package/dist/index.test.js +2 -2
  235. package/dist/index.test.js.map +1 -1
  236. package/dist/irdevice/airconditioner.d.ts +3 -3
  237. package/dist/irdevice/airconditioner.d.ts.map +1 -1
  238. package/dist/irdevice/airconditioner.js.map +1 -1
  239. package/dist/irdevice/airpurifier.d.ts +3 -3
  240. package/dist/irdevice/airpurifier.d.ts.map +1 -1
  241. package/dist/irdevice/airpurifier.js.map +1 -1
  242. package/dist/irdevice/camera.d.ts +3 -3
  243. package/dist/irdevice/camera.d.ts.map +1 -1
  244. package/dist/irdevice/camera.js.map +1 -1
  245. package/dist/irdevice/fan.d.ts +3 -3
  246. package/dist/irdevice/fan.d.ts.map +1 -1
  247. package/dist/irdevice/fan.js.map +1 -1
  248. package/dist/irdevice/irdevice.d.ts +3 -3
  249. package/dist/irdevice/irdevice.d.ts.map +1 -1
  250. package/dist/irdevice/irdevice.js.map +1 -1
  251. package/dist/irdevice/light.d.ts +3 -3
  252. package/dist/irdevice/light.d.ts.map +1 -1
  253. package/dist/irdevice/light.js.map +1 -1
  254. package/dist/irdevice/other.d.ts +3 -3
  255. package/dist/irdevice/other.d.ts.map +1 -1
  256. package/dist/irdevice/other.js.map +1 -1
  257. package/dist/irdevice/tv.d.ts +3 -3
  258. package/dist/irdevice/tv.d.ts.map +1 -1
  259. package/dist/irdevice/tv.js.map +1 -1
  260. package/dist/irdevice/vacuumcleaner.d.ts +3 -3
  261. package/dist/irdevice/vacuumcleaner.d.ts.map +1 -1
  262. package/dist/irdevice/vacuumcleaner.js.map +1 -1
  263. package/dist/irdevice/waterheater.d.ts +3 -3
  264. package/dist/irdevice/waterheater.d.ts.map +1 -1
  265. package/dist/irdevice/waterheater.js.map +1 -1
  266. package/dist/{platform.d.ts → platform-hap.d.ts} +2 -2
  267. package/dist/platform-hap.d.ts.map +1 -0
  268. package/dist/{platform.js → platform-hap.js} +32 -31
  269. package/dist/{platform.js.map → platform-hap.js.map} +1 -1
  270. package/dist/platform-matter.d.ts +75 -0
  271. package/dist/platform-matter.d.ts.map +1 -0
  272. package/dist/platform-matter.js +362 -0
  273. package/dist/platform-matter.js.map +1 -0
  274. package/dist/verifyconfig.test.d.ts +2 -0
  275. package/dist/verifyconfig.test.d.ts.map +1 -0
  276. package/dist/verifyconfig.test.js +167 -0
  277. package/dist/verifyconfig.test.js.map +1 -0
  278. package/docs/index.html +20 -11
  279. package/docs/variables/default.html +1 -1
  280. package/package.json +10 -10
  281. package/src/{device → devices-hap}/airpurifier.ts +2 -2
  282. package/src/{device → devices-hap}/blindtilt.ts +7 -3
  283. package/src/{device → devices-hap}/bot.ts +2 -2
  284. package/src/{device → devices-hap}/ceilinglight.ts +2 -2
  285. package/src/{device → devices-hap}/colorbulb.ts +2 -2
  286. package/src/{device → devices-hap}/contact.ts +2 -2
  287. package/src/{device → devices-hap}/curtain.ts +32 -10
  288. package/src/{device → devices-hap}/device.ts +12 -6
  289. package/src/{device → devices-hap}/fan.ts +2 -2
  290. package/src/{device → devices-hap}/hub.ts +7 -6
  291. package/src/{device → devices-hap}/humidifier.ts +2 -2
  292. package/src/{device → devices-hap}/iosensor.ts +2 -2
  293. package/src/{device → devices-hap}/lightstrip.ts +2 -2
  294. package/src/{device → devices-hap}/lock.ts +2 -2
  295. package/src/{device → devices-hap}/meter.ts +2 -2
  296. package/src/{device → devices-hap}/meterplus.ts +2 -2
  297. package/src/{device → devices-hap}/meterpro.ts +18 -5
  298. package/src/{device → devices-hap}/motion.ts +2 -2
  299. package/src/{device → devices-hap}/plug.ts +2 -2
  300. package/src/{device → devices-hap}/relayswitch.ts +2 -2
  301. package/src/{device → devices-hap}/robotvacuumcleaner.ts +2 -2
  302. package/src/{device → devices-hap}/waterdetector.ts +2 -2
  303. package/src/devices-matter/BaseMatterAccessory.ts +131 -0
  304. package/src/devices-matter/ColorLightAccessory.ts +113 -0
  305. package/src/devices-matter/ColorTemperatureLightAccessory.ts +98 -0
  306. package/src/devices-matter/ContactSensorAccessory.ts +37 -0
  307. package/src/devices-matter/DimmableLightAccessory.ts +196 -0
  308. package/src/devices-matter/DoorLockAccessory.ts +56 -0
  309. package/src/devices-matter/ExtendedColorLightAccessory.ts +127 -0
  310. package/src/devices-matter/FanAccessory.ts +87 -0
  311. package/src/devices-matter/HumiditySensorAccessory.ts +39 -0
  312. package/src/devices-matter/LeakSensorAccessory.ts +36 -0
  313. package/src/devices-matter/LightSensorAccessory.ts +39 -0
  314. package/src/devices-matter/OccupancySensorAccessory.ts +52 -0
  315. package/src/devices-matter/OnOffLightAccessory.ts +133 -0
  316. package/src/devices-matter/OnOffOutletAccessory.ts +52 -0
  317. package/src/devices-matter/OnOffSwitchAccessory.ts +52 -0
  318. package/src/devices-matter/RoboticVacuumAccessory.ts +484 -0
  319. package/src/devices-matter/SmokeCOAlarmAccessory.ts +59 -0
  320. package/src/devices-matter/TemperatureSensorAccessory.ts +39 -0
  321. package/src/devices-matter/ThermostatAccessory.ts +105 -0
  322. package/src/devices-matter/VenetianBlindAccessory.ts +118 -0
  323. package/src/devices-matter/WindowBlindAccessory.ts +94 -0
  324. package/src/devices-matter/custom/PowerStripAccessory.ts +309 -0
  325. package/src/devices-matter/custom/index.ts +8 -0
  326. package/src/devices-matter/index.ts +29 -0
  327. package/src/homebridge-ui/public/index.html +1 -1
  328. package/src/index.test.ts +2 -2
  329. package/src/index.ts +7 -2
  330. package/src/irdevice/airconditioner.ts +2 -2
  331. package/src/irdevice/airpurifier.ts +2 -2
  332. package/src/irdevice/camera.ts +2 -2
  333. package/src/irdevice/fan.ts +2 -2
  334. package/src/irdevice/irdevice.ts +2 -2
  335. package/src/irdevice/light.ts +2 -2
  336. package/src/irdevice/other.ts +2 -2
  337. package/src/irdevice/tv.ts +2 -2
  338. package/src/irdevice/vacuumcleaner.ts +2 -2
  339. package/src/irdevice/waterheater.ts +2 -2
  340. package/src/{platform.ts → platform-hap.ts} +31 -30
  341. package/src/platform-matter.ts +450 -0
  342. package/src/verifyconfig.test.ts +197 -0
  343. package/tsconfig.json +2 -1
  344. package/typedoc.json +1 -0
  345. package/.github/workflows/build.yml +0 -18
  346. package/.github/workflows/changerelease.yml +0 -11
  347. package/.github/workflows/labeler.yml +0 -16
  348. package/.github/workflows/release-drafter.yml +0 -14
  349. package/dist/device/airpurifier.d.ts.map +0 -1
  350. package/dist/device/airpurifier.js.map +0 -1
  351. package/dist/device/blindtilt.d.ts.map +0 -1
  352. package/dist/device/blindtilt.js.map +0 -1
  353. package/dist/device/bot.d.ts.map +0 -1
  354. package/dist/device/bot.js.map +0 -1
  355. package/dist/device/ceilinglight.d.ts.map +0 -1
  356. package/dist/device/ceilinglight.js.map +0 -1
  357. package/dist/device/colorbulb.d.ts.map +0 -1
  358. package/dist/device/colorbulb.js.map +0 -1
  359. package/dist/device/contact.d.ts.map +0 -1
  360. package/dist/device/contact.js.map +0 -1
  361. package/dist/device/curtain.d.ts.map +0 -1
  362. package/dist/device/curtain.js.map +0 -1
  363. package/dist/device/device.d.ts.map +0 -1
  364. package/dist/device/device.js.map +0 -1
  365. package/dist/device/fan.d.ts.map +0 -1
  366. package/dist/device/fan.js.map +0 -1
  367. package/dist/device/hub.d.ts.map +0 -1
  368. package/dist/device/hub.js.map +0 -1
  369. package/dist/device/humidifier.d.ts.map +0 -1
  370. package/dist/device/humidifier.js.map +0 -1
  371. package/dist/device/iosensor.d.ts.map +0 -1
  372. package/dist/device/iosensor.js.map +0 -1
  373. package/dist/device/lightstrip.d.ts.map +0 -1
  374. package/dist/device/lightstrip.js.map +0 -1
  375. package/dist/device/lock.d.ts.map +0 -1
  376. package/dist/device/lock.js.map +0 -1
  377. package/dist/device/meter.d.ts.map +0 -1
  378. package/dist/device/meter.js.map +0 -1
  379. package/dist/device/meterplus.d.ts.map +0 -1
  380. package/dist/device/meterplus.js.map +0 -1
  381. package/dist/device/meterpro.d.ts.map +0 -1
  382. package/dist/device/meterpro.js.map +0 -1
  383. package/dist/device/motion.d.ts.map +0 -1
  384. package/dist/device/motion.js.map +0 -1
  385. package/dist/device/plug.d.ts.map +0 -1
  386. package/dist/device/plug.js.map +0 -1
  387. package/dist/device/relayswitch.d.ts.map +0 -1
  388. package/dist/device/relayswitch.js.map +0 -1
  389. package/dist/device/robotvacuumcleaner.d.ts.map +0 -1
  390. package/dist/device/robotvacuumcleaner.js.map +0 -1
  391. package/dist/device/waterdetector.d.ts.map +0 -1
  392. package/dist/device/waterdetector.js.map +0 -1
  393. package/dist/platform.d.ts.map +0 -1
  394. /package/dist/{device → devices-hap}/airpurifier.js +0 -0
  395. /package/dist/{device → devices-hap}/bot.js +0 -0
  396. /package/dist/{device → devices-hap}/ceilinglight.js +0 -0
  397. /package/dist/{device → devices-hap}/colorbulb.js +0 -0
  398. /package/dist/{device → devices-hap}/contact.js +0 -0
  399. /package/dist/{device → devices-hap}/fan.js +0 -0
  400. /package/dist/{device → devices-hap}/humidifier.js +0 -0
  401. /package/dist/{device → devices-hap}/iosensor.js +0 -0
  402. /package/dist/{device → devices-hap}/lightstrip.js +0 -0
  403. /package/dist/{device → devices-hap}/lock.js +0 -0
  404. /package/dist/{device → devices-hap}/meter.js +0 -0
  405. /package/dist/{device → devices-hap}/meterplus.js +0 -0
  406. /package/dist/{device → devices-hap}/motion.js +0 -0
  407. /package/dist/{device → devices-hap}/plug.js +0 -0
  408. /package/dist/{device → devices-hap}/relayswitch.js +0 -0
  409. /package/dist/{device → devices-hap}/robotvacuumcleaner.js +0 -0
  410. /package/dist/{device → devices-hap}/waterdetector.js +0 -0
@@ -0,0 +1,450 @@
1
+ import type {
2
+ API,
3
+ DynamicPlatformPlugin,
4
+ Logging,
5
+ MatterAccessory,
6
+ SerializedMatterAccessory,
7
+ } from 'homebridge'
8
+
9
+ import type { SwitchBotPlatformConfig } from './settings.js'
10
+
11
+ import {
12
+ ColorLightAccessory,
13
+ ColorTemperatureLightAccessory,
14
+ ContactSensorAccessory,
15
+ DimmableLightAccessory,
16
+ DoorLockAccessory,
17
+ ExtendedColorLightAccessory,
18
+ FanAccessory,
19
+ HumiditySensorAccessory,
20
+ LeakSensorAccessory,
21
+ LightSensorAccessory,
22
+ OccupancySensorAccessory,
23
+ OnOffLightAccessory,
24
+ OnOffOutletAccessory,
25
+ OnOffSwitchAccessory,
26
+ PowerStripAccessory,
27
+ RoboticVacuumAccessory,
28
+ SmokeCOAlarmAccessory,
29
+ TemperatureSensorAccessory,
30
+ ThermostatAccessory,
31
+ VenetianBlindAccessory,
32
+ WindowBlindAccessory,
33
+ } from './devices-matter/index.js'
34
+ import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js'
35
+
36
+ /**
37
+ * MatterPlatform
38
+ * Demonstrates all available Matter device types in Homebridge
39
+ *
40
+ * Organized by official Matter Specification v1.4.1 categories
41
+ */
42
+ export class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
43
+ // Track restored HAP cached accessories (required for DynamicPlatformPlugin)
44
+ // This is commented out here as this plugin does not have any HAP accessories
45
+ // public readonly accessories: Map<string, PlatformAccessory> = new Map()
46
+
47
+ // Track restored Matter cached accessories
48
+ public readonly matterAccessories: Map<string, SerializedMatterAccessory> = new Map()
49
+
50
+ constructor(
51
+ public readonly log: Logging,
52
+ public readonly config: SwitchBotPlatformConfig,
53
+ public readonly api: API,
54
+ ) {
55
+ this.log.debug('Finished initializing platform:', this.config.name)
56
+
57
+ // Does the user have a version of Homebridge that is compatible with matter?
58
+ if (!this.api.isMatterAvailable?.()) {
59
+ this.log.warn('Matter is not available in this version of Homebridge. Please update Homebridge to use this plugin.')
60
+ }
61
+
62
+ // Check if the user has matter enabled, this means:
63
+ // - If the plugin is running on the main bridge, then the user must have enabled matter in the Homebridge settings page in the UI
64
+ // - If the plugin is running on a child bridge, then the user must have enabled matter on the plugin bridge settings section in the UI
65
+ // In reality, only the below check is needed, but they are both included here for completeness
66
+ // Remember to use a '?.' optional chaining operator in case the user is running an older version of Homebridge that does not have these APIs
67
+ if (!this.api.isMatterEnabled?.()) {
68
+ this.log.warn('Matter is not enabled in Homebridge. Please enable Matter in the Homebridge settings to use this plugin.')
69
+ return
70
+ }
71
+
72
+ // Register Matter accessories when Homebridge has finished launching
73
+ this.api.on('didFinishLaunching', () => {
74
+ this.log.debug('Executed didFinishLaunching callback')
75
+ this.registerMatterAccessories()
76
+ })
77
+ }
78
+
79
+ /**
80
+ * Required for DynamicPlatformPlugin
81
+ * Called when homebridge restores cached accessories from disk at startup
82
+ */
83
+ configureAccessory(/* accessory: PlatformAccessory */) {
84
+ // Note this is not used for Matter accessories - use configureMatterAccessory instead
85
+ // This plugin does not have any hap accessories, so here we can comment this out
86
+ // this.accessories.set(accessory.UUID, accessory)
87
+ }
88
+
89
+ /**
90
+ * Called when homebridge restores cached Matter accessories from disk at startup.
91
+ *
92
+ * This is where you can access the `accessory.context` object to retrieve
93
+ * any custom data you stored when the accessory was originally registered.
94
+ */
95
+ configureMatterAccessory(accessory: SerializedMatterAccessory) {
96
+ this.log.debug('Loading cached Matter accessory:', accessory.displayName)
97
+ this.matterAccessories.set(accessory.uuid, accessory)
98
+ }
99
+
100
+ /**
101
+ * Register all Matter accessories
102
+ */
103
+ private async registerMatterAccessories() {
104
+ this.log.info('═'.repeat(80))
105
+ this.log.info('Homebridge Matter Plugin')
106
+ this.log.info('═'.repeat(80))
107
+
108
+ // Remove accessories that are disabled in config
109
+ await this.removeDisabledAccessories()
110
+
111
+ // Register devices by Matter specification sections
112
+ await this.registerSection4Lighting()
113
+ await this.registerSection5SmartPlugs()
114
+ await this.registerSection6Switches()
115
+ await this.registerSection7Sensors()
116
+ await this.registerSection8Closure()
117
+ await this.registerSection9HVAC()
118
+ await this.registerSection12Robotic()
119
+ await this.registerCustomDevices()
120
+
121
+ this.log.info('═'.repeat(80))
122
+ this.log.info('Finished registering Matter accessories')
123
+ this.log.info('═'.repeat(80))
124
+ }
125
+
126
+ /**
127
+ * Remove accessories that are disabled in config
128
+ */
129
+ private async removeDisabledAccessories() {
130
+ const configMap = [
131
+ { enabled: this.config.enableOnOffLight, uuid: this.api.matter.uuid.generate('matter-onoff-light'), name: 'On/Off Light' },
132
+ { enabled: this.config.enableDimmableLight, uuid: this.api.matter.uuid.generate('matter-dimmable-light'), name: 'Dimmable Light' },
133
+ { enabled: this.config.enableColourTemperatureLight, uuid: this.api.matter.uuid.generate('matter-colour-temp-light'), name: 'Colour Temperature Light' },
134
+ { enabled: this.config.enableColourLight, uuid: this.api.matter.uuid.generate('matter-colour-light'), name: 'Colour Light (HS)' },
135
+ { enabled: this.config.enableExtendedColourLight, uuid: this.api.matter.uuid.generate('matter-extended-colour-light'), name: 'Extended Colour Light' },
136
+ { enabled: this.config.enableOnOffOutlet, uuid: this.api.matter.uuid.generate('matter-onoff-outlet'), name: 'On/Off Outlet' },
137
+ { enabled: this.config.enableOnOffSwitch, uuid: this.api.matter.uuid.generate('matter-onoff-switch'), name: 'On/Off Switch' },
138
+ { enabled: this.config.enableTemperatureSensor, uuid: this.api.matter.uuid.generate('matter-temperature-sensor'), name: 'Temperature Sensor' },
139
+ { enabled: this.config.enableHumiditySensor, uuid: this.api.matter.uuid.generate('matter-humidity-sensor'), name: 'Humidity Sensor' },
140
+ { enabled: this.config.enableLightSensor, uuid: this.api.matter.uuid.generate('matter-light-sensor'), name: 'Light Sensor' },
141
+ { enabled: this.config.enableOccupancySensor, uuid: this.api.matter.uuid.generate('matter-occupancy-sensor'), name: 'Occupancy Sensor' },
142
+ { enabled: this.config.enableContactSensor, uuid: this.api.matter.uuid.generate('matter-contact-sensor'), name: 'Contact Sensor' },
143
+ { enabled: this.config.enableLeakSensor, uuid: this.api.matter.uuid.generate('matter-leak-sensor'), name: 'Leak Sensor' },
144
+ { enabled: this.config.enableSmokeSensor, uuid: this.api.matter.uuid.generate('matter-smoke-sensor'), name: 'Smoke Sensor' },
145
+ { enabled: this.config.enableDoorLock, uuid: this.api.matter.uuid.generate('matter-door-lock'), name: 'Door Lock' },
146
+ { enabled: this.config.enableWindowBlind, uuid: this.api.matter.uuid.generate('matter-window-blind'), name: 'Window Blind' },
147
+ { enabled: this.config.enableVenetianBlind, uuid: this.api.matter.uuid.generate('matter-venetian-blind'), name: 'Venetian Blind' },
148
+ { enabled: this.config.enableThermostat, uuid: this.api.matter.uuid.generate('matter-thermostat'), name: 'Thermostat' },
149
+ { enabled: this.config.enableFan, uuid: this.api.matter.uuid.generate('matter-fan'), name: 'Fan' },
150
+ { enabled: this.config.enableRobotVacuum, uuid: this.api.matter.uuid.generate('matter-robot-vacuum'), name: 'Robot Vacuum' },
151
+ { enabled: this.config.enablePowerStrip, uuid: this.api.matter.uuid.generate('matter-power-strip'), name: 'Power Strip' },
152
+ ]
153
+
154
+ for (const { enabled, uuid, name } of configMap) {
155
+ if (enabled === false) {
156
+ const existingAccessory = this.matterAccessories.get(uuid)
157
+ if (existingAccessory) {
158
+ this.log.info(`Removing accessory '${name}' (disabled in config)`)
159
+ await this.api.matter.unregisterPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [existingAccessory as unknown as MatterAccessory])
160
+ this.matterAccessories.delete(uuid)
161
+ }
162
+ }
163
+ }
164
+ }
165
+
166
+ /**
167
+ * Section 4: Lighting Devices (Matter Spec § 4)
168
+ */
169
+ private async registerSection4Lighting() {
170
+ this.log.info('═'.repeat(80))
171
+ this.log.info('Section 4: Lighting Devices (Matter Spec § 4)')
172
+ this.log.info('═'.repeat(80))
173
+
174
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
175
+
176
+ // On/Off Light
177
+ if (this.config.enableOnOffLight !== false) {
178
+ const device = new OnOffLightAccessory(this.api, this.log)
179
+ accessories.push(device.toAccessory())
180
+ }
181
+
182
+ // Dimmable Light
183
+ if (this.config.enableDimmableLight !== false) {
184
+ const device = new DimmableLightAccessory(this.api, this.log)
185
+ accessories.push(device.toAccessory())
186
+ }
187
+
188
+ // Color Temperature Light
189
+ if (this.config.enableColourTemperatureLight !== false) {
190
+ const device = new ColorTemperatureLightAccessory(this.api, this.log)
191
+ accessories.push(device.toAccessory())
192
+ }
193
+
194
+ // Color Light (HS only)
195
+ if (this.config.enableColourLight !== false) {
196
+ const device = new ColorLightAccessory(this.api, this.log)
197
+ accessories.push(device.toAccessory())
198
+ }
199
+
200
+ // Extended Color Light (HS+CCT)
201
+ if (this.config.enableExtendedColourLight !== false) {
202
+ const device = new ExtendedColorLightAccessory(this.api, this.log)
203
+ accessories.push(device.toAccessory())
204
+ }
205
+
206
+ if (accessories.length > 0) {
207
+ this.log.info(`✓ Registered ${accessories.length} lighting device(s)`)
208
+ for (const acc of accessories) {
209
+ this.log.info(` - ${acc.displayName}`)
210
+ }
211
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
212
+ }
213
+ }
214
+
215
+ /**
216
+ * Section 5: Smart Plugs/Actuators (Matter Spec § 5)
217
+ */
218
+ private async registerSection5SmartPlugs() {
219
+ this.log.info('═'.repeat(80))
220
+ this.log.info('Section 5: Smart Plugs/Actuators (Matter Spec § 5)')
221
+ this.log.info('═'.repeat(80))
222
+
223
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
224
+
225
+ // On/Off Outlet
226
+ if (this.config.enableOnOffOutlet !== false) {
227
+ const device = new OnOffOutletAccessory(this.api, this.log)
228
+ accessories.push(device.toAccessory())
229
+ }
230
+
231
+ if (accessories.length > 0) {
232
+ this.log.info(`✓ Registered ${accessories.length} smart plug/actuator device(s)`)
233
+ for (const acc of accessories) {
234
+ this.log.info(` - ${acc.displayName}`)
235
+ }
236
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
237
+ }
238
+ }
239
+
240
+ /**
241
+ * Section 6: Switches & Controllers (Matter Spec § 6)
242
+ */
243
+ private async registerSection6Switches() {
244
+ this.log.info('═'.repeat(80))
245
+ this.log.info('Section 6: Switches & Controllers (Matter Spec § 6)')
246
+ this.log.info('═'.repeat(80))
247
+
248
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
249
+
250
+ // On/Off Switch
251
+ if (this.config.enableOnOffSwitch !== false) {
252
+ const device = new OnOffSwitchAccessory(this.api, this.log)
253
+ accessories.push(device.toAccessory())
254
+ }
255
+
256
+ if (accessories.length > 0) {
257
+ this.log.info(`✓ Registered ${accessories.length} switch/controller device(s)`)
258
+ for (const acc of accessories) {
259
+ this.log.info(` - ${acc.displayName}`)
260
+ }
261
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
262
+ }
263
+ }
264
+
265
+ /**
266
+ * Section 7: Sensors (Matter Spec § 7)
267
+ */
268
+ private async registerSection7Sensors() {
269
+ this.log.info('═'.repeat(80))
270
+ this.log.info('Section 7: Sensors (Matter Spec § 7)')
271
+ this.log.info('═'.repeat(80))
272
+
273
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
274
+
275
+ // Contact Sensor
276
+ if (this.config.enableContactSensor !== false) {
277
+ const device = new ContactSensorAccessory(this.api, this.log)
278
+ accessories.push(device.toAccessory())
279
+ }
280
+
281
+ // Light Sensor
282
+ if (this.config.enableLightSensor !== false) {
283
+ const device = new LightSensorAccessory(this.api, this.log)
284
+ accessories.push(device.toAccessory())
285
+ }
286
+
287
+ // Occupancy Sensor
288
+ if (this.config.enableOccupancySensor !== false) {
289
+ const device = new OccupancySensorAccessory(this.api, this.log)
290
+ accessories.push(device.toAccessory())
291
+ }
292
+
293
+ // Temperature Sensor
294
+ if (this.config.enableTemperatureSensor !== false) {
295
+ const device = new TemperatureSensorAccessory(this.api, this.log)
296
+ accessories.push(device.toAccessory())
297
+ }
298
+
299
+ // Humidity Sensor
300
+ if (this.config.enableHumiditySensor !== false) {
301
+ const device = new HumiditySensorAccessory(this.api, this.log)
302
+ accessories.push(device.toAccessory())
303
+ }
304
+
305
+ // Smoke/CO Alarm
306
+ if (this.config.enableSmokeSensor !== false) {
307
+ const device = new SmokeCOAlarmAccessory(this.api, this.log)
308
+ accessories.push(device.toAccessory())
309
+ }
310
+
311
+ // Leak Sensor
312
+ if (this.config.enableLeakSensor !== false) {
313
+ const device = new LeakSensorAccessory(this.api, this.log)
314
+ accessories.push(device.toAccessory())
315
+ }
316
+
317
+ if (accessories.length > 0) {
318
+ this.log.info(`✓ Registered ${accessories.length} sensor device(s)`)
319
+ for (const acc of accessories) {
320
+ this.log.info(` - ${acc.displayName}`)
321
+ }
322
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
323
+ }
324
+ }
325
+
326
+ /**
327
+ * Section 8: Closure Devices (Matter Spec § 8)
328
+ */
329
+ private async registerSection8Closure() {
330
+ this.log.info('═'.repeat(80))
331
+ this.log.info('Section 8: Closure Devices (Matter Spec § 8)')
332
+ this.log.info('═'.repeat(80))
333
+
334
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
335
+
336
+ // Door Lock
337
+ if (this.config.enableDoorLock !== false) {
338
+ const device = new DoorLockAccessory(this.api, this.log)
339
+ accessories.push(device.toAccessory())
340
+ }
341
+
342
+ // Window Blind
343
+ if (this.config.enableWindowBlind !== false) {
344
+ const device = new WindowBlindAccessory(this.api, this.log)
345
+ accessories.push(device.toAccessory())
346
+ }
347
+
348
+ // Venetian Blind
349
+ if (this.config.enableVenetianBlind !== false) {
350
+ const device = new VenetianBlindAccessory(this.api, this.log)
351
+ accessories.push(device.toAccessory())
352
+ }
353
+
354
+ if (accessories.length > 0) {
355
+ this.log.info(`✓ Registered ${accessories.length} closure device(s)`)
356
+ for (const acc of accessories) {
357
+ this.log.info(` - ${acc.displayName}`)
358
+ }
359
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
360
+ }
361
+ }
362
+
363
+ /**
364
+ * Section 9: HVAC (Matter Spec § 9)
365
+ */
366
+ private async registerSection9HVAC() {
367
+ this.log.info('═'.repeat(80))
368
+ this.log.info('Section 9: HVAC (Matter Spec § 9)')
369
+ this.log.info('═'.repeat(80))
370
+
371
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
372
+
373
+ // Thermostat
374
+ if (this.config.enableThermostat !== false) {
375
+ const device = new ThermostatAccessory(this.api, this.log)
376
+ accessories.push(device.toAccessory())
377
+ }
378
+
379
+ // Fan
380
+ if (this.config.enableFan !== false) {
381
+ const device = new FanAccessory(this.api, this.log)
382
+ accessories.push(device.toAccessory())
383
+ }
384
+
385
+ if (accessories.length > 0) {
386
+ this.log.info(`✓ Registered ${accessories.length} HVAC device(s)`)
387
+ for (const acc of accessories) {
388
+ this.log.info(` - ${acc.displayName}`)
389
+ }
390
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
391
+ }
392
+ }
393
+
394
+ /**
395
+ * Section 12: Robotic Devices (Matter Spec § 12)
396
+ * ⚠️ IMPORTANT: RVC devices use a DIFFERENT PROCESS (same code) than other devices!
397
+ * When this runs, you'll see separate commissioning codes in the logs for the robot vacuum.
398
+ * Use those codes to pair the vacuum as a separate bridge in your Home app.
399
+ */
400
+ private async registerSection12Robotic() {
401
+ this.log.info('═'.repeat(80))
402
+ this.log.info('Section 12: Robotic Devices (Matter Spec § 12)')
403
+ this.log.info('═'.repeat(80))
404
+
405
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
406
+
407
+ // Robot Vacuum
408
+ if (this.config.enableRobotVacuum !== false) {
409
+ const device = new RoboticVacuumAccessory(this.api, this.log)
410
+ accessories.push(device.toAccessory())
411
+ }
412
+
413
+ if (accessories.length > 0) {
414
+ this.log.info(`✓ Registered ${accessories.length} robot vacuum device(s)`)
415
+ for (const acc of accessories) {
416
+ this.log.info(` - ${acc.displayName} (standalone for Apple Home compatibility)`)
417
+ }
418
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
419
+ }
420
+ }
421
+
422
+ /**
423
+ * Custom Devices
424
+ *
425
+ * This section demonstrates custom device implementations that go beyond
426
+ * the standard Matter device types. These examples show advanced patterns
427
+ * like managing multiple logical components within a single device.
428
+ */
429
+ private async registerCustomDevices() {
430
+ this.log.info('═'.repeat(80))
431
+ this.log.info('Custom Devices')
432
+ this.log.info('═'.repeat(80))
433
+
434
+ const accessories: Array<MatterAccessory<Record<string, unknown>>> = []
435
+
436
+ // Power Strip (4 Outlets)
437
+ if (this.config.enablePowerStrip !== false) {
438
+ const device = new PowerStripAccessory(this.api, this.log)
439
+ accessories.push(device.toAccessory())
440
+ }
441
+
442
+ if (accessories.length > 0) {
443
+ this.log.info(`✓ Registered ${accessories.length} custom device(s)`)
444
+ for (const acc of accessories) {
445
+ this.log.info(` - ${acc.displayName}`)
446
+ }
447
+ await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories)
448
+ }
449
+ }
450
+ }
@@ -0,0 +1,197 @@
1
+ import { describe, expect, it, vi } from 'vitest'
2
+ import type { SwitchBotPlatformConfig } from './settings.js'
3
+
4
+ // Create a minimal mock of the SwitchBotPlatform to test verifyConfig
5
+ class MockSwitchBotPlatform {
6
+ config: SwitchBotPlatformConfig
7
+ errorLogCalls: string[] = []
8
+ debugLogCalls: string[] = []
9
+
10
+ constructor(config: SwitchBotPlatformConfig) {
11
+ this.config = config
12
+ }
13
+
14
+ errorLog(message: string) {
15
+ this.errorLogCalls.push(message)
16
+ }
17
+
18
+ debugLog(message: string) {
19
+ this.debugLogCalls.push(message)
20
+ }
21
+
22
+ debugWarnLog(message: string) {
23
+ this.debugLogCalls.push(`WARN: ${message}`)
24
+ }
25
+
26
+ debugErrorLog(message: string) {
27
+ this.debugLogCalls.push(`ERROR: ${message}`)
28
+ }
29
+
30
+ // Copy the exact verifyConfig method from the actual platform
31
+ async verifyConfig() {
32
+ this.debugLog('Verifying Config')
33
+ this.config = this.config || {}
34
+ this.config.options = this.config.options || {}
35
+
36
+ if (this.config.options) {
37
+ // Device Config
38
+ if (this.config.options.devices) {
39
+ for (const deviceConfig of this.config.options.devices) {
40
+ if (!deviceConfig.hide_device) {
41
+ if (!deviceConfig.deviceId) {
42
+ this.errorLog('The devices config section is missing the *Device ID* in the config. Please check your config.')
43
+ }
44
+ if (!deviceConfig.configDeviceType && (deviceConfig as any).connectionType) {
45
+ this.errorLog('The devices config section is missing the *Device Type* in the config. Please check your config.')
46
+ }
47
+ }
48
+ }
49
+ }
50
+
51
+ // IR Device Config
52
+ if (this.config.options.irdevices) {
53
+ for (const irDeviceConfig of this.config.options.irdevices) {
54
+ if (!irDeviceConfig.hide_device) {
55
+ if (!irDeviceConfig.deviceId) {
56
+ this.errorLog('The devices config section is missing the *Device ID* in the config. Please check your config.')
57
+ }
58
+ if (!irDeviceConfig.deviceId && !irDeviceConfig.configRemoteType) {
59
+ this.errorLog('The devices config section is missing the *Device Type* in the config. Please check your config.')
60
+ }
61
+ }
62
+ }
63
+ }
64
+ }
65
+
66
+ if (!this.config.credentials && !this.config.options) {
67
+ this.debugWarnLog('Missing Credentials')
68
+ } else if (this.config.credentials && !this.config.credentials.notice) {
69
+ if (!this.config.credentials?.token) {
70
+ this.debugErrorLog('Missing token')
71
+ this.debugWarnLog('Cloud Enabled SwitchBot Devices & IR Devices will not work')
72
+ }
73
+ if (this.config.credentials?.token) {
74
+ if (!this.config.credentials?.secret) {
75
+ this.debugErrorLog('Missing secret')
76
+ this.debugWarnLog('Cloud Enabled SwitchBot Devices & IR Devices will not work')
77
+ }
78
+ }
79
+ }
80
+ }
81
+ }
82
+
83
+ describe('verifyConfig fix for reboot loop', () => {
84
+ it('should log error instead of throwing when device config is missing deviceId', async () => {
85
+ const config: SwitchBotPlatformConfig = {
86
+ platform: 'SwitchBot',
87
+ name: 'SwitchBot',
88
+ credentials: {
89
+ token: 'test-token',
90
+ secret: 'test-secret',
91
+ },
92
+ options: {
93
+ devices: [
94
+ {
95
+ logging: 'standard',
96
+ } as any, // Missing deviceId
97
+ ],
98
+ },
99
+ }
100
+
101
+ const platform = new MockSwitchBotPlatform(config)
102
+
103
+ // This should NOT throw an error anymore - it should log instead
104
+ await expect(platform.verifyConfig()).resolves.not.toThrow()
105
+
106
+ // Verify that the error was logged instead of thrown
107
+ expect(platform.errorLogCalls).toContain(
108
+ 'The devices config section is missing the *Device ID* in the config. Please check your config.'
109
+ )
110
+ })
111
+
112
+ it('should log error instead of throwing when device config is missing configDeviceType with connectionType', async () => {
113
+ const config: SwitchBotPlatformConfig = {
114
+ platform: 'SwitchBot',
115
+ name: 'SwitchBot',
116
+ credentials: {
117
+ token: 'test-token',
118
+ secret: 'test-secret',
119
+ },
120
+ options: {
121
+ devices: [
122
+ {
123
+ deviceId: 'test-device-id',
124
+ connectionType: 'BLE',
125
+ // Missing configDeviceType
126
+ } as any,
127
+ ],
128
+ },
129
+ }
130
+
131
+ const platform = new MockSwitchBotPlatform(config)
132
+
133
+ // This should NOT throw an error anymore - it should log instead
134
+ await expect(platform.verifyConfig()).resolves.not.toThrow()
135
+
136
+ // Verify that the error was logged instead of thrown
137
+ expect(platform.errorLogCalls).toContain(
138
+ 'The devices config section is missing the *Device Type* in the config. Please check your config.'
139
+ )
140
+ })
141
+
142
+ it('should not log error when device config has hide_device set to true', async () => {
143
+ const config: SwitchBotPlatformConfig = {
144
+ platform: 'SwitchBot',
145
+ name: 'SwitchBot',
146
+ credentials: {
147
+ token: 'test-token',
148
+ secret: 'test-secret',
149
+ },
150
+ options: {
151
+ devices: [
152
+ {
153
+ hide_device: true,
154
+ // Missing deviceId but hidden
155
+ } as any,
156
+ ],
157
+ },
158
+ }
159
+
160
+ const platform = new MockSwitchBotPlatform(config)
161
+
162
+ // Should not throw or log errors because device is hidden
163
+ await expect(platform.verifyConfig()).resolves.not.toThrow()
164
+ expect(platform.errorLogCalls).toHaveLength(0)
165
+ })
166
+
167
+ it('should handle valid device config without errors', async () => {
168
+ const config: SwitchBotPlatformConfig = {
169
+ platform: 'SwitchBot',
170
+ name: 'SwitchBot',
171
+ credentials: {
172
+ token: 'test-token',
173
+ secret: 'test-secret',
174
+ },
175
+ options: {
176
+ devices: [
177
+ {
178
+ deviceId: 'test-device-id',
179
+ configDeviceType: 'Bot',
180
+ logging: 'standard',
181
+ } as any,
182
+ ],
183
+ },
184
+ }
185
+
186
+ const platform = new MockSwitchBotPlatform(config)
187
+
188
+ // Should not throw or log device config errors with valid config
189
+ await expect(platform.verifyConfig()).resolves.not.toThrow()
190
+
191
+ // Should not have device config errors
192
+ expect(platform.errorLogCalls.filter(msg =>
193
+ msg.includes('missing the *Device ID*') ||
194
+ msg.includes('missing the *Device Type*')
195
+ )).toHaveLength(0)
196
+ })
197
+ })
package/tsconfig.json CHANGED
@@ -16,7 +16,8 @@
16
16
  "sourceMap": true,
17
17
  "allowSyntheticDefaultImports": true,
18
18
  "esModuleInterop": true,
19
- "forceConsistentCasingInFileNames": true
19
+ "forceConsistentCasingInFileNames": true,
20
+ "skipLibCheck": true
20
21
  },
21
22
  "include": [
22
23
  "src"
package/typedoc.json CHANGED
@@ -1,4 +1,5 @@
1
1
  {
2
+ "theme": "default",
2
3
  "out": "docs",
3
4
  "exclude": ["src/**/*.spec.ts"],
4
5
  "entryPoints": [
@@ -1,18 +0,0 @@
1
- name: Node Build
2
-
3
- on:
4
- push:
5
- branches: [latest]
6
- pull_request:
7
- workflow_dispatch:
8
-
9
- jobs:
10
- build_and_test:
11
- uses: OpenWonderLabs/.github/.github/workflows/nodejs-build-and-test.yml@latest
12
- with:
13
- enable_coverage: false
14
- secrets:
15
- token: ${{ secrets.GITHUB_TOKEN }}
16
- lint:
17
- needs: build_and_test
18
- uses: OpenWonderLabs/.github/.github/workflows/eslint.yml@latest
@@ -1,11 +0,0 @@
1
- name: Changelog to Release
2
-
3
- on:
4
- release:
5
- types: [published]
6
-
7
- jobs:
8
- changerelease:
9
- uses: OpenWonderLabs/.github/.github/workflows/changerelease.yml@latest
10
- secrets:
11
- token: ${{ secrets.GITHUB_TOKEN }}