homebridge 2.5.1-beta.2 → 2.5.1-beta.3

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 (332) hide show
  1. package/dist/api.d.ts +253 -35
  2. package/dist/api.js +93 -5
  3. package/dist/api.js.map +1 -1
  4. package/dist/bridgeService.d.ts +63 -6
  5. package/dist/bridgeService.js +401 -99
  6. package/dist/bridgeService.js.map +1 -1
  7. package/dist/childBridgeFork.d.ts +12 -9
  8. package/dist/childBridgeFork.js +126 -40
  9. package/dist/childBridgeFork.js.map +1 -1
  10. package/dist/childBridgeService.d.ts +107 -28
  11. package/dist/childBridgeService.js +225 -28
  12. package/dist/childBridgeService.js.map +1 -1
  13. package/dist/cli.d.ts +0 -1
  14. package/dist/cli.js +28 -7
  15. package/dist/cli.js.map +1 -1
  16. package/dist/externalPortService.d.ts +4 -1
  17. package/dist/externalPortService.js +16 -4
  18. package/dist/externalPortService.js.map +1 -1
  19. package/dist/index.d.ts +36 -10
  20. package/dist/index.js +20 -4
  21. package/dist/index.js.map +1 -1
  22. package/dist/ipcService.d.ts +27 -12
  23. package/dist/ipcService.js +19 -6
  24. package/dist/ipcService.js.map +1 -1
  25. package/dist/logger.d.ts +10 -4
  26. package/dist/logger.js +27 -14
  27. package/dist/logger.js.map +1 -1
  28. package/dist/matter/BaseMatterManager.d.ts +36 -1
  29. package/dist/matter/BaseMatterManager.js +96 -39
  30. package/dist/matter/BaseMatterManager.js.map +1 -1
  31. package/dist/matter/ChildBridgeMatterManager.d.ts +27 -14
  32. package/dist/matter/ChildBridgeMatterManager.js +220 -62
  33. package/dist/matter/ChildBridgeMatterManager.js.map +1 -1
  34. package/dist/matter/ChildBridgeMatterMessageHandler.d.ts +3 -9
  35. package/dist/matter/ChildBridgeMatterMessageHandler.js +21 -7
  36. package/dist/matter/ChildBridgeMatterMessageHandler.js.map +1 -1
  37. package/dist/matter/ClusterCommandMapper.d.ts +21 -14
  38. package/dist/matter/ClusterCommandMapper.js +143 -84
  39. package/dist/matter/ClusterCommandMapper.js.map +1 -1
  40. package/dist/matter/ExternalMatterAccessoryPublisher.d.ts +2 -1
  41. package/dist/matter/ExternalMatterAccessoryPublisher.js +29 -18
  42. package/dist/matter/ExternalMatterAccessoryPublisher.js.map +1 -1
  43. package/dist/matter/MatterAPIImpl.d.ts +62 -41
  44. package/dist/matter/MatterAPIImpl.js +62 -47
  45. package/dist/matter/MatterAPIImpl.js.map +1 -1
  46. package/dist/matter/MatterBridgeManager.d.ts +2 -1
  47. package/dist/matter/MatterBridgeManager.js +58 -35
  48. package/dist/matter/MatterBridgeManager.js.map +1 -1
  49. package/dist/matter/MatterError.d.ts +15 -1
  50. package/dist/matter/MatterError.js +53 -1
  51. package/dist/matter/MatterError.js.map +1 -1
  52. package/dist/matter/MatterPortAllocator.d.ts +6 -1
  53. package/dist/matter/MatterPortAllocator.js +8 -0
  54. package/dist/matter/MatterPortAllocator.js.map +1 -1
  55. package/dist/matter/SwitchAPI.d.ts +0 -1
  56. package/dist/matter/accessoryCache.d.ts +49 -2
  57. package/dist/matter/accessoryCache.js +106 -3
  58. package/dist/matter/accessoryCache.js.map +1 -1
  59. package/dist/matter/behaviors/BehaviorRegistry.d.ts +39 -12
  60. package/dist/matter/behaviors/BehaviorRegistry.js +102 -63
  61. package/dist/matter/behaviors/BehaviorRegistry.js.map +1 -1
  62. package/dist/matter/behaviors/ClosureControlBehavior.d.ts +0 -19
  63. package/dist/matter/behaviors/ClosureControlBehavior.js +102 -68
  64. package/dist/matter/behaviors/ClosureControlBehavior.js.map +1 -1
  65. package/dist/matter/behaviors/ColorControlBehavior.d.ts +30 -10
  66. package/dist/matter/behaviors/ColorControlBehavior.js +130 -175
  67. package/dist/matter/behaviors/ColorControlBehavior.js.map +1 -1
  68. package/dist/matter/behaviors/DeviceEnergyManagementBehavior.d.ts +3 -6
  69. package/dist/matter/behaviors/DeviceEnergyManagementBehavior.js +35 -91
  70. package/dist/matter/behaviors/DeviceEnergyManagementBehavior.js.map +1 -1
  71. package/dist/matter/behaviors/DoorLockBehavior.d.ts +9 -10
  72. package/dist/matter/behaviors/DoorLockBehavior.js +41 -62
  73. package/dist/matter/behaviors/DoorLockBehavior.js.map +1 -1
  74. package/dist/matter/behaviors/EndpointContext.d.ts +7 -1
  75. package/dist/matter/behaviors/EndpointContext.js +8 -0
  76. package/dist/matter/behaviors/EndpointContext.js.map +1 -1
  77. package/dist/matter/behaviors/EnergyEvseBehavior.d.ts +6 -4
  78. package/dist/matter/behaviors/EnergyEvseBehavior.js +52 -76
  79. package/dist/matter/behaviors/EnergyEvseBehavior.js.map +1 -1
  80. package/dist/matter/behaviors/FanControlBehavior.d.ts +1 -6
  81. package/dist/matter/behaviors/FanControlBehavior.js +34 -56
  82. package/dist/matter/behaviors/FanControlBehavior.js.map +1 -1
  83. package/dist/matter/behaviors/IdentifyBehavior.d.ts +2 -5
  84. package/dist/matter/behaviors/IdentifyBehavior.js +26 -25
  85. package/dist/matter/behaviors/IdentifyBehavior.js.map +1 -1
  86. package/dist/matter/behaviors/KeypadInputBehavior.d.ts +0 -5
  87. package/dist/matter/behaviors/KeypadInputBehavior.js +18 -13
  88. package/dist/matter/behaviors/KeypadInputBehavior.js.map +1 -1
  89. package/dist/matter/behaviors/LevelControlBehavior.d.ts +41 -10
  90. package/dist/matter/behaviors/LevelControlBehavior.js +173 -191
  91. package/dist/matter/behaviors/LevelControlBehavior.js.map +1 -1
  92. package/dist/matter/behaviors/MediaPlaybackBehavior.d.ts +0 -5
  93. package/dist/matter/behaviors/MediaPlaybackBehavior.js +14 -10
  94. package/dist/matter/behaviors/MediaPlaybackBehavior.js.map +1 -1
  95. package/dist/matter/behaviors/OnOffBehavior.d.ts +1 -6
  96. package/dist/matter/behaviors/OnOffBehavior.js +41 -76
  97. package/dist/matter/behaviors/OnOffBehavior.js.map +1 -1
  98. package/dist/matter/behaviors/RegistryManager.d.ts +0 -1
  99. package/dist/matter/behaviors/RvcCleanModeBehavior.d.ts +0 -5
  100. package/dist/matter/behaviors/RvcCleanModeBehavior.js +9 -47
  101. package/dist/matter/behaviors/RvcCleanModeBehavior.js.map +1 -1
  102. package/dist/matter/behaviors/RvcOperationalStateBehavior.d.ts +5 -8
  103. package/dist/matter/behaviors/RvcOperationalStateBehavior.js +41 -38
  104. package/dist/matter/behaviors/RvcOperationalStateBehavior.js.map +1 -1
  105. package/dist/matter/behaviors/RvcRunModeBehavior.d.ts +3 -14
  106. package/dist/matter/behaviors/RvcRunModeBehavior.js +4 -50
  107. package/dist/matter/behaviors/RvcRunModeBehavior.js.map +1 -1
  108. package/dist/matter/behaviors/ServiceAreaBehavior.d.ts +1 -6
  109. package/dist/matter/behaviors/ServiceAreaBehavior.js +42 -51
  110. package/dist/matter/behaviors/ServiceAreaBehavior.js.map +1 -1
  111. package/dist/matter/behaviors/ThermostatBehavior.d.ts +6 -6
  112. package/dist/matter/behaviors/ThermostatBehavior.js +83 -106
  113. package/dist/matter/behaviors/ThermostatBehavior.js.map +1 -1
  114. package/dist/matter/behaviors/ValveConfigurationAndControlBehavior.d.ts +0 -5
  115. package/dist/matter/behaviors/ValveConfigurationAndControlBehavior.js +34 -57
  116. package/dist/matter/behaviors/ValveConfigurationAndControlBehavior.js.map +1 -1
  117. package/dist/matter/behaviors/WaterHeaterBehavior.d.ts +1 -4
  118. package/dist/matter/behaviors/WaterHeaterBehavior.js +14 -62
  119. package/dist/matter/behaviors/WaterHeaterBehavior.js.map +1 -1
  120. package/dist/matter/behaviors/WindowCoveringBehavior.d.ts +19 -10
  121. package/dist/matter/behaviors/WindowCoveringBehavior.js +94 -141
  122. package/dist/matter/behaviors/WindowCoveringBehavior.js.map +1 -1
  123. package/dist/matter/behaviors/handlerResponse.d.ts +47 -0
  124. package/dist/matter/behaviors/handlerResponse.js +79 -0
  125. package/dist/matter/behaviors/handlerResponse.js.map +1 -0
  126. package/dist/matter/behaviors/handlerScope.d.ts +16 -0
  127. package/dist/matter/behaviors/handlerScope.js +23 -0
  128. package/dist/matter/behaviors/handlerScope.js.map +1 -0
  129. package/dist/matter/behaviors/index.d.ts +0 -3
  130. package/dist/matter/behaviors/index.js +0 -7
  131. package/dist/matter/behaviors/index.js.map +1 -1
  132. package/dist/matter/behaviors/pluginUpdates.d.ts +35 -0
  133. package/dist/matter/behaviors/pluginUpdates.js +74 -0
  134. package/dist/matter/behaviors/pluginUpdates.js.map +1 -0
  135. package/dist/matter/behaviors/revertFailedChange.d.ts +28 -0
  136. package/dist/matter/behaviors/revertFailedChange.js +40 -0
  137. package/dist/matter/behaviors/revertFailedChange.js.map +1 -0
  138. package/dist/matter/behaviors/stateLock.d.ts +20 -0
  139. package/dist/matter/behaviors/stateLock.js +36 -0
  140. package/dist/matter/behaviors/stateLock.js.map +1 -0
  141. package/dist/matter/clusterFeatures.d.ts +0 -1
  142. package/dist/matter/clusterFeatures.js.map +1 -1
  143. package/dist/matter/clusterHandlerMap.d.ts +116 -25
  144. package/dist/matter/clusterHandlerMap.js +8 -0
  145. package/dist/matter/clusterHandlerMap.js.map +1 -1
  146. package/dist/matter/clusterStateMap.d.ts +9 -3
  147. package/dist/matter/clusterTypes.d.ts +66 -7
  148. package/dist/matter/clusterTypes.js +5 -3
  149. package/dist/matter/clusterTypes.js.map +1 -1
  150. package/dist/matter/config.d.ts +2 -3
  151. package/dist/matter/config.js +30 -31
  152. package/dist/matter/config.js.map +1 -1
  153. package/dist/matter/configValidator.d.ts +11 -1
  154. package/dist/matter/configValidator.js +36 -14
  155. package/dist/matter/configValidator.js.map +1 -1
  156. package/dist/matter/errorHandler.d.ts +22 -5
  157. package/dist/matter/errorHandler.js +62 -17
  158. package/dist/matter/errorHandler.js.map +1 -1
  159. package/dist/matter/errors.d.ts +0 -1
  160. package/dist/matter/index.d.ts +0 -1
  161. package/dist/matter/ipc-types.d.ts +40 -2
  162. package/dist/matter/logFormatter.d.ts +17 -1
  163. package/dist/matter/logFormatter.js +32 -32
  164. package/dist/matter/logFormatter.js.map +1 -1
  165. package/dist/matter/managerTypes.d.ts +10 -45
  166. package/dist/matter/processConfig.d.ts +15 -0
  167. package/dist/matter/processConfig.js +60 -0
  168. package/dist/matter/processConfig.js.map +1 -0
  169. package/dist/matter/server/AccessoryManager.d.ts +83 -19
  170. package/dist/matter/server/AccessoryManager.js +447 -226
  171. package/dist/matter/server/AccessoryManager.js.map +1 -1
  172. package/dist/matter/server/AccessoryQuery.d.ts +3 -3
  173. package/dist/matter/server/AccessoryQuery.js +40 -12
  174. package/dist/matter/server/AccessoryQuery.js.map +1 -1
  175. package/dist/matter/server/BehaviorMap.d.ts +4 -20
  176. package/dist/matter/server/BehaviorMap.js +4 -28
  177. package/dist/matter/server/BehaviorMap.js.map +1 -1
  178. package/dist/matter/server/CommissioningManager.d.ts +3 -16
  179. package/dist/matter/server/CommissioningManager.js +109 -137
  180. package/dist/matter/server/CommissioningManager.js.map +1 -1
  181. package/dist/matter/server/FabricManager.d.ts +9 -22
  182. package/dist/matter/server/FabricManager.js +32 -170
  183. package/dist/matter/server/FabricManager.js.map +1 -1
  184. package/dist/matter/server/ServerConfig.d.ts +0 -5
  185. package/dist/matter/server/ServerConfig.js +1 -4
  186. package/dist/matter/server/ServerConfig.js.map +1 -1
  187. package/dist/matter/server/ServerLifecycle.d.ts +64 -19
  188. package/dist/matter/server/ServerLifecycle.js +268 -174
  189. package/dist/matter/server/ServerLifecycle.js.map +1 -1
  190. package/dist/matter/server/StateManager.d.ts +17 -2
  191. package/dist/matter/server/StateManager.js +104 -52
  192. package/dist/matter/server/StateManager.js.map +1 -1
  193. package/dist/matter/server/index.d.ts +2 -3
  194. package/dist/matter/server/index.js +2 -2
  195. package/dist/matter/server/index.js.map +1 -1
  196. package/dist/matter/server/storageLock.d.ts +35 -0
  197. package/dist/matter/server/storageLock.js +121 -0
  198. package/dist/matter/server/storageLock.js.map +1 -0
  199. package/dist/matter/server.d.ts +20 -22
  200. package/dist/matter/server.js +129 -66
  201. package/dist/matter/server.js.map +1 -1
  202. package/dist/matter/serverHelpers.d.ts +17 -71
  203. package/dist/matter/serverHelpers.js +88 -207
  204. package/dist/matter/serverHelpers.js.map +1 -1
  205. package/dist/matter/sharedTypes.d.ts +7 -2
  206. package/dist/matter/sharedTypes.js.map +1 -1
  207. package/dist/matter/types.d.ts +121 -88
  208. package/dist/matter/types.js +62 -22
  209. package/dist/matter/types.js.map +1 -1
  210. package/dist/matter/utils.d.ts +32 -5
  211. package/dist/matter/utils.js +63 -14
  212. package/dist/matter/utils.js.map +1 -1
  213. package/dist/matterExports.d.ts +30 -0
  214. package/dist/matterExports.js +23 -0
  215. package/dist/matterExports.js.map +1 -0
  216. package/dist/platformAccessory.d.ts +54 -9
  217. package/dist/platformAccessory.js +38 -5
  218. package/dist/platformAccessory.js.map +1 -1
  219. package/dist/plugin.d.ts +0 -4
  220. package/dist/plugin.js +65 -33
  221. package/dist/plugin.js.map +1 -1
  222. package/dist/pluginManager.d.ts +38 -4
  223. package/dist/pluginManager.js +123 -66
  224. package/dist/pluginManager.js.map +1 -1
  225. package/dist/server.d.ts +38 -11
  226. package/dist/server.js +286 -118
  227. package/dist/server.js.map +1 -1
  228. package/dist/storageService.d.ts +12 -6
  229. package/dist/storageService.js +39 -16
  230. package/dist/storageService.js.map +1 -1
  231. package/dist/user.d.ts +0 -1
  232. package/dist/util/errorMessage.d.ts +6 -0
  233. package/dist/util/errorMessage.js +15 -0
  234. package/dist/util/errorMessage.js.map +1 -0
  235. package/dist/util/ipc.d.ts +12 -0
  236. package/dist/util/ipc.js +25 -0
  237. package/dist/util/ipc.js.map +1 -0
  238. package/dist/util/mac.d.ts +1 -2
  239. package/dist/util/mac.js.map +1 -1
  240. package/dist/util/pin.d.ts +19 -0
  241. package/dist/util/pin.js +43 -0
  242. package/dist/util/pin.js.map +1 -0
  243. package/dist/util/port.d.ts +11 -0
  244. package/dist/util/port.js +24 -0
  245. package/dist/util/port.js.map +1 -0
  246. package/dist/version.d.ts +0 -1
  247. package/package.json +28 -17
  248. package/dist/api.d.ts.map +0 -1
  249. package/dist/bridgeService.d.ts.map +0 -1
  250. package/dist/childBridgeFork.d.ts.map +0 -1
  251. package/dist/childBridgeService.d.ts.map +0 -1
  252. package/dist/cli.d.ts.map +0 -1
  253. package/dist/externalPortService.d.ts.map +0 -1
  254. package/dist/index.d.ts.map +0 -1
  255. package/dist/ipcService.d.ts.map +0 -1
  256. package/dist/logger.d.ts.map +0 -1
  257. package/dist/matter/BaseMatterManager.d.ts.map +0 -1
  258. package/dist/matter/ChildBridgeMatterManager.d.ts.map +0 -1
  259. package/dist/matter/ChildBridgeMatterMessageHandler.d.ts.map +0 -1
  260. package/dist/matter/ClusterCommandMapper.d.ts.map +0 -1
  261. package/dist/matter/ExternalMatterAccessoryPublisher.d.ts.map +0 -1
  262. package/dist/matter/MatterAPIImpl.d.ts.map +0 -1
  263. package/dist/matter/MatterBridgeManager.d.ts.map +0 -1
  264. package/dist/matter/MatterError.d.ts.map +0 -1
  265. package/dist/matter/MatterPortAllocator.d.ts.map +0 -1
  266. package/dist/matter/SwitchAPI.d.ts.map +0 -1
  267. package/dist/matter/accessoryCache.d.ts.map +0 -1
  268. package/dist/matter/behaviors/AirQualityBehavior.d.ts +0 -44
  269. package/dist/matter/behaviors/AirQualityBehavior.d.ts.map +0 -1
  270. package/dist/matter/behaviors/AirQualityBehavior.js +0 -48
  271. package/dist/matter/behaviors/AirQualityBehavior.js.map +0 -1
  272. package/dist/matter/behaviors/BehaviorRegistry.d.ts.map +0 -1
  273. package/dist/matter/behaviors/ClosureControlBehavior.d.ts.map +0 -1
  274. package/dist/matter/behaviors/ColorControlBehavior.d.ts.map +0 -1
  275. package/dist/matter/behaviors/ConcentrationMeasurementBehavior.d.ts +0 -117
  276. package/dist/matter/behaviors/ConcentrationMeasurementBehavior.d.ts.map +0 -1
  277. package/dist/matter/behaviors/ConcentrationMeasurementBehavior.js +0 -132
  278. package/dist/matter/behaviors/ConcentrationMeasurementBehavior.js.map +0 -1
  279. package/dist/matter/behaviors/DeviceEnergyManagementBehavior.d.ts.map +0 -1
  280. package/dist/matter/behaviors/DoorLockBehavior.d.ts.map +0 -1
  281. package/dist/matter/behaviors/EndpointContext.d.ts.map +0 -1
  282. package/dist/matter/behaviors/EnergyEvseBehavior.d.ts.map +0 -1
  283. package/dist/matter/behaviors/FanControlBehavior.d.ts.map +0 -1
  284. package/dist/matter/behaviors/IdentifyBehavior.d.ts.map +0 -1
  285. package/dist/matter/behaviors/KeypadInputBehavior.d.ts.map +0 -1
  286. package/dist/matter/behaviors/LevelControlBehavior.d.ts.map +0 -1
  287. package/dist/matter/behaviors/MediaPlaybackBehavior.d.ts.map +0 -1
  288. package/dist/matter/behaviors/OnOffBehavior.d.ts.map +0 -1
  289. package/dist/matter/behaviors/RegistryManager.d.ts.map +0 -1
  290. package/dist/matter/behaviors/RvcCleanModeBehavior.d.ts.map +0 -1
  291. package/dist/matter/behaviors/RvcOperationalStateBehavior.d.ts.map +0 -1
  292. package/dist/matter/behaviors/RvcRunModeBehavior.d.ts.map +0 -1
  293. package/dist/matter/behaviors/ServiceAreaBehavior.d.ts.map +0 -1
  294. package/dist/matter/behaviors/ThermostatBehavior.d.ts.map +0 -1
  295. package/dist/matter/behaviors/ValveConfigurationAndControlBehavior.d.ts.map +0 -1
  296. package/dist/matter/behaviors/WaterHeaterBehavior.d.ts.map +0 -1
  297. package/dist/matter/behaviors/WindowCoveringBehavior.d.ts.map +0 -1
  298. package/dist/matter/behaviors/index.d.ts.map +0 -1
  299. package/dist/matter/clusterFeatures.d.ts.map +0 -1
  300. package/dist/matter/clusterHandlerMap.d.ts.map +0 -1
  301. package/dist/matter/clusterStateMap.d.ts.map +0 -1
  302. package/dist/matter/clusterTypes.d.ts.map +0 -1
  303. package/dist/matter/config.d.ts.map +0 -1
  304. package/dist/matter/configValidator.d.ts.map +0 -1
  305. package/dist/matter/errorHandler.d.ts.map +0 -1
  306. package/dist/matter/errors.d.ts.map +0 -1
  307. package/dist/matter/index.d.ts.map +0 -1
  308. package/dist/matter/ipc-types.d.ts.map +0 -1
  309. package/dist/matter/logFormatter.d.ts.map +0 -1
  310. package/dist/matter/managerTypes.d.ts.map +0 -1
  311. package/dist/matter/server/AccessoryManager.d.ts.map +0 -1
  312. package/dist/matter/server/AccessoryQuery.d.ts.map +0 -1
  313. package/dist/matter/server/BehaviorMap.d.ts.map +0 -1
  314. package/dist/matter/server/CommissioningManager.d.ts.map +0 -1
  315. package/dist/matter/server/FabricManager.d.ts.map +0 -1
  316. package/dist/matter/server/ServerConfig.d.ts.map +0 -1
  317. package/dist/matter/server/ServerLifecycle.d.ts.map +0 -1
  318. package/dist/matter/server/StateManager.d.ts.map +0 -1
  319. package/dist/matter/server/index.d.ts.map +0 -1
  320. package/dist/matter/server.d.ts.map +0 -1
  321. package/dist/matter/serverHelpers.d.ts.map +0 -1
  322. package/dist/matter/sharedTypes.d.ts.map +0 -1
  323. package/dist/matter/types.d.ts.map +0 -1
  324. package/dist/matter/utils.d.ts.map +0 -1
  325. package/dist/platformAccessory.d.ts.map +0 -1
  326. package/dist/plugin.d.ts.map +0 -1
  327. package/dist/pluginManager.d.ts.map +0 -1
  328. package/dist/server.d.ts.map +0 -1
  329. package/dist/storageService.d.ts.map +0 -1
  330. package/dist/user.d.ts.map +0 -1
  331. package/dist/util/mac.d.ts.map +0 -1
  332. package/dist/version.d.ts.map +0 -1
@@ -2,8 +2,10 @@ import type { MacAddress } from '@homebridge/hap-nodejs';
2
2
  import type { HomebridgeAPI } from './api.js';
3
3
  import type { AccessoryConfig, BridgeConfiguration, BridgeHapConfig, BridgeOptions, HomebridgeConfig, PlatformConfig } from './bridgeService.js';
4
4
  import type { ExternalPortService } from './externalPortService.js';
5
- import type { IpcService } from './ipcService.js';
5
+ import type { IpcService, MatterEvent } from './ipcService.js';
6
6
  import type { FabricInfo, MatterConfig } from './matter/index.js';
7
+ import type { ChildBridgeMatterStatusInfo, MatterControlRequest } from './matter/ipc-types.js';
8
+ import type { AccessoryInfo } from './matter/managerTypes.js';
7
9
  import type { Plugin } from './plugin.js';
8
10
  import type { HomebridgeOptions } from './server.js';
9
11
  import { PluginType } from './api.js';
@@ -25,7 +27,9 @@ export declare const enum ChildProcessMessageEventType {
25
27
  */
26
28
  START = "start",
27
29
  /**
28
- * Sent from the child process when the bridge is online
30
+ * Sent from the child process once the bridge has been started: its
31
+ * accessories are loaded and the HAP publish has been asked for. The bridge
32
+ * may not be advertised on the network yet at that moment.
29
33
  */
30
34
  ONLINE = "online",
31
35
  /**
@@ -70,6 +74,12 @@ export declare const enum ChildProcessMessageEventType {
70
74
  * Unified Matter event from child process
71
75
  * Includes: accessoriesData, accessoryInfoData, accessoryControlResponse,
72
76
  * accessoryUpdate, accessoryAdded, accessoryRemoved
77
+ *
78
+ * accessoryAdded and accessoryRemoved are sent by the Matter server itself
79
+ * (matter/server/AccessoryManager.ts) with IpcOutgoingEvent.MATTER_EVENT,
80
+ * the id the main process uses towards the UI. In a child bridge that only
81
+ * reaches this handler because the two ids are the same string: keep
82
+ * them equal.
73
83
  */
74
84
  MATTER_EVENT = "matterEvent"
75
85
  }
@@ -79,7 +89,7 @@ export declare const enum ChildBridgeStatus {
79
89
  */
80
90
  PENDING = "pending",
81
91
  /**
82
- * The child bridge is online and has published it's accessory
92
+ * The child bridge is online and has published its accessory
83
93
  */
84
94
  OK = "ok",
85
95
  /**
@@ -91,6 +101,53 @@ export interface ChildProcessMessageEvent<T> {
91
101
  id: ChildProcessMessageEventType;
92
102
  data?: T;
93
103
  }
104
+ /**
105
+ * Every message the main process and a child bridge process send each other,
106
+ * with the data that goes with its id.
107
+ */
108
+ export type ChildProcessMessage = {
109
+ id: ChildProcessMessageEventType.READY | ChildProcessMessageEventType.START | ChildProcessMessageEventType.ONLINE | ChildProcessMessageEventType.START_MATTER_MONITORING | ChildProcessMessageEventType.STOP_MATTER_MONITORING | ChildProcessMessageEventType.GET_MATTER_ACCESSORIES;
110
+ data?: undefined;
111
+ } | {
112
+ id: ChildProcessMessageEventType.LOAD;
113
+ data: ChildProcessLoadEventData;
114
+ } | {
115
+ id: ChildProcessMessageEventType.LOADED;
116
+ data: ChildProcessPluginLoadedEventData;
117
+ } | {
118
+ id: ChildProcessMessageEventType.PORT_REQUEST;
119
+ data: ChildProcessPortRequestEventData;
120
+ } | {
121
+ id: ChildProcessMessageEventType.PORT_ALLOCATED;
122
+ data: ChildProcessPortAllocatedEventData;
123
+ } | {
124
+ id: ChildProcessMessageEventType.STATUS_UPDATE;
125
+ data: ChildBridgePairedStatusEventData;
126
+ } | {
127
+ id: ChildProcessMessageEventType.RELEASE_MATTER_PORT;
128
+ data?: {
129
+ uniqueId?: string;
130
+ };
131
+ } | {
132
+ id: ChildProcessMessageEventType.GET_MATTER_ACCESSORY_INFO;
133
+ data: {
134
+ uuid: string;
135
+ correlationId?: string;
136
+ };
137
+ } | {
138
+ id: ChildProcessMessageEventType.MATTER_ACCESSORY_CONTROL;
139
+ data: MatterControlRequest;
140
+ } | {
141
+ id: ChildProcessMessageEventType.MATTER_EVENT;
142
+ data: MatterEvent;
143
+ };
144
+ /**
145
+ * What a child bridge answers to a request for its Matter accessories.
146
+ */
147
+ export interface ChildBridgeMatterAccessories {
148
+ accessories: AccessoryInfo[];
149
+ bridgeUsername: string;
150
+ }
94
151
  export interface ChildProcessLoadEventData {
95
152
  type: PluginType;
96
153
  identifier: string;
@@ -114,15 +171,7 @@ export interface ChildProcessPortAllocatedEventData {
114
171
  export interface ChildBridgePairedStatusEventData {
115
172
  paired: boolean | null;
116
173
  setupUri: string | null;
117
- matter?: {
118
- qrCode?: string;
119
- manualPairingCode?: string;
120
- serialNumber?: string;
121
- commissioned: boolean;
122
- deviceCount: number;
123
- fabricCount?: number;
124
- fabrics?: FabricInfo[];
125
- };
174
+ matter?: ChildBridgeMatterStatusInfo;
126
175
  }
127
176
  /**
128
177
  * Child bridge metadata
@@ -155,6 +204,11 @@ export interface ChildMetadata {
155
204
  matterDeviceCount?: number;
156
205
  matterFabricCount?: number;
157
206
  matterFabrics?: FabricInfo[];
207
+ /**
208
+ * True when Matter is configured for the child bridge but its server did
209
+ * not start (for example its port is in use). The reason is in the log.
210
+ */
211
+ matterStartFailed?: boolean;
158
212
  }
159
213
  /**
160
214
  * Manages the child processes of platforms/accessories being exposed as separate forked bridges.
@@ -172,7 +226,7 @@ export declare class ChildBridgeService {
172
226
  private externalPortService;
173
227
  private child?;
174
228
  private args;
175
- private processEnv;
229
+ private forkOptions;
176
230
  private shuttingDown;
177
231
  private lastBridgeStatus;
178
232
  private pairedStatus;
@@ -190,11 +244,19 @@ export declare class ChildBridgeService {
190
244
  private matterAccessoriesResolve?;
191
245
  private matterAccessoriesPromise?;
192
246
  onExternalBridgeRegistered?: (externalBridgeUsername: string, ownerUsername: string) => void;
193
- onAccessoryInfoResponse?: (uuid: string) => void;
247
+ onExternalBridgeUnregistered?: (externalBridgeUsername: string) => void;
248
+ onAccessoryInfoResponse?: (uuid: string, correlationId?: string) => void;
194
249
  onAccessoryControlResponse?: (correlationId: string) => void;
195
250
  isMatterMonitoringActive?: () => boolean;
251
+ private restartRequested;
252
+ private shutdownListenerAttached;
196
253
  private readonly _onApiShutdown;
197
254
  constructor(type: PluginType, identifier: string, plugin: Plugin, bridgeConfig: BridgeConfiguration, homebridgeConfig: HomebridgeConfig, homebridgeOptions: HomebridgeOptions, api: HomebridgeAPI, ipcService: IpcService, externalPortService: ExternalPortService);
255
+ /**
256
+ * Listen for the Homebridge shutdown, so the child process is told to stop.
257
+ * Does nothing when the listener is already attached.
258
+ */
259
+ private attachShutdownListener;
198
260
  /**
199
261
  * Start the child bridge service
200
262
  */
@@ -215,7 +277,8 @@ export declare class ChildBridgeService {
215
277
  stopMatterMonitoring(): void;
216
278
  /**
217
279
  * Request Matter accessories from this child bridge.
218
- * Returns a promise that resolves when the child responds, or undefined on timeout.
280
+ * Returns a promise that resolves when the child responds, or undefined on
281
+ * timeout, or undefined at once when the child process is not running.
219
282
  *
220
283
  * Concurrent callers share the same in-flight promise. Previously each
221
284
  * call registered its own resolver in `matterAccessoriesResolve`, and the
@@ -227,24 +290,18 @@ export declare class ChildBridgeService {
227
290
  * event missing this child's accessories. Coalescing lets both callers
228
291
  * resolve with the same data on a single response.
229
292
  */
230
- requestMatterAccessories(timeoutMs?: number): Promise<{
231
- accessories: any[];
232
- bridgeUsername: string;
233
- } | undefined>;
293
+ requestMatterAccessories(timeoutMs?: number): Promise<ChildBridgeMatterAccessories | undefined>;
234
294
  /**
235
295
  * Get specific Matter accessory info from this child bridge
236
296
  */
237
- getMatterAccessoryInfo(uuid: string): void;
297
+ getMatterAccessoryInfo(uuid: string, correlationId?: string): void;
238
298
  /**
239
299
  * Control a Matter accessory on this child bridge
300
+ *
301
+ * @returns false when the request could not be sent, because the child
302
+ * process is not running (stopped, restarting, or waiting to be restarted)
240
303
  */
241
- controlMatterAccessory(data: {
242
- uuid: string;
243
- cluster: string;
244
- attributes: Record<string, unknown>;
245
- partId?: string;
246
- correlationId?: string;
247
- }): void;
304
+ controlMatterAccessory(data: MatterControlRequest): boolean;
248
305
  private get bridgeStatus();
249
306
  private set bridgeStatus(value);
250
307
  /**
@@ -261,6 +318,7 @@ export declare class ChildBridgeService {
261
318
  * Helper function to send a message to the child process
262
319
  * @param type
263
320
  * @param data
321
+ * @returns whether the message was sent: it is dropped when the child is not connected
264
322
  */
265
323
  private sendMessage;
266
324
  /**
@@ -305,6 +363,28 @@ export declare class ChildBridgeService {
305
363
  * Starts the child bridge, only if it was manually stopped and is no longer running
306
364
  */
307
365
  startChildBridge(): void;
366
+ /**
367
+ * Whether a `_bridge.username` read from config.json is this child bridge's.
368
+ * The username in memory is upper case (it is normalised at start-up), while
369
+ * the file keeps the user's own spelling.
370
+ */
371
+ private isOwnUsername;
372
+ /**
373
+ * Take the `_bridge` block read again from config.json as this child
374
+ * bridge's config. The username stays the one already in use: it is this
375
+ * bridge's identity, and the file may spell it in lower case.
376
+ *
377
+ * The block gets the checks a full start gives it. Before, a `_bridge` block
378
+ * changed in the UI was used unchecked after a child bridge restart: a wrong
379
+ * `hap` block, a pin that is not a text, or a Matter port another bridge
380
+ * already has.
381
+ */
382
+ private useRefreshedBridgeConfig;
383
+ /**
384
+ * Whether the main bridge or another child bridge in config.json has this
385
+ * Matter port, and will start a Matter server on it.
386
+ */
387
+ private isMatterPortOfAnotherBridge;
308
388
  /**
309
389
  * Read the config.json file from disk and refresh the plugin config block for just this plugin
310
390
  */
@@ -314,4 +394,3 @@ export declare class ChildBridgeService {
314
394
  */
315
395
  getMetadata(): ChildMetadata;
316
396
  }
317
- //# sourceMappingURL=childBridgeService.d.ts.map