Enum BundleError 

#[non_exhaustive]
pub enum BundleError {
    Zstd(String),
    Tar(String),
    Manifest(String),
    UnsupportedVersion {
        found: u32,
        max: u32,
    },
    Events(String),
    HashMismatch {
        expected: String,
        actual: String,
    },
    MissingBlob(String),
    IntegrityMismatch,
}

Portable session bundle (hh-core::bundle) build/parse error. Every variant here is reachable from untrusted input (hh import file.hh) and must carry enough detail to act on — “corrupt bundle” alone is not actionable (v1.0.0 addendum: parsers over untrusted input must never panic and must report precisely what failed).

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.

Zstd(String)

The bundle’s zstd stream could not be decompressed.

Tar(String)

The decompressed bundle is not a valid tar archive, or contains an entry outside the allow-list (unexpected path, symlink, hardlink, absolute path, or .. component).

Manifest(String)

manifest.json is missing, unreadable, or not valid JSON.

UnsupportedVersion

The bundle’s format_version is newer than this build of hh understands.

Fields

found: u32

The bundle’s declared format version.

max: u32

The highest format version this build supports.

Events(String)

events.ndjson is missing or one of its lines is not valid JSON.

HashMismatch

A blob’s actual content hash did not match its expected hash (from its tar path or from an event/file_change reference).

Fields

expected: String

Expected BLAKE3 hex.

actual: String

Actual BLAKE3 hex.

MissingBlob(String)

An event or file_change references a blob hash that the bundle does not carry.

IntegrityMismatch

The bundle’s events.ndjson digest did not match manifest.integrity.

Trait Implementations

impl Debug for BundleError

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

Formats the value using the given formatter.

impl Display for BundleError

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

Formats the value using the given formatter.

impl Error for BundleError

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<BundleError> for Error

fn from(source: BundleError) -> Self

Converts to this type from the input type.