roxify 1.11.0 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,338 @@
1
+ use std::io::Read;
2
+ use std::path::Path;
3
+ use cipher::{KeyIvInit, StreamCipher};
4
+
5
+ const PIXEL_MAGIC: &[u8] = b"PXL1";
6
+ const MARKER_BYTES: usize = 12;
7
+
8
+ type Aes256Ctr = ctr::Ctr64BE<aes::Aes256>;
9
+
10
+ pub fn streaming_decode_to_dir(png_path: &Path, out_dir: &Path) -> Result<Vec<String>, String> {
11
+ streaming_decode_to_dir_encrypted(png_path, out_dir, None)
12
+ }
13
+
14
+ pub fn streaming_decode_to_dir_encrypted(
15
+ png_path: &Path,
16
+ out_dir: &Path,
17
+ passphrase: Option<&str>,
18
+ ) -> Result<Vec<String>, String> {
19
+ let file = std::fs::File::open(png_path).map_err(|e| format!("open: {}", e))?;
20
+ let mmap = unsafe { memmap2::Mmap::map(&file).map_err(|e| format!("mmap: {}", e))? };
21
+ let data = &mmap[..];
22
+
23
+ if data.len() < 8 || &data[0..8] != &[137, 80, 78, 71, 13, 10, 26, 10] {
24
+ return Err("Not a PNG file".into());
25
+ }
26
+
27
+ let (width, height, idat_data_start, idat_data_end) = parse_png_header(data)?;
28
+
29
+ let mut reader = DeflatePixelReader::new(data, width, height, idat_data_start, idat_data_end);
30
+
31
+ let mut marker_buf = [0u8; MARKER_BYTES];
32
+ reader.read_exact(&mut marker_buf).map_err(|e| format!("read markers: {}", e))?;
33
+
34
+ let mut pxl1 = [0u8; 4];
35
+ reader.read_exact(&mut pxl1).map_err(|e| format!("read PXL1: {}", e))?;
36
+ if &pxl1 != PIXEL_MAGIC {
37
+ return Err(format!("Expected PXL1, got {:?}", pxl1));
38
+ }
39
+
40
+ let mut hdr = [0u8; 2];
41
+ reader.read_exact(&mut hdr).map_err(|e| format!("read hdr: {}", e))?;
42
+ let _version = hdr[0];
43
+ let name_len = hdr[1] as usize;
44
+
45
+ if name_len > 0 {
46
+ let mut name_buf = vec![0u8; name_len];
47
+ reader.read_exact(&mut name_buf).map_err(|e| format!("read name: {}", e))?;
48
+ }
49
+
50
+ let mut plen_buf = [0u8; 4];
51
+ reader.read_exact(&mut plen_buf).map_err(|e| format!("read payload_len: {}", e))?;
52
+ let payload_len = u32::from_be_bytes(plen_buf) as u64;
53
+
54
+ let payload_reader = reader.take(payload_len);
55
+
56
+ let first_byte_reader = FirstByteReader::new(payload_reader);
57
+ let (enc_byte, remaining_reader) = first_byte_reader.into_parts()?;
58
+
59
+ match enc_byte {
60
+ 0x00 => {
61
+ let mut decoder = zstd::stream::Decoder::new(remaining_reader)
62
+ .map_err(|e| format!("zstd decoder: {}", e))?;
63
+ decoder.window_log_max(31).map_err(|e| format!("zstd window_log_max: {}", e))?;
64
+ read_rox1_and_untar(decoder, out_dir)
65
+ }
66
+ 0x03 => {
67
+ let pass = passphrase.ok_or("Passphrase required for AES-CTR decryption")?;
68
+ let mut salt = [0u8; 16];
69
+ let mut iv = [0u8; 16];
70
+ let mut r = remaining_reader;
71
+ r.read_exact(&mut salt).map_err(|e| format!("read salt: {}", e))?;
72
+ r.read_exact(&mut iv).map_err(|e| format!("read iv: {}", e))?;
73
+
74
+ let key = crate::crypto::derive_aes_ctr_key(pass, &salt);
75
+ let cipher = Aes256Ctr::new_from_slices(&key, &iv)
76
+ .map_err(|e| format!("AES-CTR init: {}", e))?;
77
+
78
+ let hmac_size = 32u64;
79
+ let encrypted_data_len = payload_len - 1 - 16 - 16 - hmac_size;
80
+ let ctr_reader = CtrDecryptReader::new(r.take(encrypted_data_len), cipher);
81
+
82
+ let mut decoder = zstd::stream::Decoder::new(ctr_reader)
83
+ .map_err(|e| format!("zstd decoder: {}", e))?;
84
+ decoder.window_log_max(31).map_err(|e| format!("zstd window_log_max: {}", e))?;
85
+ read_rox1_and_untar(decoder, out_dir)
86
+ }
87
+ _ => Err(format!("Unsupported encryption (enc=0x{:02x}) in streaming decode", enc_byte)),
88
+ }
89
+ }
90
+
91
+ fn read_rox1_and_untar<R: Read>(mut decoder: R, out_dir: &Path) -> Result<Vec<String>, String> {
92
+ let mut magic = [0u8; 4];
93
+ decoder.read_exact(&mut magic).map_err(|e| format!("read ROX1: {}", e))?;
94
+ if &magic != b"ROX1" {
95
+ return Err(format!("Expected ROX1, got {:?}", magic));
96
+ }
97
+ std::fs::create_dir_all(out_dir).map_err(|e| format!("mkdir: {}", e))?;
98
+ tar_unpack_from_reader(decoder, out_dir)
99
+ }
100
+
101
+ fn parse_png_header(data: &[u8]) -> Result<(usize, usize, usize, usize), String> {
102
+ let mut pos = 8;
103
+
104
+ let mut width = 0usize;
105
+ let mut height = 0usize;
106
+ let mut idat_start = 0usize;
107
+ let mut idat_end = 0usize;
108
+
109
+ while pos + 12 <= data.len() {
110
+ let chunk_len = u32::from_be_bytes([data[pos], data[pos + 1], data[pos + 2], data[pos + 3]]) as usize;
111
+ let chunk_type = &data[pos + 4..pos + 8];
112
+ let chunk_data_start = pos + 8;
113
+
114
+ if chunk_type == b"IHDR" {
115
+ if chunk_len < 13 {
116
+ return Err("Invalid IHDR".into());
117
+ }
118
+ width = u32::from_be_bytes([
119
+ data[chunk_data_start],
120
+ data[chunk_data_start + 1],
121
+ data[chunk_data_start + 2],
122
+ data[chunk_data_start + 3],
123
+ ]) as usize;
124
+ height = u32::from_be_bytes([
125
+ data[chunk_data_start + 4],
126
+ data[chunk_data_start + 5],
127
+ data[chunk_data_start + 6],
128
+ data[chunk_data_start + 7],
129
+ ]) as usize;
130
+ } else if chunk_type == b"IDAT" {
131
+ idat_start = chunk_data_start;
132
+ idat_end = chunk_data_start + chunk_len;
133
+ } else if chunk_type == b"IEND" {
134
+ break;
135
+ }
136
+
137
+ pos = chunk_data_start + chunk_len + 4;
138
+ }
139
+
140
+ if width == 0 || height == 0 {
141
+ return Err("IHDR not found".into());
142
+ }
143
+ if idat_start == 0 {
144
+ return Err("IDAT not found".into());
145
+ }
146
+
147
+ Ok((width, height, idat_start, idat_end))
148
+ }
149
+
150
+ struct DeflatePixelReader<'a> {
151
+ data: &'a [u8],
152
+ height: usize,
153
+ offset: usize,
154
+ idat_end: usize,
155
+ block_remaining: usize,
156
+ current_row: usize,
157
+ col_in_row: usize,
158
+ scanline_filter_pending: bool,
159
+ row_bytes: usize,
160
+ }
161
+
162
+ impl<'a> DeflatePixelReader<'a> {
163
+ fn new(data: &'a [u8], width: usize, height: usize, idat_data_start: usize, idat_data_end: usize) -> Self {
164
+ let row_bytes = width * 3;
165
+ Self {
166
+ data,
167
+ height,
168
+ offset: idat_data_start + 2,
169
+ idat_end: idat_data_end,
170
+ block_remaining: 0,
171
+ current_row: 0,
172
+ col_in_row: 0,
173
+ scanline_filter_pending: true,
174
+ row_bytes,
175
+ }
176
+ }
177
+
178
+ fn ensure_block(&mut self) -> Result<(), std::io::Error> {
179
+ if self.block_remaining > 0 {
180
+ return Ok(());
181
+ }
182
+
183
+ if self.offset + 5 > self.idat_end {
184
+ return Err(std::io::Error::new(std::io::ErrorKind::UnexpectedEof, "No more deflate blocks"));
185
+ }
186
+
187
+ let len_lo = self.data[self.offset + 1] as usize;
188
+ let len_hi = self.data[self.offset + 2] as usize;
189
+ self.offset += 5;
190
+
191
+ self.block_remaining = len_lo | (len_hi << 8);
192
+ Ok(())
193
+ }
194
+
195
+ fn copy_raw_bytes(&mut self, buf: &mut [u8], count: usize) -> Result<usize, std::io::Error> {
196
+ let mut written = 0;
197
+ while written < count {
198
+ self.ensure_block()?;
199
+ let avail = self.block_remaining.min(count - written).min(self.idat_end - self.offset);
200
+ if avail == 0 {
201
+ break;
202
+ }
203
+ buf[written..written + avail].copy_from_slice(&self.data[self.offset..self.offset + avail]);
204
+ self.offset += avail;
205
+ self.block_remaining -= avail;
206
+ written += avail;
207
+ }
208
+ Ok(written)
209
+ }
210
+
211
+ fn skip_raw_bytes(&mut self, count: usize) -> Result<(), std::io::Error> {
212
+ let mut remaining = count;
213
+ while remaining > 0 {
214
+ self.ensure_block()?;
215
+ let skip = self.block_remaining.min(remaining).min(self.idat_end - self.offset);
216
+ if skip == 0 {
217
+ break;
218
+ }
219
+ self.offset += skip;
220
+ self.block_remaining -= skip;
221
+ remaining -= skip;
222
+ }
223
+ Ok(())
224
+ }
225
+ }
226
+
227
+ impl<'a> Read for DeflatePixelReader<'a> {
228
+ fn read(&mut self, buf: &mut [u8]) -> std::io::Result<usize> {
229
+ let mut filled = 0;
230
+
231
+ while filled < buf.len() {
232
+ if self.current_row >= self.height {
233
+ break;
234
+ }
235
+
236
+ if self.scanline_filter_pending {
237
+ self.skip_raw_bytes(1)?;
238
+ self.scanline_filter_pending = false;
239
+ self.col_in_row = 0;
240
+ }
241
+
242
+ if self.col_in_row >= self.row_bytes {
243
+ self.current_row += 1;
244
+ self.scanline_filter_pending = true;
245
+ continue;
246
+ }
247
+
248
+ let remaining_in_row = self.row_bytes - self.col_in_row;
249
+ let remaining_in_buf = buf.len() - filled;
250
+ let to_read = remaining_in_row.min(remaining_in_buf);
251
+
252
+ let got = self.copy_raw_bytes(&mut buf[filled..filled + to_read], to_read)?;
253
+ filled += got;
254
+ self.col_in_row += got;
255
+ if got == 0 {
256
+ break;
257
+ }
258
+ }
259
+
260
+ Ok(filled)
261
+ }
262
+ }
263
+
264
+ struct FirstByteReader<R: Read> {
265
+ inner: R,
266
+ }
267
+
268
+ impl<R: Read> FirstByteReader<R> {
269
+ fn new(inner: R) -> Self {
270
+ Self { inner }
271
+ }
272
+
273
+ fn into_parts(mut self) -> Result<(u8, impl Read), String> {
274
+ let mut byte = [0u8; 1];
275
+ self.inner.read_exact(&mut byte).map_err(|e| format!("read first byte: {}", e))?;
276
+ Ok((byte[0], self.inner))
277
+ }
278
+ }
279
+
280
+ struct CtrDecryptReader<R: Read> {
281
+ inner: R,
282
+ cipher: Aes256Ctr,
283
+ }
284
+
285
+ impl<R: Read> CtrDecryptReader<R> {
286
+ fn new(inner: R, cipher: Aes256Ctr) -> Self {
287
+ Self { inner, cipher }
288
+ }
289
+ }
290
+
291
+ impl<R: Read> Read for CtrDecryptReader<R> {
292
+ fn read(&mut self, buf: &mut [u8]) -> std::io::Result<usize> {
293
+ let n = self.inner.read(buf)?;
294
+ if n > 0 {
295
+ self.cipher.apply_keystream(&mut buf[..n]);
296
+ }
297
+ Ok(n)
298
+ }
299
+ }
300
+
301
+ fn tar_unpack_from_reader<R: Read>(reader: R, output_dir: &Path) -> Result<Vec<String>, String> {
302
+ let buf_reader = std::io::BufReader::with_capacity(8 * 1024 * 1024, reader);
303
+ let mut archive = tar::Archive::new(buf_reader);
304
+ let mut written = Vec::new();
305
+ let mut created_dirs = std::collections::HashSet::new();
306
+
307
+ let entries = archive.entries().map_err(|e| format!("tar entries: {}", e))?;
308
+ for entry in entries {
309
+ let mut entry = entry.map_err(|e| format!("tar entry: {}", e))?;
310
+ let path = entry.path().map_err(|e| format!("tar path: {}", e))?.to_path_buf();
311
+
312
+ let mut safe = std::path::PathBuf::new();
313
+ for comp in path.components() {
314
+ if let std::path::Component::Normal(osstr) = comp {
315
+ safe.push(osstr);
316
+ }
317
+ }
318
+ if safe.as_os_str().is_empty() {
319
+ continue;
320
+ }
321
+
322
+ let dest = output_dir.join(&safe);
323
+ if let Some(parent) = dest.parent() {
324
+ if created_dirs.insert(parent.to_path_buf()) {
325
+ std::fs::create_dir_all(parent).map_err(|e| format!("mkdir {:?}: {}", parent, e))?;
326
+ }
327
+ }
328
+
329
+ let mut f = std::io::BufWriter::with_capacity(
330
+ (entry.size() as usize).min(4 * 1024 * 1024).max(8192),
331
+ std::fs::File::create(&dest).map_err(|e| format!("create {:?}: {}", dest, e))?,
332
+ );
333
+ std::io::copy(&mut entry, &mut f).map_err(|e| format!("write {:?}: {}", dest, e))?;
334
+ written.push(safe.to_string_lossy().to_string());
335
+ }
336
+
337
+ Ok(written)
338
+ }