expo-file-system 55.0.4 → 55.0.6

package/CHANGELOG.md

@@ -10,6 +10,18 @@
 
 ### 💡 Others
 
+## 55.0.6 — 2026-02-16
+
+### 🐛 Bug fixes
+
+- [Android] Fix bundle directory listing returning incorrect names, URIs and trailing slashes for files. ([#42882](https://github.com/expo/expo/pull/42882) by [@aleqsio](https://github.com/aleqsio))
+
+## 55.0.5 — 2026-02-08
+
+### 🎉 New features
+
+- Add `append` option to write methods. ([#42778](https://github.com/expo/expo/pull/42778) by [@aleqsio](https://github.com/aleqsio))
+
 ## 55.0.4 — 2026-02-03
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

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

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

@@ -93,9 +93,14 @@ class FileSystemDirectory(uri: Uri) : FileSystemPath(uri) {
     validatePermission(Permission.READ)
     return file.listFilesAsUnified().map {
       val uriString = it.uri.toString()
+      val isDir = it.isDirectory()
       mapOf(
-        "isDirectory" to it.isDirectory(),
-        "uri" to if (uriString.endsWith("/")) uriString else "$uriString/"
+        "isDirectory" to isDir,
+        "uri" to if (isDir) {
+          if (uriString.endsWith("/")) uriString else "$uriString/"
+        } else {
+          uriString
+        }
       )
     }
   }

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

@@ -50,48 +50,48 @@ class FileSystemFile(uri: Uri) : FileSystemPath(uri) {
     }
   }
 
-  fun write(content: String) {
+  fun write(content: String, append: Boolean = false) {
     validateType()
     validatePermission(Permission.WRITE)
     if (!exists) {
       create()
     }
-    file.outputStream().use { outputStream ->
+    file.outputStream(append).use { outputStream ->
       outputStream.write(content.toByteArray())
     }
   }
 
-  fun write(content: TypedArray) {
+  fun write(content: TypedArray, append: Boolean = false) {
     validateType()
     validatePermission(Permission.WRITE)
     if (!exists) {
       create()
     }
     if (uri.isContentUri) {
-      file.outputStream().use { outputStream ->
+      file.outputStream(append).use { outputStream ->
         val array = ByteArray(content.length)
         content.toDirectBuffer().get(array)
         outputStream.write(array)
       }
     } else {
-      FileOutputStream(javaFile).use {
+      FileOutputStream(javaFile, append).use {
         it.channel.write(content.toDirectBuffer())
       }
     }
   }
 
-  fun write(content: ByteArray) {
+  fun write(content: ByteArray, append: Boolean = false) {
     validateType()
     validatePermission(Permission.WRITE)
     if (!exists) {
       create()
     }
     if (uri.isContentUri) {
-      file.outputStream().use { outputStream ->
+      file.outputStream(append).use { outputStream ->
         outputStream.write(content)
       }
     } else {
-      FileOutputStream(javaFile).use {
+      FileOutputStream(javaFile, append).use {
         it.write(content)
       }
     }

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

@@ -150,18 +150,19 @@ class FileSystemModule : Module() {
       }
 
       Function("write") { file: FileSystemFile, content: Either<String, TypedArray>, options: WriteOptions? ->
+        val append = options?.append ?: false
         if (content.`is`(String::class)) {
           content.get(String::class).let {
             if (options?.encoding == EncodingType.BASE64) {
-              file.write(Base64.decode(it, Base64.DEFAULT))
+              file.write(Base64.decode(it, Base64.DEFAULT), append)
             } else {
-              file.write(it)
+              file.write(it, append)
             }
           }
         }
         if (content.`is`(TypedArray::class)) {
           content.get(TypedArray::class).let {
-            file.write(it)
+            file.write(it, append)
           }
         }
       }

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

@@ -25,7 +25,9 @@ enum class EncodingType(val value: String) : Enumerable {
 
 data class WriteOptions(
   @Field
-  val encoding: EncodingType = EncodingType.UTF8
+  val encoding: EncodingType = EncodingType.UTF8,
+  @Field
+  val append: Boolean = false
 ) : Record
 
 data class DownloadOptions(

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

@@ -210,7 +210,8 @@ open class FileSystemLegacyModule : Module() {
       val uri = Uri.parse(slashifyFilePath(uriStr))
       ensurePermission(uri, Permission.WRITE)
       val encoding = options.encoding
-      getOutputStream(uri).use { out ->
+      val append = options.append
+      getOutputStream(uri, append).use { out ->
         if (encoding == EncodingType.BASE64) {
           val bytes = Base64.decode(contents, Base64.DEFAULT)
           out.write(bytes)
@@ -1068,9 +1069,9 @@ open class FileSystemLegacyModule : Module() {
   }
 
   @Throws(IOException::class)
-  private fun getOutputStream(uri: Uri) = when {
-    uri.scheme == "file" -> FileOutputStream(uri.toFile())
-    uri.isSAFUri -> context.contentResolver.openOutputStream(uri)!!
+  private fun getOutputStream(uri: Uri, append: Boolean = false) = when {
+    uri.scheme == "file" -> FileOutputStream(uri.toFile(), append)
+    uri.isSAFUri -> context.contentResolver.openOutputStream(uri, if (append) "wa" else "w")!!
     else -> throw IOException("Unsupported scheme for location '$uri'.")
   }
 

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

@@ -63,7 +63,9 @@ data class DownloadOptionsLegacy(
 
 data class WritingOptions(
   @Field
-  val encoding: EncodingType = EncodingType.UTF8
+  val encoding: EncodingType = EncodingType.UTF8,
+  @Field
+  val append: Boolean = false
 ) : Record
 
 data class FileSystemUploadOptions(

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

@@ -50,7 +50,7 @@ class AssetFile(private val context: Context, override val uri: Uri) : UnifiedFi
       }
 
       val parentPath = currentPath.substringBeforeLast('/')
-      val parentUri = "asset://$parentPath".toUri()
+      val parentUri = "asset:///$parentPath".toUri()
 
       return AssetFile(context, parentUri)
     }
@@ -69,7 +69,10 @@ class AssetFile(private val context: Context, override val uri: Uri) : UnifiedFi
 
   override fun listFilesAsUnified(): List<UnifiedFileInterface> {
     val list = context.assets.list(path)
-    return list?.map { name -> AssetFile(context, File(path, name).toUri()) as UnifiedFileInterface } ?: emptyList()
+    return list?.map { name ->
+      val childPath = if (path.isEmpty()) name else "$path/$name"
+      AssetFile(context, "asset:///$childPath".toUri()) as UnifiedFileInterface
+    } ?: emptyList()
   }
 
   override val type: String?
@@ -95,7 +98,7 @@ class AssetFile(private val context: Context, override val uri: Uri) : UnifiedFi
     return null
   }
 
-  override fun outputStream(): OutputStream {
+  override fun outputStream(append: Boolean): OutputStream {
     throw UnsupportedOperationException("Asset files are not writable")
   }
 
@@ -131,8 +134,8 @@ class AssetFile(private val context: Context, override val uri: Uri) : UnifiedFi
     if (isDirectory()) {
       val assets = context.assets.list(path)
       assets?.forEach { assetName ->
-        val childUri = "$uri/$assetName".replace("//", "/").toUri()
-        val childFile = AssetFile(context, childUri)
+        val childPath = if (path.isEmpty()) assetName else "$path/$assetName"
+        val childFile = AssetFile(context, "asset:///$childPath".toUri())
         yieldAll(childFile.walkTopDown())
       }
     }

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

@@ -68,8 +68,8 @@ class JavaFile(override val uri: Uri) : UnifiedFileInterface, File(URI.create(ur
     }
   }
 
-  override fun outputStream(): OutputStream {
-    return FileOutputStream(this)
+  override fun outputStream(append: Boolean): OutputStream {
+    return FileOutputStream(this, append)
   }
 
   override fun inputStream(): InputStream {

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

@@ -70,14 +70,15 @@ class SAFDocumentFile(private val context: Context, override val uri: Uri) : Uni
     return null
   }
 
-  override fun outputStream(): OutputStream {
-    return context.contentResolver.openOutputStream(uri)
+  override fun outputStream(append: Boolean): OutputStream {
+    val mode = if (append) "wa" else "w"
+    return context.contentResolver.openOutputStream(uri, mode)
       ?: throw IllegalStateException("Unable to open output stream for URI: $uri")
   }
 
   override fun inputStream(): InputStream {
     return context.contentResolver.openInputStream(uri)
-      ?: throw IllegalStateException("Unable to open output stream for URI: $uri")
+      ?: throw IllegalStateException("Unable to open input stream for URI: $uri")
   }
 
   override fun length(): Long {

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

@@ -19,7 +19,7 @@ interface UnifiedFileInterface {
   val creationTime: Long?
   val fileName: String?
   fun getContentUri(appContext: AppContext): Uri
-  fun outputStream(): java.io.OutputStream
+  fun outputStream(append: Boolean = false): java.io.OutputStream
   fun inputStream(): java.io.InputStream
   fun length(): Long
   fun walkTopDown(): Sequence<UnifiedFileInterface>

package/build/ExpoFileSystem.types.d.ts

@@ -26,6 +26,11 @@ export type FileWriteOptions = {
      * @default FileSystem.EncodingType.UTF8
      */
     encoding?: EncodingType | 'utf8' | 'base64';
+    /**
+     * Whether to append the contents to the end of the file or overwrite the existing file.
+     * @default false
+     */
+    append?: boolean;
 };
 export type DirectoryCreateOptions = {
     /**

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/legacy/FileSystem.types.d.ts

@@ -244,6 +244,11 @@ export type WritingOptions = {
      * @default FileSystem.EncodingType.UTF8
      */
     encoding?: EncodingType | 'utf8' | 'base64';
+    /**
+     * Whether to append the contents to the end of the file or overwrite the existing file.
+     * @default false
+     */
+    append?: boolean;
 };
 export type DeletingOptions = {
     /**

package/build/legacy/FileSystem.types.d.ts.map

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

package/expo-module.config.json

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

package/ios/FileSystemFile.swift

@@ -75,23 +75,49 @@ internal final class FileSystemFile: FileSystemPath {
     return nil
   }
 
-  func write(_ content: String) throws {
+  func write(_ content: String, append: Bool = false) throws {
     try withCorrectTypeAndScopedAccess(permission: .write) {
-      try content.write(to: url, atomically: false, encoding: .utf8) // TODO: better error handling
+      if append, let data = content.data(using: .utf8) {
+        try writeAppending(data)
+      } else {
+        try content.write(to: url, atomically: false, encoding: .utf8) // TODO: better error handling
+      }
     }
   }
 
-  func write(_ data: Data) throws {
+  func write(_ data: Data, append: Bool = false) throws {
     try withCorrectTypeAndScopedAccess(permission: .write) {
-      try data.write(to: url)
+      if append {
+        try writeAppending(data)
+      } else {
+        try data.write(to: url)
+      }
     }
   }
 
   // TODO: blob support
-  func write(_ content: TypedArray) throws {
+  func write(_ content: TypedArray, append: Bool = false) throws {
     try withCorrectTypeAndScopedAccess(permission: .write) {
-      try Data(bytes: content.rawPointer, count: content.byteLength).write(to: url)
+      let data = Data(bytes: content.rawPointer, count: content.byteLength)
+      if append {
+        try writeAppending(data)
+      } else {
+        try data.write(to: url)
+      }
+    }
+  }
+
+  private func writeAppending(_ data: Data) throws {
+    if !FileManager.default.fileExists(atPath: url.path) {
+      try data.write(to: url)
+      return
+    }
+    let fileHandle = try FileHandle(forWritingTo: url)
+    defer {
+      fileHandle.closeFile()
     }
+    fileHandle.seekToEndOfFile()
+    fileHandle.write(data)
   }
 
   func text() throws -> String {

package/ios/FileSystemModule.swift

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

package/ios/FileSystemRecords.swift

@@ -43,4 +43,5 @@ enum WriteEncoding: String, Enumerable {
 
 struct WriteOptions: Record {
   @Field var encoding: WriteEncoding?
+  @Field var append: Bool = false
 }

package/ios/Legacy/FileSystemLegacyModule.swift

@@ -75,12 +75,32 @@ public final class FileSystemLegacyModule: Module {
     AsyncFunction("writeAsStringAsync") { (url: URL, string: String, options: WritingOptions) in
       try ensurePathPermission(appContext, path: url.path, flag: .write)
 
+      let data: Data?
       if options.encoding == .base64 {
-        try writeFileAsBase64(path: url.path, string: string)
-        return
+        data = Data(base64Encoded: string, options: .ignoreUnknownCharacters)
+      } else {
+        data = string.data(using: options.encoding.toStringEncoding() ?? .utf8)
+      }
+
+      guard let data else {
+        throw FileNotWritableException(url.path)
       }
+
       do {
-        try string.write(toFile: url.path, atomically: true, encoding: options.encoding.toStringEncoding() ?? .utf8)
+        if options.append {
+          if !FileManager.default.fileExists(atPath: url.path) {
+            try data.write(to: url, options: .atomic)
+          } else {
+            let fileHandle = try FileHandle(forWritingTo: url)
+            defer {
+              fileHandle.closeFile()
+            }
+            fileHandle.seekToEndOfFile()
+            fileHandle.write(data)
+          }
+        } else {
+          try data.write(to: url, options: .atomic)
+        }
       } catch {
         throw FileNotWritableException(url.path)
           .causedBy(error)

package/ios/Legacy/FileSystemLegacyRecords.swift

@@ -14,6 +14,7 @@ struct ReadingOptions: Record {
 
 struct WritingOptions: Record {
   @Field var encoding: Encoding = .utf8
+  @Field var append: Bool = false
 }
 
 struct DeletingOptions: Record {

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

@@ -0,0 +1 @@
+8b2504dcd7aaba91ad3ada8c1ff58302

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

@@ -0,0 +1 @@
+4de99e1e1c6e4b40cb7c35f718b62b1427badf50

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

@@ -0,0 +1 @@
+9330eaef0805d16ee837eafe6d67c12ba9402e3234bb0cced8480ffb5bb95724

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

@@ -0,0 +1 @@
+328e6fb825b497fa9aa51a7aa90760effdadd597905b9d19f831b759f46cc4b1f9669fcc7b008994e111f96aa0f06606a55cec9c6636dd43d0ccc5e5bfe8733c

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

@@ -0,0 +1 @@
+902202be8d72548d5f94cc97a93e5d94

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

@@ -0,0 +1 @@
+7f23fb8cbb29a79481a61ae98f3bb0678a965eff

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

@@ -0,0 +1 @@
+97eaf1ea3bf2a8d824bb4a28fcd230cb07cb528a2ac5668c6a25bfbf27b70d87

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

@@ -0,0 +1 @@
+fb6e6ab63fae6f645b5d81475f34db643ebff61b7e5f2eda5dd74ff819a7c38b040315ff1387b5cf812d22b736e81528523e5a04c8959dec36a17976ce78573f

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

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.filesystem",
-    "version": "55.0.4",
+    "version": "55.0.6",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -75,13 +75,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-55.0.4.aar",
-          "url": "expo.modules.filesystem-55.0.4.aar",
-          "size": 389172,
-          "sha512": "bac4c8e263a5ac9bad3d552d67bef08845b69538ea06377043b88cb85765045ecc2bf7950113a74851f8e32de0859231784cbb4c36fb377fe05a97375d240165",
-          "sha256": "2b9684d9983f06a3a381cb5d89808a501fe0ba3289128e8e19ae355f29ed6d89",
-          "sha1": "c6b80673784e3cbd1e2cab0354c3d9340b2fb433",
-          "md5": "8a8614ae30e160cdc96805c6361bacbe"
+          "name": "expo.modules.filesystem-55.0.6.aar",
+          "url": "expo.modules.filesystem-55.0.6.aar",
+          "size": 391155,
+          "sha512": "fb6e6ab63fae6f645b5d81475f34db643ebff61b7e5f2eda5dd74ff819a7c38b040315ff1387b5cf812d22b736e81528523e5a04c8959dec36a17976ce78573f",
+          "sha256": "97eaf1ea3bf2a8d824bb4a28fcd230cb07cb528a2ac5668c6a25bfbf27b70d87",
+          "sha1": "7f23fb8cbb29a79481a61ae98f3bb0678a965eff",
+          "md5": "902202be8d72548d5f94cc97a93e5d94"
         }
       ]
     },
@@ -153,13 +153,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-55.0.4.aar",
-          "url": "expo.modules.filesystem-55.0.4.aar",
-          "size": 389172,
-          "sha512": "bac4c8e263a5ac9bad3d552d67bef08845b69538ea06377043b88cb85765045ecc2bf7950113a74851f8e32de0859231784cbb4c36fb377fe05a97375d240165",
-          "sha256": "2b9684d9983f06a3a381cb5d89808a501fe0ba3289128e8e19ae355f29ed6d89",
-          "sha1": "c6b80673784e3cbd1e2cab0354c3d9340b2fb433",
-          "md5": "8a8614ae30e160cdc96805c6361bacbe"
+          "name": "expo.modules.filesystem-55.0.6.aar",
+          "url": "expo.modules.filesystem-55.0.6.aar",
+          "size": 391155,
+          "sha512": "fb6e6ab63fae6f645b5d81475f34db643ebff61b7e5f2eda5dd74ff819a7c38b040315ff1387b5cf812d22b736e81528523e5a04c8959dec36a17976ce78573f",
+          "sha256": "97eaf1ea3bf2a8d824bb4a28fcd230cb07cb528a2ac5668c6a25bfbf27b70d87",
+          "sha1": "7f23fb8cbb29a79481a61ae98f3bb0678a965eff",
+          "md5": "902202be8d72548d5f94cc97a93e5d94"
         }
       ]
     },
@@ -173,13 +173,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.filesystem-55.0.4-sources.jar",
-          "url": "expo.modules.filesystem-55.0.4-sources.jar",
-          "size": 27650,
-          "sha512": "72cb0cc7570e89b67e831ff8b6283ac3d96fff74add3e2fc53f04a76846be336a5a877e24612080aacac1786f0da74ef1b2704d86326506de629f289b9a33c58",
-          "sha256": "93bc2737eea73f9a6d6a85a9ae71695b04652af5876dbf21a60b9903e4c4133d",
-          "sha1": "e9a3ae376ac5f6353f5a8583530d56ab3d539ea2",
-          "md5": "bf72d26fe28bec2e7f5942f57fa45fa0"
+          "name": "expo.modules.filesystem-55.0.6-sources.jar",
+          "url": "expo.modules.filesystem-55.0.6-sources.jar",
+          "size": 27843,
+          "sha512": "328e6fb825b497fa9aa51a7aa90760effdadd597905b9d19f831b759f46cc4b1f9669fcc7b008994e111f96aa0f06606a55cec9c6636dd43d0ccc5e5bfe8733c",
+          "sha256": "9330eaef0805d16ee837eafe6d67c12ba9402e3234bb0cced8480ffb5bb95724",
+          "sha1": "4de99e1e1c6e4b40cb7c35f718b62b1427badf50",
+          "md5": "8b2504dcd7aaba91ad3ada8c1ff58302"
         }
       ]
     }

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

@@ -0,0 +1 @@
+1c632ad49c2b36f0075cc86d7d9773dd

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

@@ -0,0 +1 @@
+e6702506ef6b96d35ce7407e8e08d1be9e2a4d2f

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

@@ -0,0 +1 @@
+3b5b1ed5d9cef20c04afa473bd1af4d47f03a0e5b988dd2d2629fb244db59957

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

@@ -0,0 +1 @@
+2205bc508440d92e8c724bdbf2ffc23d4bb386228ec4a0f8126302574d9f1f3640a73d28ef916fdcd4f2adc9992a6fc36a492fc172c0ee231994c172f87d6f9d

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

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

@@ -0,0 +1 @@
+e7bbef241bcb1ebd6e018dffd8185927

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

@@ -0,0 +1 @@
+7f9780e200e743b7f2f72058a373e9001810faff

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

@@ -0,0 +1 @@
+08830483f8f16b9543340a36770c17c8c23bffa6d00231c555acca9d5be74c19

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

@@ -0,0 +1 @@
+63f159be4ba0b9ee4247d304c3767c728cc9d8179c04bb4a8ef1c7b580c469c0d333e43a48587ff2ed71b59a2e982f38a0521e54c7e5bc67a59d559cb4720fb0

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>55.0.4</latest>
-    <release>55.0.4</release>
+    <latest>55.0.6</latest>
+    <release>55.0.6</release>
     <versions>
-      <version>55.0.4</version>
+      <version>55.0.6</version>
     </versions>
-    <lastUpdated>20260203054508</lastUpdated>
+    <lastUpdated>20260216170142</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-8d74f78e65cb7a79ed3766ac545c4909
+007ba82e8f59892d5c26ff9e5dbbb05a

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

@@ -1 +1 @@
-15f7d7110ed24b9aa47a9fffd3a071b1115b22e0
+3d4931e005e122c589d8d068a95cd15217158b3e

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

@@ -1 +1 @@
-9fb67f125075d31612bcf7548eeb846a5f27619d04b2f1c39d4966e604da059c
+30347f406e9fb93d8163c38bcec9f1bc705b2b91060969dd82063dc64bc3a0ed

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

@@ -1 +1 @@
-78eaa32e0d01dcdc074678b6efb9dfe4eef27d67fa9d1ee96efe0807b939b5d35fd49b3f0828d54487657c83fbbac418066ddfaa09e868ffbd1b206246b643a9
+b2aaffd4cddf98b38d354064393cc0f89ffd2bef6cfc79b5b2c7cba1ef99a9010a9c97624cff160064ff2243316a5df7a60be605019e992550777f6d97948934

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "55.0.4",
+  "version": "55.0.6",
   "description": "Provides access to the local file system on the device.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -55,5 +55,5 @@
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "436ffb4355d5207f4a03fbc3568cd33424a40f3e"
+  "gitHead": "928cc951854450f3c72e00e8e420e567fabd1f8c"
 }

package/src/ExpoFileSystem.types.ts

@@ -28,6 +28,11 @@ export type FileWriteOptions = {
    * @default FileSystem.EncodingType.UTF8
    */
   encoding?: EncodingType | 'utf8' | 'base64';
+  /**
+   * Whether to append the contents to the end of the file or overwrite the existing file.
+   * @default false
+   */
+  append?: boolean;
 };
 
 export type DirectoryCreateOptions = {

package/src/legacy/FileSystem.types.ts

@@ -269,6 +269,11 @@ export type WritingOptions = {
    * @default FileSystem.EncodingType.UTF8
    */
   encoding?: EncodingType | 'utf8' | 'base64';
+  /**
+   * Whether to append the contents to the end of the file or overwrite the existing file.
+   * @default false
+   */
+  append?: boolean;
 };
 
 export type DeletingOptions = {

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

@@ -1 +0,0 @@
-bf72d26fe28bec2e7f5942f57fa45fa0

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

@@ -1 +0,0 @@
-e9a3ae376ac5f6353f5a8583530d56ab3d539ea2

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

@@ -1 +0,0 @@
-93bc2737eea73f9a6d6a85a9ae71695b04652af5876dbf21a60b9903e4c4133d

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

@@ -1 +0,0 @@
-72cb0cc7570e89b67e831ff8b6283ac3d96fff74add3e2fc53f04a76846be336a5a877e24612080aacac1786f0da74ef1b2704d86326506de629f289b9a33c58

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

@@ -1 +0,0 @@
-8a8614ae30e160cdc96805c6361bacbe

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

@@ -1 +0,0 @@
-c6b80673784e3cbd1e2cab0354c3d9340b2fb433

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

@@ -1 +0,0 @@
-2b9684d9983f06a3a381cb5d89808a501fe0ba3289128e8e19ae355f29ed6d89

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

@@ -1 +0,0 @@
-bac4c8e263a5ac9bad3d552d67bef08845b69538ea06377043b88cb85765045ecc2bf7950113a74851f8e32de0859231784cbb4c36fb377fe05a97375d240165

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

@@ -1 +0,0 @@
-6ed01e1c8df2e254ab252148d180d80b

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

@@ -1 +0,0 @@
-6fd46eb6b2b937c2a9a8fd2dfecdaf17e1c9da6a

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

@@ -1 +0,0 @@
-e00575c2f9215ecd92499dd6f3fb110f0c3d64fb42eebff8b6237dad86bc7411

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

@@ -1 +0,0 @@
-05f3579f7e3b31ae8545376a3d05298ec757fb82c078f07572faa732804bf2972bc0342157c5aa58b6c97f359a6fe67c95d428278fad57945b3d204ae9d17774

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

@@ -1 +0,0 @@
-057fb4b4a48a67fedd3b35a8ccf69471

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

@@ -1 +0,0 @@
-a992635ee4affb5f4735cce7f954ab782c397ffd

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

@@ -1 +0,0 @@
-7b10bd037b382eb8b5583d5bb9820ba7357bc12fa34f316796d9a5ba6ffbdbaf

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

@@ -1 +0,0 @@
-43bd9036b0759300231c34f4c4d2354b10e20587a58c78bc349ef2921ee0e189b5cb1469dc1bbb1b94d08a0a92cdfd5a21f063663e2b45a2619ac0d041885cfe