@capacitor/filesystem 1.0.7 → 4.0.0-beta.2

package/CHANGELOG.md

@@ -3,6 +3,73 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.0.0-beta.2](https://github.com/ionic-team/capacitor-plugins/compare/4.0.0-beta.0...4.0.0-beta.2) (2022-07-08)
+
+**Note:** Version bump only for package @capacitor/filesystem
+
+
+
+
+
+# 4.0.0-beta.0 (2022-06-27)
+
+
+### Bug Fixes
+
+* **filesystem:** Prevent android crash on invalid base64 write ([#937](https://github.com/ionic-team/capacitor-plugins/issues/937)) ([1af0bfe](https://github.com/ionic-team/capacitor-plugins/commit/1af0bfe24d2a36bc2949fe52866131c3327b321e))
+* **filesystem:** Throw errors instead of strings ([#746](https://github.com/ionic-team/capacitor-plugins/issues/746)) ([af4b875](https://github.com/ionic-team/capacitor-plugins/commit/af4b8750be512b869af07bcf96c1602eedc6758e))
+* **filesystem:** web appendFile with base64 data ([#928](https://github.com/ionic-team/capacitor-plugins/issues/928)) ([80253cf](https://github.com/ionic-team/capacitor-plugins/commit/80253cf2652bf7fa9c07933989cbdffeadd52a27))
+* correct addListeners links ([#655](https://github.com/ionic-team/capacitor-plugins/issues/655)) ([f9871e7](https://github.com/ionic-team/capacitor-plugins/commit/f9871e7bd53478addb21155e148829f550c0e457))
+* inline source code in esm map files ([#760](https://github.com/ionic-team/capacitor-plugins/issues/760)) ([a960489](https://github.com/ionic-team/capacitor-plugins/commit/a960489a19db0182b90d187a50deff9dfbe51038))
+* remove postpublish scripts ([#656](https://github.com/ionic-team/capacitor-plugins/issues/656)) ([ed6ac49](https://github.com/ionic-team/capacitor-plugins/commit/ed6ac499ebf4a47525071ccbfc36c27503e11f60))
+* **android:** permissions use "publicStorage" as alias ([#202](https://github.com/ionic-team/capacitor-plugins/issues/202)) ([2dfc7a3](https://github.com/ionic-team/capacitor-plugins/commit/2dfc7a3261a4f98871a86fe6d47fab084a2d1deb))
+* **android:** support writing files without scheme ([#241](https://github.com/ionic-team/capacitor-plugins/issues/241)) ([4285cb1](https://github.com/ionic-team/capacitor-plugins/commit/4285cb1d37ec3361e7ec4da4786502693b04d478))
+* **filesystem:** allow copy if from is not parent of to ([#546](https://github.com/ionic-team/capacitor-plugins/issues/546)) ([a70414e](https://github.com/ionic-team/capacitor-plugins/commit/a70414e79189579ff1a0b5c2a90d12491f5c23cf))
+* **filesystem:** Append doesn't resolve on iOS ([#305](https://github.com/ionic-team/capacitor-plugins/issues/305)) ([98e91cd](https://github.com/ionic-team/capacitor-plugins/commit/98e91cd745fb12bf46f99233bb527f147dbba58b))
+* **filesystem:** Convert stat ctime/mtime timestamp to milliseconds ([#321](https://github.com/ionic-team/capacitor-plugins/issues/321)) ([d978986](https://github.com/ionic-team/capacitor-plugins/commit/d97898662d0ba037e5f8448990a91de5ec6a4234))
+* **filesystem:** copy doesn't resolve on Android ([#233](https://github.com/ionic-team/capacitor-plugins/issues/233)) ([17cbf3b](https://github.com/ionic-team/capacitor-plugins/commit/17cbf3b0ada97f1279fba32b551c380c0e669406))
+* **filesystem:** is not requesting permission on public directories ([#246](https://github.com/ionic-team/capacitor-plugins/issues/246)) ([aa897ab](https://github.com/ionic-team/capacitor-plugins/commit/aa897ab4269e34cd5d762ed645030054ddda7dd6))
+* **filesystem:** Make ctime optional ([#373](https://github.com/ionic-team/capacitor-plugins/issues/373)) ([e3c6212](https://github.com/ionic-team/capacitor-plugins/commit/e3c6212b94c75cf747a8768af5056963683953b2))
+* **filesystem:** rmdir doesn't resolve on iOS ([#239](https://github.com/ionic-team/capacitor-plugins/issues/239)) ([7ca538b](https://github.com/ionic-team/capacitor-plugins/commit/7ca538bb47e2e00080eadfe8d875323c1e198cb2))
+* add es2017 lib to tsconfig ([#180](https://github.com/ionic-team/capacitor-plugins/issues/180)) ([2c3776c](https://github.com/ionic-team/capacitor-plugins/commit/2c3776c38ca025c5ee965dec10ccf1cdb6c02e2f))
+* support deprecated types from Capacitor 2 ([#139](https://github.com/ionic-team/capacitor-plugins/issues/139)) ([2d7127a](https://github.com/ionic-team/capacitor-plugins/commit/2d7127a488e26f0287951921a6db47c49d817336))
+* **filesystem:** Use PermissionState from @capacitor/core ([#148](https://github.com/ionic-team/capacitor-plugins/issues/148)) ([5ce3c5d](https://github.com/ionic-team/capacitor-plugins/commit/5ce3c5d491a35b8771661f3e4eb98aac6df15911))
+
+
+### Features
+
+* set targetSDK default value to 32 ([#970](https://github.com/ionic-team/capacitor-plugins/issues/970)) ([fa70d96](https://github.com/ionic-team/capacitor-plugins/commit/fa70d96f141af751aae53ceb5642c46b204f5958))
+* **filesystem:** Make readDir return files information ([#949](https://github.com/ionic-team/capacitor-plugins/issues/949)) ([0a9f43d](https://github.com/ionic-team/capacitor-plugins/commit/0a9f43dffd3815f600c35ed4528c017644fdb55e))
+* **filesystem:** Return path of copied file ([#931](https://github.com/ionic-team/capacitor-plugins/issues/931)) ([310f583](https://github.com/ionic-team/capacitor-plugins/commit/310f583ccec58730ab8046a1618782c950c60656))
+* add commonjs output format ([#179](https://github.com/ionic-team/capacitor-plugins/issues/179)) ([8e9e098](https://github.com/ionic-team/capacitor-plugins/commit/8e9e09862064b3f6771d7facbc4008e995d9b463))
+* Filesystem plugin ([#19](https://github.com/ionic-team/capacitor-plugins/issues/19)) ([3b86a4a](https://github.com/ionic-team/capacitor-plugins/commit/3b86a4a972e00eaed1d078bfcc69af6136222dc4))
+* set targetSDK default value to 31 ([#824](https://github.com/ionic-team/capacitor-plugins/issues/824)) ([3ee10de](https://github.com/ionic-team/capacitor-plugins/commit/3ee10de98067984c1a4e75295d001c5a895c47f4))
+* Upgrade gradle to 7.4 ([#826](https://github.com/ionic-team/capacitor-plugins/issues/826)) ([5db0906](https://github.com/ionic-team/capacitor-plugins/commit/5db0906f6264287c4f8e69dbaecf19d4d387824b))
+* Use java 11 ([#910](https://github.com/ionic-team/capacitor-plugins/issues/910)) ([5acb2a2](https://github.com/ionic-team/capacitor-plugins/commit/5acb2a288a413492b163e4e97da46a085d9e4be0))
+* **android:** implements Activity Result API changes for permissions and activity results ([#222](https://github.com/ionic-team/capacitor-plugins/issues/222)) ([f671b9f](https://github.com/ionic-team/capacitor-plugins/commit/f671b9f4b472806ef43db6dcf302d4503cf1828c))
+* **filesystem:** Allow the use of absolute urls on iOS and web ([#250](https://github.com/ionic-team/capacitor-plugins/issues/250)) ([03ad97c](https://github.com/ionic-team/capacitor-plugins/commit/03ad97c1b7450e864504198853aac2b3bdc4b8a4))
+* **filesystem:** support Library directory ([#666](https://github.com/ionic-team/capacitor-plugins/issues/666)) ([ce7ee95](https://github.com/ionic-team/capacitor-plugins/commit/ce7ee958b141f1dd4f86493923455f8264d0b6db))
+
+
+
+
+
+# [1.1.0](https://github.com/ionic-team/capacitor-plugins/compare/@capacitor/filesystem@1.0.7...@capacitor/filesystem@1.1.0) (2022-01-19)
+
+
+### Bug Fixes
+
+* inline source code in esm map files ([#760](https://github.com/ionic-team/capacitor-plugins/issues/760)) ([a960489](https://github.com/ionic-team/capacitor-plugins/commit/a960489a19db0182b90d187a50deff9dfbe51038))
+
+
+### Features
+
+* **filesystem:** support Library directory ([#666](https://github.com/ionic-team/capacitor-plugins/issues/666)) ([ce7ee95](https://github.com/ionic-team/capacitor-plugins/commit/ce7ee958b141f1dd4f86493923455f8264d0b6db))
+
+
+
+
+
 ## [1.0.7](https://github.com/ionic-team/capacitor-plugins/compare/@capacitor/filesystem@1.0.6...@capacitor/filesystem@1.0.7) (2022-01-10)
 
 

package/CapacitorFilesystem.podspec

@@ -11,7 +11,7 @@ Pod::Spec.new do |s|
   s.author = package['author']
   s.source = { :git => 'https://github.com/ionic-team/capacitor-plugins.git', :tag => package['name'] + '@' + package['version'] }
   s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}', 'filesystem/ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
-  s.ios.deployment_target  = '12.0'
+  s.ios.deployment_target  = '13.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.1'
 end

package/README.md

@@ -282,7 +282,7 @@ Rename a file or directory
 ### copy(...)
 
 ```typescript
-copy(options: CopyOptions) => Promise<void>
+copy(options: CopyOptions) => Promise<CopyResult>
 ```
 
 Copy a file or directory
@@ -291,6 +291,8 @@ Copy a file or directory
 | ------------- | --------------------------------------------------- |
 | **`options`** | <code><a href="#copyoptions">CopyOptions</a></code> |
 
+**Returns:** <code>Promise&lt;<a href="#copyresult">CopyResult</a>&gt;</code>
+
 **Since:** 1.0.0
 
 --------------------
@@ -405,9 +407,21 @@ Required on Android, only when using <a href="#directory">`Directory.Documents`<
 
 #### ReaddirResult
 
-| Prop        | Type                  | Description                                        | Since |
-| ----------- | --------------------- | -------------------------------------------------- | ----- |
-| **`files`** | <code>string[]</code> | List of files and directories inside the directory | 1.0.0 |
+| Prop        | Type                    | Description                                        | Since |
+| ----------- | ----------------------- | -------------------------------------------------- | ----- |
+| **`files`** | <code>FileInfo[]</code> | List of files and directories inside the directory | 1.0.0 |
+
+
+#### FileInfo
+
+| Prop        | Type                               | Description                                                                          | Since |
+| ----------- | ---------------------------------- | ------------------------------------------------------------------------------------ | ----- |
+| **`name`**  | <code>string</code>                | Name of the file or directory.                                                       |       |
+| **`type`**  | <code>'directory' \| 'file'</code> | Type of the file.                                                                    | 4.0.0 |
+| **`size`**  | <code>number</code>                | Size of the file in bytes.                                                           | 4.0.0 |
+| **`ctime`** | <code>number</code>                | Time of creation in milliseconds. It's not available on Android 7 and older devices. | 4.0.0 |
+| **`mtime`** | <code>number</code>                | Time of last modification in milliseconds.                                           | 4.0.0 |
+| **`uri`**   | <code>string</code>                | The uri of the file.                                                                 | 4.0.0 |
 
 
 #### ReaddirOptions
@@ -435,13 +449,13 @@ Required on Android, only when using <a href="#directory">`Directory.Documents`<
 
 #### StatResult
 
-| Prop        | Type                | Description                                                                          | Since |
-| ----------- | ------------------- | ------------------------------------------------------------------------------------ | ----- |
-| **`type`**  | <code>string</code> | Type of the file                                                                     | 1.0.0 |
-| **`size`**  | <code>number</code> | Size of the file                                                                     | 1.0.0 |
-| **`ctime`** | <code>number</code> | Time of creation in milliseconds. It's not available on Android 7 and older devices. | 1.0.0 |
-| **`mtime`** | <code>number</code> | Time of last modification in milliseconds.                                           | 1.0.0 |
-| **`uri`**   | <code>string</code> | The uri of the file                                                                  | 1.0.0 |
+| Prop        | Type                               | Description                                                                          | Since |
+| ----------- | ---------------------------------- | ------------------------------------------------------------------------------------ | ----- |
+| **`type`**  | <code>'directory' \| 'file'</code> | Type of the file.                                                                    | 1.0.0 |
+| **`size`**  | <code>number</code>                | Size of the file in bytes.                                                           | 1.0.0 |
+| **`ctime`** | <code>number</code>                | Time of creation in milliseconds. It's not available on Android 7 and older devices. | 1.0.0 |
+| **`mtime`** | <code>number</code>                | Time of last modification in milliseconds.                                           | 1.0.0 |
+| **`uri`**   | <code>string</code>                | The uri of the file                                                                  | 1.0.0 |
 
 
 #### StatOptions
@@ -462,6 +476,13 @@ Required on Android, only when using <a href="#directory">`Directory.Documents`<
 | **`toDirectory`** | <code><a href="#directory">Directory</a></code> | The <a href="#directory">`Directory`</a> containing the destination file or directory. If not supplied will use the 'directory' parameter as the destination | 1.0.0 |
 
 
+#### CopyResult
+
+| Prop      | Type                | Description                            | Since |
+| --------- | ------------------- | -------------------------------------- | ----- |
+| **`uri`** | <code>string</code> | The uri where the file was copied into | 4.0.0 |
+
+
 #### PermissionStatus
 
 | Prop                | Type                                                        |
@@ -490,7 +511,8 @@ Required on Android, only when using <a href="#directory">`Directory.Documents`<
 | Members               | Value                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                       | Since |
 | --------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
 | **`Documents`**       | <code>'DOCUMENTS'</code>        | The Documents directory On iOS it's the app's documents directory. Use this directory to store user-generated content. On Android it's the Public Documents folder, so it's accessible from other apps. It's not accesible on Android 10 unless the app enables legacy External Storage by adding `android:requestLegacyExternalStorage="true"` in the `application` tag in the `AndroidManifest.xml`. It's not accesible on Android 11 or newer. | 1.0.0 |
-| **`Data`**            | <code>'DATA'</code>             | The Data directory On iOS it will use the Documents directory On Android it's the directory holding application files. Files will be deleted when the application is uninstalled.                                                                                                                                                                                                                                                                 | 1.0.0 |
+| **`Data`**            | <code>'DATA'</code>             | The Data directory On iOS it will use the Documents directory. On Android it's the directory holding application files. Files will be deleted when the application is uninstalled.                                                                                                                                                                                                                                                                | 1.0.0 |
+| **`Library`**         | <code>'LIBRARY'</code>          | The Library directory On iOS it will use the Library directory. On Android it's the directory holding application files. Files will be deleted when the application is uninstalled.                                                                                                                                                                                                                                                               | 1.1.0 |
 | **`Cache`**           | <code>'CACHE'</code>            | The Cache directory Can be deleted in cases of low memory, so use this directory to write app-specific files that your app can re-create easily.                                                                                                                                                                                                                                                                                                  | 1.0.0 |
 | **`External`**        | <code>'EXTERNAL'</code>         | The external directory On iOS it will use the Documents directory On Android it's the directory on the primary shared/external storage device where the application can place persistent files it owns. These files are internal to the applications, and not typically visible to the user as media. Files will be deleted when the application is uninstalled.                                                                                  | 1.0.0 |
 | **`ExternalStorage`** | <code>'EXTERNAL_STORAGE'</code> | The external storage directory On iOS it will use the Documents directory On Android it's the primary shared/external storage directory. It's not accesible on Android 10 unless the app enables legacy External Storage by adding `android:requestLegacyExternalStorage="true"` in the `application` tag in the `AndroidManifest.xml`. It's not accesible on Android 11 or newer.                                                                | 1.0.0 |

package/android/build.gradle

@@ -1,7 +1,7 @@
 ext {
-    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.1'
-    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.2'
-    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.3.0'
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.3'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.4.0'
 }
 
 buildscript {
@@ -10,17 +10,17 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:4.2.1'
+        classpath 'com.android.tools.build:gradle:7.2.1'
     }
 }
 
 apply plugin: 'com.android.library'
 
 android {
-    compileSdkVersion project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 30
+    compileSdkVersion project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 32
     defaultConfig {
-        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 21
-        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 30
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 22
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 32
         versionCode 1
         versionName "1.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
@@ -35,14 +35,13 @@ android {
         abortOnError false
     }
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_1_8
-        targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_11
+        targetCompatibility JavaVersion.VERSION_11
     }
 }
 
 repositories {
     google()
-    jcenter()
     mavenCentral()
 }
 

package/android/src/main/java/com/capacitorjs/plugins/filesystem/Filesystem.java

@@ -72,18 +72,18 @@ public class Filesystem {
         return created;
     }
 
-    public String[] readdir(String path, String directory) throws DirectoryNotFoundException {
-        String[] files = null;
+    public File[] readdir(String path, String directory) throws DirectoryNotFoundException {
+        File[] files = null;
         File fileObject = getFileObject(path, directory);
         if (fileObject != null && fileObject.exists()) {
-            files = fileObject.list();
+            files = fileObject.listFiles();
         } else {
             throw new DirectoryNotFoundException("Directory does not exist");
         }
         return files;
     }
 
-    public boolean copy(String from, String directory, String to, String toDirectory, boolean doRename)
+    public File copy(String from, String directory, String to, String toDirectory, boolean doRename)
         throws IOException, CopyFailedException {
         if (toDirectory == null) {
             toDirectory = directory;
@@ -100,7 +100,7 @@ public class Filesystem {
         }
 
         if (toObject.equals(fromObject)) {
-            return true;
+            return toObject;
         }
 
         if (!fromObject.exists()) {
@@ -130,7 +130,7 @@ public class Filesystem {
             copyRecursively(fromObject, toObject);
         }
 
-        return true;
+        return toObject;
     }
 
     public InputStream getInputStream(String path, String directory) throws IOException {
@@ -180,12 +180,14 @@ public class Filesystem {
         return Base64.encodeToString(byteStream.toByteArray(), Base64.NO_WRAP);
     }
 
+    @SuppressWarnings("deprecation")
     public File getDirectory(String directory) {
         Context c = this.context;
         switch (directory) {
             case "DOCUMENTS":
                 return Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS);
             case "DATA":
+            case "LIBRARY":
                 return c.getFilesDir();
             case "CACHE":
                 return c.getCacheDir();

package/android/src/main/java/com/capacitorjs/plugins/filesystem/FilesystemPlugin.java

@@ -169,6 +169,8 @@ public class FilesystemPlugin extends Plugin {
                 ex
             );
             call.reject("FILE_NOTCREATED");
+        } catch (IllegalArgumentException ex) {
+            call.reject("The supplied data is not valid base64 content.");
         }
     }
 
@@ -267,10 +269,37 @@ public class FilesystemPlugin extends Plugin {
             requestAllPermissions(call, "permissionCallback");
         } else {
             try {
-                String[] files = implementation.readdir(path, directory);
+                File[] files = implementation.readdir(path, directory);
+                JSArray filesArray = new JSArray();
                 if (files != null) {
+                    for (var i = 0; i < files.length; i++) {
+                        File fileObject = files[i];
+                        JSObject data = new JSObject();
+                        data.put("name", fileObject.getName());
+                        data.put("type", fileObject.isDirectory() ? "directory" : "file");
+                        data.put("size", fileObject.length());
+                        data.put("mtime", fileObject.lastModified());
+                        data.put("uri", Uri.fromFile(fileObject).toString());
+
+                        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+                            try {
+                                BasicFileAttributes attr = Files.readAttributes(fileObject.toPath(), BasicFileAttributes.class);
+
+                                // use whichever is the oldest between creationTime and lastAccessTime
+                                if (attr.creationTime().toMillis() < attr.lastAccessTime().toMillis()) {
+                                    data.put("ctime", attr.creationTime().toMillis());
+                                } else {
+                                    data.put("ctime", attr.lastAccessTime().toMillis());
+                                }
+                            } catch (Exception ex) {}
+                        } else {
+                            data.put("ctime", null);
+                        }
+                        filesArray.put(data);
+                    }
+
                     JSObject ret = new JSObject();
-                    ret.put("files", JSArray.from(files));
+                    ret.put("files", filesArray);
                     call.resolve(ret);
                 } else {
                     call.reject("Unable to read directory");
@@ -364,8 +393,14 @@ public class FilesystemPlugin extends Plugin {
             }
         }
         try {
-            implementation.copy(from, directory, to, toDirectory, doRename);
-            call.resolve();
+            File file = implementation.copy(from, directory, to, toDirectory, doRename);
+            if (!doRename) {
+                JSObject result = new JSObject();
+                result.put("uri", Uri.fromFile(file).toString());
+                call.resolve(result);
+            } else {
+                call.resolve();
+            }
         } catch (CopyFailedException ex) {
             call.reject(ex.getMessage());
         } catch (IOException ex) {

package/dist/docs.json

@@ -242,7 +242,7 @@
       },
       {
         "name": "copy",
-        "signature": "(options: CopyOptions) => Promise<void>",
+        "signature": "(options: CopyOptions) => Promise<CopyResult>",
         "parameters": [
           {
             "name": "options",
@@ -250,7 +250,7 @@
             "type": "CopyOptions"
           }
         ],
-        "returns": "Promise<void>",
+        "returns": "Promise<CopyResult>",
         "tags": [
           {
             "name": "since",
@@ -259,6 +259,7 @@
         ],
         "docs": "Copy a file or directory",
         "complexTypes": [
+          "CopyResult",
           "CopyOptions"
         ],
         "slug": "copy"
@@ -683,8 +684,86 @@
             }
           ],
           "docs": "List of files and directories inside the directory",
+          "complexTypes": [
+            "FileInfo"
+          ],
+          "type": "FileInfo[]"
+        }
+      ]
+    },
+    {
+      "name": "FileInfo",
+      "slug": "fileinfo",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "name",
+          "tags": [],
+          "docs": "Name of the file or directory.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "type",
+          "tags": [
+            {
+              "text": "4.0.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Type of the file.",
+          "complexTypes": [],
+          "type": "'directory' | 'file'"
+        },
+        {
+          "name": "size",
+          "tags": [
+            {
+              "text": "4.0.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Size of the file in bytes.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "ctime",
+          "tags": [
+            {
+              "text": "4.0.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Time of creation in milliseconds.\n\nIt's not available on Android 7 and older devices.",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "mtime",
+          "tags": [
+            {
+              "text": "4.0.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Time of last modification in milliseconds.",
           "complexTypes": [],
-          "type": "string[]"
+          "type": "number"
+        },
+        {
+          "name": "uri",
+          "tags": [
+            {
+              "text": "4.0.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The uri of the file.",
+          "complexTypes": [],
+          "type": "string"
         }
       ]
     },
@@ -794,9 +873,9 @@
               "name": "since"
             }
           ],
-          "docs": "Type of the file",
+          "docs": "Type of the file.",
           "complexTypes": [],
-          "type": "string"
+          "type": "'directory' | 'file'"
         },
         {
           "name": "size",
@@ -806,7 +885,7 @@
               "name": "since"
             }
           ],
-          "docs": "Size of the file",
+          "docs": "Size of the file in bytes.",
           "complexTypes": [],
           "type": "number"
         },
@@ -944,6 +1023,27 @@
         }
       ]
     },
+    {
+      "name": "CopyResult",
+      "slug": "copyresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "uri",
+          "tags": [
+            {
+              "text": "4.0.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The uri where the file was copied into",
+          "complexTypes": [],
+          "type": "string"
+        }
+      ]
+    },
     {
       "name": "PermissionStatus",
       "slug": "permissionstatus",
@@ -988,7 +1088,18 @@
               "name": "since"
             }
           ],
-          "docs": "The Data directory\nOn iOS it will use the Documents directory\nOn Android it's the directory holding application files.\nFiles will be deleted when the application is uninstalled."
+          "docs": "The Data directory\nOn iOS it will use the Documents directory.\nOn Android it's the directory holding application files.\nFiles will be deleted when the application is uninstalled."
+        },
+        {
+          "name": "Library",
+          "value": "'LIBRARY'",
+          "tags": [
+            {
+              "text": "1.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The Library directory\nOn iOS it will use the Library directory.\nOn Android it's the directory holding application files.\nFiles will be deleted when the application is uninstalled."
         },
         {
           "name": "Cache",

package/dist/esm/definitions.d.ts

@@ -18,13 +18,22 @@ export declare enum Directory {
     Documents = "DOCUMENTS",
     /**
      * The Data directory
-     * On iOS it will use the Documents directory
+     * On iOS it will use the Documents directory.
      * On Android it's the directory holding application files.
      * Files will be deleted when the application is uninstalled.
      *
      * @since 1.0.0
      */
     Data = "DATA",
+    /**
+     * The Library directory
+     * On iOS it will use the Library directory.
+     * On Android it's the directory holding application files.
+     * Files will be deleted when the application is uninstalled.
+     *
+     * @since 1.1.0
+     */
+    Library = "LIBRARY",
     /**
      * The Cache directory
      * Can be deleted in cases of low memory, so use this directory to write app-specific files
@@ -318,7 +327,45 @@ export interface ReaddirResult {
      *
      * @since 1.0.0
      */
-    files: string[];
+    files: FileInfo[];
+}
+export interface FileInfo {
+    /**
+     * Name of the file or directory.
+     */
+    name: string;
+    /**
+     * Type of the file.
+     *
+     * @since 4.0.0
+     */
+    type: 'directory' | 'file';
+    /**
+     * Size of the file in bytes.
+     *
+     * @since 4.0.0
+     */
+    size: number;
+    /**
+     * Time of creation in milliseconds.
+     *
+     * It's not available on Android 7 and older devices.
+     *
+     * @since 4.0.0
+     */
+    ctime?: number;
+    /**
+     * Time of last modification in milliseconds.
+     *
+     * @since 4.0.0
+     */
+    mtime: number;
+    /**
+     * The uri of the file.
+     *
+     * @since 4.0.0
+     */
+    uri: string;
 }
 export interface GetUriResult {
     /**
@@ -330,13 +377,13 @@ export interface GetUriResult {
 }
 export interface StatResult {
     /**
-     * Type of the file
+     * Type of the file.
      *
      * @since 1.0.0
      */
-    type: string;
+    type: 'directory' | 'file';
     /**
-     * Size of the file
+     * Size of the file in bytes.
      *
      * @since 1.0.0
      */
@@ -362,6 +409,14 @@ export interface StatResult {
      */
     uri: string;
 }
+export interface CopyResult {
+    /**
+     * The uri where the file was copied into
+     *
+     * @since 4.0.0
+     */
+    uri: string;
+}
 export interface FilesystemPlugin {
     /**
      * Read a file from disk
@@ -428,7 +483,7 @@ export interface FilesystemPlugin {
      *
      * @since 1.0.0
      */
-    copy(options: CopyOptions): Promise<void>;
+    copy(options: CopyOptions): Promise<CopyResult>;
     /**
      * Check read/write permissions.
      * Required on Android, only when using `Directory.Documents` or