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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (618) hide show
  1. package/dist/cjs/behavior/Behavior.d.ts.map +1 -1
  2. package/dist/cjs/behavior/Behavior.js +2 -0
  3. package/dist/cjs/behavior/Behavior.js.map +1 -1
  4. package/dist/cjs/behavior/Events.d.ts.map +1 -1
  5. package/dist/cjs/behavior/Events.js +4 -2
  6. package/dist/cjs/behavior/Events.js.map +1 -1
  7. package/dist/cjs/behavior/cluster/ClusterBehavior.d.ts +17 -3
  8. package/dist/cjs/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
  9. package/dist/cjs/behavior/cluster/ClusterBehavior.js +2 -20
  10. package/dist/cjs/behavior/cluster/ClusterBehavior.js.map +1 -1
  11. package/dist/cjs/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
  12. package/dist/cjs/behavior/cluster/ClusterBehaviorType.js +8 -150
  13. package/dist/cjs/behavior/cluster/ClusterBehaviorType.js.map +1 -1
  14. package/dist/cjs/behavior/context/server/LocalActorContext.d.ts +1 -1
  15. package/dist/cjs/behavior/context/server/LocalActorContext.d.ts.map +1 -1
  16. package/dist/cjs/behavior/internal/BehaviorBacking.d.ts +2 -2
  17. package/dist/cjs/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  18. package/dist/cjs/behavior/internal/BehaviorBacking.js +2 -0
  19. package/dist/cjs/behavior/internal/BehaviorBacking.js.map +1 -1
  20. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts +45 -0
  21. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  22. package/dist/cjs/behavior/internal/ClusterDerivation.js +192 -0
  23. package/dist/cjs/behavior/internal/ClusterDerivation.js.map +6 -0
  24. package/dist/cjs/behavior/internal/ClusterStatics.d.ts +16 -0
  25. package/dist/cjs/behavior/internal/ClusterStatics.d.ts.map +1 -0
  26. package/dist/cjs/behavior/internal/ClusterStatics.js +138 -0
  27. package/dist/cjs/behavior/internal/ClusterStatics.js.map +6 -0
  28. package/dist/cjs/behavior/internal/ModeledState.d.ts +18 -0
  29. package/dist/cjs/behavior/internal/ModeledState.d.ts.map +1 -0
  30. package/dist/cjs/behavior/internal/ModeledState.js +54 -0
  31. package/dist/cjs/behavior/internal/ModeledState.js.map +6 -0
  32. package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts +1 -1
  33. package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  34. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js +3 -12
  35. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  36. package/dist/cjs/behavior/state/managed/Datasource.d.ts +54 -10
  37. package/dist/cjs/behavior/state/managed/Datasource.d.ts.map +1 -1
  38. package/dist/cjs/behavior/state/managed/Datasource.js +107 -38
  39. package/dist/cjs/behavior/state/managed/Datasource.js.map +1 -1
  40. package/dist/cjs/behavior/state/managed/Internal.d.ts +20 -5
  41. package/dist/cjs/behavior/state/managed/Internal.d.ts.map +1 -1
  42. package/dist/cjs/behavior/state/managed/Internal.js +28 -26
  43. package/dist/cjs/behavior/state/managed/Internal.js.map +1 -1
  44. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts +56 -12
  45. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  46. package/dist/cjs/behavior/state/managed/ManagedReference.js +103 -43
  47. package/dist/cjs/behavior/state/managed/ManagedReference.js.map +1 -1
  48. package/dist/cjs/behavior/state/managed/NameResolver.js +1 -1
  49. package/dist/cjs/behavior/state/managed/NameResolver.js.map +1 -1
  50. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts +33 -0
  51. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  52. package/dist/cjs/behavior/state/{validation/peer-forwarding.js → managed/ReadOnlyReference.js} +36 -17
  53. package/dist/cjs/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  54. package/dist/cjs/behavior/state/managed/ValReference.d.ts +80 -13
  55. package/dist/cjs/behavior/state/managed/ValReference.d.ts.map +1 -1
  56. package/dist/cjs/behavior/state/managed/ValReference.js +32 -0
  57. package/dist/cjs/behavior/state/managed/ValReference.js.map +2 -2
  58. package/dist/cjs/behavior/state/managed/errors.d.ts +25 -0
  59. package/dist/cjs/behavior/state/managed/errors.d.ts.map +1 -0
  60. package/dist/cjs/behavior/state/{validation/FabricIndexSentinel.js → managed/errors.js} +15 -10
  61. package/dist/cjs/behavior/state/managed/errors.js.map +6 -0
  62. package/dist/cjs/behavior/state/managed/index.d.ts +1 -0
  63. package/dist/cjs/behavior/state/managed/index.d.ts.map +1 -1
  64. package/dist/cjs/behavior/state/managed/index.js +1 -0
  65. package/dist/cjs/behavior/state/managed/index.js.map +1 -1
  66. package/dist/cjs/behavior/state/managed/values/BitmapManager.js +5 -20
  67. package/dist/cjs/behavior/state/managed/values/BitmapManager.js.map +1 -1
  68. package/dist/cjs/behavior/state/managed/values/ListManager.d.ts +0 -5
  69. package/dist/cjs/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  70. package/dist/cjs/behavior/state/managed/values/ListManager.js +274 -133
  71. package/dist/cjs/behavior/state/managed/values/ListManager.js.map +2 -2
  72. package/dist/cjs/behavior/state/managed/values/StructManager.d.ts.map +1 -1
  73. package/dist/cjs/behavior/state/managed/values/StructManager.js +30 -35
  74. package/dist/cjs/behavior/state/managed/values/StructManager.js.map +2 -2
  75. package/dist/cjs/behavior/state/managed/values/ValuePatcher.d.ts +8 -0
  76. package/dist/cjs/behavior/state/managed/values/ValuePatcher.d.ts.map +1 -1
  77. package/dist/cjs/behavior/state/managed/values/ValuePatcher.js +13 -2
  78. package/dist/cjs/behavior/state/managed/values/ValuePatcher.js.map +1 -1
  79. package/dist/cjs/behavior/state/validation/FabricIndexField.d.ts +30 -0
  80. package/dist/cjs/behavior/state/validation/FabricIndexField.d.ts.map +1 -0
  81. package/dist/cjs/behavior/state/validation/FabricIndexField.js +53 -0
  82. package/dist/cjs/behavior/state/validation/FabricIndexField.js.map +6 -0
  83. package/dist/cjs/behavior/state/validation/ValueValidator.d.ts.map +1 -1
  84. package/dist/cjs/behavior/state/validation/ValueValidator.js +16 -36
  85. package/dist/cjs/behavior/state/validation/ValueValidator.js.map +1 -1
  86. package/dist/cjs/behavior/state/validation/conformance.d.ts.map +1 -1
  87. package/dist/cjs/behavior/state/validation/conformance.js +6 -5
  88. package/dist/cjs/behavior/state/validation/conformance.js.map +1 -1
  89. package/dist/cjs/behavior/state/validation/constraint.d.ts.map +1 -1
  90. package/dist/cjs/behavior/state/validation/constraint.js +3 -1
  91. package/dist/cjs/behavior/state/validation/constraint.js.map +1 -1
  92. package/dist/cjs/behavior/state/validation/location.d.ts +6 -0
  93. package/dist/cjs/behavior/state/validation/location.d.ts.map +1 -1
  94. package/dist/cjs/behavior/state/validation/remote-validation.d.ts +57 -0
  95. package/dist/cjs/behavior/state/validation/remote-validation.d.ts.map +1 -0
  96. package/dist/cjs/behavior/state/validation/remote-validation.js +63 -0
  97. package/dist/cjs/behavior/state/validation/remote-validation.js.map +6 -0
  98. package/dist/cjs/behavior/supervision/Supervision.d.ts.map +1 -1
  99. package/dist/cjs/behavior/supervision/Supervision.js +1 -1
  100. package/dist/cjs/behavior/supervision/Supervision.js.map +1 -1
  101. package/dist/cjs/behavior/supervision/SupervisionConfig.d.ts.map +1 -1
  102. package/dist/cjs/behavior/supervision/SupervisionConfig.js +1 -1
  103. package/dist/cjs/behavior/supervision/SupervisionConfig.js.map +1 -1
  104. package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts +3 -12
  105. package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
  106. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts +57 -6
  107. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  108. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js +86 -0
  109. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  110. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  111. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  112. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js +9 -0
  113. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  114. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  115. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  116. package/dist/cjs/behavior/system/controller/ControllerBehavior.js +2 -1
  117. package/dist/cjs/behavior/system/controller/ControllerBehavior.js.map +1 -1
  118. package/dist/cjs/behavior/system/dcl/DclBehavior.d.ts +3 -3
  119. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  120. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  121. package/dist/cjs/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  122. package/dist/cjs/behavior/system/remote/api/ApiResource.d.ts +14 -0
  123. package/dist/cjs/behavior/system/remote/api/ApiResource.d.ts.map +1 -1
  124. package/dist/cjs/behavior/system/remote/api/ApiResource.js +19 -0
  125. package/dist/cjs/behavior/system/remote/api/ApiResource.js.map +1 -1
  126. package/dist/cjs/behavior/system/remote/api/Envelope.d.ts +4 -2
  127. package/dist/cjs/behavior/system/remote/api/Envelope.d.ts.map +1 -1
  128. package/dist/cjs/behavior/system/remote/api/Envelope.js +7 -5
  129. package/dist/cjs/behavior/system/remote/api/Envelope.js.map +1 -1
  130. package/dist/cjs/behavior/system/remote/api/resources/CommandResource.js +2 -2
  131. package/dist/cjs/behavior/system/remote/api/resources/CommandResource.js.map +1 -1
  132. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.d.ts +1 -0
  133. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.d.ts.map +1 -1
  134. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.js +3 -0
  135. package/dist/cjs/behavior/system/remote/api/resources/NodeResource.js.map +1 -1
  136. package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.d.ts.map +1 -1
  137. package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.js +5 -3
  138. package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.js.map +1 -1
  139. package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.d.ts.map +1 -1
  140. package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.js +2 -11
  141. package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.js.map +1 -1
  142. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  143. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  144. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js +6 -1
  145. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  146. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  147. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  148. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js +74 -0
  149. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  150. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  151. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  152. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  153. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  154. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts +2 -2
  155. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  156. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  157. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  158. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  159. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  160. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  161. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +104 -60
  162. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  163. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  164. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  165. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  166. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  167. package/dist/cjs/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  168. package/dist/cjs/behaviors/groupcast/GroupcastServer.js +41 -25
  169. package/dist/cjs/behaviors/groupcast/GroupcastServer.js.map +2 -2
  170. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  171. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  172. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.js +15 -4
  173. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.js.map +2 -2
  174. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  175. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  176. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js +27 -23
  177. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  178. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  179. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  180. package/dist/cjs/behaviors/thermostat/ThermostatServer.js +66 -49
  181. package/dist/cjs/behaviors/thermostat/ThermostatServer.js.map +1 -1
  182. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  183. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  184. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js +19 -5
  185. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +2 -2
  186. package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.d.ts.map +1 -1
  187. package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.js +13 -3
  188. package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.js.map +1 -1
  189. package/dist/cjs/endpoint/Endpoint.d.ts +5 -9
  190. package/dist/cjs/endpoint/Endpoint.d.ts.map +1 -1
  191. package/dist/cjs/endpoint/Endpoint.js +4 -23
  192. package/dist/cjs/endpoint/Endpoint.js.map +1 -1
  193. package/dist/cjs/endpoint/properties/Behaviors.d.ts.map +1 -1
  194. package/dist/cjs/endpoint/properties/Behaviors.js +5 -1
  195. package/dist/cjs/endpoint/properties/Behaviors.js.map +1 -1
  196. package/dist/cjs/node/ClientNode.d.ts +25 -0
  197. package/dist/cjs/node/ClientNode.d.ts.map +1 -1
  198. package/dist/cjs/node/ClientNode.js +41 -0
  199. package/dist/cjs/node/ClientNode.js.map +1 -1
  200. package/dist/cjs/node/ServerNode.d.ts.map +1 -1
  201. package/dist/cjs/node/ServerNode.js +2 -0
  202. package/dist/cjs/node/ServerNode.js.map +1 -1
  203. package/dist/cjs/node/client/ClientCommandMethod.d.ts.map +1 -1
  204. package/dist/cjs/node/client/ClientCommandMethod.js +3 -15
  205. package/dist/cjs/node/client/ClientCommandMethod.js.map +1 -1
  206. package/dist/cjs/node/client/ClientEventEmitter.d.ts.map +1 -1
  207. package/dist/cjs/node/client/ClientEventEmitter.js +6 -2
  208. package/dist/cjs/node/client/ClientEventEmitter.js.map +1 -1
  209. package/dist/cjs/node/client/ClientStructure.d.ts.map +1 -1
  210. package/dist/cjs/node/client/ClientStructure.js +181 -108
  211. package/dist/cjs/node/client/ClientStructure.js.map +2 -2
  212. package/dist/cjs/node/client/Peers.d.ts +18 -6
  213. package/dist/cjs/node/client/Peers.d.ts.map +1 -1
  214. package/dist/cjs/node/client/Peers.js +29 -13
  215. package/dist/cjs/node/client/Peers.js.map +1 -1
  216. package/dist/cjs/node/integration/ChangeNotificationService.d.ts +14 -3
  217. package/dist/cjs/node/integration/ChangeNotificationService.d.ts.map +1 -1
  218. package/dist/cjs/node/integration/ProtocolService.d.ts.map +1 -1
  219. package/dist/cjs/node/integration/ProtocolService.js +38 -56
  220. package/dist/cjs/node/integration/ProtocolService.js.map +1 -1
  221. package/dist/cjs/node/server/InteractionServer.d.ts.map +1 -1
  222. package/dist/cjs/node/server/InteractionServer.js +28 -24
  223. package/dist/cjs/node/server/InteractionServer.js.map +2 -2
  224. package/dist/cjs/node/server/ServerSubscription.d.ts +7 -2
  225. package/dist/cjs/node/server/ServerSubscription.d.ts.map +1 -1
  226. package/dist/cjs/node/server/ServerSubscription.js +83 -47
  227. package/dist/cjs/node/server/ServerSubscription.js.map +1 -1
  228. package/dist/cjs/storage/EndpointStore.d.ts +1 -1
  229. package/dist/cjs/storage/EndpointStore.js +1 -1
  230. package/dist/cjs/storage/client/ClientEndpointStore.d.ts +2 -2
  231. package/dist/cjs/storage/client/ClientEndpointStore.d.ts.map +1 -1
  232. package/dist/cjs/storage/client/ClientEndpointStore.js +1 -1
  233. package/dist/cjs/storage/client/DatasourceCache.d.ts +5 -3
  234. package/dist/cjs/storage/client/DatasourceCache.d.ts.map +1 -1
  235. package/dist/cjs/storage/client/DatasourceCache.js +68 -71
  236. package/dist/cjs/storage/client/DatasourceCache.js.map +1 -1
  237. package/dist/cjs/storage/client/FabricScopedListWrite.d.ts +73 -0
  238. package/dist/cjs/storage/client/FabricScopedListWrite.d.ts.map +1 -0
  239. package/dist/cjs/storage/client/FabricScopedListWrite.js +168 -0
  240. package/dist/cjs/storage/client/FabricScopedListWrite.js.map +6 -0
  241. package/dist/cjs/storage/client/RemoteWriteParticipant.d.ts +9 -6
  242. package/dist/cjs/storage/client/RemoteWriteParticipant.d.ts.map +1 -1
  243. package/dist/cjs/storage/client/RemoteWriteParticipant.js +11 -15
  244. package/dist/cjs/storage/client/RemoteWriteParticipant.js.map +1 -1
  245. package/dist/cjs/storage/client/RemoteWriter.d.ts +67 -7
  246. package/dist/cjs/storage/client/RemoteWriter.d.ts.map +1 -1
  247. package/dist/cjs/storage/client/RemoteWriter.js +61 -13
  248. package/dist/cjs/storage/client/RemoteWriter.js.map +1 -1
  249. package/dist/cjs/storage/server/DatasourceStore.d.ts +2 -2
  250. package/dist/cjs/storage/server/DatasourceStore.d.ts.map +1 -1
  251. package/dist/cjs/storage/server/DatasourceStore.js.map +1 -1
  252. package/dist/cjs/storage/server/ServerEndpointStore.d.ts +2 -2
  253. package/dist/cjs/storage/server/ServerEndpointStore.d.ts.map +1 -1
  254. package/dist/cjs/storage/server/ServerEndpointStore.js +1 -1
  255. package/dist/cjs/testing/mock-server-node.d.ts +2 -1
  256. package/dist/cjs/testing/mock-server-node.d.ts.map +1 -1
  257. package/dist/cjs/testing/mock-server-node.js +8 -5
  258. package/dist/cjs/testing/mock-server-node.js.map +2 -2
  259. package/dist/cjs/testing/node-helpers.d.ts +5 -0
  260. package/dist/cjs/testing/node-helpers.d.ts.map +1 -1
  261. package/dist/cjs/testing/node-helpers.js +4 -4
  262. package/dist/cjs/testing/node-helpers.js.map +1 -1
  263. package/dist/esm/behavior/Behavior.d.ts.map +1 -1
  264. package/dist/esm/behavior/Behavior.js +2 -0
  265. package/dist/esm/behavior/Behavior.js.map +1 -1
  266. package/dist/esm/behavior/Events.d.ts.map +1 -1
  267. package/dist/esm/behavior/Events.js +4 -2
  268. package/dist/esm/behavior/Events.js.map +1 -1
  269. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts +17 -3
  270. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
  271. package/dist/esm/behavior/cluster/ClusterBehavior.js +2 -20
  272. package/dist/esm/behavior/cluster/ClusterBehavior.js.map +1 -1
  273. package/dist/esm/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
  274. package/dist/esm/behavior/cluster/ClusterBehaviorType.js +10 -159
  275. package/dist/esm/behavior/cluster/ClusterBehaviorType.js.map +1 -1
  276. package/dist/esm/behavior/context/server/LocalActorContext.d.ts +1 -1
  277. package/dist/esm/behavior/context/server/LocalActorContext.d.ts.map +1 -1
  278. package/dist/esm/behavior/internal/BehaviorBacking.d.ts +2 -2
  279. package/dist/esm/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  280. package/dist/esm/behavior/internal/BehaviorBacking.js +2 -0
  281. package/dist/esm/behavior/internal/BehaviorBacking.js.map +1 -1
  282. package/dist/esm/behavior/internal/ClusterDerivation.d.ts +45 -0
  283. package/dist/esm/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  284. package/dist/esm/behavior/internal/ClusterDerivation.js +172 -0
  285. package/dist/esm/behavior/internal/ClusterDerivation.js.map +6 -0
  286. package/dist/esm/behavior/internal/ClusterStatics.d.ts +16 -0
  287. package/dist/esm/behavior/internal/ClusterStatics.d.ts.map +1 -0
  288. package/dist/esm/behavior/internal/ClusterStatics.js +118 -0
  289. package/dist/esm/behavior/internal/ClusterStatics.js.map +6 -0
  290. package/dist/esm/behavior/internal/ModeledState.d.ts +18 -0
  291. package/dist/esm/behavior/internal/ModeledState.d.ts.map +1 -0
  292. package/dist/esm/behavior/internal/ModeledState.js +34 -0
  293. package/dist/esm/behavior/internal/ModeledState.js.map +6 -0
  294. package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts +1 -1
  295. package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  296. package/dist/esm/behavior/internal/ServerBehaviorBacking.js +3 -12
  297. package/dist/esm/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  298. package/dist/esm/behavior/state/managed/Datasource.d.ts +54 -10
  299. package/dist/esm/behavior/state/managed/Datasource.d.ts.map +1 -1
  300. package/dist/esm/behavior/state/managed/Datasource.js +107 -38
  301. package/dist/esm/behavior/state/managed/Datasource.js.map +1 -1
  302. package/dist/esm/behavior/state/managed/Internal.d.ts +20 -5
  303. package/dist/esm/behavior/state/managed/Internal.d.ts.map +1 -1
  304. package/dist/esm/behavior/state/managed/Internal.js +28 -26
  305. package/dist/esm/behavior/state/managed/Internal.js.map +1 -1
  306. package/dist/esm/behavior/state/managed/ManagedReference.d.ts +56 -12
  307. package/dist/esm/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  308. package/dist/esm/behavior/state/managed/ManagedReference.js +103 -43
  309. package/dist/esm/behavior/state/managed/ManagedReference.js.map +1 -1
  310. package/dist/esm/behavior/state/managed/NameResolver.js +1 -1
  311. package/dist/esm/behavior/state/managed/NameResolver.js.map +1 -1
  312. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts +33 -0
  313. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  314. package/dist/esm/behavior/state/managed/ReadOnlyReference.js +45 -0
  315. package/dist/esm/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  316. package/dist/esm/behavior/state/managed/ValReference.d.ts +80 -13
  317. package/dist/esm/behavior/state/managed/ValReference.d.ts.map +1 -1
  318. package/dist/esm/behavior/state/managed/ValReference.js +28 -0
  319. package/dist/esm/behavior/state/managed/ValReference.js.map +2 -2
  320. package/dist/esm/behavior/state/managed/errors.d.ts +25 -0
  321. package/dist/esm/behavior/state/managed/errors.d.ts.map +1 -0
  322. package/dist/esm/behavior/state/managed/errors.js +20 -0
  323. package/dist/esm/behavior/state/managed/errors.js.map +6 -0
  324. package/dist/esm/behavior/state/managed/index.d.ts +1 -0
  325. package/dist/esm/behavior/state/managed/index.d.ts.map +1 -1
  326. package/dist/esm/behavior/state/managed/index.js +1 -0
  327. package/dist/esm/behavior/state/managed/index.js.map +1 -1
  328. package/dist/esm/behavior/state/managed/values/BitmapManager.js +6 -21
  329. package/dist/esm/behavior/state/managed/values/BitmapManager.js.map +1 -1
  330. package/dist/esm/behavior/state/managed/values/ListManager.d.ts +0 -5
  331. package/dist/esm/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  332. package/dist/esm/behavior/state/managed/values/ListManager.js +277 -144
  333. package/dist/esm/behavior/state/managed/values/ListManager.js.map +2 -2
  334. package/dist/esm/behavior/state/managed/values/StructManager.d.ts.map +1 -1
  335. package/dist/esm/behavior/state/managed/values/StructManager.js +31 -36
  336. package/dist/esm/behavior/state/managed/values/StructManager.js.map +2 -2
  337. package/dist/esm/behavior/state/managed/values/ValuePatcher.d.ts +8 -0
  338. package/dist/esm/behavior/state/managed/values/ValuePatcher.d.ts.map +1 -1
  339. package/dist/esm/behavior/state/managed/values/ValuePatcher.js +13 -2
  340. package/dist/esm/behavior/state/managed/values/ValuePatcher.js.map +1 -1
  341. package/dist/esm/behavior/state/validation/FabricIndexField.d.ts +30 -0
  342. package/dist/esm/behavior/state/validation/FabricIndexField.d.ts.map +1 -0
  343. package/dist/esm/behavior/state/validation/FabricIndexField.js +33 -0
  344. package/dist/esm/behavior/state/validation/FabricIndexField.js.map +6 -0
  345. package/dist/esm/behavior/state/validation/ValueValidator.d.ts.map +1 -1
  346. package/dist/esm/behavior/state/validation/ValueValidator.js +17 -37
  347. package/dist/esm/behavior/state/validation/ValueValidator.js.map +1 -1
  348. package/dist/esm/behavior/state/validation/conformance.d.ts.map +1 -1
  349. package/dist/esm/behavior/state/validation/conformance.js +6 -5
  350. package/dist/esm/behavior/state/validation/conformance.js.map +1 -1
  351. package/dist/esm/behavior/state/validation/constraint.d.ts.map +1 -1
  352. package/dist/esm/behavior/state/validation/constraint.js +3 -1
  353. package/dist/esm/behavior/state/validation/constraint.js.map +1 -1
  354. package/dist/esm/behavior/state/validation/location.d.ts +6 -0
  355. package/dist/esm/behavior/state/validation/location.d.ts.map +1 -1
  356. package/dist/esm/behavior/state/validation/remote-validation.d.ts +57 -0
  357. package/dist/esm/behavior/state/validation/remote-validation.d.ts.map +1 -0
  358. package/dist/esm/behavior/state/validation/remote-validation.js +48 -0
  359. package/dist/esm/behavior/state/validation/remote-validation.js.map +6 -0
  360. package/dist/esm/behavior/supervision/Supervision.d.ts.map +1 -1
  361. package/dist/esm/behavior/supervision/Supervision.js +1 -1
  362. package/dist/esm/behavior/supervision/Supervision.js.map +1 -1
  363. package/dist/esm/behavior/supervision/SupervisionConfig.d.ts.map +1 -1
  364. package/dist/esm/behavior/supervision/SupervisionConfig.js +1 -1
  365. package/dist/esm/behavior/supervision/SupervisionConfig.js.map +1 -1
  366. package/dist/esm/behavior/supervision/ValueSupervisor.d.ts +3 -12
  367. package/dist/esm/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
  368. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts +57 -6
  369. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  370. package/dist/esm/behavior/system/commissioning/CommissioningClient.js +87 -0
  371. package/dist/esm/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  372. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  373. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  374. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js +10 -1
  375. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  376. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  377. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  378. package/dist/esm/behavior/system/controller/ControllerBehavior.js +2 -1
  379. package/dist/esm/behavior/system/controller/ControllerBehavior.js.map +1 -1
  380. package/dist/esm/behavior/system/dcl/DclBehavior.d.ts +3 -3
  381. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  382. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  383. package/dist/esm/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  384. package/dist/esm/behavior/system/remote/api/ApiResource.d.ts +14 -0
  385. package/dist/esm/behavior/system/remote/api/ApiResource.d.ts.map +1 -1
  386. package/dist/esm/behavior/system/remote/api/ApiResource.js +19 -0
  387. package/dist/esm/behavior/system/remote/api/ApiResource.js.map +1 -1
  388. package/dist/esm/behavior/system/remote/api/Envelope.d.ts +4 -2
  389. package/dist/esm/behavior/system/remote/api/Envelope.d.ts.map +1 -1
  390. package/dist/esm/behavior/system/remote/api/Envelope.js +7 -5
  391. package/dist/esm/behavior/system/remote/api/Envelope.js.map +1 -1
  392. package/dist/esm/behavior/system/remote/api/resources/CommandResource.js +2 -2
  393. package/dist/esm/behavior/system/remote/api/resources/CommandResource.js.map +1 -1
  394. package/dist/esm/behavior/system/remote/api/resources/NodeResource.d.ts +1 -0
  395. package/dist/esm/behavior/system/remote/api/resources/NodeResource.d.ts.map +1 -1
  396. package/dist/esm/behavior/system/remote/api/resources/NodeResource.js +3 -0
  397. package/dist/esm/behavior/system/remote/api/resources/NodeResource.js.map +1 -1
  398. package/dist/esm/behavior/system/remote/api/resources/PropertyResource.d.ts.map +1 -1
  399. package/dist/esm/behavior/system/remote/api/resources/PropertyResource.js +5 -3
  400. package/dist/esm/behavior/system/remote/api/resources/PropertyResource.js.map +1 -1
  401. package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.d.ts.map +1 -1
  402. package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.js +2 -11
  403. package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.js.map +1 -1
  404. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  405. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  406. package/dist/esm/behavior/system/sessions/SessionsBehavior.js +6 -1
  407. package/dist/esm/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  408. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  409. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  410. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js +54 -0
  411. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  412. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  413. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  414. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  415. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  416. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts +2 -2
  417. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  418. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  419. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  420. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  421. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  422. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  423. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +105 -60
  424. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  425. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  426. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  427. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  428. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  429. package/dist/esm/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  430. package/dist/esm/behaviors/groupcast/GroupcastServer.js +42 -25
  431. package/dist/esm/behaviors/groupcast/GroupcastServer.js.map +2 -2
  432. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  433. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  434. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.js +15 -4
  435. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.js.map +2 -2
  436. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  437. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  438. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js +32 -24
  439. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  440. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  441. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  442. package/dist/esm/behaviors/thermostat/ThermostatServer.js +66 -49
  443. package/dist/esm/behaviors/thermostat/ThermostatServer.js.map +1 -1
  444. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  445. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  446. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js +19 -5
  447. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +2 -2
  448. package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.d.ts.map +1 -1
  449. package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.js +13 -3
  450. package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.js.map +1 -1
  451. package/dist/esm/endpoint/Endpoint.d.ts +5 -9
  452. package/dist/esm/endpoint/Endpoint.d.ts.map +1 -1
  453. package/dist/esm/endpoint/Endpoint.js +5 -24
  454. package/dist/esm/endpoint/Endpoint.js.map +1 -1
  455. package/dist/esm/endpoint/properties/Behaviors.d.ts.map +1 -1
  456. package/dist/esm/endpoint/properties/Behaviors.js +6 -2
  457. package/dist/esm/endpoint/properties/Behaviors.js.map +1 -1
  458. package/dist/esm/node/ClientNode.d.ts +25 -0
  459. package/dist/esm/node/ClientNode.d.ts.map +1 -1
  460. package/dist/esm/node/ClientNode.js +41 -0
  461. package/dist/esm/node/ClientNode.js.map +1 -1
  462. package/dist/esm/node/ServerNode.d.ts.map +1 -1
  463. package/dist/esm/node/ServerNode.js +2 -0
  464. package/dist/esm/node/ServerNode.js.map +1 -1
  465. package/dist/esm/node/client/ClientCommandMethod.d.ts.map +1 -1
  466. package/dist/esm/node/client/ClientCommandMethod.js +4 -16
  467. package/dist/esm/node/client/ClientCommandMethod.js.map +1 -1
  468. package/dist/esm/node/client/ClientEventEmitter.d.ts.map +1 -1
  469. package/dist/esm/node/client/ClientEventEmitter.js +6 -2
  470. package/dist/esm/node/client/ClientEventEmitter.js.map +1 -1
  471. package/dist/esm/node/client/ClientStructure.d.ts.map +1 -1
  472. package/dist/esm/node/client/ClientStructure.js +181 -108
  473. package/dist/esm/node/client/ClientStructure.js.map +2 -2
  474. package/dist/esm/node/client/Peers.d.ts +18 -6
  475. package/dist/esm/node/client/Peers.d.ts.map +1 -1
  476. package/dist/esm/node/client/Peers.js +29 -14
  477. package/dist/esm/node/client/Peers.js.map +1 -1
  478. package/dist/esm/node/integration/ChangeNotificationService.d.ts +14 -3
  479. package/dist/esm/node/integration/ChangeNotificationService.d.ts.map +1 -1
  480. package/dist/esm/node/integration/ProtocolService.d.ts.map +1 -1
  481. package/dist/esm/node/integration/ProtocolService.js +40 -57
  482. package/dist/esm/node/integration/ProtocolService.js.map +1 -1
  483. package/dist/esm/node/server/InteractionServer.d.ts.map +1 -1
  484. package/dist/esm/node/server/InteractionServer.js +28 -25
  485. package/dist/esm/node/server/InteractionServer.js.map +2 -2
  486. package/dist/esm/node/server/ServerSubscription.d.ts +7 -2
  487. package/dist/esm/node/server/ServerSubscription.d.ts.map +1 -1
  488. package/dist/esm/node/server/ServerSubscription.js +83 -47
  489. package/dist/esm/node/server/ServerSubscription.js.map +1 -1
  490. package/dist/esm/storage/EndpointStore.d.ts +1 -1
  491. package/dist/esm/storage/EndpointStore.js +1 -1
  492. package/dist/esm/storage/client/ClientEndpointStore.d.ts +2 -2
  493. package/dist/esm/storage/client/ClientEndpointStore.d.ts.map +1 -1
  494. package/dist/esm/storage/client/ClientEndpointStore.js +1 -1
  495. package/dist/esm/storage/client/DatasourceCache.d.ts +5 -3
  496. package/dist/esm/storage/client/DatasourceCache.d.ts.map +1 -1
  497. package/dist/esm/storage/client/DatasourceCache.js +68 -71
  498. package/dist/esm/storage/client/DatasourceCache.js.map +1 -1
  499. package/dist/esm/storage/client/FabricScopedListWrite.d.ts +73 -0
  500. package/dist/esm/storage/client/FabricScopedListWrite.d.ts.map +1 -0
  501. package/dist/esm/storage/client/FabricScopedListWrite.js +148 -0
  502. package/dist/esm/storage/client/FabricScopedListWrite.js.map +6 -0
  503. package/dist/esm/storage/client/RemoteWriteParticipant.d.ts +9 -6
  504. package/dist/esm/storage/client/RemoteWriteParticipant.d.ts.map +1 -1
  505. package/dist/esm/storage/client/RemoteWriteParticipant.js +11 -15
  506. package/dist/esm/storage/client/RemoteWriteParticipant.js.map +1 -1
  507. package/dist/esm/storage/client/RemoteWriter.d.ts +67 -7
  508. package/dist/esm/storage/client/RemoteWriter.d.ts.map +1 -1
  509. package/dist/esm/storage/client/RemoteWriter.js +65 -14
  510. package/dist/esm/storage/client/RemoteWriter.js.map +1 -1
  511. package/dist/esm/storage/server/DatasourceStore.d.ts +2 -2
  512. package/dist/esm/storage/server/DatasourceStore.d.ts.map +1 -1
  513. package/dist/esm/storage/server/DatasourceStore.js.map +1 -1
  514. package/dist/esm/storage/server/ServerEndpointStore.d.ts +2 -2
  515. package/dist/esm/storage/server/ServerEndpointStore.d.ts.map +1 -1
  516. package/dist/esm/storage/server/ServerEndpointStore.js +1 -1
  517. package/dist/esm/testing/mock-server-node.d.ts +2 -1
  518. package/dist/esm/testing/mock-server-node.d.ts.map +1 -1
  519. package/dist/esm/testing/mock-server-node.js +16 -7
  520. package/dist/esm/testing/mock-server-node.js.map +2 -2
  521. package/dist/esm/testing/node-helpers.d.ts +5 -0
  522. package/dist/esm/testing/node-helpers.d.ts.map +1 -1
  523. package/dist/esm/testing/node-helpers.js +4 -4
  524. package/dist/esm/testing/node-helpers.js.map +1 -1
  525. package/package.json +6 -6
  526. package/src/behavior/Behavior.ts +2 -0
  527. package/src/behavior/Events.ts +6 -3
  528. package/src/behavior/cluster/ClusterBehavior.ts +22 -13
  529. package/src/behavior/cluster/ClusterBehaviorType.ts +9 -270
  530. package/src/behavior/context/server/LocalActorContext.ts +1 -4
  531. package/src/behavior/internal/BehaviorBacking.ts +10 -2
  532. package/src/behavior/internal/ClusterDerivation.ts +295 -0
  533. package/src/behavior/internal/ClusterStatics.ts +180 -0
  534. package/src/behavior/internal/ModeledState.ts +58 -0
  535. package/src/behavior/internal/ServerBehaviorBacking.ts +9 -16
  536. package/src/behavior/state/managed/Datasource.ts +181 -58
  537. package/src/behavior/state/managed/Internal.ts +44 -34
  538. package/src/behavior/state/managed/ManagedReference.ts +159 -70
  539. package/src/behavior/state/managed/NameResolver.ts +1 -1
  540. package/src/behavior/state/managed/ReadOnlyReference.ts +61 -0
  541. package/src/behavior/state/managed/ValReference.ts +104 -14
  542. package/src/behavior/state/managed/errors.ts +33 -0
  543. package/src/behavior/state/managed/index.ts +1 -0
  544. package/src/behavior/state/managed/values/BitmapManager.ts +6 -22
  545. package/src/behavior/state/managed/values/ListManager.ts +313 -164
  546. package/src/behavior/state/managed/values/StructManager.ts +48 -52
  547. package/src/behavior/state/managed/values/ValuePatcher.ts +25 -3
  548. package/src/behavior/state/validation/FabricIndexField.ts +51 -0
  549. package/src/behavior/state/validation/ValueValidator.ts +24 -54
  550. package/src/behavior/state/validation/conformance.ts +9 -7
  551. package/src/behavior/state/validation/constraint.ts +5 -1
  552. package/src/behavior/state/validation/location.ts +8 -0
  553. package/src/behavior/state/validation/remote-validation.ts +107 -0
  554. package/src/behavior/supervision/Supervision.ts +1 -2
  555. package/src/behavior/supervision/SupervisionConfig.ts +1 -2
  556. package/src/behavior/supervision/ValueSupervisor.ts +3 -13
  557. package/src/behavior/system/commissioning/CommissioningClient.ts +122 -6
  558. package/src/behavior/system/commissioning/RemoteDescriptor.ts +17 -1
  559. package/src/behavior/system/controller/ControllerBehavior.ts +2 -1
  560. package/src/behavior/system/dcl/DclBehavior.ts +3 -3
  561. package/src/behavior/system/network/ServerGroupNetworking.ts +3 -2
  562. package/src/behavior/system/remote/api/ApiResource.ts +23 -0
  563. package/src/behavior/system/remote/api/Envelope.ts +8 -6
  564. package/src/behavior/system/remote/api/resources/CommandResource.ts +2 -2
  565. package/src/behavior/system/remote/api/resources/NodeResource.ts +4 -0
  566. package/src/behavior/system/remote/api/resources/PropertyResource.ts +5 -3
  567. package/src/behavior/system/remote/api/resources/ServerNodeResource.ts +2 -13
  568. package/src/behavior/system/sessions/SessionsBehavior.ts +8 -2
  569. package/src/behavior/system/subscriptions/SubscriptionStore.ts +66 -0
  570. package/src/behavior/system/subscriptions/SubscriptionsServer.ts +73 -33
  571. package/src/behaviors/access-control/AccessControlServer.ts +3 -3
  572. package/src/behaviors/administrator-commissioning/AdministratorCommissioningServer.ts +47 -24
  573. package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts +138 -84
  574. package/src/behaviors/group-key-management/GroupKeyManagementServer.ts +12 -8
  575. package/src/behaviors/groupcast/GroupcastServer.ts +50 -34
  576. package/src/behaviors/localization-configuration/LocalizationConfigurationServer.ts +18 -6
  577. package/src/behaviors/operational-credentials/VendorIdVerification.ts +50 -35
  578. package/src/behaviors/thermostat/ThermostatServer.ts +93 -70
  579. package/src/behaviors/time-format-localization/TimeFormatLocalizationServer.ts +24 -9
  580. package/src/behaviors/unit-localization/UnitLocalizationServer.ts +17 -4
  581. package/src/endpoint/Endpoint.ts +5 -31
  582. package/src/endpoint/properties/Behaviors.ts +6 -2
  583. package/src/node/ClientNode.ts +41 -0
  584. package/src/node/ServerNode.ts +2 -0
  585. package/src/node/client/ClientCommandMethod.ts +4 -19
  586. package/src/node/client/ClientEventEmitter.ts +7 -3
  587. package/src/node/client/ClientStructure.ts +208 -135
  588. package/src/node/client/Peers.ts +36 -20
  589. package/src/node/integration/ChangeNotificationService.ts +18 -3
  590. package/src/node/integration/ProtocolService.ts +45 -57
  591. package/src/node/server/InteractionServer.ts +33 -35
  592. package/src/node/server/ServerSubscription.ts +88 -50
  593. package/src/storage/EndpointStore.ts +1 -1
  594. package/src/storage/client/ClientEndpointStore.ts +1 -1
  595. package/src/storage/client/DatasourceCache.ts +86 -79
  596. package/src/storage/client/FabricScopedListWrite.ts +245 -0
  597. package/src/storage/client/RemoteWriteParticipant.ts +20 -23
  598. package/src/storage/client/RemoteWriter.ts +156 -26
  599. package/src/storage/server/DatasourceStore.ts +2 -2
  600. package/src/storage/server/ServerEndpointStore.ts +1 -1
  601. package/src/testing/mock-server-node.ts +22 -9
  602. package/src/testing/node-helpers.ts +5 -1
  603. package/dist/cjs/behavior/state/validation/FabricIndexSentinel.d.ts +0 -14
  604. package/dist/cjs/behavior/state/validation/FabricIndexSentinel.d.ts.map +0 -1
  605. package/dist/cjs/behavior/state/validation/FabricIndexSentinel.js.map +0 -6
  606. package/dist/cjs/behavior/state/validation/peer-forwarding.d.ts +0 -20
  607. package/dist/cjs/behavior/state/validation/peer-forwarding.d.ts.map +0 -1
  608. package/dist/cjs/behavior/state/validation/peer-forwarding.js.map +0 -6
  609. package/dist/esm/behavior/state/validation/FabricIndexSentinel.d.ts +0 -14
  610. package/dist/esm/behavior/state/validation/FabricIndexSentinel.d.ts.map +0 -1
  611. package/dist/esm/behavior/state/validation/FabricIndexSentinel.js +0 -15
  612. package/dist/esm/behavior/state/validation/FabricIndexSentinel.js.map +0 -6
  613. package/dist/esm/behavior/state/validation/peer-forwarding.d.ts +0 -20
  614. package/dist/esm/behavior/state/validation/peer-forwarding.d.ts.map +0 -1
  615. package/dist/esm/behavior/state/validation/peer-forwarding.js +0 -26
  616. package/dist/esm/behavior/state/validation/peer-forwarding.js.map +0 -6
  617. package/src/behavior/state/validation/FabricIndexSentinel.ts +0 -20
  618. package/src/behavior/state/validation/peer-forwarding.ts +0 -47
@@ -7,7 +7,7 @@
7
7
  import { camelize, deepCopy, GeneratedClass, isObject } from "@matter/general";
8
8
  import type { Schema } from "@matter/model";
9
9
  import { ElementTag, FieldValue, MandatoryDefaultValue, Metatype, ValueModel } from "@matter/model";
10
- import { AccessControl, PhantomReferenceError, SchemaImplementationError, Val } from "@matter/protocol";
10
+ import { AccessControl, SchemaImplementationError, Val } from "@matter/protocol";
11
11
  import { FabricIndex } from "@matter/types";
12
12
  import { RootSupervisor } from "../../../supervision/RootSupervisor.js";
13
13
  import type { ValueSupervisor } from "../../../supervision/ValueSupervisor.js";
@@ -22,8 +22,7 @@ import {
22
22
  memberValueOf,
23
23
  } from "../MemberKeys.js";
24
24
  import { NameResolver } from "../NameResolver.js";
25
- import type { ValReference } from "../ValReference.js";
26
- import { isFabricScopedList } from "./ListManager.js";
25
+ import { ValReference } from "../ValReference.js";
27
26
  import { PrimitiveManager } from "./PrimitiveManager.js";
28
27
 
29
28
  /**
@@ -140,11 +139,11 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
140
139
 
141
140
  const { access, manage, validate } = supervisor.get(schema);
142
141
 
143
- const fabricScopedList = isFabricScopedList(schema) && schema.effectiveMetatype === Metatype.array;
142
+ const fabricScopedList = schema.fabricScopedList;
144
143
 
145
144
  // We generally do not deal with default values. If the schema defines a default it is assigned before the manager
146
- // is created. The one exception is for field references. These we must look up dynamically at runtime because the
147
- // value should always track the referenced value
145
+ // is created. Field references are the exception: a name-keyed container reads the referenced value at runtime so
146
+ // it tracks that value, and a mirror's default is a copy of it, made in readDefault
148
147
  let defaultReader: ((val: Val) => Val) | undefined;
149
148
  if (typeof FieldValue.referenced(schema.default) === "string") {
150
149
  defaultReader = NameResolver(supervisor, schema.parent, camelize(FieldValue.referenced(schema.default)!));
@@ -153,8 +152,8 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
153
152
  // A member mandatory under the mirror's active features always reads a value even when the peer's
154
153
  // AttributeList omits it, and an optional member stays undefined even when the peer's AttributeList reports
155
154
  // it -- this mirrors the conformance-aware TypeScript typings, which know nothing about runtime AttributeList
156
- // data. The container itself never holds this value, so it can't masquerade as peer data in persistence,
157
- // change detection or external-change integration.
155
+ // data. The container never holds this value, so it can't masquerade as peer data in persistence, change
156
+ // detection or external-change integration; a change in place of a default container throws UncachedValueError.
158
157
  const scope = supervisor.scope;
159
158
  const isMandatory = scope.isMandatory(schema);
160
159
 
@@ -176,7 +175,7 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
176
175
  const referencedDefault = defaultReader;
177
176
  const readDefault: ((self: Struct) => Val | undefined) | undefined = synthesizeDefault
178
177
  ? referencedDefault
179
- ? (self: Struct) => referencedDefault(self) ?? synthesizeDefault()
178
+ ? (self: Struct) => Internal.copy(referencedDefault(self)) ?? synthesizeDefault()
180
179
  : () => synthesizeDefault()
181
180
  : undefined;
182
181
 
@@ -185,20 +184,21 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
185
184
 
186
185
  set(this: Struct, value: Val) {
187
186
  access.authorizeWrite(this[Internal.session], this[Internal.reference].location);
187
+ const container = ValReference.writableContainerOf(this[Internal.reference]);
188
188
 
189
189
  // We allow attribute/field name or id as key. If name is present id is ignored
190
190
  const pk = this[Internal.reference].primaryKey;
191
191
  let key = memberKeyFor(pk, name, id);
192
- let storedKey = memberSlotOf(this[Internal.reference].value, key, memberFallbackKeyFor(pk, name, id));
192
+ let storedKey = memberSlotOf(container, key, memberFallbackKeyFor(pk, name, id));
193
193
 
194
194
  // Rollback and the fabric-scoped-list merge check must see stored truth — never the write-migration
195
195
  // slot above and never a synthesized default
196
- const oldValue = memberValueOf(this[Internal.reference].value, key, memberReadFallbackKeyFor(pk, name, id));
196
+ const oldValue = memberValueOf(container, key, memberReadFallbackKeyFor(pk, name, id));
197
197
 
198
198
  const self = this;
199
199
 
200
200
  this[Internal.reference].change(() => {
201
- const struct = this[Internal.reference].value;
201
+ const struct = ValReference.containerOf(this[Internal.reference]);
202
202
 
203
203
  // Identify the target. Usually just "struct" except when struct supports Val.Dynamic
204
204
  let target;
@@ -214,9 +214,9 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
214
214
  if (fabricScopedList || validate) {
215
215
  // A dynamic member's previous value lives in the provider, not the container slot;
216
216
  // read it only when rollback or the fabric-scoped merge check may consume it, as the
217
- // provider's getter may be costly. Unmanage in case the provider serves a managed
218
- // value — rollback must not plant a proxy that expires with this session
219
- previousValue = Internal.unmanage(properties[name]);
217
+ // provider's getter may be costly. Unwrap in case the provider serves a managed value —
218
+ // rollback must not plant a proxy that expires with this session
219
+ previousValue = Internal.rawOf(properties[name]);
220
220
  }
221
221
  } else {
222
222
  target = struct;
@@ -225,8 +225,7 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
225
225
  target = struct;
226
226
  }
227
227
 
228
- // Unwrap if incoming value (or nested children) is managed
229
- value = Internal.unmanage(value);
228
+ value = Internal.copy(value);
230
229
 
231
230
  // Undo our change on error. Rollback will take care of this when transactional but this handles the
232
231
  // cases of 1.) no transaction, and 2.) error is caught within transaction. A previously absent member
@@ -243,11 +242,14 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
243
242
  if (fabricScopedList && Array.isArray(value)) {
244
243
  // The merge must run through the proxy even for an absent member; it is what filters by fabric
245
244
  // and supplies the accessing fabric
246
- if (previousValue === undefined) {
245
+ if (previousValue === undefined || previousValue === null) {
247
246
  target[key] = [];
248
247
  if (storedKey !== undefined && storedKey !== key) {
249
248
  delete target[storedKey];
250
249
  }
250
+
251
+ // The direct write above bypasses the cached reference; the merge below reads through it
252
+ this[Internal.reference].subrefs?.[memberKeyFor(pk, name, id)]?.refresh("session");
251
253
  }
252
254
 
253
255
  // In the case of fabric-scoped write to established list we use the managed proxy to perform update
@@ -258,6 +260,9 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
258
260
  proxy[i] = value[i];
259
261
  }
260
262
  proxy.length = value.length;
263
+
264
+ // The list prepared copies of the entries, so validate those
265
+ value = Array.from(proxy, Internal.copy);
261
266
  } catch (e) {
262
267
  undo();
263
268
  throw e;
@@ -284,6 +289,7 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
284
289
  path: this[Internal.reference].location.path,
285
290
  siblings: struct,
286
291
  owner: this[Internal.reference].rootOwner,
292
+ remote: this[Internal.reference].mirrorsRemote ? "outbound" : undefined,
287
293
  });
288
294
  } catch (e) {
289
295
  undo();
@@ -298,10 +304,7 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
298
304
  // For primitives, we don't need a manager so just proxy reads directly
299
305
  descriptor.get = function (this: Struct) {
300
306
  if (access.mayRead(this[Internal.session], this[Internal.reference].location)) {
301
- const struct = this[Internal.reference].value as Val.Dynamic;
302
- if (struct === undefined) {
303
- throw new PhantomReferenceError(this[Internal.reference].location);
304
- }
307
+ const struct = ValReference.containerOf(this[Internal.reference]) as Val.Dynamic;
305
308
  if (struct[Val.properties]) {
306
309
  const properties = struct[Val.properties](
307
310
  this[Internal.reference].rootOwner,
@@ -350,7 +353,7 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
350
353
  let value;
351
354
 
352
355
  // Obtain the value. Normally just struct[key] except in the case of Val.Dynamic
353
- const struct = this[Internal.reference].value;
356
+ const struct = ValReference.containerOf(this[Internal.reference]);
354
357
  const primaryKey = this[Internal.reference].primaryKey;
355
358
  const key = memberKeyFor(primaryKey, name, id);
356
359
  if ((struct as Val.Dynamic)[Val.properties]) {
@@ -375,7 +378,12 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
375
378
  }
376
379
 
377
380
  if (value === undefined) {
378
- return primaryKey === "name" ? defaultReader?.(this) : readDefault?.(this);
381
+ if (primaryKey === "name") {
382
+ return defaultReader?.(this);
383
+ }
384
+ if (readDefault === undefined) {
385
+ return undefined;
386
+ }
379
387
  }
380
388
 
381
389
  // Value is null or a dynamic property, so just return it
@@ -384,36 +392,24 @@ function configureProperty(supervisor: RootSupervisor, schema: ValueModel) {
384
392
  return value;
385
393
  }
386
394
 
387
- const managed = this[Internal.reference].subrefs?.[key];
388
- if (managed) {
389
- return managed.owner;
390
- }
391
-
392
- const assertWriteOk = (value: Val) => {
393
- // Note - this needs to mirror behavior in the setter above
394
- access.authorizeWrite(this[Internal.session], this[Internal.reference].location);
395
- if (validate) {
396
- validate(value, this[Internal.session], {
397
- path: this[Internal.reference].location.path,
398
- siblings: this[Internal.reference].value,
399
- owner: this[Internal.reference].rootOwner,
400
- });
401
- }
402
- };
403
-
404
- // Clone the container before write
405
- const ref = new ManagedReference(
406
- this[Internal.reference],
407
- name,
408
- id,
409
- assertWriteOk,
410
- cloneContainer,
411
- this[Internal.session],
412
- );
395
+ // The reference makes the default of an absent member, once for as long as the member stays absent
396
+ const ref =
397
+ this[Internal.reference].subrefs?.[key] ??
398
+ new ManagedReference(
399
+ this[Internal.reference],
400
+ name,
401
+ id,
402
+ cloneContainer,
403
+ this[Internal.session],
404
+ "member",
405
+ primaryKey === "id" && readDefault ? () => readDefault(this) : undefined,
406
+ );
413
407
 
414
- ref.owner = manage(ref, this[Internal.session]);
408
+ if (ref.value === undefined || ref.value === null) {
409
+ return ref.value;
410
+ }
415
411
 
416
- return ref.owner;
412
+ return (ref.owner ??= manage(ref, this[Internal.session]));
417
413
  };
418
414
  }
419
415
 
@@ -10,9 +10,18 @@ import { DataModelPath, Metatype, StoredDefaultValue, ValueModel } from "@matter
10
10
  import { SchemaImplementationError, Val, WriteError } from "@matter/protocol";
11
11
  import { RootSupervisor } from "../../../supervision/RootSupervisor.js";
12
12
  import { ValueSupervisor } from "../../../supervision/ValueSupervisor.js";
13
+ import { Internal } from "../Internal.js";
13
14
 
14
15
  /**
15
16
  * Obtain a {@link ValueSupervisor.Patch} function for the given schema.
17
+ *
18
+ * The patch decides per target. A target that mirrors a remote node, such as the cluster state of a client node or a
19
+ * value inside it, takes each given member or entry as a whole value: the patch assigns it like `state.x = value` in an
20
+ * act, without merging it into the cached value and without local defaults. A list member must then be given as an
21
+ * array. Assigning to a member of a value inside an attribute changes that attribute in place, so it fails with
22
+ * `UncachedValueError` while the attribute reads its uncached default. Any other target is patched: a struct given for
23
+ * a struct member is merged into it, a list is merged entry by entry, and a missing struct or list entry starts from
24
+ * the schema defaults.
16
25
  */
17
26
  export function ValuePatcher(schema: Schema, supervisor: RootSupervisor) {
18
27
  switch (schema.effectiveMetatype) {
@@ -118,6 +127,8 @@ function StructPatcher(schema: ValueModel, supervisor: RootSupervisor): ValueSup
118
127
  throw new WriteError(path, `cannot patch ${target} because it is not an object`);
119
128
  }
120
129
 
130
+ const assignsWhole = mirrorsRemote(target);
131
+
121
132
  for (let key in changes as Val.Struct) {
122
133
  let newValue = (changes as Val.Struct)[key];
123
134
 
@@ -129,9 +140,14 @@ function StructPatcher(schema: ValueModel, supervisor: RootSupervisor): ValueSup
129
140
  key = memberAltKeys[key];
130
141
  }
131
142
 
132
- // If this is not a subcollection or the new value is not an object, just do direct set
143
+ if (assignsWhole && memberArrays[key] && isObject(newValue)) {
144
+ throw new ImplementationError(
145
+ `Cannot patch ${path.at(key)} with an object: on the cluster state of a client node a list is written whole, so give the complete list as an array`,
146
+ );
147
+ }
148
+
133
149
  const subpatch = memberPatchers[key];
134
- if (!subpatch || newValue === null || typeof newValue !== "object") {
150
+ if (assignsWhole || !subpatch || newValue === null || typeof newValue !== "object") {
135
151
  target[key] = newValue;
136
152
  continue;
137
153
  }
@@ -194,6 +210,8 @@ function ListPatcher(schema: ValueModel, supervisor: RootSupervisor): ValueSuper
194
210
  throw new WriteError(path, `patch definition ${changes} is not an object`);
195
211
  }
196
212
 
213
+ const assignsWhole = mirrorsRemote(target);
214
+
197
215
  // eslint reports error here when linting entire project but not individual file. Unsure if this is a bug but
198
216
  // disabling as code is correct as written
199
217
  // oxlint-disable-next-line @typescript-eslint/no-for-in-array
@@ -207,7 +225,7 @@ function ListPatcher(schema: ValueModel, supervisor: RootSupervisor): ValueSuper
207
225
  // Changes may be an array or object but JS allows string indices either way even though TS doesn't
208
226
  let newValue = (changes as Val.Struct)[indexStr];
209
227
 
210
- if (patchEntry) {
228
+ if (patchEntry && !assignsWhole) {
211
229
  const oldValue = index < target.length ? target[index] : undefined;
212
230
  if (newValue === undefined || newValue === null || oldValue === undefined || oldValue === null) {
213
231
  // If creating a new object, apply as a patch to the object's defaults before insertion
@@ -232,6 +250,10 @@ function ListPatcher(schema: ValueModel, supervisor: RootSupervisor): ValueSuper
232
250
  };
233
251
  }
234
252
 
253
+ function mirrorsRemote(target: Val.Collection) {
254
+ return Internal.referenceOf(target)?.mirrorsRemote === true;
255
+ }
256
+
235
257
  function PrimitivePatcher(): ValueSupervisor.Patch {
236
258
  return (_changes, _target, path) => {
237
259
  throw new ImplementationError(`Cannot generate patch ${path} because it does not define not a collection`);
@@ -0,0 +1,51 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2022-2026 Matter.js Authors
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+
7
+ import { camelize } from "@matter/general";
8
+ import { FabricIndex as FabricIndexElement, FieldModel, ValueModel } from "@matter/model";
9
+ import type { Val } from "@matter/protocol";
10
+ import type { FabricIndex } from "@matter/types";
11
+ import { memberSlotOf, memberValueOf } from "../managed/MemberKeys.js";
12
+
13
+ const FIELD_ID = FabricIndexElement.id;
14
+ const FIELD_NAME = FabricIndexElement.name;
15
+ const FIELD_PROPERTY = camelize(FIELD_NAME);
16
+
17
+ /**
18
+ * True when `schema` is the spec-defined FabricIndex field of a fabric-scoped struct — same id/name match
19
+ * `ObjectSchema.encodeEntryToTlv` uses to gate the wire-level strip. Per spec the id+name combination is reserved
20
+ * for this purpose; no other struct field can re-use it.
21
+ * @see {@link MatterSpecification.v161.Core} § 7.13.6
22
+ */
23
+ export function isFabricIndexField(schema: ValueModel): boolean {
24
+ return schema instanceof FieldModel && schema.id === FIELD_ID && schema.name === FIELD_NAME;
25
+ }
26
+
27
+ /**
28
+ * The slot under which a name-keyed fabric-scoped struct holds its FabricIndex: the property name, else the TLV tag
29
+ * number, as struct validation reads a field. Undefined if the struct holds none.
30
+ */
31
+ export function fabricIndexSlotOf(struct: Val.Struct) {
32
+ return memberSlotOf(struct, FIELD_PROPERTY, FIELD_ID);
33
+ }
34
+
35
+ /**
36
+ * The FabricIndex a name-keyed fabric-scoped struct holds; see {@link fabricIndexSlotOf}.
37
+ */
38
+ export function fabricIndexOf(struct: Val.Struct): Val {
39
+ return memberValueOf(struct, FIELD_PROPERTY, FIELD_ID);
40
+ }
41
+
42
+ /**
43
+ * {@link struct} with {@link fabricIndex} as its FabricIndex, under the slot it already uses for it, else under the
44
+ * property name. Returns {@link struct} itself if it already holds that index.
45
+ */
46
+ export function withFabricIndex(struct: Val.Struct, fabricIndex: FabricIndex): Val.Struct {
47
+ if (fabricIndexOf(struct) === fabricIndex) {
48
+ return struct;
49
+ }
50
+ return { ...struct, [fabricIndexSlotOf(struct) ?? FIELD_PROPERTY]: fabricIndex };
51
+ }
@@ -20,7 +20,7 @@ import { BitmapEncodedValue, FabricIndex, Status } from "@matter/types";
20
20
  import { RootSupervisor } from "../../supervision/RootSupervisor.js";
21
21
  import { maybeConfigOf } from "../../supervision/SupervisionConfig.js";
22
22
  import type { ValueSupervisor } from "../../supervision/ValueSupervisor.js";
23
- import { memberSlotOf, memberValueOf } from "../managed/MemberKeys.js";
23
+ import { memberValueOf } from "../managed/MemberKeys.js";
24
24
  import {
25
25
  assertArray,
26
26
  assertBoolean,
@@ -34,29 +34,12 @@ import {
34
34
  import { astToFunction } from "./conformance-compiler.js";
35
35
  import { createConformanceValidator } from "./conformance.js";
36
36
  import { createConstraintValidator } from "./constraint.js";
37
- import { isFabricIndexSentinel } from "./FabricIndexSentinel.js";
37
+ import { isFabricIndexField } from "./FabricIndexField.js";
38
38
  import { ValidationLocation } from "./location.js";
39
- import { forwardValidationToPeer } from "./peer-forwarding.js";
39
+ import { leaveErrorsToRemote } from "./remote-validation.js";
40
40
 
41
41
  const logger = Logger.get("ValueValidator");
42
42
 
43
- /**
44
- * Wrap a datatype validator so peer (client) writes forward datatype violations the device may still accept (see
45
- * {@link forwardValidationToPeer}). Conformance violations are forwarded separately in {@link createConformanceValidator}
46
- * so that datatype validation still runs after a forwarded conformance failure.
47
- */
48
- function forwardableForClientPeer(inner: ValueSupervisor.Validate): ValueSupervisor.Validate {
49
- return (value, session, location) => {
50
- try {
51
- inner(value, session, location);
52
- } catch (e) {
53
- if (!forwardValidationToPeer(session, e)) {
54
- throw e;
55
- }
56
- }
57
- };
58
- }
59
-
60
43
  /**
61
44
  * Generate a function that performs data validation.
62
45
  *
@@ -65,7 +48,7 @@ function forwardableForClientPeer(inner: ValueSupervisor.Validate): ValueSupervi
65
48
  */
66
49
  export function ValueValidator(schema: Schema, supervisor: RootSupervisor): ValueSupervisor.Validate | undefined {
67
50
  if (schema instanceof ClusterModel) {
68
- return forwardableForClientPeer(createStructValidator(schema, supervisor));
51
+ return leaveErrorsToRemote(supervisor, createStructValidator(schema, supervisor));
69
52
  }
70
53
 
71
54
  let validator: ValueSupervisor.Validate | undefined;
@@ -141,7 +124,8 @@ export function ValueValidator(schema: Schema, supervisor: RootSupervisor): Valu
141
124
 
142
125
  validator = createNullValidator(schema, validator);
143
126
 
144
- validator = validator && forwardableForClientPeer(validator);
127
+ // Catches undefined enum values, reserved bitmap bits and struct-choice conformance errors
128
+ validator = validator && leaveErrorsToRemote(supervisor, validator);
145
129
 
146
130
  validator = createConformanceValidator(schema, supervisor, validator);
147
131
 
@@ -283,8 +267,6 @@ function createBitmapValidator(schema: ValueModel, supervisor: RootSupervisor):
283
267
  }
284
268
  }
285
269
 
286
- // The bound stays local, so it runs with the structural checks: a conformance or reserved-bit failure is
287
- // forwarded for a peer write, which unwinds the validator before anything after it
288
270
  validateMagnitude?.(value, session, location);
289
271
 
290
272
  // A bit's conformance says whether the bit may be set, never that it must be, because every declared bit is
@@ -358,32 +340,16 @@ function createIntegerValidator(schema: ValueModel, supervisor: RootSupervisor,
358
340
 
359
341
  const inner = createSimpleValidator(schema, supervisor, assertion);
360
342
 
361
- // OMIT_FABRIC handling for the fabric-scoped struct FabricIndex sentinel (Matter §7.13.6). Mutation of
362
- // `siblings.fabricIndex` is an intentional bend of the read-only validator contract — covers both the
363
- // per-field StructManager setter path AND the ListManager.writeEntry path (which writes raw entry objects
364
- // bypassing per-field setters). One mechanism handles every setStateOf path.
365
- if (isFabricIndexSentinel(schema)) {
366
- const fieldName = schema.propertyName;
367
- const fieldId = schema.id;
368
- const fabricSentinelOrSubstitute: ValueSupervisor.Validate = (value, session, location) => {
369
- const peerContext = session.clientPeerContext;
370
- if (value !== FabricIndex.OMIT_FABRIC || peerContext === undefined) {
371
- inner(value, session, location);
372
- return;
373
- }
374
- const siblings = location.siblings as Val.Struct | undefined;
375
- if (siblings !== undefined && peerContext.fabricIndexOnPeer !== undefined) {
376
- // Substitute into the slot holding the sentinel — a name-keyed container may hold it under the
377
- // field's TLV tag number, and writing another slot would leave two disagreeing fabricIndex values
378
- siblings[memberSlotOf(siblings, fieldName, fieldId) ?? fieldName] = peerContext.fabricIndexOnPeer;
343
+ // The FabricIndex of a written fabric-scoped struct is ignored (Matter § 7.19.1.9.1) and the encoder leaves
344
+ // OMIT_FABRIC out of a write, so a value sent to a remote node may hold OMIT_FABRIC
345
+ if (isFabricIndexField(schema)) {
346
+ const acceptOmittedOutbound: ValueSupervisor.Validate = (value, session, location) => {
347
+ if (value === FabricIndex.OMIT_FABRIC && location.remote === "outbound") {
379
348
  return;
380
349
  }
381
- logger.debug(
382
- "fabricIndex was not replaced with the peer's fabric index because it is not yet known; local cache will hold the OMIT_FABRIC sentinel (-1) until the peer's subscription delivers the real value at",
383
- location.path,
384
- );
350
+ inner(value, session, location);
385
351
  };
386
- return fabricSentinelOrSubstitute;
352
+ return acceptOmittedOutbound;
387
353
  }
388
354
 
389
355
  return inner;
@@ -408,14 +374,13 @@ function createStructValidator(schema: Schema, supervisor: RootSupervisor): Valu
408
374
 
409
375
  const config = location.config ?? maybeConfigOf(struct);
410
376
 
411
- const sublocation = {
377
+ const sublocation: ValidationLocation = {
378
+ ...location,
412
379
  path: location.path.at(""),
413
380
  siblings: struct,
414
381
  choices: {},
415
- outerResolve: location.outerResolve,
416
382
  config,
417
- owner: location.owner,
418
- } as ValidationLocation;
383
+ };
419
384
 
420
385
  for (const name in validators) {
421
386
  const { id, validate } = validators[name];
@@ -482,10 +447,15 @@ function createListValidator(schema: ValueModel, supervisor: RootSupervisor): Va
482
447
  const entryConfig = location.config?.readonlyChild?.("entry");
483
448
 
484
449
  let index = 0;
485
- const sublocation = {
450
+ // An entry is not a member of the struct that holds the list, so it gets none of its context
451
+ const sublocation: ValidationLocation = {
452
+ ...location,
486
453
  path: location.path.at(""),
487
- owner: location.owner,
488
- } as ValidationLocation;
454
+ siblings: undefined,
455
+ choices: undefined,
456
+ outerResolve: undefined,
457
+ config: undefined,
458
+ };
489
459
  // An index names the position in the list, which an entry holding no value occupies too
490
460
  for (const e of list as Iterable<unknown>) {
491
461
  if (e !== undefined && e !== null) {
@@ -8,7 +8,7 @@ import { RootSupervisor } from "#behavior/supervision/RootSupervisor.js";
8
8
  import { ValueModel } from "@matter/model";
9
9
  import { ValueSupervisor } from "../../supervision/ValueSupervisor.js";
10
10
  import { astToFunction } from "./conformance-compiler.js";
11
- import { forwardValidationToPeer } from "./peer-forwarding.js";
11
+ import { leaveToRemote, mayLeaveToRemote } from "./remote-validation.js";
12
12
 
13
13
  /**
14
14
  * Creates a function that validates a field based on its conformance definition.
@@ -21,12 +21,14 @@ export function createConformanceValidator(
21
21
  supervisor: RootSupervisor,
22
22
  nextValidator?: ValueSupervisor.Validate,
23
23
  ): ValueSupervisor.Validate | undefined {
24
- const validate = astToFunction(schema, supervisor);
24
+ const conformance = astToFunction(schema, supervisor);
25
25
 
26
- if (!validate && !nextValidator) {
26
+ if (!conformance && !nextValidator) {
27
27
  return undefined;
28
28
  }
29
29
 
30
+ const remoteDecides = mayLeaveToRemote(supervisor);
31
+
30
32
  return (value, session, location) => {
31
33
  const cfg = location.config?.supervision;
32
34
 
@@ -36,13 +38,13 @@ export function createConformanceValidator(
36
38
  return;
37
39
  }
38
40
 
41
+ // A conformance failure left to the device must still fall through to datatype validation below, so a
42
+ // wrong-typed value cannot slip onto the wire
39
43
  if (cfg?.conformance !== false) {
40
44
  try {
41
- validate?.(value, session, location);
45
+ conformance?.(value, session, location);
42
46
  } catch (e) {
43
- // For peer writes a forwarded conformance failure must still fall through to datatype validation below,
44
- // so a wrong-typed value cannot slip onto the wire.
45
- if (!forwardValidationToPeer(session, e)) {
47
+ if (!remoteDecides || !leaveToRemote(location, e)) {
46
48
  throw e;
47
49
  }
48
50
  }
@@ -12,6 +12,7 @@ import { ValueSupervisor } from "../../supervision/ValueSupervisor.js";
12
12
  import { NameResolver } from "../managed/NameResolver.js";
13
13
  import { assertArray, assertBoolean, assertNumeric, assertSequence, assertString } from "./assertions.js";
14
14
  import { ValidationLocation } from "./location.js";
15
+ import { leaveErrorsToRemote } from "./remote-validation.js";
15
16
 
16
17
  interface NameResolverFactory {
17
18
  (location: ValidationLocation): (name: string) => Val;
@@ -84,12 +85,15 @@ export function createConstraintValidator(
84
85
  return undefined;
85
86
  }
86
87
 
88
+ // Wrap here, not in the caller: an error left to the device must not skip later checks such as list entries
89
+ const validate = leaveErrorsToRemote(supervisor, inner);
90
+
87
91
  return (value, session, location) => {
88
92
  const cfg = location.config?.supervision;
89
93
  if (cfg?.validate === false || cfg?.constraint === false) {
90
94
  return;
91
95
  }
92
- inner(value, session, location);
96
+ validate(value, session, location);
93
97
  };
94
98
  }
95
99
 
@@ -7,6 +7,7 @@
7
7
  import { DataModelPath } from "@matter/model";
8
8
  import { Val } from "@matter/protocol";
9
9
  import type { Supervision } from "../../supervision/Supervision.js";
10
+ import type { leaveErrorsToRemote } from "./remote-validation.js";
10
11
 
11
12
  /**
12
13
  * Contextual information tracked during validation.
@@ -40,6 +41,13 @@ export interface ValidationLocation {
40
41
  */
41
42
  owner?: unknown;
42
43
 
44
+ /**
45
+ * Set if the values under validation are sent to a remote node (`"outbound"`) or received from one (`"inbound"`).
46
+ * A validation error of such a value may be left to the device to decide on rather than thrown; see
47
+ * {@link leaveErrorsToRemote}.
48
+ */
49
+ remote?: "outbound" | "inbound";
50
+
43
51
  /**
44
52
  * Fallback resolver for cross-struct references. When a name cannot be resolved in siblings or the ownership
45
53
  * hierarchy, the validator calls this function.