expo-file-system 19.0.15 → 19.0.16

package/CHANGELOG.md

@@ -10,6 +10,17 @@
 
 ### 💡 Others
 
+## 19.0.16 — 2025-10-01
+
+### 🎉 New features
+
+- Add write options for base64 encoded bytes. ([#39963](https://github.com/expo/expo/pull/39963) by [@aleqsio](https://github.com/aleqsio))
+
+### 🐛 Bug fixes
+
+- Fix typedoc in the File class. ([#40064](https://github.com/expo/expo/pull/40064) by [@aleqsio](https://github.com/aleqsio))
+- [Android] Fix getContentUri. ([#40001](https://github.com/expo/expo/pull/40001) by [@aleqsio](https://github.com/aleqsio))
+
 ## 19.0.15 — 2025-09-22
 
 ### 🎉 New features

package/android/build.gradle

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

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

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

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

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

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

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

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

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

package/build/ExpoFileSystem.types.d.ts

@@ -10,6 +10,23 @@ export type FileCreateOptions = {
      */
     overwrite?: boolean;
 };
+export declare enum EncodingType {
+    /**
+     * Standard encoding format.
+     */
+    UTF8 = "utf8",
+    /**
+     * Binary, radix-64 representation.
+     */
+    Base64 = "base64"
+}
+export type FileWriteOptions = {
+    /**
+     * The encoding format to use when writing the file.
+     * @default FileSystem.EncodingType.UTF8
+     */
+    encoding?: EncodingType | 'utf8' | 'base64';
+};
 export type DirectoryCreateOptions = {
     /**
      * Whether to create intermediate directories if they do not exist.
@@ -187,7 +204,7 @@ export declare class File {
      * Writes content to the file.
      * @param content The content to write into the file.
      */
-    write(content: string | Uint8Array): void;
+    write(content: string | Uint8Array, options: FileWriteOptions): void;
     /**
      * Deletes a file.
      *

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

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

package/build/FileSystem.d.ts

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

package/expo-module.config.json

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

package/ios/FileSystemExceptions.swift

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

package/ios/FileSystemFile.swift

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

package/ios/FileSystemModule.swift

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

package/ios/FileSystemRecords.swift

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+87d735cdcd4a073816bf205bbf6dbe7c

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

@@ -0,0 +1 @@
+b75600742761aa7454e90367911205a044962027

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

@@ -0,0 +1 @@
+feab8d53caa9bbf48cf41532048ac5f206b0ab482118d2279a5124126902b9fa

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

@@ -0,0 +1 @@
+c6a7ae1fb95df6076dd160993ce6650502806e924f35b7e87fa03f0f6060bc7db14f7a603692ce8b880f84462404d59dd8129b486a1e732c5b9d1cc4c255440d

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

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.filesystem",
-    "version": "19.0.15",
+    "version": "19.0.16",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -75,13 +75,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.15.aar",
-          "url": "expo.modules.filesystem-19.0.15.aar",
-          "size": 386747,
-          "sha512": "acbe861a908142be88eae95809a80e51574b5a70c980bc45fa0c1c634972e7ee98ca03d9286e6a2aca0b9b2764e3e92e4f484472a587e9330f1cf9efb3b866a9",
-          "sha256": "38db39dc4425a365524ef25cca51740a6c671970a34c27bc8da80ad7ef853a97",
-          "sha1": "795f2aa667934af20b277058a973e66e567aabd5",
-          "md5": "65a90c8c307beb7e905d5d1b87f47f71"
+          "name": "expo.modules.filesystem-19.0.16.aar",
+          "url": "expo.modules.filesystem-19.0.16.aar",
+          "size": 390234,
+          "sha512": "c6a7ae1fb95df6076dd160993ce6650502806e924f35b7e87fa03f0f6060bc7db14f7a603692ce8b880f84462404d59dd8129b486a1e732c5b9d1cc4c255440d",
+          "sha256": "feab8d53caa9bbf48cf41532048ac5f206b0ab482118d2279a5124126902b9fa",
+          "sha1": "b75600742761aa7454e90367911205a044962027",
+          "md5": "87d735cdcd4a073816bf205bbf6dbe7c"
         }
       ]
     },
@@ -153,13 +153,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.15.aar",
-          "url": "expo.modules.filesystem-19.0.15.aar",
-          "size": 386747,
-          "sha512": "acbe861a908142be88eae95809a80e51574b5a70c980bc45fa0c1c634972e7ee98ca03d9286e6a2aca0b9b2764e3e92e4f484472a587e9330f1cf9efb3b866a9",
-          "sha256": "38db39dc4425a365524ef25cca51740a6c671970a34c27bc8da80ad7ef853a97",
-          "sha1": "795f2aa667934af20b277058a973e66e567aabd5",
-          "md5": "65a90c8c307beb7e905d5d1b87f47f71"
+          "name": "expo.modules.filesystem-19.0.16.aar",
+          "url": "expo.modules.filesystem-19.0.16.aar",
+          "size": 390234,
+          "sha512": "c6a7ae1fb95df6076dd160993ce6650502806e924f35b7e87fa03f0f6060bc7db14f7a603692ce8b880f84462404d59dd8129b486a1e732c5b9d1cc4c255440d",
+          "sha256": "feab8d53caa9bbf48cf41532048ac5f206b0ab482118d2279a5124126902b9fa",
+          "sha1": "b75600742761aa7454e90367911205a044962027",
+          "md5": "87d735cdcd4a073816bf205bbf6dbe7c"
         }
       ]
     },
@@ -173,13 +173,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.filesystem-19.0.15-sources.jar",
-          "url": "expo.modules.filesystem-19.0.15-sources.jar",
-          "size": 28571,
-          "sha512": "5e896d6a549d64430a226c22eb689f3d84f088506657d2985750534e5840f17b1c903a4fee9cd9a915f47a3e6773596b1f33bd388570e9f4fd360ac2d5d54521",
-          "sha256": "243397e0d8c3e68d5bce371d9a1ac30805c8b93e4f2940d0ddb312d5056ef292",
-          "sha1": "8de8a89b5e329ae1f0989a09d1fc13fe6b672fb5",
-          "md5": "e4ed87add3090ef9b1f273d33bc37969"
+          "name": "expo.modules.filesystem-19.0.16-sources.jar",
+          "url": "expo.modules.filesystem-19.0.16-sources.jar",
+          "size": 28785,
+          "sha512": "60c1582dab4e6504250846af398e2e5993b17a7c14c141282407f8f7f7949256331d238c5ea32afb7c5753903fc0b868fe1a79c3f972ea2525e947744005c6dc",
+          "sha256": "2ce5bf618d3e1370e92da41b3ae54847ee10874310bac1c7a31918ea9b463777",
+          "sha1": "d372fc4ea514b436e89656c186c54f3c27320b7e",
+          "md5": "eb9c254f5ab2514e83db9dd934eaa22c"
         }
       ]
     }

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

@@ -0,0 +1 @@
+0d446f8b0a79a7de05074e1b098b6601

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

@@ -0,0 +1 @@
+9aba248a42b385e7fda4cca5746b2a558bdae056

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

@@ -0,0 +1 @@
+dbc438671dad3d9ecc355bb0a26971e115bd4aa098c41cdd9e86d69053b90f88

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

@@ -0,0 +1 @@
+5924747e355b59660367ab020f805afbea65b5f506f6673a9f06cac9343b362c472c4d96588a97944393b9cec3f75271c1a8aa516097f475985badc7944b6c1b

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

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

@@ -0,0 +1 @@
+64d5cb2e4efcfd67348f8b9327477cca

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

@@ -0,0 +1 @@
+98c45d5273e1d874978c5b336e587e0453d4b5cc

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

@@ -0,0 +1 @@
+9fd2cff40ef53e89777a2dc995002720fb7e374e2fa808b903802961746178ba

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

@@ -0,0 +1 @@
+5ee2686dec6aa95c7e1a8de47a63033bdf696758808744e079a151f3e390242b9cf7c66985a92b8e36c81d0b5ff4508fd7311929029668098c017f9cb9e33285

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.15</latest>
-    <release>19.0.15</release>
+    <latest>19.0.16</latest>
+    <release>19.0.16</release>
     <versions>
-      <version>19.0.15</version>
+      <version>19.0.16</version>
     </versions>
-    <lastUpdated>20250922222656</lastUpdated>
+    <lastUpdated>20251001002202</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-a08705e104bf3a3a429e74130057d2cc
+70816adde62d1cabb634f2d24c390556

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

@@ -1 +1 @@
-1a08d359f25fe0e05ddab478bc5674d5613bff84
+8e488291cf4e0ddf1a2bb0b1e43c507b4c05150b

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

@@ -1 +1 @@
-1b96b0a5aee52850d256c440c7b1f0551ff55e7b9d97ddb8ee824c10d58b7d74
+182697a7c3a5a66cc3676be5ea1e4114c8efb000bf682749bcbfc47b53228257

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

@@ -1 +1 @@
-e56211b815de4697d1fb6341550a2fa3e0015466daf2ce8440953e457aee1307b2700912284ee69f5ed5afd2fbd21a6800385efc24de868b4f4cefd3200955aa
+af9e7e36960251e4ad9d0ab63105464bcb20251ede5c2705c7f1e80eb07371a9087c9610624f97c4b5e23c5a3a766db5dcf99ee0f6b89aa2b9e54b8d48a15c52

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "19.0.15",
+  "version": "19.0.16",
   "description": "Provides access to the local file system on the device.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -42,5 +42,5 @@
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "6523053d0d997d2a21f580d2752b2f873c122038"
+  "gitHead": "1ab3b9621b78b77b81049ebf06149753a1e0898c"
 }

package/src/ExpoFileSystem.types.ts

@@ -11,6 +11,25 @@ export type FileCreateOptions = {
   overwrite?: boolean;
 };
 
+export enum EncodingType {
+  /**
+   * Standard encoding format.
+   */
+  UTF8 = 'utf8',
+  /**
+   * Binary, radix-64 representation.
+   */
+  Base64 = 'base64',
+}
+
+export type FileWriteOptions = {
+  /**
+   * The encoding format to use when writing the file.
+   * @default FileSystem.EncodingType.UTF8
+   */
+  encoding?: EncodingType | 'utf8' | 'base64';
+};
+
 export type DirectoryCreateOptions = {
   /**
    * Whether to create intermediate directories if they do not exist.
@@ -212,7 +231,7 @@ export declare class File {
    * Writes content to the file.
    * @param content The content to write into the file.
    */
-  write(content: string | Uint8Array): void;
+  write(content: string | Uint8Array, options: FileWriteOptions): void;
 
   /**
    * Deletes a file.

package/src/FileSystem.ts

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1 +0,0 @@
-edb9b08217271bbd4befa89eb738d0f2

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

@@ -1 +0,0 @@
-5fec8c09cdc861ef19fb7949c088a1e339b669ce

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

@@ -1 +0,0 @@
-8a122e20c3496ba05ce6a47b5505fa9fdd756c2a41d5b47376a58c3686485e1a

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

@@ -1 +0,0 @@
-9a660930a1f487c38b1bb23f51eb84ba9d44e98e41041e8116785f1b026850ab2aa65cfadf4b7e881ff230ef43689c78fe92dd5a081cb02468b94ce857a8e3c0

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

@@ -1 +0,0 @@
-535fe0d5278cdb592991164f4249319a

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

@@ -1 +0,0 @@
-3965b36a2d431f5b037b85b03efd6e757b8e966f

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

@@ -1 +0,0 @@
-bc5aad17ac0c14a65fa0d1cbd707e397ad87855cda5ee7ec90c18ef319105790

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

@@ -1 +0,0 @@
-9fc3e1e35258de6ed24367b89ebd600ba65f09a12ed80d5699f3f161efd687d4e36a0c46633ff6b3d43509e2ef1fae3458e467cc3976a2ddddd2a5dd9a993dbf