Enum GraphError 

#[non_exhaustive]
pub enum GraphError {
    NodeNotFound {
        id: NodeId,
    },
    EdgeNotFound {
        id: EdgeId,
    },
    NodeNotAlive {
        id: NodeId,
    },
    EdgeNotAlive {
        id: EdgeId,
    },
    RowSpaceExhausted {
        kind: &'static str,
        rows: u64,
        max_rows: u64,
    },
    Inconsistent {
        reason: String,
    },
    PropertyIndexAlreadyExists {
        label: DbString,
        property: DbString,
    },
    PropertyIndexNotFound {
        label: DbString,
        property: DbString,
    },
    IndexValueRejected {
        label: DbString,
        property: DbString,
        expected_kind: TypedIndexKind,
        observed: &'static str,
    },
    CompositePropertyIndexAlreadyExists {
        label: DbString,
        properties: Box<SmallVec<[DbString; 4]>>,
    },
    VectorIndexAlreadyExists {
        label: DbString,
        property: DbString,
    },
    VectorIndexInvalidDimension {
        dimension: u32,
    },
    VectorIndexInvalidHnswConfig {
        max_neighbors: u16,
        ef_construction: u16,
        reason: &'static str,
    },
    VectorIndexInvalidIvfConfig {
        target_centroids: u16,
        reason: &'static str,
    },
    VectorIndexValueRejected {
        label: DbString,
        property: DbString,
        expected_dimension: u32,
        observed: String,
    },
    TextIndexAlreadyExists {
        label: DbString,
        property: DbString,
    },
    TypeViolation(TypeViolation),
    StoreAssignment(Box<StoreAssignmentError>),
    Durable {
        reason: String,
    },
    Cancelled,
    Core(CoreError),
    Provider(ProviderError),
    Persist(PersistError),
}

Error type for graph storage and mutation operations.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NodeNotFound

The requested node row does not exist.

Fields

id: NodeId

Missing node ID.

EdgeNotFound

The requested edge row does not exist.

Fields

id: EdgeId

Missing edge ID.

NodeNotAlive

The requested node row exists but is not alive.

Fields

id: NodeId

Dead node ID.

EdgeNotAlive

The requested edge row exists but is not alive.

Fields

id: EdgeId

Dead edge ID.

RowSpaceExhausted

The dense row store filled the v1 row-addressable range (max 2^32 rows).

Post-4c the cap is a row count, not an id value: rows append at the dense end and u32::MAX is reserved as RowIndex::TOMBSTONE, so the last addressable row is u32::MAX - 1.

Fields

kind: &'static str

"node" or "edge".

rows: u64

The current row count that hit the cap.

max_rows: u64

The maximum addressable row count.

Inconsistent

The graph snapshot violates a structural invariant (e.g., row count exceeds the addressable u32 range).

Fields

reason: String

Free-form description of the inconsistency.

PropertyIndexAlreadyExists

A property index already exists for this (label, property).

Fields

label: DbString

Indexed node label.

property: DbString

Indexed property key.

PropertyIndexNotFound

The named property index does not exist.

Fields

label: DbString

Indexed node label.

property: DbString

Indexed property key.

IndexValueRejected

A value cannot be admitted to the declared property index kind.

Fields

label: DbString

Indexed node label.

property: DbString

Indexed property key.

expected_kind: TypedIndexKind

Registered index kind.

observed: &'static str

Observed value kind or "NaN".

CompositePropertyIndexAlreadyExists

A composite property index already exists for this (label, properties...).

Fields

label: DbString

Indexed node label.

properties: Box<SmallVec<[DbString; 4]>>

Indexed property keys in declaration order.

Boxed so this variant does not inflate GraphError past clippy’s result_large_err byte threshold: an inline SmallVec<[DbString; 4]> is ~104 B (four owned string values plus header), and the variant otherwise drives every GraphResult<T> stack slot over the limit. The Box pushes the allocation onto the cold error-construction path.

VectorIndexAlreadyExists

A vector property index already exists for this (label, property).

Fields

label: DbString

Indexed node label.

property: DbString

Indexed vector property key.

VectorIndexInvalidDimension

A vector index was declared with an invalid dimensionality.

Fields

dimension: u32

Declared vector dimensionality.

VectorIndexInvalidHnswConfig

A vector index was declared with invalid HNSW construction parameters.

Fields

max_neighbors: u16

Declared HNSW M fanout.

ef_construction: u16

Declared HNSW construction beam width.

reason: &'static str

Reason the configuration is rejected.

VectorIndexInvalidIvfConfig

A vector index was declared with invalid IVF construction parameters.

Fields

target_centroids: u16

Declared IVF target centroid count.

reason: &'static str

Reason the configuration is rejected.

VectorIndexValueRejected

A value cannot be admitted to a vector index.

Fields

label: DbString

Indexed node label.

property: DbString

Indexed vector property key.

expected_dimension: u32

Registered vector dimensionality.

observed: String

Observed value kind or dimensionality.

TextIndexAlreadyExists

A text index already exists for this (label, property).

Fields

label: DbString

Indexed node label.

property: DbString

Indexed string property key.

TypeViolation(TypeViolation)

A closed graph mutation violates its bound graph type.

StoreAssignment(Box<StoreAssignmentError>)

A store assignment failed before the graph mutation was applied.

Durable

A commit-critical durable provider rejected or failed a write.

Fields

reason: String

Human-readable durable provider failure reason.

Cancelled

The commit was cancelled at the pre-WAL cut-line (BRIEF-117): the committer observed the cancellation token set before it appended the commit to the WAL, so nothing was persisted or published. Past the WAL append a commit is irrevocable and this is never returned.

Core(CoreError)

Error propagated from selene-core.

Provider(ProviderError)

Error propagated from an index provider.

Persist(PersistError)

Error propagated from persistence recovery.

Implementations

impl GraphError

pub const fn gqlstatus(&self) -> &'static str

Map this error to its 5-character ISO GQLSTATUS code.

Trait Implementations

impl Debug for GraphError

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

Formats the value using the given formatter.

impl Diagnostic for GraphError

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn related(&self) -> Option<Box<dyn Iterator<Item = &dyn Diagnostic> + '_>>

Additional related Diagnostics.

fn url(&self) -> Option<Box<dyn Display + '_>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for GraphError

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

Formats the value using the given formatter.

impl Error for GraphError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<CoreError> for GraphError

fn from(source: CoreError) -> Self

Converts to this type from the input type.

impl From<GraphError> for JsonSearchError

fn from(source: GraphError) -> Self

Converts to this type from the input type.

impl From<GraphError> for TextSearchError

fn from(source: GraphError) -> Self

Converts to this type from the input type.

impl From<GraphError> for VectorSearchError

fn from(source: GraphError) -> Self

Converts to this type from the input type.

impl From<PersistError> for GraphError

fn from(source: PersistError) -> Self

Converts to this type from the input type.

impl From<ProviderError> for GraphError

fn from(source: ProviderError) -> Self

Converts to this type from the input type.

impl From<TypeViolation> for GraphError

fn from(source: TypeViolation) -> Self

Converts to this type from the input type.