expo-file-system 19.0.6 → 19.0.7

package/CHANGELOG.md

@@ -10,6 +10,13 @@
 
 ### 💡 Others
 
+## 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._

package/android/build.gradle

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

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

@@ -193,6 +193,10 @@ class FileSystemModule : Module() {
         file.move(destination)
       }
 
+      Function("rename") { file: FileSystemFile, newName: String ->
+        file.rename(newName)
+      }
+
       Property("uri") { file ->
         file.asString()
       }
@@ -286,6 +290,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/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.

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

@@ -1 +1 @@
-{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../src/ExpoFileSystem.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAElD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,IAAI,IAAI;IAEpB;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAEd;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAErC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAEvD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAExC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAEzC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAEzC;;;;OAIG;IACH,aAAa,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE;IAEvD;;OAEG;IACH,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE;IAE5B;;;;;;OAMG;IACH,IAAI,IAAI,aAAa;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CACnE;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI;IACvB;;;;OAIG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAElD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,IAAI,IAAI;IAEpB;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAElB;;;OAGG;IACH,MAAM,IAAI,MAAM;IAEhB;;;OAGG;IACH,UAAU,IAAI,MAAM;IAEpB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEzC;;;OAGG;IACH,SAAS,IAAI,UAAU;IAEvB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAEzC;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAEd;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ;IAErC;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAErC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAEzC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAEzC;;;OAGG;IACH,IAAI,IAAI,UAAU;IAElB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,iBAAiB,CACtB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,SAAS,GAAG,IAAI,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3E;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,CAAC,OAAO,OAAO,UAAU;IAI7B,KAAK,IAAI,IAAI;IAKb,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC;IAKlD,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAItB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;;;OAIG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC"}
+{"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.7",
       "repository": "local-maven-repo"
     }
   }

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/FileSystemModule.swift

@@ -208,6 +208,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 +276,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/local-maven-repo/host/exp/exponent/expo.modules.filesystem/19.0.7/expo.modules.filesystem-19.0.7-sources.jar.md5

@@ -0,0 +1 @@
+c155ff9ad88368334bea4f91422d8d32

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

@@ -0,0 +1 @@
+d674cc8fccd186f29334b506c24efcfdfac2e40a

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

@@ -0,0 +1 @@
+d40b6af1ade1a3e62958afbeb12170073ec4b0e9171e20ba91cdb1e1ae1b04ac

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

@@ -0,0 +1 @@
+883e3e975a1c678ab873b0e1a009d6b2e047daf7e3a21a8444a848a6f67b93ede413ae71029d59732541d9aa7bd7c9067626b0fd70a13e1d428da0e1e5a3bd9d

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

@@ -0,0 +1 @@
+3131a757a0b15f33c69b92145bbdbfbe

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

@@ -0,0 +1 @@
+65ea240b61a6bafa919d7fd66917aa1bbbb4fbc9

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

@@ -0,0 +1 @@
+3b1f05d11977bd8acba506764a3ed15e1bc517e7aaec57112545923c8b81ab04

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

@@ -0,0 +1 @@
+de4ccf9ef1c373a39e75d149e717061316cba471c546ad5247bc629083868d5e8700322898b147d22aa845fcd9e5f0ec1fca48c0d76025dddb41b3b300360627

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

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.filesystem",
-    "version": "19.0.6",
+    "version": "19.0.7",
     "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.7.aar",
+          "url": "expo.modules.filesystem-19.0.7.aar",
+          "size": 376534,
+          "sha512": "de4ccf9ef1c373a39e75d149e717061316cba471c546ad5247bc629083868d5e8700322898b147d22aa845fcd9e5f0ec1fca48c0d76025dddb41b3b300360627",
+          "sha256": "3b1f05d11977bd8acba506764a3ed15e1bc517e7aaec57112545923c8b81ab04",
+          "sha1": "65ea240b61a6bafa919d7fd66917aa1bbbb4fbc9",
+          "md5": "3131a757a0b15f33c69b92145bbdbfbe"
         }
       ]
     },
@@ -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.7.aar",
+          "url": "expo.modules.filesystem-19.0.7.aar",
+          "size": 376534,
+          "sha512": "de4ccf9ef1c373a39e75d149e717061316cba471c546ad5247bc629083868d5e8700322898b147d22aa845fcd9e5f0ec1fca48c0d76025dddb41b3b300360627",
+          "sha256": "3b1f05d11977bd8acba506764a3ed15e1bc517e7aaec57112545923c8b81ab04",
+          "sha1": "65ea240b61a6bafa919d7fd66917aa1bbbb4fbc9",
+          "md5": "3131a757a0b15f33c69b92145bbdbfbe"
         }
       ]
     },
@@ -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.7-sources.jar",
+          "url": "expo.modules.filesystem-19.0.7-sources.jar",
+          "size": 28557,
+          "sha512": "883e3e975a1c678ab873b0e1a009d6b2e047daf7e3a21a8444a848a6f67b93ede413ae71029d59732541d9aa7bd7c9067626b0fd70a13e1d428da0e1e5a3bd9d",
+          "sha256": "d40b6af1ade1a3e62958afbeb12170073ec4b0e9171e20ba91cdb1e1ae1b04ac",
+          "sha1": "d674cc8fccd186f29334b506c24efcfdfac2e40a",
+          "md5": "c155ff9ad88368334bea4f91422d8d32"
         }
       ]
     }

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

@@ -0,0 +1 @@
+50785801d5f35f044c1ea21593e51f48

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

@@ -0,0 +1 @@
+ec4c9821f147b921c38dfd75fe8ccfb87ab04ba9

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

@@ -0,0 +1 @@
+df378e667196c0a9fb856d02a0a7d4b761d3975d0345a970338cc8fcf7c17bff

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

@@ -0,0 +1 @@
+e9ef84e5f83b6e1705e1b5a7802682aec4f49c2f91a001291c9bdd79d1b1a71f51b9fa08b8204e1dc08522a9e0c6214288d4a8e87a1a1ac6806ccbcb08e038e7

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/{19.0.6/expo.modules.filesystem-19.0.6.pom → 19.0.7/expo.modules.filesystem-19.0.7.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.7</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.7/expo.modules.filesystem-19.0.7.pom.md5

@@ -0,0 +1 @@
+7b2e9b63735f2cdcfefb2e6bd3f1e179

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

@@ -0,0 +1 @@
+7bde55a9fe9a7dd0c99e05411602f7de65973ad7

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

@@ -0,0 +1 @@
+711ea03d039b3c3ceabdc4f9de6d3c45fa054f5892763c708de0e416135e7b41

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

@@ -0,0 +1 @@
+9ce4435eef9347f5860fce84c95feca14bf7746d4d6ed079f27c25ab77bc1b3249a8df72ea4c946c8200efdc4cebd38573fef10fb9bf931512e0e5de2a19c6ab

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

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

@@ -1 +1 @@
-c14c2616f065148d676957ac2daec817
+dcab33e619a12cb1280ed5526609c42d

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

@@ -1 +1 @@
-916672a04fb5d9ab23c2ea10835d120c7d0d4457
+238a976822d6a261fa7f76460d534d4f5934233f

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

@@ -1 +1 @@
-2035f9bd454ad732e2fc1524d4821cbe3c2dc27cfede9a10a80ad5dea96b1697
+3693e2c2f2b219f586d17150a2433838d437328d308c677cbcb50d8d5da61709

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

@@ -1 +1 @@
-f5abcdea24e961a071ba75c5e5f49decbb1c8082a5d38b48ba59be97c24feb8fd182aed8ca90c6653c6bef553dde35744035433ee875570202ea16b2a45c719b
+3959d1f0b20eec078018d1dbc67f436883b499575c2b2175e940500c8e822e569509a3b0f7141f4d3c772b0816d22d0bdf9c5993fb110983f8be35f8c7f195dc

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "19.0.6",
+  "version": "19.0.7",
   "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.5",
+    "jest-expo": "~54.0.5"
   },
   "peerDependencies": {
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "d44e41c9c0714a838b1652556d27bcb506fabbdf"
+  "gitHead": "1dafdaa317c182191909a94a355c8b08a2654783"
 }

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.

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