Skip to main content

qualia_core_db/sensing/acquisition/
source.rs

1use super::Error;
2/// Immutable original snapshot. Hashing is admitted before reading bytes.
3#[derive(Clone, Copy, Debug, PartialEq, Eq)]
4pub struct Original<'a> {
5    bytes: &'a [u8],
6    digest: [u8; 32],
7}
8impl<'a> Original<'a> {
9    pub fn admit(bytes: &'a [u8], max_bytes: usize) -> Result<Self, Error> {
10        if bytes.len() > max_bytes {
11            return Err(Error::Budget);
12        }
13        Ok(Self {
14            bytes,
15            digest: *blake3::hash(bytes).as_bytes(),
16        })
17    }
18    pub fn bytes(self) -> &'a [u8] {
19        self.bytes
20    }
21    pub fn digest(self) -> [u8; 32] {
22        self.digest
23    }
24    pub fn region(self, offset: usize, length: usize) -> Result<Region<'a>, Error> {
25        let end = offset.checked_add(length).ok_or(Error::Overflow)?;
26        let bytes = self.bytes.get(offset..end).ok_or(Error::Bounds)?;
27        Ok(Region {
28            original: self,
29            offset,
30            bytes,
31        })
32    }
33}
34/// Selected byte range always retains its complete original, including other metadata.
35#[derive(Clone, Copy, Debug)]
36pub struct Region<'a> {
37    original: Original<'a>,
38    offset: usize,
39    bytes: &'a [u8],
40}
41impl<'a> Region<'a> {
42    pub fn bytes(self) -> &'a [u8] {
43        self.bytes
44    }
45    pub fn original(self) -> Original<'a> {
46        self.original
47    }
48    pub fn offset(self) -> usize {
49        self.offset
50    }
51}