@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
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
import { InternalError } from "@matter/general";
|
|
8
8
|
import { AccessControl, ExpiredReferenceError, Val } from "@matter/protocol";
|
|
9
9
|
import type { Supervision } from "../../supervision/Supervision.js";
|
|
10
|
+
import { UncachedValueError } from "./errors.js";
|
|
10
11
|
import {
|
|
11
12
|
memberFallbackKeyFor,
|
|
12
13
|
memberKeyFor,
|
|
@@ -14,14 +15,14 @@ import {
|
|
|
14
15
|
memberSlotOf,
|
|
15
16
|
memberValueOf,
|
|
16
17
|
} from "./MemberKeys.js";
|
|
17
|
-
import
|
|
18
|
+
import { ValReference } from "./ValReference.js";
|
|
18
19
|
|
|
19
20
|
type Container = Record<string | number, Val>;
|
|
20
21
|
|
|
21
22
|
/**
|
|
22
23
|
* ManagedReference manages a reference to a container property of another reference.
|
|
23
24
|
*
|
|
24
|
-
* The ManagedReference
|
|
25
|
+
* The ManagedReference clones the container on write unless the transaction already owns it.
|
|
25
26
|
*
|
|
26
27
|
* This serves the following purposes:
|
|
27
28
|
*
|
|
@@ -31,9 +32,27 @@ type Container = Record<string | number, Val>;
|
|
|
31
32
|
*
|
|
32
33
|
* - Preserves metadata regarding the state of the value
|
|
33
34
|
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
35
|
+
* A member reference follows whatever container the parent holds at its key. A list entry reference is bound to one
|
|
36
|
+
* entry instead, because an index does not identify an entry (see {@link ManagedReference.Binding}):
|
|
37
|
+
*
|
|
38
|
+
* | State | Cause | {@link value} | Writes |
|
|
39
|
+
* |---------|----------------------------------------------------------|--------------------|-------------------------|
|
|
40
|
+
* | live | the member holds a container | that container | allowed |
|
|
41
|
+
* | default | the member is absent; the reference has a default | the default | `UncachedValueError` |
|
|
42
|
+
* | absent | member absent without default, or container above absent;| `undefined`/`null` | `PhantomReferenceError` |
|
|
43
|
+
* | | for an entry, only after another transaction's commit | | |
|
|
44
|
+
* | expired | the owning context exited, a parent is read-only, or a | last container | `ExpiredReferenceError` |
|
|
45
|
+
* | | change in this session moved, removed or replaced this | | |
|
|
46
|
+
* | | entry | | |
|
|
47
|
+
*
|
|
48
|
+
* A reference to a mandatory member has a default when its parent keys by ID, which only a mirror's root does; see
|
|
49
|
+
* {@link ValReference.PrimaryKey}. A reference makes its default when it enters "default" and serves that same value
|
|
50
|
+
* until it leaves; a read never stores it. A value built from the default and assigned whole is stored like any other
|
|
51
|
+
* assignment and replaces the remote value. A write below a reference in "default" fails the same way. Before the
|
|
52
|
+
* default is checked, a write throws what the datasource's `ExternallyMutableStore.assertWritable` throws. "default"
|
|
53
|
+
* and "absent" return to "live" when the member holds a container again, for example after a report or an assignment.
|
|
54
|
+
* Once a transaction changed the cluster, its root keeps its own copy, so a later report does not reach it. A live
|
|
55
|
+
* member that becomes absent again, for example by a rollback, enters "default" or "absent". "expired" is final.
|
|
37
56
|
*/
|
|
38
57
|
export class ManagedReference implements ValReference {
|
|
39
58
|
readonly primaryKey = "name";
|
|
@@ -46,35 +65,43 @@ export class ManagedReference implements ValReference {
|
|
|
46
65
|
#key: string | number;
|
|
47
66
|
#fallbackKey: string | number | undefined;
|
|
48
67
|
#readFallbackKey: string | number | undefined;
|
|
49
|
-
#
|
|
50
|
-
#
|
|
68
|
+
#clone: (container: Val) => Val;
|
|
69
|
+
#makeDefault: (() => Val) | undefined;
|
|
70
|
+
#servesDefault = false;
|
|
51
71
|
#session: AccessControl.Session;
|
|
52
|
-
#expired = false;
|
|
53
72
|
#location: AccessControl.Location;
|
|
54
|
-
#value:
|
|
73
|
+
#value: Val;
|
|
55
74
|
#dynamicContainer: Val.Struct | undefined;
|
|
56
75
|
#dynamicSource: Val | undefined;
|
|
76
|
+
#binding: ManagedReference.Binding;
|
|
77
|
+
#entry: unknown;
|
|
78
|
+
#copies?: WeakSet<object>;
|
|
79
|
+
#detached = false;
|
|
57
80
|
|
|
58
81
|
/**
|
|
59
82
|
* @param parent a reference to the container we reference
|
|
60
83
|
* @param name the name (in the case of structs) or index (in case of lists)
|
|
61
84
|
* @param id the lookup ID, used when {@link parent} keys its members by ID
|
|
62
|
-
* @param
|
|
63
|
-
* @param clone clones the container prior to write; undefined if not transactional
|
|
85
|
+
* @param clone clones the container prior to write
|
|
64
86
|
* @param session the access control session
|
|
87
|
+
* @param binding what the reference stays bound to when the parent changes
|
|
88
|
+
* @param makeDefault makes the default to serve while the member is absent; called once each time the member
|
|
89
|
+
* becomes absent
|
|
65
90
|
*/
|
|
66
91
|
constructor(
|
|
67
92
|
parent: ValReference<Val.Collection>,
|
|
68
93
|
name: string | number,
|
|
69
94
|
id: number | undefined,
|
|
70
|
-
assertWriteOk: (value: Val) => void,
|
|
71
95
|
clone: (container: Val) => Val,
|
|
72
96
|
session: AccessControl.Session,
|
|
97
|
+
binding: ManagedReference.Binding,
|
|
98
|
+
makeDefault?: () => Val,
|
|
73
99
|
) {
|
|
74
100
|
this.parent = parent;
|
|
75
|
-
this.#assertWriteOk = assertWriteOk;
|
|
76
101
|
this.#clone = clone;
|
|
102
|
+
this.#makeDefault = makeDefault;
|
|
77
103
|
this.#session = session;
|
|
104
|
+
this.#binding = binding;
|
|
78
105
|
|
|
79
106
|
this.#location = {
|
|
80
107
|
...parent.location,
|
|
@@ -89,10 +116,8 @@ export class ManagedReference implements ValReference {
|
|
|
89
116
|
this.#readFallbackKey = readFallbackKey;
|
|
90
117
|
|
|
91
118
|
this.#bindDynamicContainer();
|
|
92
|
-
this.#value =
|
|
93
|
-
|
|
94
|
-
? memberValueOf(parent.value as Container, key, readFallbackKey)
|
|
95
|
-
: memberValueOf(this.#dynamicContainer as Container, key, fallbackKey);
|
|
119
|
+
this.#value = this.#memberValue();
|
|
120
|
+
this.#entry = this.#value;
|
|
96
121
|
|
|
97
122
|
// Propagate supervision config from parent
|
|
98
123
|
if (parent.supervisionConfig) {
|
|
@@ -106,34 +131,20 @@ export class ManagedReference implements ValReference {
|
|
|
106
131
|
}
|
|
107
132
|
|
|
108
133
|
get rootOwner() {
|
|
109
|
-
return this.parent
|
|
134
|
+
return this.parent.rootOwner;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
get mirrorsRemote() {
|
|
138
|
+
return this.parent.mirrorsRemote;
|
|
110
139
|
}
|
|
111
140
|
|
|
112
141
|
get value() {
|
|
113
142
|
// Authorization is unnecessary here because the reference would not exist if access is unauthorized
|
|
114
|
-
// Note that we allow read from expired references
|
|
115
143
|
return this.#value;
|
|
116
144
|
}
|
|
117
145
|
|
|
118
|
-
set value(newValue: Val) {
|
|
119
|
-
if (this.#value === newValue) {
|
|
120
|
-
return;
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
// Authorization and validation
|
|
124
|
-
this.#assertWriteOk(newValue);
|
|
125
|
-
|
|
126
|
-
// Set the value directly before change() so change() doesn't create a useless clone
|
|
127
|
-
this.#replaceValue(newValue);
|
|
128
|
-
|
|
129
|
-
// Now use change to complete the update
|
|
130
|
-
this.change(() => {
|
|
131
|
-
this.#writeTo(this.#dynamicContainer ?? (this.parent!.value as Container), newValue);
|
|
132
|
-
});
|
|
133
|
-
}
|
|
134
|
-
|
|
135
146
|
get expired() {
|
|
136
|
-
return this.#expired;
|
|
147
|
+
return this.#detached || this.parent.expired;
|
|
137
148
|
}
|
|
138
149
|
|
|
139
150
|
get location() {
|
|
@@ -144,64 +155,129 @@ export class ManagedReference implements ValReference {
|
|
|
144
155
|
this.#location = loc;
|
|
145
156
|
}
|
|
146
157
|
|
|
147
|
-
|
|
148
|
-
if (
|
|
149
|
-
|
|
158
|
+
assertWritable() {
|
|
159
|
+
if (this.expired) {
|
|
160
|
+
throw new ExpiredReferenceError(this.location);
|
|
150
161
|
}
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
this.#session,
|
|
155
|
-
);
|
|
156
|
-
return memberValueOf(origProperties as Container, this.#key, this.#fallbackKey);
|
|
162
|
+
this.parent.assertWritable();
|
|
163
|
+
if (this.#servesDefault) {
|
|
164
|
+
throw new UncachedValueError(this.location);
|
|
157
165
|
}
|
|
158
|
-
return memberValueOf(this.parent!.original as Container, this.#key, this.#readFallbackKey);
|
|
159
166
|
}
|
|
160
167
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
168
|
+
/**
|
|
169
|
+
* A container a `Val.properties` provider serves, and every container below it, is never owned, even when the
|
|
170
|
+
* provider serves a container the transaction cloned for another member. The provider keeps the value its setter
|
|
171
|
+
* accepted, so a later change must clone it again instead of changing it in place.
|
|
172
|
+
*/
|
|
173
|
+
owns(container: Val) {
|
|
174
|
+
return this.#dynamicContainer === undefined && this.parent.owns(container);
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
adopt(container: Val) {
|
|
178
|
+
this.parent.adopt(container);
|
|
179
|
+
}
|
|
165
180
|
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
181
|
+
/**
|
|
182
|
+
* Clones the container unless the transaction {@link owns} it, runs {@link mutator}, then stores the container in
|
|
183
|
+
* the parent. A dynamic provider's setter therefore receives the container after every change, with the change
|
|
184
|
+
* applied.
|
|
185
|
+
*/
|
|
186
|
+
change(mutator: () => void) {
|
|
187
|
+
ValReference.writableContainerOf(this);
|
|
188
|
+
|
|
189
|
+
this.parent.change(() => {
|
|
190
|
+
// The parent's change may refresh this reference and expire it
|
|
191
|
+
ValReference.writableContainerOf(this);
|
|
192
|
+
|
|
193
|
+
if (!this.owns(this.#value)) {
|
|
194
|
+
const clone = this.#clone(this.#value);
|
|
195
|
+
this.adopt(clone);
|
|
196
|
+
if (this.#binding === "entry" && typeof clone === "object" && clone !== null) {
|
|
197
|
+
(this.#copies ??= new WeakSet()).add(clone);
|
|
198
|
+
}
|
|
199
|
+
this.#replaceValue(clone, "session");
|
|
172
200
|
}
|
|
173
201
|
|
|
174
|
-
// Apply changes
|
|
175
202
|
mutator();
|
|
203
|
+
|
|
204
|
+
this.#writeTo(this.#dynamicContainer ?? (this.parent.value as Container), this.#value);
|
|
176
205
|
}, this.#key);
|
|
177
206
|
}
|
|
178
207
|
|
|
179
|
-
refresh() {
|
|
180
|
-
if (this.
|
|
181
|
-
this.#expired = true;
|
|
208
|
+
refresh(cause: ValReference.RefreshCause) {
|
|
209
|
+
if (this.expired) {
|
|
182
210
|
return;
|
|
183
211
|
}
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
this.#
|
|
212
|
+
|
|
213
|
+
if (this.parent.value === undefined || this.parent.value === null) {
|
|
214
|
+
this.#servesDefault = false;
|
|
215
|
+
this.#follow(undefined, cause);
|
|
187
216
|
return;
|
|
188
217
|
}
|
|
189
218
|
|
|
190
219
|
// A member the parent serves from a provider must stay served for the life of this reference; a reference that
|
|
191
220
|
// found no provider is never asked again, so a parent may not start serving one either
|
|
192
|
-
if (this.#dynamicContainer !== undefined && this.parent
|
|
221
|
+
if (this.#dynamicContainer !== undefined && this.parent.value !== this.#dynamicSource) {
|
|
193
222
|
this.#bindDynamicContainer();
|
|
194
223
|
if (this.#dynamicContainer === undefined) {
|
|
195
224
|
throw new InternalError(`Value at ${this.location.path} no longer serves ${this.#key}`);
|
|
196
225
|
}
|
|
197
226
|
}
|
|
198
227
|
|
|
228
|
+
this.#follow(this.#memberValue(), cause);
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
#memberValue() {
|
|
199
232
|
const value =
|
|
200
233
|
this.#dynamicContainer === undefined
|
|
201
|
-
? memberValueOf(this.parent
|
|
234
|
+
? memberValueOf(this.parent.value as Container, this.#key, this.#readFallbackKey)
|
|
202
235
|
: memberValueOf(this.#dynamicContainer as Container, this.#key, this.#fallbackKey);
|
|
236
|
+
if (value !== undefined || this.#makeDefault === undefined) {
|
|
237
|
+
this.#servesDefault = false;
|
|
238
|
+
return value;
|
|
239
|
+
}
|
|
240
|
+
if (!this.#servesDefault) {
|
|
241
|
+
this.#servesDefault = true;
|
|
242
|
+
return this.#makeDefault();
|
|
243
|
+
}
|
|
244
|
+
return this.#value;
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* Take `value` as the referenced value. An entry reference expires instead when a change in this session put
|
|
249
|
+
* another entry at its index. It accepts its entry and every copy it made of that entry, because only a rollback
|
|
250
|
+
* puts an earlier copy back. After another transaction's commit, an entry reference follows its index like a
|
|
251
|
+
* member reference and binds to the entry now there.
|
|
252
|
+
*/
|
|
253
|
+
#follow(value: unknown, cause: ValReference.RefreshCause) {
|
|
254
|
+
if (this.#binding === "entry") {
|
|
255
|
+
if (cause === "external") {
|
|
256
|
+
this.#entry = value;
|
|
257
|
+
this.#copies = undefined;
|
|
258
|
+
} else if (!this.#holds(value)) {
|
|
259
|
+
this.#detach();
|
|
260
|
+
return;
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
this.#replaceValue(value, cause);
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
#holds(value: unknown) {
|
|
268
|
+
if (value === this.#entry) {
|
|
269
|
+
return true;
|
|
270
|
+
}
|
|
271
|
+
return typeof value === "object" && value !== null && !!this.#copies?.has(value);
|
|
272
|
+
}
|
|
203
273
|
|
|
204
|
-
|
|
274
|
+
/**
|
|
275
|
+
* Stop following the entry. The reference keeps its last value and is {@link expired}. It leaves the parent's
|
|
276
|
+
* subrefs, so the next read at its index creates a reference for the entry now there.
|
|
277
|
+
*/
|
|
278
|
+
#detach() {
|
|
279
|
+
this.#detached = true;
|
|
280
|
+
delete this.parent.subrefs?.[this.#key];
|
|
205
281
|
}
|
|
206
282
|
|
|
207
283
|
/**
|
|
@@ -209,7 +285,7 @@ export class ManagedReference implements ValReference {
|
|
|
209
285
|
* struct it was derived from, so this runs again whenever the parent replaces that struct.
|
|
210
286
|
*/
|
|
211
287
|
#bindDynamicContainer() {
|
|
212
|
-
const parent = this.parent
|
|
288
|
+
const parent = this.parent;
|
|
213
289
|
|
|
214
290
|
this.#dynamicSource = parent.value;
|
|
215
291
|
this.#dynamicContainer = undefined;
|
|
@@ -236,14 +312,27 @@ export class ManagedReference implements ValReference {
|
|
|
236
312
|
}
|
|
237
313
|
}
|
|
238
314
|
|
|
239
|
-
#replaceValue(newValue: Val) {
|
|
315
|
+
#replaceValue(newValue: Val, cause: ValReference.RefreshCause) {
|
|
240
316
|
this.#value = newValue;
|
|
241
317
|
|
|
242
318
|
const subrefs = this.subrefs;
|
|
243
319
|
if (subrefs) {
|
|
244
320
|
for (const key in subrefs) {
|
|
245
|
-
subrefs[key].refresh();
|
|
321
|
+
subrefs[key].refresh(cause);
|
|
246
322
|
}
|
|
247
323
|
}
|
|
248
324
|
}
|
|
249
325
|
}
|
|
326
|
+
|
|
327
|
+
export namespace ManagedReference {
|
|
328
|
+
/**
|
|
329
|
+
* What a reference stays bound to when its parent changes.
|
|
330
|
+
*
|
|
331
|
+
* - `member`: the key. A struct member is identified by its name, so the reference follows the container the
|
|
332
|
+
* parent holds there.
|
|
333
|
+
* - `entry`: the entry it was read for, or the entry another transaction's commit put at its index. An index does
|
|
334
|
+
* not identify a list entry: a list method, a length change, an assignment at the index or of the whole list puts
|
|
335
|
+
* another entry there.
|
|
336
|
+
*/
|
|
337
|
+
export type Binding = "member" | "entry";
|
|
338
|
+
}
|
|
@@ -97,7 +97,7 @@ export function NameResolver(
|
|
|
97
97
|
}
|
|
98
98
|
|
|
99
99
|
return (val: Val) => {
|
|
100
|
-
const parent = (val
|
|
100
|
+
const parent = Internal.referenceOf(val)?.parent?.owner;
|
|
101
101
|
if (parent) {
|
|
102
102
|
return parentReader(parent as Val.Collection);
|
|
103
103
|
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022-2026 Matter.js Authors
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { AccessControl, ExpiredReferenceError, Val } from "@matter/protocol";
|
|
8
|
+
import type { ValReference } from "./ValReference.js";
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* A read-only reference to a value that has no slot in managed state, such as an entry a list method removed or an
|
|
12
|
+
* entry a sort comparator receives.
|
|
13
|
+
*
|
|
14
|
+
* The reference serves the value it was given, not a copy. A manager over it reads through the same path as over a
|
|
15
|
+
* live reference, with the same authorization and name resolution. The reference counts as expired, so every write
|
|
16
|
+
* through it or through a reference below it throws {@link ExpiredReferenceError}.
|
|
17
|
+
*/
|
|
18
|
+
export class ReadOnlyReference implements ValReference {
|
|
19
|
+
readonly primaryKey = "name";
|
|
20
|
+
readonly expired = true;
|
|
21
|
+
|
|
22
|
+
subrefs?: Record<number | string, ValReference>;
|
|
23
|
+
owner?: Val;
|
|
24
|
+
location: AccessControl.Location;
|
|
25
|
+
|
|
26
|
+
#value: Val;
|
|
27
|
+
#rootOwner: unknown;
|
|
28
|
+
|
|
29
|
+
readonly mirrorsRemote: boolean;
|
|
30
|
+
|
|
31
|
+
constructor(value: Val, location: AccessControl.Location, rootOwner: unknown, mirrorsRemote: boolean) {
|
|
32
|
+
this.#value = value;
|
|
33
|
+
this.location = location;
|
|
34
|
+
this.#rootOwner = rootOwner;
|
|
35
|
+
this.mirrorsRemote = mirrorsRemote;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
get value() {
|
|
39
|
+
return this.#value;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
get rootOwner() {
|
|
43
|
+
return this.#rootOwner;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
change() {
|
|
47
|
+
throw new ExpiredReferenceError(this.location);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
assertWritable() {
|
|
51
|
+
throw new ExpiredReferenceError(this.location);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
refresh() {}
|
|
55
|
+
|
|
56
|
+
owns() {
|
|
57
|
+
return false;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
adopt() {}
|
|
61
|
+
}
|
|
@@ -5,7 +5,9 @@
|
|
|
5
5
|
*/
|
|
6
6
|
|
|
7
7
|
import type { AccessControl, Val } from "@matter/protocol";
|
|
8
|
+
import { ExpiredReferenceError, PhantomReferenceError } from "@matter/protocol";
|
|
8
9
|
import type { Supervision } from "../../supervision/Supervision.js";
|
|
10
|
+
import { Internal } from "./Internal.js";
|
|
9
11
|
|
|
10
12
|
/**
|
|
11
13
|
* A Reference offers a simple mechanism for referring to properties by reference.
|
|
@@ -14,17 +16,18 @@ import type { Supervision } from "../../supervision/Supervision.js";
|
|
|
14
16
|
*/
|
|
15
17
|
export interface ValReference<T extends Val = Val> {
|
|
16
18
|
/**
|
|
17
|
-
* The current value of the referenced property.
|
|
19
|
+
* The current value of the referenced property. While the property is absent, a reference with a default for it
|
|
20
|
+
* serves that default, and any other reference serves `undefined` or `null`. A reference below a container that
|
|
21
|
+
* is absent without a default serves `undefined` or `null` too. An expired nested reference keeps the last
|
|
22
|
+
* container it saw, which a live reference to the same entry may still change. The root reference throws
|
|
23
|
+
* {@link ExpiredReferenceError} after its owning context exits.
|
|
18
24
|
*/
|
|
19
|
-
value: T;
|
|
25
|
+
readonly value: T | undefined | null;
|
|
20
26
|
|
|
21
27
|
/**
|
|
22
|
-
*
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* When true, the reference is no longer usable because the owning context has exited.
|
|
28
|
+
* When true, the reference no longer tracks live state: the owning context has exited, a change in this session
|
|
29
|
+
* moved, removed or replaced the list entry it was read for, or the reference is a read-only view. Final, and true
|
|
30
|
+
* for every reference below an expired one.
|
|
28
31
|
*/
|
|
29
32
|
readonly expired: boolean;
|
|
30
33
|
|
|
@@ -39,9 +42,10 @@ export interface ValReference<T extends Val = Val> {
|
|
|
39
42
|
subrefs?: Record<number | string, ValReference>;
|
|
40
43
|
|
|
41
44
|
/**
|
|
42
|
-
* Mutates data.
|
|
45
|
+
* Mutates data. A nested reference first clones its container unless the transaction {@link owns} it.
|
|
43
46
|
*
|
|
44
|
-
* Then runs the specified mutator to make the actual changes.
|
|
47
|
+
* Then runs the specified mutator to make the actual changes. A nested reference then stores the changed
|
|
48
|
+
* container in its parent, so the mutator changes state only through this reference or references below it.
|
|
45
49
|
*
|
|
46
50
|
* @param mutator the mutation logic, may freely modify {@link value}
|
|
47
51
|
* @param member the key of the member of {@link value} the mutation assigns. The root reference records it as
|
|
@@ -52,8 +56,37 @@ export interface ValReference<T extends Val = Val> {
|
|
|
52
56
|
|
|
53
57
|
/**
|
|
54
58
|
* Refresh any internal cache from the referenced container.
|
|
59
|
+
*
|
|
60
|
+
* @param cause what changed the container, which decides whether a list entry reference follows its index (see
|
|
61
|
+
* `ManagedReference.Binding`)
|
|
62
|
+
*/
|
|
63
|
+
refresh(cause: ValReference.RefreshCause): void;
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Throw the error a change through this reference fails with. Does not check whether the member is absent;
|
|
67
|
+
* {@link ValReference.containerOf} does. A change asks before it is applied and before it joins the transaction.
|
|
68
|
+
* The access check, list bounds checks and the validation of a new list entry run before this; validation of a
|
|
69
|
+
* value assigned to a struct member runs after it. The Remote API `add` asks before the access check.
|
|
70
|
+
*
|
|
71
|
+
* Checks in this order, so the first refusal wins: {@link expired}, then the datasource, then a default served by
|
|
72
|
+
* this reference or one above it.
|
|
73
|
+
*
|
|
74
|
+
* @throws ExpiredReferenceError when the reference is {@link expired}, naming the location of this reference
|
|
75
|
+
* @throws what the datasource's `ExternallyMutableStore.assertWritable` throws
|
|
76
|
+
* @throws UncachedValueError when this reference, or one above it, serves the default of an absent member
|
|
55
77
|
*/
|
|
56
|
-
|
|
78
|
+
assertWritable(): void;
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Whether the transaction cloned {@link container} since its last commit or rollback. A nested write may change
|
|
82
|
+
* an owned container in place; any other container may be shared with committed state.
|
|
83
|
+
*/
|
|
84
|
+
owns(container: Val): boolean;
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* Record {@link container}, a clone this transaction made, as owned until the transaction commits or rolls back.
|
|
88
|
+
*/
|
|
89
|
+
adopt(container: Val): void;
|
|
57
90
|
|
|
58
91
|
/**
|
|
59
92
|
* How this container keys its own members. Only a datasource root may key by element ID; every nested container
|
|
@@ -71,6 +104,11 @@ export interface ValReference<T extends Val = Val> {
|
|
|
71
104
|
*/
|
|
72
105
|
rootOwner?: any;
|
|
73
106
|
|
|
107
|
+
/**
|
|
108
|
+
* Whether the root datasource holds a copy of a remote node's values.
|
|
109
|
+
*/
|
|
110
|
+
readonly mirrorsRemote: boolean;
|
|
111
|
+
|
|
74
112
|
/**
|
|
75
113
|
* The parent of this reference, if any.
|
|
76
114
|
*/
|
|
@@ -83,12 +121,64 @@ export interface ValReference<T extends Val = Val> {
|
|
|
83
121
|
}
|
|
84
122
|
|
|
85
123
|
export namespace ValReference {
|
|
124
|
+
/**
|
|
125
|
+
* What changed a container before a refresh.
|
|
126
|
+
*
|
|
127
|
+
* - `session`: a change or rollback in the session that holds the reference.
|
|
128
|
+
* - `external`: another transaction committed, and the session has not written since.
|
|
129
|
+
*/
|
|
130
|
+
export type RefreshCause = "session" | "external";
|
|
131
|
+
|
|
86
132
|
/**
|
|
87
133
|
* How a container keys its own members.
|
|
88
134
|
*
|
|
89
|
-
* `id` also asserts provenance: only a datasource mirroring a peer keys by element ID, and
|
|
90
|
-
* the peer
|
|
91
|
-
* configured default or computed schema default) may enter it
|
|
135
|
+
* `id` also asserts provenance: only a datasource mirroring a peer keys by element ID, and such a container stores
|
|
136
|
+
* only values the peer reported or that are being written to it — no locally derived value (state-class field
|
|
137
|
+
* initializer, configured default or computed schema default) may enter it. A mandatory member the container
|
|
138
|
+
* does not hold reads as its default, which is never stored; see `ManagedReference`.
|
|
92
139
|
*/
|
|
93
140
|
export type PrimaryKey = "id" | "name";
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* The container {@link reference} points to, for a manager that reads its members. A nested reference whose
|
|
144
|
+
* owning context exited still serves the last container it saw.
|
|
145
|
+
*
|
|
146
|
+
* @throws PhantomReferenceError when the property, or a container above it, is absent
|
|
147
|
+
* @throws ExpiredReferenceError when the container is absent and the reference is expired, or when
|
|
148
|
+
* {@link reference} is a root reference whose owning context has exited
|
|
149
|
+
*/
|
|
150
|
+
export function containerOf<T extends Val>(reference: ValReference<T>): NonNullable<T> {
|
|
151
|
+
const container = reference.value;
|
|
152
|
+
if (container === undefined || container === null) {
|
|
153
|
+
if (reference.expired) {
|
|
154
|
+
throw new ExpiredReferenceError(reference.location);
|
|
155
|
+
}
|
|
156
|
+
throw new PhantomReferenceError(reference.location);
|
|
157
|
+
}
|
|
158
|
+
return container;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* The container {@link reference} points to, for a manager that writes its members.
|
|
163
|
+
*
|
|
164
|
+
* @throws ExpiredReferenceError when the reference is {@link ValReference.expired}, whether or not the container is
|
|
165
|
+
* present
|
|
166
|
+
* @throws PhantomReferenceError when the property, or a container above it, is absent
|
|
167
|
+
* @throws any error {@link ValReference.assertWritable} throws
|
|
168
|
+
*/
|
|
169
|
+
export function writableContainerOf<T extends Val>(reference: ValReference<T>): NonNullable<T> {
|
|
170
|
+
reference.assertWritable();
|
|
171
|
+
return containerOf(reference);
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Assert that {@link value} may be changed. Use it before a value built from {@link value}, such as a list with
|
|
176
|
+
* one more entry, replaces it: {@link value} may be a default that the datasource does not hold, and the new value
|
|
177
|
+
* would then replace the remote value. Returns for a value that is not managed.
|
|
178
|
+
*
|
|
179
|
+
* @throws any error {@link ValReference.assertWritable} throws for the reference behind {@link value}
|
|
180
|
+
*/
|
|
181
|
+
export function assertWritableValue(value: Val) {
|
|
182
|
+
Internal.referenceOf(value)?.assertWritable();
|
|
183
|
+
}
|
|
94
184
|
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2022-2026 Matter.js Authors
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import type { SchemaErrorPath } from "@matter/model";
|
|
8
|
+
import { WriteError } from "@matter/protocol";
|
|
9
|
+
import { Status } from "@matter/types";
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Thrown for a change in place of a mandatory list, struct or bitmap that the cluster state of a client node does not
|
|
13
|
+
* hold.
|
|
14
|
+
*
|
|
15
|
+
* The cluster state of a client node reads such a value as its default, so it reads like any other value. The default
|
|
16
|
+
* is not the device's value: the device's list may hold entries, its bitmap flags and its struct fields that the
|
|
17
|
+
* default does not have. Sending the default with a change would replace the device's value, so the change fails and
|
|
18
|
+
* nothing is stored or sent.
|
|
19
|
+
*
|
|
20
|
+
* Read the attribute from the device first, or assign a complete value. An assigned value replaces the value on the
|
|
21
|
+
* device, also when it was built from the default, such as `[...state.binding, entry]`. `Endpoint.set()` and
|
|
22
|
+
* `Endpoint.setStateOf()` assign each attribute value given for the cluster state of a client node whole, so they do
|
|
23
|
+
* not fail with this error.
|
|
24
|
+
*/
|
|
25
|
+
export class UncachedValueError extends WriteError {
|
|
26
|
+
constructor(path: SchemaErrorPath) {
|
|
27
|
+
super(
|
|
28
|
+
path,
|
|
29
|
+
"The value is not cached; read it from the device first, or assign a complete value, which replaces the value on the device",
|
|
30
|
+
Status.InvalidInState,
|
|
31
|
+
);
|
|
32
|
+
}
|
|
33
|
+
}
|