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

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 (618) 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/context/server/LocalActorContext.d.ts +1 -1
  15. package/dist/cjs/behavior/context/server/LocalActorContext.d.ts.map +1 -1
  16. package/dist/cjs/behavior/internal/BehaviorBacking.d.ts +2 -2
  17. package/dist/cjs/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  18. package/dist/cjs/behavior/internal/BehaviorBacking.js +2 -0
  19. package/dist/cjs/behavior/internal/BehaviorBacking.js.map +1 -1
  20. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts +45 -0
  21. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  22. package/dist/cjs/behavior/internal/ClusterDerivation.js +192 -0
  23. package/dist/cjs/behavior/internal/ClusterDerivation.js.map +6 -0
  24. package/dist/cjs/behavior/internal/ClusterStatics.d.ts +16 -0
  25. package/dist/cjs/behavior/internal/ClusterStatics.d.ts.map +1 -0
  26. package/dist/cjs/behavior/internal/ClusterStatics.js +138 -0
  27. package/dist/cjs/behavior/internal/ClusterStatics.js.map +6 -0
  28. package/dist/cjs/behavior/internal/ModeledState.d.ts +18 -0
  29. package/dist/cjs/behavior/internal/ModeledState.d.ts.map +1 -0
  30. package/dist/cjs/behavior/internal/ModeledState.js +54 -0
  31. package/dist/cjs/behavior/internal/ModeledState.js.map +6 -0
  32. package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts +1 -1
  33. package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  34. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js +3 -12
  35. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  36. package/dist/cjs/behavior/state/managed/Datasource.d.ts +54 -10
  37. package/dist/cjs/behavior/state/managed/Datasource.d.ts.map +1 -1
  38. package/dist/cjs/behavior/state/managed/Datasource.js +107 -38
  39. package/dist/cjs/behavior/state/managed/Datasource.js.map +1 -1
  40. package/dist/cjs/behavior/state/managed/Internal.d.ts +20 -5
  41. package/dist/cjs/behavior/state/managed/Internal.d.ts.map +1 -1
  42. package/dist/cjs/behavior/state/managed/Internal.js +28 -26
  43. package/dist/cjs/behavior/state/managed/Internal.js.map +1 -1
  44. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts +56 -12
  45. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  46. package/dist/cjs/behavior/state/managed/ManagedReference.js +103 -43
  47. package/dist/cjs/behavior/state/managed/ManagedReference.js.map +1 -1
  48. package/dist/cjs/behavior/state/managed/NameResolver.js +1 -1
  49. package/dist/cjs/behavior/state/managed/NameResolver.js.map +1 -1
  50. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts +33 -0
  51. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  52. package/dist/cjs/behavior/state/{validation/peer-forwarding.js → managed/ReadOnlyReference.js} +36 -17
  53. package/dist/cjs/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  54. package/dist/cjs/behavior/state/managed/ValReference.d.ts +80 -13
  55. package/dist/cjs/behavior/state/managed/ValReference.d.ts.map +1 -1
  56. package/dist/cjs/behavior/state/managed/ValReference.js +32 -0
  57. package/dist/cjs/behavior/state/managed/ValReference.js.map +2 -2
  58. package/dist/cjs/behavior/state/managed/errors.d.ts +25 -0
  59. package/dist/cjs/behavior/state/managed/errors.d.ts.map +1 -0
  60. package/dist/cjs/behavior/state/{validation/FabricIndexSentinel.js → managed/errors.js} +15 -10
  61. package/dist/cjs/behavior/state/managed/errors.js.map +6 -0
  62. package/dist/cjs/behavior/state/managed/index.d.ts +1 -0
  63. package/dist/cjs/behavior/state/managed/index.d.ts.map +1 -1
  64. package/dist/cjs/behavior/state/managed/index.js +1 -0
  65. package/dist/cjs/behavior/state/managed/index.js.map +1 -1
  66. package/dist/cjs/behavior/state/managed/values/BitmapManager.js +5 -20
  67. package/dist/cjs/behavior/state/managed/values/BitmapManager.js.map +1 -1
  68. package/dist/cjs/behavior/state/managed/values/ListManager.d.ts +0 -5
  69. package/dist/cjs/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  70. package/dist/cjs/behavior/state/managed/values/ListManager.js +274 -133
  71. package/dist/cjs/behavior/state/managed/values/ListManager.js.map +2 -2
  72. package/dist/cjs/behavior/state/managed/values/StructManager.d.ts.map +1 -1
  73. package/dist/cjs/behavior/state/managed/values/StructManager.js +30 -35
  74. package/dist/cjs/behavior/state/managed/values/StructManager.js.map +2 -2
  75. package/dist/cjs/behavior/state/managed/values/ValuePatcher.d.ts +8 -0
  76. package/dist/cjs/behavior/state/managed/values/ValuePatcher.d.ts.map +1 -1
  77. package/dist/cjs/behavior/state/managed/values/ValuePatcher.js +13 -2
  78. package/dist/cjs/behavior/state/managed/values/ValuePatcher.js.map +1 -1
  79. package/dist/cjs/behavior/state/validation/FabricIndexField.d.ts +30 -0
  80. package/dist/cjs/behavior/state/validation/FabricIndexField.d.ts.map +1 -0
  81. package/dist/cjs/behavior/state/validation/FabricIndexField.js +53 -0
  82. package/dist/cjs/behavior/state/validation/FabricIndexField.js.map +6 -0
  83. package/dist/cjs/behavior/state/validation/ValueValidator.d.ts.map +1 -1
  84. package/dist/cjs/behavior/state/validation/ValueValidator.js +16 -36
  85. package/dist/cjs/behavior/state/validation/ValueValidator.js.map +1 -1
  86. package/dist/cjs/behavior/state/validation/conformance.d.ts.map +1 -1
  87. package/dist/cjs/behavior/state/validation/conformance.js +6 -5
  88. package/dist/cjs/behavior/state/validation/conformance.js.map +1 -1
  89. package/dist/cjs/behavior/state/validation/constraint.d.ts.map +1 -1
  90. package/dist/cjs/behavior/state/validation/constraint.js +3 -1
  91. package/dist/cjs/behavior/state/validation/constraint.js.map +1 -1
  92. package/dist/cjs/behavior/state/validation/location.d.ts +6 -0
  93. package/dist/cjs/behavior/state/validation/location.d.ts.map +1 -1
  94. package/dist/cjs/behavior/state/validation/remote-validation.d.ts +57 -0
  95. package/dist/cjs/behavior/state/validation/remote-validation.d.ts.map +1 -0
  96. package/dist/cjs/behavior/state/validation/remote-validation.js +63 -0
  97. package/dist/cjs/behavior/state/validation/remote-validation.js.map +6 -0
  98. package/dist/cjs/behavior/supervision/Supervision.d.ts.map +1 -1
  99. package/dist/cjs/behavior/supervision/Supervision.js +1 -1
  100. package/dist/cjs/behavior/supervision/Supervision.js.map +1 -1
  101. package/dist/cjs/behavior/supervision/SupervisionConfig.d.ts.map +1 -1
  102. package/dist/cjs/behavior/supervision/SupervisionConfig.js +1 -1
  103. package/dist/cjs/behavior/supervision/SupervisionConfig.js.map +1 -1
  104. package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts +3 -12
  105. package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
  106. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts +57 -6
  107. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  108. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js +86 -0
  109. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  110. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  111. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  112. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js +9 -0
  113. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  114. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  115. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  116. package/dist/cjs/behavior/system/controller/ControllerBehavior.js +2 -1
  117. package/dist/cjs/behavior/system/controller/ControllerBehavior.js.map +1 -1
  118. package/dist/cjs/behavior/system/dcl/DclBehavior.d.ts +3 -3
  119. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  120. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  121. package/dist/cjs/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  122. package/dist/cjs/behavior/system/remote/api/ApiResource.d.ts +14 -0
  123. package/dist/cjs/behavior/system/remote/api/ApiResource.d.ts.map +1 -1
  124. package/dist/cjs/behavior/system/remote/api/ApiResource.js +19 -0
  125. package/dist/cjs/behavior/system/remote/api/ApiResource.js.map +1 -1
  126. package/dist/cjs/behavior/system/remote/api/Envelope.d.ts +4 -2
  127. package/dist/cjs/behavior/system/remote/api/Envelope.d.ts.map +1 -1
  128. package/dist/cjs/behavior/system/remote/api/Envelope.js +7 -5
  129. package/dist/cjs/behavior/system/remote/api/Envelope.js.map +1 -1
  130. package/dist/cjs/behavior/system/remote/api/resources/CommandResource.js +2 -2
  131. package/dist/cjs/behavior/system/remote/api/resources/CommandResource.js.map +1 -1
  132. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.d.ts +1 -0
  133. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.d.ts.map +1 -1
  134. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.js +3 -0
  135. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.js.map +1 -1
  136. package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.d.ts.map +1 -1
  137. package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.js +5 -3
  138. package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.js.map +1 -1
  139. package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.d.ts.map +1 -1
  140. package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.js +2 -11
  141. package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.js.map +1 -1
  142. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  143. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  144. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js +6 -1
  145. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  146. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  147. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  148. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js +74 -0
  149. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  150. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  151. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  152. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  153. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  154. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts +2 -2
  155. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  156. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  157. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  158. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  159. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  160. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  161. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +104 -60
  162. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  163. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  164. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  165. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  166. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  167. package/dist/cjs/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  168. package/dist/cjs/behaviors/groupcast/GroupcastServer.js +41 -25
  169. package/dist/cjs/behaviors/groupcast/GroupcastServer.js.map +2 -2
  170. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  171. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  172. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.js +15 -4
  173. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.js.map +2 -2
  174. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  175. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  176. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js +27 -23
  177. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  178. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  179. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  180. package/dist/cjs/behaviors/thermostat/ThermostatServer.js +66 -49
  181. package/dist/cjs/behaviors/thermostat/ThermostatServer.js.map +1 -1
  182. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  183. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  184. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js +19 -5
  185. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +2 -2
  186. package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.d.ts.map +1 -1
  187. package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.js +13 -3
  188. package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.js.map +1 -1
  189. package/dist/cjs/endpoint/Endpoint.d.ts +5 -9
  190. package/dist/cjs/endpoint/Endpoint.d.ts.map +1 -1
  191. package/dist/cjs/endpoint/Endpoint.js +4 -23
  192. package/dist/cjs/endpoint/Endpoint.js.map +1 -1
  193. package/dist/cjs/endpoint/properties/Behaviors.d.ts.map +1 -1
  194. package/dist/cjs/endpoint/properties/Behaviors.js +5 -1
  195. package/dist/cjs/endpoint/properties/Behaviors.js.map +1 -1
  196. package/dist/cjs/node/ClientNode.d.ts +25 -0
  197. package/dist/cjs/node/ClientNode.d.ts.map +1 -1
  198. package/dist/cjs/node/ClientNode.js +41 -0
  199. package/dist/cjs/node/ClientNode.js.map +1 -1
  200. package/dist/cjs/node/ServerNode.d.ts.map +1 -1
  201. package/dist/cjs/node/ServerNode.js +2 -0
  202. package/dist/cjs/node/ServerNode.js.map +1 -1
  203. package/dist/cjs/node/client/ClientCommandMethod.d.ts.map +1 -1
  204. package/dist/cjs/node/client/ClientCommandMethod.js +3 -15
  205. package/dist/cjs/node/client/ClientCommandMethod.js.map +1 -1
  206. package/dist/cjs/node/client/ClientEventEmitter.d.ts.map +1 -1
  207. package/dist/cjs/node/client/ClientEventEmitter.js +6 -2
  208. package/dist/cjs/node/client/ClientEventEmitter.js.map +1 -1
  209. package/dist/cjs/node/client/ClientStructure.d.ts.map +1 -1
  210. package/dist/cjs/node/client/ClientStructure.js +181 -108
  211. package/dist/cjs/node/client/ClientStructure.js.map +2 -2
  212. package/dist/cjs/node/client/Peers.d.ts +18 -6
  213. package/dist/cjs/node/client/Peers.d.ts.map +1 -1
  214. package/dist/cjs/node/client/Peers.js +29 -13
  215. package/dist/cjs/node/client/Peers.js.map +1 -1
  216. package/dist/cjs/node/integration/ChangeNotificationService.d.ts +14 -3
  217. package/dist/cjs/node/integration/ChangeNotificationService.d.ts.map +1 -1
  218. package/dist/cjs/node/integration/ProtocolService.d.ts.map +1 -1
  219. package/dist/cjs/node/integration/ProtocolService.js +38 -56
  220. package/dist/cjs/node/integration/ProtocolService.js.map +1 -1
  221. package/dist/cjs/node/server/InteractionServer.d.ts.map +1 -1
  222. package/dist/cjs/node/server/InteractionServer.js +28 -24
  223. package/dist/cjs/node/server/InteractionServer.js.map +2 -2
  224. package/dist/cjs/node/server/ServerSubscription.d.ts +7 -2
  225. package/dist/cjs/node/server/ServerSubscription.d.ts.map +1 -1
  226. package/dist/cjs/node/server/ServerSubscription.js +83 -47
  227. package/dist/cjs/node/server/ServerSubscription.js.map +1 -1
  228. package/dist/cjs/storage/EndpointStore.d.ts +1 -1
  229. package/dist/cjs/storage/EndpointStore.js +1 -1
  230. package/dist/cjs/storage/client/ClientEndpointStore.d.ts +2 -2
  231. package/dist/cjs/storage/client/ClientEndpointStore.d.ts.map +1 -1
  232. package/dist/cjs/storage/client/ClientEndpointStore.js +1 -1
  233. package/dist/cjs/storage/client/DatasourceCache.d.ts +5 -3
  234. package/dist/cjs/storage/client/DatasourceCache.d.ts.map +1 -1
  235. package/dist/cjs/storage/client/DatasourceCache.js +68 -71
  236. package/dist/cjs/storage/client/DatasourceCache.js.map +1 -1
  237. package/dist/cjs/storage/client/FabricScopedListWrite.d.ts +73 -0
  238. package/dist/cjs/storage/client/FabricScopedListWrite.d.ts.map +1 -0
  239. package/dist/cjs/storage/client/FabricScopedListWrite.js +168 -0
  240. package/dist/cjs/storage/client/FabricScopedListWrite.js.map +6 -0
  241. package/dist/cjs/storage/client/RemoteWriteParticipant.d.ts +9 -6
  242. package/dist/cjs/storage/client/RemoteWriteParticipant.d.ts.map +1 -1
  243. package/dist/cjs/storage/client/RemoteWriteParticipant.js +11 -15
  244. package/dist/cjs/storage/client/RemoteWriteParticipant.js.map +1 -1
  245. package/dist/cjs/storage/client/RemoteWriter.d.ts +67 -7
  246. package/dist/cjs/storage/client/RemoteWriter.d.ts.map +1 -1
  247. package/dist/cjs/storage/client/RemoteWriter.js +61 -13
  248. package/dist/cjs/storage/client/RemoteWriter.js.map +1 -1
  249. package/dist/cjs/storage/server/DatasourceStore.d.ts +2 -2
  250. package/dist/cjs/storage/server/DatasourceStore.d.ts.map +1 -1
  251. package/dist/cjs/storage/server/DatasourceStore.js.map +1 -1
  252. package/dist/cjs/storage/server/ServerEndpointStore.d.ts +2 -2
  253. package/dist/cjs/storage/server/ServerEndpointStore.d.ts.map +1 -1
  254. package/dist/cjs/storage/server/ServerEndpointStore.js +1 -1
  255. package/dist/cjs/testing/mock-server-node.d.ts +2 -1
  256. package/dist/cjs/testing/mock-server-node.d.ts.map +1 -1
  257. package/dist/cjs/testing/mock-server-node.js +8 -5
  258. package/dist/cjs/testing/mock-server-node.js.map +2 -2
  259. package/dist/cjs/testing/node-helpers.d.ts +5 -0
  260. package/dist/cjs/testing/node-helpers.d.ts.map +1 -1
  261. package/dist/cjs/testing/node-helpers.js +4 -4
  262. package/dist/cjs/testing/node-helpers.js.map +1 -1
  263. package/dist/esm/behavior/Behavior.d.ts.map +1 -1
  264. package/dist/esm/behavior/Behavior.js +2 -0
  265. package/dist/esm/behavior/Behavior.js.map +1 -1
  266. package/dist/esm/behavior/Events.d.ts.map +1 -1
  267. package/dist/esm/behavior/Events.js +4 -2
  268. package/dist/esm/behavior/Events.js.map +1 -1
  269. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts +17 -3
  270. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
  271. package/dist/esm/behavior/cluster/ClusterBehavior.js +2 -20
  272. package/dist/esm/behavior/cluster/ClusterBehavior.js.map +1 -1
  273. package/dist/esm/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
  274. package/dist/esm/behavior/cluster/ClusterBehaviorType.js +10 -159
  275. package/dist/esm/behavior/cluster/ClusterBehaviorType.js.map +1 -1
  276. package/dist/esm/behavior/context/server/LocalActorContext.d.ts +1 -1
  277. package/dist/esm/behavior/context/server/LocalActorContext.d.ts.map +1 -1
  278. package/dist/esm/behavior/internal/BehaviorBacking.d.ts +2 -2
  279. package/dist/esm/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  280. package/dist/esm/behavior/internal/BehaviorBacking.js +2 -0
  281. package/dist/esm/behavior/internal/BehaviorBacking.js.map +1 -1
  282. package/dist/esm/behavior/internal/ClusterDerivation.d.ts +45 -0
  283. package/dist/esm/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  284. package/dist/esm/behavior/internal/ClusterDerivation.js +172 -0
  285. package/dist/esm/behavior/internal/ClusterDerivation.js.map +6 -0
  286. package/dist/esm/behavior/internal/ClusterStatics.d.ts +16 -0
  287. package/dist/esm/behavior/internal/ClusterStatics.d.ts.map +1 -0
  288. package/dist/esm/behavior/internal/ClusterStatics.js +118 -0
  289. package/dist/esm/behavior/internal/ClusterStatics.js.map +6 -0
  290. package/dist/esm/behavior/internal/ModeledState.d.ts +18 -0
  291. package/dist/esm/behavior/internal/ModeledState.d.ts.map +1 -0
  292. package/dist/esm/behavior/internal/ModeledState.js +34 -0
  293. package/dist/esm/behavior/internal/ModeledState.js.map +6 -0
  294. package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts +1 -1
  295. package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  296. package/dist/esm/behavior/internal/ServerBehaviorBacking.js +3 -12
  297. package/dist/esm/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  298. package/dist/esm/behavior/state/managed/Datasource.d.ts +54 -10
  299. package/dist/esm/behavior/state/managed/Datasource.d.ts.map +1 -1
  300. package/dist/esm/behavior/state/managed/Datasource.js +107 -38
  301. package/dist/esm/behavior/state/managed/Datasource.js.map +1 -1
  302. package/dist/esm/behavior/state/managed/Internal.d.ts +20 -5
  303. package/dist/esm/behavior/state/managed/Internal.d.ts.map +1 -1
  304. package/dist/esm/behavior/state/managed/Internal.js +28 -26
  305. package/dist/esm/behavior/state/managed/Internal.js.map +1 -1
  306. package/dist/esm/behavior/state/managed/ManagedReference.d.ts +56 -12
  307. package/dist/esm/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  308. package/dist/esm/behavior/state/managed/ManagedReference.js +103 -43
  309. package/dist/esm/behavior/state/managed/ManagedReference.js.map +1 -1
  310. package/dist/esm/behavior/state/managed/NameResolver.js +1 -1
  311. package/dist/esm/behavior/state/managed/NameResolver.js.map +1 -1
  312. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts +33 -0
  313. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  314. package/dist/esm/behavior/state/managed/ReadOnlyReference.js +45 -0
  315. package/dist/esm/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  316. package/dist/esm/behavior/state/managed/ValReference.d.ts +80 -13
  317. package/dist/esm/behavior/state/managed/ValReference.d.ts.map +1 -1
  318. package/dist/esm/behavior/state/managed/ValReference.js +28 -0
  319. package/dist/esm/behavior/state/managed/ValReference.js.map +2 -2
  320. package/dist/esm/behavior/state/managed/errors.d.ts +25 -0
  321. package/dist/esm/behavior/state/managed/errors.d.ts.map +1 -0
  322. package/dist/esm/behavior/state/managed/errors.js +20 -0
  323. package/dist/esm/behavior/state/managed/errors.js.map +6 -0
  324. package/dist/esm/behavior/state/managed/index.d.ts +1 -0
  325. package/dist/esm/behavior/state/managed/index.d.ts.map +1 -1
  326. package/dist/esm/behavior/state/managed/index.js +1 -0
  327. package/dist/esm/behavior/state/managed/index.js.map +1 -1
  328. package/dist/esm/behavior/state/managed/values/BitmapManager.js +6 -21
  329. package/dist/esm/behavior/state/managed/values/BitmapManager.js.map +1 -1
  330. package/dist/esm/behavior/state/managed/values/ListManager.d.ts +0 -5
  331. package/dist/esm/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  332. package/dist/esm/behavior/state/managed/values/ListManager.js +277 -144
  333. package/dist/esm/behavior/state/managed/values/ListManager.js.map +2 -2
  334. package/dist/esm/behavior/state/managed/values/StructManager.d.ts.map +1 -1
  335. package/dist/esm/behavior/state/managed/values/StructManager.js +31 -36
  336. package/dist/esm/behavior/state/managed/values/StructManager.js.map +2 -2
  337. package/dist/esm/behavior/state/managed/values/ValuePatcher.d.ts +8 -0
  338. package/dist/esm/behavior/state/managed/values/ValuePatcher.d.ts.map +1 -1
  339. package/dist/esm/behavior/state/managed/values/ValuePatcher.js +13 -2
  340. package/dist/esm/behavior/state/managed/values/ValuePatcher.js.map +1 -1
  341. package/dist/esm/behavior/state/validation/FabricIndexField.d.ts +30 -0
  342. package/dist/esm/behavior/state/validation/FabricIndexField.d.ts.map +1 -0
  343. package/dist/esm/behavior/state/validation/FabricIndexField.js +33 -0
  344. package/dist/esm/behavior/state/validation/FabricIndexField.js.map +6 -0
  345. package/dist/esm/behavior/state/validation/ValueValidator.d.ts.map +1 -1
  346. package/dist/esm/behavior/state/validation/ValueValidator.js +17 -37
  347. package/dist/esm/behavior/state/validation/ValueValidator.js.map +1 -1
  348. package/dist/esm/behavior/state/validation/conformance.d.ts.map +1 -1
  349. package/dist/esm/behavior/state/validation/conformance.js +6 -5
  350. package/dist/esm/behavior/state/validation/conformance.js.map +1 -1
  351. package/dist/esm/behavior/state/validation/constraint.d.ts.map +1 -1
  352. package/dist/esm/behavior/state/validation/constraint.js +3 -1
  353. package/dist/esm/behavior/state/validation/constraint.js.map +1 -1
  354. package/dist/esm/behavior/state/validation/location.d.ts +6 -0
  355. package/dist/esm/behavior/state/validation/location.d.ts.map +1 -1
  356. package/dist/esm/behavior/state/validation/remote-validation.d.ts +57 -0
  357. package/dist/esm/behavior/state/validation/remote-validation.d.ts.map +1 -0
  358. package/dist/esm/behavior/state/validation/remote-validation.js +48 -0
  359. package/dist/esm/behavior/state/validation/remote-validation.js.map +6 -0
  360. package/dist/esm/behavior/supervision/Supervision.d.ts.map +1 -1
  361. package/dist/esm/behavior/supervision/Supervision.js +1 -1
  362. package/dist/esm/behavior/supervision/Supervision.js.map +1 -1
  363. package/dist/esm/behavior/supervision/SupervisionConfig.d.ts.map +1 -1
  364. package/dist/esm/behavior/supervision/SupervisionConfig.js +1 -1
  365. package/dist/esm/behavior/supervision/SupervisionConfig.js.map +1 -1
  366. package/dist/esm/behavior/supervision/ValueSupervisor.d.ts +3 -12
  367. package/dist/esm/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
  368. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts +57 -6
  369. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  370. package/dist/esm/behavior/system/commissioning/CommissioningClient.js +87 -0
  371. package/dist/esm/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  372. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  373. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  374. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js +10 -1
  375. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  376. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  377. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  378. package/dist/esm/behavior/system/controller/ControllerBehavior.js +2 -1
  379. package/dist/esm/behavior/system/controller/ControllerBehavior.js.map +1 -1
  380. package/dist/esm/behavior/system/dcl/DclBehavior.d.ts +3 -3
  381. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  382. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  383. package/dist/esm/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  384. package/dist/esm/behavior/system/remote/api/ApiResource.d.ts +14 -0
  385. package/dist/esm/behavior/system/remote/api/ApiResource.d.ts.map +1 -1
  386. package/dist/esm/behavior/system/remote/api/ApiResource.js +19 -0
  387. package/dist/esm/behavior/system/remote/api/ApiResource.js.map +1 -1
  388. package/dist/esm/behavior/system/remote/api/Envelope.d.ts +4 -2
  389. package/dist/esm/behavior/system/remote/api/Envelope.d.ts.map +1 -1
  390. package/dist/esm/behavior/system/remote/api/Envelope.js +7 -5
  391. package/dist/esm/behavior/system/remote/api/Envelope.js.map +1 -1
  392. package/dist/esm/behavior/system/remote/api/resources/CommandResource.js +2 -2
  393. package/dist/esm/behavior/system/remote/api/resources/CommandResource.js.map +1 -1
  394. package/dist/esm/behavior/system/remote/api/resources/NodeResource.d.ts +1 -0
  395. package/dist/esm/behavior/system/remote/api/resources/NodeResource.d.ts.map +1 -1
  396. package/dist/esm/behavior/system/remote/api/resources/NodeResource.js +3 -0
  397. package/dist/esm/behavior/system/remote/api/resources/NodeResource.js.map +1 -1
  398. package/dist/esm/behavior/system/remote/api/resources/PropertyResource.d.ts.map +1 -1
  399. package/dist/esm/behavior/system/remote/api/resources/PropertyResource.js +5 -3
  400. package/dist/esm/behavior/system/remote/api/resources/PropertyResource.js.map +1 -1
  401. package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.d.ts.map +1 -1
  402. package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.js +2 -11
  403. package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.js.map +1 -1
  404. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  405. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  406. package/dist/esm/behavior/system/sessions/SessionsBehavior.js +6 -1
  407. package/dist/esm/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  408. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  409. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  410. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js +54 -0
  411. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  412. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  413. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  414. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  415. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  416. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts +2 -2
  417. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  418. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  419. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  420. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  421. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  422. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  423. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +105 -60
  424. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  425. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  426. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  427. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  428. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  429. package/dist/esm/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  430. package/dist/esm/behaviors/groupcast/GroupcastServer.js +42 -25
  431. package/dist/esm/behaviors/groupcast/GroupcastServer.js.map +2 -2
  432. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  433. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  434. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.js +15 -4
  435. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.js.map +2 -2
  436. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  437. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  438. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js +32 -24
  439. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  440. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  441. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  442. package/dist/esm/behaviors/thermostat/ThermostatServer.js +66 -49
  443. package/dist/esm/behaviors/thermostat/ThermostatServer.js.map +1 -1
  444. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  445. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  446. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js +19 -5
  447. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +2 -2
  448. package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.d.ts.map +1 -1
  449. package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.js +13 -3
  450. package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.js.map +1 -1
  451. package/dist/esm/endpoint/Endpoint.d.ts +5 -9
  452. package/dist/esm/endpoint/Endpoint.d.ts.map +1 -1
  453. package/dist/esm/endpoint/Endpoint.js +5 -24
  454. package/dist/esm/endpoint/Endpoint.js.map +1 -1
  455. package/dist/esm/endpoint/properties/Behaviors.d.ts.map +1 -1
  456. package/dist/esm/endpoint/properties/Behaviors.js +6 -2
  457. package/dist/esm/endpoint/properties/Behaviors.js.map +1 -1
  458. package/dist/esm/node/ClientNode.d.ts +25 -0
  459. package/dist/esm/node/ClientNode.d.ts.map +1 -1
  460. package/dist/esm/node/ClientNode.js +41 -0
  461. package/dist/esm/node/ClientNode.js.map +1 -1
  462. package/dist/esm/node/ServerNode.d.ts.map +1 -1
  463. package/dist/esm/node/ServerNode.js +2 -0
  464. package/dist/esm/node/ServerNode.js.map +1 -1
  465. package/dist/esm/node/client/ClientCommandMethod.d.ts.map +1 -1
  466. package/dist/esm/node/client/ClientCommandMethod.js +4 -16
  467. package/dist/esm/node/client/ClientCommandMethod.js.map +1 -1
  468. package/dist/esm/node/client/ClientEventEmitter.d.ts.map +1 -1
  469. package/dist/esm/node/client/ClientEventEmitter.js +6 -2
  470. package/dist/esm/node/client/ClientEventEmitter.js.map +1 -1
  471. package/dist/esm/node/client/ClientStructure.d.ts.map +1 -1
  472. package/dist/esm/node/client/ClientStructure.js +181 -108
  473. package/dist/esm/node/client/ClientStructure.js.map +2 -2
  474. package/dist/esm/node/client/Peers.d.ts +18 -6
  475. package/dist/esm/node/client/Peers.d.ts.map +1 -1
  476. package/dist/esm/node/client/Peers.js +29 -14
  477. package/dist/esm/node/client/Peers.js.map +1 -1
  478. package/dist/esm/node/integration/ChangeNotificationService.d.ts +14 -3
  479. package/dist/esm/node/integration/ChangeNotificationService.d.ts.map +1 -1
  480. package/dist/esm/node/integration/ProtocolService.d.ts.map +1 -1
  481. package/dist/esm/node/integration/ProtocolService.js +40 -57
  482. package/dist/esm/node/integration/ProtocolService.js.map +1 -1
  483. package/dist/esm/node/server/InteractionServer.d.ts.map +1 -1
  484. package/dist/esm/node/server/InteractionServer.js +28 -25
  485. package/dist/esm/node/server/InteractionServer.js.map +2 -2
  486. package/dist/esm/node/server/ServerSubscription.d.ts +7 -2
  487. package/dist/esm/node/server/ServerSubscription.d.ts.map +1 -1
  488. package/dist/esm/node/server/ServerSubscription.js +83 -47
  489. package/dist/esm/node/server/ServerSubscription.js.map +1 -1
  490. package/dist/esm/storage/EndpointStore.d.ts +1 -1
  491. package/dist/esm/storage/EndpointStore.js +1 -1
  492. package/dist/esm/storage/client/ClientEndpointStore.d.ts +2 -2
  493. package/dist/esm/storage/client/ClientEndpointStore.d.ts.map +1 -1
  494. package/dist/esm/storage/client/ClientEndpointStore.js +1 -1
  495. package/dist/esm/storage/client/DatasourceCache.d.ts +5 -3
  496. package/dist/esm/storage/client/DatasourceCache.d.ts.map +1 -1
  497. package/dist/esm/storage/client/DatasourceCache.js +68 -71
  498. package/dist/esm/storage/client/DatasourceCache.js.map +1 -1
  499. package/dist/esm/storage/client/FabricScopedListWrite.d.ts +73 -0
  500. package/dist/esm/storage/client/FabricScopedListWrite.d.ts.map +1 -0
  501. package/dist/esm/storage/client/FabricScopedListWrite.js +148 -0
  502. package/dist/esm/storage/client/FabricScopedListWrite.js.map +6 -0
  503. package/dist/esm/storage/client/RemoteWriteParticipant.d.ts +9 -6
  504. package/dist/esm/storage/client/RemoteWriteParticipant.d.ts.map +1 -1
  505. package/dist/esm/storage/client/RemoteWriteParticipant.js +11 -15
  506. package/dist/esm/storage/client/RemoteWriteParticipant.js.map +1 -1
  507. package/dist/esm/storage/client/RemoteWriter.d.ts +67 -7
  508. package/dist/esm/storage/client/RemoteWriter.d.ts.map +1 -1
  509. package/dist/esm/storage/client/RemoteWriter.js +65 -14
  510. package/dist/esm/storage/client/RemoteWriter.js.map +1 -1
  511. package/dist/esm/storage/server/DatasourceStore.d.ts +2 -2
  512. package/dist/esm/storage/server/DatasourceStore.d.ts.map +1 -1
  513. package/dist/esm/storage/server/DatasourceStore.js.map +1 -1
  514. package/dist/esm/storage/server/ServerEndpointStore.d.ts +2 -2
  515. package/dist/esm/storage/server/ServerEndpointStore.d.ts.map +1 -1
  516. package/dist/esm/storage/server/ServerEndpointStore.js +1 -1
  517. package/dist/esm/testing/mock-server-node.d.ts +2 -1
  518. package/dist/esm/testing/mock-server-node.d.ts.map +1 -1
  519. package/dist/esm/testing/mock-server-node.js +16 -7
  520. package/dist/esm/testing/mock-server-node.js.map +2 -2
  521. package/dist/esm/testing/node-helpers.d.ts +5 -0
  522. package/dist/esm/testing/node-helpers.d.ts.map +1 -1
  523. package/dist/esm/testing/node-helpers.js +4 -4
  524. package/dist/esm/testing/node-helpers.js.map +1 -1
  525. package/package.json +6 -6
  526. package/src/behavior/Behavior.ts +2 -0
  527. package/src/behavior/Events.ts +6 -3
  528. package/src/behavior/cluster/ClusterBehavior.ts +22 -13
  529. package/src/behavior/cluster/ClusterBehaviorType.ts +9 -270
  530. package/src/behavior/context/server/LocalActorContext.ts +1 -4
  531. package/src/behavior/internal/BehaviorBacking.ts +10 -2
  532. package/src/behavior/internal/ClusterDerivation.ts +295 -0
  533. package/src/behavior/internal/ClusterStatics.ts +180 -0
  534. package/src/behavior/internal/ModeledState.ts +58 -0
  535. package/src/behavior/internal/ServerBehaviorBacking.ts +9 -16
  536. package/src/behavior/state/managed/Datasource.ts +181 -58
  537. package/src/behavior/state/managed/Internal.ts +44 -34
  538. package/src/behavior/state/managed/ManagedReference.ts +159 -70
  539. package/src/behavior/state/managed/NameResolver.ts +1 -1
  540. package/src/behavior/state/managed/ReadOnlyReference.ts +61 -0
  541. package/src/behavior/state/managed/ValReference.ts +104 -14
  542. package/src/behavior/state/managed/errors.ts +33 -0
  543. package/src/behavior/state/managed/index.ts +1 -0
  544. package/src/behavior/state/managed/values/BitmapManager.ts +6 -22
  545. package/src/behavior/state/managed/values/ListManager.ts +313 -164
  546. package/src/behavior/state/managed/values/StructManager.ts +48 -52
  547. package/src/behavior/state/managed/values/ValuePatcher.ts +25 -3
  548. package/src/behavior/state/validation/FabricIndexField.ts +51 -0
  549. package/src/behavior/state/validation/ValueValidator.ts +24 -54
  550. package/src/behavior/state/validation/conformance.ts +9 -7
  551. package/src/behavior/state/validation/constraint.ts +5 -1
  552. package/src/behavior/state/validation/location.ts +8 -0
  553. package/src/behavior/state/validation/remote-validation.ts +107 -0
  554. package/src/behavior/supervision/Supervision.ts +1 -2
  555. package/src/behavior/supervision/SupervisionConfig.ts +1 -2
  556. package/src/behavior/supervision/ValueSupervisor.ts +3 -13
  557. package/src/behavior/system/commissioning/CommissioningClient.ts +122 -6
  558. package/src/behavior/system/commissioning/RemoteDescriptor.ts +17 -1
  559. package/src/behavior/system/controller/ControllerBehavior.ts +2 -1
  560. package/src/behavior/system/dcl/DclBehavior.ts +3 -3
  561. package/src/behavior/system/network/ServerGroupNetworking.ts +3 -2
  562. package/src/behavior/system/remote/api/ApiResource.ts +23 -0
  563. package/src/behavior/system/remote/api/Envelope.ts +8 -6
  564. package/src/behavior/system/remote/api/resources/CommandResource.ts +2 -2
  565. package/src/behavior/system/remote/api/resources/NodeResource.ts +4 -0
  566. package/src/behavior/system/remote/api/resources/PropertyResource.ts +5 -3
  567. package/src/behavior/system/remote/api/resources/ServerNodeResource.ts +2 -13
  568. package/src/behavior/system/sessions/SessionsBehavior.ts +8 -2
  569. package/src/behavior/system/subscriptions/SubscriptionStore.ts +66 -0
  570. package/src/behavior/system/subscriptions/SubscriptionsServer.ts +73 -33
  571. package/src/behaviors/access-control/AccessControlServer.ts +3 -3
  572. package/src/behaviors/administrator-commissioning/AdministratorCommissioningServer.ts +47 -24
  573. package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts +138 -84
  574. package/src/behaviors/group-key-management/GroupKeyManagementServer.ts +12 -8
  575. package/src/behaviors/groupcast/GroupcastServer.ts +50 -34
  576. package/src/behaviors/localization-configuration/LocalizationConfigurationServer.ts +18 -6
  577. package/src/behaviors/operational-credentials/VendorIdVerification.ts +50 -35
  578. package/src/behaviors/thermostat/ThermostatServer.ts +93 -70
  579. package/src/behaviors/time-format-localization/TimeFormatLocalizationServer.ts +24 -9
  580. package/src/behaviors/unit-localization/UnitLocalizationServer.ts +17 -4
  581. package/src/endpoint/Endpoint.ts +5 -31
  582. package/src/endpoint/properties/Behaviors.ts +6 -2
  583. package/src/node/ClientNode.ts +41 -0
  584. package/src/node/ServerNode.ts +2 -0
  585. package/src/node/client/ClientCommandMethod.ts +4 -19
  586. package/src/node/client/ClientEventEmitter.ts +7 -3
  587. package/src/node/client/ClientStructure.ts +208 -135
  588. package/src/node/client/Peers.ts +36 -20
  589. package/src/node/integration/ChangeNotificationService.ts +18 -3
  590. package/src/node/integration/ProtocolService.ts +45 -57
  591. package/src/node/server/InteractionServer.ts +33 -35
  592. package/src/node/server/ServerSubscription.ts +88 -50
  593. package/src/storage/EndpointStore.ts +1 -1
  594. package/src/storage/client/ClientEndpointStore.ts +1 -1
  595. package/src/storage/client/DatasourceCache.ts +86 -79
  596. package/src/storage/client/FabricScopedListWrite.ts +245 -0
  597. package/src/storage/client/RemoteWriteParticipant.ts +20 -23
  598. package/src/storage/client/RemoteWriter.ts +156 -26
  599. package/src/storage/server/DatasourceStore.ts +2 -2
  600. package/src/storage/server/ServerEndpointStore.ts +1 -1
  601. package/src/testing/mock-server-node.ts +22 -9
  602. package/src/testing/node-helpers.ts +5 -1
  603. package/dist/cjs/behavior/state/validation/FabricIndexSentinel.d.ts +0 -14
  604. package/dist/cjs/behavior/state/validation/FabricIndexSentinel.d.ts.map +0 -1
  605. package/dist/cjs/behavior/state/validation/FabricIndexSentinel.js.map +0 -6
  606. package/dist/cjs/behavior/state/validation/peer-forwarding.d.ts +0 -20
  607. package/dist/cjs/behavior/state/validation/peer-forwarding.d.ts.map +0 -1
  608. package/dist/cjs/behavior/state/validation/peer-forwarding.js.map +0 -6
  609. package/dist/esm/behavior/state/validation/FabricIndexSentinel.d.ts +0 -14
  610. package/dist/esm/behavior/state/validation/FabricIndexSentinel.d.ts.map +0 -1
  611. package/dist/esm/behavior/state/validation/FabricIndexSentinel.js +0 -15
  612. package/dist/esm/behavior/state/validation/FabricIndexSentinel.js.map +0 -6
  613. package/dist/esm/behavior/state/validation/peer-forwarding.d.ts +0 -20
  614. package/dist/esm/behavior/state/validation/peer-forwarding.d.ts.map +0 -1
  615. package/dist/esm/behavior/state/validation/peer-forwarding.js +0 -26
  616. package/dist/esm/behavior/state/validation/peer-forwarding.js.map +0 -6
  617. package/src/behavior/state/validation/FabricIndexSentinel.ts +0 -20
  618. package/src/behavior/state/validation/peer-forwarding.ts +0 -47
@@ -12,6 +12,7 @@ import { ServerNetworkRuntime } from "#behavior/system/network/ServerNetworkRunt
12
12
  import { ProductDescriptionServer } from "#behavior/system/product-description/ProductDescriptionServer.js";
13
13
  import { SessionsBehavior } from "#behavior/system/sessions/SessionsBehavior.js";
14
14
  import { SubscriptionsServer } from "#behavior/system/subscriptions/SubscriptionsServer.js";
15
+ import { SubscriptionStore } from "#behavior/system/subscriptions/SubscriptionStore.js";
15
16
  import { Endpoint } from "#endpoint/Endpoint.js";
16
17
  import { EndpointInitializer } from "#endpoint/properties/EndpointInitializer.js";
17
18
  import { ServerNodeStore } from "#storage/server/ServerNodeStore.js";
@@ -248,6 +249,7 @@ export class ServerNode<T extends ServerNode.RootEndpoint = ServerNode.RootEndpo
248
249
  () => this.env.get(SessionManager).clear(),
249
250
  () => this.env.get(FabricManager).clear(),
250
251
  () => this.env.get(OccurrenceManager).clear(),
252
+ () => this.env.get(SubscriptionStore).clear(),
251
253
  () => ServerEnvironment.eraseCredentials(this),
252
254
  () => this.env.get(ServerNodeStore).erase(),
253
255
  ],
@@ -10,8 +10,7 @@ import type { Endpoint } from "#endpoint/Endpoint.js";
10
10
  import type { ClientNode } from "#node/ClientNode.js";
11
11
  import { Node } from "#node/Node.js";
12
12
  import type { CommandModel } from "@matter/model";
13
- import { ClientInteraction, Invoke, ResultStatus } from "@matter/protocol";
14
- import { Status } from "@matter/types";
13
+ import { ClientInteraction, Invoke, InvokeResult } from "@matter/protocol";
15
14
 
16
15
  /**
17
16
  * Create the command method for a client behavior.
@@ -45,23 +44,9 @@ export function ClientCommandMethod(name: string, commandModel?: CommandModel) {
45
44
  invoke.largeMessage = true;
46
45
  }
47
46
 
48
- const chunks = (node.interaction as ClientInteraction).invoke(invoke, context ?? this.context);
49
-
50
- for await (const chunk of chunks) {
51
- for (const entry of chunk) {
52
- // We send only one command, so we only get one response back
53
- switch (entry.kind) {
54
- case "cmd-status":
55
- if (entry.status !== Status.Success) {
56
- throw ResultStatus.errorOf(entry);
57
- }
58
- return;
59
-
60
- case "cmd-response":
61
- return entry.data;
62
- }
63
- }
64
- }
47
+ return InvokeResult.responseOfSingleCommand(
48
+ (node.interaction as ClientInteraction).invoke(invoke, context ?? this.context),
49
+ );
65
50
  },
66
51
  };
67
52
 
@@ -61,12 +61,13 @@ export function ClientEventEmitter(node: ClientNode, structure: ClientStructure)
61
61
 
62
62
  const behavior = target.endpoint.behaviors.supported[names.cluster];
63
63
  if (behavior) {
64
- const { number, timestamp, priority, value } = occurrence;
64
+ const { number, timestamp, resolvedTimestamp, priority, value } = occurrence;
65
65
  const timestampKind = timestampKindOf(occurrence);
66
66
  changes.broadcastEvent(target.endpoint, behavior, target.event.schema as EventModel, {
67
67
  number,
68
68
  timestamp: timestamp as Timestamp,
69
69
  timestampKind,
70
+ resolvedTimestamp,
70
71
  priority,
71
72
  payload: value as Val.Struct | undefined,
72
73
  });
@@ -107,11 +108,14 @@ export function ClientEventEmitter(node: ClientNode, structure: ClientStructure)
107
108
  }
108
109
 
109
110
  /**
110
- * Identify which of the four timestamp variants Matter Core §10.7 defines the peer sent. Absent all of them the
111
+ * Identify which of the four timestamp variants Matter Core §10.6.9 defines the peer sent. Absent all of them the
111
112
  * occurrence carries {@link ReadResult.EventValue.timestamp} 0, which is a Posix epoch of no useful precision.
112
113
  */
113
114
  function timestampKindOf(occurrence: ReadResult.EventValue): ChangeNotificationService.TimestampKind {
114
- const { systemTimestamp, deltaEpochTimestamp, deltaSystemTimestamp } = occurrence;
115
+ const { epochTimestamp, systemTimestamp, deltaEpochTimestamp, deltaSystemTimestamp } = occurrence;
116
+ if (epochTimestamp !== undefined) {
117
+ return "epoch";
118
+ }
115
119
  if (systemTimestamp !== undefined) {
116
120
  return "system";
117
121
  }
@@ -134,24 +134,36 @@ export class ClientStructure {
134
134
  #attributeIds = new Map<ClusterId, Map<string, number>>();
135
135
 
136
136
  /**
137
- * Which endpoints have named each part in a `PartsList`, and what each of those lists contained.
137
+ * The parts each endpoint's current `PartsList` names.
138
138
  *
139
139
  * Parenthood cannot be decided from a single list, because a device type composing its list of
140
140
  * every descendant ({@link EndpointComposition.FullFamily}) says nothing about which endpoint owns
141
- * a part. A claim stays here until it can be decided; nothing is ever reparented, so an
142
- * undecidable claim waits for the read that settles it rather than being guessed at.
141
+ * a part. {@link #placeParts} reads all lists together; nothing is ever reparented, so a part
142
+ * whose owner cannot be told yet waits for the read that settles it rather than being guessed at.
143
143
  */
144
- #partClaims = new Map<EndpointStructure, Set<EndpointStructure>>();
145
144
  #partsListOf = new Map<EndpointStructure, Set<EndpointNumber>>();
146
145
 
147
146
  /**
148
- * How each endpoint composes its `PartsList`, for the endpoints that have said.
147
+ * The endpoints on the node as of the last structural apply, or `undefined` while the root has not reported its
148
+ * `PartsList`; see {@link #findEndpointsOnTheNode}.
149
+ */
150
+ #endpointsOnTheNode?: Set<EndpointNumber>;
151
+
152
+ /** Endpoints that left the node but stay placed, because they hold endpoints on the node. */
153
+ #keptOffTheNode = new Set<EndpointNumber>();
154
+
155
+ #warnedIncompleteRootPartsList = false;
156
+
157
+ /**
158
+ * How each endpoint composes its `PartsList`, for the endpoints that have said. Read it through
159
+ * {@link #compositionOf}, which does not use the root's entry.
149
160
  *
150
161
  * Absent means the endpoint has not reported its device types yet, which is not the same as
151
162
  * composing a tree: a list from an endpoint whose composition is unknown says nothing about who
152
- * owns what, so claims from it wait rather than being read as a parent's.
163
+ * owns what, so it is not weighed in deciding a part's owner yet.
153
164
  */
154
165
  #composition = new Map<EndpointStructure, EndpointComposition>();
166
+ #warnedRootWithoutDeviceType = false;
155
167
  #events: ClientStructureEvents;
156
168
  #changed = Observable<[void]>();
157
169
  #applying = 0;
@@ -241,7 +253,9 @@ export class ClientStructure {
241
253
  }
242
254
  }
243
255
 
244
- this.#resolvePartClaims();
256
+ this.#endpointsOnTheNode = this.#findEndpointsOnTheNode();
257
+ this.#checkRootPartsList();
258
+ this.#placeParts();
245
259
 
246
260
  const changes = this.#pendingChanges;
247
261
  this.#pendingChanges = new Map();
@@ -996,6 +1010,10 @@ export class ClientStructure {
996
1010
  | undefined;
997
1011
  if (Array.isArray(deviceTypeList)) {
998
1012
  this.#noteComposition(structure, deviceTypeList);
1013
+ // The behavior's state holds an empty list until the peer reports one
1014
+ if (!endpoint.number && structure.reportedLists?.has(DEVICE_TYPE_LIST_ATTR_ID)) {
1015
+ this.#checkRootDeviceTypes(deviceTypeList);
1016
+ }
999
1017
 
1000
1018
  const endpointType = endpoint.type;
1001
1019
  for (const dt of deviceTypeList) {
@@ -1080,68 +1098,21 @@ export class ClientStructure {
1080
1098
  return;
1081
1099
  }
1082
1100
 
1083
- // Which claimant owns a part is decided by #resolvePartClaims, once every list this
1084
- // interaction carries is in.
1101
+ // Which endpoint owns a part is decided by #placeParts, once every list this interaction
1102
+ // carries is in.
1085
1103
  const named = new Set<EndpointNumber>();
1086
1104
  for (const value of partsList) {
1087
1105
  // The peer's own value, so it is checked rather than trusted; one out of range names no
1088
- // endpoint this could hold
1089
- if (typeof value !== "number" || !EndpointNumber.isValid(value)) {
1106
+ // endpoint this could hold, and the root is no endpoint's part (Matter Core § 9.2.8)
1107
+ if (typeof value !== "number" || !EndpointNumber.isValid(value) || value === ROOT_ENDPOINT_NUMBER) {
1090
1108
  continue;
1091
1109
  }
1092
1110
 
1093
1111
  const partNo = EndpointNumber(value);
1094
1112
  named.add(partNo);
1095
-
1096
- const part = this.#endpointFor(partNo);
1097
- let claimants = this.#partClaims.get(part);
1098
- if (claimants === undefined) {
1099
- claimants = new Set();
1100
- this.#partClaims.set(part, claimants);
1101
- }
1102
- claimants.add(structure);
1113
+ this.#endpointFor(partNo);
1103
1114
  }
1104
- this.#retractClaimsOf(structure, named);
1105
1115
  this.#partsListOf.set(structure, named);
1106
-
1107
- // For the root partsList specifically, if an endpoint is no longer present then it has been removed from the
1108
- // node. Schedule for erase
1109
- if (endpoint.maybeNumber === 0) {
1110
- const numbersUsed = new Set(partsList);
1111
- for (const descendent of (endpoint as Node).endpoints) {
1112
- // Skip root endpoint and uninitialized numbers (though latter shouldn't be possible)
1113
- if (!descendent.maybeNumber) {
1114
- continue;
1115
- }
1116
-
1117
- if (!numbersUsed.has(descendent.number)) {
1118
- const endpoint = this.#endpoints.get(descendent.number);
1119
- if (endpoint === undefined) {
1120
- continue;
1121
- }
1122
-
1123
- // Erasing an endpoint closes everything below it, and nothing can move what it
1124
- // held elsewhere first. A peer that drops an endpoint while still naming what
1125
- // hangs from it contradicts itself, and the endpoints it still names are worth
1126
- // more than a tree that matches its list exactly.
1127
- const named = new Array<Endpoint>();
1128
- descendent.visit(below => {
1129
- if (below !== descendent && below.maybeNumber !== undefined && numbersUsed.has(below.number)) {
1130
- named.push(below);
1131
- }
1132
- });
1133
- if (named.length) {
1134
- logger.warn(
1135
- `Keeping ${descendent} although the peer's root no longer names it:`,
1136
- `it holds ${named.join(", ")}, which the root does name`,
1137
- );
1138
- continue;
1139
- }
1140
-
1141
- this.#scheduleStructureChange(endpoint, "erase");
1142
- }
1143
- }
1144
- }
1145
1116
  }
1146
1117
 
1147
1118
  #endpointFor(number: EndpointNumber) {
@@ -1273,15 +1244,9 @@ export class ClientStructure {
1273
1244
  );
1274
1245
 
1275
1246
  this.#endpoints.delete(endpoint.number);
1276
- this.#partClaims.delete(structure);
1277
1247
  this.#partsListOf.delete(structure);
1278
1248
  this.#composition.delete(structure);
1279
- for (const [part, claimants] of this.#partClaims) {
1280
- claimants.delete(structure);
1281
- if (claimants.size === 0) {
1282
- this.#partClaims.delete(part);
1283
- }
1284
- }
1249
+ this.#keptOffTheNode.delete(endpoint.number);
1285
1250
 
1286
1251
  // Skip deletion if the endpoint was already destroyed, e.g. because a parent endpoint was erased first and
1287
1252
  // recursively closed its children
@@ -1399,11 +1364,18 @@ export class ClientStructure {
1399
1364
  }
1400
1365
 
1401
1366
  /**
1402
- * Decide the owner of every part whose owner is now known, then apply the structural changes that
1403
- * fall out of it.
1367
+ * Decide which endpoints are on the node and the owner of every part whose owner is now known, then apply the
1368
+ * structural changes that fall out of it.
1404
1369
  */
1405
1370
  async #applyPendingChanges() {
1406
- this.#resolvePartClaims();
1371
+ const previous = this.#endpointsOnTheNode;
1372
+ const current = this.#findEndpointsOnTheNode();
1373
+ this.#endpointsOnTheNode = current;
1374
+ this.#checkRootPartsList();
1375
+ if (previous !== undefined && current !== undefined) {
1376
+ this.#eraseEndpointsOffTheNode(previous, current);
1377
+ }
1378
+ this.#placeParts();
1407
1379
 
1408
1380
  for (const [endpoint, change] of this.#pendingChanges.entries()) {
1409
1381
  this.#pendingChanges.delete(endpoint);
@@ -1424,24 +1396,40 @@ export class ClientStructure {
1424
1396
  }
1425
1397
 
1426
1398
  /**
1427
- * Give every part whose owner is now known an owner, and schedule its installation.
1399
+ * Give every part on the node whose owner is now known an owner, and schedule its installation.
1428
1400
  *
1429
1401
  * A part named by an ordinary endpoint's list is that endpoint's child. A part named only by
1430
1402
  * full-family lists is a child of the innermost of them — but only once every endpoint those lists
1431
1403
  * name has reported its own parts, because until then a list naming it says no more than that it
1432
1404
  * is somewhere below. A part is placed only below an owner that is itself placed, so it is never
1433
- * installed or announced below an endpoint that is not on the node. A claim that is undecided, or
1434
- * whose owner is not placed yet, stays for a later interaction to settle.
1405
+ * installed or announced below an endpoint that is not on the node. Each call reads the current
1406
+ * lists, so a part that cannot be placed yet is considered again on the next apply.
1435
1407
  */
1436
- #resolvePartClaims() {
1408
+ #placeParts() {
1409
+ const claimantsOf = new Map<EndpointStructure, Set<EndpointStructure>>();
1410
+ for (const [claimant, parts] of this.#partsListOf) {
1411
+ for (const partNo of parts) {
1412
+ const part = this.#endpoints.get(partNo);
1413
+ if (part === undefined) {
1414
+ continue;
1415
+ }
1416
+
1417
+ let claimants = claimantsOf.get(part);
1418
+ if (claimants === undefined) {
1419
+ claimants = new Set();
1420
+ claimantsOf.set(part, claimants);
1421
+ }
1422
+ claimants.add(claimant);
1423
+ }
1424
+ }
1425
+
1437
1426
  let placedAny: boolean;
1438
1427
  do {
1439
1428
  placedAny = false;
1440
- for (const [part, claimants] of [...this.#partClaims]) {
1429
+ for (const [part, claimants] of claimantsOf) {
1441
1430
  // Nothing is reparented: an endpoint the peer has already placed keeps its parent, and
1442
1431
  // Matter has no operation that would move it (Core § 9.2.7.3's single-parent requirement)
1443
- if (this.#ownerOf(part) !== undefined) {
1444
- this.#partClaims.delete(part);
1432
+ if (this.#isPlaced(part) || !this.#isOnTheNode(part)) {
1445
1433
  continue;
1446
1434
  }
1447
1435
 
@@ -1451,15 +1439,6 @@ export class ClientStructure {
1451
1439
  }
1452
1440
  const { owner, contenders } = decision;
1453
1441
 
1454
- this.#partClaims.delete(part);
1455
-
1456
- // The root names every endpoint the peer has, and its removal scan runs while attribute
1457
- // data is read — before this. Installing a part the root no longer names would resurrect
1458
- // an endpoint that scan has already passed over.
1459
- if (!this.#isOnTheNode(part)) {
1460
- continue;
1461
- }
1462
-
1463
1442
  if (contenders.length) {
1464
1443
  logger.warn(
1465
1444
  `Taking ${owner.endpoint} as the parent of ${part.endpoint}:`,
@@ -1485,21 +1464,120 @@ export class ClientStructure {
1485
1464
  }
1486
1465
 
1487
1466
  /**
1488
- * Whether the peer's root names `structure`, so far as the root has said.
1489
- *
1490
- * A root endpoint composes its `PartsList` of every descendant (Matter Core § 9.2.8), so an
1491
- * endpoint the root does not name is not a descendant of the node at all — whether it has gone
1492
- * away or was never part of the tree the peer describes. Until the root has reported a list there
1493
- * is nothing to judge against and every endpoint is taken as present.
1467
+ * Whether `structure` is on the node as of the last structural apply; see {@link #findEndpointsOnTheNode}. Until
1468
+ * the root has reported a list there is nothing to judge against and every endpoint is taken as present.
1494
1469
  */
1495
1470
  #isOnTheNode(structure: EndpointStructure) {
1496
- if (structure.endpoint.maybeNumber === 0) {
1497
- return true;
1471
+ const number = structure.endpoint.maybeNumber;
1472
+ return number === undefined || this.#isNumberOnTheNode(number);
1473
+ }
1474
+
1475
+ #isNumberOnTheNode(number: EndpointNumber) {
1476
+ return (
1477
+ number === ROOT_ENDPOINT_NUMBER ||
1478
+ this.#endpointsOnTheNode === undefined ||
1479
+ this.#endpointsOnTheNode.has(number)
1480
+ );
1481
+ }
1482
+
1483
+ /**
1484
+ * The endpoints on the node other than the root, or `undefined` while the root has not reported its `PartsList`.
1485
+ *
1486
+ * A `PartsList` names only endpoints that exist (Matter Core § 9.2.7.3), and the root's names every endpoint on the
1487
+ * node (§ 9.2.8). Some peers name only part of their endpoints there. An endpoint that the `PartsList` of an
1488
+ * endpoint on the node names is on the node too, once the peer has reported its DeviceTypeList or PartsList; until
1489
+ * then the entry may name an endpoint that does not exist.
1490
+ */
1491
+ #findEndpointsOnTheNode() {
1492
+ const rootParts = this.#rootPartsList();
1493
+ if (rootParts === undefined) {
1494
+ return undefined;
1495
+ }
1496
+
1497
+ const found = new Set(rootParts);
1498
+ const pending = [...found];
1499
+ for (let number = pending.pop(); number !== undefined; number = pending.pop()) {
1500
+ const structure = this.#endpoints.get(number);
1501
+ const named = structure === undefined ? undefined : this.#partsListOf.get(structure);
1502
+ for (const part of named ?? []) {
1503
+ if (found.has(part) || !this.#hasReportedDescriptorList(part)) {
1504
+ continue;
1505
+ }
1506
+ found.add(part);
1507
+ pending.push(part);
1508
+ }
1498
1509
  }
1510
+ return found;
1511
+ }
1512
+
1513
+ #hasReportedDescriptorList(number: EndpointNumber) {
1514
+ return !!this.#endpoints.get(number)?.reportedLists?.size;
1515
+ }
1499
1516
 
1517
+ #rootPartsList() {
1500
1518
  const root = this.#endpoints.get(ROOT_ENDPOINT_NUMBER);
1501
- const rootParts = root === undefined ? undefined : this.#partsListOf.get(root);
1502
- return rootParts === undefined || rootParts.has(structure.endpoint.number);
1519
+ return root === undefined ? undefined : this.#partsListOf.get(root);
1520
+ }
1521
+
1522
+ /**
1523
+ * Schedule the erase of every placed endpoint that left the node since `previous`.
1524
+ *
1525
+ * Only an endpoint the peer had on the node is erased, so an endpoint the peer never named stays, such as one
1526
+ * added locally. An endpoint that holds an endpoint still on the node is kept, because erasing it would close that
1527
+ * endpoint too; it is checked again on every apply.
1528
+ */
1529
+ #eraseEndpointsOffTheNode(previous: Set<EndpointNumber>, current: Set<EndpointNumber>) {
1530
+ const candidates = new Set([...previous, ...this.#keptOffTheNode]);
1531
+ for (const number of candidates) {
1532
+ const structure = this.#endpoints.get(number);
1533
+ if (current.has(number) || structure === undefined || !this.#isPlaced(structure)) {
1534
+ this.#keptOffTheNode.delete(number);
1535
+ continue;
1536
+ }
1537
+
1538
+ const { endpoint } = structure;
1539
+ const held = new Array<Endpoint>();
1540
+ endpoint.visit(below => {
1541
+ if (below !== endpoint && below.maybeNumber !== undefined && current.has(below.number)) {
1542
+ held.push(below);
1543
+ }
1544
+ });
1545
+ if (!held.length) {
1546
+ this.#keptOffTheNode.delete(number);
1547
+ this.#scheduleStructureChange(structure, "erase");
1548
+ continue;
1549
+ }
1550
+
1551
+ const message = [
1552
+ `Keeping ${endpoint} although it is no longer on the node:`,
1553
+ `it holds ${held.join(", ")}, which are on the node`,
1554
+ ];
1555
+ if (this.#keptOffTheNode.has(number)) {
1556
+ logger.debug(...message);
1557
+ } else {
1558
+ logger.warn(...message);
1559
+ this.#keptOffTheNode.add(number);
1560
+ }
1561
+ }
1562
+ }
1563
+
1564
+ /** Warn once per node when the root's `PartsList` does not name every endpoint on the node. */
1565
+ #checkRootPartsList() {
1566
+ const rootParts = this.#rootPartsList();
1567
+ if (this.#warnedIncompleteRootPartsList || rootParts === undefined || this.#endpointsOnTheNode === undefined) {
1568
+ return;
1569
+ }
1570
+
1571
+ const unnamed = [...this.#endpointsOnTheNode].filter(number => !rootParts.has(number)).sort((a, b) => a - b);
1572
+ if (!unnamed.length) {
1573
+ return;
1574
+ }
1575
+
1576
+ this.#warnedIncompleteRootPartsList = true;
1577
+ logger.warn(
1578
+ `Peer ${this.#node} does not name endpoints ${unnamed.join(", ")} in the PartsList of its root endpoint,`,
1579
+ "although Matter requires the root to list every endpoint; other endpoints name them, so they are on the node",
1580
+ );
1503
1581
  }
1504
1582
 
1505
1583
  /**
@@ -1510,9 +1588,8 @@ export class ClientStructure {
1510
1588
  const ordinary = new Array<EndpointStructure>();
1511
1589
  const fullFamily = new Array<EndpointStructure>();
1512
1590
  for (const claimant of claimants) {
1513
- // An endpoint the root does not name is not on the node, so it owns nothing. It would
1514
- // otherwise take parts the root does name and hold them below itself, where nothing
1515
- // installs them.
1591
+ // An endpoint not on the node owns nothing. It would otherwise take parts that are on the
1592
+ // node and hold them below itself, where nothing installs them.
1516
1593
  if (!this.#isOnTheNode(claimant)) {
1517
1594
  continue;
1518
1595
  }
@@ -1520,7 +1597,7 @@ export class ClientStructure {
1520
1597
  // What a list means depends on how its endpoint composes one, so a claimant that has not
1521
1598
  // said cannot be weighed against the others yet. Deciding without it would place the part
1522
1599
  // under a parent that a later report cannot correct.
1523
- if (!this.#composition.has(claimant)) {
1600
+ if (this.#compositionOf(claimant) === undefined) {
1524
1601
  return undefined;
1525
1602
  }
1526
1603
 
@@ -1581,14 +1658,12 @@ export class ClientStructure {
1581
1658
 
1582
1659
  /**
1583
1660
  * Whether every endpoint `structure` names has reported a `PartsList` of its own, which is what
1584
- * makes the parts it names and nobody else's its own children. An endpoint the root no longer
1585
- * names reports nothing more, so it is not waited for.
1661
+ * makes the parts it names and nobody else's its own children. An endpoint that is not on the
1662
+ * node reports nothing more, so it is not waited for.
1586
1663
  */
1587
1664
  #partsAccountedFor(structure: EndpointStructure) {
1588
- const root = this.#endpoints.get(ROOT_ENDPOINT_NUMBER);
1589
- const rootParts = root === undefined ? undefined : this.#partsListOf.get(root);
1590
1665
  for (const partNo of this.#partsListOf.get(structure) ?? []) {
1591
- if (rootParts !== undefined && !rootParts.has(partNo)) {
1666
+ if (!this.#isNumberOnTheNode(partNo)) {
1592
1667
  continue;
1593
1668
  }
1594
1669
 
@@ -1600,36 +1675,6 @@ export class ClientStructure {
1600
1675
  return true;
1601
1676
  }
1602
1677
 
1603
- /**
1604
- * Withdraw `structure`'s claim on the parts its previous `PartsList` named and `named` does not.
1605
- *
1606
- * A claim that outlives the list it came from would let an endpoint the peer has dropped be
1607
- * installed later, once the claim became decidable — the peer's current lists are the only
1608
- * statement of what it has.
1609
- */
1610
- #retractClaimsOf(structure: EndpointStructure, named: Set<EndpointNumber>) {
1611
- for (const partNo of this.#partsListOf.get(structure) ?? []) {
1612
- if (named.has(partNo)) {
1613
- continue;
1614
- }
1615
-
1616
- const part = this.#endpoints.get(partNo);
1617
- if (part === undefined) {
1618
- continue;
1619
- }
1620
-
1621
- const claimants = this.#partClaims.get(part);
1622
- if (claimants === undefined) {
1623
- continue;
1624
- }
1625
-
1626
- claimants.delete(structure);
1627
- if (claimants.size === 0) {
1628
- this.#partClaims.delete(part);
1629
- }
1630
- }
1631
- }
1632
-
1633
1678
  /**
1634
1679
  * Record how `structure` composes its `PartsList`, from every device type it reports.
1635
1680
  *
@@ -1661,9 +1706,37 @@ export class ClientStructure {
1661
1706
  }
1662
1707
  }
1663
1708
 
1709
+ /**
1710
+ * How `structure` composes its `PartsList`, or `undefined` while it has not said.
1711
+ *
1712
+ * The root's `PartsList` lists every endpoint on the node (Matter Core § 9.2.8), so its composition is known
1713
+ * whatever device types it reports.
1714
+ */
1715
+ #compositionOf(structure: EndpointStructure) {
1716
+ if (structure.endpoint.maybeNumber === 0) {
1717
+ return EndpointComposition.FullFamily;
1718
+ }
1719
+ return this.#composition.get(structure);
1720
+ }
1721
+
1664
1722
  /** Whether `structure`'s `PartsList` names every descendant rather than its own children. */
1665
1723
  #isFullFamily(structure: EndpointStructure) {
1666
- return this.#composition.get(structure) === EndpointComposition.FullFamily;
1724
+ return this.#compositionOf(structure) === EndpointComposition.FullFamily;
1725
+ }
1726
+
1727
+ /**
1728
+ * Warn once per node when the root reports no device type, although its DeviceTypeList needs at least one entry
1729
+ * (Matter Core § 9.5.6.1). Placing the endpoints does not depend on it; see {@link #compositionOf}.
1730
+ */
1731
+ #checkRootDeviceTypes(deviceTypeList: Descriptor.DeviceType[]) {
1732
+ if (this.#warnedRootWithoutDeviceType || deviceTypeList.some(dt => typeof dt?.deviceType === "number")) {
1733
+ return;
1734
+ }
1735
+ this.#warnedRootWithoutDeviceType = true;
1736
+ logger.warn(
1737
+ `Peer ${this.#node} reports no device type on its root endpoint, although Matter requires at least one;`,
1738
+ "its PartsList is read as listing every endpoint on the node",
1739
+ );
1667
1740
  }
1668
1741
 
1669
1742
  /**