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

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 (353) 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/internal/BehaviorBacking.d.ts.map +1 -1
  15. package/dist/cjs/behavior/internal/BehaviorBacking.js +2 -0
  16. package/dist/cjs/behavior/internal/BehaviorBacking.js.map +1 -1
  17. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts +45 -0
  18. package/dist/cjs/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  19. package/dist/cjs/behavior/internal/ClusterDerivation.js +192 -0
  20. package/dist/cjs/behavior/internal/ClusterDerivation.js.map +6 -0
  21. package/dist/cjs/behavior/internal/ClusterStatics.d.ts +16 -0
  22. package/dist/cjs/behavior/internal/ClusterStatics.d.ts.map +1 -0
  23. package/dist/cjs/behavior/internal/ClusterStatics.js +138 -0
  24. package/dist/cjs/behavior/internal/ClusterStatics.js.map +6 -0
  25. package/dist/cjs/behavior/internal/ModeledState.d.ts +18 -0
  26. package/dist/cjs/behavior/internal/ModeledState.d.ts.map +1 -0
  27. package/dist/cjs/behavior/internal/ModeledState.js +54 -0
  28. package/dist/cjs/behavior/internal/ModeledState.js.map +6 -0
  29. package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  30. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js +3 -12
  31. package/dist/cjs/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  32. package/dist/cjs/behavior/state/managed/Datasource.js +28 -17
  33. package/dist/cjs/behavior/state/managed/Datasource.js.map +1 -1
  34. package/dist/cjs/behavior/state/managed/Internal.d.ts +16 -5
  35. package/dist/cjs/behavior/state/managed/Internal.d.ts.map +1 -1
  36. package/dist/cjs/behavior/state/managed/Internal.js +23 -25
  37. package/dist/cjs/behavior/state/managed/Internal.js.map +1 -1
  38. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts +45 -12
  39. package/dist/cjs/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  40. package/dist/cjs/behavior/state/managed/ManagedReference.js +74 -44
  41. package/dist/cjs/behavior/state/managed/ManagedReference.js.map +1 -1
  42. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts +31 -0
  43. package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  44. package/dist/cjs/behavior/state/managed/ReadOnlyReference.js +60 -0
  45. package/dist/cjs/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  46. package/dist/cjs/behavior/state/managed/ValReference.d.ts +47 -10
  47. package/dist/cjs/behavior/state/managed/ValReference.d.ts.map +1 -1
  48. package/dist/cjs/behavior/state/managed/ValReference.js +29 -0
  49. package/dist/cjs/behavior/state/managed/ValReference.js.map +2 -2
  50. package/dist/cjs/behavior/state/managed/values/BitmapManager.js +5 -20
  51. package/dist/cjs/behavior/state/managed/values/BitmapManager.js.map +1 -1
  52. package/dist/cjs/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  53. package/dist/cjs/behavior/state/managed/values/ListManager.js +262 -119
  54. package/dist/cjs/behavior/state/managed/values/ListManager.js.map +2 -2
  55. package/dist/cjs/behavior/state/managed/values/StructManager.js +14 -23
  56. package/dist/cjs/behavior/state/managed/values/StructManager.js.map +2 -2
  57. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts +13 -3
  58. package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  59. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js +12 -0
  60. package/dist/cjs/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  61. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  62. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  63. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js +9 -0
  64. package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  65. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  66. package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  67. package/dist/cjs/behavior/system/controller/ControllerBehavior.js +2 -1
  68. package/dist/cjs/behavior/system/controller/ControllerBehavior.js.map +1 -1
  69. package/dist/cjs/behavior/system/dcl/DclBehavior.d.ts +3 -3
  70. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  71. package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  72. package/dist/cjs/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  73. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  74. package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  75. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js +6 -1
  76. package/dist/cjs/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  77. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  78. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  79. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js +74 -0
  80. package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  81. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  82. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  83. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  84. package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  85. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts +2 -2
  86. package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  87. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  88. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  89. package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  90. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  91. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  92. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +104 -60
  93. package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  94. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  95. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  96. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  97. package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  98. package/dist/cjs/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  99. package/dist/cjs/behaviors/groupcast/GroupcastServer.js +41 -25
  100. package/dist/cjs/behaviors/groupcast/GroupcastServer.js.map +2 -2
  101. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  102. package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  103. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  104. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  105. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js +27 -23
  106. package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  107. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  108. package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  109. package/dist/cjs/behaviors/thermostat/ThermostatServer.js +66 -49
  110. package/dist/cjs/behaviors/thermostat/ThermostatServer.js.map +1 -1
  111. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  112. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  113. package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +1 -1
  114. package/dist/cjs/endpoint/properties/Behaviors.d.ts.map +1 -1
  115. package/dist/cjs/endpoint/properties/Behaviors.js +5 -1
  116. package/dist/cjs/endpoint/properties/Behaviors.js.map +1 -1
  117. package/dist/cjs/node/ClientNode.d.ts +6 -0
  118. package/dist/cjs/node/ClientNode.d.ts.map +1 -1
  119. package/dist/cjs/node/ClientNode.js +6 -0
  120. package/dist/cjs/node/ClientNode.js.map +1 -1
  121. package/dist/cjs/node/ServerNode.d.ts.map +1 -1
  122. package/dist/cjs/node/ServerNode.js +2 -0
  123. package/dist/cjs/node/ServerNode.js.map +1 -1
  124. package/dist/cjs/node/client/ClientEventEmitter.d.ts.map +1 -1
  125. package/dist/cjs/node/client/ClientEventEmitter.js +6 -2
  126. package/dist/cjs/node/client/ClientEventEmitter.js.map +1 -1
  127. package/dist/cjs/node/client/ClientStructure.d.ts.map +1 -1
  128. package/dist/cjs/node/client/ClientStructure.js +181 -108
  129. package/dist/cjs/node/client/ClientStructure.js.map +2 -2
  130. package/dist/cjs/node/client/Peers.d.ts +3 -2
  131. package/dist/cjs/node/client/Peers.d.ts.map +1 -1
  132. package/dist/cjs/node/client/Peers.js +8 -9
  133. package/dist/cjs/node/client/Peers.js.map +1 -1
  134. package/dist/cjs/node/integration/ChangeNotificationService.d.ts +14 -3
  135. package/dist/cjs/node/integration/ChangeNotificationService.d.ts.map +1 -1
  136. package/dist/cjs/node/integration/ProtocolService.d.ts.map +1 -1
  137. package/dist/cjs/node/integration/ProtocolService.js +38 -56
  138. package/dist/cjs/node/integration/ProtocolService.js.map +1 -1
  139. package/dist/cjs/node/server/InteractionServer.d.ts.map +1 -1
  140. package/dist/cjs/node/server/InteractionServer.js +28 -24
  141. package/dist/cjs/node/server/InteractionServer.js.map +2 -2
  142. package/dist/cjs/node/server/ServerSubscription.d.ts +7 -2
  143. package/dist/cjs/node/server/ServerSubscription.d.ts.map +1 -1
  144. package/dist/cjs/node/server/ServerSubscription.js +83 -47
  145. package/dist/cjs/node/server/ServerSubscription.js.map +1 -1
  146. package/dist/cjs/testing/mock-server-node.d.ts +2 -1
  147. package/dist/cjs/testing/mock-server-node.d.ts.map +1 -1
  148. package/dist/cjs/testing/mock-server-node.js +8 -5
  149. package/dist/cjs/testing/mock-server-node.js.map +2 -2
  150. package/dist/cjs/testing/node-helpers.d.ts +5 -0
  151. package/dist/cjs/testing/node-helpers.d.ts.map +1 -1
  152. package/dist/cjs/testing/node-helpers.js +4 -4
  153. package/dist/cjs/testing/node-helpers.js.map +1 -1
  154. package/dist/esm/behavior/Behavior.d.ts.map +1 -1
  155. package/dist/esm/behavior/Behavior.js +2 -0
  156. package/dist/esm/behavior/Behavior.js.map +1 -1
  157. package/dist/esm/behavior/Events.d.ts.map +1 -1
  158. package/dist/esm/behavior/Events.js +4 -2
  159. package/dist/esm/behavior/Events.js.map +1 -1
  160. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts +17 -3
  161. package/dist/esm/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
  162. package/dist/esm/behavior/cluster/ClusterBehavior.js +2 -20
  163. package/dist/esm/behavior/cluster/ClusterBehavior.js.map +1 -1
  164. package/dist/esm/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
  165. package/dist/esm/behavior/cluster/ClusterBehaviorType.js +10 -159
  166. package/dist/esm/behavior/cluster/ClusterBehaviorType.js.map +1 -1
  167. package/dist/esm/behavior/internal/BehaviorBacking.d.ts.map +1 -1
  168. package/dist/esm/behavior/internal/BehaviorBacking.js +2 -0
  169. package/dist/esm/behavior/internal/BehaviorBacking.js.map +1 -1
  170. package/dist/esm/behavior/internal/ClusterDerivation.d.ts +45 -0
  171. package/dist/esm/behavior/internal/ClusterDerivation.d.ts.map +1 -0
  172. package/dist/esm/behavior/internal/ClusterDerivation.js +172 -0
  173. package/dist/esm/behavior/internal/ClusterDerivation.js.map +6 -0
  174. package/dist/esm/behavior/internal/ClusterStatics.d.ts +16 -0
  175. package/dist/esm/behavior/internal/ClusterStatics.d.ts.map +1 -0
  176. package/dist/esm/behavior/internal/ClusterStatics.js +118 -0
  177. package/dist/esm/behavior/internal/ClusterStatics.js.map +6 -0
  178. package/dist/esm/behavior/internal/ModeledState.d.ts +18 -0
  179. package/dist/esm/behavior/internal/ModeledState.d.ts.map +1 -0
  180. package/dist/esm/behavior/internal/ModeledState.js +34 -0
  181. package/dist/esm/behavior/internal/ModeledState.js.map +6 -0
  182. package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
  183. package/dist/esm/behavior/internal/ServerBehaviorBacking.js +3 -12
  184. package/dist/esm/behavior/internal/ServerBehaviorBacking.js.map +1 -1
  185. package/dist/esm/behavior/state/managed/Datasource.js +28 -17
  186. package/dist/esm/behavior/state/managed/Datasource.js.map +1 -1
  187. package/dist/esm/behavior/state/managed/Internal.d.ts +16 -5
  188. package/dist/esm/behavior/state/managed/Internal.d.ts.map +1 -1
  189. package/dist/esm/behavior/state/managed/Internal.js +23 -25
  190. package/dist/esm/behavior/state/managed/Internal.js.map +1 -1
  191. package/dist/esm/behavior/state/managed/ManagedReference.d.ts +45 -12
  192. package/dist/esm/behavior/state/managed/ManagedReference.d.ts.map +1 -1
  193. package/dist/esm/behavior/state/managed/ManagedReference.js +75 -45
  194. package/dist/esm/behavior/state/managed/ManagedReference.js.map +1 -1
  195. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts +31 -0
  196. package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
  197. package/dist/esm/behavior/state/managed/ReadOnlyReference.js +40 -0
  198. package/dist/esm/behavior/state/managed/ReadOnlyReference.js.map +6 -0
  199. package/dist/esm/behavior/state/managed/ValReference.d.ts +47 -10
  200. package/dist/esm/behavior/state/managed/ValReference.d.ts.map +1 -1
  201. package/dist/esm/behavior/state/managed/ValReference.js +25 -0
  202. package/dist/esm/behavior/state/managed/ValReference.js.map +2 -2
  203. package/dist/esm/behavior/state/managed/values/BitmapManager.js +6 -21
  204. package/dist/esm/behavior/state/managed/values/BitmapManager.js.map +1 -1
  205. package/dist/esm/behavior/state/managed/values/ListManager.d.ts.map +1 -1
  206. package/dist/esm/behavior/state/managed/values/ListManager.js +264 -129
  207. package/dist/esm/behavior/state/managed/values/ListManager.js.map +2 -2
  208. package/dist/esm/behavior/state/managed/values/StructManager.js +15 -24
  209. package/dist/esm/behavior/state/managed/values/StructManager.js.map +2 -2
  210. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts +13 -3
  211. package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
  212. package/dist/esm/behavior/system/commissioning/CommissioningClient.js +12 -0
  213. package/dist/esm/behavior/system/commissioning/CommissioningClient.js.map +1 -1
  214. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
  215. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
  216. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js +10 -1
  217. package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
  218. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts +2 -1
  219. package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
  220. package/dist/esm/behavior/system/controller/ControllerBehavior.js +2 -1
  221. package/dist/esm/behavior/system/controller/ControllerBehavior.js.map +1 -1
  222. package/dist/esm/behavior/system/dcl/DclBehavior.d.ts +3 -3
  223. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
  224. package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
  225. package/dist/esm/behavior/system/network/ServerGroupNetworking.js.map +1 -1
  226. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
  227. package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
  228. package/dist/esm/behavior/system/sessions/SessionsBehavior.js +6 -1
  229. package/dist/esm/behavior/system/sessions/SessionsBehavior.js.map +1 -1
  230. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
  231. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
  232. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js +54 -0
  233. package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
  234. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
  235. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
  236. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
  237. package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
  238. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts +2 -2
  239. package/dist/esm/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
  240. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
  241. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
  242. package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
  243. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
  244. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
  245. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +105 -60
  246. package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
  247. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
  248. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
  249. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
  250. package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
  251. package/dist/esm/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
  252. package/dist/esm/behaviors/groupcast/GroupcastServer.js +42 -25
  253. package/dist/esm/behaviors/groupcast/GroupcastServer.js.map +2 -2
  254. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
  255. package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
  256. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
  257. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
  258. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js +32 -24
  259. package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
  260. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts +15 -4
  261. package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
  262. package/dist/esm/behaviors/thermostat/ThermostatServer.js +66 -49
  263. package/dist/esm/behaviors/thermostat/ThermostatServer.js.map +1 -1
  264. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
  265. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
  266. package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +1 -1
  267. package/dist/esm/endpoint/properties/Behaviors.d.ts.map +1 -1
  268. package/dist/esm/endpoint/properties/Behaviors.js +6 -2
  269. package/dist/esm/endpoint/properties/Behaviors.js.map +1 -1
  270. package/dist/esm/node/ClientNode.d.ts +6 -0
  271. package/dist/esm/node/ClientNode.d.ts.map +1 -1
  272. package/dist/esm/node/ClientNode.js +6 -0
  273. package/dist/esm/node/ClientNode.js.map +1 -1
  274. package/dist/esm/node/ServerNode.d.ts.map +1 -1
  275. package/dist/esm/node/ServerNode.js +2 -0
  276. package/dist/esm/node/ServerNode.js.map +1 -1
  277. package/dist/esm/node/client/ClientEventEmitter.d.ts.map +1 -1
  278. package/dist/esm/node/client/ClientEventEmitter.js +6 -2
  279. package/dist/esm/node/client/ClientEventEmitter.js.map +1 -1
  280. package/dist/esm/node/client/ClientStructure.d.ts.map +1 -1
  281. package/dist/esm/node/client/ClientStructure.js +181 -108
  282. package/dist/esm/node/client/ClientStructure.js.map +2 -2
  283. package/dist/esm/node/client/Peers.d.ts +3 -2
  284. package/dist/esm/node/client/Peers.d.ts.map +1 -1
  285. package/dist/esm/node/client/Peers.js +8 -10
  286. package/dist/esm/node/client/Peers.js.map +1 -1
  287. package/dist/esm/node/integration/ChangeNotificationService.d.ts +14 -3
  288. package/dist/esm/node/integration/ChangeNotificationService.d.ts.map +1 -1
  289. package/dist/esm/node/integration/ProtocolService.d.ts.map +1 -1
  290. package/dist/esm/node/integration/ProtocolService.js +40 -57
  291. package/dist/esm/node/integration/ProtocolService.js.map +1 -1
  292. package/dist/esm/node/server/InteractionServer.d.ts.map +1 -1
  293. package/dist/esm/node/server/InteractionServer.js +28 -25
  294. package/dist/esm/node/server/InteractionServer.js.map +2 -2
  295. package/dist/esm/node/server/ServerSubscription.d.ts +7 -2
  296. package/dist/esm/node/server/ServerSubscription.d.ts.map +1 -1
  297. package/dist/esm/node/server/ServerSubscription.js +83 -47
  298. package/dist/esm/node/server/ServerSubscription.js.map +1 -1
  299. package/dist/esm/testing/mock-server-node.d.ts +2 -1
  300. package/dist/esm/testing/mock-server-node.d.ts.map +1 -1
  301. package/dist/esm/testing/mock-server-node.js +16 -7
  302. package/dist/esm/testing/mock-server-node.js.map +2 -2
  303. package/dist/esm/testing/node-helpers.d.ts +5 -0
  304. package/dist/esm/testing/node-helpers.d.ts.map +1 -1
  305. package/dist/esm/testing/node-helpers.js +4 -4
  306. package/dist/esm/testing/node-helpers.js.map +1 -1
  307. package/package.json +6 -6
  308. package/src/behavior/Behavior.ts +2 -0
  309. package/src/behavior/Events.ts +6 -3
  310. package/src/behavior/cluster/ClusterBehavior.ts +22 -13
  311. package/src/behavior/cluster/ClusterBehaviorType.ts +9 -270
  312. package/src/behavior/internal/BehaviorBacking.ts +3 -0
  313. package/src/behavior/internal/ClusterDerivation.ts +295 -0
  314. package/src/behavior/internal/ClusterStatics.ts +180 -0
  315. package/src/behavior/internal/ModeledState.ts +58 -0
  316. package/src/behavior/internal/ServerBehaviorBacking.ts +3 -15
  317. package/src/behavior/state/managed/Datasource.ts +36 -21
  318. package/src/behavior/state/managed/Internal.ts +36 -33
  319. package/src/behavior/state/managed/ManagedReference.ts +120 -68
  320. package/src/behavior/state/managed/ReadOnlyReference.ts +54 -0
  321. package/src/behavior/state/managed/ValReference.ts +67 -11
  322. package/src/behavior/state/managed/values/BitmapManager.ts +6 -22
  323. package/src/behavior/state/managed/values/ListManager.ts +301 -146
  324. package/src/behavior/state/managed/values/StructManager.ts +20 -29
  325. package/src/behavior/system/commissioning/CommissioningClient.ts +22 -3
  326. package/src/behavior/system/commissioning/RemoteDescriptor.ts +17 -1
  327. package/src/behavior/system/controller/ControllerBehavior.ts +2 -1
  328. package/src/behavior/system/dcl/DclBehavior.ts +3 -3
  329. package/src/behavior/system/network/ServerGroupNetworking.ts +3 -2
  330. package/src/behavior/system/sessions/SessionsBehavior.ts +8 -2
  331. package/src/behavior/system/subscriptions/SubscriptionStore.ts +66 -0
  332. package/src/behavior/system/subscriptions/SubscriptionsServer.ts +73 -33
  333. package/src/behaviors/access-control/AccessControlServer.ts +3 -3
  334. package/src/behaviors/administrator-commissioning/AdministratorCommissioningServer.ts +47 -24
  335. package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts +138 -84
  336. package/src/behaviors/group-key-management/GroupKeyManagementServer.ts +12 -8
  337. package/src/behaviors/groupcast/GroupcastServer.ts +50 -34
  338. package/src/behaviors/localization-configuration/LocalizationConfigurationServer.ts +1 -1
  339. package/src/behaviors/operational-credentials/VendorIdVerification.ts +50 -35
  340. package/src/behaviors/thermostat/ThermostatServer.ts +93 -70
  341. package/src/behaviors/time-format-localization/TimeFormatLocalizationServer.ts +4 -4
  342. package/src/endpoint/properties/Behaviors.ts +6 -2
  343. package/src/node/ClientNode.ts +6 -0
  344. package/src/node/ServerNode.ts +2 -0
  345. package/src/node/client/ClientEventEmitter.ts +7 -3
  346. package/src/node/client/ClientStructure.ts +208 -135
  347. package/src/node/client/Peers.ts +10 -14
  348. package/src/node/integration/ChangeNotificationService.ts +18 -3
  349. package/src/node/integration/ProtocolService.ts +45 -57
  350. package/src/node/server/InteractionServer.ts +33 -35
  351. package/src/node/server/ServerSubscription.ts +88 -50
  352. package/src/testing/mock-server-node.ts +22 -9
  353. package/src/testing/node-helpers.ts +5 -1
@@ -38,6 +38,7 @@ import {
38
38
  ElementTag,
39
39
  GeneratedCommandList,
40
40
  Matter,
41
+ SecretRedaction,
41
42
  } from "@matter/model";
42
43
  import type {
43
44
  AttributeTypeProtocol,
@@ -509,6 +510,7 @@ function clusterTypeProtocolOf(backing: BehaviorBacking): ClusterTypeProtocol |
509
510
  const attr: AttributeTypeProtocol = {
510
511
  id: id as AttributeId,
511
512
  tlv,
513
+ schema: member,
512
514
  wildcardPathFlags,
513
515
  limits,
514
516
  name,
@@ -622,6 +624,11 @@ function validateCommandPayload(
622
624
  });
623
625
  }
624
626
 
627
+ function redactedPayloadDiagnostic(model: CommandModel | undefined, payload: object) {
628
+ const redacted = SecretRedaction.redact(model, payload);
629
+ return isObject(redacted) ? Diagnostic.dict(redacted) : redacted;
630
+ }
631
+
625
632
  /**
626
633
  * Invokes a command on a backing behavior
627
634
  */
@@ -638,7 +645,7 @@ function invokeCommand(
638
645
 
639
646
  let requestDiagnostic: unknown;
640
647
  if (isObject(request)) {
641
- requestDiagnostic = Diagnostic.dict(request);
648
+ requestDiagnostic = redactedPayloadDiagnostic(commandModels?.requestModel, request);
642
649
  } else if (request !== undefined) {
643
650
  requestDiagnostic = request;
644
651
  } else {
@@ -647,7 +654,6 @@ function invokeCommand(
647
654
 
648
655
  const { path, endpoint } = backing;
649
656
  const context = session as ActionContext;
650
-
651
657
  logger.info(
652
658
  "Invoke",
653
659
  Mark.INBOUND,
@@ -683,6 +689,41 @@ function invokeCommand(
683
689
  ? (name: string) => (name === camelize(commandModels.requestModel.name) ? request : undefined)
684
690
  : undefined;
685
691
 
692
+ const { transaction } = session;
693
+
694
+ /**
695
+ * Validate and log the response of the command, as returned or once its promise resolves.
696
+ */
697
+ function completeResponse(result: unknown) {
698
+ if (commandModels?.responseModel) {
699
+ try {
700
+ validateCommandPayload(
701
+ result as Val.Struct | undefined,
702
+ commandModels.responseModel,
703
+ commandModels.supervisor,
704
+ session,
705
+ outerResolve,
706
+ );
707
+ } catch (e) {
708
+ const error = new StatusResponse.FailureError(
709
+ `Response validation failed for ${command.name}: ${asError(e).message}`,
710
+ );
711
+ error.cause = e;
712
+ throw error;
713
+ }
714
+ }
715
+ if (isObject(result)) {
716
+ logger.info(
717
+ "Invoke",
718
+ Mark.OUTBOUND,
719
+ Diagnostic.strong(path.at(camelize(command.name))),
720
+ transaction.via,
721
+ redactedPayloadDiagnostic(commandModels?.responseModel, result),
722
+ );
723
+ }
724
+ return result;
725
+ }
726
+
686
727
  const agent = endpoint.agentFor(context);
687
728
  const behavior = agent.get(backing.type);
688
729
 
@@ -721,63 +762,10 @@ function invokeCommand(
721
762
  if (MaybePromise.is(result)) {
722
763
  isAsync = true;
723
764
  result = Promise.resolve(result)
724
- .then(result => {
725
- if (commandModels?.responseModel) {
726
- try {
727
- validateCommandPayload(
728
- result as Val.Struct | undefined,
729
- commandModels.responseModel,
730
- commandModels.supervisor,
731
- session,
732
- outerResolve,
733
- );
734
- } catch (e) {
735
- const error = new StatusResponse.FailureError(
736
- `Response validation failed for ${command.name}: ${asError(e).message}`,
737
- );
738
- error.cause = e;
739
- throw error;
740
- }
741
- }
742
- if (isObject(result)) {
743
- logger.info(
744
- "Invoke",
745
- Mark.OUTBOUND,
746
- Diagnostic.strong(path.at(camelize(command.name))),
747
- session.transaction!.via,
748
- Diagnostic.dict(result),
749
- );
750
- }
751
- return result;
752
- })
765
+ .then(completeResponse)
753
766
  .finally(() => activity?.[Symbol.dispose]());
754
767
  } else {
755
- if (commandModels?.responseModel) {
756
- try {
757
- validateCommandPayload(
758
- result as Val.Struct | undefined,
759
- commandModels.responseModel,
760
- commandModels.supervisor,
761
- session,
762
- outerResolve,
763
- );
764
- } catch (e) {
765
- const error = new StatusResponse.FailureError(
766
- `Response validation failed for ${command.name}: ${asError(e).message}`,
767
- );
768
- error.cause = e;
769
- throw error;
770
- }
771
- }
772
- if (isObject(result)) {
773
- logger.info(
774
- "Invoke",
775
- Mark.OUTBOUND,
776
- Diagnostic.strong(path.at(camelize(command.name))),
777
- session.transaction.via,
778
- Diagnostic.dict(result),
779
- );
780
- }
768
+ completeResponse(result);
781
769
  }
782
770
  } finally {
783
771
  if (!isAsync) {
@@ -646,7 +646,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
646
646
 
647
647
  if (fabric !== undefined && !keepSubscriptions) {
648
648
  let clearedCount = 0;
649
- for (const sess of this.#context.sessions.sessions) {
649
+ for (const sess of this.#context.sessions.registeredSessions) {
650
650
  // TODO Adjust this filtering when subscriptions move to Peer
651
651
  if (!PeerAddress.is(sess.peerAddress, session.peerAddress)) {
652
652
  // Ignore subscriptions from other peers
@@ -761,40 +761,37 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
761
761
  const maxInterval = subscription.maxInterval;
762
762
 
763
763
  // Then send the subscription response
764
- await messenger.send(
765
- MessageType.SubscribeResponse,
766
- TlvSubscribeResponse.encode({
767
- subscriptionId,
768
- maxInterval: Seconds.of(maxInterval),
769
- interactionModelRevision: Specification.INTERACTION_MODEL_REVISION,
770
- }),
771
- {
772
- logContext: {
773
- ...Subscription.diagnosticOf(subscriptionId),
774
- maxInterval: Duration.format(maxInterval),
764
+ try {
765
+ await messenger.send(
766
+ MessageType.SubscribeResponse,
767
+ TlvSubscribeResponse.encode({
768
+ subscriptionId,
769
+ maxInterval: Seconds.of(maxInterval),
770
+ interactionModelRevision: Specification.INTERACTION_MODEL_REVISION,
771
+ }),
772
+ {
773
+ logContext: {
774
+ ...Subscription.diagnosticOf(subscriptionId),
775
+ maxInterval: Duration.format(maxInterval),
776
+ },
775
777
  },
776
- },
777
- );
778
+ );
779
+ } catch (error) {
780
+ await subscription.close();
781
+ throw error;
782
+ }
778
783
 
779
- // When an error occurs while sending the response, the subscription is not yet active and will be cleaned up by GC
780
784
  if (subscription.activate()) {
781
785
  this.#counters.totalSubscriptionsEstablished++;
782
786
  }
783
787
  }
784
788
 
785
- #initiateSubscriptionExchange(addressOrSession: PeerAddress | Session, protocolId: number) {
786
- const exchange =
787
- addressOrSession instanceof Session
788
- ? this.#context.exchangeManager.initiateExchangeForSession(
789
- addressOrSession,
790
- protocolId,
791
- SUBSCRIPTION_EXCHANGE_OPTIONS,
792
- )
793
- : this.#context.exchangeManager.initiateExchange(
794
- addressOrSession,
795
- protocolId,
796
- SUBSCRIPTION_EXCHANGE_OPTIONS,
797
- );
789
+ #initiateSubscriptionExchange(session: Session, protocolId: number) {
790
+ const exchange = this.#context.exchangeManager.initiateExchangeForSession(
791
+ session,
792
+ protocolId,
793
+ SUBSCRIPTION_EXCHANGE_OPTIONS,
794
+ );
798
795
 
799
796
  // Count subscription report messages we push and the acks we receive in response
800
797
  this.#countExchangeMessages(exchange);
@@ -813,8 +810,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
813
810
  const context: ServerSubscriptionContext = {
814
811
  session,
815
812
  node: this.#node,
816
- initiateExchange: (addressOrSession, protocolId) =>
817
- this.#initiateSubscriptionExchange(addressOrSession, protocolId),
813
+ initiateExchange: (session, protocolId) => this.#initiateSubscriptionExchange(session, protocolId),
818
814
  };
819
815
 
820
816
  const subscription = new ServerSubscription({
@@ -881,8 +877,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
881
877
  const context: ServerSubscriptionContext = {
882
878
  session,
883
879
  node: this.#node,
884
- initiateExchange: (addressOrSession, protocolId) =>
885
- this.#initiateSubscriptionExchange(addressOrSession, protocolId),
880
+ initiateExchange: (session, protocolId) => this.#initiateSubscriptionExchange(session, protocolId),
886
881
  };
887
882
 
888
883
  subscription = new ServerSubscription({
@@ -958,7 +953,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
958
953
  const jitter = delayJitterWindowMs > 0 ? this.#node.env.get(Entropy).randomUint32 % delayJitterWindowMs : 0;
959
954
  const delay = Millis(delayMinMs + jitter);
960
955
 
961
- for (const session of this.#context.sessions.sessions) {
956
+ for (const session of this.#context.sessions.registeredSessions) {
962
957
  for (const subscription of session.subscriptions) {
963
958
  if (subscription instanceof ServerSubscription && subscription.selectsAnyEndpoint(endpoints)) {
964
959
  subscription.deferReports(delay);
@@ -1055,6 +1050,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
1055
1050
  // Emitted => access allowed (denied paths are dropped, see below); AccessAllowed is the
1056
1051
  // access-control outcome, not command success (Groupcast spec §11.27.7.6.3).
1057
1052
  this.#context.sessions.emitGroupMessage({
1053
+ kind: "authenticated",
1058
1054
  result: Groupcast.GroupcastTestResult.Success,
1059
1055
  fabric,
1060
1056
  groupId,
@@ -1070,9 +1066,10 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
1070
1066
  if (!emitted) {
1071
1067
  const subject = groupSession?.subjectFor(message);
1072
1068
  if (subject !== undefined && Subject.isGroup(subject) && !subject.hasValidMapping) {
1073
- // The authenticating key is not the one mapped for the group: improperly authenticated per
1074
- // core§11.27.7.6.3, reported without the unauthenticated group id
1069
+ // GroupKeyMap or the key set changed after decode accepted the key: improperly authenticated per
1070
+ // core§11.27.7.6.3, reported without the group id
1075
1071
  this.#context.sessions.emitGroupMessage({
1072
+ kind: "authenticated",
1076
1073
  result: Groupcast.GroupcastTestResult.FailedAuth,
1077
1074
  fabric,
1078
1075
  sourceIp,
@@ -1088,6 +1085,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
1088
1085
  memberEndpoints !== undefined && memberEndpoints.length > 0 ? false : undefined;
1089
1086
  for (const { commandPath } of invokeRequests) {
1090
1087
  this.#context.sessions.emitGroupMessage({
1088
+ kind: "authenticated",
1091
1089
  result: Groupcast.GroupcastTestResult.Success,
1092
1090
  fabric,
1093
1091
  groupId,
@@ -38,7 +38,6 @@ import {
38
38
  EventReadResponse,
39
39
  InteractionServerMessenger,
40
40
  NumberedOccurrence,
41
- PeerAddress,
42
41
  Read,
43
42
  ReadResult,
44
43
  SessionClosedError,
@@ -118,10 +117,10 @@ export namespace ServerSubscriptionConfig {
118
117
  * Interface between {@link ServerSubscription} and the local Matter environment.
119
118
  */
120
119
  export interface ServerSubscriptionContext {
121
- // TODO - remove this. Subscriptions are associated with a peer, not a session
120
+ /** The session the subscription is set up on. {@link ServerSubscription.session} changes when it is superseded. */
122
121
  session: NodeSession;
123
122
  node: ServerNode;
124
- initiateExchange(addressOrSession: PeerAddress | Session, protocolId: number): MessageExchange;
123
+ initiateExchange(session: Session, protocolId: number): MessageExchange;
125
124
  }
126
125
 
127
126
  /**
@@ -153,7 +152,7 @@ export class ServerSubscription implements Subscription {
153
152
  #seededClusterDetails? = new Map<string, number>();
154
153
  #latestSeededEventNumber? = EventNumber(0);
155
154
  readonly #sendInterval: Duration;
156
- readonly #peerAddress: PeerAddress;
155
+ #session: NodeSession;
157
156
 
158
157
  #sendNextUpdateImmediately = false;
159
158
  /** The send interval timer fired since the last pass started, so the next pass sends even without data. */
@@ -176,8 +175,8 @@ export class ServerSubscription implements Subscription {
176
175
  this.#request = request;
177
176
 
178
177
  this.#context = context;
179
-
180
- this.#peerAddress = this.session.peerAddress;
178
+ this.#session = context.session;
179
+ this.#session.superseded.on(this.#follow);
181
180
 
182
181
  let maxInterval: Duration;
183
182
  let sendInterval: Duration;
@@ -211,8 +210,12 @@ export class ServerSubscription implements Subscription {
211
210
  return hex.fixed(this.#id, 8);
212
211
  }
213
212
 
213
+ /**
214
+ * The session the subscription reports on. It changes when a newer session of the subscriber supersedes it, see
215
+ * {@link NodeSession.superseded}.
216
+ */
214
217
  get session() {
215
- return this.#context.session;
218
+ return this.#session;
216
219
  }
217
220
 
218
221
  get isTerminated() {
@@ -414,13 +417,14 @@ export class ServerSubscription implements Subscription {
414
417
  // The owning session is already tearing down and its subscriptions have been swept, so registering here
415
418
  // would orphan us on a dead session and spin the update timer against a closing session manager. Drop the
416
419
  // change handlers registered while seeding and stay inert; the controller re-subscribes on reconnect.
420
+ this.#session.superseded.off(this.#follow);
417
421
  this.#changeHandlers.close();
418
422
  this.#isClosed = true;
419
423
  return false;
420
424
  }
421
425
  this.session.subscriptions.add(this);
422
426
  logger.debug(this.session.via, "New subscription", Diagnostic.strong(this.idStr));
423
- this.#lifetime = this.#context.session.join("subscription", Diagnostic.strong(this.#id));
427
+ this.#lifetime = this.session.join("subscription", Diagnostic.strong(this.#id));
424
428
 
425
429
  // We do not need these data anymore, so we can free some memory
426
430
  if (this.request.eventFilters !== undefined) this.request.eventFilters.length = 0;
@@ -550,9 +554,10 @@ export class ServerSubscription implements Subscription {
550
554
  this.#lastUpdateTime = Time.nowUs;
551
555
  this.#reportDueAt = Timestamp(this.#lastUpdateTime + this.#sendInterval);
552
556
 
557
+ const sentOn = session ?? this.session;
553
558
  try {
554
559
  using sending = updating?.join("sending");
555
- if (await this.#sendUpdateMessage(sending, attributeFilter, eventsMinNumber, onlyWithData, session)) {
560
+ if (await this.#sendUpdateMessage(sending, attributeFilter, eventsMinNumber, onlyWithData, sentOn)) {
556
561
  this.#sendUpdateErrorCounter = 0;
557
562
  }
558
563
  } catch (error) {
@@ -561,48 +566,45 @@ export class ServerSubscription implements Subscription {
561
566
  return;
562
567
  }
563
568
 
564
- this.#sendUpdateErrorCounter++;
565
- logger.info(
566
- `Error sending subscription update message (error count=${this.#sendUpdateErrorCounter}):`,
567
- (error instanceof MatterError && error.message) || error,
568
- );
569
- if (this.#sendUpdateErrorCounter <= 2) {
570
- // fill the data back in the queue to resend with next try
571
- if (attributeFilter !== undefined) {
572
- for (const [endpointId, clusters] of Object.entries(attributeFilter)) {
573
- for (const [clusterId, attributes] of Object.entries(clusters)) {
574
- this.#addOutstandingAttributes(
575
- EndpointNumber(parseInt(endpointId), false),
576
- ClusterId(parseInt(clusterId), false),
577
- Array.from(attributes),
578
- );
579
- }
580
- }
581
- }
582
- if (eventsMinNumber !== undefined) {
583
- this.#outstandingEventsMinNumber = eventsMinNumber; // newer number are always higher, so we can just set it
584
- }
569
+ if (sentOn !== this.session) {
570
+ // A failure on a session the subscription has left says nothing about the session it reports on
571
+ logger.debug(
572
+ `Resending update of subscription ${this.idStr} on its new session after a failure on its former one:`,
573
+ (error instanceof MatterError && error.message) || error,
574
+ );
575
+ this.#requeueUpdate(attributeFilter, eventsMinNumber);
576
+ this.#keepAliveOwed ||= !onlyWithData;
577
+ this.#sendNextUpdateImmediately = true;
585
578
  } else {
586
- logger.notice(
587
- `Giving up on subscription ${this.idStr} after 3 failed updates; the controller must subscribe again`,
579
+ this.#sendUpdateErrorCounter++;
580
+ logger.info(
581
+ `Error sending subscription update message (error count=${this.#sendUpdateErrorCounter}):`,
582
+ (error instanceof MatterError && error.message) || error,
588
583
  );
589
- this.#sendNextUpdateImmediately = false;
590
- if (
591
- causedBy(
592
- error,
593
- TransientPeerCommunicationError,
594
- NoResponseTimeoutError,
595
- NetworkError,
596
- SessionClosedError,
597
- )
598
- ) {
599
- // The session is left alone: failing to push reports says nothing about whether the
600
- // controller can still reach us, and recovery is its call regardless
601
- using _messaging = updating?.join("abandoning");
602
- await this.#closeFromUpdate();
603
- break;
584
+ if (this.#sendUpdateErrorCounter <= 2) {
585
+ this.#requeueUpdate(attributeFilter, eventsMinNumber);
604
586
  } else {
605
- throw error;
587
+ logger.notice(
588
+ `Giving up on subscription ${this.idStr} after 3 failed updates; the controller must subscribe again`,
589
+ );
590
+ this.#sendNextUpdateImmediately = false;
591
+ if (
592
+ causedBy(
593
+ error,
594
+ TransientPeerCommunicationError,
595
+ NoResponseTimeoutError,
596
+ NetworkError,
597
+ SessionClosedError,
598
+ )
599
+ ) {
600
+ // The session is left alone: failing to push reports says nothing about whether the
601
+ // controller can still reach us, and recovery is its call regardless
602
+ using _messaging = updating?.join("abandoning");
603
+ await this.#closeFromUpdate();
604
+ break;
605
+ } else {
606
+ throw error;
607
+ }
606
608
  }
607
609
  }
608
610
  }
@@ -623,6 +625,24 @@ export class ServerSubscription implements Subscription {
623
625
  }
624
626
  }
625
627
 
628
+ /** Put the data of an update that failed back into the queue, so the next update sends it. */
629
+ #requeueUpdate(attributeFilter: DirtyState.ForCluster | undefined, eventsMinNumber: EventNumber | undefined) {
630
+ if (attributeFilter !== undefined) {
631
+ for (const [endpointId, clusters] of Object.entries(attributeFilter)) {
632
+ for (const [clusterId, attributes] of Object.entries(clusters)) {
633
+ this.#addOutstandingAttributes(
634
+ EndpointNumber(parseInt(endpointId), false),
635
+ ClusterId(parseInt(clusterId), false),
636
+ Array.from(attributes),
637
+ );
638
+ }
639
+ }
640
+ }
641
+ if (eventsMinNumber !== undefined) {
642
+ this.#outstandingEventsMinNumber = eventsMinNumber; // newer number are always higher, so we can just set it
643
+ }
644
+ }
645
+
626
646
  /**
627
647
  * Returns an iterator that yields the data reports and events data for the given read request.
628
648
  */
@@ -796,6 +816,23 @@ export class ServerSubscription implements Subscription {
796
816
  await this.#cancel();
797
817
  }
798
818
 
819
+ /** Continue on {@link newer}, which superseded the session of the subscription. */
820
+ readonly #follow = (newer: NodeSession) => {
821
+ const former = this.#session;
822
+ former.superseded.off(this.#follow);
823
+ newer.superseded.on(this.#follow);
824
+ this.#session = newer;
825
+
826
+ if (this.#lifetime !== undefined) {
827
+ former.subscriptions.delete(this);
828
+ newer.subscriptions.add(this);
829
+ this.#lifetime.owner = newer.activate();
830
+ // Failures on the former session say nothing about the new one
831
+ this.#sendUpdateErrorCounter = 0;
832
+ }
833
+ logger.debug(newer.via, "Subscription", Diagnostic.strong(this.idStr), "moved from", former.via);
834
+ };
835
+
799
836
  /** Returns false if the subscription was already closed. */
800
837
  #markClosed(terminate: boolean) {
801
838
  if (this.#isClosed) {
@@ -818,6 +855,7 @@ export class ServerSubscription implements Subscription {
818
855
 
819
856
  this.#sendUpdatesActivated = false;
820
857
 
858
+ this.#session.superseded.off(this.#follow);
821
859
  this.#changeHandlers.close();
822
860
 
823
861
  if (flushViaSession !== undefined) {
@@ -895,9 +933,9 @@ export class ServerSubscription implements Subscription {
895
933
  attributeFilter: DirtyState.ForCluster | undefined,
896
934
  eventsMinNumber: EventNumber | undefined,
897
935
  onlyWithData: boolean,
898
- session?: Session,
936
+ session: Session,
899
937
  ) {
900
- const exchange = this.#context.initiateExchange(session ?? this.#peerAddress, INTERACTION_PROTOCOL_ID);
938
+ const exchange = this.#context.initiateExchange(session, INTERACTION_PROTOCOL_ID);
901
939
  if (exchange === undefined) {
902
940
  return false;
903
941
  }
@@ -31,8 +31,16 @@ import {
31
31
  nextEmitOf,
32
32
  } from "@matter/general";
33
33
  import { AccessLevel, MatterModel } from "@matter/model";
34
- import { ExchangeManager, FabricManager, ProtocolMocks, SessionManager, TestFabric } from "@matter/protocol";
35
- import { FabricIndex, NodeId } from "@matter/types";
34
+ import {
35
+ ExchangeManager,
36
+ FabricManager,
37
+ PeerAddress,
38
+ ProtocolMocks,
39
+ Session,
40
+ SessionManager,
41
+ TestFabric,
42
+ } from "@matter/protocol";
43
+ import { FabricIndex, INTERACTION_PROTOCOL_ID, NodeId } from "@matter/types";
36
44
  import { MockExchange } from "./mock-exchange.js";
37
45
 
38
46
  const logger = Logger.get("MockServerNode");
@@ -237,15 +245,19 @@ export class MockServerNode<T extends MockServerNode.RootEndpoint = MockServerNo
237
245
  throw error;
238
246
  }
239
247
 
240
- node.env.get(ExchangeManager).initiateExchange = address => {
241
- const exchange = new MockExchange(address, {
242
- session: node.env.get(SessionManager).maybeSessionFor(address),
243
- });
244
-
248
+ const exchanges = node.env.get(ExchangeManager);
249
+ const initiateExchangeForSession = exchanges.initiateExchangeForSession.bind(exchanges);
250
+ const interceptExchange = (address: PeerAddress, session?: Session) => {
251
+ const exchange = new MockExchange(address, { session });
245
252
  node.#newExchanges.write(exchange);
246
-
247
253
  return exchange;
248
254
  };
255
+ exchanges.initiateExchange = address =>
256
+ interceptExchange(address, node.env.get(SessionManager).maybeSessionFor(address));
257
+ exchanges.initiateExchangeForSession = (session, protocolId, options) =>
258
+ protocolId === INTERACTION_PROTOCOL_ID && session instanceof ProtocolMocks.NodeSession
259
+ ? interceptExchange(session.peerAddress, session)
260
+ : initiateExchangeForSession(session, protocolId, options);
249
261
 
250
262
  if (!node.lifecycle.isOnline) {
251
263
  await nextEmitOf(node.lifecycle.online);
@@ -255,7 +267,8 @@ export class MockServerNode<T extends MockServerNode.RootEndpoint = MockServerNo
255
267
  }
256
268
 
257
269
  /**
258
- * Resolves with the next exchange the node initiates towards a peer. Only available on nodes made by {@link createOnline}.
270
+ * Resolves with the next exchange the node initiates towards a peer, by address or as an interaction exchange on a
271
+ * mock session such as one {@link createExchange} creates. Only available on nodes made by {@link createOnline}.
259
272
  */
260
273
  async handleExchange(): Promise<MockExchange> {
261
274
  return await this.#newExchanges.read();
@@ -315,7 +315,11 @@ export function CommissioningHelper() {
315
315
  }
316
316
 
317
317
  export namespace interaction {
318
- const BarelyMockedMessenger = {
318
+ /**
319
+ * Messenger that discards everything the interaction server sends, enough for handlers whose response a test does
320
+ * not read.
321
+ */
322
+ export const BarelyMockedMessenger = {
319
323
  sendStatus: (_code: Status) => {},
320
324
  sendDataReport: async (_options: unknown) => {},
321
325
  send: async (_type: number, _message: Bytes) => {},