@matter/node 0.16.0-alpha.0-20250817-1b000357c → 0.16.0-alpha.0-20250820-24939dd26

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 (323) hide show
  1. package/dist/cjs/behavior/Behavior.d.ts +1 -1
  2. package/dist/cjs/behavior/Behavior.d.ts.map +1 -1
  3. package/dist/cjs/behavior/Events.js +1 -1
  4. package/dist/cjs/behavior/Events.js.map +1 -1
  5. package/dist/cjs/behavior/Transitions.d.ts +8 -8
  6. package/dist/cjs/behavior/Transitions.d.ts.map +1 -1
  7. package/dist/cjs/behavior/Transitions.js +8 -8
  8. package/dist/cjs/behavior/Transitions.js.map +1 -1
  9. package/dist/cjs/behavior/cluster/FabricScopedDataHandler.js +1 -1
  10. package/dist/cjs/behavior/cluster/FabricScopedDataHandler.js.map +1 -1
  11. package/dist/cjs/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  12. package/dist/cjs/behavior/internal/BehaviorBacking.js +7 -2
  13. package/dist/cjs/behavior/internal/BehaviorBacking.js.map +1 -1
  14. package/dist/cjs/behavior/internal/Reactors.js +2 -2
  15. package/dist/cjs/behavior/internal/Reactors.js.map +1 -1
  16. package/dist/cjs/behavior/state/managed/values/PrimitiveManager.d.ts +3 -4
  17. package/dist/cjs/behavior/state/managed/values/PrimitiveManager.d.ts.map +1 -1
  18. package/dist/cjs/behavior/state/managed/values/PrimitiveManager.js.map +1 -1
  19. package/dist/cjs/behavior/state/managed/values/ValuePatcher.js.map +1 -1
  20. package/dist/cjs/behavior/state/migrations/Migration.d.ts +20 -0
  21. package/dist/cjs/behavior/state/migrations/Migration.d.ts.map +1 -0
  22. package/dist/cjs/behavior/state/migrations/Migration.js +43 -0
  23. package/dist/cjs/behavior/state/migrations/Migration.js.map +6 -0
  24. package/dist/cjs/behavior/{system/subscription → state/migrations}/index.d.ts +1 -1
  25. package/dist/cjs/behavior/state/migrations/index.d.ts.map +1 -0
  26. package/dist/{esm/behavior/system/subscription → cjs/behavior/state/migrations}/index.js +1 -1
  27. package/dist/cjs/behavior/state/migrations/index.js.map +6 -0
  28. package/dist/cjs/behavior/state/validation/ValueValidator.d.ts.map +1 -1
  29. package/dist/cjs/behavior/state/validation/ValueValidator.js +1 -0
  30. package/dist/cjs/behavior/state/validation/ValueValidator.js.map +1 -1
  31. package/dist/cjs/behavior/supervision/RootSupervisor.js +2 -2
  32. package/dist/cjs/behavior/supervision/RootSupervisor.js.map +1 -1
  33. package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts +1 -1
  34. package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
  35. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts +7 -7
  36. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  37. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js +61 -61
  38. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  39. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  40. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js +15 -14
  41. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  42. package/dist/cjs/behavior/system/controller/discovery/ContinuousDiscovery.js +1 -1
  43. package/dist/cjs/behavior/system/controller/discovery/ContinuousDiscovery.js.map +1 -1
  44. package/dist/cjs/behavior/system/controller/discovery/Discovery.d.ts +2 -2
  45. package/dist/cjs/behavior/system/controller/discovery/Discovery.d.ts.map +1 -1
  46. package/dist/cjs/behavior/system/controller/discovery/Discovery.js +2 -2
  47. package/dist/cjs/behavior/system/controller/discovery/Discovery.js.map +1 -1
  48. package/dist/cjs/behavior/system/network/ClientNetworkRuntime.d.ts +1 -0
  49. package/dist/cjs/behavior/system/network/ClientNetworkRuntime.d.ts.map +1 -1
  50. package/dist/cjs/behavior/system/network/ClientNetworkRuntime.js +40 -4
  51. package/dist/cjs/behavior/system/network/ClientNetworkRuntime.js.map +2 -2
  52. package/dist/cjs/behavior/system/network/NetworkBehavior.d.ts +5 -0
  53. package/dist/cjs/behavior/system/network/NetworkBehavior.d.ts.map +1 -1
  54. package/dist/cjs/behavior/system/network/NetworkBehavior.js +5 -0
  55. package/dist/cjs/behavior/system/network/NetworkBehavior.js.map +1 -1
  56. package/dist/cjs/behavior/system/network/NetworkClient.d.ts +7 -4
  57. package/dist/cjs/behavior/system/network/NetworkClient.d.ts.map +1 -1
  58. package/dist/cjs/behavior/system/network/NetworkClient.js +15 -9
  59. package/dist/cjs/behavior/system/network/NetworkClient.js.map +1 -1
  60. package/dist/cjs/behavior/system/network/NetworkRuntime.d.ts.map +1 -1
  61. package/dist/cjs/behavior/system/network/NetworkRuntime.js +0 -1
  62. package/dist/cjs/behavior/system/network/NetworkRuntime.js.map +1 -1
  63. package/dist/cjs/behavior/system/network/ServerNetworkRuntime.d.ts.map +1 -1
  64. package/dist/cjs/behavior/system/network/ServerNetworkRuntime.js +3 -2
  65. package/dist/cjs/behavior/system/network/ServerNetworkRuntime.js.map +1 -1
  66. package/dist/cjs/behavior/system/{subscription/SubscriptionBehavior.d.ts → subscriptions/SubscriptionsServer.d.ts} +6 -6
  67. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -0
  68. package/dist/cjs/behavior/system/{subscription/SubscriptionBehavior.js → subscriptions/SubscriptionsServer.js} +22 -22
  69. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js.map +6 -0
  70. package/dist/{esm/behavior/system/subscription → cjs/behavior/system/subscriptions}/index.d.ts +1 -1
  71. package/dist/cjs/behavior/system/subscriptions/index.d.ts.map +1 -0
  72. package/dist/cjs/behavior/system/{subscription → subscriptions}/index.js +3 -3
  73. package/dist/cjs/behavior/system/subscriptions/index.js.map +6 -0
  74. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts +3 -3
  75. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  76. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +13 -11
  77. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  78. package/dist/cjs/behaviors/color-control/ColorControlServer.d.ts +2 -2
  79. package/dist/cjs/behaviors/color-control/ColorControlServer.d.ts.map +1 -1
  80. package/dist/cjs/behaviors/color-control/ColorControlServer.js +4 -4
  81. package/dist/cjs/behaviors/color-control/ColorControlServer.js.map +1 -1
  82. package/dist/cjs/behaviors/general-commissioning/GeneralCommissioningServer.d.ts.map +1 -1
  83. package/dist/cjs/behaviors/general-commissioning/GeneralCommissioningServer.js +3 -3
  84. package/dist/cjs/behaviors/general-commissioning/GeneralCommissioningServer.js.map +1 -1
  85. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +4 -4
  86. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  87. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +17 -16
  88. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  89. package/dist/cjs/behaviors/identify/IdentifyServer.d.ts.map +1 -1
  90. package/dist/cjs/behaviors/identify/IdentifyServer.js +1 -1
  91. package/dist/cjs/behaviors/identify/IdentifyServer.js.map +1 -1
  92. package/dist/cjs/behaviors/level-control/LevelControlServer.d.ts +1 -1
  93. package/dist/cjs/behaviors/level-control/LevelControlServer.d.ts.map +1 -1
  94. package/dist/cjs/behaviors/level-control/LevelControlServer.js +3 -3
  95. package/dist/cjs/behaviors/level-control/LevelControlServer.js.map +1 -1
  96. package/dist/cjs/behaviors/on-off/OnOffServer.d.ts.map +1 -1
  97. package/dist/cjs/behaviors/on-off/OnOffServer.js +2 -2
  98. package/dist/cjs/behaviors/on-off/OnOffServer.js.map +1 -1
  99. package/dist/cjs/behaviors/power-source/PowerSourceServer.d.ts.map +1 -1
  100. package/dist/cjs/behaviors/power-source/PowerSourceServer.js +2 -1
  101. package/dist/cjs/behaviors/power-source/PowerSourceServer.js.map +1 -1
  102. package/dist/cjs/behaviors/switch/SwitchServer.d.ts +4 -4
  103. package/dist/cjs/behaviors/switch/SwitchServer.d.ts.map +1 -1
  104. package/dist/cjs/behaviors/switch/SwitchServer.js +8 -6
  105. package/dist/cjs/behaviors/switch/SwitchServer.js.map +1 -1
  106. package/dist/cjs/endpoint/Endpoint.d.ts.map +1 -1
  107. package/dist/cjs/endpoint/Endpoint.js +11 -1
  108. package/dist/cjs/endpoint/Endpoint.js.map +1 -1
  109. package/dist/cjs/endpoint/properties/SupportedBehaviors.d.ts +1 -1
  110. package/dist/cjs/endpoint/properties/SupportedBehaviors.d.ts.map +1 -1
  111. package/dist/cjs/node/ClientNode.d.ts +12 -0
  112. package/dist/cjs/node/ClientNode.d.ts.map +1 -1
  113. package/dist/cjs/node/ClientNode.js +26 -0
  114. package/dist/cjs/node/ClientNode.js.map +1 -1
  115. package/dist/cjs/node/Node.d.ts.map +1 -1
  116. package/dist/cjs/node/Node.js +2 -0
  117. package/dist/cjs/node/Node.js.map +1 -1
  118. package/dist/cjs/node/ServerNode.d.ts +2 -2
  119. package/dist/cjs/node/ServerNode.d.ts.map +1 -1
  120. package/dist/cjs/node/ServerNode.js +2 -2
  121. package/dist/cjs/node/ServerNode.js.map +1 -1
  122. package/dist/cjs/node/client/ClientNodes.js +4 -4
  123. package/dist/cjs/node/client/ClientNodes.js.map +1 -1
  124. package/dist/cjs/node/client/NodePeerAddressStore.d.ts +4 -1
  125. package/dist/cjs/node/client/NodePeerAddressStore.d.ts.map +1 -1
  126. package/dist/cjs/node/client/NodePeerAddressStore.js +2 -1
  127. package/dist/cjs/node/client/NodePeerAddressStore.js.map +2 -2
  128. package/dist/cjs/node/server/InteractionServer.d.ts +6 -6
  129. package/dist/cjs/node/server/InteractionServer.d.ts.map +1 -1
  130. package/dist/cjs/node/server/InteractionServer.js +12 -11
  131. package/dist/cjs/node/server/InteractionServer.js.map +1 -1
  132. package/dist/cjs/node/server/ProtocolService.js +2 -2
  133. package/dist/cjs/node/server/ProtocolService.js.map +1 -1
  134. package/dist/cjs/node/server/ServerSubscription.d.ts +18 -17
  135. package/dist/cjs/node/server/ServerSubscription.d.ts.map +1 -1
  136. package/dist/cjs/node/server/ServerSubscription.js +61 -54
  137. package/dist/cjs/node/server/ServerSubscription.js.map +1 -1
  138. package/dist/esm/behavior/Behavior.d.ts +1 -1
  139. package/dist/esm/behavior/Behavior.d.ts.map +1 -1
  140. package/dist/esm/behavior/Events.js +1 -1
  141. package/dist/esm/behavior/Events.js.map +1 -1
  142. package/dist/esm/behavior/Transitions.d.ts +8 -8
  143. package/dist/esm/behavior/Transitions.d.ts.map +1 -1
  144. package/dist/esm/behavior/Transitions.js +12 -9
  145. package/dist/esm/behavior/Transitions.js.map +1 -1
  146. package/dist/esm/behavior/cluster/FabricScopedDataHandler.js +2 -2
  147. package/dist/esm/behavior/cluster/FabricScopedDataHandler.js.map +1 -1
  148. package/dist/esm/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  149. package/dist/esm/behavior/internal/BehaviorBacking.js +7 -2
  150. package/dist/esm/behavior/internal/BehaviorBacking.js.map +1 -1
  151. package/dist/esm/behavior/internal/Reactors.js +2 -2
  152. package/dist/esm/behavior/internal/Reactors.js.map +1 -1
  153. package/dist/esm/behavior/state/managed/values/PrimitiveManager.d.ts +3 -4
  154. package/dist/esm/behavior/state/managed/values/PrimitiveManager.d.ts.map +1 -1
  155. package/dist/esm/behavior/state/managed/values/PrimitiveManager.js.map +1 -1
  156. package/dist/esm/behavior/state/managed/values/ValuePatcher.js.map +1 -1
  157. package/dist/esm/behavior/state/migrations/Migration.d.ts +20 -0
  158. package/dist/esm/behavior/state/migrations/Migration.d.ts.map +1 -0
  159. package/dist/esm/behavior/state/migrations/Migration.js +23 -0
  160. package/dist/esm/behavior/state/migrations/Migration.js.map +6 -0
  161. package/dist/esm/behavior/state/migrations/index.d.ts +7 -0
  162. package/dist/esm/behavior/state/migrations/index.d.ts.map +1 -0
  163. package/dist/esm/behavior/state/migrations/index.js +6 -0
  164. package/dist/esm/behavior/state/migrations/index.js.map +6 -0
  165. package/dist/esm/behavior/state/validation/ValueValidator.d.ts.map +1 -1
  166. package/dist/esm/behavior/state/validation/ValueValidator.js +1 -0
  167. package/dist/esm/behavior/state/validation/ValueValidator.js.map +1 -1
  168. package/dist/esm/behavior/supervision/RootSupervisor.js +2 -2
  169. package/dist/esm/behavior/supervision/RootSupervisor.js.map +1 -1
  170. package/dist/esm/behavior/supervision/ValueSupervisor.d.ts +1 -1
  171. package/dist/esm/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
  172. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts +7 -7
  173. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  174. package/dist/esm/behavior/system/commissioning/CommissioningClient.js +68 -62
  175. package/dist/esm/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  176. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  177. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js +15 -14
  178. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  179. package/dist/esm/behavior/system/controller/discovery/ContinuousDiscovery.js +1 -1
  180. package/dist/esm/behavior/system/controller/discovery/ContinuousDiscovery.js.map +1 -1
  181. package/dist/esm/behavior/system/controller/discovery/Discovery.d.ts +2 -2
  182. package/dist/esm/behavior/system/controller/discovery/Discovery.d.ts.map +1 -1
  183. package/dist/esm/behavior/system/controller/discovery/Discovery.js +2 -2
  184. package/dist/esm/behavior/system/controller/discovery/Discovery.js.map +1 -1
  185. package/dist/esm/behavior/system/network/ClientNetworkRuntime.d.ts +1 -0
  186. package/dist/esm/behavior/system/network/ClientNetworkRuntime.d.ts.map +1 -1
  187. package/dist/esm/behavior/system/network/ClientNetworkRuntime.js +42 -6
  188. package/dist/esm/behavior/system/network/ClientNetworkRuntime.js.map +2 -2
  189. package/dist/esm/behavior/system/network/NetworkBehavior.d.ts +5 -0
  190. package/dist/esm/behavior/system/network/NetworkBehavior.d.ts.map +1 -1
  191. package/dist/esm/behavior/system/network/NetworkBehavior.js +5 -0
  192. package/dist/esm/behavior/system/network/NetworkBehavior.js.map +1 -1
  193. package/dist/esm/behavior/system/network/NetworkClient.d.ts +7 -4
  194. package/dist/esm/behavior/system/network/NetworkClient.d.ts.map +1 -1
  195. package/dist/esm/behavior/system/network/NetworkClient.js +16 -10
  196. package/dist/esm/behavior/system/network/NetworkClient.js.map +1 -1
  197. package/dist/esm/behavior/system/network/NetworkRuntime.d.ts.map +1 -1
  198. package/dist/esm/behavior/system/network/NetworkRuntime.js +0 -1
  199. package/dist/esm/behavior/system/network/NetworkRuntime.js.map +1 -1
  200. package/dist/esm/behavior/system/network/ServerNetworkRuntime.d.ts.map +1 -1
  201. package/dist/esm/behavior/system/network/ServerNetworkRuntime.js +3 -2
  202. package/dist/esm/behavior/system/network/ServerNetworkRuntime.js.map +1 -1
  203. package/dist/esm/behavior/system/{subscription/SubscriptionBehavior.d.ts → subscriptions/SubscriptionsServer.d.ts} +6 -6
  204. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -0
  205. package/dist/esm/behavior/system/{subscription/SubscriptionBehavior.js → subscriptions/SubscriptionsServer.js} +20 -20
  206. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js.map +6 -0
  207. package/dist/esm/behavior/system/subscriptions/index.d.ts +7 -0
  208. package/dist/esm/behavior/system/subscriptions/index.d.ts.map +1 -0
  209. package/dist/esm/behavior/system/subscriptions/index.js +7 -0
  210. package/dist/esm/behavior/system/{subscription → subscriptions}/index.js.map +1 -1
  211. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts +3 -3
  212. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  213. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +16 -14
  214. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  215. package/dist/esm/behaviors/color-control/ColorControlServer.d.ts +2 -2
  216. package/dist/esm/behaviors/color-control/ColorControlServer.d.ts.map +1 -1
  217. package/dist/esm/behaviors/color-control/ColorControlServer.js +6 -5
  218. package/dist/esm/behaviors/color-control/ColorControlServer.js.map +1 -1
  219. package/dist/esm/behaviors/general-commissioning/GeneralCommissioningServer.d.ts.map +1 -1
  220. package/dist/esm/behaviors/general-commissioning/GeneralCommissioningServer.js +4 -4
  221. package/dist/esm/behaviors/general-commissioning/GeneralCommissioningServer.js.map +1 -1
  222. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +4 -4
  223. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  224. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +29 -17
  225. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  226. package/dist/esm/behaviors/identify/IdentifyServer.d.ts.map +1 -1
  227. package/dist/esm/behaviors/identify/IdentifyServer.js +2 -2
  228. package/dist/esm/behaviors/identify/IdentifyServer.js.map +1 -1
  229. package/dist/esm/behaviors/level-control/LevelControlServer.d.ts +1 -1
  230. package/dist/esm/behaviors/level-control/LevelControlServer.d.ts.map +1 -1
  231. package/dist/esm/behaviors/level-control/LevelControlServer.js +4 -4
  232. package/dist/esm/behaviors/level-control/LevelControlServer.js.map +1 -1
  233. package/dist/esm/behaviors/on-off/OnOffServer.d.ts.map +1 -1
  234. package/dist/esm/behaviors/on-off/OnOffServer.js +3 -3
  235. package/dist/esm/behaviors/on-off/OnOffServer.js.map +1 -1
  236. package/dist/esm/behaviors/power-source/PowerSourceServer.d.ts.map +1 -1
  237. package/dist/esm/behaviors/power-source/PowerSourceServer.js +2 -1
  238. package/dist/esm/behaviors/power-source/PowerSourceServer.js.map +1 -1
  239. package/dist/esm/behaviors/switch/SwitchServer.d.ts +4 -4
  240. package/dist/esm/behaviors/switch/SwitchServer.d.ts.map +1 -1
  241. package/dist/esm/behaviors/switch/SwitchServer.js +9 -7
  242. package/dist/esm/behaviors/switch/SwitchServer.js.map +1 -1
  243. package/dist/esm/endpoint/Endpoint.d.ts.map +1 -1
  244. package/dist/esm/endpoint/Endpoint.js +11 -1
  245. package/dist/esm/endpoint/Endpoint.js.map +1 -1
  246. package/dist/esm/endpoint/properties/SupportedBehaviors.d.ts +1 -1
  247. package/dist/esm/endpoint/properties/SupportedBehaviors.d.ts.map +1 -1
  248. package/dist/esm/node/ClientNode.d.ts +12 -0
  249. package/dist/esm/node/ClientNode.d.ts.map +1 -1
  250. package/dist/esm/node/ClientNode.js +26 -0
  251. package/dist/esm/node/ClientNode.js.map +1 -1
  252. package/dist/esm/node/Node.d.ts.map +1 -1
  253. package/dist/esm/node/Node.js +2 -0
  254. package/dist/esm/node/Node.js.map +1 -1
  255. package/dist/esm/node/ServerNode.d.ts +2 -2
  256. package/dist/esm/node/ServerNode.d.ts.map +1 -1
  257. package/dist/esm/node/ServerNode.js +2 -2
  258. package/dist/esm/node/ServerNode.js.map +1 -1
  259. package/dist/esm/node/client/ClientNodes.js +5 -5
  260. package/dist/esm/node/client/ClientNodes.js.map +1 -1
  261. package/dist/esm/node/client/NodePeerAddressStore.d.ts +4 -1
  262. package/dist/esm/node/client/NodePeerAddressStore.d.ts.map +1 -1
  263. package/dist/esm/node/client/NodePeerAddressStore.js +3 -2
  264. package/dist/esm/node/client/NodePeerAddressStore.js.map +2 -2
  265. package/dist/esm/node/server/InteractionServer.d.ts +6 -6
  266. package/dist/esm/node/server/InteractionServer.d.ts.map +1 -1
  267. package/dist/esm/node/server/InteractionServer.js +16 -12
  268. package/dist/esm/node/server/InteractionServer.js.map +1 -1
  269. package/dist/esm/node/server/ProtocolService.js +2 -2
  270. package/dist/esm/node/server/ProtocolService.js.map +1 -1
  271. package/dist/esm/node/server/ServerSubscription.d.ts +18 -17
  272. package/dist/esm/node/server/ServerSubscription.d.ts.map +1 -1
  273. package/dist/esm/node/server/ServerSubscription.js +75 -55
  274. package/dist/esm/node/server/ServerSubscription.js.map +1 -1
  275. package/package.json +7 -7
  276. package/src/behavior/Behavior.ts +1 -1
  277. package/src/behavior/Events.ts +1 -1
  278. package/src/behavior/Transitions.ts +17 -13
  279. package/src/behavior/cluster/FabricScopedDataHandler.ts +2 -2
  280. package/src/behavior/internal/BehaviorBacking.ts +9 -2
  281. package/src/behavior/state/managed/values/PrimitiveManager.ts +3 -4
  282. package/src/behavior/state/managed/values/ValuePatcher.ts +2 -2
  283. package/src/behavior/state/migrations/Migration.ts +34 -0
  284. package/src/behavior/{system/subscription → state/migrations}/index.ts +1 -1
  285. package/src/behavior/state/validation/ValueValidator.ts +1 -0
  286. package/src/behavior/supervision/ValueSupervisor.ts +1 -1
  287. package/src/behavior/system/commissioning/CommissioningClient.ts +78 -68
  288. package/src/behavior/system/commissioning/RemoteDescriptor.ts +15 -15
  289. package/src/behavior/system/controller/discovery/ContinuousDiscovery.ts +1 -1
  290. package/src/behavior/system/controller/discovery/Discovery.ts +4 -4
  291. package/src/behavior/system/network/ClientNetworkRuntime.ts +59 -6
  292. package/src/behavior/system/network/NetworkBehavior.ts +6 -1
  293. package/src/behavior/system/network/NetworkClient.ts +19 -12
  294. package/src/behavior/system/network/NetworkRuntime.ts +0 -1
  295. package/src/behavior/system/network/ServerNetworkRuntime.ts +4 -2
  296. package/src/behavior/system/sessions/SessionsBehavior.ts +1 -1
  297. package/src/behavior/system/{subscription/SubscriptionBehavior.ts → subscriptions/SubscriptionsServer.ts} +17 -17
  298. package/src/behavior/system/subscriptions/index.ts +7 -0
  299. package/src/behaviors/administrator-commissioning/AdministratorCommissioningServer.ts +20 -16
  300. package/src/behaviors/color-control/ColorControlServer.ts +5 -4
  301. package/src/behaviors/general-commissioning/GeneralCommissioningServer.ts +4 -4
  302. package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts +38 -21
  303. package/src/behaviors/identify/IdentifyServer.ts +2 -2
  304. package/src/behaviors/level-control/LevelControlServer.ts +4 -4
  305. package/src/behaviors/on-off/OnOffServer.ts +3 -3
  306. package/src/behaviors/power-source/PowerSourceServer.ts +2 -1
  307. package/src/behaviors/switch/SwitchServer.ts +10 -7
  308. package/src/endpoint/Endpoint.ts +13 -1
  309. package/src/endpoint/properties/SupportedBehaviors.ts +1 -1
  310. package/src/node/ClientNode.ts +30 -0
  311. package/src/node/Node.ts +2 -0
  312. package/src/node/ServerNode.ts +2 -2
  313. package/src/node/client/ClientNodes.ts +8 -8
  314. package/src/node/client/NodePeerAddressStore.ts +4 -2
  315. package/src/node/server/InteractionServer.ts +21 -15
  316. package/src/node/server/ServerSubscription.ts +86 -64
  317. package/dist/cjs/behavior/system/subscription/SubscriptionBehavior.d.ts.map +0 -1
  318. package/dist/cjs/behavior/system/subscription/SubscriptionBehavior.js.map +0 -6
  319. package/dist/cjs/behavior/system/subscription/index.d.ts.map +0 -1
  320. package/dist/cjs/behavior/system/subscription/index.js.map +0 -6
  321. package/dist/esm/behavior/system/subscription/SubscriptionBehavior.d.ts.map +0 -1
  322. package/dist/esm/behavior/system/subscription/SubscriptionBehavior.js.map +0 -6
  323. package/dist/esm/behavior/system/subscription/index.d.ts.map +0 -1
@@ -7,7 +7,15 @@
7
7
  import { Behavior } from "#behavior/Behavior.js";
8
8
  import { Events as BaseEvents } from "#behavior/Events.js";
9
9
  import { OperationalCredentialsClient } from "#behaviors/operational-credentials";
10
- import { ImplementationError, NotImplementedError, Observable, ServerAddress, Time } from "#general";
10
+ import {
11
+ Duration,
12
+ ImplementationError,
13
+ NotImplementedError,
14
+ Observable,
15
+ ServerAddress,
16
+ Time,
17
+ Timestamp,
18
+ } from "#general";
11
19
  import { DatatypeModel, FieldElement } from "#model";
12
20
  import type { ClientNode } from "#node/ClientNode.js";
13
21
  import type { Node } from "#node/Node.js";
@@ -55,7 +63,7 @@ export class CommissioningClient extends Behavior {
55
63
  }
56
64
 
57
65
  if (this.state.discoveredAt === undefined) {
58
- this.state.discoveredAt = Time.nowMs();
66
+ this.state.discoveredAt = Time.nowMs;
59
67
  }
60
68
 
61
69
  this.reactTo((this.endpoint as Node).lifecycle.partsReady, this.#initializeNode);
@@ -120,7 +128,7 @@ export class CommissioningClient extends Behavior {
120
128
  const address = identityService.assignNodeAddress(node, fabric.fabricIndex, opts.nodeId);
121
129
 
122
130
  const commissioningOptions: LocatedNodeCommissioningOptions = {
123
- addresses,
131
+ addresses: addresses.map(ServerAddress),
124
132
  fabric,
125
133
  nodeId: address.nodeId,
126
134
  passcode,
@@ -209,65 +217,67 @@ export class CommissioningClient extends Behavior {
209
217
  /**
210
218
  * Define logical schema. This enables runtime validation, make fields persistent and makes subfields editable.
211
219
  */
212
- static override readonly schema = new DatatypeModel({
213
- name: "CommissioningState",
214
- type: "struct",
215
-
216
- children: [
217
- FieldElement({
218
- name: "peerAddress",
219
- type: "struct",
220
- quality: "N",
221
- children: [
222
- FieldElement({ name: "fabricIndex", type: "fabric-id" }),
223
- FieldElement({ name: "nodeId", type: "node-id" }),
224
- ],
225
- }),
226
- FieldElement({
227
- name: "addresses",
228
- type: "list",
229
- quality: "N",
230
- children: [
231
- FieldElement({
232
- name: "entry",
233
- type: "struct",
234
- children: [
235
- FieldElement({ name: "type", type: "string" }),
236
- FieldElement({ name: "ip", type: "string" }),
237
- FieldElement({ name: "port", type: "uint16" }),
238
- FieldElement({ name: "peripheralAddress", type: "string" }),
239
- ],
240
- }),
241
- ],
242
- }),
243
- FieldElement({ name: "discoveredAt", type: "systime-ms", quality: "N", conformance: "M" }),
244
- FieldElement({ name: "onlineAt", type: "systime-ms" }),
245
- FieldElement({ name: "offlineAt", type: "systime-ms" }),
246
- FieldElement({ name: "ttl", type: "uint32", quality: "N" }),
247
- FieldElement({ name: "deviceIdentifier", type: "string", quality: "N" }),
248
- FieldElement({ name: "discriminator", type: "uint16", quality: "N" }),
249
- FieldElement({ name: "commissioningMode", type: "uint8", quality: "N" }),
250
- FieldElement({ name: "vendorId", type: "vendor-id", quality: "N" }),
251
- FieldElement({ name: "productId", type: "uint16", quality: "N" }),
252
- FieldElement({ name: "deviceType", type: "uint16", quality: "N" }),
253
- FieldElement({ name: "deviceName", type: "string", quality: "N" }),
254
- FieldElement({ name: "rotatingIdentifier", type: "string", quality: "N" }),
255
- FieldElement({ name: "pairingHint", type: "uint32", quality: "N" }),
256
- FieldElement({ name: "pairingInstructions", type: "string", quality: "N" }),
257
- FieldElement({
258
- name: "sessionParameters",
259
- type: "struct",
260
- quality: "N",
261
- children: [
262
- FieldElement({ name: "idleIntervalMs", type: "uint32", constraint: "max 3600000" }),
263
- FieldElement({ name: "activeIntervalMs", type: "uint32", constraint: "max 3600000" }),
264
- FieldElement({ name: "activeThresholdMs", type: "uint16" }),
265
- ],
266
- }),
267
- FieldElement({ name: "tcpSupport", type: "uint8", quality: "N" }),
268
- FieldElement({ name: "longIdleOperatingMode", type: "bool", quality: "N" }),
269
- ],
270
- });
220
+ static override readonly schema = new DatatypeModel(
221
+ {
222
+ name: "CommissioningState",
223
+ type: "struct",
224
+ },
225
+
226
+ FieldElement({
227
+ name: "peerAddress",
228
+ type: "struct",
229
+ quality: "N",
230
+ children: [
231
+ FieldElement({ name: "fabricIndex", type: "fabric-id" }),
232
+ FieldElement({ name: "nodeId", type: "node-id" }),
233
+ ],
234
+ }),
235
+
236
+ FieldElement({
237
+ name: "addresses",
238
+ type: "list",
239
+ quality: "N",
240
+ children: [
241
+ FieldElement({
242
+ name: "entry",
243
+ type: "struct",
244
+ children: [
245
+ FieldElement({ name: "type", type: "string" }),
246
+ FieldElement({ name: "ip", type: "string" }),
247
+ FieldElement({ name: "port", type: "uint16" }),
248
+ FieldElement({ name: "peripheralAddress", type: "string" }),
249
+ ],
250
+ }),
251
+ ],
252
+ }),
253
+
254
+ FieldElement({ name: "discoveredAt", type: "systime-ms", quality: "N", conformance: "M" }),
255
+ FieldElement({ name: "onlineAt", type: "systime-ms" }),
256
+ FieldElement({ name: "offlineAt", type: "systime-ms" }),
257
+ FieldElement({ name: "ttl", type: "uint32", quality: "N" }),
258
+ FieldElement({ name: "deviceIdentifier", type: "string", quality: "N" }),
259
+ FieldElement({ name: "discriminator", type: "uint16", quality: "N" }),
260
+ FieldElement({ name: "commissioningMode", type: "uint8", quality: "N" }),
261
+ FieldElement({ name: "vendorId", type: "vendor-id", quality: "N" }),
262
+ FieldElement({ name: "productId", type: "uint16", quality: "N" }),
263
+ FieldElement({ name: "deviceType", type: "uint16", quality: "N" }),
264
+ FieldElement({ name: "deviceName", type: "string", quality: "N" }),
265
+ FieldElement({ name: "rotatingIdentifier", type: "string", quality: "N" }),
266
+ FieldElement({ name: "pairingHint", type: "uint32", quality: "N" }),
267
+ FieldElement({ name: "pairingInstructions", type: "string", quality: "N" }),
268
+ FieldElement({
269
+ name: "sessionParameters",
270
+ type: "struct",
271
+ quality: "N",
272
+ children: [
273
+ FieldElement({ name: "idleInterval", type: "duration", constraint: "max 3600000" }),
274
+ FieldElement({ name: "activeInterval", type: "duration", constraint: "max 3600000" }),
275
+ FieldElement({ name: "activeThreshold", type: "duration", constraint: "max 65535" }),
276
+ ],
277
+ }),
278
+ FieldElement({ name: "tcpSupport", type: "uint8", quality: "N" }),
279
+ FieldElement({ name: "longIdleOperatingMode", type: "bool", quality: "N" }),
280
+ );
271
281
  }
272
282
 
273
283
  export namespace CommissioningClient {
@@ -281,27 +291,27 @@ export namespace CommissioningClient {
281
291
  * Known network addresses for the device. If this is undefined the node has not been located on any network
282
292
  * interface.
283
293
  */
284
- addresses?: ServerAddress[];
294
+ addresses?: ServerAddress.Definition[];
285
295
 
286
296
  /**
287
297
  * Time at which the device was discovered.
288
298
  */
289
- discoveredAt?: number;
299
+ discoveredAt?: Timestamp;
290
300
 
291
301
  /**
292
302
  * Time at which we discovered the device's current operational addresses.
293
303
  */
294
- onlineAt?: number;
304
+ onlineAt?: Timestamp;
295
305
 
296
306
  /**
297
307
  * Time at which we concluded the device's current operational address is unreachable.
298
308
  */
299
- offlineAt?: number;
309
+ offlineAt?: Timestamp;
300
310
 
301
311
  /**
302
- * The TTL of the discovery record if applicable.
312
+ * The TTL of the discovery record if applicable (in seconds).
303
313
  */
304
- ttl?: number;
314
+ ttl?: Duration;
305
315
 
306
316
  /**
307
317
  * The canonical global ID of the device.
@@ -4,7 +4,7 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
 
7
- import { Immutable } from "#general";
7
+ import { Immutable, Seconds, ServerAddress } from "#general";
8
8
  import { CommissionableDevice, OperationalDevice, PeerAddress, SessionParameters } from "#protocol";
9
9
  import { DeviceTypeId, VendorId } from "#types";
10
10
  import type { CommissioningClient } from "./CommissioningClient.js";
@@ -67,7 +67,7 @@ export namespace RemoteDescriptor {
67
67
  }
68
68
 
69
69
  if (ttl !== undefined) {
70
- result.ttl = ttl;
70
+ result.ttl = Seconds(ttl);
71
71
  }
72
72
 
73
73
  if (deviceIdentifier !== undefined) {
@@ -103,18 +103,18 @@ export namespace RemoteDescriptor {
103
103
  }
104
104
 
105
105
  if (sessionParameters !== undefined) {
106
- const { idleIntervalMs, activeIntervalMs, activeThresholdMs } = sessionParameters;
106
+ const { idleInterval, activeInterval, activeThreshold } = sessionParameters;
107
107
 
108
- if (idleIntervalMs !== undefined) {
109
- result.SII = idleIntervalMs;
108
+ if (idleInterval !== undefined) {
109
+ result.SII = idleInterval;
110
110
  }
111
111
 
112
- if (activeIntervalMs !== undefined) {
113
- result.SAI = activeIntervalMs;
112
+ if (activeInterval !== undefined) {
113
+ result.SAI = activeInterval;
114
114
  }
115
115
 
116
- if (activeThresholdMs !== undefined) {
117
- result.SAT = activeThresholdMs;
116
+ if (activeThreshold !== undefined) {
117
+ result.SAT = activeThreshold;
118
118
  }
119
119
  }
120
120
 
@@ -129,11 +129,11 @@ export namespace RemoteDescriptor {
129
129
  const isOperational = long.peerAddress !== undefined;
130
130
  if (isOperational) {
131
131
  if (addresses !== undefined) {
132
- result.addresses = addresses?.filter(address => address.type === "udp");
132
+ result.addresses = addresses?.filter(address => address.type === "udp").map(ServerAddress);
133
133
  }
134
134
  } else {
135
135
  if (addresses !== undefined) {
136
- result.addresses = addresses.map(address => ({ ...address }));
136
+ result.addresses = addresses.map(address => ({ ...address })).map(ServerAddress);
137
137
  }
138
138
 
139
139
  if (discriminator !== undefined) {
@@ -165,7 +165,7 @@ export namespace RemoteDescriptor {
165
165
  }
166
166
 
167
167
  if (addresses?.length) {
168
- long.addresses = addresses;
168
+ long.addresses = addresses.map(ServerAddress.definitionOf);
169
169
  }
170
170
 
171
171
  if (deviceIdentifier !== undefined) {
@@ -181,13 +181,13 @@ export namespace RemoteDescriptor {
181
181
 
182
182
  let sessionParameters: Partial<SessionParameters> | undefined;
183
183
  if (SII !== undefined) {
184
- (sessionParameters ??= {}).idleIntervalMs = SII;
184
+ (sessionParameters ??= {}).idleInterval = SII;
185
185
  }
186
186
  if (SAI !== undefined) {
187
- (sessionParameters ??= {}).activeIntervalMs = SAI;
187
+ (sessionParameters ??= {}).activeInterval = SAI;
188
188
  }
189
189
  if (SAT !== undefined) {
190
- (sessionParameters ??= {}).activeThresholdMs = SAT;
190
+ (sessionParameters ??= {}).activeThreshold = SAT;
191
191
  }
192
192
  long.sessionParameters = sessionParameters;
193
193
 
@@ -22,7 +22,7 @@ export class ContinuousDiscovery extends Discovery<ClientNode[]> {
22
22
 
23
23
  constructor(owner: ServerNode, options?: Discovery.Options) {
24
24
  super(owner, options);
25
- this.#bounded = options?.timeoutSeconds !== undefined;
25
+ this.#bounded = options?.timeout !== undefined;
26
26
  }
27
27
 
28
28
  /**
@@ -4,7 +4,7 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
 
7
- import { CancelablePromise, Diagnostic, Logger, MaybePromise, withTimeout } from "#general";
7
+ import { CancelablePromise, Diagnostic, Duration, Logger, MaybePromise, withTimeout } from "#general";
8
8
  import { ClientNodeFactory } from "#node/client/ClientNodeFactory.js";
9
9
  import type { ClientNode } from "#node/ClientNode.js";
10
10
  import type { ServerNode } from "#node/ServerNode.js";
@@ -224,8 +224,8 @@ export abstract class Discovery<T = unknown> extends CancelablePromise<T> {
224
224
 
225
225
  let promise = DiscoveryAggregateError.allSettled(promises, `${this} failed`);
226
226
 
227
- if (this.#options.timeoutSeconds !== undefined) {
228
- promise = withTimeout(this.#options.timeoutSeconds * 1_000, promise, this.stop.bind(this));
227
+ if (this.#options.timeout !== undefined) {
228
+ promise = withTimeout(this.#options.timeout, promise, this.stop.bind(this));
229
229
  }
230
230
 
231
231
  promise.then(this.#afterDiscovery.bind(this)).catch(this.#reject);
@@ -260,7 +260,7 @@ export abstract class Discovery<T = unknown> extends CancelablePromise<T> {
260
260
 
261
261
  export namespace Discovery {
262
262
  export type Options = CommissionableDeviceIdentifiers & {
263
- timeoutSeconds?: number;
263
+ timeout?: Duration;
264
264
  };
265
265
 
266
266
  export type InstanceOptions = Options & {
@@ -4,9 +4,9 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
 
7
- import { InternalError, Logger, MatterError } from "#general";
7
+ import { InternalError, Logger, MatterError, ObserverGroup } from "#general";
8
8
  import type { ClientNode } from "#node/ClientNode.js";
9
- import { ClientInteraction, ExchangeProvider, PeerSet } from "#protocol";
9
+ import { ClientInteraction, ExchangeProvider, PeerAddress, PeerSet, SessionManager } from "#protocol";
10
10
  import { CommissioningClient } from "../commissioning/CommissioningClient.js";
11
11
  import { RemoteDescriptor } from "../commissioning/RemoteDescriptor.js";
12
12
  import { NetworkRuntime } from "./NetworkRuntime.js";
@@ -21,30 +21,81 @@ const logger = Logger.get("ClientNetworkRuntime");
21
21
  */
22
22
  export class ClientNetworkRuntime extends NetworkRuntime {
23
23
  #client?: ClientInteraction;
24
+ #observers = new ObserverGroup();
24
25
 
25
26
  constructor(owner: ClientNode) {
26
27
  super(owner);
27
28
  }
28
29
 
30
+ override get owner() {
31
+ return super.owner as ClientNode;
32
+ }
33
+
29
34
  protected async start() {
35
+ // Ensure we can connect to the node
30
36
  if (!this.owner.lifecycle.isCommissioned) {
31
37
  throw new UncommissionedError(`Cannot interact with ${this.owner} because it is uncommissioned`);
32
38
  }
33
39
 
34
- const commissioningState = this.owner.stateOf(CommissioningClient);
40
+ if (this.owner.state.network.isDisabled) {
41
+ throw new UncommissionedError(`Cannot interact with ${this.owner} because it is disabled`);
42
+ }
43
+
35
44
  const address = this.owner.stateOf(CommissioningClient).peerAddress;
36
- const peers = this.owner.env.get(PeerSet);
37
45
 
38
46
  if (address === undefined) {
39
47
  throw new InternalError(`Commissioned node ${this.owner} has no peer address`);
40
48
  }
41
49
 
50
+ // Install the exchange provider for the node
51
+ const { env, lifecycle } = this.owner;
52
+ const peers = env.get(PeerSet);
53
+ const commissioningState = this.owner.stateOf(CommissioningClient);
54
+
42
55
  const exchangeProvider = await peers.exchangeProviderFor(address, {
43
56
  discoveryData: RemoteDescriptor.fromLongForm(commissioningState),
44
57
  });
45
- this.owner.env.set(ExchangeProvider, exchangeProvider);
58
+ env.set(ExchangeProvider, exchangeProvider);
59
+
60
+ // Monitor sessions to maintain online state. We consider the node "online" if there is an active session. If
61
+ // not, we consider the node offline. This is the only real way we have of determining whether the node is
62
+ // healthy without actively polling
63
+ this.#client = env.get(ClientInteraction);
64
+ const { sessions } = env.get(SessionManager);
65
+
66
+ if (sessions.find(session => session.peerIs(address))) {
67
+ this.owner.act(({ context }) => lifecycle.online.emit(context));
68
+ }
46
69
 
47
- this.#client = this.owner.env.get(ClientInteraction);
70
+ this.#observers.on(sessions.added, session => {
71
+ if (lifecycle.isOnline) {
72
+ return;
73
+ }
74
+
75
+ const address = PeerAddress(commissioningState.peerAddress);
76
+ if (!address || session.peerAddress !== address) {
77
+ return;
78
+ }
79
+
80
+ this.owner.act(({ context }) => lifecycle.online.emit(context));
81
+ });
82
+
83
+ this.#observers.on(sessions.deleted, session => {
84
+ if (!lifecycle.isOnline) {
85
+ return;
86
+ }
87
+
88
+ const address = PeerAddress(commissioningState.peerAddress);
89
+ if (session.peerAddress !== address) {
90
+ return;
91
+ }
92
+
93
+ if (address && sessions.find(({ peerAddress }) => peerAddress === address)) {
94
+ return;
95
+ }
96
+
97
+ this.owner.act(({ context }) => lifecycle.offline.emit(context));
98
+ });
48
99
  }
49
100
 
50
101
  protected async stop() {
@@ -55,6 +106,8 @@ export class ClientNetworkRuntime extends NetworkRuntime {
55
106
  } catch (e) {
56
107
  logger.error(`Error closing connection to ${this.owner}`, e);
57
108
  }
109
+
110
+ this.#observers.close();
58
111
  }
59
112
 
60
113
  blockNewActivity() {
@@ -4,7 +4,7 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
 
7
- import { STANDARD_MATTER_PORT } from "#general";
7
+ import { MaybePromise, STANDARD_MATTER_PORT } from "#general";
8
8
  import { Behavior } from "../../Behavior.js";
9
9
  import type { NetworkRuntime } from "./NetworkRuntime.js";
10
10
 
@@ -24,6 +24,11 @@ export class NetworkBehavior extends Behavior {
24
24
  override [Symbol.asyncDispose]() {
25
25
  return this.internal.runtime?.close();
26
26
  }
27
+
28
+ /**
29
+ * Invoked by node when networking is ready.
30
+ */
31
+ startup(): MaybePromise {}
27
32
  }
28
33
 
29
34
  export namespace NetworkBehavior {
@@ -6,7 +6,7 @@
6
6
 
7
7
  import { DatatypeModel, FieldElement } from "#model";
8
8
  import { Node } from "#node/Node.js";
9
- import { DEFAULT_MIN_INTERVAL_FLOOR_SECONDS, Subscribe } from "#protocol";
9
+ import { DEFAULT_MIN_INTERVAL_FLOOR, Subscribe } from "#protocol";
10
10
  import { ClientNetworkRuntime } from "./ClientNetworkRuntime.js";
11
11
  import { NetworkBehavior } from "./NetworkBehavior.js";
12
12
 
@@ -14,22 +14,18 @@ export class NetworkClient extends NetworkBehavior {
14
14
  declare internal: NetworkClient.Internal;
15
15
  declare state: NetworkClient.State;
16
16
 
17
- override initialize() {
18
- this.reactTo(this.#node.lifecycle.online, this.startup);
19
- }
20
-
21
- protected async startup() {
22
- const { startupSubscription } = this.state;
17
+ override async startup() {
18
+ const { startupSubscription, isDisabled } = this.state;
23
19
 
24
- if (startupSubscription === null) {
20
+ if (startupSubscription === null || isDisabled) {
25
21
  return;
26
22
  }
27
23
 
28
24
  // TODO - configure subscription based on physical device properties
29
25
  const subscribe = Subscribe({
30
26
  fabricFilter: true,
31
- minIntervalFloorSeconds: DEFAULT_MIN_INTERVAL_FLOOR_SECONDS,
32
- maxIntervalCeilingSeconds: 0,
27
+ minIntervalFloor: DEFAULT_MIN_INTERVAL_FLOOR,
28
+ maxIntervalCeiling: 0,
33
29
  attributes: [{}],
34
30
  ...startupSubscription,
35
31
  });
@@ -59,6 +55,12 @@ export class NetworkClient extends NetworkBehavior {
59
55
  default: { type: "properties", properties: {} },
60
56
  quality: "XN",
61
57
  }),
58
+
59
+ FieldElement({
60
+ name: "isDisabled",
61
+ type: "bool",
62
+ quality: "N",
63
+ }),
62
64
  ],
63
65
  });
64
66
  }
@@ -72,11 +74,16 @@ export namespace NetworkClient {
72
74
  /**
73
75
  * A subscription installed when the node is first commissioned and when the service is restarted.
74
76
  *
75
- * The default subscription is a wildcard for all attributes and of the node. You can set to undefined or
76
- * filter the fields and values but only values selected by this subscription will update automatically.
77
+ * The default subscription is a wildcard for all attributes of the node. You can set to undefined or filter
78
+ * the fields and values but only values selected by this subscription will update automatically.
77
79
  *
78
80
  * Set to null to disable automatic subscription.
79
81
  */
80
82
  startupSubscription?: Subscribe | null;
83
+
84
+ /**
85
+ * If true, the matter.js will not perform network communication with the node.
86
+ */
87
+ isDisabled = false;
81
88
  }
82
89
  }
@@ -34,7 +34,6 @@ export abstract class NetworkRuntime {
34
34
 
35
35
  async [Construction.construct]() {
36
36
  await this.start();
37
- await this.#owner.act(agent => this.owner.lifecycle.online.emit(agent.context));
38
37
  }
39
38
 
40
39
  async [Construction.destruct]() {
@@ -4,7 +4,7 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
 
7
- import { SubscriptionBehavior } from "#behavior/system/subscription/SubscriptionBehavior.js";
7
+ import { SubscriptionsBehavior } from "#behavior/system/subscriptions/SubscriptionsServer.js";
8
8
  import {
9
9
  Construction,
10
10
  Crypto,
@@ -293,6 +293,8 @@ export class ServerNetworkRuntime extends NetworkRuntime {
293
293
  if (this.owner.stateOf(CommissioningServer).commissioned) {
294
294
  this.enableMdnsAdvertising();
295
295
  }
296
+
297
+ await this.owner.act(agent => this.owner.lifecycle.online.emit(agent.context));
296
298
  }
297
299
 
298
300
  override async [Construction.construct]() {
@@ -355,7 +357,7 @@ export class ServerNetworkRuntime extends NetworkRuntime {
355
357
  this.#formerSubscriptionsHandled = true;
356
358
 
357
359
  await this.owner.act(agent =>
358
- agent.get(SubscriptionBehavior).reestablishFormerSubscriptions(env.get(InteractionServer)),
360
+ agent.get(SubscriptionsBehavior).reestablishFormerSubscriptions(env.get(InteractionServer)),
359
361
  );
360
362
  }
361
363
 
@@ -72,7 +72,7 @@ export class SessionsBehavior extends Behavior {
72
72
  return;
73
73
  }
74
74
 
75
- // When subscription was added then inform SubscriptionBehavior
75
+ // When subscription was added then inform SubscriptionsBehavior
76
76
  if (session.subscriptions.has(subscription)) {
77
77
  this.events.subscriptionAdded.emit(subscription);
78
78
  }
@@ -4,7 +4,7 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
 
7
- import { deepCopy, isIpNetworkChannel, Logger, MatterError, MaybePromise, ServerAddressIp } from "#general";
7
+ import { deepCopy, isIpNetworkChannel, Logger, MatterError, MaybePromise, Seconds, ServerAddressIp } from "#general";
8
8
  import { DatatypeModel, FieldElement } from "#model";
9
9
  import { InteractionServer, PeerSubscription } from "#node/server/InteractionServer.js";
10
10
  import { ServerSubscription } from "#node/server/ServerSubscription.js";
@@ -21,10 +21,10 @@ import {
21
21
  import { StatusCode, StatusResponseError } from "#types";
22
22
  import { Behavior } from "../../Behavior.js";
23
23
  import { SessionsBehavior } from "../sessions/SessionsBehavior.js";
24
- const logger = Logger.get("SubscriptionBehavior");
24
+ const logger = Logger.get("SubscriptionsBehavior");
25
25
 
26
26
  /** Timeout in seconds to wait for responses or discovery of the peer node when trying to re-establish a subscription. */
27
- const REESTABLISH_SUBSCRIPTIONS_TIMEOUT_S = 2;
27
+ const REESTABLISH_SUBSCRIPTIONS_TIMEOUT = Seconds(2);
28
28
 
29
29
  /**
30
30
  * Subscriptions Persistence handling.
@@ -33,11 +33,11 @@ const REESTABLISH_SUBSCRIPTIONS_TIMEOUT_S = 2;
33
33
  * speed up the controller reconnection process. This can mean a bit more memory usage on start of the device. To
34
34
  * disable this feature set `persistenceEnabled` as state of the `subscription` behavior to `false`.
35
35
  */
36
- export class SubscriptionBehavior extends Behavior {
37
- static override readonly id = "subscription";
36
+ export class SubscriptionsBehavior extends Behavior {
37
+ static override readonly id = "subscriptions";
38
38
 
39
- declare state: SubscriptionBehavior.State;
40
- declare internal: SubscriptionBehavior.Internal;
39
+ declare state: SubscriptionsBehavior.State;
40
+ declare internal: SubscriptionsBehavior.Internal;
41
41
 
42
42
  override initialize() {
43
43
  if (this.state.subscriptions !== undefined && this.state.persistenceEnabled !== false) {
@@ -115,10 +115,10 @@ export class SubscriptionBehavior extends Behavior {
115
115
  ),
116
116
  ),
117
117
  FieldElement({ name: "isFabricFiltered", type: "bool" }),
118
- FieldElement({ name: "maxIntervalCeilingSeconds", type: "uint16" }),
119
- FieldElement({ name: "minIntervalFloorSeconds", type: "uint16" }),
120
- FieldElement({ name: "maxInterval", type: "uint16" }),
121
- FieldElement({ name: "sendInterval", type: "uint16" }),
118
+ FieldElement({ name: "maxIntervalCeiling", type: "duration" }),
119
+ FieldElement({ name: "minIntervalFloor", type: "duration" }),
120
+ FieldElement({ name: "maxInterval", type: "duration" }),
121
+ FieldElement({ name: "sendInterval", type: "duration" }),
122
122
  FieldElement(
123
123
  {
124
124
  name: "operationalAddress",
@@ -142,8 +142,8 @@ export class SubscriptionBehavior extends Behavior {
142
142
  maxInterval,
143
143
  sendInterval,
144
144
  id,
145
- maxIntervalCeilingSeconds,
146
- minIntervalFloorSeconds,
145
+ maxIntervalCeiling,
146
+ minIntervalFloor,
147
147
  } = subscription;
148
148
  const { peerAddress } = session;
149
149
  const { fabricIndex, nodeId } = peerAddress;
@@ -160,8 +160,8 @@ export class SubscriptionBehavior extends Behavior {
160
160
  const peerSubscription: PeerSubscription = {
161
161
  subscriptionId: id,
162
162
  peerAddress: { fabricIndex, nodeId },
163
- maxIntervalCeilingSeconds,
164
- minIntervalFloorSeconds,
163
+ maxIntervalCeiling,
164
+ minIntervalFloor,
165
165
  attributeRequests,
166
166
  eventRequests,
167
167
  isFabricFiltered,
@@ -234,7 +234,7 @@ export class SubscriptionBehavior extends Behavior {
234
234
  await peers.ensureConnection(peerAddress, {
235
235
  discoveryOptions: {
236
236
  discoveryType: NodeDiscoveryType.TimedDiscovery,
237
- timeoutSeconds: REESTABLISH_SUBSCRIPTIONS_TIMEOUT_S,
237
+ timeout: REESTABLISH_SUBSCRIPTIONS_TIMEOUT,
238
238
  },
239
239
  allowUnknownPeer: true,
240
240
  operationalAddress,
@@ -282,7 +282,7 @@ export class SubscriptionBehavior extends Behavior {
282
282
  }
283
283
  }
284
284
 
285
- export namespace SubscriptionBehavior {
285
+ export namespace SubscriptionsBehavior {
286
286
  export class State {
287
287
  /** Set to false if persistence of subscriptions should be disabled */
288
288
  persistenceEnabled = true;