@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
@@ -7,6 +7,7 @@
7
7
  import { InternalError } from "@matter/general";
8
8
  import { AccessControl, ExpiredReferenceError, Val } from "@matter/protocol";
9
9
  import type { Supervision } from "../../supervision/Supervision.js";
10
+ import { UncachedValueError } from "./errors.js";
10
11
  import {
11
12
  memberFallbackKeyFor,
12
13
  memberKeyFor,
@@ -14,14 +15,14 @@ import {
14
15
  memberSlotOf,
15
16
  memberValueOf,
16
17
  } from "./MemberKeys.js";
17
- import type { ValReference } from "./ValReference.js";
18
+ import { ValReference } from "./ValReference.js";
18
19
 
19
20
  type Container = Record<string | number, Val>;
20
21
 
21
22
  /**
22
23
  * ManagedReference manages a reference to a container property of another reference.
23
24
  *
24
- * The ManagedReference detects when the value changes and clones the container if it is the original copy.
25
+ * The ManagedReference clones the container on write unless the transaction already owns it.
25
26
  *
26
27
  * This serves the following purposes:
27
28
  *
@@ -31,9 +32,27 @@ type Container = Record<string | number, Val>;
31
32
  *
32
33
  * - Preserves metadata regarding the state of the value
33
34
  *
34
- * Change detection happens automatically if the value is replaced. If a subvalue is replaced, the logic replacing the
35
- * subvalue must update "changed" manually before replacing the subvalue. For managed structures this is handled by a
36
- * separate ManagedReference.
35
+ * A member reference follows whatever container the parent holds at its key. A list entry reference is bound to one
36
+ * entry instead, because an index does not identify an entry (see {@link ManagedReference.Binding}):
37
+ *
38
+ * | State | Cause | {@link value} | Writes |
39
+ * |---------|----------------------------------------------------------|--------------------|-------------------------|
40
+ * | live | the member holds a container | that container | allowed |
41
+ * | default | the member is absent; the reference has a default | the default | `UncachedValueError` |
42
+ * | absent | member absent without default, or container above absent;| `undefined`/`null` | `PhantomReferenceError` |
43
+ * | | for an entry, only after another transaction's commit | | |
44
+ * | expired | the owning context exited, a parent is read-only, or a | last container | `ExpiredReferenceError` |
45
+ * | | change in this session moved, removed or replaced this | | |
46
+ * | | entry | | |
47
+ *
48
+ * A reference to a mandatory member has a default when its parent keys by ID, which only a mirror's root does; see
49
+ * {@link ValReference.PrimaryKey}. A reference makes its default when it enters "default" and serves that same value
50
+ * until it leaves; a read never stores it. A value built from the default and assigned whole is stored like any other
51
+ * assignment and replaces the remote value. A write below a reference in "default" fails the same way. Before the
52
+ * default is checked, a write throws what the datasource's `ExternallyMutableStore.assertWritable` throws. "default"
53
+ * and "absent" return to "live" when the member holds a container again, for example after a report or an assignment.
54
+ * Once a transaction changed the cluster, its root keeps its own copy, so a later report does not reach it. A live
55
+ * member that becomes absent again, for example by a rollback, enters "default" or "absent". "expired" is final.
37
56
  */
38
57
  export class ManagedReference implements ValReference {
39
58
  readonly primaryKey = "name";
@@ -46,35 +65,43 @@ export class ManagedReference implements ValReference {
46
65
  #key: string | number;
47
66
  #fallbackKey: string | number | undefined;
48
67
  #readFallbackKey: string | number | undefined;
49
- #assertWriteOk: (value: Val) => void;
50
- #clone: ((container: Val) => Val) | undefined;
68
+ #clone: (container: Val) => Val;
69
+ #makeDefault: (() => Val) | undefined;
70
+ #servesDefault = false;
51
71
  #session: AccessControl.Session;
52
- #expired = false;
53
72
  #location: AccessControl.Location;
54
- #value: unknown;
73
+ #value: Val;
55
74
  #dynamicContainer: Val.Struct | undefined;
56
75
  #dynamicSource: Val | undefined;
76
+ #binding: ManagedReference.Binding;
77
+ #entry: unknown;
78
+ #copies?: WeakSet<object>;
79
+ #detached = false;
57
80
 
58
81
  /**
59
82
  * @param parent a reference to the container we reference
60
83
  * @param name the name (in the case of structs) or index (in case of lists)
61
84
  * @param id the lookup ID, used when {@link parent} keys its members by ID
62
- * @param assertWriteOk enforces ACLs and read-only
63
- * @param clone clones the container prior to write; undefined if not transactional
85
+ * @param clone clones the container prior to write
64
86
  * @param session the access control session
87
+ * @param binding what the reference stays bound to when the parent changes
88
+ * @param makeDefault makes the default to serve while the member is absent; called once each time the member
89
+ * becomes absent
65
90
  */
66
91
  constructor(
67
92
  parent: ValReference<Val.Collection>,
68
93
  name: string | number,
69
94
  id: number | undefined,
70
- assertWriteOk: (value: Val) => void,
71
95
  clone: (container: Val) => Val,
72
96
  session: AccessControl.Session,
97
+ binding: ManagedReference.Binding,
98
+ makeDefault?: () => Val,
73
99
  ) {
74
100
  this.parent = parent;
75
- this.#assertWriteOk = assertWriteOk;
76
101
  this.#clone = clone;
102
+ this.#makeDefault = makeDefault;
77
103
  this.#session = session;
104
+ this.#binding = binding;
78
105
 
79
106
  this.#location = {
80
107
  ...parent.location,
@@ -89,10 +116,8 @@ export class ManagedReference implements ValReference {
89
116
  this.#readFallbackKey = readFallbackKey;
90
117
 
91
118
  this.#bindDynamicContainer();
92
- this.#value =
93
- this.#dynamicContainer === undefined
94
- ? memberValueOf(parent.value as Container, key, readFallbackKey)
95
- : memberValueOf(this.#dynamicContainer as Container, key, fallbackKey);
119
+ this.#value = this.#memberValue();
120
+ this.#entry = this.#value;
96
121
 
97
122
  // Propagate supervision config from parent
98
123
  if (parent.supervisionConfig) {
@@ -106,34 +131,20 @@ export class ManagedReference implements ValReference {
106
131
  }
107
132
 
108
133
  get rootOwner() {
109
- return this.parent!.rootOwner;
134
+ return this.parent.rootOwner;
135
+ }
136
+
137
+ get mirrorsRemote() {
138
+ return this.parent.mirrorsRemote;
110
139
  }
111
140
 
112
141
  get value() {
113
142
  // Authorization is unnecessary here because the reference would not exist if access is unauthorized
114
- // Note that we allow read from expired references
115
143
  return this.#value;
116
144
  }
117
145
 
118
- set value(newValue: Val) {
119
- if (this.#value === newValue) {
120
- return;
121
- }
122
-
123
- // Authorization and validation
124
- this.#assertWriteOk(newValue);
125
-
126
- // Set the value directly before change() so change() doesn't create a useless clone
127
- this.#replaceValue(newValue);
128
-
129
- // Now use change to complete the update
130
- this.change(() => {
131
- this.#writeTo(this.#dynamicContainer ?? (this.parent!.value as Container), newValue);
132
- });
133
- }
134
-
135
146
  get expired() {
136
- return this.#expired;
147
+ return this.#detached || this.parent.expired;
137
148
  }
138
149
 
139
150
  get location() {
@@ -144,64 +155,129 @@ export class ManagedReference implements ValReference {
144
155
  this.#location = loc;
145
156
  }
146
157
 
147
- get original() {
148
- if (!this.parent!.original) {
149
- return undefined;
158
+ assertWritable() {
159
+ if (this.expired) {
160
+ throw new ExpiredReferenceError(this.location);
150
161
  }
151
- if (this.#dynamicContainer !== undefined) {
152
- const origProperties = (this.parent!.original as Val.Dynamic)[Val.properties](
153
- this.parent!.rootOwner,
154
- this.#session,
155
- );
156
- return memberValueOf(origProperties as Container, this.#key, this.#fallbackKey);
162
+ this.parent.assertWritable();
163
+ if (this.#servesDefault) {
164
+ throw new UncachedValueError(this.location);
157
165
  }
158
- return memberValueOf(this.parent!.original as Container, this.#key, this.#readFallbackKey);
159
166
  }
160
167
 
161
- change(mutator: () => void) {
162
- if (this.#expired) {
163
- throw new ExpiredReferenceError(this.location);
164
- }
168
+ /**
169
+ * A container a `Val.properties` provider serves, and every container below it, is never owned, even when the
170
+ * provider serves a container the transaction cloned for another member. The provider keeps the value its setter
171
+ * accepted, so a later change must clone it again instead of changing it in place.
172
+ */
173
+ owns(container: Val) {
174
+ return this.#dynamicContainer === undefined && this.parent.owns(container);
175
+ }
176
+
177
+ adopt(container: Val) {
178
+ this.parent.adopt(container);
179
+ }
165
180
 
166
- this.parent!.change(() => {
167
- // In transactions, clone the value if we haven't done so yet
168
- if (this.#clone && this.#value === this.original) {
169
- const newValue = this.#clone(this.#value);
170
- this.#writeTo(this.#dynamicContainer ?? (this.parent!.value as Container), newValue);
171
- this.#replaceValue(newValue);
181
+ /**
182
+ * Clones the container unless the transaction {@link owns} it, runs {@link mutator}, then stores the container in
183
+ * the parent. A dynamic provider's setter therefore receives the container after every change, with the change
184
+ * applied.
185
+ */
186
+ change(mutator: () => void) {
187
+ ValReference.writableContainerOf(this);
188
+
189
+ this.parent.change(() => {
190
+ // The parent's change may refresh this reference and expire it
191
+ ValReference.writableContainerOf(this);
192
+
193
+ if (!this.owns(this.#value)) {
194
+ const clone = this.#clone(this.#value);
195
+ this.adopt(clone);
196
+ if (this.#binding === "entry" && typeof clone === "object" && clone !== null) {
197
+ (this.#copies ??= new WeakSet()).add(clone);
198
+ }
199
+ this.#replaceValue(clone, "session");
172
200
  }
173
201
 
174
- // Apply changes
175
202
  mutator();
203
+
204
+ this.#writeTo(this.#dynamicContainer ?? (this.parent.value as Container), this.#value);
176
205
  }, this.#key);
177
206
  }
178
207
 
179
- refresh() {
180
- if (this.parent!.expired) {
181
- this.#expired = true;
208
+ refresh(cause: ValReference.RefreshCause) {
209
+ if (this.expired) {
182
210
  return;
183
211
  }
184
- if (this.parent!.value === undefined || this.parent!.value === null) {
185
- this.#expired = true;
186
- this.#replaceValue(undefined);
212
+
213
+ if (this.parent.value === undefined || this.parent.value === null) {
214
+ this.#servesDefault = false;
215
+ this.#follow(undefined, cause);
187
216
  return;
188
217
  }
189
218
 
190
219
  // A member the parent serves from a provider must stay served for the life of this reference; a reference that
191
220
  // found no provider is never asked again, so a parent may not start serving one either
192
- if (this.#dynamicContainer !== undefined && this.parent!.value !== this.#dynamicSource) {
221
+ if (this.#dynamicContainer !== undefined && this.parent.value !== this.#dynamicSource) {
193
222
  this.#bindDynamicContainer();
194
223
  if (this.#dynamicContainer === undefined) {
195
224
  throw new InternalError(`Value at ${this.location.path} no longer serves ${this.#key}`);
196
225
  }
197
226
  }
198
227
 
228
+ this.#follow(this.#memberValue(), cause);
229
+ }
230
+
231
+ #memberValue() {
199
232
  const value =
200
233
  this.#dynamicContainer === undefined
201
- ? memberValueOf(this.parent!.value as Container, this.#key, this.#readFallbackKey)
234
+ ? memberValueOf(this.parent.value as Container, this.#key, this.#readFallbackKey)
202
235
  : memberValueOf(this.#dynamicContainer as Container, this.#key, this.#fallbackKey);
236
+ if (value !== undefined || this.#makeDefault === undefined) {
237
+ this.#servesDefault = false;
238
+ return value;
239
+ }
240
+ if (!this.#servesDefault) {
241
+ this.#servesDefault = true;
242
+ return this.#makeDefault();
243
+ }
244
+ return this.#value;
245
+ }
246
+
247
+ /**
248
+ * Take `value` as the referenced value. An entry reference expires instead when a change in this session put
249
+ * another entry at its index. It accepts its entry and every copy it made of that entry, because only a rollback
250
+ * puts an earlier copy back. After another transaction's commit, an entry reference follows its index like a
251
+ * member reference and binds to the entry now there.
252
+ */
253
+ #follow(value: unknown, cause: ValReference.RefreshCause) {
254
+ if (this.#binding === "entry") {
255
+ if (cause === "external") {
256
+ this.#entry = value;
257
+ this.#copies = undefined;
258
+ } else if (!this.#holds(value)) {
259
+ this.#detach();
260
+ return;
261
+ }
262
+ }
263
+
264
+ this.#replaceValue(value, cause);
265
+ }
266
+
267
+ #holds(value: unknown) {
268
+ if (value === this.#entry) {
269
+ return true;
270
+ }
271
+ return typeof value === "object" && value !== null && !!this.#copies?.has(value);
272
+ }
203
273
 
204
- this.#replaceValue(value);
274
+ /**
275
+ * Stop following the entry. The reference keeps its last value and is {@link expired}. It leaves the parent's
276
+ * subrefs, so the next read at its index creates a reference for the entry now there.
277
+ */
278
+ #detach() {
279
+ this.#detached = true;
280
+ delete this.parent.subrefs?.[this.#key];
205
281
  }
206
282
 
207
283
  /**
@@ -209,7 +285,7 @@ export class ManagedReference implements ValReference {
209
285
  * struct it was derived from, so this runs again whenever the parent replaces that struct.
210
286
  */
211
287
  #bindDynamicContainer() {
212
- const parent = this.parent!;
288
+ const parent = this.parent;
213
289
 
214
290
  this.#dynamicSource = parent.value;
215
291
  this.#dynamicContainer = undefined;
@@ -236,14 +312,27 @@ export class ManagedReference implements ValReference {
236
312
  }
237
313
  }
238
314
 
239
- #replaceValue(newValue: Val) {
315
+ #replaceValue(newValue: Val, cause: ValReference.RefreshCause) {
240
316
  this.#value = newValue;
241
317
 
242
318
  const subrefs = this.subrefs;
243
319
  if (subrefs) {
244
320
  for (const key in subrefs) {
245
- subrefs[key].refresh();
321
+ subrefs[key].refresh(cause);
246
322
  }
247
323
  }
248
324
  }
249
325
  }
326
+
327
+ export namespace ManagedReference {
328
+ /**
329
+ * What a reference stays bound to when its parent changes.
330
+ *
331
+ * - `member`: the key. A struct member is identified by its name, so the reference follows the container the
332
+ * parent holds there.
333
+ * - `entry`: the entry it was read for, or the entry another transaction's commit put at its index. An index does
334
+ * not identify a list entry: a list method, a length change, an assignment at the index or of the whole list puts
335
+ * another entry there.
336
+ */
337
+ export type Binding = "member" | "entry";
338
+ }
@@ -97,7 +97,7 @@ export function NameResolver(
97
97
  }
98
98
 
99
99
  return (val: Val) => {
100
- const parent = (val as Internal.Collection)?.[Internal.reference]?.parent?.owner;
100
+ const parent = Internal.referenceOf(val)?.parent?.owner;
101
101
  if (parent) {
102
102
  return parentReader(parent as Val.Collection);
103
103
  }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2022-2026 Matter.js Authors
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+
7
+ import { AccessControl, ExpiredReferenceError, Val } from "@matter/protocol";
8
+ import type { ValReference } from "./ValReference.js";
9
+
10
+ /**
11
+ * A read-only reference to a value that has no slot in managed state, such as an entry a list method removed or an
12
+ * entry a sort comparator receives.
13
+ *
14
+ * The reference serves the value it was given, not a copy. A manager over it reads through the same path as over a
15
+ * live reference, with the same authorization and name resolution. The reference counts as expired, so every write
16
+ * through it or through a reference below it throws {@link ExpiredReferenceError}.
17
+ */
18
+ export class ReadOnlyReference implements ValReference {
19
+ readonly primaryKey = "name";
20
+ readonly expired = true;
21
+
22
+ subrefs?: Record<number | string, ValReference>;
23
+ owner?: Val;
24
+ location: AccessControl.Location;
25
+
26
+ #value: Val;
27
+ #rootOwner: unknown;
28
+
29
+ readonly mirrorsRemote: boolean;
30
+
31
+ constructor(value: Val, location: AccessControl.Location, rootOwner: unknown, mirrorsRemote: boolean) {
32
+ this.#value = value;
33
+ this.location = location;
34
+ this.#rootOwner = rootOwner;
35
+ this.mirrorsRemote = mirrorsRemote;
36
+ }
37
+
38
+ get value() {
39
+ return this.#value;
40
+ }
41
+
42
+ get rootOwner() {
43
+ return this.#rootOwner;
44
+ }
45
+
46
+ change() {
47
+ throw new ExpiredReferenceError(this.location);
48
+ }
49
+
50
+ assertWritable() {
51
+ throw new ExpiredReferenceError(this.location);
52
+ }
53
+
54
+ refresh() {}
55
+
56
+ owns() {
57
+ return false;
58
+ }
59
+
60
+ adopt() {}
61
+ }
@@ -5,7 +5,9 @@
5
5
  */
6
6
 
7
7
  import type { AccessControl, Val } from "@matter/protocol";
8
+ import { ExpiredReferenceError, PhantomReferenceError } from "@matter/protocol";
8
9
  import type { Supervision } from "../../supervision/Supervision.js";
10
+ import { Internal } from "./Internal.js";
9
11
 
10
12
  /**
11
13
  * A Reference offers a simple mechanism for referring to properties by reference.
@@ -14,17 +16,18 @@ import type { Supervision } from "../../supervision/Supervision.js";
14
16
  */
15
17
  export interface ValReference<T extends Val = Val> {
16
18
  /**
17
- * The current value of the referenced property. Cleared when the reference is no longer functional.
19
+ * The current value of the referenced property. While the property is absent, a reference with a default for it
20
+ * serves that default, and any other reference serves `undefined` or `null`. A reference below a container that
21
+ * is absent without a default serves `undefined` or `null` too. An expired nested reference keeps the last
22
+ * container it saw, which a live reference to the same entry may still change. The root reference throws
23
+ * {@link ExpiredReferenceError} after its owning context exits.
18
24
  */
19
- value: T;
25
+ readonly value: T | undefined | null;
20
26
 
21
27
  /**
22
- * The current canonical value of the referenced property.
23
- */
24
- readonly original: T;
25
-
26
- /**
27
- * When true, the reference is no longer usable because the owning context has exited.
28
+ * When true, the reference no longer tracks live state: the owning context has exited, a change in this session
29
+ * moved, removed or replaced the list entry it was read for, or the reference is a read-only view. Final, and true
30
+ * for every reference below an expired one.
28
31
  */
29
32
  readonly expired: boolean;
30
33
 
@@ -39,9 +42,10 @@ export interface ValReference<T extends Val = Val> {
39
42
  subrefs?: Record<number | string, ValReference>;
40
43
 
41
44
  /**
42
- * Mutates data. Clones the container and updates metadata when called on an unmodified transactional reference.
45
+ * Mutates data. A nested reference first clones its container unless the transaction {@link owns} it.
43
46
  *
44
- * Then runs the specified mutator to make the actual changes.
47
+ * Then runs the specified mutator to make the actual changes. A nested reference then stores the changed
48
+ * container in its parent, so the mutator changes state only through this reference or references below it.
45
49
  *
46
50
  * @param mutator the mutation logic, may freely modify {@link value}
47
51
  * @param member the key of the member of {@link value} the mutation assigns. The root reference records it as
@@ -52,8 +56,37 @@ export interface ValReference<T extends Val = Val> {
52
56
 
53
57
  /**
54
58
  * Refresh any internal cache from the referenced container.
59
+ *
60
+ * @param cause what changed the container, which decides whether a list entry reference follows its index (see
61
+ * `ManagedReference.Binding`)
62
+ */
63
+ refresh(cause: ValReference.RefreshCause): void;
64
+
65
+ /**
66
+ * Throw the error a change through this reference fails with. Does not check whether the member is absent;
67
+ * {@link ValReference.containerOf} does. A change asks before it is applied and before it joins the transaction.
68
+ * The access check, list bounds checks and the validation of a new list entry run before this; validation of a
69
+ * value assigned to a struct member runs after it. The Remote API `add` asks before the access check.
70
+ *
71
+ * Checks in this order, so the first refusal wins: {@link expired}, then the datasource, then a default served by
72
+ * this reference or one above it.
73
+ *
74
+ * @throws ExpiredReferenceError when the reference is {@link expired}, naming the location of this reference
75
+ * @throws what the datasource's `ExternallyMutableStore.assertWritable` throws
76
+ * @throws UncachedValueError when this reference, or one above it, serves the default of an absent member
55
77
  */
56
- refresh(): void;
78
+ assertWritable(): void;
79
+
80
+ /**
81
+ * Whether the transaction cloned {@link container} since its last commit or rollback. A nested write may change
82
+ * an owned container in place; any other container may be shared with committed state.
83
+ */
84
+ owns(container: Val): boolean;
85
+
86
+ /**
87
+ * Record {@link container}, a clone this transaction made, as owned until the transaction commits or rolls back.
88
+ */
89
+ adopt(container: Val): void;
57
90
 
58
91
  /**
59
92
  * How this container keys its own members. Only a datasource root may key by element ID; every nested container
@@ -71,6 +104,11 @@ export interface ValReference<T extends Val = Val> {
71
104
  */
72
105
  rootOwner?: any;
73
106
 
107
+ /**
108
+ * Whether the root datasource holds a copy of a remote node's values.
109
+ */
110
+ readonly mirrorsRemote: boolean;
111
+
74
112
  /**
75
113
  * The parent of this reference, if any.
76
114
  */
@@ -83,12 +121,64 @@ export interface ValReference<T extends Val = Val> {
83
121
  }
84
122
 
85
123
  export namespace ValReference {
124
+ /**
125
+ * What changed a container before a refresh.
126
+ *
127
+ * - `session`: a change or rollback in the session that holds the reference.
128
+ * - `external`: another transaction committed, and the session has not written since.
129
+ */
130
+ export type RefreshCause = "session" | "external";
131
+
86
132
  /**
87
133
  * How a container keys its own members.
88
134
  *
89
- * `id` also asserts provenance: only a datasource mirroring a peer keys by element ID, and for such a container
90
- * the peer's reports are the only source of values — no locally derived value (state-class field initializer,
91
- * configured default or computed schema default) may enter it or be synthesized on read.
135
+ * `id` also asserts provenance: only a datasource mirroring a peer keys by element ID, and such a container stores
136
+ * only values the peer reported or that are being written to it — no locally derived value (state-class field
137
+ * initializer, configured default or computed schema default) may enter it. A mandatory member the container
138
+ * does not hold reads as its default, which is never stored; see `ManagedReference`.
92
139
  */
93
140
  export type PrimaryKey = "id" | "name";
141
+
142
+ /**
143
+ * The container {@link reference} points to, for a manager that reads its members. A nested reference whose
144
+ * owning context exited still serves the last container it saw.
145
+ *
146
+ * @throws PhantomReferenceError when the property, or a container above it, is absent
147
+ * @throws ExpiredReferenceError when the container is absent and the reference is expired, or when
148
+ * {@link reference} is a root reference whose owning context has exited
149
+ */
150
+ export function containerOf<T extends Val>(reference: ValReference<T>): NonNullable<T> {
151
+ const container = reference.value;
152
+ if (container === undefined || container === null) {
153
+ if (reference.expired) {
154
+ throw new ExpiredReferenceError(reference.location);
155
+ }
156
+ throw new PhantomReferenceError(reference.location);
157
+ }
158
+ return container;
159
+ }
160
+
161
+ /**
162
+ * The container {@link reference} points to, for a manager that writes its members.
163
+ *
164
+ * @throws ExpiredReferenceError when the reference is {@link ValReference.expired}, whether or not the container is
165
+ * present
166
+ * @throws PhantomReferenceError when the property, or a container above it, is absent
167
+ * @throws any error {@link ValReference.assertWritable} throws
168
+ */
169
+ export function writableContainerOf<T extends Val>(reference: ValReference<T>): NonNullable<T> {
170
+ reference.assertWritable();
171
+ return containerOf(reference);
172
+ }
173
+
174
+ /**
175
+ * Assert that {@link value} may be changed. Use it before a value built from {@link value}, such as a list with
176
+ * one more entry, replaces it: {@link value} may be a default that the datasource does not hold, and the new value
177
+ * would then replace the remote value. Returns for a value that is not managed.
178
+ *
179
+ * @throws any error {@link ValReference.assertWritable} throws for the reference behind {@link value}
180
+ */
181
+ export function assertWritableValue(value: Val) {
182
+ Internal.referenceOf(value)?.assertWritable();
183
+ }
94
184
  }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2022-2026 Matter.js Authors
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+
7
+ import type { SchemaErrorPath } from "@matter/model";
8
+ import { WriteError } from "@matter/protocol";
9
+ import { Status } from "@matter/types";
10
+
11
+ /**
12
+ * Thrown for a change in place of a mandatory list, struct or bitmap that the cluster state of a client node does not
13
+ * hold.
14
+ *
15
+ * The cluster state of a client node reads such a value as its default, so it reads like any other value. The default
16
+ * is not the device's value: the device's list may hold entries, its bitmap flags and its struct fields that the
17
+ * default does not have. Sending the default with a change would replace the device's value, so the change fails and
18
+ * nothing is stored or sent.
19
+ *
20
+ * Read the attribute from the device first, or assign a complete value. An assigned value replaces the value on the
21
+ * device, also when it was built from the default, such as `[...state.binding, entry]`. `Endpoint.set()` and
22
+ * `Endpoint.setStateOf()` assign each attribute value given for the cluster state of a client node whole, so they do
23
+ * not fail with this error.
24
+ */
25
+ export class UncachedValueError extends WriteError {
26
+ constructor(path: SchemaErrorPath) {
27
+ super(
28
+ path,
29
+ "The value is not cached; read it from the device first, or assign a complete value, which replaces the value on the device",
30
+ Status.InvalidInState,
31
+ );
32
+ }
33
+ }
@@ -5,3 +5,4 @@
5
5
  */
6
6
 
7
7
  export * from "./Instrumentation.js";
8
+ export * from "./errors.js";