rn-file-toolkit 1.0.1 → 1.0.3

package/lib/module/index.js

@@ -5,16 +5,6 @@ import { NativeEventEmitter, NativeModules } from 'react-native';
 import FileToolkitSpec from "./NativeFileToolkit.js";
 const FileToolkitModule = NativeModules.FileToolkit || FileToolkitSpec;
 const eventEmitter = new NativeEventEmitter(FileToolkitModule);
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/**
- * Rich progress information emitted during a download.
- * Replaces the plain `number` percent from earlier versions.
- */
-
-// ─── Queue ───────────────────────────────────────────────────────────────────
-
 class DownloadQueue {
   _maxConcurrent = 3;
   _active = 0;
@@ -22,7 +12,6 @@ class DownloadQueue {
   setOptions(opts) {
     if (opts.maxConcurrent != null && opts.maxConcurrent > 0) {
       this._maxConcurrent = opts.maxConcurrent;
-      // Kick off any slots that just opened.
       this._flush();
     }
   }
@@ -52,7 +41,6 @@ class DownloadQueue {
     while (this._active < this._maxConcurrent && this._queue.length > 0) {
       const item = this._queue.shift();
       this._active++;
-      // Strip queue-specific fields before passing to the native layer.
       const nativeOptions = {
         ...item.options
       };
@@ -70,55 +58,31 @@ class DownloadQueue {
   }
 }
 const _globalQueue = new DownloadQueue();
-
-/**
- * Configure the global managed download queue.
- *
- * @example
- * ```ts
- * setQueueOptions({ maxConcurrent: 3 });
- * ```
- */
+function _generateId() {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+    const r = Math.random() * 16 | 0;
+    const v = c === 'x' ? r : r & 0x3 | 0x8;
+    return v.toString(16);
+  });
+}
 export function setQueueOptions(options) {
   _globalQueue.setOptions(options);
 }
-
-/**
- * Get the current state of the managed download queue.
- *
- * @example
- * ```ts
- * const { active, pending, maxConcurrent } = getQueueStatus();
- * ```
- */
 export function getQueueStatus() {
   return _globalQueue.getStatus();
 }
-
-// ─── Core download ────────────────────────────────────────────────────────────
-
-/**
- * Core native download executor — used internally by `download()` and the queue.
- * Never routes through the queue.
- */
 async function _executeDownload(options) {
   let progressSubscription = null;
   let retrySubscription = null;
-
-  // downloadId is resolved immediately on Android foreground, allowing
-  // ID-based event filtering. On iOS it only arrives on completion, so we
-  // fall back to URL-based filtering in that case.
-  let knownDownloadId = null;
-
-  // Speed / ETA tracking (JS-side, works regardless of native platform)
+  const downloadId = options.downloadId || _generateId();
+  const knownDownloadId = downloadId;
   let _lastProgressTs = null;
   let _lastProgressBytes = 0;
-  // Smoothed speed using exponential moving average (α = 0.3)
   let _smoothedSpeedBps = 0;
   if (options.onProgress) {
     progressSubscription = eventEmitter.addListener('onDownloadProgress', event => {
-      const matchesId = knownDownloadId && event.downloadId === knownDownloadId;
-      const matchesUrl = !knownDownloadId && event.url === options.url;
+      const matchesId = event.downloadId === knownDownloadId;
+      const matchesUrl = !event.downloadId && event.url === options.url;
       if ((matchesId || matchesUrl) && options.onProgress) {
         const now = Date.now();
         const percent = event.progress ?? 0;
@@ -130,47 +94,30 @@ async function _executeDownload(options) {
           const dtSec = (now - _lastProgressTs) / 1000;
           if (dtSec > 0) {
             const bytesDelta = bytesDownloaded - _lastProgressBytes;
-            // Only update speed if we have byte-level data from native
             if (bytesDelta > 0 && totalBytes > 0) {
               const instantSpeed = bytesDelta / dtSec;
-              // Exponential moving average for smoother readings
               _smoothedSpeedBps = _smoothedSpeedBps === 0 ? instantSpeed : 0.3 * instantSpeed + 0.7 * _smoothedSpeedBps;
               speedBps = _smoothedSpeedBps;
-              const remaining = totalBytes - bytesDownloaded;
-              etaSeconds = speedBps > 0 ? remaining / speedBps : 0;
-            } else if (percent > 0 && percent < 100) {
-              // Fallback: estimate from percent when bytes aren't available
-              const estimatedTotalBytes = totalBytes > 0 ? totalBytes : _lastProgressBytes / (percent / 100);
-              const percentDelta = percent - _lastProgressBytes / estimatedTotalBytes * 100;
-              if (percentDelta > 0) {
-                const estimatedByteDelta = percentDelta / 100 * estimatedTotalBytes;
-                const instantSpeed = estimatedByteDelta / dtSec;
-                _smoothedSpeedBps = _smoothedSpeedBps === 0 ? instantSpeed : 0.3 * instantSpeed + 0.7 * _smoothedSpeedBps;
-                speedBps = _smoothedSpeedBps;
-                const remainingPct = 100 - percent;
-                const estimatedRemaining = remainingPct / 100 * estimatedTotalBytes;
-                etaSeconds = speedBps > 0 ? estimatedRemaining / speedBps : 0;
-              }
+              etaSeconds = speedBps > 0 ? (totalBytes - bytesDownloaded) / speedBps : 0;
             }
           }
         }
         _lastProgressTs = now;
         _lastProgressBytes = bytesDownloaded;
-        const info = {
+        options.onProgress({
           percent,
           bytesDownloaded,
           totalBytes,
           speedBps,
           etaSeconds
-        };
-        options.onProgress(info);
+        });
       }
     });
   }
   if (options.retry?.onRetry) {
     retrySubscription = eventEmitter.addListener('onDownloadRetry', event => {
-      const matchesId = knownDownloadId && event.downloadId === knownDownloadId;
-      const matchesUrl = !knownDownloadId && event.url === options.url;
+      const matchesId = event.downloadId === knownDownloadId;
+      const matchesUrl = !event.downloadId && event.url === options.url;
       if ((matchesId || matchesUrl) && options.retry?.onRetry) {
         options.retry.onRetry(event.attempt, event.error ?? '');
       }
@@ -181,32 +128,13 @@ async function _executeDownload(options) {
     retrySubscription?.remove();
   };
   try {
-    const resultPromise = FileToolkitSpec.download({
-      url: options.url,
-      fileName: options.fileName,
+    const result = await FileToolkitModule.download({
+      ...options,
+      downloadId,
       background: options.background ?? false,
       headers: options.headers ?? {},
-      destination: options.destination ?? 'downloads',
-      notificationTitle: options.notificationTitle,
-      notificationDescription: options.notificationDescription,
-      checksum: options.checksum,
-      retry: options.retry ? {
-        attempts: options.retry.attempts,
-        delay: options.retry.delay ?? 1000
-      } : undefined
+      destination: options.destination ?? 'downloads'
     });
-
-    // On Android foreground the promise resolves immediately with downloadId,
-    // giving us a precise ID to filter events by before download completes.
-    // On iOS it only resolves on completion, so knownDownloadId stays null
-    // and URL-based filtering is used as the fallback.
-    resultPromise.then?.(partial => {
-      if (partial?.downloadId && !partial?.filePath) {
-        // Android early-resolve: has downloadId but no filePath yet
-        knownDownloadId = partial.downloadId;
-      }
-    });
-    const result = await resultPromise;
     cleanup();
     return result;
   } catch (error) {
@@ -217,256 +145,149 @@ async function _executeDownload(options) {
     };
   }
 }
-
-/**
- * Download a file.
- *
- * For **foreground** downloads the promise resolves when the file is saved.
- * For **background** downloads the promise resolves immediately with a
- * `downloadId`; listen to the `onDownloadComplete` / `onDownloadError`
- * events for the final result.
- *
- * Pass `queue: true` to join the managed queue and respect the `maxConcurrent`
- * limit configured via `setQueueOptions()`. Use `priority: 'high'` to jump
- * ahead of other pending items in the queue.
- *
- * @example
- * ```ts
- * // Direct (unqueued) download
- * const result = await download({ url: 'https://...' });
- *
- * // Queued download with high priority
- * setQueueOptions({ maxConcurrent: 3 });
- * const result = await download({
- *   url: 'https://...',
- *   queue: true,
- *   priority: 'high',
- * });
- * ```
- */
 export function download(options) {
-  if (options.queue) {
-    return _globalQueue.enqueue(options);
-  }
+  if (options.queue) return _globalQueue.enqueue(options);
   return _executeDownload(options);
 }
-
-// ─── Core upload ───────────────────────────────────────────────────────────────
-
-/**
- * Upload a file using multipart/form-data.
- */
 export async function upload(options) {
-  let progressSubscription = null;
+  let sub = null;
+  const uploadId = options.uploadId || _generateId();
   if (options.onProgress) {
-    progressSubscription = eventEmitter.addListener('onUploadProgress', event => {
-      if (event.url === options.url && options.onProgress) {
-        options.onProgress(event.progress);
-      }
+    sub = eventEmitter.addListener('onUploadProgress', e => {
+      if (e.uploadId === uploadId) options.onProgress(e.progress);
     });
   }
   try {
-    const result = await FileToolkitSpec.upload({
-      url: options.url,
-      filePath: options.filePath,
+    const res = await FileToolkitModule.upload({
+      ...options,
+      uploadId,
       fieldName: options.fieldName ?? 'file',
       headers: options.headers ?? {},
       parameters: options.parameters ?? {}
     });
-    if (progressSubscription) {
-      progressSubscription.remove();
-    }
-    return result;
-  } catch (error) {
-    if (progressSubscription) {
-      progressSubscription.remove();
-    }
+    sub?.remove();
+    return {
+      ...res,
+      uploadId
+    };
+  } catch (err) {
+    sub?.remove();
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err?.message || 'UNKNOWN_ERROR',
+      uploadId
     };
   }
 }
-
-// ─── Pause / Resume / Cancel ──────────────────────────────────────────────────
-
-/**
- * Pause an active foreground download.
- * On iOS the partial data is stored so it can be resumed.
- * On Android the download thread is suspended.
- */
-export async function pauseDownload(downloadId) {
+export async function pauseDownload(id) {
   try {
-    return await FileToolkitSpec.pauseDownload(downloadId);
-  } catch (error) {
+    return await FileToolkitModule.pauseDownload(id);
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-/**
- * Resume a previously paused download.
- * On iOS resumes from partial data (HTTP Range). On Android unblocks the thread.
- */
-export async function resumeDownload(downloadId) {
+export async function resumeDownload(id) {
   try {
-    return await FileToolkitSpec.resumeDownload(downloadId);
-  } catch (error) {
+    return await FileToolkitModule.resumeDownload(id);
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-/**
- * Cancel and discard a download (foreground or background).
- * Any partially-downloaded file is deleted.
- */
-export async function cancelDownload(downloadId) {
+export async function cancelDownload(id) {
   try {
-    return await FileToolkitSpec.cancelDownload(downloadId);
-  } catch (error) {
+    return await FileToolkitModule.cancelDownload(id);
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-// ─── Cache management ─────────────────────────────────────────────────────────
-
-/**
- * List all files in the app's cache directory.
- */
 export async function getCachedFiles() {
   try {
-    return await FileToolkitSpec.getCachedFiles();
-  } catch (error) {
+    return await FileToolkitModule.getCachedFiles();
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-/**
- * Delete a single file by its absolute path.
- */
-export async function deleteFile(filePath) {
+export async function deleteFile(path) {
   try {
-    return await FileToolkitSpec.deleteFile(filePath);
-  } catch (error) {
+    return await FileToolkitModule.deleteFile(path);
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-/**
- * Delete all files in the app's cache directory.
- */
 export async function clearCache() {
   try {
-    return await FileToolkitSpec.clearCache();
-  } catch (error) {
+    return await FileToolkitModule.clearCache();
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-/**
- * Get all active background downloads.
- * Use this after app restart to "re-attach" to ongoing downloads.
- */
 export async function getBackgroundDownloads() {
   try {
-    return await FileToolkitSpec.getBackgroundDownloads();
-  } catch (error) {
+    return await FileToolkitModule.getBackgroundDownloads();
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-// ─── File system helpers ─────────────────────────────────────────────────────
-
-function _ensureFsSuccess(result, fallback) {
-  if (!result?.success) {
-    throw new Error(result?.error || fallback);
-  }
+function _ensure(res, msg) {
+  if (!res?.success) throw new Error(res?.error || msg);
 }
-
-/** Check whether a file or directory exists. */
-export async function exists(filePath) {
-  const result = await FileToolkitSpec.exists(filePath);
-  _ensureFsSuccess(result, 'EXISTS_ERROR');
-  return !!result.exists;
+export async function exists(path) {
+  const res = await FileToolkitModule.exists(path);
+  _ensure(res, 'EXISTS_ERROR');
+  return !!res.exists;
 }
-
-/** Get file or directory metadata. */
-export async function stat(filePath) {
-  const result = await FileToolkitSpec.stat(filePath);
-  _ensureFsSuccess(result, 'STAT_ERROR');
-  return result.stat;
+export async function stat(path) {
+  const res = await FileToolkitModule.stat(path);
+  _ensure(res, 'STAT_ERROR');
+  return res.stat;
 }
-
-/** Read a file as utf8 (default) or base64 string. */
-export async function readFile(filePath, encoding = 'utf8') {
-  const result = await FileToolkitSpec.readFile(filePath, encoding);
-  _ensureFsSuccess(result, 'READ_FILE_ERROR');
-  return result.data ?? '';
+export async function readFile(path, enc = 'utf8') {
+  const res = await FileToolkitModule.readFile(path, enc);
+  _ensure(res, 'READ_ERROR');
+  return res.data ?? '';
 }
-
-/** Write utf8 (default) or base64 data to a file. */
-export async function writeFile(filePath, data, encoding = 'utf8') {
-  const result = await FileToolkitSpec.writeFile(filePath, data, encoding);
-  _ensureFsSuccess(result, 'WRITE_FILE_ERROR');
+export async function writeFile(path, data, enc = 'utf8') {
+  const res = await FileToolkitModule.writeFile(path, data, enc);
+  _ensure(res, 'WRITE_ERROR');
 }
-
-/** Copy a file from source to destination. */
-export async function copyFile(fromPath, toPath) {
-  const result = await FileToolkitSpec.copyFile(fromPath, toPath);
-  _ensureFsSuccess(result, 'COPY_FILE_ERROR');
+export async function copyFile(from, to) {
+  const res = await FileToolkitModule.copyFile(from, to);
+  _ensure(res, 'COPY_ERROR');
 }
-
-/** Move a file from source to destination. */
-export async function moveFile(fromPath, toPath) {
-  const result = await FileToolkitSpec.moveFile(fromPath, toPath);
-  _ensureFsSuccess(result, 'MOVE_FILE_ERROR');
+export async function moveFile(from, to) {
+  const res = await FileToolkitModule.moveFile(from, to);
+  _ensure(res, 'MOVE_ERROR');
 }
-
-/** Create a directory recursively. */
-export async function mkdir(dirPath) {
-  const result = await FileToolkitSpec.mkdir(dirPath);
-  _ensureFsSuccess(result, 'MKDIR_ERROR');
+export async function mkdir(path) {
+  const res = await FileToolkitModule.mkdir(path);
+  _ensure(res, 'MKDIR_ERROR');
 }
-
-/** List direct entries (names) in a directory. */
-export async function ls(dirPath) {
-  const result = await FileToolkitSpec.ls(dirPath);
-  _ensureFsSuccess(result, 'LS_ERROR');
-  return result.entries || [];
+export async function ls(path) {
+  const res = await FileToolkitModule.ls(path);
+  _ensure(res, 'LS_ERROR');
+  return res.entries || [];
 }
-
-/**
- * File system API namespace.
- *
- * @example
- * ```ts
- * import { fs } from 'rn-file-toolkit';
- *
- * const ok = await fs.exists('/path/to/file.pdf');
- * const meta = await fs.stat('/path/to/file.pdf');
- * const text = await fs.readFile('/path/to/file.txt');
- * ```
- */
 export const fs = {
   exists,
   stat,
@@ -474,366 +295,130 @@ export const fs = {
   writeFile,
   copyFile,
   moveFile,
-  deleteFile: async filePath => {
-    const result = await deleteFile(filePath);
-    _ensureFsSuccess(result, 'DELETE_FILE_ERROR');
+  deleteFile: async p => {
+    _ensure(await deleteFile(p), 'DEL_ERROR');
   },
   mkdir,
   ls
 };
-
-// ─── Event helpers ────────────────────────────────────────────────────────────
-
-/**
- * Subscribe to background download completion events.
- * Returns an unsubscribe function.
- */
-export function onDownloadComplete(callback) {
-  const sub = eventEmitter.addListener('onDownloadComplete', callback);
-  return () => sub.remove();
+export function onDownloadComplete(cb) {
+  const s = eventEmitter.addListener('onDownloadComplete', cb);
+  return () => s.remove();
 }
-
-/**
- * Subscribe to background download error events.
- * Returns an unsubscribe function.
- */
-export function onDownloadError(callback) {
-  const sub = eventEmitter.addListener('onDownloadError', callback);
-  return () => sub.remove();
+export function onDownloadError(cb) {
+  const s = eventEmitter.addListener('onDownloadError', cb);
+  return () => s.remove();
 }
-
-/**
- * Subscribe to upload progress events.
- * Returns an unsubscribe function.
- */
-export function onUploadProgress(callback) {
-  const sub = eventEmitter.addListener('onUploadProgress', callback);
-  return () => sub.remove();
+export function onUploadProgress(cb) {
+  const s = eventEmitter.addListener('onUploadProgress', cb);
+  return () => s.remove();
 }
-
-/**
- * Subscribe to download retry events (fired before each retry attempt).
- * Returns an unsubscribe function.
- */
-export function onDownloadRetry(callback) {
-  const sub = eventEmitter.addListener('onDownloadRetry', callback);
-  return () => sub.remove();
+export function onDownloadRetry(cb) {
+  const s = eventEmitter.addListener('onDownloadRetry', cb);
+  return () => s.remove();
 }
-
-// ─── saveBase64AsFile ─────────────────────────────────────────────────────────
-
-/**
- * Save a base64 string or data URI as a file.
- * Supports data URIs (e.g., "data:image/png;base64,iVBORw0...") and plain base64 strings.
- *
- * @example
- * ```typescript
- * // From data URI
- * const result = await saveBase64AsFile({
- *   base64Data: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...',
- *   fileName: 'photo.png',
- *   destination: 'documents'
- * });
- *
- * // From plain base64
- * const result = await saveBase64AsFile({
- *   base64Data: 'SGVsbG8gV29ybGQ=',
- *   fileName: 'hello.txt',
- *   destination: 'cache'
- * });
- * ```
- */
-export async function saveBase64AsFile(options) {
+export async function saveBase64AsFile(opts) {
   try {
     let {
       base64Data,
       fileName,
       destination
-    } = options;
-
-    // Parse data URI if present (e.g., "data:image/png;base64,iVBORw0...")
+    } = opts;
     if (base64Data.startsWith('data:')) {
-      const matches = base64Data.match(/^data:([^;]+);base64,(.+)$/);
-      if (matches && matches[2]) {
-        base64Data = matches[2];
-
-        // Auto-detect file extension from MIME type if fileName not provided
-        if (!fileName && matches[1]) {
-          const mimeType = matches[1];
-          const ext = mimeType.split('/')[1] || 'bin';
-          fileName = `file_${Date.now()}.${ext}`;
-        }
-      } else {
-        return {
-          success: false,
-          error: 'Invalid data URI format. Expected: data:<mimetype>;base64,<data>'
-        };
+      const m = base64Data.match(/^data:([^;]+);base64,(.+)$/);
+      if (m && m[2]) {
+        base64Data = m[2];
+        if (!fileName && m[1]) fileName = `file_${Date.now()}.${m[1].split('/')[1] || 'bin'}`;
       }
     }
-    const result = await FileToolkitModule.saveBase64AsFile({
+    return await FileToolkitModule.saveBase64AsFile({
       base64Data,
       fileName,
       destination
     });
-    return result;
-  } catch (error) {
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-// ─── urlToBase64 ──────────────────────────────────────────────────────────────
-
-/**
- * Convert a web URL (image, video, gif, etc.) to base64 string.
- * Downloads the file and returns both the base64 string and data URI format.
- *
- * @example
- * ```typescript
- * // Convert image to base64
- * const result = await urlToBase64({
- *   url: 'https://example.com/photo.jpg',
- *   headers: { Authorization: 'Bearer token' }
- * });
- *
- * if (result.success) {
- *   console.log('Base64:', result.base64);
- *   console.log('Data URI:', result.dataUri);
- *   console.log('MIME Type:', result.mimeType);
- * }
- * ```
- */
-export async function urlToBase64(options) {
+export async function urlToBase64(opts) {
   try {
-    const result = await FileToolkitModule.urlToBase64({
-      url: options.url,
-      headers: options.headers
-    });
-    return result;
-  } catch (error) {
+    return await FileToolkitModule.urlToBase64(opts);
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-// ─── shareFile ────────────────────────────────────────────────────────────────
-
-/**
- * Share a file with other apps using the native share dialog.
- * Opens the system share sheet on iOS and share chooser on Android.
- *
- * @example
- * ```typescript
- * const result = await shareFile({
- *   filePath: '/path/to/document.pdf',
- *   title: 'Share Document',
- *   subject: 'Check out this file'
- * });
- *
- * if (result.success) {
- *   console.log('File shared successfully');
- * }
- * ```
- */
-export async function shareFile(options) {
+export async function shareFile(opts) {
   try {
-    const result = await FileToolkitModule.shareFile(options.filePath, {
-      title: options.title,
-      subject: options.subject
+    return await FileToolkitModule.shareFile(opts.filePath, {
+      title: opts.title,
+      subject: opts.subject
     });
-    return result;
-  } catch (error) {
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-// ─── openFile ─────────────────────────────────────────────────────────────────
-
-/**
- * Open a file with the default app or app chooser.
- * On iOS, displays a preview or shows apps that can handle the file.
- * On Android, opens with the default app or shows app chooser.
- *
- * @example
- * ```typescript
- * const result = await openFile({
- *   filePath: '/path/to/document.pdf',
- *   mimeType: 'application/pdf' // optional, auto-detected if not provided
- * });
- *
- * if (result.success) {
- *   console.log('File opened successfully');
- * }
- * ```
- */
-export async function openFile(options) {
+export async function openFile(opts) {
   try {
-    const result = await FileToolkitModule.openFile(options.filePath, options.mimeType || '');
-    return result;
-  } catch (error) {
+    return await FileToolkitModule.openFile(opts.filePath, opts.mimeType || '');
+  } catch (err) {
     return {
       success: false,
-      error: error?.message || 'UNKNOWN_ERROR'
+      error: err.message || 'UNKNOWN_ERROR'
     };
   }
 }
-
-// ─── Zip / Unzip ─────────────────────────────────────────────────────────────
-
-/**
- * Extract a ZIP archive to a destination directory.
- *
- * Uses `java.util.zip` on Android and zlib (system framework) on iOS.
- * No third-party dependency required.
- *
- * @param sourcePath Absolute path to the `.zip` file
- * @param destDir    Absolute path to the directory where files will be extracted.
- *                   The directory is created automatically if it does not exist.
- *
- * @example
- * ```ts
- * const result = await unzip(
- *   '/path/to/archive.zip',
- *   '/path/to/output-folder'
- * );
- *
- * if (result.success) {
- *   console.log('Extracted files:', result.files);
- * }
- * ```
- */
-export async function unzip(sourcePath, destDir) {
+export async function unzip(s, d) {
   try {
-    const result = await FileToolkitSpec.unzip(sourcePath, destDir);
-    return result;
-  } catch (error) {
+    return await FileToolkitModule.unzip(s, d);
+  } catch {
     return {
       success: false,
-      error: error?.message || 'UNZIP_ERROR'
+      error: 'UNZIP_ERROR'
     };
   }
 }
-
-/**
- * Create a ZIP archive from a file or directory.
- *
- * Uses `java.util.zip` on Android and zlib (system framework) on iOS.
- * No third-party dependency required.
- *
- * @param sourcePath Absolute path to the file or directory to compress
- * @param destPath   Absolute path for the output `.zip` file.
- *                   Parent directory is created automatically if needed.
- *
- * @example
- * ```ts
- * // Zip a single file
- * const result = await zip(
- *   '/path/to/document.pdf',
- *   '/path/to/document.zip'
- * );
- *
- * // Zip an entire directory
- * const result = await zip(
- *   '/path/to/my-folder',
- *   '/path/to/my-folder.zip'
- * );
- *
- * if (result.success) {
- *   console.log('Archive created at:', result.zipPath);
- * }
- * ```
- */
-export async function zip(sourcePath, destPath) {
+export async function zip(s, d) {
   try {
-    const result = await FileToolkitSpec.zip(sourcePath, destPath);
-    return result;
-  } catch (error) {
+    return await FileToolkitModule.zip(s, d);
+  } catch {
     return {
       success: false,
-      error: error?.message || 'ZIP_ERROR'
+      error: 'ZIP_ERROR'
     };
   }
 }
-
-// ─── useDownload hook ─────────────────────────────────────────────────────────
-
-/**
- * React hook for managing a single download with built-in state.
- *
- * Tracks status, rich progress (percent, speed, ETA), and the final result.
- * Exposes `pause`, `resume`, and `cancel` controls tied to the active download.
- *
- * @example
- * ```tsx
- * function DownloadButton() {
- *   const { start, pause, resume, cancel, status, progress, result } = useDownload();
- *
- *   return (
- *     <View>
- *       <Button
- *         title="Download"
- *         onPress={() => start({ url: 'https://example.com/file.zip' })}
- *       />
- *
- *       {status === 'downloading' && progress && (
- *         <View>
- *           <Text>{progress.percent.toFixed(1)}%</Text>
- *           <Text>Speed: {(progress.speedBps / 1024).toFixed(1)} KB/s</Text>
- *           <Text>ETA: {progress.etaSeconds.toFixed(0)}s</Text>
- *           <ProgressBar value={progress.percent / 100} />
- *           <Button title="Pause" onPress={pause} />
- *         </View>
- *       )}
- *
- *       {status === 'paused' && (
- *         <Button title="Resume" onPress={resume} />
- *       )}
- *
- *       {status === 'done' && result?.success && (
- *         <Text>Saved to: {result.filePath}</Text>
- *       )}
- *
- *       {status === 'error' && (
- *         <Text>Error: {result?.error}</Text>
- *       )}
- *     </View>
- *   );
- * }
- * ```
- */
 export function useDownload() {
   const [status, setStatus] = useState('idle');
   const [progress, setProgress] = useState(null);
   const [result, setResult] = useState(null);
   const [downloadId, setDownloadId] = useState(null);
   const downloadIdRef = useRef(null);
-  const start = useCallback(async options => {
+  const start = useCallback(async opts => {
+    const id = opts.downloadId || _generateId();
     setStatus('downloading');
     setProgress(null);
     setResult(null);
-    setDownloadId(null);
-    downloadIdRef.current = null;
+    setDownloadId(id);
+    downloadIdRef.current = id;
     const res = await download({
-      ...options,
-      onProgress: info => {
-        setProgress(info);
-        options.onProgress?.(info);
+      ...opts,
+      downloadId: id,
+      onProgress: p => {
+        setProgress(p);
+        opts.onProgress?.(p);
       }
     });
-    if (res.downloadId) {
-      downloadIdRef.current = res.downloadId;
-      setDownloadId(res.downloadId);
-    }
     setResult(res);
-    const isBackgroundPending = !!options.background && !!res.success && !!res.downloadId && !res.filePath;
-    setStatus(isBackgroundPending ? 'downloading' : res.success ? 'done' : 'error');
+    setStatus(!!opts.background && !!res.success && !!res.downloadId && !res.filePath ? 'downloading' : res.success ? 'done' : 'error');
     return res;
   }, []);
   const pause = useCallback(async () => {