@capacitor/filesystem 7.0.2-nightly-20250526T150552.0 → 7.1.0-dev.2

package/CapacitorFilesystem.podspec

@@ -7,11 +7,12 @@ Pod::Spec.new do |s|
   s.version = package['version']
   s.summary = package['description']
   s.license = package['license']
-  s.homepage = 'https://capacitorjs.com'
+  s.homepage = package['repository']['url']
   s.author = package['author']
-  s.source = { :git => 'https://github.com/ionic-team/capacitor-plugins.git', :tag => package['name'] + '@' + package['version'] }
-  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}', 'filesystem/ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
   s.ios.deployment_target = '14.0'
   s.dependency 'Capacitor'
+  s.dependency 'IONFilesystemLib', spec='~> 1.0'
   s.swift_version = '5.1'
 end

package/LICENSE

@@ -1,23 +1,21 @@
-Copyright 2020-present Ionic
-https://ionic.io
-
 MIT License
 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
+Copyright (c) 2025 Ionic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Package.swift

@@ -2,22 +2,28 @@
 import PackageDescription
 
 let package = Package(
-    name: "CapacitorFilesystem",
+    name: "FilesystemCapacitor",
     platforms: [.iOS(.v14)],
     products: [
         .library(
-            name: "CapacitorFilesystem",
+            name: "FilesystemCapacitor",
             targets: ["FilesystemPlugin"])
     ],
     dependencies: [
-        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", exact: "7.1.0")
     ],
     targets: [
+        .binaryTarget(
+            name: "IONFilesystemLib",
+            url: "https://github.com/ionic-team/ion-ios-filesystem/releases/download/1.0.0/IONFilesystemLib.zip",
+            checksum: "0279cb09ba79c2c917b049a6e388f37f025846886ecc86b0a09320da46ed2c33" // sha-256
+        ),
         .target(
             name: "FilesystemPlugin",
             dependencies: [
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
-                .product(name: "Cordova", package: "capacitor-swift-pm")
+                .product(name: "Cordova", package: "capacitor-swift-pm"),
+                "IONFilesystemLib"
             ],
             path: "ios/Sources/FilesystemPlugin"),
         .testTarget(

package/README.md

@@ -75,12 +75,12 @@ Additionally, the Filesystem API supports using full `file://` paths, or reading
 ## Example
 
 ```typescript
-import { Filesystem, Directory, Encoding } from '@capacitor/filesystem';
+import { Filesystem, Directory, Encoding } from "@capacitor/filesystem";
 
 const writeSecretFile = async () => {
   await Filesystem.writeFile({
-    path: 'secrets/text.txt',
-    data: 'This is a test',
+    path: "secrets/text.txt",
+    data: "This is a test",
     directory: Directory.Documents,
     encoding: Encoding.UTF8,
   });
@@ -88,17 +88,17 @@ const writeSecretFile = async () => {
 
 const readSecretFile = async () => {
   const contents = await Filesystem.readFile({
-    path: 'secrets/text.txt',
+    path: "secrets/text.txt",
     directory: Directory.Documents,
     encoding: Encoding.UTF8,
   });
 
-  console.log('secrets:', contents);
+  console.log("secrets:", contents);
 };
 
 const deleteSecretFile = async () => {
   await Filesystem.deleteFile({
-    path: 'secrets/text.txt',
+    path: "secrets/text.txt",
     directory: Directory.Documents,
   });
 };
@@ -108,10 +108,10 @@ const readFilePath = async () => {
   // read binary data (base64 encoded) from plugins that return File URIs, such as
   // the Camera.
   const contents = await Filesystem.readFile({
-    path: 'file:///var/mobile/Containers/Data/Application/22A433FD-D82D-4989-8BE6-9FC49DEA20BB/Documents/text.txt',
+    path: "file:///var/mobile/Containers/Data/Application/22A433FD-D82D-4989-8BE6-9FC49DEA20BB/Documents/text.txt",
   });
 
-  console.log('data:', contents);
+  console.log("data:", contents);
 };
 ```
 
@@ -119,7 +119,10 @@ const readFilePath = async () => {
 
 <docgen-index>
 
+* [`checkPermissions()`](#checkpermissions)
+* [`requestPermissions()`](#requestpermissions)
 * [`readFile(...)`](#readfile)
+* [`readFileInChunks(...)`](#readfileinchunks)
 * [`writeFile(...)`](#writefile)
 * [`appendFile(...)`](#appendfile)
 * [`deleteFile(...)`](#deletefile)
@@ -130,8 +133,6 @@ const readFilePath = async () => {
 * [`stat(...)`](#stat)
 * [`rename(...)`](#rename)
 * [`copy(...)`](#copy)
-* [`checkPermissions()`](#checkpermissions)
-* [`requestPermissions()`](#requestpermissions)
 * [`downloadFile(...)`](#downloadfile)
 * [`addListener('progress', ...)`](#addlistenerprogress-)
 * [`removeAllListeners()`](#removealllisteners)
@@ -141,9 +142,45 @@ const readFilePath = async () => {
 
 </docgen-index>
 
+For list of existing error codes, see [Errors](#errors).
+
 <docgen-api>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
+### checkPermissions()
+
+```typescript
+checkPermissions() => Promise<PermissionStatus>
+```
+
+Check read/write permissions.
+Required on Android, only when using <a href="#directory">`Directory.Documents`</a> or
+`Directory.ExternalStorage`.
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+**Since:** 1.0.0
+
+--------------------
+
+
+### requestPermissions()
+
+```typescript
+requestPermissions() => Promise<PermissionStatus>
+```
+
+Request read/write permissions.
+Required on Android, only when using <a href="#directory">`Directory.Documents`</a> or
+`Directory.ExternalStorage`.
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+**Since:** 1.0.0
+
+--------------------
+
+
 ### readFile(...)
 
 ```typescript
@@ -163,6 +200,29 @@ Read a file from disk
 --------------------
 
 
+### readFileInChunks(...)
+
+```typescript
+readFileInChunks(options: ReadFileInChunksOptions, callback: ReadFileInChunksCallback) => Promise<CallbackID>
+```
+
+Read a file from disk, in chunks.
+Native only (not available in web).
+Use the callback to receive each read chunk.
+If empty chunk is returned, it means file has been completely read.
+
+| Param          | Type                                                                          |
+| -------------- | ----------------------------------------------------------------------------- |
+| **`options`**  | <code><a href="#readfileinchunksoptions">ReadFileInChunksOptions</a></code>   |
+| **`callback`** | <code><a href="#readfileinchunkscallback">ReadFileInChunksCallback</a></code> |
+
+**Returns:** <code>Promise&lt;string&gt;</code>
+
+**Since:** 7.1.0
+
+--------------------
+
+
 ### writeFile(...)
 
 ```typescript
@@ -300,7 +360,7 @@ Return data about a file
 | ------------- | --------------------------------------------------- |
 | **`options`** | <code><a href="#statoptions">StatOptions</a></code> |
 
-**Returns:** <code>Promise&lt;<a href="#statresult">StatResult</a>&gt;</code>
+**Returns:** <code>Promise&lt;<a href="#fileinfo">FileInfo</a>&gt;</code>
 
 **Since:** 1.0.0
 
@@ -343,40 +403,6 @@ Copy a file or directory
 --------------------
 
 
-### checkPermissions()
-
-```typescript
-checkPermissions() => Promise<PermissionStatus>
-```
-
-Check read/write permissions.
-Required on Android, only when using <a href="#directory">`Directory.Documents`</a> or
-`Directory.ExternalStorage`.
-
-**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
-
-**Since:** 1.0.0
-
---------------------
-
-
-### requestPermissions()
-
-```typescript
-requestPermissions() => Promise<PermissionStatus>
-```
-
-Request read/write permissions.
-Required on Android, only when using <a href="#directory">`Directory.Documents`</a> or
-`Directory.ExternalStorage`.
-
-**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
-
-**Since:** 1.0.0
-
---------------------
-
-
 ### downloadFile(...)
 
 ```typescript
@@ -385,6 +411,9 @@ downloadFile(options: DownloadFileOptions) => Promise<DownloadFileResult>
 
 Perform a http request to a server and download the file to the specified destination.
 
+This method has been deprecated since version 7.1.0.
+We recommend using the @capacitor/file-transfer plugin instead, in conjunction with this plugin.
+
 | Param         | Type                                                                |
 | ------------- | ------------------------------------------------------------------- |
 | **`options`** | <code><a href="#downloadfileoptions">DownloadFileOptions</a></code> |
@@ -404,6 +433,9 @@ addListener(eventName: 'progress', listenerFunc: ProgressListener) => Promise<Pl
 
 Add a listener to file download progress events.
 
+This method has been deprecated since version 7.1.0.
+We recommend using the @capacitor/file-transfer plugin instead, in conjunction with this plugin.
+
 | Param              | Type                                                          |
 | ------------------ | ------------------------------------------------------------- |
 | **`eventName`**    | <code>'progress'</code>                                       |
@@ -424,6 +456,9 @@ removeAllListeners() => Promise<void>
 
 Remove all listeners for this plugin.
 
+This method has been deprecated since version 7.1.0.
+We recommend using the @capacitor/file-transfer plugin instead, in conjunction with this plugin.
+
 **Since:** 5.2.0
 
 --------------------
@@ -432,6 +467,13 @@ Remove all listeners for this plugin.
 ### Interfaces
 
 
+#### PermissionStatus
+
+| Prop                | Type                                                        |
+| ------------------- | ----------------------------------------------------------- |
+| **`publicStorage`** | <code><a href="#permissionstate">PermissionState</a></code> |
+
+
 #### ReadFileResult
 
 | Prop       | Type                        | Description                                                                                                                            | Since |
@@ -448,6 +490,13 @@ Remove all listeners for this plugin.
 | **`encoding`**  | <code><a href="#encoding">Encoding</a></code>   | The encoding to read the file in, if not provided, data is read as binary and returned as base64 encoded. Pass <a href="#encoding">Encoding.UTF8</a> to read data as string | 1.0.0 |
 
 
+#### ReadFileInChunksOptions
+
+| Prop            | Type                | Description                  | Since |
+| --------------- | ------------------- | ---------------------------- | ----- |
+| **`chunkSize`** | <code>number</code> | Size of the chunks in bytes. | 7.1.0 |
+
+
 #### WriteFileResult
 
 | Prop      | Type                | Description                             | Since |
@@ -513,11 +562,11 @@ Remove all listeners for this plugin.
 
 | Prop        | Type                               | Description                                                                          | Since |
 | ----------- | ---------------------------------- | ------------------------------------------------------------------------------------ | ----- |
-| **`name`**  | <code>string</code>                | Name of the file or directory.                                                       |       |
+| **`name`**  | <code>string</code>                | Name of the file or directory.                                                       | 7.1.0 |
 | **`type`**  | <code>'file' \| 'directory'</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 |
+| **`ctime`** | <code>number</code>                | Time of creation in milliseconds. It's not available on Android 7 and older devices. | 7.1.0 |
+| **`mtime`** | <code>number</code>                | Time of last modification in milliseconds.                                           | 7.1.0 |
 | **`uri`**   | <code>string</code>                | The uri of the file.                                                                 | 4.0.0 |
 
 
@@ -544,17 +593,6 @@ Remove all listeners for this plugin.
 | **`directory`** | <code><a href="#directory">Directory</a></code> | The <a href="#directory">`Directory`</a> to get the file under | 1.0.0 |
 
 
-#### StatResult
-
-| Prop        | Type                               | Description                                                                          | Since |
-| ----------- | ---------------------------------- | ------------------------------------------------------------------------------------ | ----- |
-| **`type`**  | <code>'file' \| 'directory'</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
 
 | Prop            | Type                                            | Description                                                    | Since |
@@ -580,13 +618,6 @@ Remove all listeners for this plugin.
 | **`uri`** | <code>string</code> | The uri where the file was copied into | 4.0.0 |
 
 
-#### PermissionStatus
-
-| Prop                | Type                                                        |
-| ------------------- | ----------------------------------------------------------- |
-| **`publicStorage`** | <code><a href="#permissionstate">PermissionState</a></code> |
-
-
 #### DownloadFileResult
 
 | Prop       | Type                | Description                                                          | Since |
@@ -624,14 +655,31 @@ Remove all listeners for this plugin.
 ### Type Aliases
 
 
-#### RenameOptions
+#### PermissionState
 
-<code><a href="#copyoptions">CopyOptions</a></code>
+<code>'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'</code>
 
 
-#### PermissionState
+#### ReadFileInChunksCallback
+
+Callback for receiving chunks read from a file, or error if something went wrong.
+
+<code>(chunkRead: <a href="#readfileresult">ReadFileResult</a> | null, err?: any): void</code>
 
-<code>'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'</code>
+
+#### CallbackID
+
+<code>string</code>
+
+
+#### StatResult
+
+<code><a href="#fileinfo">FileInfo</a></code>
+
+
+#### RenameOptions
+
+<code><a href="#copyoptions">CopyOptions</a></code>
 
 
 #### ProgressListener
@@ -646,14 +694,17 @@ A listener function that receives progress events.
 
 #### Directory
 
-| 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`. On Android 11 or newer the app can only access the files/folders the app created. | 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 |
+| 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 accessible on Android 10 unless the app enables legacy External Storage by adding `android:requestLegacyExternalStorage="true"` in the `application` tag in the `AndroidManifest.xml`. On Android 11 or newer the app can only access the files/folders the app created. | 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 accessible 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 accessible on Android 11 or newer.                                                                                                     | 1.0.0 |
+| **`ExternalCache`**   | <code>'EXTERNAL_CACHE'</code>   | The external cache directory. On iOS it will use the Documents directory. On Android it's the primary shared/external cache.                                                                                                                                                                                                                                                                                                                                                               | 7.1.0 |
+| **`LibraryNoCloud`**  | <code>'LIBRARY_NO_CLOUD'</code> | The Library directory without cloud backup. Used in iOS. On Android it's the directory holding application files.                                                                                                                                                                                                                                                                                                                                                                          | 7.1.0 |
+| **`Temporary`**       | <code>'TEMPORARY'</code>        | A temporary directory for iOS. On Android it's the directory holding the application cache.                                                                                                                                                                                                                                                                                                                                                                                                | 7.1.0 |
 
 
 #### Encoding
@@ -665,3 +716,23 @@ A listener function that receives progress events.
 | **`UTF16`** | <code>'utf16'</code> | Sixteen-bit UCS Transformation Format, byte order identified by an optional byte-order mark This encoding is only supported on Android.  | 1.0.0 |
 
 </docgen-api>
+
+### Errors
+
+Since version 7.1.0, the plugin returns specific errors with specific codes on native Android and iOS. Web does not follow this standard for errors.
+
+The following table list all the plugin errors:
+
+| Error code        | Platform(s)      | Message                      |
+|-------------------|------------------|------------------------------|
+| OS-PLUG-FILE-0004 | iOS              | Cordova / Capacitor bridge isn’t initialized. |
+| OS-PLUG-FILE-0005 | Android, iOS     | The method input parameters aren’t valid. |
+| OS-PLUG-FILE-0006 | Android, iOS     | Invalid path was provided. |
+| OS-PLUG-FILE-0007 | Android          | Unable to perform file operation, user denied permission request. |
+| OS-PLUG-FILE-0008 | Android, iOS     | Operation failed because file does not exist. |
+| OS-PLUG-FILE-0009 | Android          | Operation not supported for provided input. |
+| OS-PLUG-FILE-0010 | Android, iOS     | Directory already exists, cannot be overwritten. |
+| OS-PLUG-FILE-0011 | Android, iOS     | Missing parent directory – possibly recursive=false was passed or parent directory creation failed. |
+| OS-PLUG-FILE-0012 | Android, iOS     | Cannot delete directory with children; received recursive=false but directory has contents. |
+| OS-PLUG-FILE-0013 | Android, iOS     | The operation failed with an error. |
+

package/android/build.gradle

@@ -1,5 +1,4 @@
 ext {
-    capacitorVersion = System.getenv('CAPACITOR_VERSION')
     junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
     androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
     androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
@@ -7,27 +6,19 @@ ext {
 }
 
 buildscript {
+    ext.kotlin_version = project.hasProperty("kotlin_version") ? rootProject.ext.kotlin_version : '1.9.24'
     repositories {
         google()
         mavenCentral()
-        maven {
-            url "https://plugins.gradle.org/m2/"
-        }
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.7.2'
-        if (System.getenv("CAP_PLUGIN_PUBLISH") == "true") {
-            classpath 'io.github.gradle-nexus:publish-plugin:1.3.0'
-        }
+        classpath 'com.android.tools.build:gradle:8.7.1'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
 
 apply plugin: 'com.android.library'
-if (System.getenv("CAP_PLUGIN_PUBLISH") == "true") {
-    apply plugin: 'io.github.gradle-nexus.publish-plugin'
-    apply from: file('../../scripts/android/publish-root.gradle')
-    apply from: file('../../scripts/android/publish-module.gradle')
-}
+apply plugin: 'kotlin-android'
 
 android {
     namespace "com.capacitorjs.plugins.filesystem"
@@ -52,9 +43,10 @@ android {
         sourceCompatibility JavaVersion.VERSION_21
         targetCompatibility JavaVersion.VERSION_21
     }
-    publishing {
-        singleVariant("release")
-    }
+}
+
+kotlin {
+    jvmToolchain(21)
 }
 
 repositories {
@@ -65,14 +57,12 @@ repositories {
 
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation "io.ionic.libs:ionfilesystem-android:1.0.0"
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
 
-    if (System.getenv("CAP_PLUGIN_PUBLISH") == "true") {
-        implementation "com.capacitorjs:core:$capacitorVersion"
-    } else {
-        implementation project(':capacitor-android')
-    }
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4")
 
-    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

package/android/src/main/kotlin/com/capacitorjs/plugins/filesystem/FilesystemErrors.kt

@@ -0,0 +1,101 @@
+package com.capacitorjs.plugins.filesystem
+
+import io.ionic.libs.ionfilesystemlib.model.IONFILEExceptions
+
+object FilesystemErrors {
+    private fun formatErrorCode(number: Int): String {
+        return "OS-PLUG-FILE-" + number.toString().padStart(4, '0')
+    }
+
+    data class ErrorInfo(
+        val code: String,
+        val message: String
+    )
+
+    fun invalidInputMethod(methodName: String): ErrorInfo = ErrorInfo(
+        code = formatErrorCode(5),
+        message = "The '$methodName' input parameters aren't valid."
+    )
+
+    fun invalidPath(path: String): ErrorInfo = ErrorInfo(
+        code = formatErrorCode(6),
+        message = "Invalid ${if (path.isNotBlank()) "'$path' " else ""}path."
+    )
+
+    val filePermissionsDenied: ErrorInfo = ErrorInfo(
+        code = formatErrorCode(7),
+        message = "Unable to do file operation, user denied permission request."
+    )
+
+    fun doesNotExist(methodName: String, path: String): ErrorInfo = ErrorInfo(
+        code = formatErrorCode(8),
+        message = "'$methodName' failed because file ${if (path.isNotBlank()) "at '$path' " else ""}does not exist."
+    )
+
+    fun notAllowed(methodName: String, notAllowedFor: String): ErrorInfo = ErrorInfo(
+        code = formatErrorCode(9),
+        message = "'$methodName' not supported for $notAllowedFor."
+    )
+
+    fun directoryCreationAlreadyExists(path: String): ErrorInfo = ErrorInfo(
+        code = formatErrorCode(10),
+        message = "Directory ${if (path.isNotBlank()) "at '$path' " else ""}already exists, cannot be overwritten."
+    )
+
+    val missingParentDirectories: ErrorInfo = ErrorInfo(
+        code = formatErrorCode(11),
+        message = "Missing parent directory – possibly recursive=false was passed or parent directory creation failed."
+    )
+
+    val cannotDeleteChildren: ErrorInfo = ErrorInfo(
+        code = formatErrorCode(12),
+        message = "Cannot delete directory with children; received recursive=false but directory has contents."
+    )
+
+    fun operationFailed(methodName: String, errorMessage: String): ErrorInfo = ErrorInfo(
+        code = formatErrorCode(13),
+        message = "'$methodName' failed with${if (errorMessage.isNotBlank()) ": $errorMessage" else "an unknown error."}"
+    )
+}
+
+fun Throwable.toFilesystemError(methodName: String): FilesystemErrors.ErrorInfo = when (this) {
+
+    is IONFILEExceptions.UnresolvableUri -> FilesystemErrors.invalidPath(this.uri)
+
+    is IONFILEExceptions.DoesNotExist -> FilesystemErrors.doesNotExist(methodName, this.path)
+
+    is IONFILEExceptions.NotSupportedForContentScheme -> FilesystemErrors.notAllowed(
+        methodName,
+        notAllowedFor = "content:// URIs"
+    )
+
+    is IONFILEExceptions.NotSupportedForDirectory -> FilesystemErrors.notAllowed(
+        methodName,
+        notAllowedFor = "directories"
+    )
+
+    is IONFILEExceptions.NotSupportedForFiles -> FilesystemErrors.notAllowed(
+        methodName,
+        notAllowedFor = "files, only directories are supported"
+    )
+
+    is IONFILEExceptions.CreateFailed.AlreadyExists ->
+        FilesystemErrors.directoryCreationAlreadyExists(this.path)
+
+    is IONFILEExceptions.CreateFailed.NoParentDirectory -> FilesystemErrors.missingParentDirectories
+
+    is IONFILEExceptions.DeleteFailed.CannotDeleteChildren -> FilesystemErrors.cannotDeleteChildren
+
+    is IONFILEExceptions.CopyRenameFailed.MixingFilesAndDirectories,
+    is IONFILEExceptions.CopyRenameFailed.LocalToContent,
+    is IONFILEExceptions.CopyRenameFailed.SourceAndDestinationContent ->
+        FilesystemErrors.notAllowed(methodName, "the provided source and destinations")
+
+    is IONFILEExceptions.CopyRenameFailed.DestinationDirectoryExists ->
+        FilesystemErrors.directoryCreationAlreadyExists(this.path)
+
+    is IONFILEExceptions.CopyRenameFailed.NoParentDirectory ->
+        FilesystemErrors.missingParentDirectories
+
+    else -> FilesystemErrors.operationFailed(methodName, this.localizedMessage ?: "")
+}