expo-file-system 19.0.6 → 19.0.8

package/CHANGELOG.md

@@ -10,6 +10,19 @@
 
 ### 💡 Others
 
+## 19.0.8 — 2025-09-02
+
+### 🎉 New features
+
+- [iOS] Add `pickFileAsync` support ([#39173](https://github.com/expo/expo/pull/39173) by [@kosmydel](https://github.com/kosmydel))
+
+## 19.0.7 — 2025-08-31
+
+### 🎉 New features
+
+- Add `rename` method for files and directories ([#39138](https://github.com/expo/expo/pull/39138) by [@kosmydel](https://github.com/kosmydel))
+- Add `idempotent` option for creating directories ([#39121](https://github.com/expo/expo/pull/39121) by [@kosmydel](https://github.com/kosmydel))
+
 ## 19.0.6 — 2025-08-26
 
 _This version does not introduce any user-facing changes._
@@ -37,6 +50,7 @@ _This version does not introduce any user-facing changes._
 ### 💡 Others
 
 - Update typings for `typescript@5.9` ([#38833](https://github.com/expo/expo/pull/38833) by [@kitten](https://github.com/kitten))
+- Change Constants to Constant/Property. ([#38926](https://github.com/expo/expo/pull/38926) by [@jakex7](https://github.com/jakex7))
 
 ## 19.0.0 — 2025-08-13
 

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '19.0.6'
+version = '19.0.8'
 
 android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "19.0.6"
+    versionName "19.0.8"
   }
 }
 

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

@@ -53,6 +53,9 @@ class FileSystemDirectory(uri: Uri) : FileSystemPath(uri) {
   fun create(options: CreateOptions = CreateOptions()) {
     validateType()
     validatePermission(Permission.WRITE)
+    if (!needsCreation(options)) {
+      return
+    }
     validateCanCreate(options)
     if (uri.isContentUri) {
       throw UnableToCreateException("create function does not work with SAF Uris, use `createDirectory` and `createFile` instead")
@@ -101,4 +104,8 @@ class FileSystemDirectory(uri: Uri) : FileSystemPath(uri) {
     val uriString = file.uri.toString()
     return if (uriString.endsWith("/")) uriString else "$uriString/"
   }
+
+  fun needsCreation(options: CreateOptions): Boolean {
+    return !file.exists() || !options.idempotent
+  }
 }

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

@@ -28,11 +28,17 @@ class FileSystemModule : Module() {
   override fun definition() = ModuleDefinition {
     Name("FileSystem")
 
-    Constants(
-      "documentDirectory" to Uri.fromFile(context.filesDir).toString() + "/",
-      "cacheDirectory" to Uri.fromFile(context.cacheDir).toString() + "/",
-      "bundleDirectory" to "asset://"
-    )
+    Constant("documentDirectory") {
+      Uri.fromFile(context.filesDir).toString() + "/"
+    }
+
+    Constant("cacheDirectory") {
+      Uri.fromFile(context.cacheDir).toString() + "/"
+    }
+
+    Constant("bundleDirectory") {
+      "asset://"
+    }
 
     Property("totalDiskSpace") {
       File(context.filesDir.path).totalSpace
@@ -193,6 +199,10 @@ class FileSystemModule : Module() {
         file.move(destination)
       }
 
+      Function("rename") { file: FileSystemFile, newName: String ->
+        file.rename(newName)
+      }
+
       Property("uri") { file ->
         file.asString()
       }
@@ -286,6 +296,10 @@ class FileSystemModule : Module() {
         directory.move(destination)
       }
 
+      Function("rename") { directory: FileSystemDirectory, newName: String ->
+        directory.rename(newName)
+      }
+
       Property("uri") { directory ->
         directory.asString()
       }

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

@@ -12,7 +12,9 @@ data class CreateOptions(
   @Field
   val intermediates: Boolean = false,
   @Field
-  val overwrite: Boolean = false
+  val overwrite: Boolean = false,
+  @Field
+  val idempotent: Boolean = false
 ) : Record
 
 data class DownloadOptions(

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

@@ -163,6 +163,20 @@ abstract class FileSystemPath(var uri: Uri) : SharedObject() {
     }
   }
 
+  fun rename(newName: String) {
+    validateType()
+    validatePermission(Permission.WRITE)
+    val newFile = File(javaFile.parent, newName)
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+      javaFile.toPath().moveTo(newFile.toPath())
+      uri = newFile.toUri()
+    } else {
+      javaFile.copyTo(newFile)
+      javaFile.delete()
+      uri = newFile.toUri()
+    }
+  }
+
   val modificationTime: Long? get() {
     validateType()
     return file.lastModified()

package/android/src/main/java/expo/modules/filesystem/legacy/FileSystemLegacyModule.kt

@@ -89,11 +89,17 @@ open class FileSystemLegacyModule : Module() {
   override fun definition() = ModuleDefinition {
     Name("ExponentFileSystem")
 
-    Constants(
-      "documentDirectory" to Uri.fromFile(context.filesDir).toString() + "/",
-      "cacheDirectory" to Uri.fromFile(context.cacheDir).toString() + "/",
-      "bundleDirectory" to "asset:///"
-    )
+    Constant("documentDirectory") {
+      Uri.fromFile(context.filesDir).toString() + "/"
+    }
+
+    Constant("cacheDirectory") {
+      Uri.fromFile(context.cacheDir).toString() + "/"
+    }
+
+    Constant("bundleDirectory") {
+      "asset:///"
+    }
 
     Events(
       EXDownloadProgressEventName,

package/build/ExpoFileSystem.types.d.ts

@@ -1,15 +1,37 @@
-export type CreateOptions = {
+export type FileCreateOptions = {
     /**
      * Whether to create intermediate directories if they do not exist.
      * @default false
      */
     intermediates?: boolean;
     /**
-     * Whether to overwrite the file or directory if it exists.
+     * Whether to overwrite the file if it exists.
      * @default false
      */
     overwrite?: boolean;
 };
+export type DirectoryCreateOptions = {
+    /**
+     * Whether to create intermediate directories if they do not exist.
+     * @default false
+     */
+    intermediates?: boolean;
+    /**
+     * Whether to overwrite the directory if it exists.
+     * @default false
+     */
+    overwrite?: boolean;
+    /**
+     * This flag controls whether the `create` operation is idempotent
+     * (safe to call multiple times without error).
+     *
+     * If `true`, creating a file or directory that already exists will succeed silently.
+     * If `false`, an error will be thrown when the target already exists.
+     *
+     * @default false
+     */
+    idempotent?: boolean;
+};
 export declare class Directory {
     /**
      * Creates an instance of a directory.
@@ -42,9 +64,9 @@ export declare class Directory {
     /**
      * Creates a directory that the current uri points to.
      *
-     * @throws Error if the containing folder doesn't exist, the application has no read access to it or the directory (or a file with the same path) already exists.
+     * @throws Error if the containing folder doesn't exist, the application has no read access to it or the directory (or a file with the same path) already exists (unless `idempotent` is `true`).
      */
-    create(options?: CreateOptions): void;
+    create(options?: DirectoryCreateOptions): void;
     createFile(name: string, mimeType: string | null): File;
     createDirectory(name: string): Directory;
     /**
@@ -55,6 +77,10 @@ export declare class Directory {
      * Moves a directory. Updates the `uri` property that now points to the new location.
      */
     move(destination: Directory | File): void;
+    /**
+     * Renames a directory.
+     */
+    rename(newName: string): void;
     /**
      * @hidden
      * Lists the contents of a directory. Should not be used directly, as it returns a list of paths.
@@ -172,7 +198,7 @@ export declare class File {
      *
      * @throws Error if the containing folder doesn't exist, the application has no read access to it or the file (or directory with the same path) already exists.
      */
-    create(options?: CreateOptions): void;
+    create(options?: FileCreateOptions): void;
     /**
      * Copies a file.
      */
@@ -181,6 +207,10 @@ export declare class File {
      * Moves a directory. Updates the `uri` property that now points to the new location.
      */
     move(destination: Directory | File): void;
+    /**
+     * Renames a file.
+     */
+    rename(newName: string): void;
     /**
      * Returns A `FileHandle` object that can be used to read and write data to the file.
      * @throws Error if the file does not exist or cannot be opened.
@@ -201,16 +231,15 @@ export declare class File {
      */
     static downloadFileAsync(url: string, destination: Directory | File, options?: DownloadOptions): Promise<File>;
     /**
-     * A static method that opens a file picker to select a single file of specified type.
+     * A static method that opens a file picker to select a single file of specified type. On iOS, it returns a temporary copy of the file leaving the original file untouched.
      *
-     * @platform android
+     * Selecting multiple files is not supported yet.
      *
      * @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.
-     * @platform android
+     * @returns a `File` instance or an array of `File` instances.
      */
-    static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File>;
+    static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File | File[]>;
     /**
      * A size of the file in bytes. 0 if the file does not exist, or it cannot be read.
      */

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/index.d.ts

@@ -1,3 +1,3 @@
 export * from './FileSystem';
-export { type CreateOptions, 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, } from './ExpoFileSystem.types';
 //# 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,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,wBAAwB,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,GACnB,MAAM,wBAAwB,CAAC"}

package/expo-module.config.json

@@ -12,7 +12,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.filesystem",
-      "version": "19.0.6",
+      "version": "19.0.8",
       "repository": "local-maven-repo"
     }
   }

package/ios/FilePickingHandler.swift

@@ -0,0 +1,87 @@
+// UIKit is unavailable on macOS, so platform checks are necessary.
+// For macOS support, we should consider using NSOpenPanel: https://developer.apple.com/documentation/appkit/nsopenpanel
+#if os(iOS) || os(tvOS)
+import ExpoModulesCore
+import UIKit
+
+internal class FilePickingHandler: FilePickingResultHandler {
+  private weak var module: FileSystemModule?
+  internal var filePickingContext: FilePickingContext?
+
+  init(module: FileSystemModule) {
+    self.module = module
+  }
+
+  func presentDocumentPicker(
+    picker: UIDocumentPickerViewController,
+    isDirectory: Bool,
+    initialUri: URL?,
+    mimeType: String?,
+    promise: Promise
+  ) {
+    guard let module = module else {
+      promise.reject(MissingViewControllerException())
+      return
+    }
+
+    if filePickingContext != nil {
+      promise.reject(PickingInProgressException())
+      return
+    }
+
+    guard let currentVc = module.appContext?.utilities?.currentViewController() else {
+      promise.reject(MissingViewControllerException())
+      return
+    }
+
+    let pickerDelegate = FilePickingDelegate(resultHandler: self, isDirectory: isDirectory)
+    filePickingContext = FilePickingContext(
+      promise: promise,
+      initialUri: initialUri,
+      mimeType: mimeType,
+      isDirectory: isDirectory,
+      delegate: pickerDelegate
+    )
+
+    picker.delegate = pickerDelegate
+    picker.presentationController?.delegate = pickerDelegate
+    picker.allowsMultipleSelection = false
+
+    if UIDevice.current.userInterfaceIdiom == .pad {
+      let viewFrame = currentVc.view.frame
+      picker.popoverPresentationController?.sourceRect = CGRect(
+        x: viewFrame.midX,
+        y: viewFrame.maxY,
+        width: 0,
+        height: 0
+      )
+      picker.popoverPresentationController?.sourceView = currentVc.view
+      picker.modalPresentationStyle = .pageSheet
+    }
+
+    currentVc.present(picker, animated: true)
+  }
+
+  func didPickFileAt(url: URL) {
+    handlePickingResult { context in
+      let file = FileSystemFile(url: url)
+      context.promise.resolve(file)
+    }
+  }
+
+  func didCancelPicking() {
+    handlePickingResult { context in
+      context.promise.reject(FilePickingCancelledException())
+    }
+  }
+
+  private func handlePickingResult(_ handler: (FilePickingContext) -> Void) {
+    guard let context = filePickingContext else {
+      return
+    }
+    filePickingContext = nil
+
+    handler(context)
+  }
+}
+#endif

package/ios/FilePickingUtils.swift

@@ -0,0 +1,133 @@
+#if os(iOS) || os(tvOS)
+import ExpoModulesCore
+import MobileCoreServices
+import UIKit
+import UniformTypeIdentifiers
+
+internal protocol FilePickingResultHandler {
+  func didPickFileAt(url: URL)
+  func didCancelPicking()
+}
+
+internal struct FilePickingContext {
+  let promise: Promise
+  let initialUri: URL?
+  let mimeType: String?
+  let isDirectory: Bool
+  let delegate: FilePickingDelegate
+  var pickedUrl: URL?
+}
+
+internal class FilePickingDelegate: NSObject, UIDocumentPickerDelegate, UIAdaptivePresentationControllerDelegate {
+  private let resultHandler: FilePickingResultHandler
+  private let isDirectory: Bool
+  private weak var pickingHandler: FilePickingHandler?
+
+  init(resultHandler: FilePickingResultHandler, isDirectory: Bool = false) {
+    self.resultHandler = resultHandler
+    self.isDirectory = isDirectory
+    self.pickingHandler = resultHandler as? FilePickingHandler
+  }
+
+  func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
+    guard let url = urls.first else {
+      self.resultHandler.didCancelPicking()
+      return
+    }
+
+    self.resultHandler.didPickFileAt(url: url)
+  }
+
+  func documentPickerWasCancelled(_ controller: UIDocumentPickerViewController) {
+    self.resultHandler.didCancelPicking()
+  }
+
+  func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
+    self.resultHandler.didCancelPicking()
+  }
+}
+
+internal func createFilePicker(initialUri: URL?, mimeType: String?) -> UIDocumentPickerViewController {
+  if #available(iOS 14.0, *) {
+    let utTypes: [UTType]
+    if let mimeType = mimeType {
+      if let utType = UTType(mimeType: mimeType) {
+        utTypes = [utType]
+      } else {
+        utTypes = [UTType.item]
+      }
+    } else {
+      utTypes = [UTType.item]
+    }
+
+    let picker = UIDocumentPickerViewController(forOpeningContentTypes: utTypes, asCopy: true)
+
+    if let initialUri = initialUri {
+      picker.directoryURL = initialUri
+    }
+
+    return picker
+  }
+
+  let utiTypes: [String]
+  if let mimeType = mimeType {
+    utiTypes = [toUTI(mimeType: mimeType)]
+  } else {
+    utiTypes = [kUTTypeItem as String]
+  }
+
+  let picker = UIDocumentPickerViewController(documentTypes: utiTypes, in: .import)
+
+  if let initialUri = initialUri {
+    picker.directoryURL = initialUri
+  }
+
+  return picker
+}
+
+@available(iOS 14.0, *)
+private func toUTType(mimeType: String) -> UTType? {
+  switch mimeType {
+  case "*/*":
+    return UTType.item
+  case "image/*":
+    return UTType.image
+  case "video/*":
+    return UTType.movie
+  case "audio/*":
+    return UTType.audio
+  case "text/*":
+    return UTType.text
+  default:
+    return UTType(mimeType: mimeType)
+  }
+}
+
+private func toUTI(mimeType: String) -> String {
+  var uti: CFString
+
+  switch mimeType {
+  case "*/*":
+    uti = kUTTypeItem
+  case "image/*":
+    uti = kUTTypeImage
+  case "video/*":
+    uti = kUTTypeVideo
+  case "audio/*":
+    uti = kUTTypeAudio
+  case "text/*":
+    uti = kUTTypeText
+  default:
+    if let ref = UTTypeCreatePreferredIdentifierForTag(
+      kUTTagClassMIMEType,
+      mimeType as CFString,
+      nil
+    )?.takeRetainedValue() {
+      uti = ref
+    } else {
+      uti = kUTTypeItem
+    }
+  }
+  return uti as String
+}
+#endif

package/ios/FileSystemDirectory.swift

@@ -19,6 +19,9 @@ internal final class FileSystemDirectory: FileSystemPath {
   func create(_ options: CreateOptions) throws {
     try validatePermission(.write)
     try validateType()
+    guard try needsCreation(options) else {
+      return
+    }
     try validateCanCreate(options)
     do {
       try FileManager.default.createDirectory(at: url, withIntermediateDirectories: options.intermediates, attributes: nil)
@@ -97,4 +100,11 @@ internal final class FileSystemDirectory: FileSystemPath {
       throw UnableToGetInfoException("url scheme \(String(describing: url.scheme)) is not supported")
     }
   }
+
+  func needsCreation(_ options: CreateOptions) throws -> Bool {
+    if !exists {
+      return true
+    }
+    return !options.idempotent
+  }
 }

package/ios/FileSystemExceptions.swift

@@ -72,3 +72,27 @@ internal final class MissingPermissionException: GenericException<String> {
     "Missing permission for uri: \(param)"
   }
 }
+
+internal final class PickingInProgressException: Exception {
+  override var reason: String {
+    "File picking is already in progress"
+  }
+}
+
+internal final class MissingViewControllerException: Exception {
+  override var reason: String {
+    "No view controller available for presenting file picker"
+  }
+}
+
+internal final class FilePickingCancelledException: Exception {
+  override var reason: String {
+    "File picking was cancelled by the user"
+  }
+}
+
+internal final class FeatureNotAvailableOnPlatformException: Exception {
+  override var reason: String {
+    "This feature is not available on this platform"
+  }
+}

package/ios/FileSystemModule.swift

@@ -4,6 +4,10 @@ import ExpoModulesCore
 
 @available(iOS 14, tvOS 14, *)
 public final class FileSystemModule: Module {
+  #if os(iOS) || os(tvOS)
+  private lazy var filePickingHandler = FilePickingHandler(module: self)
+  #endif
+
   var documentDirectory: URL? {
     return appContext?.config.documentDirectory
   }
@@ -31,13 +35,20 @@ public final class FileSystemModule: Module {
   public func definition() -> ModuleDefinition {
     Name("FileSystem")
 
-    Constants {
-      return [
-        "documentDirectory": documentDirectory?.absoluteString,
-        "cacheDirectory": cacheDirectory?.absoluteString,
-        "bundleDirectory": Bundle.main.bundlePath,
-        "appleSharedContainers": getAppleSharedContainers()
-      ]
+    Constant("documentDirectory") {
+      return documentDirectory?.absoluteString
+    }
+
+    Constant("cacheDirectory") {
+      return cacheDirectory?.absoluteString
+    }
+
+    Constant("bundleDirectory") {
+      return Bundle.main.bundlePath
+    }
+
+    Constant("appleSharedContainers") {
+      return getAppleSharedContainers()
     }
 
     Property("totalDiskSpace") {
@@ -95,6 +106,20 @@ public final class FileSystemModule: Module {
       downloadTask.resume()
     }
 
+    AsyncFunction("pickFileAsync") { (initialUri: URL?, mimeType: String?, promise: Promise) in
+      #if os(iOS) || os(tvOS)
+      filePickingHandler.presentDocumentPicker(
+        picker: createFilePicker(initialUri: initialUri, mimeType: mimeType),
+        isDirectory: false,
+        initialUri: initialUri,
+        mimeType: mimeType,
+        promise: promise
+      )
+      #else
+      promise.reject(FeatureNotAvailableOnPlatformException())
+      #endif
+    }.runOnQueue(.main)
+
     Function("info") { (url: URL) in
       let output = PathInfo()
       output.exists = false
@@ -208,6 +233,10 @@ public final class FileSystemModule: Module {
         try file.move(to: to)
       }
 
+      Function("rename") { (file, newName: String) in
+        try file.rename(newName)
+      }
+
       Property("uri") { file in
         return file.url.absoluteString
       }
@@ -272,6 +301,10 @@ public final class FileSystemModule: Module {
         try directory.move(to: to)
       }
 
+      Function("rename") { (directory, newName: String) in
+        try directory.rename(newName)
+      }
+
       // this function is internal and will be removed in the future (when returning arrays of shared objects is supported)
       Function("listAsRecords") { directory in
         try directory.listAsRecords()

package/ios/FileSystemPath.swift

@@ -76,6 +76,19 @@ internal class FileSystemPath: SharedObject {
     url = destinationUrl
   }
 
+  func getRenamedUrl(newName: String) -> URL {
+    return url.deletingLastPathComponent().appendingPathComponent(newName)
+  }
+
+  func rename(_ newName: String) throws {
+    try validatePermission(.write)
+    let newUrl = getRenamedUrl(newName: newName)
+    try FileManager.default.moveItem(at: url, to: newUrl)
+    // Refetch the URL to ensure it has the correct trailing slash, which differs for directories and files.
+    let updatedUrl = getRenamedUrl(newName: newName)
+    url = updatedUrl
+  }
+
   var modificationTime: Int64 {
     get throws {
       let modificationDate: Date = try getAttribute(.modificationDate, atPath: url.path)

package/ios/FileSystemRecords.swift

@@ -5,6 +5,7 @@ import ExpoModulesCore
 struct CreateOptions: Record {
   @Field var intermediates: Bool = false
   @Field var overwrite: Bool = false
+  @Field var idempotent: Bool = false
 }
 
 struct DownloadOptions: Record {

package/ios/Legacy/FileSystemLegacyModule.swift

@@ -27,12 +27,16 @@ public final class FileSystemLegacyModule: Module {
   public func definition() -> ModuleDefinition {
     Name("ExponentFileSystem")
 
-    Constants {
-      return [
-        "documentDirectory": documentDirectory?.absoluteString,
-        "cacheDirectory": cacheDirectory?.absoluteString,
-        "bundleDirectory": Bundle.main.bundlePath
-      ]
+    Constant("documentDirectory") {
+      return documentDirectory?.absoluteString
+    }
+
+    Constant("cacheDirectory") {
+      return cacheDirectory?.absoluteString
+    }
+
+    Constant("bundleDirectory") {
+      return Bundle.main.bundlePath
     }
 
     Events(EVENT_DOWNLOAD_PROGRESS, EVENT_UPLOAD_PROGRESS)

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8-sources.jar.md5

@@ -0,0 +1 @@
+792cb40c62c2c908a410b672981f14b0

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8-sources.jar.sha1

@@ -0,0 +1 @@
+1c9d91c71b0534cc4967a352ccb7864aa71054c1

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8-sources.jar.sha256

@@ -0,0 +1 @@
+267e88a3c5d6745c834050282f9a45c0305f51c7b8554e18e0b68a16ab337edb

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8-sources.jar.sha512

@@ -0,0 +1 @@
+b8f0a84aa8f6377f6fb162699e663d8e9de63caff453a37513e1cfeeaaa050261f8ae32032f15e8968e8591d518531d46e8e549c745b2998ee16fc7578903872

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.aar.md5

@@ -0,0 +1 @@
+5af511777ab5671351368ebf881eb54b

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.aar.sha1

@@ -0,0 +1 @@
+91a70d10d282ea3c01290747edd6b4f19226ad65

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.aar.sha256

@@ -0,0 +1 @@
+25644f10378a71e515dcfe1df64fb41fef0862fdfbe9cf52ac91675939cd76fb

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.aar.sha512

@@ -0,0 +1 @@
+56d4b780eb2b6164377db2d9756e9d1d6872436d2313f75a77b4ffce8be47d92c2fc502cc87369554a595d1844763bdb6ce3d14dc68ef849379070a259f920f3

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/{19.0.6/expo.modules.filesystem-19.0.6.module → 19.0.8/expo.modules.filesystem-19.0.8.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.filesystem",
-    "version": "19.0.6",
+    "version": "19.0.8",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -75,13 +75,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.6.aar",
-          "url": "expo.modules.filesystem-19.0.6.aar",
-          "size": 373316,
-          "sha512": "36dc7ab692103570111d72588e7674ae1c7cf2c0665a351738f87dc0af98dbccb34aef221f34b5630403f2d6fd46a13cd22e4b3fb75a90f6b8b0bc2a41dd49cf",
-          "sha256": "977ef17ccaa7a6f8c09c70d2f2f2f0c1002f07df8b3756ce3905a37a7288b41b",
-          "sha1": "7f26aacfe041259700988a8f2e865b6d78a47865",
-          "md5": "67fb8fe6d438a03c9f9b1419f17a116d"
+          "name": "expo.modules.filesystem-19.0.8.aar",
+          "url": "expo.modules.filesystem-19.0.8.aar",
+          "size": 386221,
+          "sha512": "56d4b780eb2b6164377db2d9756e9d1d6872436d2313f75a77b4ffce8be47d92c2fc502cc87369554a595d1844763bdb6ce3d14dc68ef849379070a259f920f3",
+          "sha256": "25644f10378a71e515dcfe1df64fb41fef0862fdfbe9cf52ac91675939cd76fb",
+          "sha1": "91a70d10d282ea3c01290747edd6b4f19226ad65",
+          "md5": "5af511777ab5671351368ebf881eb54b"
         }
       ]
     },
@@ -153,13 +153,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.6.aar",
-          "url": "expo.modules.filesystem-19.0.6.aar",
-          "size": 373316,
-          "sha512": "36dc7ab692103570111d72588e7674ae1c7cf2c0665a351738f87dc0af98dbccb34aef221f34b5630403f2d6fd46a13cd22e4b3fb75a90f6b8b0bc2a41dd49cf",
-          "sha256": "977ef17ccaa7a6f8c09c70d2f2f2f0c1002f07df8b3756ce3905a37a7288b41b",
-          "sha1": "7f26aacfe041259700988a8f2e865b6d78a47865",
-          "md5": "67fb8fe6d438a03c9f9b1419f17a116d"
+          "name": "expo.modules.filesystem-19.0.8.aar",
+          "url": "expo.modules.filesystem-19.0.8.aar",
+          "size": 386221,
+          "sha512": "56d4b780eb2b6164377db2d9756e9d1d6872436d2313f75a77b4ffce8be47d92c2fc502cc87369554a595d1844763bdb6ce3d14dc68ef849379070a259f920f3",
+          "sha256": "25644f10378a71e515dcfe1df64fb41fef0862fdfbe9cf52ac91675939cd76fb",
+          "sha1": "91a70d10d282ea3c01290747edd6b4f19226ad65",
+          "md5": "5af511777ab5671351368ebf881eb54b"
         }
       ]
     },
@@ -173,13 +173,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.6-sources.jar",
-          "url": "expo.modules.filesystem-19.0.6-sources.jar",
-          "size": 28421,
-          "sha512": "c91977ae610fa808ea0765cd14182ad1d8961f59cbdf2df2396e7f77fe8cadbcd152018902a4f09474177b5ea77f78c107d6016c127d0546c4e9b0ebbf2b13fe",
-          "sha256": "9cf826cfa827700e415e780bc1b4a49477ea31486d465154824b7331c89e9dc7",
-          "sha1": "5f879a11258f3b3e06b575f71e801aab8e25113b",
-          "md5": "8e4953080a31fa4851c0d3af21f5f2a8"
+          "name": "expo.modules.filesystem-19.0.8-sources.jar",
+          "url": "expo.modules.filesystem-19.0.8-sources.jar",
+          "size": 28550,
+          "sha512": "b8f0a84aa8f6377f6fb162699e663d8e9de63caff453a37513e1cfeeaaa050261f8ae32032f15e8968e8591d518531d46e8e549c745b2998ee16fc7578903872",
+          "sha256": "267e88a3c5d6745c834050282f9a45c0305f51c7b8554e18e0b68a16ab337edb",
+          "sha1": "1c9d91c71b0534cc4967a352ccb7864aa71054c1",
+          "md5": "792cb40c62c2c908a410b672981f14b0"
         }
       ]
     }

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.module.md5

@@ -0,0 +1 @@
+910772c14e4d377fdf880d1f14683815

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.module.sha1

@@ -0,0 +1 @@
+edf18906655a9e36799a9fd7a4a0a0504d80c7b4

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.module.sha256

@@ -0,0 +1 @@
+42270c63b7df7a7e5d137d6c77f95b0a8a2aaa33325e69c7b4426caf00a21e8c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.module.sha512

@@ -0,0 +1 @@
+7ac666d194796a12dc4fcb504841bd4f1aa9073e73f8c6166fe35d3679ae078e1ae857a94f9f3285abfb042ef69c051dcfd81aa1f1ed5311e9f4cf9493a90a59

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/{19.0.6/expo.modules.filesystem-19.0.6.pom → 19.0.8/expo.modules.filesystem-19.0.8.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.filesystem</artifactId>
-  <version>19.0.6</version>
+  <version>19.0.8</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.0.8/expo.modules.filesystem-19.0.8.pom.md5

@@ -0,0 +1 @@
+bcf64ce87633dbe2a6143eea0ca47bb9

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.pom.sha1

@@ -0,0 +1 @@
+13ef2346544744def69586053a19731cfb269b18

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.pom.sha256

@@ -0,0 +1 @@
+602db45c912619293ac6cf4d840554e6269d8572329dde7f5af51d6d1174a883

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.8/expo.modules.filesystem-19.0.8.pom.sha512

@@ -0,0 +1 @@
+ec765be6812ea03216616a6ed18c3b28ce4f4d8f60fa8c6400c629204426074fc9373ffd65290d8f3f735408401fe47e140fd2754aebcd0a3729f57f82839bd0

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.0.6</latest>
-    <release>19.0.6</release>
+    <latest>19.0.8</latest>
+    <release>19.0.8</release>
     <versions>
-      <version>19.0.6</version>
+      <version>19.0.8</version>
     </versions>
-    <lastUpdated>20250826172804</lastUpdated>
+    <lastUpdated>20250902175113</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-c14c2616f065148d676957ac2daec817
+42876019a2c534b254bcc519820b1a83

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

@@ -1 +1 @@
-916672a04fb5d9ab23c2ea10835d120c7d0d4457
+eeba47e1c3b9979298a9ff3e5f5e21a0721a16dc

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

@@ -1 +1 @@
-2035f9bd454ad732e2fc1524d4821cbe3c2dc27cfede9a10a80ad5dea96b1697
+6d9ade77b228fbce494829fbc4a09a437b07cbc2bb89011bf3a84c349a4749fa

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

@@ -1 +1 @@
-f5abcdea24e961a071ba75c5e5f49decbb1c8082a5d38b48ba59be97c24feb8fd182aed8ca90c6653c6bef553dde35744035433ee875570202ea16b2a45c719b
+34e81020fc62cdc3e7d46321907a3f51b3802e95dd3716f63f2863237708f41c9c3b79c26cd14ba1cd8d9bb4cde63aa24d8cfa54299d6c330b494f1454a596d2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "19.0.6",
+  "version": "19.0.8",
   "description": "Provides access to the local file system on the device.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -35,12 +35,12 @@
     "preset": "expo-module-scripts"
   },
   "devDependencies": {
-    "expo-module-scripts": "^5.0.4",
-    "jest-expo": "~54.0.4"
+    "expo-module-scripts": "^5.0.6",
+    "jest-expo": "~54.0.7"
   },
   "peerDependencies": {
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "d44e41c9c0714a838b1652556d27bcb506fabbdf"
+  "gitHead": "d635404a12ea7996b987ce0fb7679a238ebcf31b"
 }

package/src/ExpoFileSystem.types.ts

@@ -1,16 +1,39 @@
-export type CreateOptions = {
+export type FileCreateOptions = {
   /**
    * Whether to create intermediate directories if they do not exist.
    * @default false
    */
   intermediates?: boolean;
   /**
-   * Whether to overwrite the file or directory if it exists.
+   * Whether to overwrite the file if it exists.
    * @default false
    */
   overwrite?: boolean;
 };
 
+export type DirectoryCreateOptions = {
+  /**
+   * Whether to create intermediate directories if they do not exist.
+   * @default false
+   */
+  intermediates?: boolean;
+  /**
+   * Whether to overwrite the directory if it exists.
+   * @default false
+   */
+  overwrite?: boolean;
+  /**
+   * This flag controls whether the `create` operation is idempotent
+   * (safe to call multiple times without error).
+   *
+   * If `true`, creating a file or directory that already exists will succeed silently.
+   * If `false`, an error will be thrown when the target already exists.
+   *
+   * @default false
+   */
+  idempotent?: boolean;
+};
+
 export declare class Directory {
   /**
    * Creates an instance of a directory.
@@ -48,9 +71,9 @@ export declare class Directory {
   /**
    * Creates a directory that the current uri points to.
    *
-   * @throws Error if the containing folder doesn't exist, the application has no read access to it or the directory (or a file with the same path) already exists.
+   * @throws Error if the containing folder doesn't exist, the application has no read access to it or the directory (or a file with the same path) already exists (unless `idempotent` is `true`).
    */
-  create(options?: CreateOptions): void;
+  create(options?: DirectoryCreateOptions): void;
 
   createFile(name: string, mimeType: string | null): File;
 
@@ -66,6 +89,11 @@ export declare class Directory {
    */
   move(destination: Directory | File): void;
 
+  /**
+   * Renames a directory.
+   */
+  rename(newName: string): void;
+
   /**
    * @hidden
    * Lists the contents of a directory. Should not be used directly, as it returns a list of paths.
@@ -199,7 +227,7 @@ export declare class File {
    *
    * @throws Error if the containing folder doesn't exist, the application has no read access to it or the file (or directory with the same path) already exists.
    */
-  create(options?: CreateOptions): void;
+  create(options?: FileCreateOptions): void;
 
   /**
    * Copies a file.
@@ -211,6 +239,11 @@ export declare class File {
    */
   move(destination: Directory | File): void;
 
+  /**
+   * Renames a file.
+   */
+  rename(newName: string): void;
+
   /**
    * Returns A `FileHandle` object that can be used to read and write data to the file.
    * @throws Error if the file does not exist or cannot be opened.
@@ -237,16 +270,15 @@ export declare class File {
   ): Promise<File>;
 
   /**
-   * A static method that opens a file picker to select a single file of specified type.
+   * A static method that opens a file picker to select a single file of specified type. On iOS, it returns a temporary copy of the file leaving the original file untouched.
    *
-   * @platform android
+   * Selecting multiple files is not supported yet.
    *
    * @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.
-   * @platform android
+   * @returns a `File` instance or an array of `File` instances.
    */
-  static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File>;
+  static pickFileAsync(initialUri?: string, mimeType?: string): Promise<File | File[]>;
 
   /**
    * A size of the file in bytes. 0 if the file does not exist, or it cannot be read.

package/src/index.ts

@@ -1,7 +1,8 @@
 export * from './FileSystem';
 
 export {
-  type CreateOptions,
+  type FileCreateOptions,
+  type DirectoryCreateOptions,
   type FileHandle,
   type FileInfo,
   type InfoOptions,

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6-sources.jar.md5

@@ -1 +0,0 @@
-8e4953080a31fa4851c0d3af21f5f2a8

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6-sources.jar.sha1

@@ -1 +0,0 @@
-5f879a11258f3b3e06b575f71e801aab8e25113b

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6-sources.jar.sha256

@@ -1 +0,0 @@
-9cf826cfa827700e415e780bc1b4a49477ea31486d465154824b7331c89e9dc7

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6-sources.jar.sha512

@@ -1 +0,0 @@
-c91977ae610fa808ea0765cd14182ad1d8961f59cbdf2df2396e7f77fe8cadbcd152018902a4f09474177b5ea77f78c107d6016c127d0546c4e9b0ebbf2b13fe

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.aar.md5

@@ -1 +0,0 @@
-67fb8fe6d438a03c9f9b1419f17a116d

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.aar.sha1

@@ -1 +0,0 @@
-7f26aacfe041259700988a8f2e865b6d78a47865

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.aar.sha256

@@ -1 +0,0 @@
-977ef17ccaa7a6f8c09c70d2f2f2f0c1002f07df8b3756ce3905a37a7288b41b

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.aar.sha512

@@ -1 +0,0 @@
-36dc7ab692103570111d72588e7674ae1c7cf2c0665a351738f87dc0af98dbccb34aef221f34b5630403f2d6fd46a13cd22e4b3fb75a90f6b8b0bc2a41dd49cf

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.module.md5

@@ -1 +0,0 @@
-7a30c0dd94620ad6d4b349c4768849cf

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.module.sha1

@@ -1 +0,0 @@
-244290223c70f2fa559e6ac33637b48d5a8fe030

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.module.sha256

@@ -1 +0,0 @@
-30cd879db3d67a93bbb86483e0e47f54a109f1e4dfbb33c2726401c737503b44

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.module.sha512

@@ -1 +0,0 @@
-d901e0bd5c6391eb748e76ad90a69263c236f8c87d1e8e23b5852d09803e4db69e96b909177165c6869b3d0decc843e1daab4d61a93fa17bda56964588e9545b

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.pom.md5

@@ -1 +0,0 @@
-abff231e2fb99adbfde79370e6fa1395

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.pom.sha1

@@ -1 +0,0 @@
-018d4dbaa67ec3eb39fb639ef68e39a06d303ad7

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.pom.sha256

@@ -1 +0,0 @@
-fa1bdccedadabacbd2a0c6bc51aa70233255f74486b3c6b99e99829e58973760

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.6/expo.modules.filesystem-19.0.6.pom.sha512

@@ -1 +0,0 @@
-91daccf5e4bfef06a91de0573936e5d637bd29472ece40112290d9cc5d65bc545d8adc3070662fefc4140d51eeddc09b6ff64b5403476a1c750cfb173273f6bd