v1.4.0

.fvm/fvm_config.json

@@ -1,4 +1,4 @@
 {
-  "flutterSdkVersion": "3.10.0",
+  "flutterSdkVersion": "3.10.2",
   "flavors": {}
 }

lib/ardrive_io.dart

@@ -8,6 +8,7 @@ export 'src/io_entity.dart';
 export 'src/io_exception.dart';
 export 'src/io_file.dart';
 export 'src/io_folder.dart';
+export 'src/mobile/mobile_io.dart';
 export 'src/utils/mime_type_utils.dart';
 export 'src/utils/path_utils.dart';
 export 'src/utils/permissions.dart';

lib/src/ardrive_downloader.dart

@@ -46,24 +46,24 @@ class ArDriveDownloader {
   }
 
   Stream<int> _handleProgress(String taskId) {
-    ReceivePort _port = ReceivePort();
+    ReceivePort port = ReceivePort();
     StreamController<int> controller = StreamController<int>();
 
     /// Remove previous port and track only one download
     IsolateNameServer.removePortNameMapping('downloader_send_port');
 
     IsolateNameServer.registerPortWithName(
-        _port.sendPort, 'downloader_send_port');
+        port.sendPort, 'downloader_send_port');
 
-    _port.listen((dynamic data) {
-      DownloadTaskStatus status = DownloadTaskStatus(data[1]);
+    port.listen((dynamic data) {
+      DownloadTaskStatus status = DownloadTaskStatus.values[data[1]];
       int progress = data[2];
 
       /// only track the progress of current task id
       if (status == DownloadTaskStatus.enqueued) {
         controller.sink.add(0);
       } else if (status == DownloadTaskStatus.running) {
-        debugPrint('Download progress: ' + progress.toString());
+        debugPrint('Download progress: $progress');
         controller.sink.add(progress);
       } else if (status == DownloadTaskStatus.complete) {
         controller.sink.add(100);

lib/src/cache_storage.dart

@@ -10,19 +10,19 @@ class IOCacheStorage {
 
     debugPrint('saving file on local storage');
 
-    final _file = File('${cacheDir.path}/${entity.name}');
+    final file = File('${cacheDir.path}/${entity.name}');
 
     final readStream = File(entity.path).openRead();
 
-    final writeStream = await _file.open(mode: FileMode.write);
+    final writeStream = await file.open(mode: FileMode.write);
 
     await for (List<int> chunk in readStream) {
       await writeStream.writeFrom(chunk);
     }
 
     await writeStream.close();
 
-    return _file.path;
+    return file.path;
   }
 
   Future<IOFile> getFileFromStorage(String fileName) async {
@@ -32,9 +32,9 @@ class IOCacheStorage {
 
     final cacheDir = await _getCacheDir();
 
-    final _file = File('${cacheDir.path}/$fileName');
+    final file = File('${cacheDir.path}/$fileName');
 
-    return adapter.fromFile(_file);
+    return adapter.fromFile(file);
   }
 
   Future<void> freeLocalStorage() async {

lib/src/file_provider.dart

@@ -28,7 +28,8 @@ abstract class FolderProvider {
 }
 
 /// Provides multiple `IOFiles` or an `IOFolder`
-abstract class MultiFileProvider extends FileProvider with FolderProvider {
+abstract class MultiFileProvider extends FileProvider
+    implements FolderProvider {
   Future<List<IOFile>> pickMultipleFiles({
     List<String>? allowedExtensions,
     required FileSource fileSource,

lib/src/io_folder.dart

@@ -70,13 +70,13 @@ class _FileSystemFolder extends IOFolder {
   /// `_mountFolderChildren` mounts recursiverly the folder hierarchy. It gets only
   /// the current level entities loading only `IOFile` and `IOFolder`
   Future<List<IOEntity>> _mountFolderStructure() async {
-    List<IOEntity> _children = [];
+    List<IOEntity> children = [];
 
     for (var fs in _folderContent) {
-      _children.add(await _addFolderNode(fs));
+      children.add(await _addFolderNode(fs));
     }
 
-    return _children;
+    return children;
   }
 
   Future<IOEntity> _addFolderNode(FileSystemEntity fsEntity) async {

lib/src/mobile/mobile_io.dart

@@ -64,9 +64,9 @@ class MobileIO implements ArDriveIO {
   }
 
   @override
-  Future<void> saveFile(IOFile file) async {
+  Future<void> saveFile(IOFile file, [bool saveOnAppDirectory = false]) async {
     try {
-      await _fileSaver.save(file);
+      await _fileSaver.save(file, saveOnAppDirectory: saveOnAppDirectory);
     } catch (e) {
       rethrow;
     }
@@ -78,12 +78,24 @@ class MobileIO implements ArDriveIO {
 /// This implementation uses the `file_saver` package.
 ///
 /// Throws an `FileSystemPermissionDeniedException` when user deny access to storage
+///
+/// `saveOnAppDirectory` is not supported on this implementation
 class MobileSelectableFolderFileSaver implements FileSaver {
+  final DartIOFileSaver _dartIOFileSaver;
+
+  MobileSelectableFolderFileSaver({DartIOFileSaver? dartIOFileSaver})
+      : _dartIOFileSaver = dartIOFileSaver ?? DartIOFileSaver();
+
   @override
-  Future<void> save(IOFile file) async {
+  Future<void> save(IOFile file, {bool saveOnAppDirectory = false}) async {
     await requestPermissions();
     await verifyPermissions();
 
+    if (saveOnAppDirectory) {
+      await _dartIOFileSaver.save(file, saveOnAppDirectory: saveOnAppDirectory);
+      return;
+    }
+
     await file_saver.FileSaver.instance.saveAs(
       name: file.name,
       bytes: await file.readAsBytes(),
@@ -98,7 +110,7 @@ class MobileSelectableFolderFileSaver implements FileSaver {
 /// It will save on `getDefaultMobileDownloadDir()`
 class DartIOFileSaver implements FileSaver {
   @override
-  Future<void> save(IOFile file) async {
+  Future<void> save(IOFile file, {bool saveOnAppDirectory = false}) async {
     await requestPermissions();
     await verifyPermissions();
 
@@ -111,13 +123,30 @@ class DartIOFileSaver implements FileSaver {
       fileName += '.$fileExtension';
     }
 
+    if (saveOnAppDirectory) {
+      await _saveOnAppDir(file, fileName);
+      return;
+    }
+
+    await _saveOnDownloadsDir(file, fileName);
+  }
+
+  Future<void> _saveOnDownloadsDir(IOFile file, String fileName) async {
     /// platform_specific_path/Downloads/
     final defaultDownloadDir = await getDefaultMobileDownloadDir();
 
     final newFile = File(defaultDownloadDir + fileName);
 
     await newFile.writeAsBytes(await file.readAsBytes());
   }
+
+  Future<void> _saveOnAppDir(IOFile file, String fileName) async {
+    final appDir = await getDefaultAppDir();
+
+    final newFile = File(appDir + fileName);
+
+    await newFile.writeAsBytes(await file.readAsBytes());
+  }
 }
 
 /// Defines the API for saving `IOFile` on Storage
@@ -130,5 +159,5 @@ abstract class FileSaver {
         'The ${Platform.operatingSystem} platform is not supported');
   }
 
-  Future<void> save(IOFile file);
+  Future<void> save(IOFile file, {bool saveOnAppDirectory = false});
 }

lib/src/utils/path_utils.dart

@@ -48,6 +48,12 @@ Future<String> getDefaultMobileDownloadDir() async {
   }
 }
 
+Future<String> getDefaultAppDir() {
+  return path_provider
+      .getApplicationDocumentsDirectory()
+      .then((value) => '${value.path}/');
+}
+
 /// Returns the file extension from the file `name`, when having, in other case the extension
 /// will be provided by the `contentType`.
 ///
@@ -84,7 +90,7 @@ String getFileExtension({
 
 Future<String> _getDefaultIOSDir() async {
   final iosDirectory = await path_provider.getApplicationDocumentsDirectory();
-  final iosDownloadsDirectory = Directory(iosDirectory.path + '/Downloads/');
+  final iosDownloadsDirectory = Directory('${iosDirectory.path}/Downloads/');
 
   if (!iosDownloadsDirectory.existsSync()) {
     iosDownloadsDirectory.createSync();

lib/src/web/web_io.dart

@@ -49,7 +49,8 @@ class WebIO implements ArDriveIO {
 
   @override
   Future<void> saveFile(IOFile file) async {
-    final savePath = await file_selector.getSavePath();
+    final savePath = await file_selector.getSaveLocation();
+
     if (savePath == null) {
       throw EntityPathException();
     }
@@ -59,7 +60,7 @@ class WebIO implements ArDriveIO {
       lastModified: file.lastModifiedDate,
       mimeType: file.contentType,
       name: file.name,
-    ).saveTo(savePath);
+    ).saveTo(savePath.path);
   }
 }
 
@@ -144,11 +145,11 @@ class WebFileSystemProvider implements MultiFileProvider {
 class FolderPicker {
   Future<void> pickFolderFiles(
       Function(Stream<List<IOFile>> stream) getFiles) async {
-    StreamController<List<IOFile>> _folderController =
+    StreamController<List<IOFile>> folderController =
         StreamController<List<IOFile>>();
 
     /// Set the stream to get the files
-    getFiles(_folderController.stream);
+    getFiles(folderController.stream);
 
     final folderInput = FileUploadInputElement();
 
@@ -166,10 +167,10 @@ class FolderPicker {
 
       /// To avoid the `IOFileAdapter` imports dart:html, this file will be mounted
       /// here.
-      _folderController.add(files.map((e) => _mountFile(e)).toList());
+      folderController.add(files.map((e) => _mountFile(e)).toList());
 
       /// Closes to finish the stream with all files
-      _folderController.close();
+      folderController.close();
       folderInput.removeAttribute('webkitdirectory');
       folderInput.remove();
     });

pubspec.yaml

@@ -1,12 +1,12 @@
 name: ardrive_io
 description: A new Flutter package project.
-version: 1.3.0
+version: 1.4.0
 homepage:
 publish_to: none
 
 environment:
-  sdk: ">=2.15.1 <3.0.0"
-  flutter: 3.10.0
+  sdk: '>=3.0.2 <4.0.0'
+  flutter: 3.13.6
 
 dependencies:
   flutter:
@@ -16,24 +16,25 @@ dependencies:
       url: https://github.com/ar-io/flutter_file_picker
       ref: master
   path_provider: ^2.0.11
-  permission_handler: ^10.0.0
+  permission_handler: ^11.0.0
   mime: ^1.0.2
   equatable: ^2.0.3
-  file_selector: ^0.9.0
-  flutter_downloader: ^1.8.3+2
-  image_picker: ^0.8.5+3
+  file_selector: ^1.0.1
+  flutter_downloader: ^1.11.3
+  image_picker: ^1.0.4
   security_scoped_resource: ^0.0.1
   file_saver:
     git:
       url: https://github.com/thiagocarvalhodev/file_saver
       ref: fix-extension
-  device_info_plus: ^8.0.0
+  device_info_plus: ^9.0.3
   async: ^2.9.0
+  path: ^1.8.3
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^1.0.0
-  mocktail: ^0.3.0
+  flutter_lints: ^2.0.3
+  mocktail: ^1.0.1
 
 # For information on the generic Dart part of this file, see the
 # following page: https://dart.dev/tools/pub/pubspec