Enum ErrorCode 

pub enum ErrorCode {
    QuerySyntax,
    QuerySemantic,
    QueryTimeout,
    QueryUnsupported,
    QueryOptimization,
    QueryExecution,
    TransactionConflict,
    TransactionTimeout,
    TransactionReadOnly,
    TransactionInvalidState,
    TransactionSerialization,
    TransactionDeadlock,
    StorageFull,
    StorageCorrupted,
    StorageRecoveryFailed,
    InvalidInput,
    NodeNotFound,
    EdgeNotFound,
    PropertyNotFound,
    LabelNotFound,
    TypeMismatch,
    Internal,
    SerializationError,
    IoError,
}

Machine-readable error code for programmatic error handling.

Error codes follow the pattern GRAFEO-{category}{number}:

• Q: Query errors (parse, semantic, timeout)
• T: Transaction errors (conflict, timeout, state)
• S: Storage errors (full, corruption)
• V: Validation errors (not found, type mismatch, invalid input)
• X: Internal errors (should not happen)

Clients can match on these codes without parsing error messages.

Examples

use grafeo_common::utils::error::{Error, ErrorCode};

let err = Error::Internal("something broke".into());
assert_eq!(err.error_code().as_str(), "GRAFEO-X001");
assert!(!err.error_code().is_retryable());

Variants

QuerySyntax

Query failed to parse.

QuerySemantic

Query parsed but is invalid (unknown label, type mismatch, etc.).

QueryTimeout

Query exceeded timeout.

QueryUnsupported

Feature not supported for this query language.

QueryOptimization

Query optimization failed.

QueryExecution

Query execution failed.

TransactionConflict

Write-write conflict (retry possible).

TransactionTimeout

Transaction exceeded TTL.

TransactionReadOnly

Transaction is read-only but attempted a write.

TransactionInvalidState

Invalid transaction state.

TransactionSerialization

Serialization failure (SSI violation).

TransactionDeadlock

Deadlock detected.

StorageFull

Memory or disk limit reached.

StorageCorrupted

WAL or data corruption detected.

StorageRecoveryFailed

Recovery from WAL failed.

InvalidInput

Request validation failed.

NodeNotFound

Node not found.

EdgeNotFound

Edge not found.

PropertyNotFound

Property key not found.

LabelNotFound

Label not found.

TypeMismatch

Type mismatch.

Internal

Unexpected internal error.

SerializationError

Serialization/deserialization error.

IoError

I/O error.

Implementations

impl ErrorCode

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

Returns the string code (e.g. "GRAFEO-Q001").

pub const fn is_retryable(&self) -> bool

Whether this error is retryable (client should retry the operation).

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl Display for ErrorCode

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

Formats the value using the given formatter.

impl Hash for ErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorCode

fn eq(&self, other: &ErrorCode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ErrorCode

impl Eq for ErrorCode

impl StructuralPartialEq for ErrorCode