expo-file-system 19.1.0-canary-20250919-7a31b96 → 19.1.0-canary-20251023-4c86f95

package/CHANGELOG.md

@@ -6,12 +6,33 @@
 
 ### 🎉 New features
 
-- add `idempotent` option to `downloadFileAsync` ([#39681](https://github.com/expo/expo/pull/39681) by [@vonovak](https://github.com/vonovak))
+- [Android] Add contentUri property. ([#40002](https://github.com/expo/expo/pull/40002) by [@aleqsio](https://github.com/aleqsio))
 
 ### 🐛 Bug fixes
 
+- [Android] Fix recursive file deletion. ([#40248](https://github.com/expo/expo/pull/40248) by [@aleqsio](https://github.com/aleqsio))
+- [iOS] Add missing `createFile` and `createDirectory` methods. ([#40314](https://github.com/expo/expo/pull/40314) by [@jakex7](https://github.com/jakex7))
+
 ### 💡 Others
 
+## 19.0.16 - 2025-10-01
+
+### 🎉 New features
+
+- Add write options for base64 encoded bytes. ([#39963](https://github.com/expo/expo/pull/39963) by [@aleqsio](https://github.com/aleqsio))
+- [iOS] Add file sharing config options ([#39286](https://github.com/expo/expo/pull/39286) by [@kosmydel](https://github.com/kosmydel))
+
+### 🐛 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))
+
+## 19.0.15 - 2025-09-22
+
+### 🎉 New features
+
+- add `idempotent` option to `downloadFileAsync` ([#39681](https://github.com/expo/expo/pull/39681) by [@vonovak](https://github.com/vonovak))
+
 ## 19.0.14 — 2025-09-13
 
 _This version does not introduce any user-facing changes._

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-20251023-4c86f95'
 
 android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "19.1.0-canary-20250919-7a31b96"
+    versionName "19.1.0-canary-20251023-4c86f95"
   }
 }
 

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

@@ -56,10 +56,10 @@ class FileSystemDirectory(uri: Uri) : FileSystemPath(uri) {
     if (!needsCreation(options)) {
       return
     }
-    validateCanCreate(options)
     if (uri.isContentUri) {
       throw UnableToCreateException("create function does not work with SAF Uris, use `createDirectory` and `createFile` instead")
     }
+    validateCanCreate(options)
     if (options.overwrite && file.exists()) {
       file.delete()
     }

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

@@ -44,6 +44,11 @@ internal class UnableToWriteHandleException(reason: String) :
     "Unable to write to a file handle: '$reason'"
   )
 
+internal class MissingAppContextException :
+  CodedException(
+    "The app context is missing."
+  )
+
 internal class PickerCancelledException :
   CodedException("The file picker was cancelled by the user")
 

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
@@ -109,6 +126,12 @@ class FileSystemFile(uri: Uri) : FileSystemPath(uri) {
     }
   }
 
+  fun asContentUri(): Uri {
+    validateType()
+    validatePermission(Permission.READ)
+    return file.getContentUri(appContext ?: throw MissingAppContextException())
+  }
+
   @OptIn(ExperimentalStdlibApi::class)
   val md5: String get() {
     validatePermission(Permission.READ)

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)) {
@@ -207,6 +215,10 @@ class FileSystemModule : Module() {
         file.asString()
       }
 
+      Property("contentUri") { file ->
+        file.asContentUri()
+      }
+
       Property("md5") { file ->
         try {
           file.md5

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/android/src/main/java/expo/modules/filesystem/FileSystemPath.kt

@@ -62,23 +62,13 @@ abstract class FileSystemPath(var uri: Uri) : SharedObject() {
       throw UnableToDeleteException("uri '${file.uri}' does not exist")
     }
     if (file.isDirectory()) {
-      file.listFilesAsUnified().forEach { child ->
-        if (child.isDirectory()) {
-          // Recursively delete subdirectories
-          if (uri.isContentUri) {
-            SAFDocumentFile(appContext?.reactContext ?: throw Exception("No context"), child.uri).delete()
-          } else {
-            JavaFile(child.uri).delete()
-          }
-        } else {
-          if (!child.delete()) {
-            throw UnableToDeleteException("failed to delete '${child.uri}'")
-          }
-        }
+      if (!file.deleteRecursively()) {
+        throw UnableToDeleteException("failed to delete '${file.uri}'")
+      }
+    } else {
+      if (!file.delete()) {
+        throw UnableToDeleteException("failed to delete '${file.uri}'")
       }
-    }
-    if (!file.delete()) {
-      throw UnableToDeleteException("failed to delete '${file.uri}'")
     }
   }
 

package/android/src/main/java/expo/modules/filesystem/unifiedfile/AssetFile.kt

@@ -4,7 +4,9 @@ import android.content.Context
 import android.net.Uri
 import android.webkit.MimeTypeMap
 import androidx.core.net.toUri
+import expo.modules.kotlin.AppContext
 import java.io.File
+import java.io.FileOutputStream
 import java.io.InputStream
 import java.io.OutputStream
 
@@ -25,6 +27,21 @@ class AssetFile(private val context: Context, override val uri: Uri) : UnifiedFi
     }
   }
 
+  // Cache the content URI to avoid redundant file writes – assets are read-only
+  var contentUri: Uri? = null
+  override fun getContentUri(appContext: AppContext): Uri {
+    inputStream().use { inputStream ->
+      val outputFile = File(context.cacheDir, "expo_shared_assets/$fileName")
+      outputFile.parentFile?.mkdirs() // Create directories if needed
+      FileOutputStream(outputFile).use { outputStream ->
+        inputStream.copyTo(outputStream)
+      }
+      val newContentUri = JavaFile(outputFile.toUri()).getContentUri(appContext)
+      contentUri = newContentUri
+      return newContentUri
+    }
+  }
+
   override val parentFile: UnifiedFileInterface?
     get() {
       val currentPath = uri.path.orEmpty()
@@ -48,6 +65,8 @@ class AssetFile(private val context: Context, override val uri: Uri) : UnifiedFi
 
   override fun delete(): Boolean = throw UnsupportedOperationException("Asset files are not writable and cannot be deleted")
 
+  override fun deleteRecursively(): Boolean = throw UnsupportedOperationException("Asset files are not writable and cannot be deleted")
+
   override fun listFilesAsUnified(): List<UnifiedFileInterface> {
     val list = context.assets.list(path)
     return list?.map { name -> AssetFile(context, File(path, name).toUri()) as UnifiedFileInterface } ?: emptyList()

package/android/src/main/java/expo/modules/filesystem/unifiedfile/JavaFile.kt

@@ -3,7 +3,9 @@ package expo.modules.filesystem.unifiedfile
 import android.net.Uri
 import android.os.Build
 import android.webkit.MimeTypeMap
+import androidx.core.content.FileProvider
 import androidx.core.net.toUri
+import expo.modules.kotlin.AppContext
 import java.io.File
 import java.io.FileInputStream
 import java.io.FileOutputStream
@@ -31,6 +33,21 @@ class JavaFile(override val uri: Uri) : UnifiedFileInterface, File(URI.create(ur
     return JavaFile(childFile.toUri())
   }
 
+  override fun deleteRecursively(): Boolean {
+    if (isDirectory) {
+      listFiles()?.forEach { it.deleteRecursively() }
+    }
+    return super<File>.delete()
+  }
+
+  override fun getContentUri(appContext: AppContext): Uri {
+    return FileProvider.getUriForFile(
+      appContext.throwingActivity.application,
+      "${appContext.throwingActivity.application.packageName}.FileSystemFileProvider",
+      this
+    )
+  }
+
   override fun listFilesAsUnified(): List<UnifiedFileInterface> =
     super<File>.listFiles()?.map { JavaFile(it.toUri()) } ?: emptyList()
 

package/android/src/main/java/expo/modules/filesystem/unifiedfile/SAFDocumentFile.kt

@@ -3,6 +3,7 @@ package expo.modules.filesystem.unifiedfile
 import android.content.Context
 import android.net.Uri
 import androidx.documentfile.provider.DocumentFile
+import expo.modules.kotlin.AppContext
 import java.io.InputStream
 import java.io.OutputStream
 
@@ -45,6 +46,8 @@ class SAFDocumentFile(private val context: Context, override val uri: Uri) : Uni
 
   override fun delete(): Boolean = documentFile?.delete() == true
 
+  override fun deleteRecursively(): Boolean = documentFile?.deleteRecursively() == true
+
   override fun listFilesAsUnified(): List<UnifiedFileInterface> =
     documentFile?.listFiles()?.map { SAFDocumentFile(context, it.uri) } ?: emptyList()
 
@@ -58,6 +61,10 @@ class SAFDocumentFile(private val context: Context, override val uri: Uri) : Uni
   override val fileName: String?
     get() = documentFile?.name
 
+  override fun getContentUri(appContext: AppContext): Uri {
+    return uri
+  }
+
   override val creationTime: Long? get() {
     // It seems there's no way to get this
     return null
@@ -88,3 +95,10 @@ class SAFDocumentFile(private val context: Context, override val uri: Uri) : Uni
     }
   }
 }
+
+fun DocumentFile.deleteRecursively(): Boolean {
+  if (isDirectory) {
+    listFiles().forEach { it.deleteRecursively() }
+  }
+  return delete()
+}

package/android/src/main/java/expo/modules/filesystem/unifiedfile/UnifiedFileInterface.kt

@@ -1,6 +1,7 @@
 package expo.modules.filesystem.unifiedfile
 
 import android.net.Uri
+import expo.modules.kotlin.AppContext
 
 interface UnifiedFileInterface {
   fun exists(): Boolean
@@ -10,12 +11,14 @@ interface UnifiedFileInterface {
   fun createFile(mimeType: String, displayName: String): UnifiedFileInterface?
   fun createDirectory(displayName: String): UnifiedFileInterface?
   fun delete(): Boolean
+  fun deleteRecursively(): Boolean
   fun listFilesAsUnified(): List<UnifiedFileInterface>
   val uri: Uri
   val type: String?
   fun lastModified(): Long?
   val creationTime: Long?
   val fileName: String?
+  fun getContentUri(appContext: AppContext): Uri
   fun outputStream(): java.io.OutputStream
   fun inputStream(): java.io.InputStream
   fun length(): Long

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[]>;
     /**
@@ -272,6 +297,11 @@ export declare class File {
      * A mime type of the file. An empty string if the file does not exist, or it cannot be read.
      */
     type: string;
+    /**
+     * A content URI to the file that can be shared to external applications.
+     * @platform android
+     */
+    contentUri: string;
 }
 export declare class FileHandle {
     close(): void;

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-20251023-4c86f95",
       "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)
@@ -328,6 +335,18 @@ public final class FileSystemModule: Module {
         try directory.listAsRecords()
       }
 
+      Function("createFile") { (directory, name: String, content: String?) in
+        let file = FileSystemFile(url: directory.url.appendingPathComponent(name))
+        try file.create(CreateOptions())
+        return file
+      }
+
+      Function("createDirectory") { (directory, name: String) in
+        let newDirectory = FileSystemDirectory(url: directory.url.appendingPathComponent(name))
+        try newDirectory.create(CreateOptions())
+        return newDirectory
+      }
+
       Property("uri") { directory in
         return directory.url.absoluteString
       }

package/ios/FileSystemPath.swift

@@ -25,7 +25,7 @@ internal class FileSystemPath: SharedObject {
 
   func validateCanCreate(_ options: CreateOptions) throws {
     if try !options.overwrite && exists {
-      throw FileAlreadyExistsException("File already exists")
+      throw FileAlreadyExistsException(url.absoluteString)
     }
   }
 

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-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95-sources.jar.md5

@@ -0,0 +1 @@
+d3f99d83252bbc8fcf013f07d3d86ea8

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95-sources.jar.sha1

@@ -0,0 +1 @@
+464959bdf2015e626f82e9af6c6c28a6498240e3

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95-sources.jar.sha256

@@ -0,0 +1 @@
+4177d9bd9a22a528b97cc2f2bd7ba47f6cbf7fb1c09d93a1cacdce6f553b05d6

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95-sources.jar.sha512

@@ -0,0 +1 @@
+6cac7b2fa58a18696e1468e4e9afe7e6092ca1a404351400345349e028cbaeda51386f4303d05372a2be2baf8de77fd97490ea91caa74bfc2a8cfe7b62619bfe

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.aar.md5

@@ -0,0 +1 @@
+b5b686523c997b2c2db9bdcfbec3bd4f

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.aar.sha1

@@ -0,0 +1 @@
+29d197f141c1824915acd933d598b94823c3407f

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.aar.sha256

@@ -0,0 +1 @@
+1f23e461e8a94f5149b5b22ecd2e6dec9a15a5b0a9f5656a86bfaa586a998e42

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.aar.sha512

@@ -0,0 +1 @@
+9e2285f94d47b66eac6eacae8f85ba8179d0d934f648546bdfee4242cd4282663bf08c2598bdc6b6e9ba2c9f62117dc134b171c38a2350833402f4259ef83f13

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-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.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-20251023-4c86f95",
     "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-20251023-4c86f95.aar",
+          "url": "expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.aar",
+          "size": 393117,
+          "sha512": "9e2285f94d47b66eac6eacae8f85ba8179d0d934f648546bdfee4242cd4282663bf08c2598bdc6b6e9ba2c9f62117dc134b171c38a2350833402f4259ef83f13",
+          "sha256": "1f23e461e8a94f5149b5b22ecd2e6dec9a15a5b0a9f5656a86bfaa586a998e42",
+          "sha1": "29d197f141c1824915acd933d598b94823c3407f",
+          "md5": "b5b686523c997b2c2db9bdcfbec3bd4f"
         }
       ]
     },
@@ -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-20251023-4c86f95.aar",
+          "url": "expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.aar",
+          "size": 393117,
+          "sha512": "9e2285f94d47b66eac6eacae8f85ba8179d0d934f648546bdfee4242cd4282663bf08c2598bdc6b6e9ba2c9f62117dc134b171c38a2350833402f4259ef83f13",
+          "sha256": "1f23e461e8a94f5149b5b22ecd2e6dec9a15a5b0a9f5656a86bfaa586a998e42",
+          "sha1": "29d197f141c1824915acd933d598b94823c3407f",
+          "md5": "b5b686523c997b2c2db9bdcfbec3bd4f"
         }
       ]
     },
@@ -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-20251023-4c86f95-sources.jar",
+          "url": "expo.modules.filesystem-19.1.0-canary-20251023-4c86f95-sources.jar",
+          "size": 29329,
+          "sha512": "6cac7b2fa58a18696e1468e4e9afe7e6092ca1a404351400345349e028cbaeda51386f4303d05372a2be2baf8de77fd97490ea91caa74bfc2a8cfe7b62619bfe",
+          "sha256": "4177d9bd9a22a528b97cc2f2bd7ba47f6cbf7fb1c09d93a1cacdce6f553b05d6",
+          "sha1": "464959bdf2015e626f82e9af6c6c28a6498240e3",
+          "md5": "d3f99d83252bbc8fcf013f07d3d86ea8"
         }
       ]
     }

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.module.md5

@@ -0,0 +1 @@
+3b0e71c7f9b207ef776e73b5ccf405e6

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.module.sha1

@@ -0,0 +1 @@
+5e4c8066d7a3d7d06f557701c464635d0d19575c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.module.sha256

@@ -0,0 +1 @@
+7e4463ab26e00d230592c7d236a99b0f7d6a44c564b104b71cdbab7c79e5c8ff

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.module.sha512

@@ -0,0 +1 @@
+c6df2b0f4e2fb579596e5a5f61706d9968148c283c3e48e9a4a1d8b0add759f254d2008a685d3987ee7906900d8f0952975e6566603df2125faea883c6d034ec

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-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.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-20251023-4c86f95</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-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.pom.md5

@@ -0,0 +1 @@
+b6fa373c559b5ab265273b5394d883ea

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.pom.sha1

@@ -0,0 +1 @@
+e1012259e511dfdee3dc365e3e0a53d143219298

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.pom.sha256

@@ -0,0 +1 @@
+2c04d1da574112646d090685e792c2584cbfd02c797a4199277d81a6f5f06bc6

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.1.0-canary-20251023-4c86f95/expo.modules.filesystem-19.1.0-canary-20251023-4c86f95.pom.sha512

@@ -0,0 +1 @@
+4d1b468af3a143f1e485bb8c47b2a88d961b6a6d34aa8141f9bfbdf808faab1394d8e018e82a6e362437e9c71881483fa0ef48b668b5a78a56ac17d1c98d2a4d

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-20251023-4c86f95</latest>
+    <release>19.1.0-canary-20251023-4c86f95</release>
     <versions>
-      <version>19.1.0-canary-20250919-7a31b96</version>
+      <version>19.1.0-canary-20251023-4c86f95</version>
     </versions>
-    <lastUpdated>20250919195357</lastUpdated>
+    <lastUpdated>20251023075058</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-9b064eb175b3ba4a8bfe3822d3f9d43a
+a7bc3f67e3c6035f2a1ef439283fd9ec

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

@@ -1 +1 @@
-184640b9b65ddd8e51200827bf267f2a0ab405bb
+3e74b671bc49450e596a3da3d6132abe9cb89991

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

@@ -1 +1 @@
-1cedddeb68e1d68ac0d4c9dbee942031c55710c73c74da1edba5fd6b93afaa14
+a34b631ce32396e145e98fd2008af0b74c64da441e2f8eff25d590b6f2a18b5c

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

@@ -1 +1 @@
-8b70e296848f602599d4c06111b237371406a5d439f68dcc486585d04e3ee42cf981dfc95cf423283c21f0036168462f3cc5c2b311afe1b20fcbea38699c5028
+997aeaa09409994797940966abe4531812845caf8f87a5c2d320425bce97373482b2fe9fa1583411d33b9b744ba6836979ae2e88e569812260be160c4fe9faf5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "19.1.0-canary-20250919-7a31b96",
+  "version": "19.1.0-canary-20251023-4c86f95",
   "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-20251023-4c86f95",
+    "jest-expo": "55.0.0-canary-20251023-4c86f95"
   },
   "peerDependencies": {
-    "expo": "55.0.0-canary-20250919-7a31b96",
+    "expo": "55.0.0-canary-20251023-4c86f95",
     "react-native": "*"
   }
 }

package/plugin/build/withFileSystem.d.ts

@@ -1,3 +1,7 @@
 import { ConfigPlugin } from 'expo/config-plugins';
-declare const _default: ConfigPlugin<void>;
+type FileSystemProps = {
+    supportsOpeningDocumentsInPlace?: boolean;
+    enableFileSharing?: boolean;
+};
+declare const _default: ConfigPlugin<FileSystemProps>;
 export default _default;

package/plugin/build/withFileSystem.js

@@ -2,11 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("expo/config-plugins");
 const pkg = require('expo-file-system/package.json');
-const withFileSystem = (config) => {
-    return config_plugins_1.AndroidConfig.Permissions.withPermissions(config, [
+const withFileSystem = (config, options = {}) => {
+    // Apply Android permissions
+    config = config_plugins_1.AndroidConfig.Permissions.withPermissions(config, [
         'android.permission.READ_EXTERNAL_STORAGE',
         'android.permission.WRITE_EXTERNAL_STORAGE',
         'android.permission.INTERNET',
     ]);
+    // Apply iOS modifications
+    return (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        if ('supportsOpeningDocumentsInPlace' in options) {
+            config.modResults.LSSupportsOpeningDocumentsInPlace = options.supportsOpeningDocumentsInPlace;
+        }
+        if ('enableFileSharing' in options) {
+            config.modResults.UIFileSharingEnabled = options.enableFileSharing;
+        }
+        return config;
+    });
 };
 exports.default = (0, config_plugins_1.createRunOncePlugin)(withFileSystem, pkg.name, pkg.version);

package/plugin/src/withFileSystem.ts

@@ -1,13 +1,35 @@
-import { AndroidConfig, ConfigPlugin, createRunOncePlugin } from 'expo/config-plugins';
+import {
+  AndroidConfig,
+  ConfigPlugin,
+  createRunOncePlugin,
+  withInfoPlist,
+} from 'expo/config-plugins';
 
 const pkg = require('expo-file-system/package.json');
 
-const withFileSystem: ConfigPlugin = (config) => {
-  return AndroidConfig.Permissions.withPermissions(config, [
+type FileSystemProps = {
+  supportsOpeningDocumentsInPlace?: boolean;
+  enableFileSharing?: boolean;
+};
+
+const withFileSystem: ConfigPlugin<FileSystemProps> = (config, options = {}) => {
+  // Apply Android permissions
+  config = AndroidConfig.Permissions.withPermissions(config, [
     'android.permission.READ_EXTERNAL_STORAGE',
     'android.permission.WRITE_EXTERNAL_STORAGE',
     'android.permission.INTERNET',
   ]);
+
+  // Apply iOS modifications
+  return withInfoPlist(config, (config) => {
+    if ('supportsOpeningDocumentsInPlace' in options) {
+      config.modResults.LSSupportsOpeningDocumentsInPlace = options.supportsOpeningDocumentsInPlace;
+    }
+    if ('enableFileSharing' in options) {
+      config.modResults.UIFileSharingEnabled = options.enableFileSharing;
+    }
+    return config;
+  });
 };
 
 export default createRunOncePlugin(withFileSystem, pkg.name, pkg.version);

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[]>;
 
@@ -316,6 +343,11 @@ export declare class File {
    * A mime type of the file. An empty string if the file does not exist, or it cannot be read.
    */
   type: string;
+  /**
+   * A content URI to the file that can be shared to external applications.
+   * @platform android
+   */
+  contentUri: string;
 }
 
 export declare class FileHandle {

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