rn-file-toolkit 1.0.3 → 1.0.4
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.
- package/README.md +16 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
## 📖 Table of Contents
|
|
19
19
|
- [Why rn-file-toolkit?](#-why-rn-file-toolkit)
|
|
20
|
+
- [Why not Expo FileSystem?](#-why-not-expo-filesystem)
|
|
20
21
|
- [Installation](#-installation)
|
|
21
22
|
- [Quick Start: `useDownload`](#-quick-start-usedownload)
|
|
22
23
|
- [Core APIs](#-core-apis)
|
|
@@ -33,7 +34,7 @@
|
|
|
33
34
|
|
|
34
35
|
## 🚀 Why rn-file-toolkit?
|
|
35
36
|
|
|
36
|
-
Most React Native file solutions (`rn-fetch-blob`, `react-native-fs`) are fragmented, lightly maintained, or lack modern features. **rn-file-toolkit** gives you a unified, **TurboModule-
|
|
37
|
+
Most React Native file solutions (`rn-fetch-blob`, `react-native-fs`) are fragmented, lightly maintained, or lack modern features. **rn-file-toolkit** gives you a unified, **TurboModule-compatible** API utilizing OS-native managers (`URLSession` on iOS, `DownloadManager` on Android) for reliable, battery-efficient operations.
|
|
37
38
|
|
|
38
39
|
### ✨ Highlights
|
|
39
40
|
- 🪝 **Drop-in React Hooks:** Built-in state management (`useDownload`) for progress and controls.
|
|
@@ -46,6 +47,19 @@ Most React Native file solutions (`rn-fetch-blob`, `react-native-fs`) are fragme
|
|
|
46
47
|
|
|
47
48
|
---
|
|
48
49
|
|
|
50
|
+
## 🤔 Why not Expo FileSystem?
|
|
51
|
+
|
|
52
|
+
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:
|
|
53
|
+
|
|
54
|
+
- **Queueing & Concurrency:** Built-in smart queueing allows you to cap concurrent downloads and set priorities without writing complex JavaScript wrappers.
|
|
55
|
+
- **Native Download/Upload Managers:** We hook directly into OS-level managers (`URLSession` on iOS, `DownloadManager` on Android) for maximum reliability and battery efficiency.
|
|
56
|
+
- **Auto-Retries & Resiliency:** Native implementations handle network drops with exponential backoff and HTTP resume automatically.
|
|
57
|
+
- **Multipart Uploads:** Robust, memory-efficient multipart uploads for large media are built right in.
|
|
58
|
+
- **Drop-in React Hooks:** Provides a `useDownload` hook out-of-the-box for instant progress tracking, speed, ETA, and state controls.
|
|
59
|
+
- **Background Persistence:** Downloads and uploads survive app suspension and backgrounding, automatically re-attaching when the app resumes.
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
49
63
|
## 📦 Installation
|
|
50
64
|
|
|
51
65
|
```bash
|
|
@@ -238,5 +252,5 @@ Contributions are welcome! If you find a bug or want to request a feature, pleas
|
|
|
238
252
|
---
|
|
239
253
|
|
|
240
254
|
<div align="center">
|
|
241
|
-
<i>Built with ❤️ for the React Native community by <a href="https://github.com/
|
|
255
|
+
<i>Built with ❤️ for the React Native community by <a href="https://github.com/chavanRk">Rohit Chavan</a></i>
|
|
242
256
|
</div>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "rn-file-toolkit",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.4",
|
|
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",
|