react-native-blob-util 0.14.1 → 0.15.0

package/README.md

@@ -303,6 +303,26 @@ ReactNativeBlobUtil
 
 **These files won't be removed automatically, please refer to [Cache File Management](#user-content-cache-file-management)**
 
+**Use File Transformer**
+
+If you need to perform any processing on the bytes prior to it being written into storage (e.g. if you want it to be encrypted) then you can use `transform` option.  NOTE: you will need to set a transformer on the libray (see [Setting a File Transformer](#Setting-A-File-Transformer))
+
+```js
+ReactNativeBlobUtil
+        .config({
+            // response data will be saved to this path if it has access right.
+            path: dirs.DocumentDir + '/path-to-file.anything',
+            transform: true
+        })
+        .fetch('GET', 'http://www.example.com/file/example.zip', {
+            //some headers ..
+        })
+        .then((res) => {
+            // the path should be dirs.DocumentDir + 'path-to-file.anything'
+            console.log('The file saved to ', res.path())
+        })
+```
+
 #### Upload example : Dropbox [files-upload](https://www.dropbox.com/developers/documentation/http/documentation#files-upload) API
 
 `react-native-blob-util` will convert the base64 string in `body` to binary format using native API, this process is done in a separated thread so that it won't block your GUI.
@@ -676,6 +696,14 @@ await ReactNativeBlobUtil.MediaCollection.writeToMediafile('content://....', //
 );
 ````
 
+Copies and tranforms data from a file in the apps storage to an existing entry of the Media Store. NOTE: you must set a transformer on the file in order for the transformation to happen (see [Setting a File Transformer](#Setting-A-File-Transformer)).
+
+````js
+await ReactNativeBlobUtil.MediaCollection.writeToMediafileWithTransform('content://....', // content uri of the entry in the media storage
+        localpath // path to the file that should be copied
+);
+````
+
 #### copyToInternal
 Copies an entry form the media storage to the apps internal storage.
 ````js
@@ -697,8 +725,10 @@ File Access APIs
 - [dirs](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#dirs)
 - [createFile](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#createfilepath-data-encodingpromise)
 - [writeFile (0.6.0)](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#writefilepathstring-contentstring--array-encodingstring-appendbooleanpromise)
+- writeFileWithTransform
 - [appendFile (0.6.0) ](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#appendfilepathstring-contentstring--arraynumber-encodingstring-promisenumber)
 - [readFile (0.6.0)](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#readfilepath-encodingpromise)
+- readFileWithTransform
 - [readStream](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#readstreampath-encoding-buffersize-interval-promisernfbreadstream)
 - [hash (0.10.9)](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#hashpath-algorithm-promise)
 - [writeStream](https://github.com/RonRadtke/react-native-blob-util/wiki/File-System-Access-API#writestreampathstring-encodingstringpromise)
@@ -903,6 +933,10 @@ ReactNativeBlobUtil.config({
         })
 ```
 
+### Transform Files
+
+Sometimes you may need the files to be transformed after reading from storage or before writing into storage (eg encryption/decyrption). In order to perform the transformations, use `readFileWithTransform` and `writeFileWithTransform`. NOTE: you must set a transformer on the file in order for the transformation to happen (see [Setting a File Transformer](#Setting-A-File-Transformer)).
+
 ## Web API Polyfills
 
 After `0.8.0` we've made some [Web API polyfills](https://github.com/RonRadtke/react-native-blob-util/wiki/Web-API-Polyfills-(experimental)) that makes some browser-based library available in RN.
@@ -910,6 +944,48 @@ After `0.8.0` we've made some [Web API polyfills](https://github.com/RonRadtke/r
 - Blob
 - XMLHttpRequest (Use our implementation if you're going to use it with Blob)
 
+
+## Setting A File Transformer
+
+Setting a file transformer will allow you to specify how data should be transformed whenever the library is writing into storage or reading from storage. A use case for this is if you want the files handled by this library to be encrypted. 
+
+If you want to use a file transformer, you must implement an interface defined in:
+
+[ReactNativeBlobUtilFileTransformer.h (iOS)](/ios/ReactNativeBlobUtilFileTransformer.h)
+
+[ReactNativeBlobUtilFileTransformer.java (Android)](/android/src/main/java/com/ReactNativeBlobUtil/ReactNativeBlobUtilFileTransformer.java)
+
+Then you set the File Transformer during app startup
+
+Android:
+```java
+public class MainApplication extends Application implements ReactApplication {
+    ...
+    @Override
+    public void onCreate() {
+       ...
+       ReactNativeBlobUtilFileTransformer.sharedFileTransformer = new MyCustomEncryptor(); 
+       ...
+    }
+```
+
+iOS:
+```m
+@implementation AppDelegate
+...
+- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
+{
+    ...
+    [ReactNativeBlobUtilFileTransformer setFileTransformer: MyCustomEncryptor.new];
+    ...
+}
+```
+
+Here are the places where the transformer would apply 
+- Reading a file from the file system  
+- Writing a file into the file system
+- Http response is downloaded to storage directly
+
 ## Performance Tips
 
 **Read Stream and Progress Event Overhead**

package/android/src/main/java/com/ReactNativeBlobUtil/ReactNativeBlobUtil.java

@@ -233,11 +233,11 @@ public class ReactNativeBlobUtil extends ReactContextBaseJavaModule {
     }
 
     @ReactMethod
-    public void readFile(final String path, final String encoding, final Promise promise) {
+    public void readFile(final String path, final String encoding, final boolean transformFile, final Promise promise) {
         threadPool.execute(new Runnable() {
             @Override
             public void run() {
-                ReactNativeBlobUtilFS.readFile(path, encoding, promise);
+                ReactNativeBlobUtilFS.readFile(path, encoding, transformFile, promise);
             }
         });
     }
@@ -253,11 +253,11 @@ public class ReactNativeBlobUtil extends ReactContextBaseJavaModule {
     }
 
     @ReactMethod
-    public void writeFile(final String path, final String encoding, final String data, final boolean append, final Promise promise) {
+    public void writeFile(final String path, final String encoding, final String data, final boolean transformFile, final boolean append, final Promise promise) {
         threadPool.execute(new Runnable() {
             @Override
             public void run() {
-                ReactNativeBlobUtilFS.writeFile(path, encoding, data, append, promise);
+                ReactNativeBlobUtilFS.writeFile(path, encoding, data, transformFile, append, promise);
             }
         });
     }
@@ -438,8 +438,8 @@ public class ReactNativeBlobUtil extends ReactContextBaseJavaModule {
     }
 
     @ReactMethod
-    public void writeToMediaFile(String fileUri, String path, Promise promise) {
-        boolean res = ReactNativeBlobUtilMediaCollection.writeToMediaFile(Uri.parse(fileUri), path, promise);
+    public void writeToMediaFile(String fileUri, String path, boolean transformFile, Promise promise) {
+        boolean res = ReactNativeBlobUtilMediaCollection.writeToMediaFile(Uri.parse(fileUri), path, transformFile, promise);
         if(res) promise.resolve("Success");
     }
 
@@ -478,7 +478,7 @@ public class ReactNativeBlobUtil extends ReactContextBaseJavaModule {
             return;
         }
 
-        boolean res = ReactNativeBlobUtilMediaCollection.writeToMediaFile(fileuri, path, promise);
+        boolean res = ReactNativeBlobUtilMediaCollection.writeToMediaFile(fileuri, path, false, promise);
         if(res) promise.resolve(fileuri.toString());
     }
 

package/android/src/main/java/com/ReactNativeBlobUtil/ReactNativeBlobUtilConfig.java

@@ -8,6 +8,7 @@ import java.util.Locale;
 class ReactNativeBlobUtilConfig {
 
     public Boolean fileCache;
+    public Boolean transformFile;
     public String path;
     public String appendExt;
     public ReadableMap addAndroidDownloads;
@@ -26,6 +27,7 @@ class ReactNativeBlobUtilConfig {
         if (options == null)
             return;
         this.fileCache = options.hasKey("fileCache") && options.getBoolean("fileCache");
+        this.transformFile = options.hasKey("transformFile") ? options.getBoolean("transformFile") : false;
         this.path = options.hasKey("path") ? options.getString("path") : null;
         this.appendExt = options.hasKey("appendExt") ? options.getString("appendExt") : "";
         this.trusty = options.hasKey("trusty") && options.getBoolean("trusty");

package/android/src/main/java/com/ReactNativeBlobUtil/ReactNativeBlobUtilFS.java

@@ -54,6 +54,7 @@ class ReactNativeBlobUtilFS {
     static boolean writeFile(String path, String encoding, String data, final boolean append) {
         try {
             int written;
+            path = ReactNativeBlobUtilUtils.normalizePath(path);
             File f = new File(path);
             File dir = f.getParentFile();
             if (!f.exists()) {
@@ -121,7 +122,7 @@ class ReactNativeBlobUtilFS {
      * @param data     Array passed from JS context.
      * @param promise  RCT Promise
      */
-    static void writeFile(String path, String encoding, String data, final boolean append, final Promise promise) {
+    static void writeFile(String path, String encoding, String data, final boolean transformFile, final boolean append, final Promise promise) {
         try {
             int written;
             File f = new File(path);
@@ -169,6 +170,12 @@ class ReactNativeBlobUtilFS {
                 }
             } else {
                 byte[] bytes = ReactNativeBlobUtilUtils.stringToBytes(data, encoding);
+                if (transformFile) {
+                    if (ReactNativeBlobUtilFileTransformer.sharedFileTransformer == null) {
+                        throw new IllegalStateException("Write file with transform was specified but the shared file transformer is not set");
+                    }
+                    bytes = ReactNativeBlobUtilFileTransformer.sharedFileTransformer.onWriteFile(bytes);
+                }
                 FileOutputStream fout = new FileOutputStream(f, append);
                 try {
                     fout.write(bytes);
@@ -237,7 +244,7 @@ class ReactNativeBlobUtilFS {
      * @param encoding Encoding of read stream.
      * @param promise  JS promise
      */
-    static void readFile(String path, String encoding, final Promise promise) {
+    static void readFile(String path, String encoding, final boolean transformFile, final Promise promise) {
         String resolved = ReactNativeBlobUtilUtils.normalizePath(path);
         if (resolved != null)
             path = resolved;
@@ -280,6 +287,13 @@ class ReactNativeBlobUtilFS {
                 return;
             }
 
+            if (transformFile) {
+                if (ReactNativeBlobUtilFileTransformer.sharedFileTransformer == null) {
+                    throw new IllegalStateException("Read file with transform was specified but the shared file transformer is not set");
+                }
+                bytes = ReactNativeBlobUtilFileTransformer.sharedFileTransformer.onReadFile(bytes);
+            }
+
             switch (encoding.toLowerCase(Locale.ROOT)) {
                 case "base64":
                     promise.resolve(Base64.encodeToString(bytes, Base64.NO_WRAP));
@@ -441,6 +455,7 @@ class ReactNativeBlobUtilFS {
      * @param promise JS promise
      */
     static void mkdir(String path, Promise promise) {
+        path = ReactNativeBlobUtilUtils.normalizePath(path);
         File dest = new File(path);
         if (dest.exists()) {
             promise.reject("EEXIST", (dest.isDirectory() ? "Folder" : "File") + " '" + path + "' already exists");
@@ -468,6 +483,7 @@ class ReactNativeBlobUtilFS {
      */
     static void cp(String path, String dest, Callback callback) {
         path = ReactNativeBlobUtilUtils.normalizePath(path);
+        dest = ReactNativeBlobUtilUtils.normalizePath(dest);
         InputStream in = null;
         OutputStream out = null;
         String message = "";
@@ -524,6 +540,8 @@ class ReactNativeBlobUtilFS {
      * @param callback JS context callback
      */
     static void mv(String path, String dest, Callback callback) {
+        path = ReactNativeBlobUtilUtils.normalizePath(path);
+        dest = ReactNativeBlobUtilUtils.normalizePath(dest);
         File src = new File(path);
         if (!src.exists()) {
             callback.invoke("Source file at path `" + path + "` does not exist");
@@ -627,6 +645,7 @@ class ReactNativeBlobUtilFS {
     static void slice(String path, String dest, int start, int end, String encode, Promise promise) {
         try {
             path = ReactNativeBlobUtilUtils.normalizePath(path);
+            dest = ReactNativeBlobUtilUtils.normalizePath(dest);
             File source = new File(path);
             if (source.isDirectory()) {
                 promise.reject("EISDIR", "Expecting a file but '" + path + "' is a directory");
@@ -790,6 +809,8 @@ class ReactNativeBlobUtilFS {
                 promise.reject("EINVAL", "Invalid algorithm '" + algorithm + "', must be one of md5, sha1, sha224, sha256, sha384, sha512");
                 return;
             }
+            
+            path = ReactNativeBlobUtilUtils.normalizePath(path);
 
             File file = new File(path);
 
@@ -837,6 +858,7 @@ class ReactNativeBlobUtilFS {
      */
     static void createFile(String path, String data, String encoding, Promise promise) {
         try {
+            path = ReactNativeBlobUtilUtils.normalizePath(path);
             File dest = new File(path);
             boolean created = dest.createNewFile();
             if (encoding.equals(ReactNativeBlobUtilConst.DATA_ENCODE_URI)) {
@@ -879,6 +901,7 @@ class ReactNativeBlobUtilFS {
      */
     static void createFileASCII(String path, ReadableArray data, Promise promise) {
         try {
+            path = ReactNativeBlobUtilUtils.normalizePath(path);
             File dest = new File(path);
             boolean created = dest.createNewFile();
             if (!created) {

package/android/src/main/java/com/ReactNativeBlobUtil/ReactNativeBlobUtilFileTransformer.java

@@ -0,0 +1,10 @@
+package com.ReactNativeBlobUtil;
+
+public class ReactNativeBlobUtilFileTransformer {
+    public interface FileTransformer {
+        public byte[] onWriteFile(byte[] data);
+        public byte[] onReadFile(byte[] data);
+    }
+
+    public static ReactNativeBlobUtilFileTransformer.FileTransformer sharedFileTransformer;
+}

package/android/src/main/java/com/ReactNativeBlobUtil/ReactNativeBlobUtilMediaCollection.java

@@ -124,7 +124,7 @@ public class ReactNativeBlobUtilMediaCollection {
         return null;
     }
 
-    public static boolean writeToMediaFile(Uri fileUri, String data, Promise promise) {
+    public static boolean writeToMediaFile(Uri fileUri, String data, boolean transformFile, Promise promise) {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
             try {
                 Context appCtx = ReactNativeBlobUtil.RCTContext.getApplicationContext();
@@ -151,16 +151,31 @@ public class ReactNativeBlobUtilMediaCollection {
                             promise.reject("ENOENT", "No such file ('" + normalizedData + "')");
                             return false;
                         }
-                        byte[] buf = new byte[10240];
-                        int read;
+
 
                         FileInputStream fin = new FileInputStream(src);
                         FileOutputStream out = new FileOutputStream(descr.getFileDescriptor());
 
-                        while ((read = fin.read(buf)) > 0) {
-                            out.write(buf, 0, read);
+                        if (transformFile) {
+                            // in order to transform file, we must load the entire file onto memory
+                            int length = (int) src.length();
+                            byte[] bytes = new byte[length];
+                            fin.read(bytes);
+                            if (ReactNativeBlobUtilFileTransformer.sharedFileTransformer == null) {
+                                throw new IllegalStateException("Write to media file with transform was specified but the shared file transformer is not set");
+                            }
+                            byte[] transformedBytes = ReactNativeBlobUtilFileTransformer.sharedFileTransformer.onWriteFile(bytes);
+                            out.write(transformedBytes);
+                        } else  {
+                            byte[] buf = new byte[10240];
+                            int read;
+
+                            while ((read = fin.read(buf)) > 0) {
+                                out.write(buf, 0, read);
+                            }
                         }
 
+
                         fin.close();
                         out.close();
                         descr.close();

package/android/src/main/java/com/ReactNativeBlobUtil/ReactNativeBlobUtilReq.java

@@ -87,6 +87,12 @@ public class ReactNativeBlobUtilReq extends BroadcastReceiver implements Runnabl
         BASE64
     }
 
+    private boolean shouldTransformFile() {
+        return this.options.transformFile &&
+            // Can only process if it's written to a file
+            (this.options.fileCache || this.options.path != null);
+    }
+
     public static HashMap<String, Call> taskTable = new HashMap<>();
     public static HashMap<String, Long> androidDownloadManagerTaskTable = new HashMap<>();
     static HashMap<String, ReactNativeBlobUtilProgressConfig> progressReport = new HashMap<>();
@@ -124,7 +130,9 @@ public class ReactNativeBlobUtilReq extends BroadcastReceiver implements Runnabl
         this.rawRequestBodyArray = arrayBody;
         this.client = client;
 
-        if (this.options.fileCache || this.options.path != null)
+        // If transformFile is specified, we first want to get the response back in memory so we can
+        // encrypt it wholesale and at that point, write it into the file storage.
+        if((this.options.fileCache || this.options.path != null) && !this.shouldTransformFile())
             responseType = ResponseType.FileStorage;
         else
             responseType = ResponseType.KeepInMemory;
@@ -557,6 +565,26 @@ public class ReactNativeBlobUtilReq extends BroadcastReceiver implements Runnabl
                     // response data directly pass to JS context as string.
                     else {
                         byte[] b = resp.body().bytes();
+                        // If process file option is turned on, we first keep response in memory and then stream that content
+                        // after processing
+                        if (this.shouldTransformFile()) {
+                            if (ReactNativeBlobUtilFileTransformer.sharedFileTransformer == null) {
+                                throw new IllegalStateException("Write file with transform was specified but the shared file transformer is not set");
+                            }
+                            this.destPath = this.destPath.replace("?append=true", "");
+                            File file = new File(this.destPath);
+                            if (!file.exists()) {
+                                file.createNewFile();
+                            }
+                            try (FileOutputStream fos = new FileOutputStream(file)) {
+                                fos.write(ReactNativeBlobUtilFileTransformer.sharedFileTransformer.onWriteFile(b));
+                            } catch(Exception e) {
+                                callback.invoke("Error from file transformer:" + e.getLocalizedMessage(), null);
+                                return;
+                            }
+                            callback.invoke(null, ReactNativeBlobUtilConst.RNFB_RESPONSE_PATH, this.destPath);
+                            return;
+                        }
                         if (responseFormat == ResponseFormat.BASE64) {
                             callback.invoke(null, ReactNativeBlobUtilConst.RNFB_RESPONSE_BASE64, android.util.Base64.encodeToString(b, Base64.NO_WRAP));
                             return;

package/android/src/main/java/com/ReactNativeBlobUtil/Response/ReactNativeBlobUtilFileResp.java

@@ -72,6 +72,10 @@ public class ReactNativeBlobUtilFileResp extends ResponseBody {
 
     @Override
     public long contentLength() {
+        if (originalBody.contentLength() > Integer.MAX_VALUE) {
+            // This is a workaround for a bug Okio buffer where it can't handle larger than int.
+            return Integer.MAX_VALUE;
+        }
         return originalBody.contentLength();
     }
 

package/class/ReactNativeBlobUtilBlobResponse.js

@@ -3,7 +3,7 @@ import fs from "../fs";
 import Blob from "../polyfill/Blob";
 import ReactNativeBlobUtilSession from "./ReactNativeBlobUtilSession";
 import URIUtil from "../utils/uri";
-
+import base64 from "base-64";
 /**
  * ReactNativeBlobUtil response object class.
  */

package/fs.js

@@ -160,7 +160,20 @@ function readFile(path: string, encoding: string = 'utf8'): Promise<any> {
     if (typeof path !== 'string') {
         return Promise.reject(addCode('EINVAL', new TypeError('Missing argument "path" ')));
     }
-    return ReactNativeBlobUtil.readFile(path, encoding);
+    return ReactNativeBlobUtil.readFile(path, encoding, false);
+}
+
+/**
+ * Reads the file, then transforms it before returning the content
+ * @param  {string} path Path of the file.
+ * @param  {'base64' | 'utf8' | 'ascii'} encoding Encoding of read stream.
+ * @return {Promise<Array<number> | string>}
+ */
+function readFileWithTransform(path: string, encoding: string = 'utf8'): Promise<any> {
+    if (typeof path !== 'string') {
+        return Promise.reject(addCode('EINVAL', new TypeError('Missing argument "path" ')))
+    }
+    return ReactNativeBlobUtil.readFile(path, encoding, true);
 }
 
 /**
@@ -186,7 +199,31 @@ function writeFile(path: string, data: string | Array<number>, encoding: ?string
             return Promise.reject(addCode('EINVAL', new TypeError(`"data" must be a String when encoding is "utf8" or "base64", but it is "${typeof data}"`)));
         }
         else
-            return ReactNativeBlobUtil.writeFile(path, encoding, data, false);
+            return ReactNativeBlobUtil.writeFile(path, encoding, data, false, false);
+    }
+}
+
+/**
+ * Transforms the data and then writes to the file.
+ * @param  {string} path  Path of the file.
+ * @param  {string | number[]} data Data to write to the file.
+ * @param  {string} encoding Encoding of data (Optional).
+ * @return {Promise}
+ */
+function writeFileWithTransform(path: string, data: string | Array<number>, encoding: ?string = 'utf8'): Promise {
+    if (typeof path !== 'string') {
+        return Promise.reject(addCode('EINVAL', new TypeError('Missing argument "path" ')))
+    }
+    if (encoding.toLocaleLowerCase() === 'ascii') {
+        return Promise.reject(addCode('EINVAL', new TypeError('ascii is not supported for converted files')))
+    }
+    else {
+        if (typeof data !== 'string') {
+            return Promise.reject(addCode('EINVAL', new TypeError(`"data" must be a String when encoding is "utf8" or "base64", but it is "${typeof data}"`)))
+        }
+
+        else
+            return ReactNativeBlobUtil.writeFile(path, encoding, data, true, false)
     }
 }
 
@@ -206,7 +243,7 @@ function appendFile(path: string, data: string | Array<number>, encoding?: strin
             return Promise.reject(addCode('EINVAL'), new TypeError(`"data" must be a String when encoding is "utf8" or "base64", but it is "${typeof data}"`));
         }
         else
-            return ReactNativeBlobUtil.writeFile(path, encoding, data, true);
+            return ReactNativeBlobUtil.writeFile(path, encoding, data, false, true);
     }
 }
 
@@ -415,6 +452,8 @@ export default {
     cp,
     writeStream,
     writeFile,
+    writeFileWithTransform,
+    readFileWithTransform,
     appendFile,
     pathForAppGroup,
     syncPathAppGroup,

package/index.d.ts

@@ -399,6 +399,14 @@ export interface FS {
      */
     writeFile(path: string, data: string | number[], encoding?: Encoding): Promise<void>;
 
+    /**
+     * Processes the data and then writes to the file.
+     * @param  path  Path of the file.
+     * @param  data Data to write to the file.
+     * @param  encoding Encoding of data (Optional).
+     */
+     writeFileWithTransform(path: string, data: string | number[], encoding?: Encoding): Promise<void>;
+
     appendFile(path: string, data: string | number[], encoding?: Encoding | "uri"): Promise<number>;
 
     /**
@@ -408,6 +416,13 @@ export interface FS {
      */
     readFile(path: string, encoding: Encoding, bufferSize?: number): Promise<any>;
 
+    /**
+     * Reads from a file and then processes the data before returning
+     * @param  path Path of the file.
+     * @param  encoding Encoding of read stream.
+     */
+     readFileWithTransform(path: string, encoding: Encoding, bufferSize?: number): Promise<any>;
+
     /**
      * Check if file exists and if it is a folder.
      * @param  path Path to check
@@ -698,6 +713,13 @@ export interface ReactNativeBlobUtilConfig {
      */
     fileCache?: boolean;
 
+    /**
+     * Set this property to true if you want the data to be processed before it gets written onto disk.
+     * This only has effect if the FileTransformer has been registered and the library is configured to write
+     * response onto disk.
+     */
+    transformFile?: boolean;
+
     /**
      * Set this property to change temp file extension that created by fetch response data.
      */
@@ -808,6 +830,13 @@ export interface MediaCollection {
      */
     writeToMediafile(uri: string, path: string): Promise<string>
 
+    /**
+     * Copies and transforms an existing file to a mediastore file. Make sure FileTransformer is set
+     * @param uri URI of the destination mediastore file
+     * @param path Path to the existing file which should be copied
+     */
+    writeToMediafileWithTransform(uri: string, path: string): Promise<string>
+
     /**
      * Copies a file from the mediastore to the apps internal storage
      * @param contenturi URI of the mediastore file

package/ios/ReactNativeBlobUtil/ReactNativeBlobUtil.m

@@ -252,9 +252,9 @@ RCT_EXPORT_METHOD(exists:(NSString *)path callback:(RCTResponseSenderBlock)callb
 }
 
 #pragma mark - fs.writeFile
-RCT_EXPORT_METHOD(writeFile:(NSString *)path encoding:(NSString *)encoding data:(NSString *)data append:(BOOL)append resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXPORT_METHOD(writeFile:(NSString *)path encoding:(NSString *)encoding data:(NSString *)data transformFile:(BOOL)transformFile append:(BOOL)append resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 {
-    [ReactNativeBlobUtilFS writeFile:path encoding:[NSString stringWithString:encoding] data:data append:append resolver:resolve rejecter:reject];
+    [ReactNativeBlobUtilFS writeFile:path encoding:[NSString stringWithString:encoding] data:data transformFile:transformFile append:append resolver:resolve rejecter:reject];
 }
 
 #pragma mark - fs.writeArray
@@ -494,11 +494,12 @@ RCT_EXPORT_METHOD(mkdir:(NSString *)path resolver:(RCTPromiseResolveBlock)resolv
 #pragma mark - fs.readFile
 RCT_EXPORT_METHOD(readFile:(NSString *)path
                   encoding:(NSString *)encoding
+                  transformFile:(BOOL) transformFile
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 {
     
-    [ReactNativeBlobUtilFS readFile:path encoding:encoding onComplete:^(NSData * content, NSString * code, NSString * err) {
+    [ReactNativeBlobUtilFS readFile:path encoding:encoding transformFile:transformFile onComplete:^(NSData * content, NSString * code, NSString * err) {
         if(err != nil) {
             reject(code, err, nil);
             return;

package/ios/ReactNativeBlobUtil.xcodeproj/project.pbxproj

@@ -8,6 +8,7 @@
 
 /* Begin PBXBuildFile section */
 		8C4801A6200CF71700FED7ED /* ReactNativeBlobUtilRequest.m in Sources */ = {isa = PBXBuildFile; fileRef = 8C4801A5200CF71700FED7ED /* ReactNativeBlobUtilRequest.m */; };
+		9FD8D3C326F1736000009F35 /* ReactNativeBlobUtilFileTransformer.m in Sources */ = {isa = PBXBuildFile; fileRef = 9FD8D3C226F1736000009F35 /* ReactNativeBlobUtilFileTransformer.m */; };
 		A158F4271D052E49006FFD38 /* ReactNativeBlobUtilFS.m in Sources */ = {isa = PBXBuildFile; fileRef = A158F4261D052E49006FFD38 /* ReactNativeBlobUtilFS.m */; };
 		A158F42D1D0535BB006FFD38 /* ReactNativeBlobUtilConst.m in Sources */ = {isa = PBXBuildFile; fileRef = A158F42C1D0535BB006FFD38 /* ReactNativeBlobUtilConst.m */; };
 		A158F4301D0539DB006FFD38 /* ReactNativeBlobUtilNetwork.m in Sources */ = {isa = PBXBuildFile; fileRef = A158F42F1D0539DB006FFD38 /* ReactNativeBlobUtilNetwork.m */; };
@@ -32,6 +33,8 @@
 /* Begin PBXFileReference section */
 		8C4801A4200CF71700FED7ED /* ReactNativeBlobUtilRequest.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = ReactNativeBlobUtilRequest.h; sourceTree = "<group>"; };
 		8C4801A5200CF71700FED7ED /* ReactNativeBlobUtilRequest.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = ReactNativeBlobUtilRequest.m; sourceTree = "<group>"; };
+		9FD8D3C126F1709A00009F35 /* ReactNativeBlobUtilFileTransformer.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = ReactNativeBlobUtilFileTransformer.h; sourceTree = "<group>"; };
+		9FD8D3C226F1736000009F35 /* ReactNativeBlobUtilFileTransformer.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = ReactNativeBlobUtilFileTransformer.m; sourceTree = "<group>"; };
 		A158F4261D052E49006FFD38 /* ReactNativeBlobUtilFS.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = ReactNativeBlobUtilFS.m; sourceTree = "<group>"; };
 		A158F4281D052E57006FFD38 /* ReactNativeBlobUtilFS.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = ReactNativeBlobUtilFS.h; sourceTree = "<group>"; };
 		A158F4291D0534A9006FFD38 /* ReactNativeBlobUtilConst.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = ReactNativeBlobUtilConst.h; sourceTree = "<group>"; };
@@ -69,6 +72,8 @@
 		A15C30051CD25C330074CB35 = {
 			isa = PBXGroup;
 			children = (
+				9FD8D3C226F1736000009F35 /* ReactNativeBlobUtilFileTransformer.m */,
+				9FD8D3C126F1709A00009F35 /* ReactNativeBlobUtilFileTransformer.h */,
 				A19B48241D98102400E6868A /* ReactNativeBlobUtilProgress.m */,
 				A19B48231D98100800E6868A /* ReactNativeBlobUtilProgress.h */,
 				A1F950181D7E9134002A95A6 /* IOS7Polyfill.h */,
@@ -156,6 +161,7 @@
 				A166D1AA1CE0647A00273590 /* ReactNativeBlobUtil.h in Sources */,
 				8C4801A6200CF71700FED7ED /* ReactNativeBlobUtilRequest.m in Sources */,
 				A158F42D1D0535BB006FFD38 /* ReactNativeBlobUtilConst.m in Sources */,
+				9FD8D3C326F1736000009F35 /* ReactNativeBlobUtilFileTransformer.m in Sources */,
 				A158F4271D052E49006FFD38 /* ReactNativeBlobUtilFS.m in Sources */,
 				A158F4301D0539DB006FFD38 /* ReactNativeBlobUtilNetwork.m in Sources */,
 				A19B48251D98102400E6868A /* ReactNativeBlobUtilProgress.m in Sources */,

package/ios/ReactNativeBlobUtilConst.h

@@ -29,6 +29,7 @@ extern NSString *const AL_PREFIX;
 
 // config
 extern NSString *const CONFIG_USE_TEMP;
+extern NSString *const CONFIG_TRANSFORM_FILE;
 extern NSString *const CONFIG_FILE_PATH;
 extern NSString *const CONFIG_FILE_EXT;
 extern NSString *const CONFIG_TRUSTY;

package/ios/ReactNativeBlobUtilConst.m

@@ -13,6 +13,7 @@ NSString *const AL_PREFIX = @"assets-library://";
 
 // fetch configs
 NSString *const CONFIG_USE_TEMP = @"fileCache";
+NSString *const CONFIG_TRANSFORM_FILE = @"transformFile";
 NSString *const CONFIG_FILE_PATH = @"path";
 NSString *const CONFIG_FILE_EXT = @"appendExt";
 NSString *const CONFIG_TRUSTY = @"trusty";

package/ios/ReactNativeBlobUtilFS.h

@@ -72,7 +72,8 @@
 + (NSDictionary *) stat:(NSString *) path error:(NSError **) error;
 + (void) exists:(NSString *) path callback:(RCTResponseSenderBlock)callback;
 + (void) writeFileArray:(NSString *)path data:(NSArray *)data append:(BOOL)append resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject;
-+ (void) writeFile:(NSString *)path encoding:(NSString *)encoding data:(NSString *)data append:(BOOL)append resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject;
++ (void) writeFile:(NSString *)path encoding:(NSString *)encoding data:(NSString *)data transformFile:(BOOL)transformFile append:(BOOL)append resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject;
++ (void) readFile:(NSString *)path encoding:(NSString *)encoding transformFile:(BOOL)transformFile onComplete:(void (^)(NSData * content, NSString* code, NSString * errMsg))onComplete;
 + (void) readFile:(NSString *)path encoding:(NSString *)encoding onComplete:(void (^)(NSData * content, NSString* code, NSString * errMsg))onComplete;
 + (void) readAssetFile:(NSData *)assetUrl completionBlock:(void(^)(NSData * content))completionBlock failBlock:(void(^)(NSError * err))failBlock;
 + (void) slice:(NSString *)path

package/ios/ReactNativeBlobUtilFS.m

@@ -10,6 +10,7 @@
 #import "ReactNativeBlobUtil.h"
 #import "ReactNativeBlobUtilFS.h"
 #import "ReactNativeBlobUtilConst.h"
+#import "ReactNativeBlobUtilFileTransformer.h"
 #import "IOS7Polyfill.h"
 @import AssetsLibrary;
 
@@ -347,6 +348,7 @@ NSMutableDictionary *fileStreams = nil;
 + (void) writeFile:(NSString *)path
                     encoding:(NSString *)encoding
                     data:(NSString *)data
+                    transformFile:(BOOL)transformFile
                     append:(BOOL)append
                     resolver:(RCTPromiseResolveBlock)resolve
                     rejecter:(RCTPromiseRejectBlock)reject
@@ -394,6 +396,16 @@ NSMutableDictionary *fileStreams = nil;
         else {
             content = [data dataUsingEncoding:NSUTF8StringEncoding];
         }
+
+        if (transformFile) {
+            NSObject<FileTransformer>* fileTransformer = [ReactNativeBlobUtilFileTransformer getFileTransformer];
+            if (fileTransformer) {
+                content = [fileTransformer onWriteFile:content];
+            } else {
+                return reject(@"EUNSPECIFIED",@"Transform specified but transformer not set", nil);
+            }
+        }
+
         if(append == YES) {
             [fileHandle seekToEndOfFile];
             [fileHandle writeData:content];
@@ -488,6 +500,7 @@ NSMutableDictionary *fileStreams = nil;
 
 + (void) readFile:(NSString *)path
          encoding:(NSString *)encoding
+         transformFile:(BOOL) transformFile
        onComplete:(void (^)(NSData * content, NSString * codeStr, NSString * errMsg))onComplete
 {
     [[self class] getPathFromUri:path completionHandler:^(NSString *path, ALAssetRepresentation *asset) {
@@ -522,6 +535,22 @@ NSMutableDictionary *fileStreams = nil;
 
         }
 
+        if (transformFile) {
+            NSObject<FileTransformer>* fileTransformer = [ReactNativeBlobUtilFileTransformer getFileTransformer];
+            if (fileTransformer) {
+                @try{
+                    fileContent = [fileTransformer onReadFile:fileContent];
+                } @catch (NSException * ex)
+                {
+                    onComplete(nil, @"EUNSPECIFIED", [NSString stringWithFormat:@"Exception on File Transformer: '%@' ", [ex description]]);
+                    return;
+                }
+            } else {
+                onComplete(nil, @"EUNSPECIFIED", @"Transform specified but transformer not set");
+                return;
+            }
+        }
+
         if(encoding != nil)
         {
             if([[encoding lowercaseString] isEqualToString:@"utf8"])

package/ios/ReactNativeBlobUtilFileTransformer.h

@@ -0,0 +1,24 @@
+//  ReactNativeBlobUtilFileTransformer.h
+//  ReactNativeBlobUtil
+//
+
+#ifndef ReactNativeBlobUtilDataConverter_h
+#define ReactNativeBlobUtilDataConverter_h
+
+#import <UIKit/UIKit.h>
+
+
+@protocol FileTransformer <NSObject>
+- (NSData*) onWriteFile:(NSData*)data;
+- (NSData*) onReadFile:(NSData*)data;
+@end
+
+@interface ReactNativeBlobUtilFileTransformer : NSObject
+
++ (void) setFileTransformer:(NSObject<FileTransformer>*) fileTransformer;
++ (NSObject<FileTransformer>*) getFileTransformer;
+
+@end
+
+
+#endif /* ReactNativeBlobUtilFileTransformer_h */

package/ios/ReactNativeBlobUtilFileTransformer.m

@@ -0,0 +1,21 @@
+//  ReactNativeBlobUtilFileTransformer.m
+//  ReactNativeBlobUtil
+//
+
+#import "ReactNativeBlobUtilFileTransformer.h"
+
+static NSObject<FileTransformer> *sharedFileTransformer;
+
+@implementation ReactNativeBlobUtilFileTransformer
+
++ (void) setFileTransformer:(NSObject<FileTransformer> *)fileTransformer {
+     sharedFileTransformer = fileTransformer;
+}
+
++ (NSObject<FileTransformer>*) getFileTransformer {
+    return sharedFileTransformer;
+}
+
+@end
+
+// PHOENIX:PATCH-PACKAGE END

package/ios/ReactNativeBlobUtilReqBuilder.m

@@ -119,7 +119,7 @@
                     if([orgPath hasPrefix:AL_PREFIX])
                     {
                         
-                        [ReactNativeBlobUtilFS readFile:orgPath encoding:nil onComplete:^(id content, NSString* code, NSString * err) {
+                        [ReactNativeBlobUtilFS readFile:orgPath encoding:nil transformFile:false onComplete:^(id content, NSString* code, NSString * err) {
                             if(err != nil)
                             {
                                 onComplete(nil, nil);
@@ -223,7 +223,7 @@
                         NSString * orgPath = [content substringFromIndex:[FILE_PREFIX length]];
                         orgPath = [ReactNativeBlobUtilFS getPathOfAsset:orgPath];
 
-                        [ReactNativeBlobUtilFS readFile:orgPath encoding:nil onComplete:^(NSData *content, NSString* code, NSString * err) {
+                        [ReactNativeBlobUtilFS readFile:orgPath encoding:nil transformFile:false onComplete:^(NSData *content, NSString* code, NSString * err) {
                             if(err != nil)
                             {
                                 onComplete(formData, YES);

package/ios/ReactNativeBlobUtilRequest.m

@@ -10,6 +10,7 @@
 
 #import "ReactNativeBlobUtilFS.h"
 #import "ReactNativeBlobUtilConst.h"
+#import "ReactNativeBlobUtilFileTransformer.h"
 #import "ReactNativeBlobUtilReqBuilder.h"
 
 #import "IOS7Polyfill.h"
@@ -156,6 +157,12 @@ typedef NS_ENUM(NSUInteger, ResponseFormat) {
         } else {
             destPath = [ReactNativeBlobUtilFS getTempPath:cacheKey withExtension:[self.options valueForKey:CONFIG_FILE_EXT]];
         }
+
+        // We still need to initialize this as a placeholder in memory before we perform
+        // the conversion
+        if ([self ShouldTransformFile]) {
+            respData = [[NSMutableData alloc] init];
+        }
     } else {
         respData = [[NSMutableData alloc] init];
         respFile = NO;
@@ -333,7 +340,9 @@ typedef NS_ENUM(NSUInteger, ResponseFormat) {
         chunkString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
     }
 
-    if (respFile) {
+    // If we need to process the data, we defer writing into the file until the we have all the data, at which point
+    // we can perform the processing and then write into the file
+    if (respFile && ![self ShouldTransformFile]) {
         [writeStream write:[data bytes] maxLength:[data length]];
     } else {
         [respData appendData:data];
@@ -390,6 +399,22 @@ typedef NS_ENUM(NSUInteger, ResponseFormat) {
     }
 
     if (respFile) {
+        if ([self ShouldTransformFile]) {
+            // At this point, we have the data that we deferred to write into a file. We can now
+            // perform the conversion and write the converted data into the file.
+            NSObject<FileTransformer>* fileTransformer = [ReactNativeBlobUtilFileTransformer getFileTransformer];
+            if (!fileTransformer) {
+                errMsg = @"Transform file specified but file transfomer not set";
+            } else {
+                @try{
+                    NSData* transformedData = [fileTransformer onWriteFile:respData];
+                    [writeStream write:[transformedData bytes] maxLength:[transformedData length]];
+                } @catch(NSException * ex)
+                {
+                    errMsg = [NSString stringWithFormat:@"Exception on File Transformer: '%@' ", [ex description]];
+                }
+            }
+        }
         [writeStream close];
         rnfbRespType = RESP_TYPE_PATH;
         respStr = destPath;
@@ -430,6 +455,10 @@ typedef NS_ENUM(NSUInteger, ResponseFormat) {
 
 }
 
+- (BOOL) ShouldTransformFile{
+    return [[options valueForKey:CONFIG_TRANSFORM_FILE] boolValue];
+}
+
 // upload progress handler
 - (void) URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didSendBodyData:(int64_t)bytesSent totalBytesSent:(int64_t)totalBytesWritten totalBytesExpectedToSend:(int64_t)totalBytesExpectedToWrite
 {

package/mediacollection.js

@@ -9,7 +9,11 @@ function createMediafile(fd: filedescriptor, mediatype: string): Promise {
 }
 
 function writeToMediafile(uri: string, path: string) {
-    return ReactNativeBlobUtil.writeToMediaFile(uri, path);
+    return ReactNativeBlobUtil.writeToMediaFile(uri, path, false);
+}
+
+function writeToMediafileWithTransform(uri: string, path: string) {
+    return ReactNativeBlobUtil.writeToMediaFile(uri, path, true);
 }
 
 function copyToInternal(contenturi: string, destpath: string) {
@@ -27,6 +31,7 @@ function copyToMediaStore(fd: filedescriptor, mediatype: string, path: string) {
 export default {
     createMediafile,
     writeToMediafile,
+    writeToMediafileWithTransform,
     copyToInternal,
     getBlob,
     copyToMediaStore

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-blob-util",
-    "version": "0.14.1",
+    "version": "0.15.0",
     "description": "A module provides upload, download, and files access API. Supports file stream read/write for process large files.",
     "main": "index.js",
     "scripts": {

package/polyfill/Fetch.js

@@ -59,10 +59,12 @@ class ReactNativeBlobUtilFetchPolyfill {
             // task.then is not, so we have to extend task.then with progress and
             // cancel function
             let progressHandler, uploadHandler, cancelHandler;
+            let scopedTask = null;
             let statefulPromise = promise
                 .then((body) => {
                     let task = RNconfig(config)
                         .fetch(options.method, url, options.headers, body);
+                    scopedTask = task;
                     if (progressHandler)
                         task.progress(progressHandler);
                     if (uploadHandler)
@@ -87,8 +89,8 @@ class ReactNativeBlobUtilFetchPolyfill {
             };
             statefulPromise.cancel = () => {
                 cancelHandler = true;
-                if (task.cancel)
-                    task.cancel();
+                if (scopedTask && scopedTask.cancel)
+                    scopedTask.cancel();
             };
 
             return statefulPromise;

package/types.js

@@ -3,6 +3,7 @@ export type ReactNativeBlobUtilConfig = {
   Progress: any,
   UploadProgress: any,
   fileCache : bool,
+  transformFile: boolean;
   path : string,
   appendExt : string,
   session : string,