@matter/node 0.18.0 → 0.18.1-alpha.0-20261111-b89790712

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 (353) hide show
  1. package/dist/cjs/behavior/Behavior.d.ts.map +1 -1
  2. package/dist/cjs/behavior/Behavior.js +2 -0
  3. package/dist/cjs/behavior/Behavior.js.map +1 -1
  4. package/dist/cjs/behavior/Events.d.ts.map +1 -1
  5. package/dist/cjs/behavior/Events.js +4 -2
  6. package/dist/cjs/behavior/Events.js.map +1 -1
  7. package/dist/cjs/behavior/cluster/ClusterBehavior.d.ts +17 -3
  8. package/dist/cjs/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
  9. package/dist/cjs/behavior/cluster/ClusterBehavior.js +2 -20
  10. package/dist/cjs/behavior/cluster/ClusterBehavior.js.map +1 -1
  11. package/dist/cjs/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
  12. package/dist/cjs/behavior/cluster/ClusterBehaviorType.js +8 -150
  13. package/dist/cjs/behavior/cluster/ClusterBehaviorType.js.map +1 -1
  14. package/dist/cjs/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  15. package/dist/cjs/behavior/internal/BehaviorBacking.js +2 -0
  16. package/dist/cjs/behavior/internal/BehaviorBacking.js.map +1 -1
  17. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts +45 -0
  18. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  19. package/dist/cjs/behavior/internal/ClusterDerivation.js +192 -0
  20. package/dist/cjs/behavior/internal/ClusterDerivation.js.map +6 -0
  21. package/dist/cjs/behavior/internal/ClusterStatics.d.ts +16 -0
  22. package/dist/cjs/behavior/internal/ClusterStatics.d.ts.map +1 -0
  23. package/dist/cjs/behavior/internal/ClusterStatics.js +138 -0
  24. package/dist/cjs/behavior/internal/ClusterStatics.js.map +6 -0
  25. package/dist/cjs/behavior/internal/ModeledState.d.ts +18 -0
  26. package/dist/cjs/behavior/internal/ModeledState.d.ts.map +1 -0
  27. package/dist/cjs/behavior/internal/ModeledState.js +54 -0
  28. package/dist/cjs/behavior/internal/ModeledState.js.map +6 -0
  29. package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  30. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js +3 -12
  31. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  32. package/dist/cjs/behavior/state/managed/Datasource.js +28 -17
  33. package/dist/cjs/behavior/state/managed/Datasource.js.map +1 -1
  34. package/dist/cjs/behavior/state/managed/Internal.d.ts +16 -5
  35. package/dist/cjs/behavior/state/managed/Internal.d.ts.map +1 -1
  36. package/dist/cjs/behavior/state/managed/Internal.js +23 -25
  37. package/dist/cjs/behavior/state/managed/Internal.js.map +1 -1
  38. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts +45 -12
  39. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  40. package/dist/cjs/behavior/state/managed/ManagedReference.js +74 -44
  41. package/dist/cjs/behavior/state/managed/ManagedReference.js.map +1 -1
  42. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts +31 -0
  43. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  44. package/dist/cjs/behavior/state/managed/ReadOnlyReference.js +60 -0
  45. package/dist/cjs/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  46. package/dist/cjs/behavior/state/managed/ValReference.d.ts +47 -10
  47. package/dist/cjs/behavior/state/managed/ValReference.d.ts.map +1 -1
  48. package/dist/cjs/behavior/state/managed/ValReference.js +29 -0
  49. package/dist/cjs/behavior/state/managed/ValReference.js.map +2 -2
  50. package/dist/cjs/behavior/state/managed/values/BitmapManager.js +5 -20
  51. package/dist/cjs/behavior/state/managed/values/BitmapManager.js.map +1 -1
  52. package/dist/cjs/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  53. package/dist/cjs/behavior/state/managed/values/ListManager.js +262 -119
  54. package/dist/cjs/behavior/state/managed/values/ListManager.js.map +2 -2
  55. package/dist/cjs/behavior/state/managed/values/StructManager.js +14 -23
  56. package/dist/cjs/behavior/state/managed/values/StructManager.js.map +2 -2
  57. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts +13 -3
  58. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  59. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js +12 -0
  60. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  61. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  62. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  63. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js +9 -0
  64. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  65. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  66. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  67. package/dist/cjs/behavior/system/controller/ControllerBehavior.js +2 -1
  68. package/dist/cjs/behavior/system/controller/ControllerBehavior.js.map +1 -1
  69. package/dist/cjs/behavior/system/dcl/DclBehavior.d.ts +3 -3
  70. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  71. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  72. package/dist/cjs/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  73. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  74. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  75. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js +6 -1
  76. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  77. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  78. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  79. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js +74 -0
  80. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  81. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  82. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  83. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  84. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  85. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts +2 -2
  86. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  87. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  88. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  89. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  90. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  91. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  92. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +104 -60
  93. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  94. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  95. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  96. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  97. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  98. package/dist/cjs/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  99. package/dist/cjs/behaviors/groupcast/GroupcastServer.js +41 -25
  100. package/dist/cjs/behaviors/groupcast/GroupcastServer.js.map +2 -2
  101. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  102. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  103. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  104. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  105. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js +27 -23
  106. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  107. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  108. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  109. package/dist/cjs/behaviors/thermostat/ThermostatServer.js +66 -49
  110. package/dist/cjs/behaviors/thermostat/ThermostatServer.js.map +1 -1
  111. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  112. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  113. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +1 -1
  114. package/dist/cjs/endpoint/properties/Behaviors.d.ts.map +1 -1
  115. package/dist/cjs/endpoint/properties/Behaviors.js +5 -1
  116. package/dist/cjs/endpoint/properties/Behaviors.js.map +1 -1
  117. package/dist/cjs/node/ClientNode.d.ts +6 -0
  118. package/dist/cjs/node/ClientNode.d.ts.map +1 -1
  119. package/dist/cjs/node/ClientNode.js +6 -0
  120. package/dist/cjs/node/ClientNode.js.map +1 -1
  121. package/dist/cjs/node/ServerNode.d.ts.map +1 -1
  122. package/dist/cjs/node/ServerNode.js +2 -0
  123. package/dist/cjs/node/ServerNode.js.map +1 -1
  124. package/dist/cjs/node/client/ClientEventEmitter.d.ts.map +1 -1
  125. package/dist/cjs/node/client/ClientEventEmitter.js +6 -2
  126. package/dist/cjs/node/client/ClientEventEmitter.js.map +1 -1
  127. package/dist/cjs/node/client/ClientStructure.d.ts.map +1 -1
  128. package/dist/cjs/node/client/ClientStructure.js +181 -108
  129. package/dist/cjs/node/client/ClientStructure.js.map +2 -2
  130. package/dist/cjs/node/client/Peers.d.ts +3 -2
  131. package/dist/cjs/node/client/Peers.d.ts.map +1 -1
  132. package/dist/cjs/node/client/Peers.js +8 -9
  133. package/dist/cjs/node/client/Peers.js.map +1 -1
  134. package/dist/cjs/node/integration/ChangeNotificationService.d.ts +14 -3
  135. package/dist/cjs/node/integration/ChangeNotificationService.d.ts.map +1 -1
  136. package/dist/cjs/node/integration/ProtocolService.d.ts.map +1 -1
  137. package/dist/cjs/node/integration/ProtocolService.js +38 -56
  138. package/dist/cjs/node/integration/ProtocolService.js.map +1 -1
  139. package/dist/cjs/node/server/InteractionServer.d.ts.map +1 -1
  140. package/dist/cjs/node/server/InteractionServer.js +28 -24
  141. package/dist/cjs/node/server/InteractionServer.js.map +2 -2
  142. package/dist/cjs/node/server/ServerSubscription.d.ts +7 -2
  143. package/dist/cjs/node/server/ServerSubscription.d.ts.map +1 -1
  144. package/dist/cjs/node/server/ServerSubscription.js +83 -47
  145. package/dist/cjs/node/server/ServerSubscription.js.map +1 -1
  146. package/dist/cjs/testing/mock-server-node.d.ts +2 -1
  147. package/dist/cjs/testing/mock-server-node.d.ts.map +1 -1
  148. package/dist/cjs/testing/mock-server-node.js +8 -5
  149. package/dist/cjs/testing/mock-server-node.js.map +2 -2
  150. package/dist/cjs/testing/node-helpers.d.ts +5 -0
  151. package/dist/cjs/testing/node-helpers.d.ts.map +1 -1
  152. package/dist/cjs/testing/node-helpers.js +4 -4
  153. package/dist/cjs/testing/node-helpers.js.map +1 -1
  154. package/dist/esm/behavior/Behavior.d.ts.map +1 -1
  155. package/dist/esm/behavior/Behavior.js +2 -0
  156. package/dist/esm/behavior/Behavior.js.map +1 -1
  157. package/dist/esm/behavior/Events.d.ts.map +1 -1
  158. package/dist/esm/behavior/Events.js +4 -2
  159. package/dist/esm/behavior/Events.js.map +1 -1
  160. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts +17 -3
  161. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
  162. package/dist/esm/behavior/cluster/ClusterBehavior.js +2 -20
  163. package/dist/esm/behavior/cluster/ClusterBehavior.js.map +1 -1
  164. package/dist/esm/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
  165. package/dist/esm/behavior/cluster/ClusterBehaviorType.js +10 -159
  166. package/dist/esm/behavior/cluster/ClusterBehaviorType.js.map +1 -1
  167. package/dist/esm/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  168. package/dist/esm/behavior/internal/BehaviorBacking.js +2 -0
  169. package/dist/esm/behavior/internal/BehaviorBacking.js.map +1 -1
  170. package/dist/esm/behavior/internal/ClusterDerivation.d.ts +45 -0
  171. package/dist/esm/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  172. package/dist/esm/behavior/internal/ClusterDerivation.js +172 -0
  173. package/dist/esm/behavior/internal/ClusterDerivation.js.map +6 -0
  174. package/dist/esm/behavior/internal/ClusterStatics.d.ts +16 -0
  175. package/dist/esm/behavior/internal/ClusterStatics.d.ts.map +1 -0
  176. package/dist/esm/behavior/internal/ClusterStatics.js +118 -0
  177. package/dist/esm/behavior/internal/ClusterStatics.js.map +6 -0
  178. package/dist/esm/behavior/internal/ModeledState.d.ts +18 -0
  179. package/dist/esm/behavior/internal/ModeledState.d.ts.map +1 -0
  180. package/dist/esm/behavior/internal/ModeledState.js +34 -0
  181. package/dist/esm/behavior/internal/ModeledState.js.map +6 -0
  182. package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  183. package/dist/esm/behavior/internal/ServerBehaviorBacking.js +3 -12
  184. package/dist/esm/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  185. package/dist/esm/behavior/state/managed/Datasource.js +28 -17
  186. package/dist/esm/behavior/state/managed/Datasource.js.map +1 -1
  187. package/dist/esm/behavior/state/managed/Internal.d.ts +16 -5
  188. package/dist/esm/behavior/state/managed/Internal.d.ts.map +1 -1
  189. package/dist/esm/behavior/state/managed/Internal.js +23 -25
  190. package/dist/esm/behavior/state/managed/Internal.js.map +1 -1
  191. package/dist/esm/behavior/state/managed/ManagedReference.d.ts +45 -12
  192. package/dist/esm/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  193. package/dist/esm/behavior/state/managed/ManagedReference.js +75 -45
  194. package/dist/esm/behavior/state/managed/ManagedReference.js.map +1 -1
  195. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts +31 -0
  196. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  197. package/dist/esm/behavior/state/managed/ReadOnlyReference.js +40 -0
  198. package/dist/esm/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  199. package/dist/esm/behavior/state/managed/ValReference.d.ts +47 -10
  200. package/dist/esm/behavior/state/managed/ValReference.d.ts.map +1 -1
  201. package/dist/esm/behavior/state/managed/ValReference.js +25 -0
  202. package/dist/esm/behavior/state/managed/ValReference.js.map +2 -2
  203. package/dist/esm/behavior/state/managed/values/BitmapManager.js +6 -21
  204. package/dist/esm/behavior/state/managed/values/BitmapManager.js.map +1 -1
  205. package/dist/esm/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  206. package/dist/esm/behavior/state/managed/values/ListManager.js +264 -129
  207. package/dist/esm/behavior/state/managed/values/ListManager.js.map +2 -2
  208. package/dist/esm/behavior/state/managed/values/StructManager.js +15 -24
  209. package/dist/esm/behavior/state/managed/values/StructManager.js.map +2 -2
  210. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts +13 -3
  211. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  212. package/dist/esm/behavior/system/commissioning/CommissioningClient.js +12 -0
  213. package/dist/esm/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  214. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  215. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  216. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js +10 -1
  217. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  218. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  219. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  220. package/dist/esm/behavior/system/controller/ControllerBehavior.js +2 -1
  221. package/dist/esm/behavior/system/controller/ControllerBehavior.js.map +1 -1
  222. package/dist/esm/behavior/system/dcl/DclBehavior.d.ts +3 -3
  223. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  224. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  225. package/dist/esm/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  226. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  227. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  228. package/dist/esm/behavior/system/sessions/SessionsBehavior.js +6 -1
  229. package/dist/esm/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  230. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  231. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  232. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js +54 -0
  233. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  234. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  235. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  236. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  237. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  238. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts +2 -2
  239. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  240. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  241. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  242. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  243. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  244. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  245. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +105 -60
  246. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  247. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  248. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  249. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  250. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  251. package/dist/esm/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  252. package/dist/esm/behaviors/groupcast/GroupcastServer.js +42 -25
  253. package/dist/esm/behaviors/groupcast/GroupcastServer.js.map +2 -2
  254. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  255. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  256. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  257. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  258. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js +32 -24
  259. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  260. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  261. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  262. package/dist/esm/behaviors/thermostat/ThermostatServer.js +66 -49
  263. package/dist/esm/behaviors/thermostat/ThermostatServer.js.map +1 -1
  264. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  265. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  266. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +1 -1
  267. package/dist/esm/endpoint/properties/Behaviors.d.ts.map +1 -1
  268. package/dist/esm/endpoint/properties/Behaviors.js +6 -2
  269. package/dist/esm/endpoint/properties/Behaviors.js.map +1 -1
  270. package/dist/esm/node/ClientNode.d.ts +6 -0
  271. package/dist/esm/node/ClientNode.d.ts.map +1 -1
  272. package/dist/esm/node/ClientNode.js +6 -0
  273. package/dist/esm/node/ClientNode.js.map +1 -1
  274. package/dist/esm/node/ServerNode.d.ts.map +1 -1
  275. package/dist/esm/node/ServerNode.js +2 -0
  276. package/dist/esm/node/ServerNode.js.map +1 -1
  277. package/dist/esm/node/client/ClientEventEmitter.d.ts.map +1 -1
  278. package/dist/esm/node/client/ClientEventEmitter.js +6 -2
  279. package/dist/esm/node/client/ClientEventEmitter.js.map +1 -1
  280. package/dist/esm/node/client/ClientStructure.d.ts.map +1 -1
  281. package/dist/esm/node/client/ClientStructure.js +181 -108
  282. package/dist/esm/node/client/ClientStructure.js.map +2 -2
  283. package/dist/esm/node/client/Peers.d.ts +3 -2
  284. package/dist/esm/node/client/Peers.d.ts.map +1 -1
  285. package/dist/esm/node/client/Peers.js +8 -10
  286. package/dist/esm/node/client/Peers.js.map +1 -1
  287. package/dist/esm/node/integration/ChangeNotificationService.d.ts +14 -3
  288. package/dist/esm/node/integration/ChangeNotificationService.d.ts.map +1 -1
  289. package/dist/esm/node/integration/ProtocolService.d.ts.map +1 -1
  290. package/dist/esm/node/integration/ProtocolService.js +40 -57
  291. package/dist/esm/node/integration/ProtocolService.js.map +1 -1
  292. package/dist/esm/node/server/InteractionServer.d.ts.map +1 -1
  293. package/dist/esm/node/server/InteractionServer.js +28 -25
  294. package/dist/esm/node/server/InteractionServer.js.map +2 -2
  295. package/dist/esm/node/server/ServerSubscription.d.ts +7 -2
  296. package/dist/esm/node/server/ServerSubscription.d.ts.map +1 -1
  297. package/dist/esm/node/server/ServerSubscription.js +83 -47
  298. package/dist/esm/node/server/ServerSubscription.js.map +1 -1
  299. package/dist/esm/testing/mock-server-node.d.ts +2 -1
  300. package/dist/esm/testing/mock-server-node.d.ts.map +1 -1
  301. package/dist/esm/testing/mock-server-node.js +16 -7
  302. package/dist/esm/testing/mock-server-node.js.map +2 -2
  303. package/dist/esm/testing/node-helpers.d.ts +5 -0
  304. package/dist/esm/testing/node-helpers.d.ts.map +1 -1
  305. package/dist/esm/testing/node-helpers.js +4 -4
  306. package/dist/esm/testing/node-helpers.js.map +1 -1
  307. package/package.json +6 -6
  308. package/src/behavior/Behavior.ts +2 -0
  309. package/src/behavior/Events.ts +6 -3
  310. package/src/behavior/cluster/ClusterBehavior.ts +22 -13
  311. package/src/behavior/cluster/ClusterBehaviorType.ts +9 -270
  312. package/src/behavior/internal/BehaviorBacking.ts +3 -0
  313. package/src/behavior/internal/ClusterDerivation.ts +295 -0
  314. package/src/behavior/internal/ClusterStatics.ts +180 -0
  315. package/src/behavior/internal/ModeledState.ts +58 -0
  316. package/src/behavior/internal/ServerBehaviorBacking.ts +3 -15
  317. package/src/behavior/state/managed/Datasource.ts +36 -21
  318. package/src/behavior/state/managed/Internal.ts +36 -33
  319. package/src/behavior/state/managed/ManagedReference.ts +120 -68
  320. package/src/behavior/state/managed/ReadOnlyReference.ts +54 -0
  321. package/src/behavior/state/managed/ValReference.ts +67 -11
  322. package/src/behavior/state/managed/values/BitmapManager.ts +6 -22
  323. package/src/behavior/state/managed/values/ListManager.ts +301 -146
  324. package/src/behavior/state/managed/values/StructManager.ts +20 -29
  325. package/src/behavior/system/commissioning/CommissioningClient.ts +22 -3
  326. package/src/behavior/system/commissioning/RemoteDescriptor.ts +17 -1
  327. package/src/behavior/system/controller/ControllerBehavior.ts +2 -1
  328. package/src/behavior/system/dcl/DclBehavior.ts +3 -3
  329. package/src/behavior/system/network/ServerGroupNetworking.ts +3 -2
  330. package/src/behavior/system/sessions/SessionsBehavior.ts +8 -2
  331. package/src/behavior/system/subscriptions/SubscriptionStore.ts +66 -0
  332. package/src/behavior/system/subscriptions/SubscriptionsServer.ts +73 -33
  333. package/src/behaviors/access-control/AccessControlServer.ts +3 -3
  334. package/src/behaviors/administrator-commissioning/AdministratorCommissioningServer.ts +47 -24
  335. package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts +138 -84
  336. package/src/behaviors/group-key-management/GroupKeyManagementServer.ts +12 -8
  337. package/src/behaviors/groupcast/GroupcastServer.ts +50 -34
  338. package/src/behaviors/localization-configuration/LocalizationConfigurationServer.ts +1 -1
  339. package/src/behaviors/operational-credentials/VendorIdVerification.ts +50 -35
  340. package/src/behaviors/thermostat/ThermostatServer.ts +93 -70
  341. package/src/behaviors/time-format-localization/TimeFormatLocalizationServer.ts +4 -4
  342. package/src/endpoint/properties/Behaviors.ts +6 -2
  343. package/src/node/ClientNode.ts +6 -0
  344. package/src/node/ServerNode.ts +2 -0
  345. package/src/node/client/ClientEventEmitter.ts +7 -3
  346. package/src/node/client/ClientStructure.ts +208 -135
  347. package/src/node/client/Peers.ts +10 -14
  348. package/src/node/integration/ChangeNotificationService.ts +18 -3
  349. package/src/node/integration/ProtocolService.ts +45 -57
  350. package/src/node/server/InteractionServer.ts +33 -35
  351. package/src/node/server/ServerSubscription.ts +88 -50
  352. package/src/testing/mock-server-node.ts +22 -9
  353. package/src/testing/node-helpers.ts +5 -1
@@ -27,7 +27,8 @@ import { AdministratorCommissioningBehavior } from "./AdministratorCommissioning
27
27
 
28
28
  /**
29
29
  * Extend the AdministratorCommissioning model to relax constraints on OpenCommissioningWindow fields. This prevents
30
- * the interaction layer from rejecting with ConstraintError so the behavior can validate and return PakeParameterError.
30
+ * the interaction layer from rejecting with ConstraintError so the behavior can validate and return PakeParameterError
31
+ * or INVALID_COMMAND as § 11.19.8.1 requires.
31
32
  */
32
33
  const openCommissioningWindow = AdministratorCommissioning.schema.commands.require("OpenCommissioningWindow");
33
34
 
@@ -38,9 +39,12 @@ const AdministratorCommissioningSchema = AdministratorCommissioning.schema.exten
38
39
  openCommissioningWindow.fields.extend("PakePasscodeVerifier", { constraint: "none" }),
39
40
  openCommissioningWindow.fields.extend("Iterations", { constraint: "none" }),
40
41
  openCommissioningWindow.fields.extend("Salt", { constraint: "none" }),
42
+ openCommissioningWindow.fields.extend("Discriminator", { constraint: "none" }),
41
43
  ),
42
44
  );
43
45
 
46
+ const MAX_DISCRIMINATOR = 0xfff;
47
+
44
48
  const AdministratorCommissioningBase = AdministratorCommissioningBehavior.for(
45
49
  AdministratorCommissioning,
46
50
  AdministratorCommissioningSchema,
@@ -70,6 +74,10 @@ export class AdministratorCommissioningServer extends AdministratorCommissioning
70
74
  salt,
71
75
  commissioningTimeout,
72
76
  }: AdministratorCommissioning.OpenCommissioningWindowRequest) {
77
+ const commissioner = this.env.get(DeviceCommissioner);
78
+ const adminFabric = this.#adminFabric();
79
+ this.#assertNoCommissioningInProgress(commissioner);
80
+
73
81
  // We monkey patched the Tlv definition above, so take care about correct error handling
74
82
  if (pakePasscodeVerifier.byteLength !== PAKE_PASSCODE_VERIFIER_LENGTH) {
75
83
  throw new AdministratorCommissioning.PakeParameterError("PAKE passcode verifier length is invalid");
@@ -80,11 +88,13 @@ export class AdministratorCommissioningServer extends AdministratorCommissioning
80
88
  if (salt.byteLength < 16 || salt.byteLength > 32) {
81
89
  throw new AdministratorCommissioning.PakeParameterError("PAKE salt has invalid length.");
82
90
  }
83
-
84
- const commissioner = this.env.get(DeviceCommissioner);
85
- const timeout = Seconds(commissioningTimeout);
86
- this.#assertCommissioningWindowRequirements(timeout, commissioner);
87
- const adminFabric = this.#adminFabric();
91
+ const timeout = this.#windowTimeout(commissioningTimeout);
92
+ if (discriminator > MAX_DISCRIMINATOR) {
93
+ throw new StatusResponseError(
94
+ `Discriminator ${discriminator} exceeds the maximum of ${MAX_DISCRIMINATOR}`,
95
+ Status.InvalidCommand,
96
+ );
97
+ }
88
98
 
89
99
  await commissioner.allowEnhancedCommissioning(
90
100
  discriminator,
@@ -107,9 +117,9 @@ export class AdministratorCommissioningServer extends AdministratorCommissioning
107
117
  commissioningTimeout,
108
118
  }: AdministratorCommissioning.OpenBasicCommissioningWindowRequest) {
109
119
  const commissioner = this.env.get(DeviceCommissioner);
110
- const timeout = Seconds(commissioningTimeout);
111
- this.#assertCommissioningWindowRequirements(timeout, commissioner);
112
120
  const adminFabric = this.#adminFabric();
121
+ this.#assertNoCommissioningInProgress(commissioner);
122
+ const timeout = this.#windowTimeout(commissioningTimeout);
113
123
 
114
124
  await commissioner.allowBasicCommissioning(this.#windowOptions(timeout));
115
125
 
@@ -151,9 +161,19 @@ export class AdministratorCommissioningServer extends AdministratorCommissioning
151
161
  await this.#closeCommissioningWindow();
152
162
  }
153
163
 
164
+ /**
165
+ * The fabric of the administrator that opens the window. A PASE session has none before AddNOC. The
166
+ * specification names no status for that case; CHIP answers PAKEParameterError.
167
+ */
154
168
  #adminFabric() {
155
169
  assertRemoteActor(this.context);
156
- return this.context.session.associatedFabric;
170
+ const { fabric } = this.context.session;
171
+ if (fabric === undefined) {
172
+ throw new AdministratorCommissioning.PakeParameterError(
173
+ "Opening a commissioning window requires a session on a fabric",
174
+ );
175
+ }
176
+ return fabric;
157
177
  }
158
178
 
159
179
  #windowOptions(timeout: Duration): DeviceCommissioner.WindowOptions {
@@ -186,30 +206,33 @@ export class AdministratorCommissioningServer extends AdministratorCommissioning
186
206
  }
187
207
 
188
208
  /**
189
- * This method validates if a commissioning window can be opened and throws various exceptions in case of failures.
209
+ * Throws Busy while an administrator's window is open or the fail-safe is armed.
210
+ *
211
+ * @see {@link MatterSpecification.v161.Core} § 11.19.8.1
190
212
  */
191
- #assertCommissioningWindowRequirements(commissioningTimeout: Duration, commissioner: DeviceCommissioner) {
192
- if (commissioner.isAdministratorWindowOpen) {
193
- throw new AdministratorCommissioning.BusyError("A commissioning window is already opened");
213
+ #assertNoCommissioningInProgress(commissioner: DeviceCommissioner) {
214
+ if (commissioner.isFailsafeArmed) {
215
+ throw new AdministratorCommissioning.BusyError("Failsafe timer armed, assume commissioning in progress.");
194
216
  }
195
217
 
196
- if (commissioningTimeout > this.internal.maximumCommissioningTimeout) {
197
- throw new StatusResponseError(
198
- `Commissioning timeout must not exceed ${this.internal.maximumCommissioningTimeout} seconds.`,
199
- Status.InvalidCommand,
200
- );
218
+ if (commissioner.isAdministratorWindowOpen) {
219
+ throw new AdministratorCommissioning.BusyError("A commissioning window is already opened");
201
220
  }
221
+ }
202
222
 
203
- if (commissioningTimeout < this.internal.minimumCommissioningTimeout) {
223
+ /**
224
+ * The window duration of a CommissioningTimeout field in seconds, or INVALID_COMMAND outside the configured bounds.
225
+ */
226
+ #windowTimeout(commissioningTimeout: number) {
227
+ const timeout = Seconds(commissioningTimeout);
228
+ const { minimumCommissioningTimeout, maximumCommissioningTimeout } = this.internal;
229
+ if (timeout < minimumCommissioningTimeout || timeout > maximumCommissioningTimeout) {
204
230
  throw new StatusResponseError(
205
- `Commissioning timeout must not be lower then ${this.internal.minimumCommissioningTimeout} seconds.`,
231
+ `Commissioning timeout ${Duration.format(timeout)} is outside ${Duration.format(minimumCommissioningTimeout)} to ${Duration.format(maximumCommissioningTimeout)}`,
206
232
  Status.InvalidCommand,
207
233
  );
208
234
  }
209
-
210
- if (commissioner.isFailsafeArmed) {
211
- throw new AdministratorCommissioning.BusyError("Failsafe timer armed, assume commissioning in progress.");
212
- }
235
+ return timeout;
213
236
  }
214
237
 
215
238
  /**
@@ -24,6 +24,7 @@ import {
24
24
  MaybePromise,
25
25
  Millis,
26
26
  Minutes,
27
+ Network,
27
28
  Seconds,
28
29
  Time,
29
30
  Timer,
@@ -57,6 +58,32 @@ const schema = Base.schema.extend(
57
58
  FieldElement({ name: "totalOperationalHoursCounter", type: "uint64", quality: "N", conformance: "M" }),
58
59
  );
59
60
 
61
+ /**
62
+ * The node's System Time: time since the node came online, or zero while it is offline.
63
+ *
64
+ * UpTime and the SystemTimeMs of TimeSnapshot both read this, so they share one base.
65
+ *
66
+ * Takes whichever clock elapsed more so a suspend (wall clock advances, monotonic clock does not) is counted. A
67
+ * forward wall-clock step is folded in the same way, which can make the value run ahead of real elapsed time; accepted
68
+ * since it has no deadline consequences. The high-water mark then keeps a later backward step from lowering what was
69
+ * already reported.
70
+ *
71
+ * @see {@link MatterSpecification.v161.Core} § 11.12.6.3
72
+ */
73
+ function systemTime(internal: GeneralDiagnosticsServer.Internal): Duration {
74
+ const { onlineAtUs, onlineAtMs } = internal;
75
+ if (onlineAtUs === undefined || onlineAtMs === undefined) {
76
+ return 0;
77
+ }
78
+
79
+ const elapsed = Duration.max(
80
+ Duration.max(elapsedSince(onlineAtUs, Time.nowUs), elapsedSince(onlineAtMs, Time.nowMs)),
81
+ internal.systemTimeHighWaterMark,
82
+ );
83
+ internal.systemTimeHighWaterMark = elapsed;
84
+ return elapsed;
85
+ }
86
+
60
87
  /**
61
88
  * Time elapsed between {@link start} and {@link end}, floored at zero.
62
89
  *
@@ -67,6 +94,29 @@ function elapsedSince(start: Timestamp, end: Timestamp): Duration {
67
94
  return Duration.max(0, Timespan(start, end).duration);
68
95
  }
69
96
 
97
+ const ENABLE_KEY_LENGTH = 16;
98
+
99
+ function isAllZero(bytes: Bytes) {
100
+ return Bytes.of(bytes).every(byte => byte === 0);
101
+ }
102
+
103
+ /**
104
+ * Compares the whole key in constant time, so the response time does not reveal how many leading bytes matched. Keys
105
+ * of any length other than 16 bytes never match.
106
+ */
107
+ function enableKeysMatch(received: Bytes, configured: Bytes) {
108
+ const a = Bytes.of(received);
109
+ const b = Bytes.of(configured);
110
+ if (a.length !== ENABLE_KEY_LENGTH || b.length !== ENABLE_KEY_LENGTH) {
111
+ return false;
112
+ }
113
+ let difference = 0;
114
+ for (let i = 0; i < ENABLE_KEY_LENGTH; i++) {
115
+ difference |= a[i] ^ b[i];
116
+ }
117
+ return difference === 0;
118
+ }
119
+
70
120
  /**
71
121
  * This is the default server implementation of GeneralDiagnosticsBehavior.
72
122
  *
@@ -74,7 +124,9 @@ function elapsedSince(start: Timestamp, end: Timestamp): Duration {
74
124
  * handle test Event triggers.
75
125
  *
76
126
  * To handle test Event triggers please override the triggerTestEvent method. If these test events are used in
77
- * certification please also set the EnableKey in the enhanced state as `deviceTestEnableKey`.
127
+ * certification please also set the EnableKey in the enhanced state as `deviceTestEnableKey` before the behavior
128
+ * initializes. The testEventTriggersEnabled attribute follows from that key: it is true exactly when the key is not
129
+ * all zeros.
78
130
  *
79
131
  * To register or clear hardware, radio, and network faults, please use the provided convenience methods:
80
132
  * * registerHardwareFault and clearHardwareFault
@@ -89,13 +141,18 @@ export class GeneralDiagnosticsServer extends Base {
89
141
  static override readonly schema = schema;
90
142
 
91
143
  override initialize() {
92
- if (this.state.testEventTriggersEnabled === undefined) {
93
- this.state.testEventTriggersEnabled = false;
94
- } else if (this.state.testEventTriggersEnabled) {
95
- const enableKey = Bytes.of(this.state.deviceTestEnableKey);
96
- if (enableKey.every(byte => byte === 0)) {
97
- throw new ImplementationError("Test event triggers are enabled but no deviceTestEnableKey is set.");
98
- }
144
+ const { deviceTestEnableKey } = this.state;
145
+ const testEventTriggersEnabled = !isAllZero(deviceTestEnableKey);
146
+ if (this.state.testEventTriggersEnabled && !testEventTriggersEnabled) {
147
+ throw new ImplementationError("Test event triggers are enabled but no deviceTestEnableKey is set.");
148
+ }
149
+ if (testEventTriggersEnabled && deviceTestEnableKey.byteLength !== ENABLE_KEY_LENGTH) {
150
+ throw new ImplementationError(
151
+ `The deviceTestEnableKey must be ${ENABLE_KEY_LENGTH} bytes long, but it has ${deviceTestEnableKey.byteLength}.`,
152
+ );
153
+ }
154
+ this.state.testEventTriggersEnabled = testEventTriggersEnabled;
155
+ if (testEventTriggersEnabled) {
99
156
  logger.warn("Test event triggers are enabled. Make sure to disable them in production.");
100
157
  }
101
158
 
@@ -108,6 +165,10 @@ export class GeneralDiagnosticsServer extends Base {
108
165
  const lifecycle = this.endpoint.lifecycle as NodeLifecycle;
109
166
  this.reactTo(lifecycle.online, this.#online, { lock: true });
110
167
  this.reactTo(lifecycle.goingOffline, this.#goingOffline, { lock: true });
168
+ this.reactTo(this.env.get(Network).interfacesChanged, this.#interfacesChanged, {
169
+ lock: true,
170
+ offline: true,
171
+ });
111
172
 
112
173
  this.maybeReactTo(this.events.activeHardwareFaults$Changed, this.#triggerActiveHardwareFaultsChangedEvent);
113
174
 
@@ -142,21 +203,27 @@ export class GeneralDiagnosticsServer extends Base {
142
203
  }
143
204
  }
144
205
 
145
- #validateTestEnabledKey(enableKey: Bytes) {
146
- const keyData = Bytes.of(enableKey);
147
- if (keyData.every(byte => byte === 0)) {
206
+ /**
207
+ * The gate of both test commands, so the commands accept exactly when testEventTriggersEnabled reports true.
208
+ *
209
+ * @see {@link MatterSpecification.v161.Core} § 11.12.7.1.1, § 11.12.7.4
210
+ * @throws {@link StatusResponseError} with CONSTRAINT_ERROR if test event triggers are disabled, or the key is all
211
+ * zeros or does not match
212
+ */
213
+ #assertEnableKey(enableKey: Bytes) {
214
+ if (!this.state.testEventTriggersEnabled) {
215
+ throw new StatusResponseError("Test event triggers are disabled", Status.ConstraintError);
216
+ }
217
+ if (isAllZero(enableKey)) {
148
218
  throw new StatusResponseError("Invalid test enable key, all zeros", Status.ConstraintError);
149
219
  }
150
- const expectedKeyData = Bytes.of(this.state.deviceTestEnableKey);
151
- keyData.forEach((byte, index) => {
152
- if (byte !== expectedKeyData[index]) {
153
- throw new StatusResponseError("Invalid test enable key", Status.ConstraintError);
154
- }
155
- });
220
+ if (!enableKeysMatch(enableKey, this.state.deviceTestEnableKey)) {
221
+ throw new StatusResponseError("Invalid test enable key", Status.ConstraintError);
222
+ }
156
223
  }
157
224
 
158
225
  override testEventTrigger({ eventTrigger, enableKey }: GeneralDiagnostics.TestEventTriggerRequest): MaybePromise {
159
- this.#validateTestEnabledKey(enableKey);
226
+ this.#assertEnableKey(enableKey);
160
227
 
161
228
  this.triggerTestEvent(eventTrigger);
162
229
  }
@@ -178,7 +245,7 @@ export class GeneralDiagnosticsServer extends Base {
178
245
  : null;
179
246
 
180
247
  return {
181
- systemTimeMs: time - Time.startup.systemMs,
248
+ systemTimeMs: Math.floor(systemTime(this.internal)),
182
249
  posixTimeMs,
183
250
  };
184
251
  }
@@ -188,11 +255,7 @@ export class GeneralDiagnosticsServer extends Base {
188
255
  value,
189
256
  count,
190
257
  }: GeneralDiagnostics.PayloadTestRequest): MaybePromise<GeneralDiagnostics.PayloadTestResponse> {
191
- this.#validateTestEnabledKey(enableKey);
192
-
193
- if (!this.state.testEventTriggersEnabled) {
194
- throw new StatusResponseError("Test event triggers are disabled", Status.ConstraintError);
195
- }
258
+ this.#assertEnableKey(enableKey);
196
259
 
197
260
  const payload = new Uint8Array(count).fill(value);
198
261
 
@@ -236,21 +299,21 @@ export class GeneralDiagnosticsServer extends Base {
236
299
 
237
300
  /**
238
301
  * Register a hardware fault. This convenience method updates the activeHardwareFaults attribute and sends out the
239
- * HardwareFaultChanged event. Make sure to clear the fault when it is resolved.
302
+ * HardwareFaultChange event. Make sure to clear the fault when it is resolved.
240
303
  * This method requires that the activeHardwareFaults attribute is activated when the cluster gets initialized.
241
304
  *
242
305
  * @param faultType The hardware fault to register.
243
306
  */
244
307
  registerHardwareFault(faultType: GeneralDiagnostics.HardwareFault) {
245
308
  const currentFaults = this.requireAttributeEnabled("activeHardwareFaults");
246
- const list = currentFaults.filter(fault => fault !== faultType);
247
- list.push(faultType);
248
- this.state.activeHardwareFaults = list;
309
+ if (!currentFaults.includes(faultType)) {
310
+ this.state.activeHardwareFaults = [...currentFaults, faultType];
311
+ }
249
312
  }
250
313
 
251
314
  /**
252
315
  * Clear a hardware fault. This convenience method updates the activeHardwareFaults attribute and sends out the
253
- * HardwareFaultChanged event.
316
+ * HardwareFaultChange event.
254
317
  *
255
318
  * @param faultType The hardware fault to clear.
256
319
  */
@@ -274,21 +337,21 @@ export class GeneralDiagnosticsServer extends Base {
274
337
 
275
338
  /**
276
339
  * Register a radio fault. This convenience method updates the activeRadioFaults attribute and sends out the
277
- * RadioFaultChanged event. Make sure to clear the fault when it is resolved.
340
+ * RadioFaultChange event. Make sure to clear the fault when it is resolved.
278
341
  * This method requires that the activeRadioFaults attribute is activated when the cluster gets initialized.
279
342
  *
280
343
  * @param faultType The radio fault to register.
281
344
  */
282
345
  registerRadioFault(faultType: GeneralDiagnostics.RadioFault) {
283
346
  const currentFaults = this.requireAttributeEnabled("activeRadioFaults");
284
- const list = currentFaults.filter(fault => fault !== faultType);
285
- list.push(faultType);
286
- this.state.activeRadioFaults = list;
347
+ if (!currentFaults.includes(faultType)) {
348
+ this.state.activeRadioFaults = [...currentFaults, faultType];
349
+ }
287
350
  }
288
351
 
289
352
  /**
290
353
  * Clear a radio fault. This convenience method updates the activeRadioFaults attribute and sends out the
291
- * RadioFaultChanged event.
354
+ * RadioFaultChange event.
292
355
  *
293
356
  * @param faultType The radio fault to clear.
294
357
  */
@@ -312,21 +375,21 @@ export class GeneralDiagnosticsServer extends Base {
312
375
 
313
376
  /**
314
377
  * Register a network fault. This convenience method updates the activeNetworkFaults attribute and sends out the
315
- * NetworkFaultChanged event. Make sure to clear the fault when it is resolved.
378
+ * NetworkFaultChange event. Make sure to clear the fault when it is resolved.
316
379
  * This method requires that the activeNetworkFaults attribute is activated when the cluster gets initialized.
317
380
  *
318
381
  * @param faultType The network fault to register.
319
382
  */
320
383
  registerNetworkFault(faultType: GeneralDiagnostics.NetworkFault) {
321
384
  const currentFaults = this.requireAttributeEnabled("activeNetworkFaults");
322
- const list = currentFaults.filter(fault => fault !== faultType);
323
- list.push(faultType);
324
- this.state.activeNetworkFaults = list;
385
+ if (!currentFaults.includes(faultType)) {
386
+ this.state.activeNetworkFaults = [...currentFaults, faultType];
387
+ }
325
388
  }
326
389
 
327
390
  /**
328
391
  * Clear a network fault. This convenience method updates the activeNetworkFaults attribute and sends out the
329
- * NetworkFaultChanged event.
392
+ * NetworkFaultChange event.
330
393
  *
331
394
  * @param faultType The network fault to clear.
332
395
  */
@@ -361,7 +424,7 @@ export class GeneralDiagnosticsServer extends Base {
361
424
  this.internal.lastTotalOperationalHoursCounterUpdateTime = now;
362
425
  this.internal.onlineAtUs = now;
363
426
  this.internal.onlineAtMs = Time.nowMs;
364
- this.internal.upTimeHighWaterMark = 0;
427
+ this.internal.systemTimeHighWaterMark = 0;
365
428
 
366
429
  this.internal.lastTotalOperationalHoursTimer?.stop();
367
430
  this.internal.lastTotalOperationalHoursTimer = this.periodicReactorTimer(
@@ -381,6 +444,18 @@ export class GeneralDiagnosticsServer extends Base {
381
444
  this.internal.onlineAtMs = undefined;
382
445
  }
383
446
 
447
+ async #interfacesChanged() {
448
+ // The network runtime exists only between start and stop, and coming online reads the interfaces again
449
+ if (!this.env.has(NetworkRuntime)) {
450
+ return;
451
+ }
452
+ try {
453
+ await this.#updateNetworkList();
454
+ } catch (error) {
455
+ logger.warn("Cannot update the network interfaces after an interface change", error);
456
+ }
457
+ }
458
+
384
459
  #updateTotalOperationalHoursCounter() {
385
460
  const now = Time.nowUs;
386
461
  const elapsedTime = elapsedSince(this.internal.lastTotalOperationalHoursCounterUpdateTime, now);
@@ -463,7 +538,7 @@ export namespace GeneralDiagnosticsServer {
463
538
  lastTotalOperationalHoursTimer: Timer | undefined;
464
539
 
465
540
  /**
466
- * Time the node came online, on the monotonic clock ({@link Time.nowUs}); used for {@link upTime}.
541
+ * Time the node came online, on the monotonic clock ({@link Time.nowUs}); used for {@link systemTime}.
467
542
  *
468
543
  * Unlike {@link NodeLifecycle.onlineAt}, which is a wall-clock {@link Date}, this is unaffected by a clock
469
544
  * step where {@link Time.nowUs} is monotonic. Where it falls back to the wall clock, a step still moves
@@ -472,30 +547,34 @@ export namespace GeneralDiagnosticsServer {
472
547
  onlineAtUs: Timestamp | undefined;
473
548
 
474
549
  /**
475
- * Time the node came online, on the wall clock ({@link Time.nowMs}); used for {@link upTime}.
550
+ * Time the node came online, on the wall clock ({@link Time.nowMs}); used for {@link systemTime}.
476
551
  *
477
552
  * Where the monotonic clock does not advance while the host is suspended (Node on Linux, and several other
478
- * runtimes), {@link onlineAtUs} alone would stop counting upTime for the duration of a suspend. Comparing against this wall-clock timestamp folds suspend
479
- * time back in wherever the wall clock actually advanced past it.
553
+ * runtimes), {@link onlineAtUs} alone would stop counting upTime for the duration of a suspend. Comparing
554
+ * against this wall-clock timestamp folds suspend time back in wherever the wall clock actually advanced past
555
+ * it.
480
556
  */
481
557
  onlineAtMs: Timestamp | undefined;
482
558
 
483
559
  /**
484
- * Highest upTime computed since the node came online.
560
+ * Highest System Time computed since the node came online.
485
561
  *
486
562
  * A suspend makes {@link onlineAtMs}'s elapsed time jump ahead of {@link onlineAtUs}'s; a later backward
487
- * wall-clock step (an NTP correction) must not then make upTime, already reported at the higher value, go
488
- * down again.
563
+ * wall-clock step (an NTP correction) must not then make upTime or SystemTimeMs, already reported at the
564
+ * higher value, go down again.
489
565
  */
490
- upTimeHighWaterMark: Duration = 0;
566
+ systemTimeHighWaterMark: Duration = 0;
491
567
  }
492
568
 
493
569
  export class State extends Base.State {
494
570
  /** Internal counter of the total time, updated every 5 minutes. */
495
571
  totalOperationalHoursCounter: Duration = 0;
496
572
 
497
- /** The TestEnableKey set for this device for the test commands. Default means "not enabled"." */
498
- deviceTestEnableKey: Bytes = new Uint8Array(16).fill(0);
573
+ /**
574
+ * The 16-byte EnableKey of the test commands. The default of all zeros disables them. testEventTriggersEnabled
575
+ * is derived from this key when the behavior initializes, so a key set later leaves the commands disabled.
576
+ */
577
+ deviceTestEnableKey: Bytes = new Uint8Array(ENABLE_KEY_LENGTH);
499
578
 
500
579
  [Val.properties](endpoint: Endpoint, session: ValueSupervisor.Session) {
501
580
  // Invoked on the underlying state, so read our own values from here. Reading them via the endpoint would
@@ -516,23 +595,7 @@ export namespace GeneralDiagnosticsServer {
516
595
  * our boot time.
517
596
  */
518
597
  get upTime() {
519
- const internal = endpoint.behaviors.internalsOf(GeneralDiagnosticsServer);
520
- const { onlineAtUs, onlineAtMs } = internal;
521
- if (onlineAtUs === undefined || onlineAtMs === undefined) {
522
- return 0;
523
- }
524
-
525
- // Take whichever clock elapsed more so a suspend (wall clock advances, monotonic clock does
526
- // not) is counted. A forward wall-clock step is folded in the same way, which can make upTime
527
- // run ahead of real elapsed time; accepted since upTime has no deadline consequences. The
528
- // high-water mark then keeps a later backward step from lowering what was already reported.
529
- const elapsed = Duration.max(
530
- Duration.max(elapsedSince(onlineAtUs, Time.nowUs), elapsedSince(onlineAtMs, Time.nowMs)),
531
- internal.upTimeHighWaterMark,
532
- );
533
- internal.upTimeHighWaterMark = elapsed;
534
-
535
- return Seconds.of(elapsed);
598
+ return Seconds.of(systemTime(endpoint.behaviors.internalsOf(GeneralDiagnosticsServer)));
536
599
  },
537
600
 
538
601
  /**
@@ -584,7 +647,7 @@ export namespace GeneralDiagnosticsServer {
584
647
 
585
648
  let currentSubscriptions = 0;
586
649
  let currentSubscriptionsForFabric = 0;
587
- for (const sess of sessionManager.sessions) {
650
+ for (const sess of sessionManager.registeredSessions) {
588
651
  const count = sess.subscriptions.size;
589
652
  currentSubscriptions += count;
590
653
  if (sess.fabric?.fabricIndex === accessingFabric) {
@@ -611,21 +674,12 @@ export namespace GeneralDiagnosticsServer {
611
674
  }
612
675
 
613
676
  export declare const ExtensionInterface: {
614
- triggerTestEvent: (eventTrigger: number | bigint) => void;
615
- registerHardwareFault: (
616
- current: GeneralDiagnostics.HardwareFault[],
617
- previous: GeneralDiagnostics.HardwareFault[],
618
- ) => void;
619
- registerRadioFault: (
620
- current: GeneralDiagnostics.RadioFault[],
621
- previous: GeneralDiagnostics.RadioFault[],
622
- ) => void;
623
- registerNetworkFault: (
624
- current: GeneralDiagnostics.NetworkFault[],
625
- previous: GeneralDiagnostics.NetworkFault[],
626
- ) => void;
627
- clearHardwareFault: (faultType: GeneralDiagnostics.HardwareFault) => void;
628
- clearRadioFault: (faultType: GeneralDiagnostics.RadioFault) => void;
629
- clearNetworkFault: (faultType: GeneralDiagnostics.NetworkFault) => void;
677
+ triggerTestEvent(eventTrigger: number | bigint): void;
678
+ registerHardwareFault(faultType: GeneralDiagnostics.HardwareFault): void;
679
+ registerRadioFault(faultType: GeneralDiagnostics.RadioFault): void;
680
+ registerNetworkFault(faultType: GeneralDiagnostics.NetworkFault): void;
681
+ clearHardwareFault(faultType: GeneralDiagnostics.HardwareFault): void;
682
+ clearRadioFault(faultType: GeneralDiagnostics.RadioFault): void;
683
+ clearNetworkFault(faultType: GeneralDiagnostics.NetworkFault): void;
630
684
  };
631
685
  }
@@ -284,12 +284,7 @@ export class GroupKeyManagementServer extends GroupKeyManagementBase {
284
284
  fabricMaps.set(fabricIndex, fabricMap);
285
285
  }
286
286
  for (const fabric of fabrics) {
287
- const fabricIndex = fabric.fabricIndex;
288
- const map = fabricMaps.get(fabricIndex);
289
- if (map === undefined) {
290
- continue;
291
- }
292
- fabric.groups.groupKeyIdMap = map;
287
+ fabric.groups.groupKeyIdMap = fabricMaps.get(fabric.fabricIndex) ?? new Map<GroupId, number>();
293
288
  }
294
289
  }
295
290
 
@@ -462,7 +457,15 @@ export class GroupKeyManagementServer extends GroupKeyManagementBase {
462
457
  };
463
458
  }
464
459
 
465
- addEndpointForGroup(fabric: Fabric, groupId: GroupId, endpointId: EndpointNumber, groupName: string): void {
460
+ /**
461
+ * Add {@link endpointId} to the group table entry of {@link groupId}, creating the entry if needed.
462
+ *
463
+ * {@link groupName} is the last name written for the group via the Groups cluster; leave it out for a group that has
464
+ * none, such as one that Groupcast JoinGroup created.
465
+ *
466
+ * @see {@link MatterSpecification.v161.Core} § 11.2.5.5.3
467
+ */
468
+ addEndpointForGroup(fabric: Fabric, groupId: GroupId, endpointId: EndpointNumber, groupName?: string): void {
466
469
  const fabricIndex = fabric.fabricIndex;
467
470
  // Add the group to the group table
468
471
  const existingGroupIndex = this.state.groupTable.findIndex(
@@ -496,7 +499,8 @@ export class GroupKeyManagementServer extends GroupKeyManagementBase {
496
499
  fabric.groups.endpoints.set(groupId, [endpointId]);
497
500
  }
498
501
  logger.info(
499
- `Added endpoint ${endpointId} to group ${groupId} on fabric ${fabricIndex} with name "${groupName}"`,
502
+ `Added endpoint ${endpointId} to group ${groupId} on fabric ${fabricIndex}`,
503
+ ...(groupName === undefined ? [] : [`with name "${groupName}"`]),
500
504
  );
501
505
  }
502
506