@amazon-devices/expo-file-system 2.0.1758683737

package/ios/EXFileSystemAssetLibraryHandler.h

@@ -0,0 +1,6 @@
+
+#import <ExpoFileSystem/EXFileSystemHandler.h>
+
+@interface EXFileSystemAssetLibraryHandler : NSObject <EXFileSystemHandler>
+
+@end

package/ios/EXFileSystemAssetLibraryHandler.m

@@ -0,0 +1,142 @@
+
+#import <ExpoFileSystem/EXFileSystemAssetLibraryHandler.h>
+#import <ExpoFileSystem/NSData+EXFileSystem.h>
+
+#import <Photos/Photos.h>
+
+@implementation EXFileSystemAssetLibraryHandler
+
++ (void)getInfoForFile:(NSURL *)fileUri
+           withOptions:(NSDictionary *)options
+              resolver:(EXPromiseResolveBlock)resolve
+              rejecter:(EXPromiseRejectBlock)reject
+{
+  NSError *error;
+  PHFetchResult<PHAsset *> *fetchResult = [self fetchResultForUri:fileUri error:&error];
+  if (error) {
+    reject(@"E_UNSUPPORTED_ARG", error.description, error);
+    return;
+  }
+  if (fetchResult.count > 0) {
+    PHAsset *asset = fetchResult[0];
+    NSMutableDictionary *result = [NSMutableDictionary dictionary];
+    result[@"exists"] = @(YES);
+    result[@"isDirectory"] = @(NO);
+    result[@"uri"] = fileUri;
+    result[@"modificationTime"] = @(asset.modificationDate.timeIntervalSince1970);
+    if (options[@"md5"] || options[@"size"]) {
+      [[PHImageManager defaultManager] requestImageDataForAsset:asset options:nil resultHandler:^(NSData * _Nullable imageData, NSString * _Nullable dataUTI, UIImageOrientation orientation, NSDictionary * _Nullable info) {
+        result[@"size"] = @(imageData.length);
+        if (options[@"md5"]) {
+          result[@"md5"] = [imageData md5String];
+        }
+        resolve(result);
+      }];
+    } else {
+      resolve(result);
+    }
+  } else {
+    resolve(@{@"exists": @(NO), @"isDirectory": @(NO)});
+  }
+}
+
++ (void)copyFrom:(NSURL *)from
+              to:(NSURL *)to
+        resolver:(EXPromiseResolveBlock)resolve
+        rejecter:(EXPromiseRejectBlock)reject
+{
+  NSString *toPath = [to.path stringByStandardizingPath];
+  
+  // NOTE: The destination-delete and the copy should happen atomically, but we hope for the best for now
+  NSError *error;
+  if ([[NSFileManager defaultManager] fileExistsAtPath:toPath]) {
+    if (![[NSFileManager defaultManager] removeItemAtPath:toPath error:&error]) {
+      reject(@"E_FILE_NOT_COPIED",
+             [NSString stringWithFormat:@"File '%@' could not be copied to '%@' because a file already exists at "
+              "the destination and could not be deleted.", from, to],
+             error);
+      return;
+    }
+  }
+
+  PHFetchResult<PHAsset *> *fetchResult = [self fetchResultForUri:from error:&error];
+  if (error) {
+    reject(@"E_UNSUPPORTED_ARG", error.description, error);
+    return;
+  }
+
+  if (fetchResult.count > 0) {
+    PHAsset *asset = fetchResult[0];
+    if (asset.mediaType == PHAssetMediaTypeVideo) {
+      [[PHImageManager defaultManager] requestAVAssetForVideo:asset options:nil resultHandler:^(AVAsset *asset, AVAudioMix *audioMix, NSDictionary *info) {
+        if (![asset isKindOfClass:[AVURLAsset class]]) {
+          reject(@"ERR_INCORRECT_ASSET_TYPE",
+                 [NSString stringWithFormat:@"File '%@' has incorrect asset type.", from],
+                 nil);
+          return;
+        }
+       
+        AVURLAsset* urlAsset = (AVURLAsset*)asset;
+        NSNumber *size;
+        [urlAsset.URL getResourceValue:&size forKey:NSURLFileSizeKey error:nil];
+        NSData *data = [NSData dataWithContentsOfURL:urlAsset.URL];
+         
+        [EXFileSystemAssetLibraryHandler copyData:data toPath:toPath resolver:resolve rejecter:reject];
+      }];
+    } else {
+      [[PHImageManager defaultManager] requestImageDataForAsset:asset options:nil resultHandler:^(NSData * _Nullable imageData, NSString * _Nullable dataUTI, UIImageOrientation orientation, NSDictionary * _Nullable info) {
+        [EXFileSystemAssetLibraryHandler copyData:imageData toPath:toPath resolver:resolve rejecter:reject];
+      }];
+    }
+  } else {
+    reject(@"E_FILE_NOT_COPIED",
+           [NSString stringWithFormat:@"File '%@' could not be found.", from],
+           error);
+  }
+}
+
+// adapted from RCTImageLoader.m
++ (PHFetchResult<PHAsset *> *)fetchResultForUri:(NSURL *)url error:(NSError **)error
+{
+  if ([url.scheme caseInsensitiveCompare:@"ph"] == NSOrderedSame) {
+    // Fetch assets using PHAsset localIdentifier (recommended)
+    NSString *const localIdentifier = [url.absoluteString substringFromIndex:@"ph://".length];
+    return [PHAsset fetchAssetsWithLocalIdentifiers:@[localIdentifier] options:nil];
+  } else if ([url.scheme caseInsensitiveCompare:@"assets-library"] == NSOrderedSame) {
+#if TARGET_OS_MACCATALYST
+    static BOOL hasWarned = NO;
+    if (!hasWarned) {
+      NSLog(@"assets-library:// URLs have been deprecated and cannot be accessed in macOS Catalyst. Returning nil (future warnings will be suppressed).");
+      hasWarned = YES;
+    }
+    return nil;
+#else
+    // This is the older, deprecated way of fetching assets from assets-library
+    // using the "assets-library://" protocol
+    return [PHAsset fetchAssetsWithALAssetURLs:@[url] options:nil];
+#endif
+  }
+
+  NSString *description = [NSString stringWithFormat:@"Invalid URL provided, expected scheme to be either 'ph' or 'assets-library', was '%@'.", url.scheme];
+  *error = [[NSError alloc] initWithDomain:NSURLErrorDomain
+                                      code:NSURLErrorUnsupportedURL
+                                  userInfo:@{NSLocalizedDescriptionKey: description}];
+  return nil;
+}
+
+
++ (void)copyData:(NSData *)data
+          toPath:(NSString *)path
+        resolver:(EXPromiseResolveBlock)resolve
+        rejecter:(EXPromiseRejectBlock)reject
+{
+  if ([data writeToFile:path atomically:YES]) {
+    resolve(nil);
+  } else {
+    reject(@"E_FILE_NOT_COPIED",
+           [NSString stringWithFormat:@"File could not be copied to '%@'.", path],
+           nil);
+  }
+}
+
+@end

package/ios/EXFileSystemHandler.h

@@ -0,0 +1,17 @@
+// Copyright 2023-present 650 Industries. All rights reserved.
+
+#import <ExpoModulesCore/ExpoModulesCore.h>
+
+@protocol EXFileSystemHandler
+
++ (void)getInfoForFile:(NSURL *)fileUri
+           withOptions:(NSDictionary *)optionxs
+              resolver:(EXPromiseResolveBlock)resolve
+              rejecter:(EXPromiseRejectBlock)reject;
+
++ (void)copyFrom:(NSURL *)from
+              to:(NSURL *)to
+        resolver:(EXPromiseResolveBlock)resolve
+        rejecter:(EXPromiseRejectBlock)reject;
+
+@end

package/ios/EXFileSystemLocalFileHandler.h

@@ -0,0 +1,7 @@
+// Copyright 2023-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXFileSystemHandler.h>
+
+@interface EXFileSystemLocalFileHandler : NSObject <EXFileSystemHandler>
+
+@end

package/ios/EXFileSystemLocalFileHandler.m

@@ -0,0 +1,79 @@
+
+#import <ExpoFileSystem/EXFileSystemLocalFileHandler.h>
+#import <ExpoFileSystem/NSData+EXFileSystem.h>
+
+@implementation EXFileSystemLocalFileHandler
+
++ (void)getInfoForFile:(NSURL *)fileUri
+           withOptions:(NSDictionary *)options
+              resolver:(EXPromiseResolveBlock)resolve
+              rejecter:(EXPromiseRejectBlock)reject
+{
+  NSString *path = fileUri.path;
+  BOOL isDirectory;
+  if ([[NSFileManager defaultManager] fileExistsAtPath:path isDirectory:&isDirectory]) {
+    NSDictionary *attributes = [[NSFileManager defaultManager] attributesOfItemAtPath:path error:nil];
+    NSMutableDictionary *result = [NSMutableDictionary dictionary];
+    result[@"exists"] = @(YES);
+    result[@"isDirectory"] = @(isDirectory);
+    result[@"uri"] = [NSURL fileURLWithPath:path].absoluteString;
+    if (options[@"md5"]) {
+      result[@"md5"] = [[NSData dataWithContentsOfFile:path] md5String];
+    }
+    result[@"size"] = @([EXFileSystemLocalFileHandler getFileSize:path attributes:attributes]);
+    result[@"modificationTime"] = @(attributes.fileModificationDate.timeIntervalSince1970);
+    resolve(result);
+  } else {
+    resolve(@{@"exists": @(NO), @"isDirectory": @(NO)});
+  }
+}
+
++ (unsigned long long)getFileSize:(NSString *)path attributes:(NSDictionary<NSFileAttributeKey, id> *)attributes
+{
+  if (attributes.fileType != NSFileTypeDirectory) {
+    return attributes.fileSize;
+  }
+  
+  // The path is pointing to the folder
+  NSArray *contents = [[NSFileManager defaultManager] contentsOfDirectoryAtPath:path error:nil];
+  NSEnumerator *contentsEnumurator = [contents objectEnumerator];
+  NSString *file;
+  unsigned long long folderSize = 0;
+  while (file = [contentsEnumurator nextObject]) {
+    NSString *filePath = [path stringByAppendingPathComponent:file];
+    NSDictionary *fileAttributes = [[NSFileManager defaultManager] attributesOfItemAtPath:filePath error:nil];
+    folderSize += [EXFileSystemLocalFileHandler getFileSize:filePath attributes:fileAttributes];
+  }
+  
+  return folderSize;
+}
+
++ (void)copyFrom:(NSURL *)from
+              to:(NSURL *)to
+        resolver:(EXPromiseResolveBlock)resolve
+        rejecter:(EXPromiseRejectBlock)reject
+{
+  NSString *fromPath = [from.path stringByStandardizingPath];
+  NSString *toPath = [to.path stringByStandardizingPath];
+  
+  NSError *error;
+  if ([[NSFileManager defaultManager] fileExistsAtPath:toPath]) {
+    if (![[NSFileManager defaultManager] removeItemAtPath:toPath error:&error]) {
+      reject(@"E_FILE_NOT_COPIED",
+             [NSString stringWithFormat:@"File '%@' could not be copied to '%@' because a file already exists at "
+              "the destination and could not be deleted.", from, to],
+             error);
+      return;
+    }
+  }
+  
+  if ([[NSFileManager defaultManager] copyItemAtPath:fromPath toPath:toPath error:&error]) {
+    resolve(nil);
+  } else {
+    reject(@"E_FILE_NOT_COPIED",
+           [NSString stringWithFormat:@"File '%@' could not be copied to '%@'.", from, to],
+           error);
+  }
+}
+
+@end

package/ios/EXSessionTasks/EXSessionCancelableUploadTaskDelegate.h

@@ -0,0 +1,16 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionUploadTaskDelegate.h>
+#import <ExpoFileSystem/EXTaskHandlersManager.h>
+
+typedef void (^EXUploadDelegateOnSendCallback)(NSURLSessionUploadTask *task, int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend);
+
+@interface EXSessionCancelableUploadTaskDelegate : EXSessionUploadTaskDelegate
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject
+                         onSendCallback:(EXUploadDelegateOnSendCallback)onSendCallback
+                       resumableManager:(EXTaskHandlersManager *)manager
+                                   uuid:(NSString *)uuid;
+
+@end

package/ios/EXSessionTasks/EXSessionCancelableUploadTaskDelegate.m

@@ -0,0 +1,55 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionCancelableUploadTaskDelegate.h>
+
+@interface EXSessionCancelableUploadTaskDelegate ()
+
+@property (strong, nonatomic, readonly) EXUploadDelegateOnSendCallback onSendCallback;
+@property (weak, nonatomic) EXTaskHandlersManager *manager;
+@property (strong, nonatomic) NSString *uuid;
+
+@end
+
+@implementation EXSessionCancelableUploadTaskDelegate
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject
+                         onSendCallback:(EXUploadDelegateOnSendCallback)onSendCallback
+                       resumableManager:(EXTaskHandlersManager *)manager
+                                   uuid:(NSString *)uuid;
+{
+  if (self = [super initWithResolve:resolve
+                             reject:reject]) {
+    _onSendCallback = onSendCallback;
+    _manager = manager;
+    _uuid = uuid;
+  }
+  return self;
+}
+
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
+{
+  if (error) {
+    // The task was paused by us. So, we shouldn't throw.
+    if (error.code == NSURLErrorCancelled) {
+      self.resolve([NSNull null]);
+      [_manager unregisterTask:_uuid];
+      return;
+    }
+  }
+
+  [super URLSession:session task:task didCompleteWithError:error];
+  [_manager unregisterTask:_uuid];
+}
+
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
+                                didSendBodyData:(int64_t)bytesSent
+                                 totalBytesSent:(int64_t)totalBytesSent
+                       totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
+{
+  if (_onSendCallback && bytesSent > 0) {
+    _onSendCallback(task, bytesSent, totalBytesSent, totalBytesExpectedToSend);
+  }
+}
+
+@end

package/ios/EXSessionTasks/EXSessionDownloadTaskDelegate.h

@@ -0,0 +1,13 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionTaskDelegate.h>
+
+@interface EXSessionDownloadTaskDelegate : EXSessionTaskDelegate
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject
+                               localUrl:(NSURL *)localUrl
+                     shouldCalculateMd5:(BOOL)shouldCalculateMd5;
+
+@end
+

package/ios/EXSessionTasks/EXSessionDownloadTaskDelegate.m

@@ -0,0 +1,64 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionDownloadTaskDelegate.h>
+#import <ExpoFileSystem/NSData+EXFileSystem.h>
+
+@interface EXSessionDownloadTaskDelegate ()
+
+@property (strong, nonatomic) NSURL *localUrl;
+@property (nonatomic) BOOL shouldCalculateMd5;
+
+@end
+
+@implementation EXSessionDownloadTaskDelegate
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject
+                               localUrl:(NSURL *)localUrl
+                     shouldCalculateMd5:(BOOL)shouldCalculateMd5
+{
+  if (self = [super initWithResolve:resolve reject:reject])
+  {
+    _localUrl = localUrl;
+    _shouldCalculateMd5 = shouldCalculateMd5;
+  }
+  return self;
+}
+
+- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
+{
+  NSError *error;
+  NSFileManager *fileManager = [NSFileManager defaultManager];
+  if ([fileManager fileExistsAtPath:_localUrl.path]) {
+    [fileManager removeItemAtURL:_localUrl error:&error];
+    if (error) {
+      self.reject(@"ERR_FILESYSTEM_CANNOT_REMOVE",
+                  [NSString stringWithFormat:@"Unable to remove file from local URI: '%@'", error.description],
+                  error);
+      return;
+    }
+  }
+
+  [fileManager moveItemAtURL:location toURL:_localUrl error:&error];
+  if (error) {
+    self.reject(@"ERR_FILESYSTEM_CANNOT_SAVE",
+                [NSString stringWithFormat:@"Unable to save file to local URI: '%@'", error.description],
+                error);
+    return;
+  }
+
+  self.resolve([self parseServerResponse:downloadTask.response]);
+}
+
+- (NSDictionary *)parseServerResponse:(NSURLResponse *)response
+{
+  NSMutableDictionary *result = [[super parseServerResponse:response] mutableCopy];
+  result[@"uri"] = _localUrl.absoluteString;
+  if (_shouldCalculateMd5) {
+    NSData *data = [NSData dataWithContentsOfURL:_localUrl];
+    result[@"md5"] = [data md5String];
+  }
+  return result;
+}
+
+@end

package/ios/EXSessionTasks/EXSessionHandler.h

@@ -0,0 +1,19 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <Foundation/Foundation.h>
+#import <ExpoModulesCore/EXSingletonModule.h>
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@protocol EXSessionHandler
+
+- (void)invokeCompletionHandlerForSessionIdentifier:(NSString *)identifier;
+
+@end
+
+@interface EXSessionHandler : EXSingletonModule <UIApplicationDelegate, EXSessionHandler>
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/EXSessionTasks/EXSessionHandler.m

@@ -0,0 +1,49 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionHandler.h>
+
+#import <ExpoModulesCore/EXDefines.h>
+
+@interface EXSessionHandler ()
+
+@property (nonatomic, strong) NSMutableDictionary<NSString *, void (^)(void)> *completionHandlers;
+
+@end
+
+@implementation EXSessionHandler
+
+EX_REGISTER_SINGLETON_MODULE(SessionHandler);
+
+- (instancetype)init
+{
+  if (self = [super init]) {
+    _completionHandlers = [NSMutableDictionary dictionary];
+  }
+  
+  return self;
+}
+
+- (void)invokeCompletionHandlerForSessionIdentifier:(NSString *)identifier
+{
+  if (!identifier) {
+    return;
+  }
+ 
+  void (^completionHandler)(void) = _completionHandlers[identifier];
+  if (completionHandler) {
+    // We need to run completionHandler explicite on the main thread because is's part of UIKit
+    dispatch_async(dispatch_get_main_queue(), ^{
+      completionHandler();
+    });
+    [_completionHandlers removeObjectForKey:identifier];
+  }
+}
+
+#pragma mark - AppDelegate
+
+- (void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)(void))completionHandler
+{
+  _completionHandlers[identifier] = completionHandler;
+}
+
+@end

package/ios/EXSessionTasks/EXSessionResumableDownloadTaskDelegate.h

@@ -0,0 +1,18 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionDownloadTaskDelegate.h>
+#import <ExpoFileSystem/EXTaskHandlersManager.h>
+
+typedef void (^EXDownloadDelegateOnWriteCallback)(NSURLSessionDownloadTask *task, int64_t bytesWritten, int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite);
+
+@interface EXSessionResumableDownloadTaskDelegate : EXSessionDownloadTaskDelegate
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject
+                               localUrl:(NSURL *)localUrl
+                     shouldCalculateMd5:(BOOL)shouldCalculateMd5
+                        onWriteCallback:(EXDownloadDelegateOnWriteCallback)onWriteCallback
+                       resumableManager:(EXTaskHandlersManager *)manager
+                                   uuid:(NSString *)uuid;
+
+@end

package/ios/EXSessionTasks/EXSessionResumableDownloadTaskDelegate.m

@@ -0,0 +1,66 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionResumableDownloadTaskDelegate.h>
+
+@interface EXSessionResumableDownloadTaskDelegate ()
+
+@property (strong, nonatomic, readonly) EXDownloadDelegateOnWriteCallback onWriteCallback;
+@property (weak, nonatomic) EXTaskHandlersManager *manager;
+@property (strong, nonatomic) NSString *uuid;
+
+@end
+
+@implementation EXSessionResumableDownloadTaskDelegate
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject
+                               localUrl:(NSURL *)localUrl
+                     shouldCalculateMd5:(BOOL)shouldCalculateMd5
+                        onWriteCallback:(EXDownloadDelegateOnWriteCallback)onWriteCallback
+                       resumableManager:(EXTaskHandlersManager *)manager
+                                   uuid:(NSString *)uuid;
+{
+  if (self = [super initWithResolve:resolve
+                             reject:reject
+                           localUrl:localUrl
+                 shouldCalculateMd5:shouldCalculateMd5]) {
+    _onWriteCallback = onWriteCallback;
+    _manager = manager;
+    _uuid = uuid;
+  }
+  return self;
+}
+
+- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
+{
+  [super URLSession:session downloadTask:downloadTask didFinishDownloadingToURL:location];
+  [_manager unregisterTask:_uuid];
+}
+
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
+{
+  if (error) {
+    // The task was paused by us. So, we shouldn't throw.
+    if (error.code == NSURLErrorCancelled) {
+      self.resolve([NSNull null]);
+    } else {
+      self.reject(@"ERR_FILESYSTEM_CANNOT_DOWNLOAD",
+                  [NSString stringWithFormat:@"Unable to download file: %@", error.description],
+                  error);
+    }
+  }
+
+  [_manager unregisterTask:_uuid];
+}
+
+- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask
+                                           didWriteData:(int64_t)bytesWritten
+                                      totalBytesWritten:(int64_t)totalBytesWritten
+                              totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
+{
+  if (_onWriteCallback && bytesWritten > 0) {
+    _onWriteCallback(downloadTask, bytesWritten, totalBytesWritten, totalBytesExpectedToWrite);
+  }
+}
+
+@end

package/ios/EXSessionTasks/EXSessionTaskDelegate.h

@@ -0,0 +1,32 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <Foundation/Foundation.h>
+#import <ExpoModulesCore/EXDefines.h>
+
+@interface EXSessionTaskDelegate : NSObject
+
+@property (nonatomic, strong, readonly) EXPromiseResolveBlock resolve;
+@property (nonatomic, strong, readonly) EXPromiseRejectBlock reject;
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject;
+
+- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location;
+
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error;
+
+- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask
+                                           didWriteData:(int64_t)bytesWritten
+                                      totalBytesWritten:(int64_t)totalBytesWritten
+                              totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite;
+
+- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data;
+
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
+                                didSendBodyData:(int64_t)bytesSent
+                                 totalBytesSent:(int64_t)totalBytesSent
+                       totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend;
+
+- (NSDictionary *)parseServerResponse:(NSURLResponse *)response;
+
+@end

package/ios/EXSessionTasks/EXSessionTaskDelegate.m

@@ -0,0 +1,58 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <ExpoFileSystem/EXSessionTaskDelegate.h>
+
+@implementation EXSessionTaskDelegate
+
+- (nonnull instancetype)initWithResolve:(EXPromiseResolveBlock)resolve
+                                 reject:(EXPromiseRejectBlock)reject
+{
+  if (self = [super init]) {
+    _resolve = resolve;
+    _reject = reject;
+  }
+  return self;
+}
+
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
+{
+  if (error) {
+    self.reject(@"ERR_FILESYSTEM_CANNOT_DOWNLOAD",
+                [NSString stringWithFormat:@"Unable to download file: %@", error.description],
+                error);
+  }
+}
+
+- (NSDictionary *)parseServerResponse:(NSURLResponse *)response
+{
+  NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *)response;
+  return @{
+    @"status": @([httpResponse statusCode]),
+    @"headers": [httpResponse allHeaderFields],
+    @"mimeType": EXNullIfNil([httpResponse MIMEType])
+  };
+}
+
+- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
+{
+}
+
+- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask
+                                           didWriteData:(int64_t)bytesWritten
+                                      totalBytesWritten:(int64_t)totalBytesWritten
+                              totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
+{
+}
+
+- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
+{
+}
+
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
+                                didSendBodyData:(int64_t)bytesSent
+                                 totalBytesSent:(int64_t)totalBytesSent
+                       totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
+{
+}
+
+@end

package/ios/EXSessionTasks/EXSessionTaskDispatcher.h

@@ -0,0 +1,19 @@
+// Copyright 2015-present 650 Industries. All rights reserved.
+
+#import <Foundation/Foundation.h>
+#import <ExpoFileSystem/EXSessionTaskDelegate.h>
+#import <ExpoFileSystem/EXSessionHandler.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface EXSessionTaskDispatcher : NSObject <NSURLSessionDelegate>
+
+- (instancetype)initWithSessionHandler:(nullable id<EXSessionHandler>)sessionHandler;
+
+- (void)registerTaskDelegate:(EXSessionTaskDelegate *)delegate forTask:(NSURLSessionTask *)task;
+
+- (void)deactivate;
+
+@end
+
+NS_ASSUME_NONNULL_END