rn-file-toolkit 1.0.5 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +18 -8
  2. package/package.json +2 -1
package/README.md CHANGED
@@ -50,16 +50,26 @@ Most React Native file solutions (`rn-fetch-blob`, `react-native-fs`) are fragme
50
50
 
51
51
  ---
52
52
 
53
- ## 🤔 Why not Expo FileSystem?
53
+ ## 🥊 How does it compare?
54
54
 
55
- Many developers looking for an **"expo-file-system alternative"** or a **"better react native download manager"** come here. While Expo FileSystem is a great tool for basic file operations, `rn-file-toolkit` is built specifically to handle complex, real-world file management scenarios:
55
+ If you've been working with React Native for a while, you've probably used `rn-fetch-blob` or `react-native-fs`. While they were fantastic tools back in the day, they haven't aged well and often struggle with modern requirements like seamless Expo integration or background persistence. You might have also tried `expo-file-system`, which is great for the basics but starts to fall short when you need smart queueing or multipart uploads.
56
56
 
57
- - **Queueing & Concurrency:** Built-in smart queueing allows you to cap concurrent downloads and set priorities without writing complex JavaScript wrappers.
58
- - **Native Download/Upload Managers:** We hook directly into OS-level managers (`URLSession` on iOS, `DownloadManager` on Android) for maximum reliability and battery efficiency.
59
- - **Auto-Retries & Resiliency:** Native implementations handle network drops with exponential backoff and HTTP resume automatically.
60
- - **Multipart Uploads:** Robust, memory-efficient multipart uploads for large media are built right in.
61
- - **Drop-in React Hooks:** Provides a `useDownload` hook out-of-the-box for instant progress tracking, speed, ETA, and state controls.
62
- - **Background Persistence:** Downloads and uploads survive app suspension and backgrounding, automatically re-attaching when the app resumes.
57
+ We built **rn-file-toolkit** because we were tired of stitching together multiple unmaintained libraries just to download a file reliably in the background while keeping the UI updated.
58
+
59
+ Here's how it stacks up against the crowd:
60
+
61
+ | Feature | `rn-file-toolkit` | `react-native-fs` & `rn-fetch-blob` | `expo-file-system` |
62
+ | :--- | :---: | :---: | :---: |
63
+ | **Background Persistence** | ✅ Yes | ⚠️ Spotty / Legacy | ✅ Yes |
64
+ | **Smart Queueing & Concurrency** | ✅ Built-in | ❌ Write your own | ❌ Write your own |
65
+ | **React Hooks (`useDownload`)** | ✅ Out-of-the-box | ❌ Manual | ❌ Manual |
66
+ | **Auto-Retries & Resumption** | ✅ Yes | ❌ Manual | ⚠️ Basic resume only |
67
+ | **Multipart Uploads** | ✅ Yes (Memory efficient) | ⚠️ Basic support | ✅ Yes |
68
+ | **Expo Support (Custom Dev Client)**| ✅ Seamless | ❌ Requires heavy config | ✅ Seamless |
69
+ | **Zero 3rd-party Dependencies** | ✅ Yes | ❌ Varies | ✅ Yes |
70
+ | **Active Maintenance** | ✅ Yes | ❌ Largely unmaintained | ✅ Yes |
71
+
72
+ We hook directly into OS-level managers (`URLSession` on iOS, `DownloadManager` on Android) to provide maximum reliability, battery efficiency, and zero headaches.
63
73
 
64
74
  ---
65
75
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rn-file-toolkit",
3
- "version": "1.0.5",
3
+ "version": "1.0.6",
4
4
  "description": "The ultimate native file management toolkit for React Native. Features background downloads, resumable uploads, filesystem operations, queues, zip/unzip, and media utilities with zero third-party dependencies.",
5
5
  "main": "./lib/commonjs/index.js",
6
6
  "module": "./lib/module/index.js",
@@ -55,6 +55,7 @@
55
55
  "android",
56
56
  "download",
57
57
  "downloader",
58
+ "file-toolkit",
58
59
  "file-download",
59
60
  "background-download",
60
61
  "download-manager",