react-native-nitro-unzip 0.1.0 → 0.2.0

package/README.md

@@ -1,13 +1,19 @@
 # react-native-nitro-unzip
 
-High-performance ZIP extraction for React Native, powered by [Nitro Modules](https://nitro.margelo.com/).
+[![npm](https://img.shields.io/npm/v/react-native-nitro-unzip)](https://www.npmjs.com/package/react-native-nitro-unzip)
+[![license](https://img.shields.io/npm/l/react-native-nitro-unzip)](https://github.com/isaacrowntree/react-native-nitro-unzip/blob/main/LICENSE)
+[![CI](https://github.com/isaacrowntree/react-native-nitro-unzip/actions/workflows/lint-typescript.yml/badge.svg)](https://github.com/isaacrowntree/react-native-nitro-unzip/actions/workflows/lint-typescript.yml)
+
+High-performance ZIP operations for React Native, powered by [Nitro Modules](https://nitro.margelo.com/).
 
 - **iOS**: SSZipArchive (C-based libz) — ~500 files/sec
 - **Android**: Optimized ZipInputStream with 64KB buffers — ~474 files/sec
-- **Zero bridge overhead** for progress callbacks (JSI-based)
-- **Proper object instances** — each extraction is an `UnzipTask` you can observe and cancel
-- **Concurrent extractions** supported out of the box
-- **iOS background task** management for continued extraction when app is backgrounded
+- **Zero bridge overhead** — progress callbacks via JSI, no serialization
+- **Object instances** — each task is an observable, cancellable `UnzipTask` or `ZipTask`
+- **Concurrent operations** supported out of the box
+- **Password support** — AES-256 encrypted archives (zip4j on Android, SSZipArchive on iOS)
+- **Zip creation** — compress files and directories with optional password protection
+- **Background tasks** — iOS background task management for continued extraction
 
 ## Installation
 
@@ -16,26 +22,61 @@ npm install react-native-nitro-unzip react-native-nitro-modules
 cd ios && pod install
 ```
 
+> Requires React Native 0.75+ and [Nitro Modules](https://nitro.margelo.com/) 0.34+
+
 ## Usage
 
+### Extract a ZIP archive
+
 ```typescript
-import { getUnzip } from 'react-native-nitro-unzip'
+import { getUnzip } from 'react-native-nitro-unzip';
 
-const unzip = getUnzip()
-const task = unzip.extract('/path/to/archive.zip', '/path/to/output')
+const unzip = getUnzip();
+const task = unzip.extract('/path/to/archive.zip', '/path/to/output');
 
-// Track progress
 task.onProgress((p) => {
-  console.log(`${(p.progress * 100).toFixed(0)}% — ${p.extractedFiles}/${p.totalFiles} files`)
-  console.log(`Speed: ${p.speed.toFixed(0)} files/sec`)
-})
+  console.log(`${(p.progress * 100).toFixed(0)}% — ${p.extractedFiles}/${p.totalFiles} files`);
+  console.log(`Speed: ${p.speed.toFixed(0)} files/sec`);
+});
 
-// Await result
-const result = await task.await()
-console.log(`Extracted ${result.extractedFiles} files in ${result.duration}ms`)
+const result = await task.await();
+console.log(`Extracted ${result.extractedFiles} files in ${result.duration}ms`);
+```
+
+### Extract with password
 
-// Or cancel
-task.cancel()
+```typescript
+const task = unzip.extractWithPassword('/path/to/encrypted.zip', '/output', 'secret');
+const result = await task.await();
+```
+
+### Create a ZIP archive
+
+```typescript
+const task = unzip.zip('/path/to/folder', '/output/archive.zip');
+
+task.onProgress((p) => {
+  console.log(`${(p.progress * 100).toFixed(0)}% — ${p.compressedFiles}/${p.totalFiles}`);
+});
+
+const result = await task.await();
+console.log(`Compressed ${result.compressedFiles} files`);
+```
+
+### Create with password (AES-256)
+
+```typescript
+const task = unzip.zipWithPassword('/path/to/folder', '/output/secure.zip', 'secret');
+const result = await task.await();
+```
+
+### Cancel an operation
+
+```typescript
+const task = unzip.extract('/path/to/large.zip', '/output');
+
+// Cancel at any time — synchronous via JSI
+task.cancel();
 ```
 
 ## API
@@ -44,21 +85,28 @@ task.cancel()
 
 Creates an `Unzip` factory instance.
 
-### `Unzip.extract(zipPath, destinationPath): UnzipTask`
+### Extraction
 
-Starts extracting a ZIP archive. Returns an `UnzipTask` instance immediately.
+| Method | Returns | Description |
+|---|---|---|
+| `extract(zipPath, destPath)` | `UnzipTask` | Extract a ZIP archive |
+| `extractWithPassword(zipPath, destPath, password)` | `UnzipTask` | Extract a password-protected archive |
 
-- `zipPath` — absolute path to the ZIP file (`file://` URIs accepted)
-- `destinationPath` — absolute path to extract into (created if missing)
+### Compression
 
-### `UnzipTask`
+| Method | Returns | Description |
+|---|---|---|
+| `zip(sourcePath, destZipPath)` | `ZipTask` | Create a ZIP archive from a directory |
+| `zipWithPassword(sourcePath, destZipPath, password)` | `ZipTask` | Create a password-protected ZIP (AES-256) |
+
+### `UnzipTask` / `ZipTask`
 
 | Property/Method | Type | Description |
 |---|---|---|
-| `taskId` | `string` | Unique identifier for this extraction |
-| `onProgress(callback)` | `(progress: UnzipProgress) => void` | Register a progress callback (throttled to ~1/sec) |
-| `cancel()` | `void` | Cancel this extraction |
-| `await()` | `Promise<UnzipResult>` | Await the extraction result |
+| `taskId` | `string` | Unique identifier for this operation |
+| `onProgress(callback)` | `void` | Register a progress callback (throttled ~1/sec) |
+| `cancel()` | `void` | Cancel the operation (synchronous via JSI) |
+| `await()` | `Promise<Result>` | Await the operation result |
 
 ### `UnzipProgress`
 
@@ -76,9 +124,30 @@ Starts extracting a ZIP archive. Returns an `UnzipTask` instance immediately.
 |---|---|---|
 | `success` | `boolean` | Whether extraction completed |
 | `extractedFiles` | `number` | Total files extracted |
+| `totalFiles` | `number` | Total files in the archive |
+| `duration` | `number` | Duration in milliseconds |
+| `averageSpeed` | `number` | Average files per second |
+| `totalBytes` | `number` | Size of the ZIP file in bytes |
+
+### `ZipProgress`
+
+| Field | Type | Description |
+|---|---|---|
+| `compressedFiles` | `number` | Files compressed so far |
+| `totalFiles` | `number` | Total files to compress |
+| `progress` | `number` | 0.0 to 1.0 |
+| `speed` | `number` | Files per second |
+
+### `ZipResult`
+
+| Field | Type | Description |
+|---|---|---|
+| `success` | `boolean` | Whether compression completed |
+| `compressedFiles` | `number` | Total files compressed |
+| `totalFiles` | `number` | Total files to compress |
 | `duration` | `number` | Duration in milliseconds |
 | `averageSpeed` | `number` | Average files per second |
-| `totalBytes` | `number` | Total bytes extracted |
+| `totalBytes` | `number` | Total bytes written |
 
 ## Performance
 
@@ -97,10 +166,20 @@ Benchmarked on a 350MB archive with 10,432 small files (map tiles):
 
 ## Requirements
 
-- React Native 0.75+
-- Nitro Modules 0.34+
-- iOS 13+
-- Android SDK 21+
+| Requirement | Version |
+|---|---|
+| React Native | 0.75+ |
+| Nitro Modules | 0.34+ |
+| iOS | 13+ |
+| Android SDK | 21+ |
+
+## Example
+
+See the [example app](./example) for a working demo of extraction, zip creation, password support, and cancellation.
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
 
 ## License
 

package/android/src/main/java/com/margelo/nitro/unzip/HybridUnzipTask.kt

@@ -163,13 +163,15 @@ class HybridUnzipTask(
 
     val durationMs = (System.currentTimeMillis() - startTime).toDouble()
     val avgSpeed = if (durationMs > 0) extractedCount / (durationMs / 1000.0) else 0.0
+    val zipFileSize = sourceFile.length().toDouble()
 
     UnzipResult(
       success = true,
       extractedFiles = extractedCount.toDouble(),
+      totalFiles = totalEntries.toDouble(),
       duration = durationMs,
       averageSpeed = avgSpeed,
-      totalBytes = 0.0
+      totalBytes = zipFileSize
     )
   }
 
@@ -239,13 +241,15 @@ class HybridUnzipTask(
 
     val durationMs = (System.currentTimeMillis() - startTime).toDouble()
     val avgSpeed = if (durationMs > 0) extractedCount / (durationMs / 1000.0) else 0.0
+    val zipFileSize = sourceFile.length().toDouble()
 
     UnzipResult(
       success = true,
       extractedFiles = extractedCount.toDouble(),
+      totalFiles = totalEntries.toDouble(),
       duration = durationMs,
       averageSpeed = avgSpeed,
-      totalBytes = 0.0
+      totalBytes = zipFileSize
     )
   }
 

package/android/src/main/java/com/margelo/nitro/unzip/HybridZipTask.kt

@@ -145,6 +145,7 @@ class HybridZipTask(
     ZipResult(
       success = true,
       compressedFiles = compressedCount.toDouble(),
+      totalFiles = totalFiles.toDouble(),
       duration = durationMs,
       averageSpeed = avgSpeed,
       totalBytes = totalBytes

package/ios/HybridUnzipTask.swift

@@ -130,10 +130,11 @@ class HybridUnzipTask: HybridUnzipTaskSpec {
     }
 
     var extractedFiles = 0
+    var totalFileCount = 0
     var lastProgressUpdate = Date()
 
     // SSZipArchive progress handler — called per file
-    let progressHandler: (String, unz_file_info, Int, Int) -> Void = { [weak self] _, _, entryNumber, total in
+    let progressHandler: (String, unz_file_info, Int, Int) -> Void = { [weak self] _, fileInfo, entryNumber, total in
       guard let self = self else { return }
 
       // Check cancellation
@@ -144,6 +145,7 @@ class HybridUnzipTask: HybridUnzipTaskSpec {
       if cancelled { return }
 
       extractedFiles = entryNumber
+      totalFileCount = total
 
       // Throttle progress updates
       let now = Date()
@@ -161,7 +163,7 @@ class HybridUnzipTask: HybridUnzipTaskSpec {
           totalFiles: Double(total),
           progress: progress,
           speed: speed,
-          processedBytes: 0
+          processedBytes: Double(fileInfo.uncompressed_size)
         ))
         lastProgressUpdate = now
       }
@@ -202,12 +204,22 @@ class HybridUnzipTask: HybridUnzipTaskSpec {
     let finalCount = extractedFiles
     let averageSpeed = duration > 0 ? Double(finalCount) / (duration / 1000) : 0
 
+    // Calculate total bytes from extracted files
+    let totalBytes: Double
+    if let attrs = try? fileManager.attributesOfItem(atPath: cleanZip),
+       let fileSize = attrs[.size] as? UInt64 {
+      totalBytes = Double(fileSize)
+    } else {
+      totalBytes = 0
+    }
+
     return UnzipResult(
       success: true,
       extractedFiles: Double(finalCount),
+      totalFiles: Double(totalFileCount),
       duration: duration,
       averageSpeed: averageSpeed,
-      totalBytes: 0
+      totalBytes: totalBytes
     )
   }
 

package/ios/HybridZipTask.swift

@@ -198,6 +198,7 @@ class HybridZipTask: HybridZipTaskSpec {
     return ZipResult(
       success: true,
       compressedFiles: Double(finalCount),
+      totalFiles: Double(totalFiles),
       duration: duration,
       averageSpeed: averageSpeed,
       totalBytes: totalBytes

package/lib/typescript/specs/Unzip.nitro.d.ts

@@ -22,6 +22,8 @@ export interface UnzipResult {
     success: boolean;
     /** Total number of files extracted */
     extractedFiles: number;
+    /** Total number of files in the archive */
+    totalFiles: number;
     /** Total extraction duration in milliseconds */
     duration: number;
     /** Average extraction speed in files per second */
@@ -77,6 +79,8 @@ export interface ZipResult {
     success: boolean;
     /** Total number of files compressed */
     compressedFiles: number;
+    /** Total number of files to compress */
+    totalFiles: number;
     /** Total compression duration in milliseconds */
     duration: number;
     /** Average compression speed in files per second */

package/lib/typescript/specs/Unzip.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Unzip.nitro.d.ts","sourceRoot":"","sources":["../../../src/specs/Unzip.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Unzip.nitro.d.ts","sourceRoot":"","sources":["../../../src/specs/Unzip.nitro.ts"],"names":[],"mappings":"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"}

package/nitrogen/generated/android/c++/JUnzipResult.hpp

@@ -35,6 +35,8 @@ namespace margelo::nitro::unzip {
       jboolean success = this->getFieldValue(fieldSuccess);
       static const auto fieldExtractedFiles = clazz->getField<double>("extractedFiles");
       double extractedFiles = this->getFieldValue(fieldExtractedFiles);
+      static const auto fieldTotalFiles = clazz->getField<double>("totalFiles");
+      double totalFiles = this->getFieldValue(fieldTotalFiles);
       static const auto fieldDuration = clazz->getField<double>("duration");
       double duration = this->getFieldValue(fieldDuration);
       static const auto fieldAverageSpeed = clazz->getField<double>("averageSpeed");
@@ -44,6 +46,7 @@ namespace margelo::nitro::unzip {
       return UnzipResult(
         static_cast<bool>(success),
         extractedFiles,
+        totalFiles,
         duration,
         averageSpeed,
         totalBytes
@@ -56,13 +59,14 @@ namespace margelo::nitro::unzip {
      */
     [[maybe_unused]]
     static jni::local_ref<JUnzipResult::javaobject> fromCpp(const UnzipResult& value) {
-      using JSignature = JUnzipResult(jboolean, double, double, double, double);
+      using JSignature = JUnzipResult(jboolean, double, double, double, double, double);
       static const auto clazz = javaClassStatic();
       static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
       return create(
         clazz,
         value.success,
         value.extractedFiles,
+        value.totalFiles,
         value.duration,
         value.averageSpeed,
         value.totalBytes

package/nitrogen/generated/android/c++/JZipResult.hpp

@@ -35,6 +35,8 @@ namespace margelo::nitro::unzip {
       jboolean success = this->getFieldValue(fieldSuccess);
       static const auto fieldCompressedFiles = clazz->getField<double>("compressedFiles");
       double compressedFiles = this->getFieldValue(fieldCompressedFiles);
+      static const auto fieldTotalFiles = clazz->getField<double>("totalFiles");
+      double totalFiles = this->getFieldValue(fieldTotalFiles);
       static const auto fieldDuration = clazz->getField<double>("duration");
       double duration = this->getFieldValue(fieldDuration);
       static const auto fieldAverageSpeed = clazz->getField<double>("averageSpeed");
@@ -44,6 +46,7 @@ namespace margelo::nitro::unzip {
       return ZipResult(
         static_cast<bool>(success),
         compressedFiles,
+        totalFiles,
         duration,
         averageSpeed,
         totalBytes
@@ -56,13 +59,14 @@ namespace margelo::nitro::unzip {
      */
     [[maybe_unused]]
     static jni::local_ref<JZipResult::javaobject> fromCpp(const ZipResult& value) {
-      using JSignature = JZipResult(jboolean, double, double, double, double);
+      using JSignature = JZipResult(jboolean, double, double, double, double, double);
       static const auto clazz = javaClassStatic();
       static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
       return create(
         clazz,
         value.success,
         value.compressedFiles,
+        value.totalFiles,
         value.duration,
         value.averageSpeed,
         value.totalBytes

package/nitrogen/generated/android/kotlin/com/margelo/nitro/unzip/UnzipResult.kt

@@ -25,6 +25,9 @@ data class UnzipResult(
   val extractedFiles: Double,
   @DoNotStrip
   @Keep
+  val totalFiles: Double,
+  @DoNotStrip
+  @Keep
   val duration: Double,
   @DoNotStrip
   @Keep
@@ -43,8 +46,8 @@ data class UnzipResult(
     @Keep
     @Suppress("unused")
     @JvmStatic
-    private fun fromCpp(success: Boolean, extractedFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double): UnzipResult {
-      return UnzipResult(success, extractedFiles, duration, averageSpeed, totalBytes)
+    private fun fromCpp(success: Boolean, extractedFiles: Double, totalFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double): UnzipResult {
+      return UnzipResult(success, extractedFiles, totalFiles, duration, averageSpeed, totalBytes)
     }
   }
 }

package/nitrogen/generated/android/kotlin/com/margelo/nitro/unzip/ZipResult.kt

@@ -25,6 +25,9 @@ data class ZipResult(
   val compressedFiles: Double,
   @DoNotStrip
   @Keep
+  val totalFiles: Double,
+  @DoNotStrip
+  @Keep
   val duration: Double,
   @DoNotStrip
   @Keep
@@ -43,8 +46,8 @@ data class ZipResult(
     @Keep
     @Suppress("unused")
     @JvmStatic
-    private fun fromCpp(success: Boolean, compressedFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double): ZipResult {
-      return ZipResult(success, compressedFiles, duration, averageSpeed, totalBytes)
+    private fun fromCpp(success: Boolean, compressedFiles: Double, totalFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double): ZipResult {
+      return ZipResult(success, compressedFiles, totalFiles, duration, averageSpeed, totalBytes)
     }
   }
 }

package/nitrogen/generated/ios/swift/UnzipResult.swift

@@ -18,8 +18,8 @@ public extension UnzipResult {
   /**
    * Create a new instance of `UnzipResult`.
    */
-  init(success: Bool, extractedFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double) {
-    self.init(success, extractedFiles, duration, averageSpeed, totalBytes)
+  init(success: Bool, extractedFiles: Double, totalFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double) {
+    self.init(success, extractedFiles, totalFiles, duration, averageSpeed, totalBytes)
   }
 
   @inline(__always)
@@ -32,6 +32,11 @@ public extension UnzipResult {
     return self.__extractedFiles
   }
   
+  @inline(__always)
+  var totalFiles: Double {
+    return self.__totalFiles
+  }
+  
   @inline(__always)
   var duration: Double {
     return self.__duration

package/nitrogen/generated/ios/swift/ZipResult.swift

@@ -18,8 +18,8 @@ public extension ZipResult {
   /**
    * Create a new instance of `ZipResult`.
    */
-  init(success: Bool, compressedFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double) {
-    self.init(success, compressedFiles, duration, averageSpeed, totalBytes)
+  init(success: Bool, compressedFiles: Double, totalFiles: Double, duration: Double, averageSpeed: Double, totalBytes: Double) {
+    self.init(success, compressedFiles, totalFiles, duration, averageSpeed, totalBytes)
   }
 
   @inline(__always)
@@ -32,6 +32,11 @@ public extension ZipResult {
     return self.__compressedFiles
   }
   
+  @inline(__always)
+  var totalFiles: Double {
+    return self.__totalFiles
+  }
+  
   @inline(__always)
   var duration: Double {
     return self.__duration

package/nitrogen/generated/shared/c++/UnzipResult.hpp

@@ -41,13 +41,14 @@ namespace margelo::nitro::unzip {
   public:
     bool success     SWIFT_PRIVATE;
     double extractedFiles     SWIFT_PRIVATE;
+    double totalFiles     SWIFT_PRIVATE;
     double duration     SWIFT_PRIVATE;
     double averageSpeed     SWIFT_PRIVATE;
     double totalBytes     SWIFT_PRIVATE;
 
   public:
     UnzipResult() = default;
-    explicit UnzipResult(bool success, double extractedFiles, double duration, double averageSpeed, double totalBytes): success(success), extractedFiles(extractedFiles), duration(duration), averageSpeed(averageSpeed), totalBytes(totalBytes) {}
+    explicit UnzipResult(bool success, double extractedFiles, double totalFiles, double duration, double averageSpeed, double totalBytes): success(success), extractedFiles(extractedFiles), totalFiles(totalFiles), duration(duration), averageSpeed(averageSpeed), totalBytes(totalBytes) {}
 
   public:
     friend bool operator==(const UnzipResult& lhs, const UnzipResult& rhs) = default;
@@ -65,6 +66,7 @@ namespace margelo::nitro {
       return margelo::nitro::unzip::UnzipResult(
         JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "success"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "extractedFiles"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalFiles"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "duration"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageSpeed"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalBytes")))
@@ -74,6 +76,7 @@ namespace margelo::nitro {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "success"), JSIConverter<bool>::toJSI(runtime, arg.success));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "extractedFiles"), JSIConverter<double>::toJSI(runtime, arg.extractedFiles));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "totalFiles"), JSIConverter<double>::toJSI(runtime, arg.totalFiles));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "duration"), JSIConverter<double>::toJSI(runtime, arg.duration));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "averageSpeed"), JSIConverter<double>::toJSI(runtime, arg.averageSpeed));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "totalBytes"), JSIConverter<double>::toJSI(runtime, arg.totalBytes));
@@ -89,6 +92,7 @@ namespace margelo::nitro {
       }
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "success")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "extractedFiles")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalFiles")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "duration")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageSpeed")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalBytes")))) return false;

package/nitrogen/generated/shared/c++/ZipResult.hpp

@@ -41,13 +41,14 @@ namespace margelo::nitro::unzip {
   public:
     bool success     SWIFT_PRIVATE;
     double compressedFiles     SWIFT_PRIVATE;
+    double totalFiles     SWIFT_PRIVATE;
     double duration     SWIFT_PRIVATE;
     double averageSpeed     SWIFT_PRIVATE;
     double totalBytes     SWIFT_PRIVATE;
 
   public:
     ZipResult() = default;
-    explicit ZipResult(bool success, double compressedFiles, double duration, double averageSpeed, double totalBytes): success(success), compressedFiles(compressedFiles), duration(duration), averageSpeed(averageSpeed), totalBytes(totalBytes) {}
+    explicit ZipResult(bool success, double compressedFiles, double totalFiles, double duration, double averageSpeed, double totalBytes): success(success), compressedFiles(compressedFiles), totalFiles(totalFiles), duration(duration), averageSpeed(averageSpeed), totalBytes(totalBytes) {}
 
   public:
     friend bool operator==(const ZipResult& lhs, const ZipResult& rhs) = default;
@@ -65,6 +66,7 @@ namespace margelo::nitro {
       return margelo::nitro::unzip::ZipResult(
         JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "success"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "compressedFiles"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalFiles"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "duration"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageSpeed"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalBytes")))
@@ -74,6 +76,7 @@ namespace margelo::nitro {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "success"), JSIConverter<bool>::toJSI(runtime, arg.success));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "compressedFiles"), JSIConverter<double>::toJSI(runtime, arg.compressedFiles));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "totalFiles"), JSIConverter<double>::toJSI(runtime, arg.totalFiles));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "duration"), JSIConverter<double>::toJSI(runtime, arg.duration));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "averageSpeed"), JSIConverter<double>::toJSI(runtime, arg.averageSpeed));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "totalBytes"), JSIConverter<double>::toJSI(runtime, arg.totalBytes));
@@ -89,6 +92,7 @@ namespace margelo::nitro {
       }
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "success")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "compressedFiles")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalFiles")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "duration")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "averageSpeed")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalBytes")))) return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-unzip",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "High-performance ZIP extraction for React Native, powered by Nitro Modules",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/src/specs/Unzip.nitro.ts

@@ -26,6 +26,8 @@ export interface UnzipResult {
   success: boolean;
   /** Total number of files extracted */
   extractedFiles: number;
+  /** Total number of files in the archive */
+  totalFiles: number;
   /** Total extraction duration in milliseconds */
   duration: number;
   /** Average extraction speed in files per second */
@@ -87,6 +89,8 @@ export interface ZipResult {
   success: boolean;
   /** Total number of files compressed */
   compressedFiles: number;
+  /** Total number of files to compress */
+  totalFiles: number;
   /** Total compression duration in milliseconds */
   duration: number;
   /** Average compression speed in files per second */