@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,6 +5,7 @@
5
5
  */
6
6
  import { InternalError } from "@matter/general";
7
7
  import { ExpiredReferenceError, Val } from "@matter/protocol";
8
+ import { UncachedValueError } from "./errors.js";
8
9
  import {
9
10
  memberFallbackKeyFor,
10
11
  memberKeyFor,
@@ -12,6 +13,7 @@ import {
12
13
  memberSlotOf,
13
14
  memberValueOf
14
15
  } from "./MemberKeys.js";
16
+ import { ValReference } from "./ValReference.js";
15
17
  class ManagedReference {
16
18
  primaryKey = "name";
17
19
  parent;
@@ -21,27 +23,34 @@ class ManagedReference {
21
23
  #key;
22
24
  #fallbackKey;
23
25
  #readFallbackKey;
24
- #assertWriteOk;
25
26
  #clone;
27
+ #makeDefault;
28
+ #servesDefault = false;
26
29
  #session;
27
- #expired = false;
28
30
  #location;
29
31
  #value;
30
32
  #dynamicContainer;
31
33
  #dynamicSource;
34
+ #binding;
35
+ #entry;
36
+ #copies;
37
+ #detached = false;
32
38
  /**
33
39
  * @param parent a reference to the container we reference
34
40
  * @param name the name (in the case of structs) or index (in case of lists)
35
41
  * @param id the lookup ID, used when {@link parent} keys its members by ID
36
- * @param assertWriteOk enforces ACLs and read-only
37
- * @param clone clones the container prior to write; undefined if not transactional
42
+ * @param clone clones the container prior to write
38
43
  * @param session the access control session
44
+ * @param binding what the reference stays bound to when the parent changes
45
+ * @param makeDefault makes the default to serve while the member is absent; called once each time the member
46
+ * becomes absent
39
47
  */
40
- constructor(parent, name, id, assertWriteOk, clone, session) {
48
+ constructor(parent, name, id, clone, session, binding, makeDefault) {
41
49
  this.parent = parent;
42
- this.#assertWriteOk = assertWriteOk;
43
50
  this.#clone = clone;
51
+ this.#makeDefault = makeDefault;
44
52
  this.#session = session;
53
+ this.#binding = binding;
45
54
  this.#location = {
46
55
  ...parent.location,
47
56
  path: parent.location.path.at(name)
@@ -53,7 +62,8 @@ class ManagedReference {
53
62
  this.#fallbackKey = fallbackKey;
54
63
  this.#readFallbackKey = readFallbackKey;
55
64
  this.#bindDynamicContainer();
56
- this.#value = this.#dynamicContainer === void 0 ? memberValueOf(parent.value, key, readFallbackKey) : memberValueOf(this.#dynamicContainer, key, fallbackKey);
65
+ this.#value = this.#memberValue();
66
+ this.#entry = this.#value;
57
67
  if (parent.supervisionConfig) {
58
68
  this.supervisionConfig = parent.supervisionConfig.readonlyChild(key);
59
69
  }
@@ -65,21 +75,14 @@ class ManagedReference {
65
75
  get rootOwner() {
66
76
  return this.parent.rootOwner;
67
77
  }
78
+ get mirrorsRemote() {
79
+ return this.parent.mirrorsRemote;
80
+ }
68
81
  get value() {
69
82
  return this.#value;
70
83
  }
71
- set value(newValue) {
72
- if (this.#value === newValue) {
73
- return;
74
- }
75
- this.#assertWriteOk(newValue);
76
- this.#replaceValue(newValue);
77
- this.change(() => {
78
- this.#writeTo(this.#dynamicContainer ?? this.parent.value, newValue);
79
- });
80
- }
81
84
  get expired() {
82
- return this.#expired;
85
+ return this.#detached || this.parent.expired;
83
86
  }
84
87
  get location() {
85
88
  return this.#location;
@@ -87,40 +90,54 @@ class ManagedReference {
87
90
  set location(loc) {
88
91
  this.#location = loc;
89
92
  }
90
- get original() {
91
- if (!this.parent.original) {
92
- return void 0;
93
+ assertWritable() {
94
+ if (this.expired) {
95
+ throw new ExpiredReferenceError(this.location);
93
96
  }
94
- if (this.#dynamicContainer !== void 0) {
95
- const origProperties = this.parent.original[Val.properties](
96
- this.parent.rootOwner,
97
- this.#session
98
- );
99
- return memberValueOf(origProperties, this.#key, this.#fallbackKey);
97
+ this.parent.assertWritable();
98
+ if (this.#servesDefault) {
99
+ throw new UncachedValueError(this.location);
100
100
  }
101
- return memberValueOf(this.parent.original, this.#key, this.#readFallbackKey);
102
101
  }
102
+ /**
103
+ * A container a `Val.properties` provider serves, and every container below it, is never owned, even when the
104
+ * provider serves a container the transaction cloned for another member. The provider keeps the value its setter
105
+ * accepted, so a later change must clone it again instead of changing it in place.
106
+ */
107
+ owns(container) {
108
+ return this.#dynamicContainer === void 0 && this.parent.owns(container);
109
+ }
110
+ adopt(container) {
111
+ this.parent.adopt(container);
112
+ }
113
+ /**
114
+ * Clones the container unless the transaction {@link owns} it, runs {@link mutator}, then stores the container in
115
+ * the parent. A dynamic provider's setter therefore receives the container after every change, with the change
116
+ * applied.
117
+ */
103
118
  change(mutator) {
104
- if (this.#expired) {
105
- throw new ExpiredReferenceError(this.location);
106
- }
119
+ ValReference.writableContainerOf(this);
107
120
  this.parent.change(() => {
108
- if (this.#clone && this.#value === this.original) {
109
- const newValue = this.#clone(this.#value);
110
- this.#writeTo(this.#dynamicContainer ?? this.parent.value, newValue);
111
- this.#replaceValue(newValue);
121
+ ValReference.writableContainerOf(this);
122
+ if (!this.owns(this.#value)) {
123
+ const clone = this.#clone(this.#value);
124
+ this.adopt(clone);
125
+ if (this.#binding === "entry" && typeof clone === "object" && clone !== null) {
126
+ (this.#copies ??= /* @__PURE__ */ new WeakSet()).add(clone);
127
+ }
128
+ this.#replaceValue(clone, "session");
112
129
  }
113
130
  mutator();
131
+ this.#writeTo(this.#dynamicContainer ?? this.parent.value, this.#value);
114
132
  }, this.#key);
115
133
  }
116
- refresh() {
117
- if (this.parent.expired) {
118
- this.#expired = true;
134
+ refresh(cause) {
135
+ if (this.expired) {
119
136
  return;
120
137
  }
121
138
  if (this.parent.value === void 0 || this.parent.value === null) {
122
- this.#expired = true;
123
- this.#replaceValue(void 0);
139
+ this.#servesDefault = false;
140
+ this.#follow(void 0, cause);
124
141
  return;
125
142
  }
126
143
  if (this.#dynamicContainer !== void 0 && this.parent.value !== this.#dynamicSource) {
@@ -129,8 +146,51 @@ class ManagedReference {
129
146
  throw new InternalError(`Value at ${this.location.path} no longer serves ${this.#key}`);
130
147
  }
131
148
  }
149
+ this.#follow(this.#memberValue(), cause);
150
+ }
151
+ #memberValue() {
132
152
  const value = this.#dynamicContainer === void 0 ? memberValueOf(this.parent.value, this.#key, this.#readFallbackKey) : memberValueOf(this.#dynamicContainer, this.#key, this.#fallbackKey);
133
- this.#replaceValue(value);
153
+ if (value !== void 0 || this.#makeDefault === void 0) {
154
+ this.#servesDefault = false;
155
+ return value;
156
+ }
157
+ if (!this.#servesDefault) {
158
+ this.#servesDefault = true;
159
+ return this.#makeDefault();
160
+ }
161
+ return this.#value;
162
+ }
163
+ /**
164
+ * Take `value` as the referenced value. An entry reference expires instead when a change in this session put
165
+ * another entry at its index. It accepts its entry and every copy it made of that entry, because only a rollback
166
+ * puts an earlier copy back. After another transaction's commit, an entry reference follows its index like a
167
+ * member reference and binds to the entry now there.
168
+ */
169
+ #follow(value, cause) {
170
+ if (this.#binding === "entry") {
171
+ if (cause === "external") {
172
+ this.#entry = value;
173
+ this.#copies = void 0;
174
+ } else if (!this.#holds(value)) {
175
+ this.#detach();
176
+ return;
177
+ }
178
+ }
179
+ this.#replaceValue(value, cause);
180
+ }
181
+ #holds(value) {
182
+ if (value === this.#entry) {
183
+ return true;
184
+ }
185
+ return typeof value === "object" && value !== null && !!this.#copies?.has(value);
186
+ }
187
+ /**
188
+ * Stop following the entry. The reference keeps its last value and is {@link expired}. It leaves the parent's
189
+ * subrefs, so the next read at its index creates a reference for the entry now there.
190
+ */
191
+ #detach() {
192
+ this.#detached = true;
193
+ delete this.parent.subrefs?.[this.#key];
134
194
  }
135
195
  /**
136
196
  * Bind to the provider the parent serves this member from, if it serves it from one. A provider belongs to the
@@ -155,12 +215,12 @@ class ManagedReference {
155
215
  delete container[this.#fallbackKey];
156
216
  }
157
217
  }
158
- #replaceValue(newValue) {
218
+ #replaceValue(newValue, cause) {
159
219
  this.#value = newValue;
160
220
  const subrefs = this.subrefs;
161
221
  if (subrefs) {
162
222
  for (const key in subrefs) {
163
- subrefs[key].refresh();
223
+ subrefs[key].refresh(cause);
164
224
  }
165
225
  }
166
226
  }
@@ -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
  }
@@ -52,7 +52,7 @@ function NameResolver(supervisor, model, name) {
52
52
  return;
53
53
  }
54
54
  return (val) => {
55
- const parent = val?.[Internal.reference]?.parent?.owner;
55
+ const parent = Internal.referenceOf(val)?.parent?.owner;
56
56
  if (parent) {
57
57
  return parentReader(parent);
58
58
  }
@@ -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,SAAS,cAAqB,kBAAmC;AAEjE,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAOvB,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,eAAe,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,aAAO,cAAc,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,eAAe,EAAE,wBAAwB,eAAe;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,SAAS,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,SAAS,cAAqB,kBAAmC;AAEjE,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAOvB,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,eAAe,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,aAAO,cAAc,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,eAAe,EAAE,wBAAwB,eAAe;AAClF;AAAA,IACJ;AAEA,UAAM,eAAe,aAAa,YAAY,cAAc,IAAI;AAChE,QAAI,CAAC,cAAc;AACf;AAAA,IACJ;AAEA,WAAO,CAAC,QAAa;AACjB,YAAM,SAAS,SAAS,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"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2022-2026 Matter.js Authors
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { ExpiredReferenceError } from "@matter/protocol";
7
+ class ReadOnlyReference {
8
+ primaryKey = "name";
9
+ expired = true;
10
+ subrefs;
11
+ owner;
12
+ location;
13
+ #value;
14
+ #rootOwner;
15
+ mirrorsRemote;
16
+ constructor(value, location, rootOwner, mirrorsRemote) {
17
+ this.#value = value;
18
+ this.location = location;
19
+ this.#rootOwner = rootOwner;
20
+ this.mirrorsRemote = mirrorsRemote;
21
+ }
22
+ get value() {
23
+ return this.#value;
24
+ }
25
+ get rootOwner() {
26
+ return this.#rootOwner;
27
+ }
28
+ change() {
29
+ throw new ExpiredReferenceError(this.location);
30
+ }
31
+ assertWritable() {
32
+ throw new ExpiredReferenceError(this.location);
33
+ }
34
+ refresh() {
35
+ }
36
+ owns() {
37
+ return false;
38
+ }
39
+ adopt() {
40
+ }
41
+ }
42
+ export {
43
+ ReadOnlyReference
44
+ };
45
+ //# 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,SAAwB,6BAAkC;AAWnD,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,sBAAsB,KAAK,QAAQ;AAAA,EACjD;AAAA,EAEA,iBAAiB;AACb,UAAM,IAAI,sBAAsB,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
@@ -1 +1 @@
1
- {"version":3,"file":"ValReference.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/ValReference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG;IAC7C;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC;IAET;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,CAAC;IAEhD;;;;;;;;;OASG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;CAC1C;AAED,yBAAiB,YAAY,CAAC;IAC1B;;;;;;OAMG;IACH,KAAY,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;CAC1C"}
1
+ {"version":3,"file":"ValReference.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/ValReference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpE;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG;IAC7C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,CAAC;IAEhD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE3D;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,YAAY,GAAG,IAAI,CAAC;IAEhD;;;;;;;;;;;;OAYG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;CAC1C;AAED,yBAAiB,YAAY,CAAC;IAC1B;;;;;OAKG;IACH,KAAY,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;IAElD;;;;;;;OAOG;IACH,KAAY,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;IAEvC;;;;;;;OAOG;IACH,SAAgB,WAAW,CAAC,CAAC,SAAS,GAAG,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CASrF;IAED;;;;;;;OAOG;IACH,SAAgB,mBAAmB,CAAC,CAAC,SAAS,GAAG,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAG7F;IAED;;;;;;OAMG;IACH,SAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,QAE7C;CACJ"}
@@ -3,4 +3,32 @@
3
3
  * Copyright 2022-2026 Matter.js Authors
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
+ import { ExpiredReferenceError, PhantomReferenceError } from "@matter/protocol";
7
+ import { Internal } from "./Internal.js";
8
+ var ValReference;
9
+ ((ValReference2) => {
10
+ function containerOf(reference) {
11
+ const container = reference.value;
12
+ if (container === void 0 || container === null) {
13
+ if (reference.expired) {
14
+ throw new ExpiredReferenceError(reference.location);
15
+ }
16
+ throw new PhantomReferenceError(reference.location);
17
+ }
18
+ return container;
19
+ }
20
+ ValReference2.containerOf = containerOf;
21
+ function writableContainerOf(reference) {
22
+ reference.assertWritable();
23
+ return containerOf(reference);
24
+ }
25
+ ValReference2.writableContainerOf = writableContainerOf;
26
+ function assertWritableValue(value) {
27
+ Internal.referenceOf(value)?.assertWritable();
28
+ }
29
+ ValReference2.assertWritableValue = assertWritableValue;
30
+ })(ValReference || (ValReference = {}));
31
+ export {
32
+ ValReference
33
+ };
6
34
  //# sourceMappingURL=ValReference.js.map
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/behavior/state/managed/ValReference.ts"],
4
- "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;",
5
- "names": []
4
+ "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,uBAAuB,6BAA6B;AAE7D,SAAS,gBAAgB;AAiHlB,IAAU;AAAA,CAAV,CAAUA,kBAAV;AA2BI,WAAS,YAA2B,WAA4C;AACnF,UAAM,YAAY,UAAU;AAC5B,QAAI,cAAc,UAAa,cAAc,MAAM;AAC/C,UAAI,UAAU,SAAS;AACnB,cAAM,IAAI,sBAAsB,UAAU,QAAQ;AAAA,MACtD;AACA,YAAM,IAAI,sBAAsB,UAAU,QAAQ;AAAA,IACtD;AACA,WAAO;AAAA,EACX;AATO,EAAAA,cAAS;AAmBT,WAAS,oBAAmC,WAA4C;AAC3F,cAAU,eAAe;AACzB,WAAO,YAAY,SAAS;AAAA,EAChC;AAHO,EAAAA,cAAS;AAYT,WAAS,oBAAoB,OAAY;AAC5C,aAAS,YAAY,KAAK,GAAG,eAAe;AAAA,EAChD;AAFO,EAAAA,cAAS;AAAA,GA1DH;",
5
+ "names": ["ValReference"]
6
6
  }
@@ -0,0 +1,25 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2022-2026 Matter.js Authors
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import type { SchemaErrorPath } from "@matter/model";
7
+ import { WriteError } from "@matter/protocol";
8
+ /**
9
+ * Thrown for a change in place of a mandatory list, struct or bitmap that the cluster state of a client node does not
10
+ * hold.
11
+ *
12
+ * The cluster state of a client node reads such a value as its default, so it reads like any other value. The default
13
+ * is not the device's value: the device's list may hold entries, its bitmap flags and its struct fields that the
14
+ * default does not have. Sending the default with a change would replace the device's value, so the change fails and
15
+ * nothing is stored or sent.
16
+ *
17
+ * Read the attribute from the device first, or assign a complete value. An assigned value replaces the value on the
18
+ * device, also when it was built from the default, such as `[...state.binding, entry]`. `Endpoint.set()` and
19
+ * `Endpoint.setStateOf()` assign each attribute value given for the cluster state of a client node whole, so they do
20
+ * not fail with this error.
21
+ */
22
+ export declare class UncachedValueError extends WriteError {
23
+ constructor(path: SchemaErrorPath);
24
+ }
25
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAC9C,YAAY,IAAI,EAAE,eAAe,EAMhC;CACJ"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2022-2026 Matter.js Authors
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { WriteError } from "@matter/protocol";
7
+ import { Status } from "@matter/types";
8
+ class UncachedValueError extends WriteError {
9
+ constructor(path) {
10
+ super(
11
+ path,
12
+ "The value is not cached; read it from the device first, or assign a complete value, which replaces the value on the device",
13
+ Status.InvalidInState
14
+ );
15
+ }
16
+ }
17
+ export {
18
+ UncachedValueError
19
+ };
20
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../src/behavior/state/managed/errors.ts"],
4
+ "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AAgBhB,MAAM,2BAA2B,WAAW;AAAA,EAC/C,YAAY,MAAuB;AAC/B;AAAA,MACI;AAAA,MACA;AAAA,MACA,OAAO;AAAA,IACX;AAAA,EACJ;AACJ;",
5
+ "names": []
6
+ }
@@ -4,4 +4,5 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
  export * from "./Instrumentation.js";
7
+ export * from "./errors.js";
7
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}
@@ -4,4 +4,5 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
  export * from "./Instrumentation.js";
7
+ export * from "./errors.js";
7
8
  //# sourceMappingURL=index.js.map