@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.
- package/dist/cjs/behavior/Behavior.d.ts.map +1 -1
- package/dist/cjs/behavior/Behavior.js +2 -0
- package/dist/cjs/behavior/Behavior.js.map +1 -1
- package/dist/cjs/behavior/Events.d.ts.map +1 -1
- package/dist/cjs/behavior/Events.js +4 -2
- package/dist/cjs/behavior/Events.js.map +1 -1
- package/dist/cjs/behavior/cluster/ClusterBehavior.d.ts +17 -3
- package/dist/cjs/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
- package/dist/cjs/behavior/cluster/ClusterBehavior.js +2 -20
- package/dist/cjs/behavior/cluster/ClusterBehavior.js.map +1 -1
- package/dist/cjs/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
- package/dist/cjs/behavior/cluster/ClusterBehaviorType.js +8 -150
- package/dist/cjs/behavior/cluster/ClusterBehaviorType.js.map +1 -1
- package/dist/cjs/behavior/context/server/LocalActorContext.d.ts +1 -1
- package/dist/cjs/behavior/context/server/LocalActorContext.d.ts.map +1 -1
- package/dist/cjs/behavior/internal/BehaviorBacking.d.ts +2 -2
- package/dist/cjs/behavior/internal/BehaviorBacking.d.ts.map +1 -1
- package/dist/cjs/behavior/internal/BehaviorBacking.js +2 -0
- package/dist/cjs/behavior/internal/BehaviorBacking.js.map +1 -1
- package/dist/cjs/behavior/internal/ClusterDerivation.d.ts +45 -0
- package/dist/cjs/behavior/internal/ClusterDerivation.d.ts.map +1 -0
- package/dist/cjs/behavior/internal/ClusterDerivation.js +192 -0
- package/dist/cjs/behavior/internal/ClusterDerivation.js.map +6 -0
- package/dist/cjs/behavior/internal/ClusterStatics.d.ts +16 -0
- package/dist/cjs/behavior/internal/ClusterStatics.d.ts.map +1 -0
- package/dist/cjs/behavior/internal/ClusterStatics.js +138 -0
- package/dist/cjs/behavior/internal/ClusterStatics.js.map +6 -0
- package/dist/cjs/behavior/internal/ModeledState.d.ts +18 -0
- package/dist/cjs/behavior/internal/ModeledState.d.ts.map +1 -0
- package/dist/cjs/behavior/internal/ModeledState.js +54 -0
- package/dist/cjs/behavior/internal/ModeledState.js.map +6 -0
- package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts +1 -1
- package/dist/cjs/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
- package/dist/cjs/behavior/internal/ServerBehaviorBacking.js +3 -12
- package/dist/cjs/behavior/internal/ServerBehaviorBacking.js.map +1 -1
- package/dist/cjs/behavior/state/managed/Datasource.d.ts +54 -10
- package/dist/cjs/behavior/state/managed/Datasource.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/Datasource.js +107 -38
- package/dist/cjs/behavior/state/managed/Datasource.js.map +1 -1
- package/dist/cjs/behavior/state/managed/Internal.d.ts +20 -5
- package/dist/cjs/behavior/state/managed/Internal.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/Internal.js +28 -26
- package/dist/cjs/behavior/state/managed/Internal.js.map +1 -1
- package/dist/cjs/behavior/state/managed/ManagedReference.d.ts +56 -12
- package/dist/cjs/behavior/state/managed/ManagedReference.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/ManagedReference.js +103 -43
- package/dist/cjs/behavior/state/managed/ManagedReference.js.map +1 -1
- package/dist/cjs/behavior/state/managed/NameResolver.js +1 -1
- package/dist/cjs/behavior/state/managed/NameResolver.js.map +1 -1
- package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts +33 -0
- package/dist/cjs/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
- package/dist/cjs/behavior/state/{validation/peer-forwarding.js → managed/ReadOnlyReference.js} +36 -17
- package/dist/cjs/behavior/state/managed/ReadOnlyReference.js.map +6 -0
- package/dist/cjs/behavior/state/managed/ValReference.d.ts +80 -13
- package/dist/cjs/behavior/state/managed/ValReference.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/ValReference.js +32 -0
- package/dist/cjs/behavior/state/managed/ValReference.js.map +2 -2
- package/dist/cjs/behavior/state/managed/errors.d.ts +25 -0
- package/dist/cjs/behavior/state/managed/errors.d.ts.map +1 -0
- package/dist/cjs/behavior/state/{validation/FabricIndexSentinel.js → managed/errors.js} +15 -10
- package/dist/cjs/behavior/state/managed/errors.js.map +6 -0
- package/dist/cjs/behavior/state/managed/index.d.ts +1 -0
- package/dist/cjs/behavior/state/managed/index.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/index.js +1 -0
- package/dist/cjs/behavior/state/managed/index.js.map +1 -1
- package/dist/cjs/behavior/state/managed/values/BitmapManager.js +5 -20
- package/dist/cjs/behavior/state/managed/values/BitmapManager.js.map +1 -1
- package/dist/cjs/behavior/state/managed/values/ListManager.d.ts +0 -5
- package/dist/cjs/behavior/state/managed/values/ListManager.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/values/ListManager.js +274 -133
- package/dist/cjs/behavior/state/managed/values/ListManager.js.map +2 -2
- package/dist/cjs/behavior/state/managed/values/StructManager.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/values/StructManager.js +30 -35
- package/dist/cjs/behavior/state/managed/values/StructManager.js.map +2 -2
- package/dist/cjs/behavior/state/managed/values/ValuePatcher.d.ts +8 -0
- package/dist/cjs/behavior/state/managed/values/ValuePatcher.d.ts.map +1 -1
- package/dist/cjs/behavior/state/managed/values/ValuePatcher.js +13 -2
- package/dist/cjs/behavior/state/managed/values/ValuePatcher.js.map +1 -1
- package/dist/cjs/behavior/state/validation/FabricIndexField.d.ts +30 -0
- package/dist/cjs/behavior/state/validation/FabricIndexField.d.ts.map +1 -0
- package/dist/cjs/behavior/state/validation/FabricIndexField.js +53 -0
- package/dist/cjs/behavior/state/validation/FabricIndexField.js.map +6 -0
- package/dist/cjs/behavior/state/validation/ValueValidator.d.ts.map +1 -1
- package/dist/cjs/behavior/state/validation/ValueValidator.js +16 -36
- package/dist/cjs/behavior/state/validation/ValueValidator.js.map +1 -1
- package/dist/cjs/behavior/state/validation/conformance.d.ts.map +1 -1
- package/dist/cjs/behavior/state/validation/conformance.js +6 -5
- package/dist/cjs/behavior/state/validation/conformance.js.map +1 -1
- package/dist/cjs/behavior/state/validation/constraint.d.ts.map +1 -1
- package/dist/cjs/behavior/state/validation/constraint.js +3 -1
- package/dist/cjs/behavior/state/validation/constraint.js.map +1 -1
- package/dist/cjs/behavior/state/validation/location.d.ts +6 -0
- package/dist/cjs/behavior/state/validation/location.d.ts.map +1 -1
- package/dist/cjs/behavior/state/validation/remote-validation.d.ts +57 -0
- package/dist/cjs/behavior/state/validation/remote-validation.d.ts.map +1 -0
- package/dist/cjs/behavior/state/validation/remote-validation.js +63 -0
- package/dist/cjs/behavior/state/validation/remote-validation.js.map +6 -0
- package/dist/cjs/behavior/supervision/Supervision.d.ts.map +1 -1
- package/dist/cjs/behavior/supervision/Supervision.js +1 -1
- package/dist/cjs/behavior/supervision/Supervision.js.map +1 -1
- package/dist/cjs/behavior/supervision/SupervisionConfig.d.ts.map +1 -1
- package/dist/cjs/behavior/supervision/SupervisionConfig.js +1 -1
- package/dist/cjs/behavior/supervision/SupervisionConfig.js.map +1 -1
- package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts +3 -12
- package/dist/cjs/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
- package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts +57 -6
- package/dist/cjs/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
- package/dist/cjs/behavior/system/commissioning/CommissioningClient.js +86 -0
- package/dist/cjs/behavior/system/commissioning/CommissioningClient.js.map +1 -1
- package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
- package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
- package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js +9 -0
- package/dist/cjs/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
- package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts +2 -1
- package/dist/cjs/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
- package/dist/cjs/behavior/system/controller/ControllerBehavior.js +2 -1
- package/dist/cjs/behavior/system/controller/ControllerBehavior.js.map +1 -1
- package/dist/cjs/behavior/system/dcl/DclBehavior.d.ts +3 -3
- package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
- package/dist/cjs/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
- package/dist/cjs/behavior/system/network/ServerGroupNetworking.js.map +1 -1
- package/dist/cjs/behavior/system/remote/api/ApiResource.d.ts +14 -0
- package/dist/cjs/behavior/system/remote/api/ApiResource.d.ts.map +1 -1
- package/dist/cjs/behavior/system/remote/api/ApiResource.js +19 -0
- package/dist/cjs/behavior/system/remote/api/ApiResource.js.map +1 -1
- package/dist/cjs/behavior/system/remote/api/Envelope.d.ts +4 -2
- package/dist/cjs/behavior/system/remote/api/Envelope.d.ts.map +1 -1
- package/dist/cjs/behavior/system/remote/api/Envelope.js +7 -5
- package/dist/cjs/behavior/system/remote/api/Envelope.js.map +1 -1
- package/dist/cjs/behavior/system/remote/api/resources/CommandResource.js +2 -2
- package/dist/cjs/behavior/system/remote/api/resources/CommandResource.js.map +1 -1
- package/dist/cjs/behavior/system/remote/api/resources/NodeResource.d.ts +1 -0
- package/dist/cjs/behavior/system/remote/api/resources/NodeResource.d.ts.map +1 -1
- package/dist/cjs/behavior/system/remote/api/resources/NodeResource.js +3 -0
- package/dist/cjs/behavior/system/remote/api/resources/NodeResource.js.map +1 -1
- package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.d.ts.map +1 -1
- package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.js +5 -3
- package/dist/cjs/behavior/system/remote/api/resources/PropertyResource.js.map +1 -1
- package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.d.ts.map +1 -1
- package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.js +2 -11
- package/dist/cjs/behavior/system/remote/api/resources/ServerNodeResource.js.map +1 -1
- package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
- package/dist/cjs/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
- package/dist/cjs/behavior/system/sessions/SessionsBehavior.js +6 -1
- package/dist/cjs/behavior/system/sessions/SessionsBehavior.js.map +1 -1
- package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
- package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
- package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js +74 -0
- package/dist/cjs/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
- package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
- package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
- package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
- package/dist/cjs/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
- package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts +2 -2
- package/dist/cjs/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
- package/dist/cjs/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
- package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
- package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +104 -60
- package/dist/cjs/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
- package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
- package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
- package/dist/cjs/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
- package/dist/cjs/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/groupcast/GroupcastServer.js +41 -25
- package/dist/cjs/behaviors/groupcast/GroupcastServer.js.map +2 -2
- package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
- package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.js +15 -4
- package/dist/cjs/behaviors/localization-configuration/LocalizationConfigurationServer.js.map +2 -2
- package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
- package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
- package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js +27 -23
- package/dist/cjs/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
- package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts +15 -4
- package/dist/cjs/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/thermostat/ThermostatServer.js +66 -49
- package/dist/cjs/behaviors/thermostat/ThermostatServer.js.map +1 -1
- package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
- package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js +19 -5
- package/dist/cjs/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +2 -2
- package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.d.ts.map +1 -1
- package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.js +13 -3
- package/dist/cjs/behaviors/unit-localization/UnitLocalizationServer.js.map +1 -1
- package/dist/cjs/endpoint/Endpoint.d.ts +5 -9
- package/dist/cjs/endpoint/Endpoint.d.ts.map +1 -1
- package/dist/cjs/endpoint/Endpoint.js +4 -23
- package/dist/cjs/endpoint/Endpoint.js.map +1 -1
- package/dist/cjs/endpoint/properties/Behaviors.d.ts.map +1 -1
- package/dist/cjs/endpoint/properties/Behaviors.js +5 -1
- package/dist/cjs/endpoint/properties/Behaviors.js.map +1 -1
- package/dist/cjs/node/ClientNode.d.ts +25 -0
- package/dist/cjs/node/ClientNode.d.ts.map +1 -1
- package/dist/cjs/node/ClientNode.js +41 -0
- package/dist/cjs/node/ClientNode.js.map +1 -1
- package/dist/cjs/node/ServerNode.d.ts.map +1 -1
- package/dist/cjs/node/ServerNode.js +2 -0
- package/dist/cjs/node/ServerNode.js.map +1 -1
- package/dist/cjs/node/client/ClientCommandMethod.d.ts.map +1 -1
- package/dist/cjs/node/client/ClientCommandMethod.js +3 -15
- package/dist/cjs/node/client/ClientCommandMethod.js.map +1 -1
- package/dist/cjs/node/client/ClientEventEmitter.d.ts.map +1 -1
- package/dist/cjs/node/client/ClientEventEmitter.js +6 -2
- package/dist/cjs/node/client/ClientEventEmitter.js.map +1 -1
- package/dist/cjs/node/client/ClientStructure.d.ts.map +1 -1
- package/dist/cjs/node/client/ClientStructure.js +181 -108
- package/dist/cjs/node/client/ClientStructure.js.map +2 -2
- package/dist/cjs/node/client/Peers.d.ts +18 -6
- package/dist/cjs/node/client/Peers.d.ts.map +1 -1
- package/dist/cjs/node/client/Peers.js +29 -13
- package/dist/cjs/node/client/Peers.js.map +1 -1
- package/dist/cjs/node/integration/ChangeNotificationService.d.ts +14 -3
- package/dist/cjs/node/integration/ChangeNotificationService.d.ts.map +1 -1
- package/dist/cjs/node/integration/ProtocolService.d.ts.map +1 -1
- package/dist/cjs/node/integration/ProtocolService.js +38 -56
- package/dist/cjs/node/integration/ProtocolService.js.map +1 -1
- package/dist/cjs/node/server/InteractionServer.d.ts.map +1 -1
- package/dist/cjs/node/server/InteractionServer.js +28 -24
- package/dist/cjs/node/server/InteractionServer.js.map +2 -2
- package/dist/cjs/node/server/ServerSubscription.d.ts +7 -2
- package/dist/cjs/node/server/ServerSubscription.d.ts.map +1 -1
- package/dist/cjs/node/server/ServerSubscription.js +83 -47
- package/dist/cjs/node/server/ServerSubscription.js.map +1 -1
- package/dist/cjs/storage/EndpointStore.d.ts +1 -1
- package/dist/cjs/storage/EndpointStore.js +1 -1
- package/dist/cjs/storage/client/ClientEndpointStore.d.ts +2 -2
- package/dist/cjs/storage/client/ClientEndpointStore.d.ts.map +1 -1
- package/dist/cjs/storage/client/ClientEndpointStore.js +1 -1
- package/dist/cjs/storage/client/DatasourceCache.d.ts +5 -3
- package/dist/cjs/storage/client/DatasourceCache.d.ts.map +1 -1
- package/dist/cjs/storage/client/DatasourceCache.js +68 -71
- package/dist/cjs/storage/client/DatasourceCache.js.map +1 -1
- package/dist/cjs/storage/client/FabricScopedListWrite.d.ts +73 -0
- package/dist/cjs/storage/client/FabricScopedListWrite.d.ts.map +1 -0
- package/dist/cjs/storage/client/FabricScopedListWrite.js +168 -0
- package/dist/cjs/storage/client/FabricScopedListWrite.js.map +6 -0
- package/dist/cjs/storage/client/RemoteWriteParticipant.d.ts +9 -6
- package/dist/cjs/storage/client/RemoteWriteParticipant.d.ts.map +1 -1
- package/dist/cjs/storage/client/RemoteWriteParticipant.js +11 -15
- package/dist/cjs/storage/client/RemoteWriteParticipant.js.map +1 -1
- package/dist/cjs/storage/client/RemoteWriter.d.ts +67 -7
- package/dist/cjs/storage/client/RemoteWriter.d.ts.map +1 -1
- package/dist/cjs/storage/client/RemoteWriter.js +61 -13
- package/dist/cjs/storage/client/RemoteWriter.js.map +1 -1
- package/dist/cjs/storage/server/DatasourceStore.d.ts +2 -2
- package/dist/cjs/storage/server/DatasourceStore.d.ts.map +1 -1
- package/dist/cjs/storage/server/DatasourceStore.js.map +1 -1
- package/dist/cjs/storage/server/ServerEndpointStore.d.ts +2 -2
- package/dist/cjs/storage/server/ServerEndpointStore.d.ts.map +1 -1
- package/dist/cjs/storage/server/ServerEndpointStore.js +1 -1
- package/dist/cjs/testing/mock-server-node.d.ts +2 -1
- package/dist/cjs/testing/mock-server-node.d.ts.map +1 -1
- package/dist/cjs/testing/mock-server-node.js +8 -5
- package/dist/cjs/testing/mock-server-node.js.map +2 -2
- package/dist/cjs/testing/node-helpers.d.ts +5 -0
- package/dist/cjs/testing/node-helpers.d.ts.map +1 -1
- package/dist/cjs/testing/node-helpers.js +4 -4
- package/dist/cjs/testing/node-helpers.js.map +1 -1
- package/dist/esm/behavior/Behavior.d.ts.map +1 -1
- package/dist/esm/behavior/Behavior.js +2 -0
- package/dist/esm/behavior/Behavior.js.map +1 -1
- package/dist/esm/behavior/Events.d.ts.map +1 -1
- package/dist/esm/behavior/Events.js +4 -2
- package/dist/esm/behavior/Events.js.map +1 -1
- package/dist/esm/behavior/cluster/ClusterBehavior.d.ts +17 -3
- package/dist/esm/behavior/cluster/ClusterBehavior.d.ts.map +1 -1
- package/dist/esm/behavior/cluster/ClusterBehavior.js +2 -20
- package/dist/esm/behavior/cluster/ClusterBehavior.js.map +1 -1
- package/dist/esm/behavior/cluster/ClusterBehaviorType.d.ts.map +1 -1
- package/dist/esm/behavior/cluster/ClusterBehaviorType.js +10 -159
- package/dist/esm/behavior/cluster/ClusterBehaviorType.js.map +1 -1
- package/dist/esm/behavior/context/server/LocalActorContext.d.ts +1 -1
- package/dist/esm/behavior/context/server/LocalActorContext.d.ts.map +1 -1
- package/dist/esm/behavior/internal/BehaviorBacking.d.ts +2 -2
- package/dist/esm/behavior/internal/BehaviorBacking.d.ts.map +1 -1
- package/dist/esm/behavior/internal/BehaviorBacking.js +2 -0
- package/dist/esm/behavior/internal/BehaviorBacking.js.map +1 -1
- package/dist/esm/behavior/internal/ClusterDerivation.d.ts +45 -0
- package/dist/esm/behavior/internal/ClusterDerivation.d.ts.map +1 -0
- package/dist/esm/behavior/internal/ClusterDerivation.js +172 -0
- package/dist/esm/behavior/internal/ClusterDerivation.js.map +6 -0
- package/dist/esm/behavior/internal/ClusterStatics.d.ts +16 -0
- package/dist/esm/behavior/internal/ClusterStatics.d.ts.map +1 -0
- package/dist/esm/behavior/internal/ClusterStatics.js +118 -0
- package/dist/esm/behavior/internal/ClusterStatics.js.map +6 -0
- package/dist/esm/behavior/internal/ModeledState.d.ts +18 -0
- package/dist/esm/behavior/internal/ModeledState.d.ts.map +1 -0
- package/dist/esm/behavior/internal/ModeledState.js +34 -0
- package/dist/esm/behavior/internal/ModeledState.js.map +6 -0
- package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts +1 -1
- package/dist/esm/behavior/internal/ServerBehaviorBacking.d.ts.map +1 -1
- package/dist/esm/behavior/internal/ServerBehaviorBacking.js +3 -12
- package/dist/esm/behavior/internal/ServerBehaviorBacking.js.map +1 -1
- package/dist/esm/behavior/state/managed/Datasource.d.ts +54 -10
- package/dist/esm/behavior/state/managed/Datasource.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/Datasource.js +107 -38
- package/dist/esm/behavior/state/managed/Datasource.js.map +1 -1
- package/dist/esm/behavior/state/managed/Internal.d.ts +20 -5
- package/dist/esm/behavior/state/managed/Internal.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/Internal.js +28 -26
- package/dist/esm/behavior/state/managed/Internal.js.map +1 -1
- package/dist/esm/behavior/state/managed/ManagedReference.d.ts +56 -12
- package/dist/esm/behavior/state/managed/ManagedReference.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/ManagedReference.js +103 -43
- package/dist/esm/behavior/state/managed/ManagedReference.js.map +1 -1
- package/dist/esm/behavior/state/managed/NameResolver.js +1 -1
- package/dist/esm/behavior/state/managed/NameResolver.js.map +1 -1
- package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts +33 -0
- package/dist/esm/behavior/state/managed/ReadOnlyReference.d.ts.map +1 -0
- package/dist/esm/behavior/state/managed/ReadOnlyReference.js +45 -0
- package/dist/esm/behavior/state/managed/ReadOnlyReference.js.map +6 -0
- package/dist/esm/behavior/state/managed/ValReference.d.ts +80 -13
- package/dist/esm/behavior/state/managed/ValReference.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/ValReference.js +28 -0
- package/dist/esm/behavior/state/managed/ValReference.js.map +2 -2
- package/dist/esm/behavior/state/managed/errors.d.ts +25 -0
- package/dist/esm/behavior/state/managed/errors.d.ts.map +1 -0
- package/dist/esm/behavior/state/managed/errors.js +20 -0
- package/dist/esm/behavior/state/managed/errors.js.map +6 -0
- package/dist/esm/behavior/state/managed/index.d.ts +1 -0
- package/dist/esm/behavior/state/managed/index.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/index.js +1 -0
- package/dist/esm/behavior/state/managed/index.js.map +1 -1
- package/dist/esm/behavior/state/managed/values/BitmapManager.js +6 -21
- package/dist/esm/behavior/state/managed/values/BitmapManager.js.map +1 -1
- package/dist/esm/behavior/state/managed/values/ListManager.d.ts +0 -5
- package/dist/esm/behavior/state/managed/values/ListManager.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/values/ListManager.js +277 -144
- package/dist/esm/behavior/state/managed/values/ListManager.js.map +2 -2
- package/dist/esm/behavior/state/managed/values/StructManager.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/values/StructManager.js +31 -36
- package/dist/esm/behavior/state/managed/values/StructManager.js.map +2 -2
- package/dist/esm/behavior/state/managed/values/ValuePatcher.d.ts +8 -0
- package/dist/esm/behavior/state/managed/values/ValuePatcher.d.ts.map +1 -1
- package/dist/esm/behavior/state/managed/values/ValuePatcher.js +13 -2
- package/dist/esm/behavior/state/managed/values/ValuePatcher.js.map +1 -1
- package/dist/esm/behavior/state/validation/FabricIndexField.d.ts +30 -0
- package/dist/esm/behavior/state/validation/FabricIndexField.d.ts.map +1 -0
- package/dist/esm/behavior/state/validation/FabricIndexField.js +33 -0
- package/dist/esm/behavior/state/validation/FabricIndexField.js.map +6 -0
- package/dist/esm/behavior/state/validation/ValueValidator.d.ts.map +1 -1
- package/dist/esm/behavior/state/validation/ValueValidator.js +17 -37
- package/dist/esm/behavior/state/validation/ValueValidator.js.map +1 -1
- package/dist/esm/behavior/state/validation/conformance.d.ts.map +1 -1
- package/dist/esm/behavior/state/validation/conformance.js +6 -5
- package/dist/esm/behavior/state/validation/conformance.js.map +1 -1
- package/dist/esm/behavior/state/validation/constraint.d.ts.map +1 -1
- package/dist/esm/behavior/state/validation/constraint.js +3 -1
- package/dist/esm/behavior/state/validation/constraint.js.map +1 -1
- package/dist/esm/behavior/state/validation/location.d.ts +6 -0
- package/dist/esm/behavior/state/validation/location.d.ts.map +1 -1
- package/dist/esm/behavior/state/validation/remote-validation.d.ts +57 -0
- package/dist/esm/behavior/state/validation/remote-validation.d.ts.map +1 -0
- package/dist/esm/behavior/state/validation/remote-validation.js +48 -0
- package/dist/esm/behavior/state/validation/remote-validation.js.map +6 -0
- package/dist/esm/behavior/supervision/Supervision.d.ts.map +1 -1
- package/dist/esm/behavior/supervision/Supervision.js +1 -1
- package/dist/esm/behavior/supervision/Supervision.js.map +1 -1
- package/dist/esm/behavior/supervision/SupervisionConfig.d.ts.map +1 -1
- package/dist/esm/behavior/supervision/SupervisionConfig.js +1 -1
- package/dist/esm/behavior/supervision/SupervisionConfig.js.map +1 -1
- package/dist/esm/behavior/supervision/ValueSupervisor.d.ts +3 -12
- package/dist/esm/behavior/supervision/ValueSupervisor.d.ts.map +1 -1
- package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts +57 -6
- package/dist/esm/behavior/system/commissioning/CommissioningClient.d.ts.map +1 -1
- package/dist/esm/behavior/system/commissioning/CommissioningClient.js +87 -0
- package/dist/esm/behavior/system/commissioning/CommissioningClient.js.map +1 -1
- package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts +9 -1
- package/dist/esm/behavior/system/commissioning/RemoteDescriptor.d.ts.map +1 -1
- package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js +10 -1
- package/dist/esm/behavior/system/commissioning/RemoteDescriptor.js.map +1 -1
- package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts +2 -1
- package/dist/esm/behavior/system/controller/ControllerBehavior.d.ts.map +1 -1
- package/dist/esm/behavior/system/controller/ControllerBehavior.js +2 -1
- package/dist/esm/behavior/system/controller/ControllerBehavior.js.map +1 -1
- package/dist/esm/behavior/system/dcl/DclBehavior.d.ts +3 -3
- package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts +2 -1
- package/dist/esm/behavior/system/network/ServerGroupNetworking.d.ts.map +1 -1
- package/dist/esm/behavior/system/network/ServerGroupNetworking.js.map +1 -1
- package/dist/esm/behavior/system/remote/api/ApiResource.d.ts +14 -0
- package/dist/esm/behavior/system/remote/api/ApiResource.d.ts.map +1 -1
- package/dist/esm/behavior/system/remote/api/ApiResource.js +19 -0
- package/dist/esm/behavior/system/remote/api/ApiResource.js.map +1 -1
- package/dist/esm/behavior/system/remote/api/Envelope.d.ts +4 -2
- package/dist/esm/behavior/system/remote/api/Envelope.d.ts.map +1 -1
- package/dist/esm/behavior/system/remote/api/Envelope.js +7 -5
- package/dist/esm/behavior/system/remote/api/Envelope.js.map +1 -1
- package/dist/esm/behavior/system/remote/api/resources/CommandResource.js +2 -2
- package/dist/esm/behavior/system/remote/api/resources/CommandResource.js.map +1 -1
- package/dist/esm/behavior/system/remote/api/resources/NodeResource.d.ts +1 -0
- package/dist/esm/behavior/system/remote/api/resources/NodeResource.d.ts.map +1 -1
- package/dist/esm/behavior/system/remote/api/resources/NodeResource.js +3 -0
- package/dist/esm/behavior/system/remote/api/resources/NodeResource.js.map +1 -1
- package/dist/esm/behavior/system/remote/api/resources/PropertyResource.d.ts.map +1 -1
- package/dist/esm/behavior/system/remote/api/resources/PropertyResource.js +5 -3
- package/dist/esm/behavior/system/remote/api/resources/PropertyResource.js.map +1 -1
- package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.d.ts.map +1 -1
- package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.js +2 -11
- package/dist/esm/behavior/system/remote/api/resources/ServerNodeResource.js.map +1 -1
- package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts +4 -0
- package/dist/esm/behavior/system/sessions/SessionsBehavior.d.ts.map +1 -1
- package/dist/esm/behavior/system/sessions/SessionsBehavior.js +6 -1
- package/dist/esm/behavior/system/sessions/SessionsBehavior.js.map +1 -1
- package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts +28 -0
- package/dist/esm/behavior/system/subscriptions/SubscriptionStore.d.ts.map +1 -0
- package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js +54 -0
- package/dist/esm/behavior/system/subscriptions/SubscriptionStore.js.map +6 -0
- package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts +8 -3
- package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.d.ts.map +1 -1
- package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js +61 -30
- package/dist/esm/behavior/system/subscriptions/SubscriptionsServer.js.map +1 -1
- package/dist/esm/behaviors/access-control/AccessControlServer.d.ts +2 -2
- package/dist/esm/behaviors/access-control/AccessControlServer.d.ts.map +1 -1
- package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.d.ts.map +1 -1
- package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js +43 -21
- package/dist/esm/behaviors/administrator-commissioning/AdministratorCommissioningServer.js.map +1 -1
- package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts +29 -23
- package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.d.ts.map +1 -1
- package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js +105 -60
- package/dist/esm/behaviors/general-diagnostics/GeneralDiagnosticsServer.js.map +1 -1
- package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts +9 -1
- package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.d.ts.map +1 -1
- package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js +11 -7
- package/dist/esm/behaviors/group-key-management/GroupKeyManagementServer.js.map +1 -1
- package/dist/esm/behaviors/groupcast/GroupcastServer.d.ts.map +1 -1
- package/dist/esm/behaviors/groupcast/GroupcastServer.js +42 -25
- package/dist/esm/behaviors/groupcast/GroupcastServer.js.map +2 -2
- package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts +1 -1
- package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.d.ts.map +1 -1
- package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.js +15 -4
- package/dist/esm/behaviors/localization-configuration/LocalizationConfigurationServer.js.map +2 -2
- package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts +2 -0
- package/dist/esm/behaviors/operational-credentials/VendorIdVerification.d.ts.map +1 -1
- package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js +32 -24
- package/dist/esm/behaviors/operational-credentials/VendorIdVerification.js.map +1 -1
- package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts +15 -4
- package/dist/esm/behaviors/thermostat/ThermostatServer.d.ts.map +1 -1
- package/dist/esm/behaviors/thermostat/ThermostatServer.js +66 -49
- package/dist/esm/behaviors/thermostat/ThermostatServer.js.map +1 -1
- package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts +4 -4
- package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.d.ts.map +1 -1
- package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js +19 -5
- package/dist/esm/behaviors/time-format-localization/TimeFormatLocalizationServer.js.map +2 -2
- package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.d.ts.map +1 -1
- package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.js +13 -3
- package/dist/esm/behaviors/unit-localization/UnitLocalizationServer.js.map +1 -1
- package/dist/esm/endpoint/Endpoint.d.ts +5 -9
- package/dist/esm/endpoint/Endpoint.d.ts.map +1 -1
- package/dist/esm/endpoint/Endpoint.js +5 -24
- package/dist/esm/endpoint/Endpoint.js.map +1 -1
- package/dist/esm/endpoint/properties/Behaviors.d.ts.map +1 -1
- package/dist/esm/endpoint/properties/Behaviors.js +6 -2
- package/dist/esm/endpoint/properties/Behaviors.js.map +1 -1
- package/dist/esm/node/ClientNode.d.ts +25 -0
- package/dist/esm/node/ClientNode.d.ts.map +1 -1
- package/dist/esm/node/ClientNode.js +41 -0
- package/dist/esm/node/ClientNode.js.map +1 -1
- package/dist/esm/node/ServerNode.d.ts.map +1 -1
- package/dist/esm/node/ServerNode.js +2 -0
- package/dist/esm/node/ServerNode.js.map +1 -1
- package/dist/esm/node/client/ClientCommandMethod.d.ts.map +1 -1
- package/dist/esm/node/client/ClientCommandMethod.js +4 -16
- package/dist/esm/node/client/ClientCommandMethod.js.map +1 -1
- package/dist/esm/node/client/ClientEventEmitter.d.ts.map +1 -1
- package/dist/esm/node/client/ClientEventEmitter.js +6 -2
- package/dist/esm/node/client/ClientEventEmitter.js.map +1 -1
- package/dist/esm/node/client/ClientStructure.d.ts.map +1 -1
- package/dist/esm/node/client/ClientStructure.js +181 -108
- package/dist/esm/node/client/ClientStructure.js.map +2 -2
- package/dist/esm/node/client/Peers.d.ts +18 -6
- package/dist/esm/node/client/Peers.d.ts.map +1 -1
- package/dist/esm/node/client/Peers.js +29 -14
- package/dist/esm/node/client/Peers.js.map +1 -1
- package/dist/esm/node/integration/ChangeNotificationService.d.ts +14 -3
- package/dist/esm/node/integration/ChangeNotificationService.d.ts.map +1 -1
- package/dist/esm/node/integration/ProtocolService.d.ts.map +1 -1
- package/dist/esm/node/integration/ProtocolService.js +40 -57
- package/dist/esm/node/integration/ProtocolService.js.map +1 -1
- package/dist/esm/node/server/InteractionServer.d.ts.map +1 -1
- package/dist/esm/node/server/InteractionServer.js +28 -25
- package/dist/esm/node/server/InteractionServer.js.map +2 -2
- package/dist/esm/node/server/ServerSubscription.d.ts +7 -2
- package/dist/esm/node/server/ServerSubscription.d.ts.map +1 -1
- package/dist/esm/node/server/ServerSubscription.js +83 -47
- package/dist/esm/node/server/ServerSubscription.js.map +1 -1
- package/dist/esm/storage/EndpointStore.d.ts +1 -1
- package/dist/esm/storage/EndpointStore.js +1 -1
- package/dist/esm/storage/client/ClientEndpointStore.d.ts +2 -2
- package/dist/esm/storage/client/ClientEndpointStore.d.ts.map +1 -1
- package/dist/esm/storage/client/ClientEndpointStore.js +1 -1
- package/dist/esm/storage/client/DatasourceCache.d.ts +5 -3
- package/dist/esm/storage/client/DatasourceCache.d.ts.map +1 -1
- package/dist/esm/storage/client/DatasourceCache.js +68 -71
- package/dist/esm/storage/client/DatasourceCache.js.map +1 -1
- package/dist/esm/storage/client/FabricScopedListWrite.d.ts +73 -0
- package/dist/esm/storage/client/FabricScopedListWrite.d.ts.map +1 -0
- package/dist/esm/storage/client/FabricScopedListWrite.js +148 -0
- package/dist/esm/storage/client/FabricScopedListWrite.js.map +6 -0
- package/dist/esm/storage/client/RemoteWriteParticipant.d.ts +9 -6
- package/dist/esm/storage/client/RemoteWriteParticipant.d.ts.map +1 -1
- package/dist/esm/storage/client/RemoteWriteParticipant.js +11 -15
- package/dist/esm/storage/client/RemoteWriteParticipant.js.map +1 -1
- package/dist/esm/storage/client/RemoteWriter.d.ts +67 -7
- package/dist/esm/storage/client/RemoteWriter.d.ts.map +1 -1
- package/dist/esm/storage/client/RemoteWriter.js +65 -14
- package/dist/esm/storage/client/RemoteWriter.js.map +1 -1
- package/dist/esm/storage/server/DatasourceStore.d.ts +2 -2
- package/dist/esm/storage/server/DatasourceStore.d.ts.map +1 -1
- package/dist/esm/storage/server/DatasourceStore.js.map +1 -1
- package/dist/esm/storage/server/ServerEndpointStore.d.ts +2 -2
- package/dist/esm/storage/server/ServerEndpointStore.d.ts.map +1 -1
- package/dist/esm/storage/server/ServerEndpointStore.js +1 -1
- package/dist/esm/testing/mock-server-node.d.ts +2 -1
- package/dist/esm/testing/mock-server-node.d.ts.map +1 -1
- package/dist/esm/testing/mock-server-node.js +16 -7
- package/dist/esm/testing/mock-server-node.js.map +2 -2
- package/dist/esm/testing/node-helpers.d.ts +5 -0
- package/dist/esm/testing/node-helpers.d.ts.map +1 -1
- package/dist/esm/testing/node-helpers.js +4 -4
- package/dist/esm/testing/node-helpers.js.map +1 -1
- package/package.json +6 -6
- package/src/behavior/Behavior.ts +2 -0
- package/src/behavior/Events.ts +6 -3
- package/src/behavior/cluster/ClusterBehavior.ts +22 -13
- package/src/behavior/cluster/ClusterBehaviorType.ts +9 -270
- package/src/behavior/context/server/LocalActorContext.ts +1 -4
- package/src/behavior/internal/BehaviorBacking.ts +10 -2
- package/src/behavior/internal/ClusterDerivation.ts +295 -0
- package/src/behavior/internal/ClusterStatics.ts +180 -0
- package/src/behavior/internal/ModeledState.ts +58 -0
- package/src/behavior/internal/ServerBehaviorBacking.ts +9 -16
- package/src/behavior/state/managed/Datasource.ts +181 -58
- package/src/behavior/state/managed/Internal.ts +44 -34
- package/src/behavior/state/managed/ManagedReference.ts +159 -70
- package/src/behavior/state/managed/NameResolver.ts +1 -1
- package/src/behavior/state/managed/ReadOnlyReference.ts +61 -0
- package/src/behavior/state/managed/ValReference.ts +104 -14
- package/src/behavior/state/managed/errors.ts +33 -0
- package/src/behavior/state/managed/index.ts +1 -0
- package/src/behavior/state/managed/values/BitmapManager.ts +6 -22
- package/src/behavior/state/managed/values/ListManager.ts +313 -164
- package/src/behavior/state/managed/values/StructManager.ts +48 -52
- package/src/behavior/state/managed/values/ValuePatcher.ts +25 -3
- package/src/behavior/state/validation/FabricIndexField.ts +51 -0
- package/src/behavior/state/validation/ValueValidator.ts +24 -54
- package/src/behavior/state/validation/conformance.ts +9 -7
- package/src/behavior/state/validation/constraint.ts +5 -1
- package/src/behavior/state/validation/location.ts +8 -0
- package/src/behavior/state/validation/remote-validation.ts +107 -0
- package/src/behavior/supervision/Supervision.ts +1 -2
- package/src/behavior/supervision/SupervisionConfig.ts +1 -2
- package/src/behavior/supervision/ValueSupervisor.ts +3 -13
- package/src/behavior/system/commissioning/CommissioningClient.ts +122 -6
- package/src/behavior/system/commissioning/RemoteDescriptor.ts +17 -1
- package/src/behavior/system/controller/ControllerBehavior.ts +2 -1
- package/src/behavior/system/dcl/DclBehavior.ts +3 -3
- package/src/behavior/system/network/ServerGroupNetworking.ts +3 -2
- package/src/behavior/system/remote/api/ApiResource.ts +23 -0
- package/src/behavior/system/remote/api/Envelope.ts +8 -6
- package/src/behavior/system/remote/api/resources/CommandResource.ts +2 -2
- package/src/behavior/system/remote/api/resources/NodeResource.ts +4 -0
- package/src/behavior/system/remote/api/resources/PropertyResource.ts +5 -3
- package/src/behavior/system/remote/api/resources/ServerNodeResource.ts +2 -13
- package/src/behavior/system/sessions/SessionsBehavior.ts +8 -2
- package/src/behavior/system/subscriptions/SubscriptionStore.ts +66 -0
- package/src/behavior/system/subscriptions/SubscriptionsServer.ts +73 -33
- package/src/behaviors/access-control/AccessControlServer.ts +3 -3
- package/src/behaviors/administrator-commissioning/AdministratorCommissioningServer.ts +47 -24
- package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts +138 -84
- package/src/behaviors/group-key-management/GroupKeyManagementServer.ts +12 -8
- package/src/behaviors/groupcast/GroupcastServer.ts +50 -34
- package/src/behaviors/localization-configuration/LocalizationConfigurationServer.ts +18 -6
- package/src/behaviors/operational-credentials/VendorIdVerification.ts +50 -35
- package/src/behaviors/thermostat/ThermostatServer.ts +93 -70
- package/src/behaviors/time-format-localization/TimeFormatLocalizationServer.ts +24 -9
- package/src/behaviors/unit-localization/UnitLocalizationServer.ts +17 -4
- package/src/endpoint/Endpoint.ts +5 -31
- package/src/endpoint/properties/Behaviors.ts +6 -2
- package/src/node/ClientNode.ts +41 -0
- package/src/node/ServerNode.ts +2 -0
- package/src/node/client/ClientCommandMethod.ts +4 -19
- package/src/node/client/ClientEventEmitter.ts +7 -3
- package/src/node/client/ClientStructure.ts +208 -135
- package/src/node/client/Peers.ts +36 -20
- package/src/node/integration/ChangeNotificationService.ts +18 -3
- package/src/node/integration/ProtocolService.ts +45 -57
- package/src/node/server/InteractionServer.ts +33 -35
- package/src/node/server/ServerSubscription.ts +88 -50
- package/src/storage/EndpointStore.ts +1 -1
- package/src/storage/client/ClientEndpointStore.ts +1 -1
- package/src/storage/client/DatasourceCache.ts +86 -79
- package/src/storage/client/FabricScopedListWrite.ts +245 -0
- package/src/storage/client/RemoteWriteParticipant.ts +20 -23
- package/src/storage/client/RemoteWriter.ts +156 -26
- package/src/storage/server/DatasourceStore.ts +2 -2
- package/src/storage/server/ServerEndpointStore.ts +1 -1
- package/src/testing/mock-server-node.ts +22 -9
- package/src/testing/node-helpers.ts +5 -1
- package/dist/cjs/behavior/state/validation/FabricIndexSentinel.d.ts +0 -14
- package/dist/cjs/behavior/state/validation/FabricIndexSentinel.d.ts.map +0 -1
- package/dist/cjs/behavior/state/validation/FabricIndexSentinel.js.map +0 -6
- package/dist/cjs/behavior/state/validation/peer-forwarding.d.ts +0 -20
- package/dist/cjs/behavior/state/validation/peer-forwarding.d.ts.map +0 -1
- package/dist/cjs/behavior/state/validation/peer-forwarding.js.map +0 -6
- package/dist/esm/behavior/state/validation/FabricIndexSentinel.d.ts +0 -14
- package/dist/esm/behavior/state/validation/FabricIndexSentinel.d.ts.map +0 -1
- package/dist/esm/behavior/state/validation/FabricIndexSentinel.js +0 -15
- package/dist/esm/behavior/state/validation/FabricIndexSentinel.js.map +0 -6
- package/dist/esm/behavior/state/validation/peer-forwarding.d.ts +0 -20
- package/dist/esm/behavior/state/validation/peer-forwarding.d.ts.map +0 -1
- package/dist/esm/behavior/state/validation/peer-forwarding.js +0 -26
- package/dist/esm/behavior/state/validation/peer-forwarding.js.map +0 -6
- package/src/behavior/state/validation/FabricIndexSentinel.ts +0 -20
- package/src/behavior/state/validation/peer-forwarding.ts +0 -47
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022-2026 Matter.js Authors
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { memberValueOf } from "#behavior/state/managed/MemberKeys.js";
|
|
8
|
+
import { fabricIndexOf, withFabricIndex } from "#behavior/state/validation/FabricIndexField.js";
|
|
9
|
+
import { Bytes, isDeepEqual, isObject, Logger } from "@matter/general";
|
|
10
|
+
import type { DataModelPath, ValueModel } from "@matter/model";
|
|
11
|
+
import { Val, WriteError } from "@matter/protocol";
|
|
12
|
+
import { FabricIndex, Status, TlvOfModel, ValidationError } from "@matter/types";
|
|
13
|
+
|
|
14
|
+
const logger = Logger.get("FabricScopedListWrite");
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* How a client node other than a group writes a fabric-scoped list to a peer.
|
|
18
|
+
*
|
|
19
|
+
* The device ignores the FabricIndex written (§ 7.19.1.9.1) and uses the accessing fabric (§ 7.13.6). It replaces
|
|
20
|
+
* only the entries of the accessing fabric (§ 7.19.1.8.2). A cached list read without fabric filtering also holds the
|
|
21
|
+
* entries of other fabrics, so a write sends only our entries:
|
|
22
|
+
*
|
|
23
|
+
* | Entry | Write |
|
|
24
|
+
* | ------------------------------------------------------------------------ | -------------------- |
|
|
25
|
+
* | written, FabricIndex ours, `FabricIndex.OMIT_FABRIC` or absent | sent, with our index |
|
|
26
|
+
* | written, other FabricIndex (`NO_FABRIC` too), equal to a cached entry | left out |
|
|
27
|
+
* | written, other FabricIndex (`NO_FABRIC` too), equal to no cached entry | whole write refused |
|
|
28
|
+
* | written, not a struct | whole write refused |
|
|
29
|
+
* | cached, of another fabric or of no fabric, missing from the written list | kept by the device |
|
|
30
|
+
* | any, while our fabric index on the peer is unknown | whole write refused |
|
|
31
|
+
*
|
|
32
|
+
* @see {@link MatterSpecification.v161.Core} § 7.13.6
|
|
33
|
+
* @see {@link MatterSpecification.v161.Core} § 7.19.1.8.2
|
|
34
|
+
* @see {@link MatterSpecification.v161.Core} § 7.19.1.9.1
|
|
35
|
+
*/
|
|
36
|
+
export namespace FabricScopedListWrite {
|
|
37
|
+
/**
|
|
38
|
+
* Whether {@link entry} is ours: a struct whose FabricIndex is our fabric index on the peer,
|
|
39
|
+
* `FabricIndex.OMIT_FABRIC` or absent. An entry of `FabricIndex.NO_FABRIC` is scoped to no fabric, and a value
|
|
40
|
+
* that is not a struct has no fabric, so neither is ours. False does not mean that {@link entry} is not a struct.
|
|
41
|
+
*
|
|
42
|
+
* @see {@link MatterSpecification.v161.Core} § 7.19.1.8.1
|
|
43
|
+
*/
|
|
44
|
+
export function isOurs(entry: Val, fabricIndexOnPeer: FabricIndex): entry is Val.Struct {
|
|
45
|
+
if (!isObject(entry)) {
|
|
46
|
+
return false;
|
|
47
|
+
}
|
|
48
|
+
const fabricIndex = fabricIndexOf(entry);
|
|
49
|
+
return (
|
|
50
|
+
fabricIndex === undefined || fabricIndex === FabricIndex.OMIT_FABRIC || fabricIndex === fabricIndexOnPeer
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Our fabric index on the peer, which a write of the fabric-scoped list at {@link path} needs.
|
|
56
|
+
*
|
|
57
|
+
* @throws WriteError with CONSTRAINT_ERROR if {@link fabricIndexOnPeer} is unknown
|
|
58
|
+
*/
|
|
59
|
+
export function requireFabricIndex(fabricIndexOnPeer: FabricIndex | undefined, path: DataModelPath) {
|
|
60
|
+
if (fabricIndexOnPeer === undefined) {
|
|
61
|
+
throw new WriteError(
|
|
62
|
+
path,
|
|
63
|
+
"Cannot write a fabric-scoped list while our fabric index on the peer " +
|
|
64
|
+
"(commissioning.fabricIndexOnPeer) is unknown; " +
|
|
65
|
+
"read operationalCredentials.currentFabricIndex first",
|
|
66
|
+
Status.ConstraintError,
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
return fabricIndexOnPeer;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* The entries of {@link list} a write of the fabric-scoped list at {@link path} sends, in their order. Each holds
|
|
74
|
+
* our fabric index on the peer as its FabricIndex, under the key the entry already uses for it, else under the
|
|
75
|
+
* property name, so the cache can hold what the device stores. The encoder leaves FabricIndex out of a write.
|
|
76
|
+
*
|
|
77
|
+
* An entry that is not ours is left out if it equals an entry of {@link cached}; the device keeps it. Two entries
|
|
78
|
+
* are equal if each field of {@link entrySchema} is absent from both, holds deep-equal values in both, or has the
|
|
79
|
+
* same TLV encoding in both. So a number and a bigint of the same value are equal, and an unchanged copy of a
|
|
80
|
+
* cached entry is equal to it even when a cached value breaks a bound of the model. A property that is not a field
|
|
81
|
+
* of {@link entrySchema} is not compared, as the encoder never sends it. A field whose values differ and that does
|
|
82
|
+
* not encode makes the entries differ.
|
|
83
|
+
*
|
|
84
|
+
* @param cached the cached value of the list
|
|
85
|
+
* @param entrySchema the schema of an entry of the list
|
|
86
|
+
* @throws WriteError with CONSTRAINT_ERROR for the first entry that is not ours and not left out
|
|
87
|
+
*/
|
|
88
|
+
export function entriesToSend(
|
|
89
|
+
list: Val.List,
|
|
90
|
+
cached: Val,
|
|
91
|
+
fabricIndexOnPeer: FabricIndex,
|
|
92
|
+
path: DataModelPath,
|
|
93
|
+
entrySchema: ValueModel,
|
|
94
|
+
) {
|
|
95
|
+
const cachedEntries = Array.isArray(cached) ? cached : [];
|
|
96
|
+
const ours = new Array<Val>();
|
|
97
|
+
const others = new Array<Val>();
|
|
98
|
+
for (const entry of list) {
|
|
99
|
+
if (isOurs(entry, fabricIndexOnPeer)) {
|
|
100
|
+
ours.push(withFabricIndex(entry, fabricIndexOnPeer));
|
|
101
|
+
} else if (cachedEntries.some(cachedEntry => isSameEntry(entry, cachedEntry, entrySchema))) {
|
|
102
|
+
others.push(entry);
|
|
103
|
+
} else {
|
|
104
|
+
throw new WriteError(
|
|
105
|
+
path,
|
|
106
|
+
refusalMessage(entry, cachedEntries, fabricIndexOnPeer, entrySchema),
|
|
107
|
+
Status.ConstraintError,
|
|
108
|
+
);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
if (others.length) {
|
|
113
|
+
logger.debug(
|
|
114
|
+
`Leaving ${countOf(others.length)} of other fabrics or of no fabric out of the write of`,
|
|
115
|
+
path,
|
|
116
|
+
);
|
|
117
|
+
}
|
|
118
|
+
const dropped = cachedEntries.filter(
|
|
119
|
+
cachedEntry =>
|
|
120
|
+
!isOurs(cachedEntry, fabricIndexOnPeer) &&
|
|
121
|
+
!others.some(entry => isSameEntry(entry, cachedEntry, entrySchema)),
|
|
122
|
+
).length;
|
|
123
|
+
if (dropped) {
|
|
124
|
+
logger.debug(
|
|
125
|
+
`The write of ${path} omits ${countOf(dropped)} of other fabrics or of no fabric;`,
|
|
126
|
+
"the device keeps them",
|
|
127
|
+
);
|
|
128
|
+
}
|
|
129
|
+
return ours;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* The cached value of a fabric-scoped list after the device accepted a write of our entries {@link written}.
|
|
134
|
+
*
|
|
135
|
+
* A write replaces only the entries of the accessing fabric, so every other entry of {@link cached} stays in its
|
|
136
|
+
* place. We choose to put {@link written} in the places of our cached entries, in order; entries beyond those
|
|
137
|
+
* places go to the end, and our cached entries that no written entry takes are removed. The device may order the
|
|
138
|
+
* list differently; its next report replaces the cached list.
|
|
139
|
+
*
|
|
140
|
+
* @see {@link MatterSpecification.v161.Core} § 7.19.1.8.2
|
|
141
|
+
*/
|
|
142
|
+
export function cachedAfterWrite(cached: Val, written: Val.List, fabricIndexOnPeer: FabricIndex): Val.List {
|
|
143
|
+
if (!Array.isArray(cached)) {
|
|
144
|
+
return written;
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
const merged = new Array<Val>();
|
|
148
|
+
let next = 0;
|
|
149
|
+
for (const entry of cached) {
|
|
150
|
+
if (!isOurs(entry, fabricIndexOnPeer)) {
|
|
151
|
+
merged.push(entry);
|
|
152
|
+
} else if (next < written.length) {
|
|
153
|
+
merged.push(written[next++]);
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
merged.push(...written.slice(next));
|
|
157
|
+
return merged;
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
function countOf(entries: number) {
|
|
162
|
+
return entries === 1 ? "1 entry" : `${entries} entries`;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
function isSameEntry(entry: Val, cachedEntry: Val, entrySchema: ValueModel) {
|
|
166
|
+
if (!isObject(entry) || !isObject(cachedEntry)) {
|
|
167
|
+
return false;
|
|
168
|
+
}
|
|
169
|
+
for (const field of entrySchema.members) {
|
|
170
|
+
const value = memberValueOf(entry, field.propertyName, field.id);
|
|
171
|
+
const cachedValue = memberValueOf(cachedEntry, field.propertyName, field.id);
|
|
172
|
+
if (value === undefined || cachedValue === undefined) {
|
|
173
|
+
if (value !== cachedValue) {
|
|
174
|
+
return false;
|
|
175
|
+
}
|
|
176
|
+
continue;
|
|
177
|
+
}
|
|
178
|
+
if (isDeepEqual(value, cachedValue)) {
|
|
179
|
+
continue;
|
|
180
|
+
}
|
|
181
|
+
const encoded = encodingOf(field, value);
|
|
182
|
+
const cachedEncoded = encodingOf(field, cachedValue);
|
|
183
|
+
if (encoded === undefined || cachedEncoded === undefined || !Bytes.areEqual(encoded, cachedEncoded)) {
|
|
184
|
+
return false;
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
return true;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/**
|
|
191
|
+
* The TLV encoding of {@link value} as {@link field}, or undefined if the value is not valid for the field.
|
|
192
|
+
*/
|
|
193
|
+
function encodingOf(field: ValueModel, value: Val) {
|
|
194
|
+
try {
|
|
195
|
+
return TlvOfModel(field).encode(value);
|
|
196
|
+
} catch (e) {
|
|
197
|
+
if (e instanceof ValidationError) {
|
|
198
|
+
return undefined;
|
|
199
|
+
}
|
|
200
|
+
throw e;
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
/**
|
|
205
|
+
* The first field of {@link entry} that does not encode, if any.
|
|
206
|
+
*/
|
|
207
|
+
function unencodableFieldOf(entry: Val.Struct, entrySchema: ValueModel) {
|
|
208
|
+
return entrySchema.members.find(field => {
|
|
209
|
+
const value = memberValueOf(entry, field.propertyName, field.id);
|
|
210
|
+
return value !== undefined && encodingOf(field, value) === undefined;
|
|
211
|
+
});
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
function refusalMessage(
|
|
215
|
+
refused: Val,
|
|
216
|
+
cachedEntries: Val.List,
|
|
217
|
+
fabricIndexOnPeer: FabricIndex,
|
|
218
|
+
entrySchema: ValueModel,
|
|
219
|
+
) {
|
|
220
|
+
if (!isObject(refused)) {
|
|
221
|
+
return `Cannot write an entry that is not a struct (our fabric index on the peer is ${fabricIndexOnPeer})`;
|
|
222
|
+
}
|
|
223
|
+
const written = fabricIndexOf(refused);
|
|
224
|
+
const what =
|
|
225
|
+
written === FabricIndex.NO_FABRIC
|
|
226
|
+
? "an entry of no fabric (FabricIndex.NO_FABRIC)"
|
|
227
|
+
: `an entry with fabricIndex ${String(written)}`;
|
|
228
|
+
const message =
|
|
229
|
+
`Cannot write ${what}: our fabric index on the peer is ${fabricIndexOnPeer}, ` +
|
|
230
|
+
"so write that index or FabricIndex.OMIT_FABRIC";
|
|
231
|
+
if (!cachedEntries.some(entry => isObject(entry) && fabricIndexOf(entry) === written)) {
|
|
232
|
+
return message;
|
|
233
|
+
}
|
|
234
|
+
const unencodable = unencodableFieldOf(refused, entrySchema);
|
|
235
|
+
if (unencodable !== undefined) {
|
|
236
|
+
return (
|
|
237
|
+
`${message}; its field ${unencodable.propertyName} holds a value the field does not allow, ` +
|
|
238
|
+
"so it cannot be compared with the cached entries of that fabric"
|
|
239
|
+
);
|
|
240
|
+
}
|
|
241
|
+
return (
|
|
242
|
+
`${message}; the entry differs from every cached entry of that fabric: it was edited, or the cache changed ` +
|
|
243
|
+
"since the list was read, so read the list again and retry"
|
|
244
|
+
);
|
|
245
|
+
}
|
|
@@ -36,53 +36,44 @@ function ordinalFor(writer: RemoteWriter) {
|
|
|
36
36
|
* notifications are released when the transaction concludes, so no observer runs inside the commit.
|
|
37
37
|
*/
|
|
38
38
|
export class RemoteWriteParticipant implements Transaction.Participant {
|
|
39
|
-
#request: RemoteWriter.Request = [];
|
|
40
39
|
#writer: RemoteWriter;
|
|
41
40
|
#name: string;
|
|
42
41
|
#pending = new Map<string, RemoteWriteParticipant.PendingWrite>();
|
|
43
42
|
#releases = new Array<() => Promise<void>>();
|
|
44
43
|
|
|
45
44
|
/**
|
|
46
|
-
* There is one participant for each transaction/writer pair. We use the writer
|
|
45
|
+
* There is one participant for each transaction/writer pair. We use the writer itself as the dedup key.
|
|
47
46
|
*/
|
|
48
47
|
get role() {
|
|
49
48
|
return this.#writer;
|
|
50
49
|
}
|
|
51
50
|
|
|
52
51
|
/**
|
|
53
|
-
* Add
|
|
52
|
+
* Add the write of one cluster to the write request.
|
|
54
53
|
*
|
|
54
|
+
* @param write the write {@link RemoteWriter.prepare} prepared
|
|
55
55
|
* @param receiver settles the values the peer accepts
|
|
56
56
|
* @param epoch the receiver's epoch when this write is queued, so it can tell a value the peer settled afterwards
|
|
57
57
|
* from one that predates the write
|
|
58
58
|
*/
|
|
59
|
-
set(
|
|
60
|
-
|
|
61
|
-
behaviorId: string,
|
|
62
|
-
values: Val.Struct,
|
|
63
|
-
receiver: RemoteWriteParticipant.Receiver,
|
|
64
|
-
epoch: number,
|
|
65
|
-
) {
|
|
66
|
-
const key = writeKey(endpointNumber, behaviorId);
|
|
59
|
+
set(write: RemoteWriter.PreparedWrite, receiver: RemoteWriteParticipant.Receiver, epoch: number) {
|
|
60
|
+
const key = writeKey(write.number, write.behaviorId);
|
|
67
61
|
if (this.#pending.has(key)) {
|
|
68
62
|
throw new InternalError(`${this} received a second write for ${key} in one commit`);
|
|
69
63
|
}
|
|
70
64
|
|
|
71
|
-
this.#
|
|
72
|
-
this.#pending.set(key, { receiver, epoch, values });
|
|
65
|
+
this.#pending.set(key, { receiver, epoch, write });
|
|
73
66
|
}
|
|
74
67
|
|
|
75
68
|
async commit1() {
|
|
76
|
-
if (!this.#
|
|
69
|
+
if (!this.#pending.size) {
|
|
77
70
|
return;
|
|
78
71
|
}
|
|
79
72
|
|
|
80
|
-
const request = this.#request;
|
|
81
73
|
const pending = this.#pending;
|
|
82
|
-
this.#request = [];
|
|
83
74
|
this.#pending = new Map();
|
|
84
75
|
|
|
85
|
-
const statuses = await this.#writer(
|
|
76
|
+
const statuses = await this.#writer.send([...pending.values()].map(({ write }) => write));
|
|
86
77
|
|
|
87
78
|
const failedByCluster = new Map<string, Set<string>>();
|
|
88
79
|
for (const { status, path } of statuses) {
|
|
@@ -98,11 +89,11 @@ export class RemoteWriteParticipant implements Transaction.Participant {
|
|
|
98
89
|
ids.add(String(path.attributeId));
|
|
99
90
|
}
|
|
100
91
|
|
|
101
|
-
for (const [key, { receiver,
|
|
92
|
+
for (const [key, { receiver, write, epoch }] of pending) {
|
|
102
93
|
const failed = failedByCluster.get(key);
|
|
103
|
-
const accepted = Object.fromEntries(Object.entries(values).filter(([id]) => !failed?.has(id)));
|
|
94
|
+
const accepted = Object.fromEntries(Object.entries(write.values).filter(([id]) => !failed?.has(id)));
|
|
104
95
|
try {
|
|
105
|
-
const { release, persistFailure } = await receiver.settleAccepted(accepted, epoch);
|
|
96
|
+
const { release, persistFailure } = await receiver.settleAccepted(accepted, epoch, write.cacheMerges);
|
|
106
97
|
this.#releases.push(release);
|
|
107
98
|
if (persistFailure !== undefined) {
|
|
108
99
|
logger.warn(
|
|
@@ -132,7 +123,6 @@ export class RemoteWriteParticipant implements Transaction.Participant {
|
|
|
132
123
|
}
|
|
133
124
|
|
|
134
125
|
rollback() {
|
|
135
|
-
this.#request = [];
|
|
136
126
|
this.#pending = new Map();
|
|
137
127
|
}
|
|
138
128
|
|
|
@@ -159,8 +149,15 @@ export namespace RemoteWriteParticipant {
|
|
|
159
149
|
* Settle {@link values}, except for an attribute the peer settled after {@link epoch}: what the device
|
|
160
150
|
* reported while the write was in flight outranks the write. The values apply in memory even when persisting
|
|
161
151
|
* them fails.
|
|
152
|
+
*
|
|
153
|
+
* @param cacheMerges per attribute, the value to cache from the value cached when this settles; see
|
|
154
|
+
* {@link RemoteWriter.PreparedWrite.cacheMerges}
|
|
162
155
|
*/
|
|
163
|
-
settleAccepted(
|
|
156
|
+
settleAccepted(
|
|
157
|
+
values: Val.Struct,
|
|
158
|
+
epoch: number,
|
|
159
|
+
cacheMerges?: RemoteWriter.PreparedWrite["cacheMerges"],
|
|
160
|
+
): Promise<Settled>;
|
|
164
161
|
}
|
|
165
162
|
|
|
166
163
|
/**
|
|
@@ -188,6 +185,6 @@ export namespace RemoteWriteParticipant {
|
|
|
188
185
|
export interface PendingWrite {
|
|
189
186
|
receiver: Receiver;
|
|
190
187
|
epoch: number;
|
|
191
|
-
|
|
188
|
+
write: RemoteWriter.PreparedWrite;
|
|
192
189
|
}
|
|
193
190
|
}
|
|
@@ -4,13 +4,22 @@
|
|
|
4
4
|
* SPDX-License-Identifier: Apache-2.0
|
|
5
5
|
*/
|
|
6
6
|
|
|
7
|
+
import { InvalidGroupOperationError } from "#endpoint/errors.js";
|
|
7
8
|
import { ClientStructure } from "#node/client/ClientStructure.js";
|
|
8
9
|
import type { ClientNode } from "#node/ClientNode.js";
|
|
9
10
|
import { InternalError } from "@matter/general";
|
|
10
|
-
import { AttributeModel } from "@matter/model";
|
|
11
|
+
import { AttributeModel, type DataModelPath } from "@matter/model";
|
|
11
12
|
import { Write, WriteResult, type Val } from "@matter/protocol";
|
|
12
|
-
import {
|
|
13
|
+
import {
|
|
14
|
+
AttributeId,
|
|
15
|
+
Status,
|
|
16
|
+
type ClusterId,
|
|
17
|
+
type ClusterType,
|
|
18
|
+
type EndpointNumber,
|
|
19
|
+
type FabricIndex,
|
|
20
|
+
} from "@matter/types";
|
|
13
21
|
import type { ClientNodeStore } from "./ClientNodeStore.js";
|
|
22
|
+
import { FabricScopedListWrite } from "./FabricScopedListWrite.js";
|
|
14
23
|
|
|
15
24
|
/**
|
|
16
25
|
* Persistence handler for {@link ClientNodeStore}.
|
|
@@ -18,12 +27,38 @@ import type { ClientNodeStore } from "./ClientNodeStore.js";
|
|
|
18
27
|
* A remote writer conveys updates to the remote node. This performs actual persistence for client nodes where the
|
|
19
28
|
* local store is just a cache and the source of truth is on the remote device.
|
|
20
29
|
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
30
|
+
* The datasource has a write prepared per cluster in the transaction's settled step, before any participant commits,
|
|
31
|
+
* so a refusal rejects the transaction before any Write Request goes out. The prepared writes of the node's clusters
|
|
32
|
+
* are then sent in one Write Request.
|
|
24
33
|
*/
|
|
25
34
|
export interface RemoteWriter {
|
|
26
|
-
|
|
35
|
+
/**
|
|
36
|
+
* Decide whether {@link proposal} may go to the remote node, and prepare it for {@link send}. Synchronous, and
|
|
37
|
+
* writes nothing.
|
|
38
|
+
*
|
|
39
|
+
* A peer receives only our entries of a fabric-scoped list; see {@link FabricScopedListWrite}. Every write of a
|
|
40
|
+
* fabric-scoped list to a peer needs our fabric index on the peer, also one of a value that is not a list.
|
|
41
|
+
*
|
|
42
|
+
* @throws WriteError with CONSTRAINT_ERROR to refuse a fabric-scoped list
|
|
43
|
+
*/
|
|
44
|
+
prepare(proposal: RemoteWriter.Proposal): RemoteWriter.PreparedWrite;
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Refuse every state change on a node that takes no writes through its endpoints.
|
|
48
|
+
*
|
|
49
|
+
* @param path the path of the values the change is for
|
|
50
|
+
* @throws InvalidGroupOperationError for a group node
|
|
51
|
+
*/
|
|
52
|
+
assertWritable(path: DataModelPath): void;
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Send {@link writes} in one Write Request.
|
|
56
|
+
*
|
|
57
|
+
* Resolves with a status per attribute once the peer answered, including those declined locally because the peer's
|
|
58
|
+
* cluster type cannot express them; when every attribute is declined locally, nothing is sent. Rejects when the
|
|
59
|
+
* peer does not answer, as then nothing is known to have been applied.
|
|
60
|
+
*/
|
|
61
|
+
send(writes: RemoteWriter.PreparedWrite[]): Promise<WriteResult.AttributeStatus[]>;
|
|
27
62
|
}
|
|
28
63
|
|
|
29
64
|
const attrCache = new WeakMap<object, Record<string, ClusterType.Attribute>>();
|
|
@@ -32,17 +67,33 @@ const attrCache = new WeakMap<object, Record<string, ClusterType.Attribute>>();
|
|
|
32
67
|
const ID_KEY = /^(0|[1-9]\d*)$/;
|
|
33
68
|
|
|
34
69
|
export function RemoteWriter(node: ClientNode, structure: ClientStructure): RemoteWriter {
|
|
35
|
-
|
|
36
|
-
const
|
|
37
|
-
const
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
70
|
+
function clusterFor(number: EndpointNumber, behaviorId: string) {
|
|
71
|
+
const clusterId = Number.parseInt(behaviorId) as ClusterId;
|
|
72
|
+
const cluster = structure.clusterFor(number, clusterId);
|
|
73
|
+
if (cluster === undefined) {
|
|
74
|
+
throw new InternalError(`Cannot remote write to non-cluster behavior ${behaviorId}`);
|
|
75
|
+
}
|
|
76
|
+
return { clusterId, cluster };
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
return {
|
|
80
|
+
assertWritable(path) {
|
|
81
|
+
if (node.nodeType === "group") {
|
|
82
|
+
throw new InvalidGroupOperationError(
|
|
83
|
+
`Cannot write ${path}: writing state on a group endpoint is not supported; ` +
|
|
84
|
+
"use group.interaction.write() with a group path",
|
|
85
|
+
);
|
|
44
86
|
}
|
|
87
|
+
},
|
|
88
|
+
|
|
89
|
+
prepare({ number, behaviorId, values, cached, path }) {
|
|
90
|
+
const { clusterId, cluster } = clusterFor(number, behaviorId);
|
|
45
91
|
const attrs = attrsFor(cluster);
|
|
92
|
+
const attributes = new Array<Write.Attribute>();
|
|
93
|
+
const declined = new Array<WriteResult.AttributeStatus>();
|
|
94
|
+
const sent: Val.Struct = {};
|
|
95
|
+
let cacheMerges: Map<string, (cached: Val) => Val> | undefined;
|
|
96
|
+
let fabricIndex: FabricIndex | undefined;
|
|
46
97
|
|
|
47
98
|
for (const id in values) {
|
|
48
99
|
if (id.startsWith("__")) {
|
|
@@ -55,35 +106,114 @@ export function RemoteWriter(node: ClientNode, structure: ClientStructure): Remo
|
|
|
55
106
|
continue;
|
|
56
107
|
}
|
|
57
108
|
|
|
58
|
-
|
|
109
|
+
let value = values[id];
|
|
110
|
+
|
|
111
|
+
if (attr.schema.fabricScopedList) {
|
|
112
|
+
// Every write of a fabric-scoped list needs our index, also one of a value that is not a list
|
|
113
|
+
const attributePath = path.at(attr.schema.propertyName);
|
|
114
|
+
fabricIndex ??= FabricScopedListWrite.requireFabricIndex(node.fabricIndexOnPeer, attributePath);
|
|
115
|
+
if (Array.isArray(value)) {
|
|
116
|
+
const entries = FabricScopedListWrite.entriesToSend(
|
|
117
|
+
value,
|
|
118
|
+
cached?.[id],
|
|
119
|
+
fabricIndex,
|
|
120
|
+
attributePath,
|
|
121
|
+
entrySchemaOf(attr.schema, attributePath),
|
|
122
|
+
);
|
|
123
|
+
const index = fabricIndex;
|
|
124
|
+
(cacheMerges ??= new Map<string, (cached: Val) => Val>()).set(id, cachedList =>
|
|
125
|
+
FabricScopedListWrite.cachedAfterWrite(cachedList, entries, index),
|
|
126
|
+
);
|
|
127
|
+
value = entries;
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
sent[id] = value;
|
|
132
|
+
attributes.push(
|
|
59
133
|
Write.Attribute({
|
|
60
134
|
endpoint: number,
|
|
61
135
|
cluster: cluster as any,
|
|
62
136
|
attributes: [attr as any],
|
|
63
|
-
value
|
|
137
|
+
value,
|
|
64
138
|
}),
|
|
65
139
|
);
|
|
66
140
|
}
|
|
67
|
-
}
|
|
68
141
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
142
|
+
return { number, behaviorId, values: sent, attributes, declined, cacheMerges };
|
|
143
|
+
},
|
|
144
|
+
|
|
145
|
+
async send(writes) {
|
|
146
|
+
const attributes = writes.flatMap(write => write.attributes);
|
|
147
|
+
|
|
148
|
+
// Remote statuses first so a device error, not one of ours, is the error a single-failure write surfaces
|
|
149
|
+
const result = attributes.length
|
|
150
|
+
? ((await node.interaction.write(Write(...attributes))) as WriteResult.AttributeStatus[])
|
|
151
|
+
: [];
|
|
152
|
+
result.push(...writes.flatMap(write => write.declined));
|
|
74
153
|
|
|
75
|
-
|
|
154
|
+
return result;
|
|
155
|
+
},
|
|
76
156
|
};
|
|
77
157
|
}
|
|
78
158
|
|
|
159
|
+
function entrySchemaOf(schema: AttributeModel, path: DataModelPath) {
|
|
160
|
+
const entrySchema = schema.listEntry;
|
|
161
|
+
if (entrySchema === undefined) {
|
|
162
|
+
throw new InternalError(`Fabric-scoped list ${path} has no entry schema`);
|
|
163
|
+
}
|
|
164
|
+
return entrySchema;
|
|
165
|
+
}
|
|
166
|
+
|
|
79
167
|
export namespace RemoteWriter {
|
|
80
|
-
|
|
168
|
+
/**
|
|
169
|
+
* The values a transaction proposes for one cluster of the remote node.
|
|
170
|
+
*/
|
|
171
|
+
export interface Proposal {
|
|
81
172
|
number: EndpointNumber;
|
|
82
173
|
behaviorId: string;
|
|
83
174
|
values: Val.Struct;
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* The cached values of the cluster, against which an entry of another fabric in a fabric-scoped list is
|
|
178
|
+
* checked.
|
|
179
|
+
*/
|
|
180
|
+
cached: Val.Struct | undefined;
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* The path of the values, for a refusal.
|
|
184
|
+
*/
|
|
185
|
+
path: DataModelPath;
|
|
84
186
|
}
|
|
85
187
|
|
|
86
|
-
|
|
188
|
+
/**
|
|
189
|
+
* The values to send for one cluster, as {@link RemoteWriter.prepare} decided.
|
|
190
|
+
*/
|
|
191
|
+
export interface PreparedWrite {
|
|
192
|
+
number: EndpointNumber;
|
|
193
|
+
behaviorId: string;
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* The values sent, by attribute ID. A fabric-scoped list holds only our entries.
|
|
197
|
+
*/
|
|
198
|
+
values: Val.Struct;
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* The attribute writes of {@link values} for the Write Request.
|
|
202
|
+
*/
|
|
203
|
+
attributes: Write.Attribute[];
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* The statuses of the attributes declined locally because the peer's cluster type cannot express them.
|
|
207
|
+
*/
|
|
208
|
+
declined: WriteResult.AttributeStatus[];
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* For an attribute whose cached value does not simply become the value sent, the value to cache once the peer
|
|
212
|
+
* accepted the write, from the value cached then. For a fabric-scoped list the device replaced only our
|
|
213
|
+
* entries, so the cached entries of other fabrics stay.
|
|
214
|
+
*/
|
|
215
|
+
cacheMerges?: ReadonlyMap<string, (cached: Val) => Val>;
|
|
216
|
+
}
|
|
87
217
|
}
|
|
88
218
|
|
|
89
219
|
/**
|
|
@@ -15,7 +15,7 @@ interface StorageParticipant extends Transaction.Participant {
|
|
|
15
15
|
}
|
|
16
16
|
|
|
17
17
|
/**
|
|
18
|
-
* Factory function for the default implementation of {@link Datasource.
|
|
18
|
+
* Factory function for the default implementation of {@link Datasource.PersistentStore}.
|
|
19
19
|
*
|
|
20
20
|
* Performs read & write for non-volatile values for a single behavior via the {@link ServerEndpointStore} interface.
|
|
21
21
|
*/
|
|
@@ -23,7 +23,7 @@ export function DatasourceStore(
|
|
|
23
23
|
endpointStore: EndpointStore,
|
|
24
24
|
behaviorId: string,
|
|
25
25
|
initialValues: Val.Struct | undefined,
|
|
26
|
-
): Datasource.
|
|
26
|
+
): Datasource.PersistentStore {
|
|
27
27
|
return {
|
|
28
28
|
initialValues,
|
|
29
29
|
|
|
@@ -46,7 +46,7 @@ export class ServerEndpointStore extends EndpointStore {
|
|
|
46
46
|
}
|
|
47
47
|
|
|
48
48
|
/**
|
|
49
|
-
* Create a {@link Datasource.
|
|
49
|
+
* Create a {@link Datasource.PersistentStore} for a behavior.
|
|
50
50
|
*/
|
|
51
51
|
createStoreForBehavior(behaviorId: string) {
|
|
52
52
|
const initialValues = this.consumeInitialValues(behaviorId);
|
|
@@ -31,8 +31,16 @@ import {
|
|
|
31
31
|
nextEmitOf,
|
|
32
32
|
} from "@matter/general";
|
|
33
33
|
import { AccessLevel, MatterModel } from "@matter/model";
|
|
34
|
-
import {
|
|
35
|
-
|
|
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)
|
|
241
|
-
|
|
242
|
-
|
|
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
|
|
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();
|