expo-file-system 19.1.0-canary-20250919-7a31b96 → 19.1.0-canary-20250930-9dc59d3

package/CHANGELOG.md

@@ -6,10 +6,14 @@
 
 ### 🎉 New features
 
+- Add write options for base64 encoded bytes. ([#39963](https://github.com/expo/expo/pull/39963) by [@aleqsio](https://github.com/aleqsio))
 - add `idempotent` option to `downloadFileAsync` ([#39681](https://github.com/expo/expo/pull/39681) by [@vonovak](https://github.com/vonovak))
 
 ### 🐛 Bug fixes
 
+- Fix typedoc in the File class. ([#40064](https://github.com/expo/expo/pull/40064) by [@aleqsio](https://github.com/aleqsio))
+- [Android] Fix getContentUri. ([#40001](https://github.com/expo/expo/pull/40001) by [@aleqsio](https://github.com/aleqsio))
+
 ### 💡 Others
 
 ## 19.0.14 — 2025-09-13

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '19.1.0-canary-20250919-7a31b96'
+version = '19.1.0-canary-20250930-9dc59d3'
 
 android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "19.1.0-canary-20250919-7a31b96"
+    versionName "19.1.0-canary-20250930-9dc59d3"
   }
 }
 

package/android/src/main/java/expo/modules/filesystem/FileSystemFile.kt

@@ -80,6 +80,23 @@ class FileSystemFile(uri: Uri) : FileSystemPath(uri) {
     }
   }
 
+  fun write(content: ByteArray) {
+    validateType()
+    validatePermission(Permission.WRITE)
+    if (!exists) {
+      create()
+    }
+    if (uri.isContentUri) {
+      file.outputStream().use { outputStream ->
+        outputStream.write(content)
+      }
+    } else {
+      FileOutputStream(javaFile).use {
+        it.write(content)
+      }
+    }
+  }
+
   fun asString(): String {
     val uriString = file.uri.toString()
     return if (uriString.endsWith("/")) uriString.dropLast(1) else uriString

package/android/src/main/java/expo/modules/filesystem/{legacy/FileSystemFileProvider.kt → FileSystemFileProvider.kt}

@@ -1,4 +1,4 @@
-package expo.modules.filesystem.legacy
+package expo.modules.filesystem
 
 import androidx.core.content.FileProvider
 

package/android/src/main/java/expo/modules/filesystem/FileSystemModule.kt

@@ -2,7 +2,10 @@ package expo.modules.filesystem
 
 import android.content.Context
 import android.net.Uri
+import android.os.Build
+import android.util.Base64
 import android.webkit.URLUtil
+import androidx.annotation.RequiresApi
 import expo.modules.interfaces.filesystem.Permission
 import expo.modules.kotlin.activityresult.AppContextActivityResultLauncher
 import expo.modules.kotlin.apifeatures.EitherType
@@ -24,6 +27,7 @@ class FileSystemModule : Module() {
   private val context: Context
     get() = appContext.reactContext ?: throw Exceptions.AppContextLost()
 
+  @RequiresApi(Build.VERSION_CODES.O)
   @OptIn(EitherType::class)
   override fun definition() = ModuleDefinition {
     Name("FileSystem")
@@ -138,10 +142,14 @@ class FileSystemModule : Module() {
         file.create(options ?: CreateOptions())
       }
 
-      Function("write") { file: FileSystemFile, content: Either<String, TypedArray> ->
+      Function("write") { file: FileSystemFile, content: Either<String, TypedArray>, options: WriteOptions? ->
         if (content.`is`(String::class)) {
           content.get(String::class).let {
-            file.write(it)
+            if (options?.encoding == EncodingType.BASE64) {
+              file.write(Base64.decode(it, Base64.DEFAULT))
+            } else {
+              file.write(it)
+            }
           }
         }
         if (content.`is`(TypedArray::class)) {

package/android/src/main/java/expo/modules/filesystem/FileSystemNextRecords.kt

@@ -2,6 +2,7 @@ package expo.modules.filesystem
 
 import expo.modules.kotlin.records.Field
 import expo.modules.kotlin.records.Record
+import expo.modules.kotlin.types.Enumerable
 
 data class InfoOptions(
   @Field
@@ -17,6 +18,16 @@ data class CreateOptions(
   val idempotent: Boolean = false
 ) : Record
 
+enum class EncodingType(val value: String) : Enumerable {
+  UTF8("utf8"),
+  BASE64("base64")
+}
+
+data class WriteOptions(
+  @Field
+  val encoding: EncodingType = EncodingType.UTF8
+) : Record
+
 data class DownloadOptions(
   @Field
   val headers: Map<String, String> = emptyMap(),

package/build/ExpoFileSystem.types.d.ts

@@ -10,6 +10,23 @@ export type FileCreateOptions = {
      */
     overwrite?: boolean;
 };
+export declare enum EncodingType {
+    /**
+     * Standard encoding format.
+     */
+    UTF8 = "utf8",
+    /**
+     * Binary, radix-64 representation.
+     */
+    Base64 = "base64"
+}
+export type FileWriteOptions = {
+    /**
+     * The encoding format to use when writing the file.
+     * @default FileSystem.EncodingType.UTF8
+     */
+    encoding?: EncodingType | 'utf8' | 'base64';
+};
 export type DirectoryCreateOptions = {
     /**
      * Whether to create intermediate directories if they do not exist.
@@ -167,7 +184,7 @@ export declare class File {
      * Retrieves content of the file as base64.
      * @returns A promise that resolves with the contents of the file as a base64 string.
      */
-    base64(): string;
+    base64(): Promise<string>;
     /**
      * Retrieves content of the file as base64.
      * @returns The contents of the file as a base64 string.
@@ -175,19 +192,19 @@ export declare class File {
     base64Sync(): string;
     /**
      * Retrieves byte content of the entire file.
-     * @returns A promise that resolves with the contents of the file as a Uint8Array.
+     * @returns A promise that resolves with the contents of the file as a `Uint8Array`.
      */
     bytes(): Promise<Uint8Array<ArrayBuffer>>;
     /**
      * Retrieves byte content of the entire file.
-     * @returns A promise that resolves with the contents of the file as a Uint8Array.
+     * @returns The contents of the file as a `Uint8Array`.
      */
     bytesSync(): Uint8Array;
     /**
      * Writes content to the file.
      * @param content The content to write into the file.
      */
-    write(content: string | Uint8Array): void;
+    write(content: string | Uint8Array, options: FileWriteOptions): void;
     /**
      * Deletes a file.
      *
@@ -231,10 +248,18 @@ export declare class File {
     /**
      * A static method that downloads a file from the network.
      *
+     * On Android, the response body streams directly into the target file. If the download fails after
+     * it starts, a partially written file may remain at the destination. On iOS, the download first
+     * completes in a temporary location and the file is moved into place only after success, so no
+     * file is left behind when the request fails.
+     *
      * @param url - The URL of the file to download.
      * @param destination - The destination directory or file. If a directory is provided, the resulting filename will be determined based on the response headers.
+     * @param options - Download options. When the destination already contains a file, the promise rejects with a `DestinationAlreadyExists` error unless `options.idempotent` is set to `true`. With `idempotent: true`, the download overwrites the existing file instead of failing.
      *
-     * @returns A promise that resolves to the downloaded file.
+     * @returns A promise that resolves to the downloaded file. When the server responds with
+     * a non-2xx HTTP status, the promise rejects with an `UnableToDownload` error whose
+     * message includes the status code. No file is created in that scenario.
      *
      * @example
      * ```ts
@@ -249,7 +274,7 @@ export declare class File {
      *
      * @param initialUri An optional URI pointing to an initial folder on which the file picker is opened.
      * @param mimeType A mime type that is used to filter out files that can be picked out.
-     * @returns a `File` instance or an array of `File` instances.
+     * @returns A `File` instance or an array of `File` instances.
      */
     static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File | File[]>;
     /**

package/build/ExpoFileSystem.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../src/ExpoFileSystem.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../src/ExpoFileSystem.types.ts"],"names":[],"mappings":"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"}

package/build/FileSystem.d.ts

@@ -36,7 +36,7 @@ export declare class Paths extends PathUtilities {
  * The constructor accepts an array of strings that are joined to create the file URI. The first argument can also be a `Directory` instance (like `Paths.cache`) or a `File` instance (which creates a new reference to the same file).
  * @example
  * ```ts
- * const file = new File(File.cache, "subdirName", "file.txt");
+ * const file = new File(Paths.cache, "subdirName", "file.txt");
  * ```
  */
 export declare class File extends ExpoFileSystem.FileSystemFile implements Blob {
@@ -47,7 +47,7 @@ export declare class File extends ExpoFileSystem.FileSystemFile implements Blob
      * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
      * @example
      * ```ts
-     * const file = new File(File.cache, "subdirName", "file.txt");
+     * const file = new File(Paths.cache, "subdirName", "file.txt");
      * ```
      */
     constructor(...uris: (string | File | Directory)[]);
@@ -75,7 +75,7 @@ export declare class File extends ExpoFileSystem.FileSystemFile implements Blob
  * The constructor accepts an array of strings that are joined to create the directory URI. The first argument can also be a `Directory` instance (like `Paths.cache`).
  * @example
  * ```ts
- * const directory = new Directory(File.cache, "subdirName");
+ * const directory = new Directory(Paths.cache, "subdirName");
  * ```
  */
 export declare class Directory extends ExpoFileSystem.FileSystemDirectory {
@@ -86,7 +86,7 @@ export declare class Directory extends ExpoFileSystem.FileSystemDirectory {
      * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
      * @example
      * ```ts
-     * const directory = new Directory(File.cache, "subdirName");
+     * const directory = new Directory(Paths.cache, "subdirName");
      * ```
      */
     constructor(...uris: (string | File | Directory)[]);

package/build/index.d.ts

@@ -1,4 +1,4 @@
 export * from './FileSystem';
-export { type FileCreateOptions, type DirectoryCreateOptions, type FileHandle, type FileInfo, type InfoOptions, type PathInfo, type DirectoryInfo, } from './ExpoFileSystem.types';
+export { type FileCreateOptions, type DirectoryCreateOptions, type FileHandle, type FileInfo, type InfoOptions, type PathInfo, type DirectoryInfo, type DownloadOptions, } from './ExpoFileSystem.types';
 export * from './legacyWarnings';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAEhC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAEhC,cAAc,kBAAkB,CAAC"}

package/expo-module.config.json

@@ -12,7 +12,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.filesystem",
-      "version": "19.1.0-canary-20250919-7a31b96",
+      "version": "19.1.0-canary-20250930-9dc59d3",
       "repository": "local-maven-repo"
     }
   }

package/ios/FileSystemExceptions.swift

@@ -13,6 +13,12 @@ internal final class UnableToDownloadException: GenericException<String> {
   }
 }
 
+internal final class UnableToWriteBase64DataException: GenericException<String> {
+  override var reason: String {
+    "Unable to write base64 data to a file: \(param)"
+  }
+}
+
 internal final class InvalidTypeFileException: Exception {
   override var reason: String {
     "A folder with the same name already exists in the file location"

package/ios/FileSystemFile.swift

@@ -81,6 +81,12 @@ internal final class FileSystemFile: FileSystemPath {
     }
   }
 
+  func write(_ data: Data) throws {
+    try withCorrectTypeAndScopedAccess(permission: .write) {
+      try data.write(to: url)
+    }
+  }
+
   // TODO: blob support
   func write(_ content: TypedArray) throws {
     try withCorrectTypeAndScopedAccess(permission: .write) {

package/ios/FileSystemModule.swift

@@ -202,9 +202,16 @@ public final class FileSystemModule: Module {
         return try file.info(options: options ?? InfoOptions())
       }
 
-      Function("write") { (file, content: Either<String, TypedArray>) in
+      Function("write") { (file: FileSystemFile, content: Either<String, TypedArray>, options: WriteOptions?) in
         if let content: String = content.get() {
-          try file.write(content)
+          if options?.encoding == WriteEncoding.base64 {
+            guard let data = Data(base64Encoded: content, options: .ignoreUnknownCharacters) else {
+              throw UnableToWriteBase64DataException(file.url.absoluteString)
+            }
+            try file.write(data)
+          } else {
+            try file.write(content)
+          }
         }
         if let content: TypedArray = content.get() {
           try file.write(content)

package/ios/FileSystemRecords.swift

@@ -35,3 +35,12 @@ struct DirectoryInfo: Record {
   @Field var modificationTime: Int64?
   @Field var creationTime: Int64?
 }
+
+enum WriteEncoding: String, Enumerable {
+  case utf8
+  case base64
+}
+
+struct WriteOptions: Record {
+  @Field var encoding: WriteEncoding?
+}

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3-sources.jar.md5

@@ -0,0 +1 @@
+eb9c254f5ab2514e83db9dd934eaa22c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3-sources.jar.sha1

@@ -0,0 +1 @@
+d372fc4ea514b436e89656c186c54f3c27320b7e

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3-sources.jar.sha256

@@ -0,0 +1 @@
+2ce5bf618d3e1370e92da41b3ae54847ee10874310bac1c7a31918ea9b463777

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3-sources.jar.sha512

@@ -0,0 +1 @@
+60c1582dab4e6504250846af398e2e5993b17a7c14c141282407f8f7f7949256331d238c5ea32afb7c5753903fc0b868fe1a79c3f972ea2525e947744005c6dc

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar.md5

@@ -0,0 +1 @@
+4149892f97989d0e3c81edb204b11142

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar.sha1

@@ -0,0 +1 @@
+6c8de52d70ec473c90b7d31a92cf34950d748780

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar.sha256

@@ -0,0 +1 @@
+ddc92ee79897052fc6df29460ca06ec69c13f347946bd4ecfbcd54358a65ff33

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar.sha512

@@ -0,0 +1 @@
+c06237b0df153d84f847eec9d3b9a677605a639191980b6d38b58a42d98a8e56bd0cbed3e22cbc956ee27709abe0ff44f77750b961377b845510b093fef6a546

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/{19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.module → 19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.module}

@@ -3,14 +3,14 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.filesystem",
-    "version": "19.1.0-canary-20250919-7a31b96",
+    "version": "19.1.0-canary-20250930-9dc59d3",
     "attributes": {
       "org.gradle.status": "release"
     }
   },
   "createdBy": {
     "gradle": {
-      "version": "8.14.3"
+      "version": "9.0.0"
     }
   },
   "variants": [
@@ -75,13 +75,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar",
-          "url": "expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar",
-          "size": 386747,
-          "sha512": "acbe861a908142be88eae95809a80e51574b5a70c980bc45fa0c1c634972e7ee98ca03d9286e6a2aca0b9b2764e3e92e4f484472a587e9330f1cf9efb3b866a9",
-          "sha256": "38db39dc4425a365524ef25cca51740a6c671970a34c27bc8da80ad7ef853a97",
-          "sha1": "795f2aa667934af20b277058a973e66e567aabd5",
-          "md5": "65a90c8c307beb7e905d5d1b87f47f71"
+          "name": "expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar",
+          "url": "expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar",
+          "size": 390234,
+          "sha512": "c06237b0df153d84f847eec9d3b9a677605a639191980b6d38b58a42d98a8e56bd0cbed3e22cbc956ee27709abe0ff44f77750b961377b845510b093fef6a546",
+          "sha256": "ddc92ee79897052fc6df29460ca06ec69c13f347946bd4ecfbcd54358a65ff33",
+          "sha1": "6c8de52d70ec473c90b7d31a92cf34950d748780",
+          "md5": "4149892f97989d0e3c81edb204b11142"
         }
       ]
     },
@@ -153,13 +153,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar",
-          "url": "expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar",
-          "size": 386747,
-          "sha512": "acbe861a908142be88eae95809a80e51574b5a70c980bc45fa0c1c634972e7ee98ca03d9286e6a2aca0b9b2764e3e92e4f484472a587e9330f1cf9efb3b866a9",
-          "sha256": "38db39dc4425a365524ef25cca51740a6c671970a34c27bc8da80ad7ef853a97",
-          "sha1": "795f2aa667934af20b277058a973e66e567aabd5",
-          "md5": "65a90c8c307beb7e905d5d1b87f47f71"
+          "name": "expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar",
+          "url": "expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.aar",
+          "size": 390234,
+          "sha512": "c06237b0df153d84f847eec9d3b9a677605a639191980b6d38b58a42d98a8e56bd0cbed3e22cbc956ee27709abe0ff44f77750b961377b845510b093fef6a546",
+          "sha256": "ddc92ee79897052fc6df29460ca06ec69c13f347946bd4ecfbcd54358a65ff33",
+          "sha1": "6c8de52d70ec473c90b7d31a92cf34950d748780",
+          "md5": "4149892f97989d0e3c81edb204b11142"
         }
       ]
     },
@@ -173,13 +173,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.filesystem-19.1.0-canary-20250919-7a31b96-sources.jar",
-          "url": "expo.modules.filesystem-19.1.0-canary-20250919-7a31b96-sources.jar",
-          "size": 28571,
-          "sha512": "5e896d6a549d64430a226c22eb689f3d84f088506657d2985750534e5840f17b1c903a4fee9cd9a915f47a3e6773596b1f33bd388570e9f4fd360ac2d5d54521",
-          "sha256": "243397e0d8c3e68d5bce371d9a1ac30805c8b93e4f2940d0ddb312d5056ef292",
-          "sha1": "8de8a89b5e329ae1f0989a09d1fc13fe6b672fb5",
-          "md5": "e4ed87add3090ef9b1f273d33bc37969"
+          "name": "expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3-sources.jar",
+          "url": "expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3-sources.jar",
+          "size": 28785,
+          "sha512": "60c1582dab4e6504250846af398e2e5993b17a7c14c141282407f8f7f7949256331d238c5ea32afb7c5753903fc0b868fe1a79c3f972ea2525e947744005c6dc",
+          "sha256": "2ce5bf618d3e1370e92da41b3ae54847ee10874310bac1c7a31918ea9b463777",
+          "sha1": "d372fc4ea514b436e89656c186c54f3c27320b7e",
+          "md5": "eb9c254f5ab2514e83db9dd934eaa22c"
         }
       ]
     }

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.module.md5

@@ -0,0 +1 @@
+67281b958a56d1a6ac5cb5a750279cc2

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.module.sha1

@@ -0,0 +1 @@
+81cca26371b64622c9660a1aea6ba86330857d45

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.module.sha256

@@ -0,0 +1 @@
+79278f1252d479e6b3a4e84e2750c328ca0b93ca00e9c046b51eb0f67bad214e

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.module.sha512

@@ -0,0 +1 @@
+2b92a2b6253b9792d3dd56266e68e175db78668e71d9ff48074d014d85523c51d45283ab6f3fefcaeae00239a102de61346a5fde6e1db69463dfe0e939ce5b5b

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/{19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.pom → 19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.filesystem</artifactId>
-  <version>19.1.0-canary-20250919-7a31b96</version>
+  <version>19.1.0-canary-20250930-9dc59d3</version>
   <packaging>aar</packaging>
   <name>expo.modules.filesystem</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.pom.md5

@@ -0,0 +1 @@
+adc47e4e9dcd8000dcb4118585091f93

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.pom.sha1

@@ -0,0 +1 @@
+e83152fc2e06ca4e73308c35ee1b622c67c2b246

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.pom.sha256

@@ -0,0 +1 @@
+f13835293053f940299c6b41adac4d852171a125501ab943d1e2d6ae022702b6

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250930-9dc59d3/expo.modules.filesystem-19.1.0-canary-20250930-9dc59d3.pom.sha512

@@ -0,0 +1 @@
+184f7cb289671255cfd98d73b6777aa5186c06e96da3cbf9c6ff2e9c82daf7d4f3ee88fc75b311a7368ae9e327c9488fb855a96353d885d2590e6d76b58f8bca

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.filesystem</artifactId>
   <versioning>
-    <latest>19.1.0-canary-20250919-7a31b96</latest>
-    <release>19.1.0-canary-20250919-7a31b96</release>
+    <latest>19.1.0-canary-20250930-9dc59d3</latest>
+    <release>19.1.0-canary-20250930-9dc59d3</release>
     <versions>
-      <version>19.1.0-canary-20250919-7a31b96</version>
+      <version>19.1.0-canary-20250930-9dc59d3</version>
     </versions>
-    <lastUpdated>20250919195357</lastUpdated>
+    <lastUpdated>20250930162534</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.md5

@@ -1 +1 @@
-9b064eb175b3ba4a8bfe3822d3f9d43a
+6d2fbfe4ba49c277946cc600b92a9549

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.sha1

@@ -1 +1 @@
-184640b9b65ddd8e51200827bf267f2a0ab405bb
+8f360d07c11fbc7e29d014d0cdbad4a11735fa02

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.sha256

@@ -1 +1 @@
-1cedddeb68e1d68ac0d4c9dbee942031c55710c73c74da1edba5fd6b93afaa14
+2464535b58a6f050f8e5547a579684dc4fffa3157c2de437b60a562d22e3e8aa

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/maven-metadata.xml.sha512

@@ -1 +1 @@
-8b70e296848f602599d4c06111b237371406a5d439f68dcc486585d04e3ee42cf981dfc95cf423283c21f0036168462f3cc5c2b311afe1b20fcbea38699c5028
+ab2ddd2374eb24ec4515ca95e581cb74ff08d5cd664df96e231df030b61cefd6417f8f89bea54a18b79cb8d2e7d2bc61bcb44428d76ccb777feccc017825bf98

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "19.1.0-canary-20250919-7a31b96",
+  "version": "19.1.0-canary-20250930-9dc59d3",
   "description": "Provides access to the local file system on the device.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -35,11 +35,11 @@
     "preset": "expo-module-scripts"
   },
   "devDependencies": {
-    "expo-module-scripts": "5.0.8-canary-20250919-7a31b96",
-    "jest-expo": "55.0.0-canary-20250919-7a31b96"
+    "expo-module-scripts": "5.0.8-canary-20250930-9dc59d3",
+    "jest-expo": "55.0.0-canary-20250930-9dc59d3"
   },
   "peerDependencies": {
-    "expo": "55.0.0-canary-20250919-7a31b96",
+    "expo": "55.0.0-canary-20250930-9dc59d3",
     "react-native": "*"
   }
 }

package/src/ExpoFileSystem.types.ts

@@ -11,6 +11,25 @@ export type FileCreateOptions = {
   overwrite?: boolean;
 };
 
+export enum EncodingType {
+  /**
+   * Standard encoding format.
+   */
+  UTF8 = 'utf8',
+  /**
+   * Binary, radix-64 representation.
+   */
+  Base64 = 'base64',
+}
+
+export type FileWriteOptions = {
+  /**
+   * The encoding format to use when writing the file.
+   * @default FileSystem.EncodingType.UTF8
+   */
+  encoding?: EncodingType | 'utf8' | 'base64';
+};
+
 export type DirectoryCreateOptions = {
   /**
    * Whether to create intermediate directories if they do not exist.
@@ -188,7 +207,7 @@ export declare class File {
    * Retrieves content of the file as base64.
    * @returns A promise that resolves with the contents of the file as a base64 string.
    */
-  base64(): string;
+  base64(): Promise<string>;
 
   /**
    * Retrieves content of the file as base64.
@@ -198,13 +217,13 @@ export declare class File {
 
   /**
    * Retrieves byte content of the entire file.
-   * @returns A promise that resolves with the contents of the file as a Uint8Array.
+   * @returns A promise that resolves with the contents of the file as a `Uint8Array`.
    */
   bytes(): Promise<Uint8Array<ArrayBuffer>>;
 
   /**
    * Retrieves byte content of the entire file.
-   * @returns A promise that resolves with the contents of the file as a Uint8Array.
+   * @returns The contents of the file as a `Uint8Array`.
    */
   bytesSync(): Uint8Array;
 
@@ -212,7 +231,7 @@ export declare class File {
    * Writes content to the file.
    * @param content The content to write into the file.
    */
-  write(content: string | Uint8Array): void;
+  write(content: string | Uint8Array, options: FileWriteOptions): void;
 
   /**
    * Deletes a file.
@@ -265,10 +284,18 @@ export declare class File {
   /**
    * A static method that downloads a file from the network.
    *
+   * On Android, the response body streams directly into the target file. If the download fails after
+   * it starts, a partially written file may remain at the destination. On iOS, the download first
+   * completes in a temporary location and the file is moved into place only after success, so no
+   * file is left behind when the request fails.
+   *
    * @param url - The URL of the file to download.
    * @param destination - The destination directory or file. If a directory is provided, the resulting filename will be determined based on the response headers.
+   * @param options - Download options. When the destination already contains a file, the promise rejects with a `DestinationAlreadyExists` error unless `options.idempotent` is set to `true`. With `idempotent: true`, the download overwrites the existing file instead of failing.
    *
-   * @returns A promise that resolves to the downloaded file.
+   * @returns A promise that resolves to the downloaded file. When the server responds with
+   * a non-2xx HTTP status, the promise rejects with an `UnableToDownload` error whose
+   * message includes the status code. No file is created in that scenario.
    *
    * @example
    * ```ts
@@ -288,7 +315,7 @@ export declare class File {
    *
    * @param initialUri An optional URI pointing to an initial folder on which the file picker is opened.
    * @param mimeType A mime type that is used to filter out files that can be picked out.
-   * @returns a `File` instance or an array of `File` instances.
+   * @returns A `File` instance or an array of `File` instances.
    */
   static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File | File[]>;
 

package/src/FileSystem.ts

@@ -65,7 +65,7 @@ export class Paths extends PathUtilities {
  * The constructor accepts an array of strings that are joined to create the file URI. The first argument can also be a `Directory` instance (like `Paths.cache`) or a `File` instance (which creates a new reference to the same file).
  * @example
  * ```ts
- * const file = new File(File.cache, "subdirName", "file.txt");
+ * const file = new File(Paths.cache, "subdirName", "file.txt");
  * ```
  */
 export class File extends ExpoFileSystem.FileSystemFile implements Blob {
@@ -76,7 +76,7 @@ export class File extends ExpoFileSystem.FileSystemFile implements Blob {
    * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
    * @example
    * ```ts
-   * const file = new File(File.cache, "subdirName", "file.txt");
+   * const file = new File(Paths.cache, "subdirName", "file.txt");
    * ```
    */
   constructor(...uris: (string | File | Directory)[]) {
@@ -151,7 +151,7 @@ File.pickFileAsync = async function (initialUri?: string, mimeType?: string) {
  * The constructor accepts an array of strings that are joined to create the directory URI. The first argument can also be a `Directory` instance (like `Paths.cache`).
  * @example
  * ```ts
- * const directory = new Directory(File.cache, "subdirName");
+ * const directory = new Directory(Paths.cache, "subdirName");
  * ```
  */
 export class Directory extends ExpoFileSystem.FileSystemDirectory {
@@ -162,7 +162,7 @@ export class Directory extends ExpoFileSystem.FileSystemDirectory {
    * @param uris An array of: `file:///` string URIs, `File` instances, and `Directory` instances representing an arbitrary location on the file system.
    * @example
    * ```ts
-   * const directory = new Directory(File.cache, "subdirName");
+   * const directory = new Directory(Paths.cache, "subdirName");
    * ```
    */
   constructor(...uris: (string | File | Directory)[]) {

package/src/index.ts

@@ -8,6 +8,7 @@ export {
   type InfoOptions,
   type PathInfo,
   type DirectoryInfo,
+  type DownloadOptions,
 } from './ExpoFileSystem.types';
 
 export * from './legacyWarnings';

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96-sources.jar.md5

@@ -1 +0,0 @@
-e4ed87add3090ef9b1f273d33bc37969

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96-sources.jar.sha1

@@ -1 +0,0 @@
-8de8a89b5e329ae1f0989a09d1fc13fe6b672fb5

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96-sources.jar.sha256

@@ -1 +0,0 @@
-243397e0d8c3e68d5bce371d9a1ac30805c8b93e4f2940d0ddb312d5056ef292

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96-sources.jar.sha512

@@ -1 +0,0 @@
-5e896d6a549d64430a226c22eb689f3d84f088506657d2985750534e5840f17b1c903a4fee9cd9a915f47a3e6773596b1f33bd388570e9f4fd360ac2d5d54521

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar.md5

@@ -1 +0,0 @@
-65a90c8c307beb7e905d5d1b87f47f71

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar.sha1

@@ -1 +0,0 @@
-795f2aa667934af20b277058a973e66e567aabd5

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar.sha256

@@ -1 +0,0 @@
-38db39dc4425a365524ef25cca51740a6c671970a34c27bc8da80ad7ef853a97

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.aar.sha512

@@ -1 +0,0 @@
-acbe861a908142be88eae95809a80e51574b5a70c980bc45fa0c1c634972e7ee98ca03d9286e6a2aca0b9b2764e3e92e4f484472a587e9330f1cf9efb3b866a9

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.module.md5

@@ -1 +0,0 @@
-5387e7e4491d9dbe19891faf2a7c647c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.module.sha1

@@ -1 +0,0 @@
-bf0be9dbd522cde3c8020b6bf9b24a74baa3b7e3

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.module.sha256

@@ -1 +0,0 @@
-606cc145c3d7e153d8f1461986dce1ad7f2a62bfac02e37396e3c195f76e46a9

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.module.sha512

@@ -1 +0,0 @@
-cdde4b39de1cf04ddc8335d727104f1db2c9d8d4d8b4116fbb488fc7c1d87c30cfcb41769eeb83942bf1a0de18d8ffc59ec3e4dedacec1162ddd2ee810392eb9

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.pom.md5

@@ -1 +0,0 @@
-f83d814a7a511bb94fd9916b62f5f682

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.pom.sha1

@@ -1 +0,0 @@
-4a2d44a04d486bcd89c0da7462fd2a49a6b7335c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.pom.sha256

@@ -1 +0,0 @@
-ab8f17647412b15bd2a157461363a1413cd2c6f6fd988d8cc03ca4ac88eec2a7

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20250919-7a31b96/expo.modules.filesystem-19.1.0-canary-20250919-7a31b96.pom.sha512

@@ -1 +0,0 @@
-ecc02b9a7f5764d040763ba156e6b2a68d5d5322610ca28d8e20740bc498e0fffcb5c4648d11b3d94889c2128089fab8a498727b86adf1e4146843e0d9fc311b