rar-stream 5.3.1 → 5.4.0

package/README.md

@@ -125,6 +125,41 @@ interface FileMedia {
 | `streamToBuffer(stream)` | Convert Readable to Buffer |
 | `createFileMedia(source)` | Wrap any `{ createReadStream }` as FileMedia |
 
+### Rust API
+
+#### In-Memory (no features required)
+
+```rust
+use rar_stream::{MemoryArchive, is_rar_archive, detect_version};
+
+// Check format
+let data = std::fs::read("archive.rar")?;
+assert!(is_rar_archive(&data));
+
+// Parse and extract
+let archive = MemoryArchive::new(&data)?;
+let info = archive.archive_info();
+println!("Format: {:?}, solid: {}", info.version, info.is_solid);
+
+for entry in archive.entries() {
+    println!("{}: {} bytes", entry.name, entry.unpacked_size);
+}
+let content = archive.extract(0)?;
+let readme = archive.extract_by_name("README.md")?;
+```
+
+#### Async (requires `async` feature)
+
+```rust
+use rar_stream::{RarFilesPackage, ParseOptions, LocalFileMedia, FileMedia};
+use std::sync::Arc;
+
+let file: Arc<dyn FileMedia> = Arc::new(LocalFileMedia::new("archive.rar")?);
+let package = RarFilesPackage::new(vec![file]);
+let files = package.parse(ParseOptions::default()).await?;
+let content = files[0].read_to_end().await?;
+```
+
 ## Feature Flags
 
 ### Rust (Cargo)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rar-stream",
-  "version": "5.3.1",
+  "version": "5.4.0",
   "description": "RAR streaming library - Rust implementation with NAPI and WASM bindings",
   "main": "lib/index.mjs",
   "browser": "lib/browser.mjs",