Trait KeyedUniqueSurface 

pub trait KeyedUniqueSurface: 'static {
    type Key: Clone + Eq + Hash + Debug + Send + Sync + 'static;
    type Provider: ?Sized + Send + Sync + 'static;

    const KIND: SurfaceKind;

    // Provided methods
    fn duplicate_error(key: &Self::Key) -> PluginError { ... }
    fn key_of(_provider: &Self::Provider) -> Option<Self::Key> { ... }
}

Keyed-unique family: DashMap<K, Arc<dyn Provider>>.

Distinct from named-unique because the key is not a QName — it may be a SmolStr scheme/name, an IndexKind, a CrdtKind, etc. The provider trait often exposes the key (e.g. crate::traits::collation::CollationProvider::name).

Members: IndexKind, StorageBackend, LabelStorage, Crdt, LogicalType, Collation, Cdc, Catalog.

Required Associated Constants

const KIND: SurfaceKind

Surface discriminant.

Required Associated Types

type Key: Clone + Eq + Hash + Debug + Send + Sync + 'static

The key type the DashMap is keyed by.

type Provider: ?Sized + Send + Sync + 'static

The trait-object provider.

Provided Methods

fn duplicate_error(key: &Self::Key) -> PluginError

Preflight: refuse a duplicate key.

Default implementation returns a generic PluginError::Internal message; surfaces that need a typed error (e.g. StorageBackend returns PluginError::StorageSchemeConflict) override this.

Errors

Returns a PluginError when the key is already taken.

fn key_of(_provider: &Self::Provider) -> Option<Self::Key>

Derive the registry key from the provider, when the provider trait self-identifies.

Returns Some(key) for surfaces whose provider exposes its key directly (e.g. crate::traits::index::IndexKindProvider::kind, crate::traits::collation::CollationProvider::name). Returns None for surfaces where the key must be supplied externally (today only LabelStorageSurface — the label name is not a property of the crate::traits::storage::Storage trait).

Foundation tasks (§1.1 Phase 4 prerequisites) use this to drive registration without an outer (key, provider) tuple wherever the provider already self-identifies.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl KeyedUniqueSurface for CatalogSurface

const KIND: SurfaceKind = SurfaceKind::Catalog

type Key = SmolStr

type Provider = dyn CatalogProvider

impl KeyedUniqueSurface for CdcSurface

const KIND: SurfaceKind = SurfaceKind::Cdc

type Key = SmolStr

type Provider = dyn CdcOutputProvider

impl KeyedUniqueSurface for CollationSurface

const KIND: SurfaceKind = SurfaceKind::Collation

type Key = SmolStr

type Provider = dyn CollationProvider

impl KeyedUniqueSurface for CrdtSurface

const KIND: SurfaceKind = SurfaceKind::Crdt

type Key = CrdtKind

type Provider = dyn CrdtKindProvider

impl KeyedUniqueSurface for IndexKindSurface

const KIND: SurfaceKind = SurfaceKind::IndexKind

type Key = IndexKind

type Provider = dyn IndexKindProvider

impl KeyedUniqueSurface for LabelStorageSurface

const KIND: SurfaceKind = SurfaceKind::LabelStorage

type Key = SmolStr

type Provider = dyn Storage

impl KeyedUniqueSurface for LogicalTypeSurface

const KIND: SurfaceKind = SurfaceKind::LogicalType

type Key = SmolStr

type Provider = dyn LogicalTypeProvider

impl KeyedUniqueSurface for StorageBackendSurface

const KIND: SurfaceKind = SurfaceKind::StorageBackend

type Key = SmolStr

type Provider = dyn StorageBackend