@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
@@ -241,9 +241,10 @@ export namespace Datasource {
241
241
  defaults?: Val.Struct;
242
242
 
243
243
  /**
244
- * Optional storage for non-volatile values.
244
+ * Optional storage for non-volatile values: a {@link PersistentStore}, or an {@link ExternallyMutableStore}
245
+ * for the values of a remote node.
245
246
  */
246
- store?: Store | ExternallyMutableStore;
247
+ store?: PersistentStore | ExternallyMutableStore;
247
248
 
248
249
  /**
249
250
  * Adjusts persisted values in an outdated format, see {@link Behavior.migrate}. Does not apply to values that
@@ -271,14 +272,19 @@ export namespace Datasource {
271
272
  }
272
273
 
273
274
  /**
274
- * The interface {@link Datasource} uses to read and write non-volatile values.
275
+ * What every store of a {@link Datasource} holds.
275
276
  */
276
277
  export interface Store {
277
278
  /**
278
279
  * Initial values must be loaded beforehand. That allows the behavior to initialize synchronously.
279
280
  */
280
281
  initialValues?: Val.Struct;
282
+ }
281
283
 
284
+ /**
285
+ * A {@link Store} the datasource writes changed values to.
286
+ */
287
+ export interface PersistentStore extends Store {
282
288
  /**
283
289
  * Updates the values.
284
290
  *
@@ -289,17 +295,49 @@ export namespace Datasource {
289
295
  }
290
296
 
291
297
  /**
292
- * An extended {@link Store} that represents cached values that may mutate independently from the datasource.
298
+ * A {@link Store} that holds cached values of a remote node, which may mutate independently from the datasource.
299
+ *
300
+ * The datasource proposes a write to the remote node in two steps: {@link prepare} decides whether the values may
301
+ * go to the remote node, and the step it returns sends them.
293
302
  */
294
303
  export interface ExternallyMutableStore extends Store {
304
+ /**
305
+ * Decide whether a transaction may propose {@link values} to the remote node, and return the step that sends
306
+ * them in commit phase one.
307
+ *
308
+ * Invoked once per commit cycle, after pre-commit settled and before any participant's commit phase one, so a
309
+ * refusal rejects the commit before any remote node receives a write. Must complete synchronously and must
310
+ * not write.
311
+ *
312
+ * The values are TLV-encoded only when the returned step sends them, so a value the encoder cannot write fails in
313
+ * commit phase one, when another remote node may already have received its write.
314
+ *
315
+ * @param path the path of the values, for a refusal
316
+ * @throws WriteError to refuse the values. Any other error, such as an `InternalError`, passes through the same
317
+ * way. Either rejects the commit and rolls the transaction back.
318
+ * @see {@link Transaction.Participant.settled}
319
+ */
320
+ prepare(values: Val.Struct, path: DataModelPath): ExternallyMutableStore.Send;
321
+
322
+ /**
323
+ * Refuse every change of the values when the remote node takes no writes through this store. The datasource
324
+ * asks before it applies a change and before it joins the transaction, so the refusal comes where the change
325
+ * is made; {@link ValReference.assertWritable} states which checks run before and after. Must not write.
326
+ *
327
+ * @param path the path of the values, for the refusal
328
+ * @throws an error that says why the remote node takes no writes
329
+ */
330
+ assertWritable(path: DataModelPath): void;
331
+
295
332
  /**
296
333
  * Apply values the peer reported.
297
334
  *
298
- * Uses the same patch semantics as {@link set}, but the values are the peer's own and take effect at once. On a
299
- * mirror, {@link set} instead proposes values to the peer and leaves the local values unchanged until the peer
300
- * accepts them, so never route a report through {@link set}. Resolves once the values are applied, also when
301
- * storing them locally failed; the result then carries that failure for the caller to report. Their change
302
- * notifications may follow later, when notifications of an earlier change are still held; do not await them.
335
+ * Uses the same patch semantics as {@link PersistentStore.set}, but the values are the peer's own and take
336
+ * effect at once. A write instead goes through {@link prepare} and leaves the local values unchanged until the
337
+ * peer accepts them. The values apply in memory before this first awaits, so a write the peer answers while
338
+ * they are still being stored sees them. Resolves once they are stored locally or queued for storage, also when storing them failed;
339
+ * the result then carries that failure for the caller to report. Their change notifications may follow later,
340
+ * when notifications of an earlier change are still held; do not await them.
303
341
  */
304
342
  externalSet(values: Val.StructMap): Promise<ExternallyMutableStore.Applied>;
305
343
 
@@ -341,6 +379,14 @@ export namespace Datasource {
341
379
  }
342
380
 
343
381
  export namespace ExternallyMutableStore {
382
+ /**
383
+ * Sends prepared values to the remote node in commit phase one of {@link transaction}. The local values stay
384
+ * unchanged until the remote node accepts them.
385
+ */
386
+ export interface Send {
387
+ (transaction: Transaction): MaybePromise<void>;
388
+ }
389
+
344
390
  /**
345
391
  * The result of {@link ExternallyMutableStore.externalSet}.
346
392
  */
@@ -352,7 +398,7 @@ export namespace Datasource {
352
398
  persistFailure?: unknown;
353
399
  }
354
400
 
355
- export function is(store?: Store | ExternallyMutableStore): store is ExternallyMutableStore {
401
+ export function is(store?: PersistentStore | ExternallyMutableStore): store is ExternallyMutableStore {
356
402
  return store !== undefined && "externalSet" in store;
357
403
  }
358
404
 
@@ -426,7 +472,7 @@ class DatasourceImpl implements Datasource, Datasource.ExternallyMutableStore.Co
426
472
  supervisor;
427
473
  location;
428
474
  entropy;
429
- store?: Datasource.Store | Datasource.ExternallyMutableStore;
475
+ store?: Datasource.PersistentStore | Datasource.ExternallyMutableStore;
430
476
  owner?: any;
431
477
  onChange?: (attrs: string[]) => MaybePromise<void>;
432
478
 
@@ -457,10 +503,20 @@ class DatasourceImpl implements Datasource, Datasource.ExternallyMutableStore.Co
457
503
  supervisionConfig?: GlobalConfig;
458
504
 
459
505
  /**
460
- * True when {@link store} is a {@link Datasource.ExternallyMutableStore}, i.e. the values mirror a remote node and
461
- * {@link Datasource.ExternallyMutableStore.set} conveys changes to that node rather than to local persistence.
506
+ * {@link store} when it is a {@link Datasource.ExternallyMutableStore}, i.e. the values are a copy of a remote
507
+ * node's values and a write goes to that node rather than to local persistence.
462
508
  */
463
- readonly mirrorsRemote: boolean;
509
+ readonly remoteStore?: Datasource.ExternallyMutableStore;
510
+
511
+ /**
512
+ * True when the datasource has a {@link remoteStore}.
513
+ *
514
+ * A validation error of a value sent to the remote node is left to the device, and a session of our own server
515
+ * node sees a fabric-scoped list unfiltered, as its fabric is not one of the remote node.
516
+ */
517
+ get mirrorsRemote() {
518
+ return this.remoteStore !== undefined;
519
+ }
464
520
 
465
521
  observedInteractions?: Set<
466
522
  | NonNullable<ValueSupervisor.RemoteActorSession["interactionComplete"]>
@@ -477,7 +533,9 @@ class DatasourceImpl implements Datasource, Datasource.ExternallyMutableStore.Co
477
533
  this.location = options.location;
478
534
  this.entropy = options.entropy;
479
535
  this.store = options.store;
480
- this.mirrorsRemote = Datasource.ExternallyMutableStore.is(options.store);
536
+ if (Datasource.ExternallyMutableStore.is(options.store)) {
537
+ this.remoteStore = options.store;
538
+ }
481
539
  this.owner = options.owner;
482
540
  this.onChange = options.onChange;
483
541
  this.primaryKey = options.primaryKey === "id" ? "id" : "name";
@@ -935,6 +993,11 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
935
993
  #precommitValues: Val.Struct | undefined;
936
994
  #changes: CommitChanges | undefined;
937
995
 
996
+ /**
997
+ * Containers this session cloned since its last commit or rollback; see {@link owns}.
998
+ */
999
+ #owned = new WeakSet<object>();
1000
+
938
1001
  /**
939
1002
  * Keys of the members this session assigned since its last commit or rollback, whether or not the value differs.
940
1003
  */
@@ -958,6 +1021,19 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
958
1021
  #fields: Set<string>;
959
1022
  #context!: SessionContext;
960
1023
 
1024
+ /**
1025
+ * The step the remote store prepared in {@link settled}, for this commit cycle's phase one.
1026
+ */
1027
+ #send: Datasource.ExternallyMutableStore.Send | undefined;
1028
+
1029
+ /**
1030
+ * Present only on a reference to the values of a remote node. The remote store decides on the proposal before any
1031
+ * participant's commit phase one, so a refusal by one remote node leaves every remote node of the transaction
1032
+ * unwritten. Absent on other references, because a transaction enters its settled status only when a participant
1033
+ * has this hook.
1034
+ */
1035
+ readonly settled?: () => void;
1036
+
961
1037
  constructor(resource: Transaction.Resource, internals: DatasourceImpl, session: ValueSupervisor.Session) {
962
1038
  this.#resource = resource;
963
1039
  this.#internals = internals;
@@ -991,6 +1067,14 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
991
1067
  } else {
992
1068
  this.supervisionConfig = new LocalConfig(internals.supervisionConfig);
993
1069
  }
1070
+
1071
+ const store = internals.remoteStore;
1072
+ if (store !== undefined) {
1073
+ this.settled = () => {
1074
+ const proposed = this.#proposedValues();
1075
+ this.#send = proposed === undefined ? undefined : store.prepare(proposed, internals.location.path);
1076
+ };
1077
+ }
994
1078
  }
995
1079
 
996
1080
  /**
@@ -1007,7 +1091,7 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1007
1091
  onChange: (oldValues: Val.Struct) => {
1008
1092
  if (this.#values === oldValues) {
1009
1093
  this.#values = this.#internals.values;
1010
- this.#refreshSubrefs();
1094
+ this.#refreshSubrefs("external");
1011
1095
  }
1012
1096
  },
1013
1097
  };
@@ -1024,7 +1108,6 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1024
1108
  try {
1025
1109
  this.#internals.sessions?.delete(this.#session);
1026
1110
  this.#expired = true;
1027
- this.#refreshSubrefs();
1028
1111
  } catch (e) {
1029
1112
  logger.warn(
1030
1113
  `Error detaching reference to ${this.#internals.location.path} from closed transaction ${transaction.via}:`,
@@ -1042,10 +1125,6 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1042
1125
 
1043
1126
  // -- ValReference implementation --
1044
1127
 
1045
- get original() {
1046
- return this.#internals.values;
1047
- }
1048
-
1049
1128
  get value() {
1050
1129
  if (this.#expired) {
1051
1130
  throw new ExpiredReferenceError(this.location);
@@ -1053,10 +1132,6 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1053
1132
  return this.#values;
1054
1133
  }
1055
1134
 
1056
- set value(_value) {
1057
- throw new InternalError(`Cannot set root reference for ${this.#internals.supervisor.schema.name}`);
1058
- }
1059
-
1060
1135
  get expired() {
1061
1136
  return this.#expired;
1062
1137
  }
@@ -1073,10 +1148,29 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1073
1148
  return this.#internals.owner;
1074
1149
  }
1075
1150
 
1076
- change(mutator: () => void, member: string | number) {
1151
+ get mirrorsRemote() {
1152
+ return this.#internals.mirrorsRemote;
1153
+ }
1154
+
1155
+ owns(container: Val) {
1156
+ return typeof container === "object" && container !== null && this.#owned.has(container);
1157
+ }
1158
+
1159
+ adopt(container: Val) {
1160
+ if (typeof container === "object" && container !== null) {
1161
+ this.#owned.add(container);
1162
+ }
1163
+ }
1164
+
1165
+ assertWritable() {
1077
1166
  if (this.#expired) {
1078
1167
  throw new ExpiredReferenceError(this.location);
1079
1168
  }
1169
+ this.#internals.remoteStore?.assertWritable(this.location.path);
1170
+ }
1171
+
1172
+ change(mutator: () => void, member: string | number) {
1173
+ this.assertWritable();
1080
1174
 
1081
1175
  // Join the transaction
1082
1176
  this.#startWrite();
@@ -1116,17 +1210,19 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1116
1210
  }
1117
1211
 
1118
1212
  // Point subreferences to the clone
1119
- this.#refreshSubrefs();
1213
+ this.#refreshSubrefs("session");
1120
1214
  }
1121
1215
 
1122
- if (this.#internals.mirrorsRemote) {
1123
- this.#mutateRecording(mutator, member);
1124
- } else {
1125
- mutator();
1216
+ // A mutator that throws may already have changed or restored values
1217
+ try {
1218
+ if (this.#internals.mirrorsRemote) {
1219
+ this.#mutateRecording(mutator, member);
1220
+ } else {
1221
+ mutator();
1222
+ }
1223
+ } finally {
1224
+ this.#refreshSubrefs("session");
1126
1225
  }
1127
-
1128
- // Refresh subrefs referencing any mutated values
1129
- this.#refreshSubrefs();
1130
1226
  }
1131
1227
 
1132
1228
  /**
@@ -1214,23 +1310,35 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1214
1310
  }
1215
1311
 
1216
1312
  /**
1217
- * For commit phase one we pass values to the store if present. For a mirror the store is the remote node.
1313
+ * For commit phase one we pass values to the store if present. For the values of a remote node the store is the
1314
+ * remote store, and phase one runs the step the store prepared in {@link settled}.
1218
1315
  */
1219
1316
  commit1() {
1220
1317
  // Staging is per commit: a claim from a cycle the store refused must not be honoured by a later one
1221
1318
  this.#stagedFeaturesKey = false;
1222
1319
  this.#stagedMigration = false;
1223
1320
 
1224
- const stored = this.#computePostCommitChanges();
1321
+ const { store } = this.#internals;
1322
+ if (Datasource.ExternallyMutableStore.is(store)) {
1323
+ const send = this.#send;
1324
+ this.#send = undefined;
1325
+ if (send !== undefined) {
1326
+ return send(this.#session.transaction);
1327
+ }
1328
+ if (this.#proposedValues() !== undefined) {
1329
+ throw new InternalError(
1330
+ `${this} reached commit phase one with values the remote store did not prepare`,
1331
+ );
1332
+ }
1333
+ return;
1334
+ }
1335
+
1336
+ const stored = this.#computeStoredChanges();
1225
1337
  if (!stored) {
1226
1338
  return;
1227
1339
  }
1228
1340
 
1229
- if (
1230
- !this.#internals.mirrorsRemote &&
1231
- this.#internals.featuresKey !== undefined &&
1232
- !this.#internals.featuresKeyPersisted
1233
- ) {
1341
+ if (this.#internals.featuresKey !== undefined && !this.#internals.featuresKeyPersisted) {
1234
1342
  stored[FEATURES_KEY] = this.#internals.featuresKey;
1235
1343
  for (const key of this.#internals.discardedStoreKeys ?? []) {
1236
1344
  if (!(key in stored)) {
@@ -1250,7 +1358,7 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1250
1358
  this.#stagedMigration = true;
1251
1359
  }
1252
1360
 
1253
- return this.#internals.store?.set(this.#session.transaction, stored);
1361
+ return store?.set(this.#session.transaction, stored);
1254
1362
  }
1255
1363
 
1256
1364
  /**
@@ -1259,6 +1367,12 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1259
1367
  commit2() {
1260
1368
  this.#assigned = undefined;
1261
1369
 
1370
+ // The clones become canonical, so the next write must clone them again
1371
+ this.#owned = new WeakSet();
1372
+
1373
+ // The next announcement diffs against the canonical value, which another transaction may change meanwhile
1374
+ this.#precommitValues = undefined;
1375
+
1262
1376
  if (!this.#changes) {
1263
1377
  return;
1264
1378
  }
@@ -1317,12 +1431,14 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1317
1431
  rollback() {
1318
1432
  this.#values = this.#internals.values;
1319
1433
  this.#assigned = undefined;
1434
+ this.#owned = new WeakSet();
1435
+ this.#send = undefined;
1320
1436
 
1321
1437
  // A rolled back value was never adopted, so it must not stand as the baseline the next announcement diffs
1322
1438
  // against
1323
1439
  this.#precommitValues = undefined;
1324
1440
 
1325
- this.#refreshSubrefs();
1441
+ this.#refreshSubrefs("session");
1326
1442
  }
1327
1443
 
1328
1444
  // -- Private helpers --
@@ -1370,11 +1486,11 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1370
1486
  }
1371
1487
  }
1372
1488
 
1373
- #refreshSubrefs() {
1489
+ #refreshSubrefs(cause: ValReference.RefreshCause) {
1374
1490
  const subrefs = this.subrefs;
1375
1491
  if (subrefs) {
1376
1492
  for (const key in subrefs) {
1377
- subrefs[key].refresh();
1493
+ subrefs[key].refresh(cause);
1378
1494
  }
1379
1495
  }
1380
1496
  }
@@ -1403,25 +1519,32 @@ class RootReference implements ValReference<Val.Struct>, Transaction.Participant
1403
1519
  }
1404
1520
 
1405
1521
  /**
1406
- * Compute the local changes of this commit and return the values that go to the store.
1522
+ * The values a session proposes to the remote node whose values the datasource holds, or undefined if none.
1407
1523
  *
1408
- * For a mirror the peer is the only writer of its values, so nothing changes locally. Every member this session
1409
- * assigned goes to the store as a proposal, also an unchanged one: the device decides, not our copy of its state.
1410
- * The store settles what the device accepts.
1524
+ * The remote node is the only writer of its values, so nothing changes locally. Every member this session assigned
1525
+ * goes to the remote node, also an unchanged one: the device decides, not our copy of its state. The store settles
1526
+ * what the device accepts.
1411
1527
  */
1412
- #computePostCommitChanges() {
1413
- this.#changes = undefined;
1414
-
1528
+ #proposedValues() {
1415
1529
  if (this.#internals.values === this.#values) {
1416
1530
  return;
1417
1531
  }
1418
1532
 
1419
- if (this.#internals.mirrorsRemote) {
1420
- let proposed: Val.Struct | undefined;
1421
- for (const name of this.#assigned ?? []) {
1422
- (proposed ??= {})[name] = this.#values[name];
1423
- }
1424
- return proposed;
1533
+ let proposed: Val.Struct | undefined;
1534
+ for (const name of this.#assigned ?? []) {
1535
+ (proposed ??= {})[name] = this.#values[name];
1536
+ }
1537
+ return proposed;
1538
+ }
1539
+
1540
+ /**
1541
+ * Compute the local changes of this commit and return the values that go to the store.
1542
+ */
1543
+ #computeStoredChanges() {
1544
+ this.#changes = undefined;
1545
+
1546
+ if (this.#internals.values === this.#values) {
1547
+ return;
1425
1548
  }
1426
1549
 
1427
1550
  const { storeFields } = this.#internals;
@@ -8,7 +8,8 @@ import type { Val } from "@matter/protocol";
8
8
  import type { ValReference } from "./ValReference.js";
9
9
 
10
10
  /**
11
- * API for bypassing managed collections and accessing the internal object containing raw data.
11
+ * API for bypassing managed collections: access to the internal object containing raw data, and raw copies of
12
+ * incoming values.
12
13
  */
13
14
  export namespace Internal {
14
15
  export const reference = Symbol("reference");
@@ -19,53 +20,62 @@ export namespace Internal {
19
20
  }
20
21
 
21
22
  /**
22
- * Recursively unwrap managed proxies in a value tree, returning raw data.
23
+ * The reference behind a managed value, or `undefined` for any other value.
24
+ */
25
+ export function referenceOf(value: Val): ValReference<Val.Collection> | undefined {
26
+ if (value === null || typeof value !== "object") {
27
+ return undefined;
28
+ }
29
+ return (value as Partial<Collection>)[reference];
30
+ }
31
+
32
+ /**
33
+ * The raw value behind a managed proxy, or `value` itself. Unlike {@link copy}, the result is the stored object,
34
+ * so a list entry reference bound to one of its entries stays live when the value is stored back.
35
+ */
36
+ export function rawOf(value: Val): Val {
37
+ const ref = referenceOf(value);
38
+ return ref ? ref.value : value;
39
+ }
40
+
41
+ /**
42
+ * Copy an incoming value tree into raw data for a manager to store.
23
43
  *
24
- * Primitives, Uint8Array, Date, and other non-plain objects pass through unchanged. Plain
25
- * arrays and plain objects are walked; a new container is only allocated if a child was replaced.
44
+ * A managed proxy is replaced by a copy of its raw value, including the entries of other fabrics. Every array and
45
+ * every plain object is copied, so the stored value shares no array or plain object with the committed state, with
46
+ * another reference or with the caller. A nested write changes a container in place once the transaction owns it,
47
+ * so a shared container would change in both places. A copied object keeps its symbol-keyed properties, such as
48
+ * `BitmapEncodedValue`, with the same values.
49
+ *
50
+ * Primitives, Uint8Array, Date and other class instances pass through unchanged.
26
51
  */
27
- export function unmanage(value: Val): Val {
52
+ export function copy(value: Val): Val {
28
53
  if (value === null || value === undefined || typeof value !== "object") {
29
54
  return value;
30
55
  }
31
56
 
32
- // Unwrap managed proxy to its raw value, then continue walking
33
- const ref = (value as Collection)[reference];
57
+ const ref = referenceOf(value);
34
58
  if (ref) {
35
- return unmanage(ref.value);
59
+ return copy(ref.value);
36
60
  }
37
61
 
38
62
  if (Array.isArray(value)) {
39
- let changed = false;
40
- const result = new Array(value.length);
41
-
42
- for (let i = 0; i < value.length; i++) {
43
- const child = unmanage(value[i]);
44
- if (child !== value[i]) {
45
- changed = true;
46
- }
47
- result[i] = child;
48
- }
49
-
50
- return changed ? result : value;
63
+ return value.map(copy);
51
64
  }
52
65
 
53
66
  const proto = Object.getPrototypeOf(value);
54
- if (proto === Object.prototype || proto === null) {
55
- let changed = false;
56
- const result = {} as Record<string, Val>;
57
-
58
- for (const key in value as Record<string, Val>) {
59
- const child = unmanage((value as Record<string, Val>)[key]);
60
- if (child !== (value as Record<string, Val>)[key]) {
61
- changed = true;
62
- }
63
- result[key] = child;
64
- }
65
-
66
- return changed ? result : value;
67
+ if (proto !== Object.prototype && proto !== null) {
68
+ return value;
67
69
  }
68
70
 
69
- return value;
71
+ const source = value as Val.Struct;
72
+ const result: Val.Struct = {};
73
+ for (const key in source) {
74
+ result[key] = copy(source[key]);
75
+ }
76
+ for (const symbol of Object.getOwnPropertySymbols(source)) {
77
+ Object.defineProperty(result, symbol, Object.getOwnPropertyDescriptor(source, symbol)!);
78
+ }
79
+ return result;
70
80
  }
71
81
  }