Struct ObjectIntegrityChecker 

pub struct ObjectIntegrityChecker { /* private fields */ }

Production-grade multi-level object integrity checker.

Thread-safety is the caller’s responsibility; wrap in Arc<Mutex<…>> if shared across threads.

Implementations

impl ObjectIntegrityChecker

pub fn new(config: CheckerConfig) -> Self

Create a new checker with the provided configuration.

pub fn with_defaults() -> Self

Create a new checker with default configuration.

pub fn register( &mut self, id: String, data: &[u8], ) -> Result<IntegrityHash, CheckerError>

Register a new object and compute its canonical hashes.

Returns the IntegrityHash on success. Returns CheckerError::MaxObjectsExceeded if the configured cap is reached. Re-registering an existing id overwrites the stored record.

pub fn verify( &mut self, id: &str, data: &[u8], level: IntegrityLevel, ) -> Result<OicVerificationResult, CheckerError>

Verify data against the stored hashes for id at the given level.

Updates the object’s status, last_verified_at, and verification_count. Returns a detailed OicVerificationResult.

pub fn verify_all( &mut self, objects: &[(&str, &[u8])], level: IntegrityLevel, ) -> Vec<OicVerificationResult>

Batch-verify multiple (id, data) pairs at the given level.

Objects that are not found are reported as failed verifications with an error message rather than causing a panic or early abort.

pub fn mark_corrupted( &mut self, id: &str, reason: String, ) -> Result<(), CheckerError>

Mark an object as PossiblyCorrupted with a caller-supplied reason.

pub fn update( &mut self, id: &str, new_data: &[u8], ) -> Result<IntegrityHash, CheckerError>

Replace the stored canonical hashes with freshly computed values from new_data and reset the verification counter.

pub fn remove(&mut self, id: &str) -> Result<(), CheckerError>

Deregister an object, freeing its stored record.

pub fn corrupted_objects(&self) -> Vec<&OicObjectRecord>

Return references to all objects currently in a Corrupted state.

pub fn objects_needing_verification( &self, since_us: u64, ) -> Vec<&OicObjectRecord>

Return references to objects whose last_verified_at is older than since_us (i.e. last_verified_at < since_us), including those that have never been verified (last_verified_at == 0).

pub fn repair_hash( &mut self, id: &str, correct_data: &[u8], ) -> Result<(), CheckerError>

Recompute hashes from correct_data and clear any corruption status.

This is the “repair” path: after retrieving a known-good copy of an object, call this to reset the canonical digest and mark the object as verified.

pub fn stats(&self) -> CheckerStats

Snapshot current aggregate statistics.

pub fn config(&self) -> &CheckerConfig

Access the underlying configuration.

pub fn len(&self) -> usize

Number of currently registered objects.

pub fn is_empty(&self) -> bool

Returns true when no objects are registered.