(#85) Apply PR fixes

Author: lakscastro

android/src/main/kotlin/io/lakscastro/sharedstorage/storageaccessframework/DocumentFileApi.kt

@@ -322,7 +322,7 @@ internal class DocumentFileApi(private val plugin: SharedStoragePlugin) :
     result: MethodChannel.Result,
     uri: String,
     content: ByteArray,
-    mode: String,
+    mode: String
   ) {
     try {
       plugin.context.contentResolver.openOutputStream(Uri.parse(uri), mode)?.apply {

docs/Usage/Storage Access Framework.md

@@ -223,7 +223,7 @@ Write to a file using raw bytes `Uint8List`.
 
 Given the document uri, opens the file in the specified `mode` and writes the `bytes` to it.
 
-`mode` represents the mode in which the file will be opened for writing. Use `FileMode.write` for truncating and `FileMode.append` for appending to the file.
+`mode` represents the mode in which the file will be opened for writing. Use `FileMode.write` for truncating (overwrite) and `FileMode.append` for appending to the file.
 
 ```dart
 final Uri documentUri = ...
@@ -576,7 +576,6 @@ You should provide either `content` or `bytes`, if both `bytes` will be used.
 
 `mode` represents the mode in which the file will be opened for writing. Use `FileMode.write` for truncating and `FileMode.append` for appending to the file.
 
-
 ```dart
 final Uri documentUri = ...
 final String fileContent = 'My File Content';
@@ -596,14 +595,14 @@ final bool? success = writeToFile(
 );
 
 /// Write to a file using a [Uint8List] as file contents [bytes]
-final DocumentFile? createdFile = writeToFile(
+final bool? success = writeToFile(
   documentUri,
   content: Uint8List.fromList(fileContent.codeUnits),
   mode: FileMode.write,
 );
 
 /// Append to a file using a [Uint8List] as file contents [bytes]
-final DocumentFile? createdFile = writeToFile(
+final bool? success = writeToFile(
   documentUri,
   content: Uint8List.fromList(fileContent.codeUnits),
   mode: FileMode.append,

lib/src/saf/saf.dart

@@ -202,7 +202,7 @@ Future<DocumentFile?> createDirectory(Uri parentUri, String displayName) async {
 }
 
 /// {@template sharedstorage.saf.createFile}
-/// Convenient method to create files using either String or raw bytes.
+/// Convenient method to create files using either [String] or raw bytes [Uint8List].
 ///
 /// Under the hood this method calls `createFileAsString` or `createFileAsBytes`
 /// depending on which argument is passed.
@@ -283,7 +283,7 @@ Future<DocumentFile?> createFileAsString(
 }
 
 /// {@template sharedstorage.saf.writeToFile}
-/// Convenient method to write to a file using either String or raw bytes.
+/// Convenient method to write to a file using either [String] or raw bytes [Uint8List].
 ///
 /// Under the hood this method calls `writeToFileAsString` or `writeToFileAsBytes`
 /// depending on which argument is passed.
@@ -327,14 +327,11 @@ Future<bool?> writeToFileAsBytes(
   required Uint8List bytes,
   FileMode? mode,
 }) async {
-  var writeMode = 'wt';
-
-  if (mode == FileMode.append || mode == FileMode.writeOnlyAppend) {
-    writeMode = 'wa';
-  }
+  final writeMode =
+      mode == FileMode.append || mode == FileMode.writeOnlyAppend ? 'wa' : 'wt';
 
   final args = <String, dynamic>{
-    'uri': uri.toString(),
+    'uri': '$uri',
     'content': bytes,
     'mode': writeMode,
   };
@@ -344,7 +341,7 @@ Future<bool?> writeToFileAsBytes(
 
 /// {@template sharedstorage.saf.writeToFileAsString}
 /// Convenient method to write to a file.
-/// using `content` as String instead Uint8List.
+/// using `content` as [String] instead [Uint8List].
 /// {@endtemplate}
 Future<bool?> writeToFileAsString(
   Uri uri, {