Enum JsonDecodeErrorSource 

pub enum JsonDecodeErrorSource<R, Q = usize>
where
    Q: Copy + Debug,
{
    Budget {
        stage: JsonDecodeStage,
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        source: MeasuredBudgetError<R, Q>,
    },
    EmptyInput {
        stage: JsonDecodeStage,
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
    },
    InvalidUtf8 {
        raw_input_bytes: usize,
        valid_up_to: usize,
        error_len: Option<usize>,
        source: Option<Utf8Error>,
    },
    InvalidJson {
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        syntax: JsonSyntaxError,
        source: Option<Arc<dyn Error + Send + Sync>>,
    },
    UnexpectedTopLevel {
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        expected: JsonRootKind,
        actual: JsonRootKind,
    },
    Deserialize {
        raw_input_bytes: usize,
        normalized_input_bytes: Option<usize>,
        line: usize,
        column: usize,
        source: Option<Arc<dyn Error + Send + Sync>>,
    },
}

An owned semantic source extracted from a JSON decoding failure.

This enum preserves the complete structured state of exactly one failure. It lets downstream adapters move error data into their own models with one exhaustive match, without pairing super::JsonDecodeError::kind with fallible source accessors. Parser and Serde sources remain present only when decoding used super::DiagnosticPolicy::Detailed.

Type Parameters

• R - Resource identity attached to budget failures.
• Q - Quantity representation attached to budget failures.

Examples

use qubit_json::decode::{JsonDecodeErrorSource, JsonDecoder};

let mut decoder = JsonDecoder::unlimited();
let error = decoder.validate_str("{").expect_err("invalid JSON must fail");
match error.into_source() {
    JsonDecodeErrorSource::InvalidJson { syntax, .. } => {
        assert_eq!(syntax.offset(), 1);
    }
    source => panic!("unexpected decoding source: {source:?}"),
}

Variants

Budget

A resource measurement was rejected.

Fields

stage: JsonDecodeStage

Semantic stage where the measurement was rejected.

raw_input_bytes: usize

Original input length.

normalized_input_bytes: Option<usize>

Normalized length when normalization completed.

source: MeasuredBudgetError<R, Q>

Complete measured-budget failure.

EmptyInput

Input was empty at a public boundary.

Fields

stage: JsonDecodeStage

Semantic stage where emptiness was detected.

raw_input_bytes: usize

Original input length.

normalized_input_bytes: Option<usize>

Normalized length when available.

InvalidUtf8

Raw bytes were not valid UTF-8.

Fields

raw_input_bytes: usize

Original input length.

valid_up_to: usize

Valid prefix length reported by UTF-8 validation.

error_len: Option<usize>

Invalid sequence length when known.

source: Option<Utf8Error>

Detailed source retained only under detailed diagnostics.

InvalidJson

Text was not one valid JSON document.

Fields

raw_input_bytes: usize

Original input length.

normalized_input_bytes: Option<usize>

Normalized length when normalization completed.

syntax: JsonSyntaxError

Stable scanner reason and source coordinates.

source: Option<Arc<dyn Error + Send + Sync>>

Detailed parser source retained only under detailed diagnostics.

UnexpectedTopLevel

A valid document had an unexpected top-level kind.

Fields

raw_input_bytes: usize

Original input length.

normalized_input_bytes: Option<usize>

Normalized length when normalization completed.

expected: JsonRootKind

Required top-level kind.

actual: JsonRootKind

Observed top-level kind.

Deserialize

A valid admitted document could not materialize the target type.

Fields

raw_input_bytes: usize

Original input length.

normalized_input_bytes: Option<usize>

Normalized length when normalization completed.

line: usize

One-based Serde line, or zero when unavailable.

column: usize

One-based Serde column, or zero when unavailable.

source: Option<Arc<dyn Error + Send + Sync>>

Detailed source retained only under detailed diagnostics.

Trait Implementations

impl<R: Clone, Q> Clone for JsonDecodeErrorSource<R, Q>

where Q: Copy + Debug + Clone,

fn clone(&self) -> JsonDecodeErrorSource<R, Q>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R: Debug, Q> Debug for JsonDecodeErrorSource<R, Q>

where Q: Copy + Debug + Debug,

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

Formats the value using the given formatter.