Struct ExtensionDescriptorRegistry 

pub struct ExtensionDescriptorRegistry { /* private fields */ }

Acyclic protocol-only descriptor registry.

Implementations

impl ExtensionDescriptorRegistry

pub fn new() -> Self

Builds an empty registry; extensions are disabled until a descriptor is registered.

pub fn register( &mut self, descriptor: ExtensionDescriptor, ) -> Result<(), ExtensionRegistryError>

Adds one descriptor after validating all descriptor-local and cross-owner rules.

pub fn register_method( &mut self, id: &ExtensionId, method: ExtensionMethodDescriptor, ) -> Result<(), ExtensionRegistryError>

Adds another request method to an already registered extension descriptor.

One extension can own more than one request method. The extension’s settings, resolver, notification, and result discriminator stay on the original descriptor so every additional method shares the same negotiated capability and frozen receipt.

pub fn freeze( &mut self, ) -> Result<ExtensionRegistryReceipt, ExtensionRegistryError>

Freezes this registry and returns its canonical domain-separated digest receipt.

pub fn receipt(&self) -> Option<&ExtensionRegistryReceipt>

Returns the frozen receipt, if this registry has been frozen.

pub fn descriptor(&self, id: &ExtensionId) -> Option<&ExtensionDescriptor>

Returns a descriptor by its exact registered identifier.

pub fn method_descriptor( &self, id: &ExtensionId, name: &str, ) -> Option<&ExtensionMethodDescriptor>

Returns the descriptor for one extension-owned request method.

This includes the primary descriptor method and every additional method registered for the same extension capability. Server handler registries use it to reject handler configurations that could never be admitted at request dispatch.

pub fn descriptors(&self) -> impl ExactSizeIterator<Item = &ExtensionDescriptor>

Returns the frozen descriptors in deterministic identifier order.

pub fn preserve_unknown_peer_extensions( &self, peer: BTreeMap<ExtensionId, ExtensionSettings>, ) -> BTreeMap<ExtensionId, ExtensionSettings>

Preserves unknown peer settings as inert diagnostic data.

pub fn negotiate<R>( &self, protocol_era: ProtocolEra, local: &ExtensionLocalEnablement, client: &ClientExtensionDiscovery, server: &ServerExtensionDiscovery, resolver: &mut R, ) -> Result<NegotiatedExtensionSet, ExtensionNegotiationError>

where R: ExtensionSettingsCompatibilityResolver,

Derives one frozen, bilateral extension set for the current exchange.

The typed resolver is called only for descriptors enabled by both local gates and advertised by both peers on this exchange. The generic registry preserves the peer objects independently; it never treats JSON-object equality as compatibility.

Trait Implementations

impl Clone for ExtensionDescriptorRegistry

fn clone(&self) -> ExtensionDescriptorRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExtensionDescriptorRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ExtensionDescriptorRegistry

fn default() -> ExtensionDescriptorRegistry

Returns the “default value” for a type.