rar-stream 5.1.1 → 5.2.0

package/lib/browser.d.ts

@@ -18,9 +18,44 @@ export declare function parseRarHeaders(data: Uint8Array): Promise<any[]>;
 export declare function parseRar5Header(data: Uint8Array): Promise<any>;
 export declare function parseRar5Headers(data: Uint8Array): Promise<any[]>;
 
+/**
+ * Extract the first file from a RAR archive buffer.
+ * Auto-detects RAR4/RAR5, parses headers, and decompresses in one call.
+ */
+export declare function extractFile(data: Uint8Array): Promise<{name: string, data: Uint8Array, length: number}>;
+
 // Classes (require init() before construction)
-export { WasmRarDecoder, WasmRar5Decoder, WasmRar5Crypto } from '../pkg/rar_stream.d.ts';
-export { WasmRarDecoder as RarDecoder, WasmRar5Decoder as Rar5Decoder } from '../pkg/rar_stream.d.ts';
+export declare class RarFilesPackage {
+  constructor(data: Uint8Array);
+  readonly length: number;
+  parse(): Array<{name: string, length: number, packedSize: number, isDirectory: boolean}>;
+  extract(index: number): {name: string, data: Uint8Array, length: number};
+  extractAll(): Array<{name: string, data: Uint8Array, length: number}>;
+  free(): void;
+}
+
+export declare class RarDecoder {
+  constructor(unpackedSize: bigint);
+  decompress(data: Uint8Array): Uint8Array;
+  bytes_written(): bigint;
+  is_complete(): boolean;
+  reset(): void;
+  free(): void;
+}
+
+export declare class Rar5Decoder {
+  constructor(unpackedSize: bigint, dictSizeLog: number, method: number, isSolid: boolean);
+  decompress(data: Uint8Array): Uint8Array;
+  reset(): void;
+  free(): void;
+}
+
+export declare class Rar5Crypto {
+  constructor(password: string, salt: Uint8Array, lg2Count: number);
+  decrypt(iv: Uint8Array, data: Uint8Array): Uint8Array;
+  verify_password(checkValue: Uint8Array): boolean;
+  free(): void;
+}
 
 // Direct snake_case access (require init() before use)
 export {
@@ -30,6 +65,7 @@ export {
   parse_rar_headers,
   parse_rar5_header,
   parse_rar5_headers,
+  extract_file,
 } from '../pkg/rar_stream.d.ts';
 
 /** Options for creating a ReadableStream */

package/lib/browser.mjs

@@ -12,6 +12,8 @@ import wasmInit, {
   parse_rar_headers,
   parse_rar5_header,
   parse_rar5_headers,
+  extract_file,
+  WasmRarArchive,
   WasmRarDecoder,
   WasmRar5Decoder,
   WasmRar5Crypto,
@@ -75,10 +77,24 @@ export async function parseRar5Headers(data) {
   return parse_rar5_headers(data);
 }
 
-// Re-export classes (require manual init() before use)
-export { WasmRarDecoder, WasmRar5Decoder, WasmRar5Crypto };
-// Aliases
-export { WasmRarDecoder as RarDecoder, WasmRar5Decoder as Rar5Decoder };
+// Re-export classes with aligned names (require manual init() before use)
+export {
+  WasmRarArchive as RarFilesPackage,
+  WasmRarDecoder as RarDecoder,
+  WasmRar5Decoder as Rar5Decoder,
+  WasmRar5Crypto as Rar5Crypto,
+};
+
+/**
+ * Extract the first file from a RAR archive buffer.
+ * Auto-detects RAR4/RAR5, parses headers, and decompresses in one call.
+ * @param {Uint8Array} data - The entire RAR archive
+ * @returns {Promise<{name: string, data: Uint8Array, size: number}>}
+ */
+export async function extractFile(data) {
+  await ensureInit();
+  return extract_file(data);
+}
 
 // Re-export snake_case direct access (require manual init() before use)
 export {
@@ -88,6 +104,7 @@ export {
   parse_rar_headers,
   parse_rar5_header,
   parse_rar5_headers,
+  extract_file,
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rar-stream",
-  "version": "5.1.1",
+  "version": "5.2.0",
   "description": "RAR streaming library - Rust implementation with NAPI and WASM bindings",
   "main": "lib/index.mjs",
   "browser": "lib/browser.mjs",
@@ -105,12 +105,12 @@
     "*.node"
   ],
   "optionalDependencies": {
-    "rar-stream-win32-x64-msvc": "5.1.1",
-    "rar-stream-darwin-x64": "5.1.1",
-    "rar-stream-linux-x64-gnu": "5.1.1",
-    "rar-stream-linux-x64-musl": "5.1.1",
-    "rar-stream-linux-arm64-gnu": "5.1.1",
-    "rar-stream-darwin-arm64": "5.1.1",
-    "rar-stream-linux-arm64-musl": "5.1.1"
+    "rar-stream-win32-x64-msvc": "5.2.0",
+    "rar-stream-darwin-x64": "5.2.0",
+    "rar-stream-linux-x64-gnu": "5.2.0",
+    "rar-stream-linux-x64-musl": "5.2.0",
+    "rar-stream-linux-arm64-gnu": "5.2.0",
+    "rar-stream-darwin-arm64": "5.2.0",
+    "rar-stream-linux-arm64-musl": "5.2.0"
   }
 }