@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
@@ -5,11 +5,11 @@
5
5
  */
6
6
  import { AccessControl, Val } from "@matter/protocol";
7
7
  import type { Supervision } from "../../supervision/Supervision.js";
8
- import type { ValReference } from "./ValReference.js";
8
+ import { ValReference } from "./ValReference.js";
9
9
  /**
10
10
  * ManagedReference manages a reference to a container property of another reference.
11
11
  *
12
- * The ManagedReference detects when the value changes and clones the container if it is the original copy.
12
+ * The ManagedReference clones the container on write unless the transaction already owns it.
13
13
  *
14
14
  * This serves the following purposes:
15
15
  *
@@ -19,9 +19,27 @@ import type { ValReference } from "./ValReference.js";
19
19
  *
20
20
  * - Preserves metadata regarding the state of the value
21
21
  *
22
- * Change detection happens automatically if the value is replaced. If a subvalue is replaced, the logic replacing the
23
- * subvalue must update "changed" manually before replacing the subvalue. For managed structures this is handled by a
24
- * separate ManagedReference.
22
+ * A member reference follows whatever container the parent holds at its key. A list entry reference is bound to one
23
+ * entry instead, because an index does not identify an entry (see {@link ManagedReference.Binding}):
24
+ *
25
+ * | State | Cause | {@link value} | Writes |
26
+ * |---------|----------------------------------------------------------|--------------------|-------------------------|
27
+ * | live | the member holds a container | that container | allowed |
28
+ * | default | the member is absent; the reference has a default | the default | `UncachedValueError` |
29
+ * | absent | member absent without default, or container above absent;| `undefined`/`null` | `PhantomReferenceError` |
30
+ * | | for an entry, only after another transaction's commit | | |
31
+ * | expired | the owning context exited, a parent is read-only, or a | last container | `ExpiredReferenceError` |
32
+ * | | change in this session moved, removed or replaced this | | |
33
+ * | | entry | | |
34
+ *
35
+ * A reference to a mandatory member has a default when its parent keys by ID, which only a mirror's root does; see
36
+ * {@link ValReference.PrimaryKey}. A reference makes its default when it enters "default" and serves that same value
37
+ * until it leaves; a read never stores it. A value built from the default and assigned whole is stored like any other
38
+ * assignment and replaces the remote value. A write below a reference in "default" fails the same way. Before the
39
+ * default is checked, a write throws what the datasource's `ExternallyMutableStore.assertWritable` throws. "default"
40
+ * and "absent" return to "live" when the member holds a container again, for example after a report or an assignment.
41
+ * Once a transaction changed the cluster, its root keeps its own copy, so a later report does not reach it. A live
42
+ * member that becomes absent again, for example by a rollback, enters "default" or "absent". "expired" is final.
25
43
  */
26
44
  export declare class ManagedReference implements ValReference {
27
45
  #private;
@@ -34,19 +52,45 @@ export declare class ManagedReference implements ValReference {
34
52
  * @param parent a reference to the container we reference
35
53
  * @param name the name (in the case of structs) or index (in case of lists)
36
54
  * @param id the lookup ID, used when {@link parent} keys its members by ID
37
- * @param assertWriteOk enforces ACLs and read-only
38
- * @param clone clones the container prior to write; undefined if not transactional
55
+ * @param clone clones the container prior to write
39
56
  * @param session the access control session
57
+ * @param binding what the reference stays bound to when the parent changes
58
+ * @param makeDefault makes the default to serve while the member is absent; called once each time the member
59
+ * becomes absent
40
60
  */
41
- constructor(parent: ValReference<Val.Collection>, name: string | number, id: number | undefined, assertWriteOk: (value: Val) => void, clone: (container: Val) => Val, session: AccessControl.Session);
61
+ constructor(parent: ValReference<Val.Collection>, name: string | number, id: number | undefined, clone: (container: Val) => Val, session: AccessControl.Session, binding: ManagedReference.Binding, makeDefault?: () => Val);
42
62
  get rootOwner(): any;
43
- get value(): Val;
44
- set value(newValue: Val);
63
+ get mirrorsRemote(): boolean;
64
+ get value(): unknown;
45
65
  get expired(): boolean;
46
66
  get location(): AccessControl.Location;
47
67
  set location(loc: AccessControl.Location);
48
- get original(): unknown;
68
+ assertWritable(): void;
69
+ /**
70
+ * A container a `Val.properties` provider serves, and every container below it, is never owned, even when the
71
+ * provider serves a container the transaction cloned for another member. The provider keeps the value its setter
72
+ * accepted, so a later change must clone it again instead of changing it in place.
73
+ */
74
+ owns(container: Val): boolean;
75
+ adopt(container: Val): void;
76
+ /**
77
+ * Clones the container unless the transaction {@link owns} it, runs {@link mutator}, then stores the container in
78
+ * the parent. A dynamic provider's setter therefore receives the container after every change, with the change
79
+ * applied.
80
+ */
49
81
  change(mutator: () => void): void;
50
- refresh(): void;
82
+ refresh(cause: ValReference.RefreshCause): void;
83
+ }
84
+ export declare namespace ManagedReference {
85
+ /**
86
+ * What a reference stays bound to when its parent changes.
87
+ *
88
+ * - `member`: the key. A struct member is identified by its name, so the reference follows the container the
89
+ * parent holds there.
90
+ * - `entry`: the entry it was read for, or the entry another transaction's commit put at its index. An index does
91
+ * not identify a list entry: a list method, a length change, an assignment at the index or of the whole list puts
92
+ * another entry there.
93
+ */
94
+ type Binding = "member" | "entry";
51
95
  }
52
96
  //# sourceMappingURL=ManagedReference.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ManagedReference.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/ManagedReference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAyB,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAQpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,YAAW,YAAY;;IACjD,QAAQ,CAAC,UAAU,UAAU;IAC7B,MAAM,+BAAC;IAEP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;IAcvC;;;;;;;OAOG;IACH,YACI,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EACpC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,EACnC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,GAAG,EAC9B,OAAO,EAAE,aAAa,CAAC,OAAO,EAkCjC;IAED,IAAI,SAAS,QAEZ;IAED,IAAI,KAAK,IAMW,GAAG,CAFtB;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,GAAG,EAetB;IAED,IAAI,OAAO,YAEV;IAED,IAAI,QAAQ,IAIM,aAAa,CAAC,QAAQ,CAFvC;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,QAAQ,EAEvC;IAED,IAAI,QAAQ,YAYX;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,QAgBzB;IAED,OAAO,SA0BN;CA4CJ"}
1
+ {"version":3,"file":"ManagedReference.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/ManagedReference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAyB,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AASpE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,gBAAiB,YAAW,YAAY;;IACjD,QAAQ,CAAC,UAAU,UAAU;IAC7B,MAAM,+BAAC;IAEP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;IAkBvC;;;;;;;;;OASG;IACH,YACI,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EACpC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,GAAG,EAC9B,OAAO,EAAE,aAAa,CAAC,OAAO,EAC9B,OAAO,EAAE,gBAAgB,CAAC,OAAO,EACjC,WAAW,CAAC,EAAE,MAAM,GAAG,EAiC1B;IAED,IAAI,SAAS,QAEZ;IAED,IAAI,aAAa,YAEhB;IAED,IAAI,KAAK,YAGR;IAED,IAAI,OAAO,YAEV;IAED,IAAI,QAAQ,IAIM,aAAa,CAAC,QAAQ,CAFvC;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,QAAQ,EAEvC;IAED,cAAc,SAQb;IAED;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,GAAG,WAElB;IAED,KAAK,CAAC,SAAS,EAAE,GAAG,QAEnB;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,QAoBzB;IAED,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,YAAY,QAqBvC;CAgGJ;AAED,yBAAiB,gBAAgB,CAAC;IAC9B;;;;;;;;OAQG;IACH,KAAY,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC5C"}
@@ -23,7 +23,9 @@ __export(ManagedReference_exports, {
23
23
  module.exports = __toCommonJS(ManagedReference_exports);
24
24
  var import_general = require("@matter/general");
25
25
  var import_protocol = require("@matter/protocol");
26
+ var import_errors = require("./errors.js");
26
27
  var import_MemberKeys = require("./MemberKeys.js");
28
+ var import_ValReference = require("./ValReference.js");
27
29
  /**
28
30
  * @license
29
31
  * Copyright 2022-2026 Matter.js Authors
@@ -38,27 +40,34 @@ class ManagedReference {
38
40
  #key;
39
41
  #fallbackKey;
40
42
  #readFallbackKey;
41
- #assertWriteOk;
42
43
  #clone;
44
+ #makeDefault;
45
+ #servesDefault = false;
43
46
  #session;
44
- #expired = false;
45
47
  #location;
46
48
  #value;
47
49
  #dynamicContainer;
48
50
  #dynamicSource;
51
+ #binding;
52
+ #entry;
53
+ #copies;
54
+ #detached = false;
49
55
  /**
50
56
  * @param parent a reference to the container we reference
51
57
  * @param name the name (in the case of structs) or index (in case of lists)
52
58
  * @param id the lookup ID, used when {@link parent} keys its members by ID
53
- * @param assertWriteOk enforces ACLs and read-only
54
- * @param clone clones the container prior to write; undefined if not transactional
59
+ * @param clone clones the container prior to write
55
60
  * @param session the access control session
61
+ * @param binding what the reference stays bound to when the parent changes
62
+ * @param makeDefault makes the default to serve while the member is absent; called once each time the member
63
+ * becomes absent
56
64
  */
57
- constructor(parent, name, id, assertWriteOk, clone, session) {
65
+ constructor(parent, name, id, clone, session, binding, makeDefault) {
58
66
  this.parent = parent;
59
- this.#assertWriteOk = assertWriteOk;
60
67
  this.#clone = clone;
68
+ this.#makeDefault = makeDefault;
61
69
  this.#session = session;
70
+ this.#binding = binding;
62
71
  this.#location = {
63
72
  ...parent.location,
64
73
  path: parent.location.path.at(name)
@@ -70,7 +79,8 @@ class ManagedReference {
70
79
  this.#fallbackKey = fallbackKey;
71
80
  this.#readFallbackKey = readFallbackKey;
72
81
  this.#bindDynamicContainer();
73
- this.#value = this.#dynamicContainer === void 0 ? (0, import_MemberKeys.memberValueOf)(parent.value, key, readFallbackKey) : (0, import_MemberKeys.memberValueOf)(this.#dynamicContainer, key, fallbackKey);
82
+ this.#value = this.#memberValue();
83
+ this.#entry = this.#value;
74
84
  if (parent.supervisionConfig) {
75
85
  this.supervisionConfig = parent.supervisionConfig.readonlyChild(key);
76
86
  }
@@ -82,21 +92,14 @@ class ManagedReference {
82
92
  get rootOwner() {
83
93
  return this.parent.rootOwner;
84
94
  }
95
+ get mirrorsRemote() {
96
+ return this.parent.mirrorsRemote;
97
+ }
85
98
  get value() {
86
99
  return this.#value;
87
100
  }
88
- set value(newValue) {
89
- if (this.#value === newValue) {
90
- return;
91
- }
92
- this.#assertWriteOk(newValue);
93
- this.#replaceValue(newValue);
94
- this.change(() => {
95
- this.#writeTo(this.#dynamicContainer ?? this.parent.value, newValue);
96
- });
97
- }
98
101
  get expired() {
99
- return this.#expired;
102
+ return this.#detached || this.parent.expired;
100
103
  }
101
104
  get location() {
102
105
  return this.#location;
@@ -104,40 +107,54 @@ class ManagedReference {
104
107
  set location(loc) {
105
108
  this.#location = loc;
106
109
  }
107
- get original() {
108
- if (!this.parent.original) {
109
- return void 0;
110
+ assertWritable() {
111
+ if (this.expired) {
112
+ throw new import_protocol.ExpiredReferenceError(this.location);
110
113
  }
111
- if (this.#dynamicContainer !== void 0) {
112
- const origProperties = this.parent.original[import_protocol.Val.properties](
113
- this.parent.rootOwner,
114
- this.#session
115
- );
116
- return (0, import_MemberKeys.memberValueOf)(origProperties, this.#key, this.#fallbackKey);
114
+ this.parent.assertWritable();
115
+ if (this.#servesDefault) {
116
+ throw new import_errors.UncachedValueError(this.location);
117
117
  }
118
- return (0, import_MemberKeys.memberValueOf)(this.parent.original, this.#key, this.#readFallbackKey);
119
118
  }
119
+ /**
120
+ * A container a `Val.properties` provider serves, and every container below it, is never owned, even when the
121
+ * provider serves a container the transaction cloned for another member. The provider keeps the value its setter
122
+ * accepted, so a later change must clone it again instead of changing it in place.
123
+ */
124
+ owns(container) {
125
+ return this.#dynamicContainer === void 0 && this.parent.owns(container);
126
+ }
127
+ adopt(container) {
128
+ this.parent.adopt(container);
129
+ }
130
+ /**
131
+ * Clones the container unless the transaction {@link owns} it, runs {@link mutator}, then stores the container in
132
+ * the parent. A dynamic provider's setter therefore receives the container after every change, with the change
133
+ * applied.
134
+ */
120
135
  change(mutator) {
121
- if (this.#expired) {
122
- throw new import_protocol.ExpiredReferenceError(this.location);
123
- }
136
+ import_ValReference.ValReference.writableContainerOf(this);
124
137
  this.parent.change(() => {
125
- if (this.#clone && this.#value === this.original) {
126
- const newValue = this.#clone(this.#value);
127
- this.#writeTo(this.#dynamicContainer ?? this.parent.value, newValue);
128
- this.#replaceValue(newValue);
138
+ import_ValReference.ValReference.writableContainerOf(this);
139
+ if (!this.owns(this.#value)) {
140
+ const clone = this.#clone(this.#value);
141
+ this.adopt(clone);
142
+ if (this.#binding === "entry" && typeof clone === "object" && clone !== null) {
143
+ (this.#copies ??= /* @__PURE__ */ new WeakSet()).add(clone);
144
+ }
145
+ this.#replaceValue(clone, "session");
129
146
  }
130
147
  mutator();
148
+ this.#writeTo(this.#dynamicContainer ?? this.parent.value, this.#value);
131
149
  }, this.#key);
132
150
  }
133
- refresh() {
134
- if (this.parent.expired) {
135
- this.#expired = true;
151
+ refresh(cause) {
152
+ if (this.expired) {
136
153
  return;
137
154
  }
138
155
  if (this.parent.value === void 0 || this.parent.value === null) {
139
- this.#expired = true;
140
- this.#replaceValue(void 0);
156
+ this.#servesDefault = false;
157
+ this.#follow(void 0, cause);
141
158
  return;
142
159
  }
143
160
  if (this.#dynamicContainer !== void 0 && this.parent.value !== this.#dynamicSource) {
@@ -146,8 +163,51 @@ class ManagedReference {
146
163
  throw new import_general.InternalError(`Value at ${this.location.path} no longer serves ${this.#key}`);
147
164
  }
148
165
  }
166
+ this.#follow(this.#memberValue(), cause);
167
+ }
168
+ #memberValue() {
149
169
  const value = this.#dynamicContainer === void 0 ? (0, import_MemberKeys.memberValueOf)(this.parent.value, this.#key, this.#readFallbackKey) : (0, import_MemberKeys.memberValueOf)(this.#dynamicContainer, this.#key, this.#fallbackKey);
150
- this.#replaceValue(value);
170
+ if (value !== void 0 || this.#makeDefault === void 0) {
171
+ this.#servesDefault = false;
172
+ return value;
173
+ }
174
+ if (!this.#servesDefault) {
175
+ this.#servesDefault = true;
176
+ return this.#makeDefault();
177
+ }
178
+ return this.#value;
179
+ }
180
+ /**
181
+ * Take `value` as the referenced value. An entry reference expires instead when a change in this session put
182
+ * another entry at its index. It accepts its entry and every copy it made of that entry, because only a rollback
183
+ * puts an earlier copy back. After another transaction's commit, an entry reference follows its index like a
184
+ * member reference and binds to the entry now there.
185
+ */
186
+ #follow(value, cause) {
187
+ if (this.#binding === "entry") {
188
+ if (cause === "external") {
189
+ this.#entry = value;
190
+ this.#copies = void 0;
191
+ } else if (!this.#holds(value)) {
192
+ this.#detach();
193
+ return;
194
+ }
195
+ }
196
+ this.#replaceValue(value, cause);
197
+ }
198
+ #holds(value) {
199
+ if (value === this.#entry) {
200
+ return true;
201
+ }
202
+ return typeof value === "object" && value !== null && !!this.#copies?.has(value);
203
+ }
204
+ /**
205
+ * Stop following the entry. The reference keeps its last value and is {@link expired}. It leaves the parent's
206
+ * subrefs, so the next read at its index creates a reference for the entry now there.
207
+ */
208
+ #detach() {
209
+ this.#detached = true;
210
+ delete this.parent.subrefs?.[this.#key];
151
211
  }
152
212
  /**
153
213
  * Bind to the provider the parent serves this member from, if it serves it from one. A provider belongs to the
@@ -172,12 +232,12 @@ class ManagedReference {
172
232
  delete container[this.#fallbackKey];
173
233
  }
174
234
  }
175
- #replaceValue(newValue) {
235
+ #replaceValue(newValue, cause) {
176
236
  this.#value = newValue;
177
237
  const subrefs = this.subrefs;
178
238
  if (subrefs) {
179
239
  for (const key in subrefs) {
180
- subrefs[key].refresh();
240
+ subrefs[key].refresh(cause);
181
241
  }
182
242
  }
183
243
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/behavior/state/managed/ManagedReference.ts"],
4
- "mappings": "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",
4
+ "mappings": "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",
5
5
  "names": []
6
6
  }
@@ -75,7 +75,7 @@ function NameResolver(supervisor, model, name) {
75
75
  return;
76
76
  }
77
77
  return (val) => {
78
- const parent = val?.[import_Internal.Internal.reference]?.parent?.owner;
78
+ const parent = import_Internal.Internal.referenceOf(val)?.parent?.owner;
79
79
  if (parent) {
80
80
  return parentReader(parent);
81
81
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/behavior/state/managed/NameResolver.ts"],
4
- "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,mBAAiE;AAEjE,sBAAyB;AACzB,wBAA8B;AAX9B;AAAA;AAAA;AAAA;AAAA;AAkBO,SAAS,aACZ,YACA,OACA,MAC+B;AAC/B,MAAI,UAAU,QAAW;AACrB;AAAA,EACJ;AAIA,MAAI,KAAK,SAAS,GAAG,GAAG;AACpB,WAAO,qBAAqB,YAAY,OAAO,IAAI;AAAA,EACvD;AAGA,MACI,UAAU,WAAW,UACpB,MAAM,OAAO,UAAa,WAAW,OAAO,QAAQ,MAAM,OAAO,WAAW,OAAO,OAAO,MAAM,IACnG;AACE,QAAI,CAAC,WAAW,YAAY,IAAI,IAAI,GAAG;AACnC;AAAA,IACJ;AACA,WAAO,qBAAqB,aAAa,WAAW,QAAQ,IAAI,CAAC;AAAA,EACrE;AAGA,MAAI,EAAE,iBAAiB,4BAAe,MAAM,sBAAsB,UAAU;AACxE,WAAO,uBAAuB;AAAA,EAClC;AAKA,QAAM,SAAS,WAAW,UAAU,KAAe,EAAE,KAAK,CAAAA,WAASA,OAAM,iBAAiB,IAAI;AAC9F,MAAI,QAAQ;AACR,WAAO,qBAAqB,OAAO,EAAE;AAAA,EACzC;AAGA,SAAO,uBAAuB;AAS9B,WAAS,qBAAqB,IAAa;AACvC,QAAI,OAAO,QAAW;AAClB,aAAO,CAAC,QAAc,MAAqB,IAAI;AAAA,IACnD;AACA,WAAO,CAAC,QAAa;AACjB,YAAM,SAAS;AACf,UAAI,WAAW,UAAa,WAAW,MAAM;AACzC,eAAO;AAAA,MACX;AACA,iBAAO,iCAAc,QAAQ,IAAI,IAAI;AAAA,IACzC;AAAA,EACJ;AAEA,WAAS,aAAa,QAAgBC,OAAkC;AACpE,WAAO,WAAW,UAAU,MAAM,EAAE,KAAK,CAAAD,WAASA,OAAM,iBAAiBC,KAAI,GAAG;AAAA,EACpF;AAKA,WAAS,yBAAyB;AAC9B,UAAM,eAAe,MAAO;AAC5B,QAAI,EAAE,wBAAwB,4BAAe,EAAE,wBAAwB,4BAAe;AAClF;AAAA,IACJ;AAEA,UAAM,eAAe,aAAa,YAAY,cAAc,IAAI;AAChE,QAAI,CAAC,cAAc;AACf;AAAA,IACJ;AAEA,WAAO,CAAC,QAAa;AACjB,YAAM,SAAU,MAA8B,yBAAS,SAAS,GAAG,QAAQ;AAC3E,UAAI,QAAQ;AACR,eAAO,aAAa,MAAwB;AAAA,MAChD;AAAA,IACJ;AAAA,EACJ;AACJ;AAMA,SAAS,qBACL,YACA,OACA,MAC+B;AAC/B,QAAM,WAAW,KAAK,MAAM,GAAG;AAC/B,QAAM,eAAe,aAAa,YAAY,OAAO,SAAS,CAAC,CAAC;AAChE,MAAI,CAAC,cAAc;AACf;AAAA,EACJ;AAEA,QAAM,OAAO,SAAS,MAAM,CAAC;AAC7B,SAAO,CAAC,QAAa;AACjB,QAAI,SAAS,aAAa,GAAG;AAC7B,eAAW,WAAW,MAAM;AACxB,UAAI,WAAW,UAAa,WAAW,MAAM;AACzC,eAAO;AAAA,MACX;AACA,eAAU,SAAwB,OAAO;AAAA,IAC7C;AACA,WAAO;AAAA,EACX;AACJ;",
4
+ "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,mBAAiE;AAEjE,sBAAyB;AACzB,wBAA8B;AAX9B;AAAA;AAAA;AAAA;AAAA;AAkBO,SAAS,aACZ,YACA,OACA,MAC+B;AAC/B,MAAI,UAAU,QAAW;AACrB;AAAA,EACJ;AAIA,MAAI,KAAK,SAAS,GAAG,GAAG;AACpB,WAAO,qBAAqB,YAAY,OAAO,IAAI;AAAA,EACvD;AAGA,MACI,UAAU,WAAW,UACpB,MAAM,OAAO,UAAa,WAAW,OAAO,QAAQ,MAAM,OAAO,WAAW,OAAO,OAAO,MAAM,IACnG;AACE,QAAI,CAAC,WAAW,YAAY,IAAI,IAAI,GAAG;AACnC;AAAA,IACJ;AACA,WAAO,qBAAqB,aAAa,WAAW,QAAQ,IAAI,CAAC;AAAA,EACrE;AAGA,MAAI,EAAE,iBAAiB,4BAAe,MAAM,sBAAsB,UAAU;AACxE,WAAO,uBAAuB;AAAA,EAClC;AAKA,QAAM,SAAS,WAAW,UAAU,KAAe,EAAE,KAAK,CAAAA,WAASA,OAAM,iBAAiB,IAAI;AAC9F,MAAI,QAAQ;AACR,WAAO,qBAAqB,OAAO,EAAE;AAAA,EACzC;AAGA,SAAO,uBAAuB;AAS9B,WAAS,qBAAqB,IAAa;AACvC,QAAI,OAAO,QAAW;AAClB,aAAO,CAAC,QAAc,MAAqB,IAAI;AAAA,IACnD;AACA,WAAO,CAAC,QAAa;AACjB,YAAM,SAAS;AACf,UAAI,WAAW,UAAa,WAAW,MAAM;AACzC,eAAO;AAAA,MACX;AACA,iBAAO,iCAAc,QAAQ,IAAI,IAAI;AAAA,IACzC;AAAA,EACJ;AAEA,WAAS,aAAa,QAAgBC,OAAkC;AACpE,WAAO,WAAW,UAAU,MAAM,EAAE,KAAK,CAAAD,WAASA,OAAM,iBAAiBC,KAAI,GAAG;AAAA,EACpF;AAKA,WAAS,yBAAyB;AAC9B,UAAM,eAAe,MAAO;AAC5B,QAAI,EAAE,wBAAwB,4BAAe,EAAE,wBAAwB,4BAAe;AAClF;AAAA,IACJ;AAEA,UAAM,eAAe,aAAa,YAAY,cAAc,IAAI;AAChE,QAAI,CAAC,cAAc;AACf;AAAA,IACJ;AAEA,WAAO,CAAC,QAAa;AACjB,YAAM,SAAS,yBAAS,YAAY,GAAG,GAAG,QAAQ;AAClD,UAAI,QAAQ;AACR,eAAO,aAAa,MAAwB;AAAA,MAChD;AAAA,IACJ;AAAA,EACJ;AACJ;AAMA,SAAS,qBACL,YACA,OACA,MAC+B;AAC/B,QAAM,WAAW,KAAK,MAAM,GAAG;AAC/B,QAAM,eAAe,aAAa,YAAY,OAAO,SAAS,CAAC,CAAC;AAChE,MAAI,CAAC,cAAc;AACf;AAAA,EACJ;AAEA,QAAM,OAAO,SAAS,MAAM,CAAC;AAC7B,SAAO,CAAC,QAAa;AACjB,QAAI,SAAS,aAAa,GAAG;AAC7B,eAAW,WAAW,MAAM;AACxB,UAAI,WAAW,UAAa,WAAW,MAAM;AACzC,eAAO;AAAA,MACX;AACA,eAAU,SAAwB,OAAO;AAAA,IAC7C;AACA,WAAO;AAAA,EACX;AACJ;",
5
5
  "names": ["model", "name"]
6
6
  }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2022-2026 Matter.js Authors
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { AccessControl, Val } from "@matter/protocol";
7
+ import type { ValReference } from "./ValReference.js";
8
+ /**
9
+ * A read-only reference to a value that has no slot in managed state, such as an entry a list method removed or an
10
+ * entry a sort comparator receives.
11
+ *
12
+ * The reference serves the value it was given, not a copy. A manager over it reads through the same path as over a
13
+ * live reference, with the same authorization and name resolution. The reference counts as expired, so every write
14
+ * through it or through a reference below it throws {@link ExpiredReferenceError}.
15
+ */
16
+ export declare class ReadOnlyReference implements ValReference {
17
+ #private;
18
+ readonly primaryKey = "name";
19
+ readonly expired = true;
20
+ subrefs?: Record<number | string, ValReference>;
21
+ owner?: Val;
22
+ location: AccessControl.Location;
23
+ readonly mirrorsRemote: boolean;
24
+ constructor(value: Val, location: AccessControl.Location, rootOwner: unknown, mirrorsRemote: boolean);
25
+ get value(): unknown;
26
+ get rootOwner(): unknown;
27
+ change(): void;
28
+ assertWritable(): void;
29
+ refresh(): void;
30
+ owns(): boolean;
31
+ adopt(): void;
32
+ }
33
+ //# sourceMappingURL=ReadOnlyReference.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReadOnlyReference.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/ReadOnlyReference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAyB,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,YAAY;;IAClD,QAAQ,CAAC,UAAU,UAAU;IAC7B,QAAQ,CAAC,OAAO,QAAQ;IAExB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IAKjC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC,YAAY,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAKnG;IAED,IAAI,KAAK,YAER;IAED,IAAI,SAAS,YAEZ;IAED,MAAM,SAEL;IAED,cAAc,SAEb;IAED,OAAO,SAAK;IAEZ,IAAI,YAEH;IAED,KAAK,SAAK;CACb"}
@@ -16,31 +16,50 @@ var __copyProps = (to, from, except, desc) => {
16
16
  return to;
17
17
  };
18
18
  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
- var peer_forwarding_exports = {};
20
- __export(peer_forwarding_exports, {
21
- forwardValidationToPeer: () => forwardValidationToPeer
19
+ var ReadOnlyReference_exports = {};
20
+ __export(ReadOnlyReference_exports, {
21
+ ReadOnlyReference: () => ReadOnlyReference
22
22
  });
23
- module.exports = __toCommonJS(peer_forwarding_exports);
24
- var import_general = require("@matter/general");
23
+ module.exports = __toCommonJS(ReadOnlyReference_exports);
25
24
  var import_protocol = require("@matter/protocol");
26
- var import_types = require("@matter/types");
27
25
  /**
28
26
  * @license
29
27
  * Copyright 2022-2026 Matter.js Authors
30
28
  * SPDX-License-Identifier: Apache-2.0
31
29
  */
32
- const logger = import_general.Logger.get("ValueValidator");
33
- function forwardValidationToPeer(session, error) {
34
- if (session.clientPeerContext === void 0) {
30
+ class ReadOnlyReference {
31
+ primaryKey = "name";
32
+ expired = true;
33
+ subrefs;
34
+ owner;
35
+ location;
36
+ #value;
37
+ #rootOwner;
38
+ mirrorsRemote;
39
+ constructor(value, location, rootOwner, mirrorsRemote) {
40
+ this.#value = value;
41
+ this.location = location;
42
+ this.#rootOwner = rootOwner;
43
+ this.mirrorsRemote = mirrorsRemote;
44
+ }
45
+ get value() {
46
+ return this.#value;
47
+ }
48
+ get rootOwner() {
49
+ return this.#rootOwner;
50
+ }
51
+ change() {
52
+ throw new import_protocol.ExpiredReferenceError(this.location);
53
+ }
54
+ assertWritable() {
55
+ throw new import_protocol.ExpiredReferenceError(this.location);
56
+ }
57
+ refresh() {
58
+ }
59
+ owns() {
35
60
  return false;
36
61
  }
37
- if (error instanceof import_protocol.ConformanceError || error instanceof import_protocol.UnknownEnumValueError || error instanceof import_protocol.DatatypeError && error.code === import_types.Status.ConstraintError) {
38
- logger.debug(
39
- "Accepting non-conformant peer data; the device is responsible for it:",
40
- import_general.Diagnostic.errorMessage(error)
41
- );
42
- return true;
62
+ adopt() {
43
63
  }
44
- return false;
45
64
  }
46
- //# sourceMappingURL=peer-forwarding.js.map
65
+ //# sourceMappingURL=ReadOnlyReference.js.map
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../src/behavior/state/managed/ReadOnlyReference.ts"],
4
+ "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAA0D;AAN1D;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,kBAA0C;AAAA,EAC1C,aAAa;AAAA,EACb,UAAU;AAAA,EAEnB;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAES;AAAA,EAET,YAAY,OAAY,UAAkC,WAAoB,eAAwB;AAClG,SAAK,SAAS;AACd,SAAK,WAAW;AAChB,SAAK,aAAa;AAClB,SAAK,gBAAgB;AAAA,EACzB;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,YAAY;AACZ,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,SAAS;AACL,UAAM,IAAI,sCAAsB,KAAK,QAAQ;AAAA,EACjD;AAAA,EAEA,iBAAiB;AACb,UAAM,IAAI,sCAAsB,KAAK,QAAQ;AAAA,EACjD;AAAA,EAEA,UAAU;AAAA,EAAC;AAAA,EAEX,OAAO;AACH,WAAO;AAAA,EACX;AAAA,EAEA,QAAQ;AAAA,EAAC;AACb;",
5
+ "names": []
6
+ }
@@ -12,15 +12,17 @@ import type { Supervision } from "../../supervision/Supervision.js";
12
12
  */
13
13
  export interface ValReference<T extends Val = Val> {
14
14
  /**
15
- * The current value of the referenced property. Cleared when the reference is no longer functional.
15
+ * The current value of the referenced property. While the property is absent, a reference with a default for it
16
+ * serves that default, and any other reference serves `undefined` or `null`. A reference below a container that
17
+ * is absent without a default serves `undefined` or `null` too. An expired nested reference keeps the last
18
+ * container it saw, which a live reference to the same entry may still change. The root reference throws
19
+ * {@link ExpiredReferenceError} after its owning context exits.
16
20
  */
17
- value: T;
21
+ readonly value: T | undefined | null;
18
22
  /**
19
- * The current canonical value of the referenced property.
20
- */
21
- readonly original: T;
22
- /**
23
- * When true, the reference is no longer usable because the owning context has exited.
23
+ * When true, the reference no longer tracks live state: the owning context has exited, a change in this session
24
+ * moved, removed or replaced the list entry it was read for, or the reference is a read-only view. Final, and true
25
+ * for every reference below an expired one.
24
26
  */
25
27
  readonly expired: boolean;
26
28
  /**
@@ -32,9 +34,10 @@ export interface ValReference<T extends Val = Val> {
32
34
  */
33
35
  subrefs?: Record<number | string, ValReference>;
34
36
  /**
35
- * Mutates data. Clones the container and updates metadata when called on an unmodified transactional reference.
37
+ * Mutates data. A nested reference first clones its container unless the transaction {@link owns} it.
36
38
  *
37
- * Then runs the specified mutator to make the actual changes.
39
+ * Then runs the specified mutator to make the actual changes. A nested reference then stores the changed
40
+ * container in its parent, so the mutator changes state only through this reference or references below it.
38
41
  *
39
42
  * @param mutator the mutation logic, may freely modify {@link value}
40
43
  * @param member the key of the member of {@link value} the mutation assigns. The root reference records it as
@@ -44,8 +47,34 @@ export interface ValReference<T extends Val = Val> {
44
47
  change(mutator: () => void, member: string | number): void;
45
48
  /**
46
49
  * Refresh any internal cache from the referenced container.
50
+ *
51
+ * @param cause what changed the container, which decides whether a list entry reference follows its index (see
52
+ * `ManagedReference.Binding`)
53
+ */
54
+ refresh(cause: ValReference.RefreshCause): void;
55
+ /**
56
+ * Throw the error a change through this reference fails with. Does not check whether the member is absent;
57
+ * {@link ValReference.containerOf} does. A change asks before it is applied and before it joins the transaction.
58
+ * The access check, list bounds checks and the validation of a new list entry run before this; validation of a
59
+ * value assigned to a struct member runs after it. The Remote API `add` asks before the access check.
60
+ *
61
+ * Checks in this order, so the first refusal wins: {@link expired}, then the datasource, then a default served by
62
+ * this reference or one above it.
63
+ *
64
+ * @throws ExpiredReferenceError when the reference is {@link expired}, naming the location of this reference
65
+ * @throws what the datasource's `ExternallyMutableStore.assertWritable` throws
66
+ * @throws UncachedValueError when this reference, or one above it, serves the default of an absent member
47
67
  */
48
- refresh(): void;
68
+ assertWritable(): void;
69
+ /**
70
+ * Whether the transaction cloned {@link container} since its last commit or rollback. A nested write may change
71
+ * an owned container in place; any other container may be shared with committed state.
72
+ */
73
+ owns(container: Val): boolean;
74
+ /**
75
+ * Record {@link container}, a clone this transaction made, as owned until the transaction commits or rolls back.
76
+ */
77
+ adopt(container: Val): void;
49
78
  /**
50
79
  * How this container keys its own members. Only a datasource root may key by element ID; every nested container
51
80
  * keys by property name (list entries, by index).
@@ -59,6 +88,10 @@ export interface ValReference<T extends Val = Val> {
59
88
  * The object that owns the root managed value.
60
89
  */
61
90
  rootOwner?: any;
91
+ /**
92
+ * Whether the root datasource holds a copy of a remote node's values.
93
+ */
94
+ readonly mirrorsRemote: boolean;
62
95
  /**
63
96
  * The parent of this reference, if any.
64
97
  */
@@ -69,13 +102,47 @@ export interface ValReference<T extends Val = Val> {
69
102
  supervisionConfig?: Supervision.Config;
70
103
  }
71
104
  export declare namespace ValReference {
105
+ /**
106
+ * What changed a container before a refresh.
107
+ *
108
+ * - `session`: a change or rollback in the session that holds the reference.
109
+ * - `external`: another transaction committed, and the session has not written since.
110
+ */
111
+ type RefreshCause = "session" | "external";
72
112
  /**
73
113
  * How a container keys its own members.
74
114
  *
75
- * `id` also asserts provenance: only a datasource mirroring a peer keys by element ID, and for such a container
76
- * the peer's reports are the only source of values — no locally derived value (state-class field initializer,
77
- * configured default or computed schema default) may enter it or be synthesized on read.
115
+ * `id` also asserts provenance: only a datasource mirroring a peer keys by element ID, and such a container stores
116
+ * only values the peer reported or that are being written to it — no locally derived value (state-class field
117
+ * initializer, configured default or computed schema default) may enter it. A mandatory member the container
118
+ * does not hold reads as its default, which is never stored; see `ManagedReference`.
78
119
  */
79
120
  type PrimaryKey = "id" | "name";
121
+ /**
122
+ * The container {@link reference} points to, for a manager that reads its members. A nested reference whose
123
+ * owning context exited still serves the last container it saw.
124
+ *
125
+ * @throws PhantomReferenceError when the property, or a container above it, is absent
126
+ * @throws ExpiredReferenceError when the container is absent and the reference is expired, or when
127
+ * {@link reference} is a root reference whose owning context has exited
128
+ */
129
+ function containerOf<T extends Val>(reference: ValReference<T>): NonNullable<T>;
130
+ /**
131
+ * The container {@link reference} points to, for a manager that writes its members.
132
+ *
133
+ * @throws ExpiredReferenceError when the reference is {@link ValReference.expired}, whether or not the container is
134
+ * present
135
+ * @throws PhantomReferenceError when the property, or a container above it, is absent
136
+ * @throws any error {@link ValReference.assertWritable} throws
137
+ */
138
+ function writableContainerOf<T extends Val>(reference: ValReference<T>): NonNullable<T>;
139
+ /**
140
+ * Assert that {@link value} may be changed. Use it before a value built from {@link value}, such as a list with
141
+ * one more entry, replaces it: {@link value} may be a default that the datasource does not hold, and the new value
142
+ * would then replace the remote value. Returns for a value that is not managed.
143
+ *
144
+ * @throws any error {@link ValReference.assertWritable} throws for the reference behind {@link value}
145
+ */
146
+ function assertWritableValue(value: Val): void;
80
147
  }
81
148
  //# sourceMappingURL=ValReference.d.ts.map