Deserialize bytes to a ViewState Backward-compatible: if the v2 fields (`kind`, `parent`) are missing (i.e., the data was written by an older version), defaults to `ViewScope::Shared` and `parent: None`.
(bytes: &[u8])
| 137 | /// (i.e., the data was written by an older version), defaults to |
| 138 | /// `ViewScope::Shared` and `parent: None`. |
| 139 | pub fn deserialize_view_state(bytes: &[u8]) -> PristineResult<ViewState> { |
| 140 | const MIN_SIZE: usize = 8 + 4; // id + name_len |
| 141 | |
| 142 | if bytes.len() < MIN_SIZE { |
| 143 | return Err(PristineError::Serialization { |
| 144 | message: "view state too short".to_string(), |
| 145 | }); |
| 146 | } |
| 147 | |
| 148 | let id = u64::from_le_bytes(bytes[0..8].try_into().unwrap()); |
| 149 | let name_len = u32::from_le_bytes(bytes[8..12].try_into().unwrap()) as usize; |
| 150 | |
| 151 | // v1 size: header(12) + name + merkle(32) + change_count(8) |
| 152 | let v1_size = 12 + name_len + 32 + 8; |
| 153 | if bytes.len() < v1_size { |
| 154 | return Err(PristineError::Serialization { |
| 155 | message: "view state truncated".to_string(), |
| 156 | }); |
| 157 | } |
| 158 | |
| 159 | let name = String::from_utf8(bytes[12..12 + name_len].to_vec()).map_err(|_| { |
| 160 | PristineError::Serialization { |
| 161 | message: "invalid view name encoding".to_string(), |
| 162 | } |
| 163 | })?; |
| 164 | |
| 165 | let mut merkle_bytes = [0u8; 32]; |
| 166 | merkle_bytes.copy_from_slice(&bytes[12 + name_len..12 + name_len + 32]); |
| 167 | let state = Merkle::from_bytes(merkle_bytes); |
| 168 | |
| 169 | let change_count = u64::from_le_bytes( |
| 170 | bytes[12 + name_len + 32..12 + name_len + 40] |
| 171 | .try_into() |
| 172 | .unwrap(), |
| 173 | ); |
| 174 | |
| 175 | // v2 fields: kind(1) + parent(8) = 9 additional bytes |
| 176 | let v2_size = v1_size + 1 + 8; |
| 177 | let (kind, parent) = if bytes.len() >= v2_size { |
| 178 | let kind_byte = bytes[v1_size]; |
| 179 | let kind = ViewScope::from_u8(kind_byte).ok_or_else(|| PristineError::Serialization { |
| 180 | message: format!("invalid view kind: {}", kind_byte), |
| 181 | })?; |
| 182 | |
| 183 | let parent_val = u64::from_le_bytes(bytes[v1_size + 1..v1_size + 9].try_into().unwrap()); |
| 184 | let parent = if parent_val == NO_PARENT { |
| 185 | None |
| 186 | } else { |
| 187 | Some(parent_val) |
| 188 | }; |
| 189 | |
| 190 | (kind, parent) |
| 191 | } else { |
| 192 | // v1 data — default to Shared with no parent |
| 193 | (ViewScope::Shared, None) |
| 194 | }; |
| 195 | |
| 196 | Ok(ViewState { |