feat(io): add user-approved recovery

This commit is contained in:
Hakan Seven 2026-08-03 12:47:48 +03:00
commit 9e90e50662
25 changed files with 2723 additions and 198 deletions

View file

@ -13,4 +13,5 @@ bincode = "1.3"
console_error_panic_hook = "0.1"
getrandom = { version = "0.3", features = ["wasm_js"] }
js-sys = "0.3"
sha2 = "0.10"
wasm-bindgen = "0.2"

View file

@ -1,10 +1,15 @@
use std::io::Cursor;
use std::sync::Arc;
use acadrust::io::dwg::DwgReader;
use acadrust::DxfReader;
use acadrust::{DwgReadOptions, DxfReader, DxfReaderConfiguration};
use js_sys::{Function, Uint8Array};
use sha2::{Digest, Sha256};
use wasm_bindgen::prelude::*;
const HASH_MARKER: &str = "\nreport-source-sha256:";
const PROTOCOL_VERSION: u16 = 3;
/// Parse DWG/DXF on a dedicated browser worker and return a compact serialized
/// document. The main wasm instance only deserializes and installs it, so the
/// expensive bit/handle/object decode never occupies the browser UI thread.
@ -12,30 +17,175 @@ use wasm_bindgen::prelude::*;
pub fn parse_document(
name: String,
bytes: Uint8Array,
recovery_mode: bool,
initial_error: String,
report_stage: &Function,
) -> Result<Uint8Array, JsValue> {
console_error_panic_hook::set_once();
report_stage.call1(&JsValue::NULL, &JsValue::from_str("copy input"))?;
let bytes = bytes.to_vec();
let bytes: Arc<[u8]> = Arc::from(bytes.to_vec());
report_stage.call1(&JsValue::NULL, &JsValue::from_str("parse document"))?;
let ext = name.rsplit('.').next().unwrap_or_default().to_lowercase();
let document = match ext.as_str() {
"dwg" => DwgReader::from_stream(Cursor::new(bytes))
.read()
.map_err(|error| JsValue::from_str(&error.to_string()))?,
"dxf" => DxfReader::from_reader(Cursor::new(bytes))
.map_err(|error| JsValue::from_str(&error.to_string()))?
.read()
.map_err(|error| JsValue::from_str(&error.to_string()))?,
_ => {
return Err(JsValue::from_str(&format!(
"Unsupported file format: .{ext}"
)))
if !matches!(ext.as_str(), "dwg" | "dxf") {
return encode_result(
Err((format!("Unsupported file format: .{ext}"), None)),
None,
false,
&bytes,
);
}
let outcome_result = match ext.as_str() {
"dwg" => {
if recovery_mode {
DwgReader::from_stream_with_options(
Cursor::new(Arc::clone(&bytes)),
DwgReadOptions::failsafe(),
)
.read_with_stats()
} else {
DwgReader::from_stream(Cursor::new(Arc::clone(&bytes)))
.read_with_stats()
}
}
"dxf" => {
if recovery_mode {
DxfReader::from_reader(Cursor::new(Arc::clone(&bytes)))
.and_then(|reader| {
reader
.with_configuration(DxfReaderConfiguration {
failsafe: true,
..DxfReaderConfiguration::default()
})
.read_with_stats()
})
} else {
DxfReader::from_reader(Cursor::new(Arc::clone(&bytes)))
.and_then(|reader| reader.read_with_stats())
}
}
_ => unreachable!(),
};
let mut outcome = match outcome_result {
Ok(outcome) => outcome,
Err(error) => {
let recoverable_parse_error = !recovery_mode && recoverable_reader_error(&error);
let source_sha256 = recovery_mode.then(|| sha256_document_bytes(&bytes));
return encode_result(
Err((error.to_string(), None)),
source_sha256,
recoverable_parse_error,
&bytes,
);
}
};
if !outcome.stats.has_usable_drawing_data() {
let error = if recovery_mode {
format!(
"initial read failed: {initial_error}; recovery found no usable drawing data"
)
} else {
"initial read returned no source drawing records".to_string()
};
let source_sha256 = recovery_mode.then(|| sha256_document_bytes(&bytes));
return encode_result(
Err((error, Some(outcome.stats))),
source_sha256,
!recovery_mode,
&bytes,
);
}
if !recovery_mode && report_fingerprint_needed(&outcome.stats) {
let message = outcome
.stats
.diagnostics
.first()
.map(|diagnostic| diagnostic.message.clone())
.unwrap_or_else(|| "normal read detected recoverable drawing errors".to_string());
return encode_result(Err((message, Some(outcome.stats))), None, true, &bytes);
}
if recovery_mode {
outcome.document.notifications.notify(
acadrust::notification::NotificationType::Error,
format!("Initial read failed; recovery mode continued: {initial_error}"),
);
acadrust::push_read_diagnostic(
&mut outcome.stats.diagnostics,
acadrust::ReadDiagnostic::new(
"strict-read-failed",
acadrust::ReadStage::RecordStream,
initial_error,
),
);
outcome.stats.recovered_errors = outcome.stats.recovered_errors.saturating_add(1);
}
let source_sha256 = report_fingerprint_needed(&outcome.stats)
.then(|| sha256_document_bytes(&bytes));
report_stage.call1(&JsValue::NULL, &JsValue::from_str("serialize document"))?;
let encoded =
bincode::serialize(&document).map_err(|error| JsValue::from_str(&error.to_string()))?;
let encoded = encode_result(Ok(outcome), source_sha256, false, &bytes)?;
report_stage.call1(&JsValue::NULL, &JsValue::from_str("copy output"))?;
Ok(encoded)
}
#[wasm_bindgen]
pub fn sha256_document(bytes: Uint8Array) -> String {
sha256_document_bytes(&bytes.to_vec())
}
fn report_fingerprint_needed(stats: &acadrust::ReadStats) -> bool {
stats.recovered() || stats.skipped_source_records > 0 || !stats.stream_completed
}
fn recoverable_reader_error(error: &acadrust::DxfError) -> bool {
matches!(
error,
acadrust::DxfError::Compression(_)
| acadrust::DxfError::Parse(_)
| acadrust::DxfError::InvalidDxfCode(_)
| acadrust::DxfError::InvalidHandle(_)
| acadrust::DxfError::ObjectNotFound(_)
| acadrust::DxfError::InvalidEntityType(_)
| acadrust::DxfError::ChecksumMismatch { .. }
| acadrust::DxfError::InvalidHeader(_)
| acadrust::DxfError::InvalidFormat(_)
| acadrust::DxfError::InvalidSentinel(_)
| acadrust::DxfError::Decompression(_)
| acadrust::DxfError::Encoding(_)
)
}
fn encode_result(
result: Result<acadrust::ReadOutcome, (String, Option<acadrust::ReadStats>)>,
source_sha256: Option<String>,
recoverable_parse_error: bool,
bytes: &[u8],
) -> Result<Uint8Array, JsValue> {
let encoded = bincode::serialize(&(
PROTOCOL_VERSION,
result,
source_sha256,
recoverable_parse_error,
))
.map_err(|error| worker_error(error.to_string(), bytes, true))?;
Ok(Uint8Array::from(encoded.as_slice()))
}
fn worker_error(error: String, bytes: &[u8], include_fingerprint: bool) -> JsValue {
if include_fingerprint {
JsValue::from_str(&format!(
"{error}{HASH_MARKER}{}",
sha256_document_bytes(bytes)
))
} else {
JsValue::from_str(&error)
}
}
fn sha256_document_bytes(bytes: &[u8]) -> String {
let digest = Sha256::digest(bytes);
let mut output = String::with_capacity(digest.len() * 2);
for byte in digest {
use std::fmt::Write;
let _ = write!(output, "{byte:02x}");
}
output
}