expo-file-system 18.1.10 → 18.2.0-canary-20250611-f0afe80

package/CHANGELOG.md

@@ -6,10 +6,16 @@
 
 ### 🎉 New features
 
+- Add support for custom headers in downloadFileAsync ([#36108](https://github.com/expo/expo/pull/36108) by [@leonhh](https://github.com/leonhh))
+
 ### 🐛 Bug fixes
 
+- Improved type safety in the FileSystem module to support tsconfig setups with stricter rules than the default. ([#37107](https://github.com/expo/expo/pull/37107) by [@hirbod](https://github.com/hirbod))
+
 ### 💡 Others
 
+- Remove "Please" from warnings and errors ([#36862](https://github.com/expo/expo/pull/36862) by [@brentvatne](https://github.com/brentvatne))
+
 ## 18.1.10 — 2025-05-08
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '18.1.10'
+version = '18.2.0-canary-20250611-f0afe80'
 
 android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "18.1.10"
+    versionName "18.2.0-canary-20250611-f0afe80"
   }
 }
 

package/android/src/main/java/expo/modules/filesystem/next/FileSystemNextModule.kt

@@ -32,9 +32,15 @@ class FileSystemNextModule : Module() {
       "bundleDirectory" to "asset:///"
     )
 
-    AsyncFunction("downloadFileAsync") Coroutine { url: URI, to: FileSystemPath ->
+    AsyncFunction("downloadFileAsync") Coroutine { url: URI, to: FileSystemPath, options: DownloadOptionsNext? ->
       to.validatePermission(Permission.WRITE)
-      val request = Request.Builder().url(url.toURL()).build()
+      val requestBuilder = Request.Builder().url(url.toURL())
+
+      options?.headers?.forEach { (key, value) ->
+        requestBuilder.addHeader(key, value)
+      }
+
+      val request = requestBuilder.build()
       val client = OkHttpClient()
       val response = request.await(client)
 

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

@@ -9,3 +9,8 @@ data class CreateOptions(
   @Field
   val overwrite: Boolean = false
 ) : Record
+
+data class DownloadOptionsNext(
+  @Field
+  val headers: Map<String, String> = emptyMap()
+) : Record

package/build/FileSystem.d.ts

@@ -143,7 +143,7 @@ export declare function downloadAsync(uri: string, fileUri: string, options?: Do
  *
  * **Server**
  *
- * Please refer to the "[Server: Handling multipart requests](#server-handling-multipart-requests)" example - there is code for a simple Node.js server.
+ * Refer to the "[Server: Handling multipart requests](#server-handling-multipart-requests)" example - there is code for a simple Node.js server.
  * @return Returns a Promise that resolves to `FileSystemUploadResult` object.
  */
 export declare function uploadAsync(url: string, fileUri: string, options?: FileSystemUploadOptions): Promise<FileSystemUploadResult>;

package/build/next/ExpoFileSystem.d.ts

@@ -1,9 +1,9 @@
 import { NativeModule } from 'expo-modules-core';
-import type { Directory, File } from './ExpoFileSystem.types';
+import type { Directory, File, DownloadOptions } from './ExpoFileSystem.types';
 declare class ExpoFileSystemNextModule extends NativeModule {
     FileSystemDirectory: typeof Directory;
     FileSystemFile: typeof File;
-    downloadFileAsync(url: string, destination: File | Directory): Promise<string>;
+    downloadFileAsync(url: string, destination: File | Directory, options?: DownloadOptions): Promise<string>;
 }
 declare const _default: ExpoFileSystemNextModule;
 export default _default;

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

@@ -1 +1 @@
-{"version":3,"file":"ExpoFileSystem.d.ts","sourceRoot":"","sources":["../../src/next/ExpoFileSystem.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,OAAO,wBAAyB,SAAQ,YAAY;IACzD,mBAAmB,EAAE,OAAO,SAAS,CAAC;IACtC,cAAc,EAAE,OAAO,IAAI,CAAC;IAC5B,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;CAC/E;;AAED,wBAEoE"}
+{"version":3,"file":"ExpoFileSystem.d.ts","sourceRoot":"","sources":["../../src/next/ExpoFileSystem.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG/E,OAAO,OAAO,wBAAyB,SAAQ,YAAY;IACzD,mBAAmB,EAAE,OAAO,SAAS,CAAC;IACtC,cAAc,EAAE,OAAO,IAAI,CAAC;IAC5B,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,IAAI,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC;CACnB;;AAED,wBAEoE"}

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

@@ -68,6 +68,14 @@ export declare class Directory {
      */
     list(): (Directory | File)[];
 }
+export type DownloadOptions = {
+    /**
+     * The headers to send with the request.
+     */
+    headers?: {
+        [key: string]: string;
+    };
+};
 /**
  * Represents a file on the file system.
  */
@@ -147,7 +155,7 @@ export declare class File {
      * const file = await File.downloadFileAsync("https://example.com/image.png", new Directory(Paths.document));
      * ```
      */
-    static downloadFileAsync(url: string, destination: Directory | File): Promise<File>;
+    static downloadFileAsync(url: string, destination: Directory | File, options?: DownloadOptions): Promise<File>;
     /**
      * A size of the file in bytes. Null if the file does not exist, or it cannot be read.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../../src/next/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;;;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;;;;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;CAC7B;AAED;;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,MAAM;IAEd;;;OAGG;IACH,MAAM,IAAI,MAAM;IAEhB;;;OAGG;IACH,KAAK,IAAI,UAAU;IAEnB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAEzC;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAEd;;;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;;;;;;;;;OASG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnF;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,OAAO,UAAU;IAI7B,KAAK,IAAI,IAAI;IAKb,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAKrC,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAItB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB"}
+{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../../src/next/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;;;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;;;;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;CAC7B;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,MAAM;IAEd;;;OAGG;IACH,MAAM,IAAI,MAAM;IAEhB;;;OAGG;IACH,KAAK,IAAI,UAAU;IAEnB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAEzC;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAEd;;;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;;;;;;;;;OASG;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;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,OAAO,UAAU;IAI7B,KAAK,IAAI,IAAI;IAKb,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAKrC,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAItB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB"}

package/build/next/FileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../src/next/FileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,qBAAa,KAAM,SAAQ,aAAa;IACtC;;OAEG;IACH,MAAM,KAAK,KAAK,cAEf;IAED;;OAEG;IACH,MAAM,KAAK,QAAQ,cAElB;IACD,MAAM,KAAK,qBAAqB,8BAO/B;CACF;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,IAAI;IAChC,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAc;gBAEb,IAAI,EAAE,IAAI;IAKtB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAInC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAIlC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAIpC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAGhE;AAED,qBAAa,IAAK,SAAQ,cAAc,CAAC,cAAc;IACrD;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,IAAI,IAAI;IAOZ,IAAI,eAAe,cAElB;IAED;;;OAGG;IACH,IAAI,SAAS,WAEZ;IAED;;OAEG;IACH,IAAI,IAAI,WAEP;IAED,cAAc;IAId,cAAc;CAGf;AAQD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cAAc,CAAC,mBAAmB;IAC/D;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,eAAe,cAElB;IAED;;;;OAIG;IACH,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE;IAO5B;;OAEG;IACH,IAAI,IAAI,WAEP;CACF"}
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../src/next/FileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,qBAAa,KAAM,SAAQ,aAAa;IACtC;;OAEG;IACH,MAAM,KAAK,KAAK,cAEf;IAED;;OAEG;IACH,MAAM,KAAK,QAAQ,cAElB;IACD,MAAM,KAAK,qBAAqB,8BAS/B;CACF;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,IAAI;IAChC,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAc;gBAEb,IAAI,EAAE,IAAI;IAKtB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAInC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAIlC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAIpC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAGhE;AAED,qBAAa,IAAK,SAAQ,cAAc,CAAC,cAAc;IACrD;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,IAAI,IAAI;IAOZ,IAAI,eAAe,cAElB;IAED;;;OAGG;IACH,IAAI,SAAS,WAEZ;IAED;;OAEG;IACH,IAAI,IAAI,WAEP;IAED,cAAc;IAId,cAAc;CAGf;AAYD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cAAc,CAAC,mBAAmB;IAC/D;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,eAAe,cAElB;IAED;;;;OAIG;IACH,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE;IAO5B;;OAEG;IACH,IAAI,IAAI,WAEP;CACF"}

package/expo-module.config.json

@@ -8,6 +8,12 @@
     "modules": [
       "expo.modules.filesystem.FileSystemModule",
       "expo.modules.filesystem.next.FileSystemNextModule"
-    ]
+    ],
+    "publication": {
+      "groupId": "host.exp.exponent",
+      "artifactId": "expo.modules.filesystem",
+      "version": "18.2.0-canary-20250611-f0afe80",
+      "repository": "local-maven-repo"
+    }
   }
 }

package/ios/Next/FileSystemNextModule.swift

@@ -16,10 +16,18 @@ public final class FileSystemNextModule: Module {
       ]
     }
 
-    AsyncFunction("downloadFileAsync") { (url: URL, to: FileSystemPath, promise: Promise) in
+    AsyncFunction("downloadFileAsync") { (url: URL, to: FileSystemPath, options: DownloadOptionsNext?, promise: Promise) in
       try to.validatePermission(.write)
 
-      let downloadTask = URLSession.shared.downloadTask(with: url) { urlOrNil, responseOrNil, errorOrNil in
+      var request = URLRequest(url: url)
+
+      if let headers = options?.headers {
+        headers.forEach { key, value in
+          request.addValue(value, forHTTPHeaderField: key)
+        }
+      }
+
+      let downloadTask = URLSession.shared.downloadTask(with: request) { urlOrNil, responseOrNil, errorOrNil in
         guard errorOrNil == nil else {
           return promise.reject(UnableToDownloadException(errorOrNil?.localizedDescription ?? "unspecified error"))
         }

package/ios/Next/FileSystemNextRecords.swift

@@ -6,3 +6,7 @@ struct CreateOptions: Record {
   @Field var intermediates: Bool = false
   @Field var overwrite: Bool = false
 }
+
+struct DownloadOptionsNext: Record {
+  @Field var headers: [String: String]?
+}

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80-sources.jar.md5

@@ -0,0 +1 @@
+2003fc20bc6b10daed08f2422c631d05

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80-sources.jar.sha1

@@ -0,0 +1 @@
+411d53074267783a2c3abd5f70acc8ecfe206850

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80-sources.jar.sha256

@@ -0,0 +1 @@
+0756e1e7fc3ed6c758e60d571776d16a91d67682c788082fc50f6bee8a24900c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80-sources.jar.sha512

@@ -0,0 +1 @@
+be40f9a68f6d8766f337229b387c4b9e019446c6b5034b222dbaeca22abe0aabc533f964aed61dc9bb32c251cfbf01def0ea36debbec0ee6ceb45e0fb271f414

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar.md5

@@ -0,0 +1 @@
+714afc053c77e63be31a31618d09495c

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar.sha1

@@ -0,0 +1 @@
+da887e7fa639fe2b40319061b5ff4d13f0f2bd62

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar.sha256

@@ -0,0 +1 @@
+f7b382e83d36d7223b0b107881bf1b629072140bf85d20416a5240edcf3b8ead

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar.sha512

@@ -0,0 +1 @@
+494bbd18c43c3ec7930e9a2b8b60519ddac51f0db0e76e8e9e8a79368feaf05fac925801adb040de753f19ac5c349fa68a4cab6b1304aedfe6e8da6467c4ea39

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.module

@@ -0,0 +1,173 @@
+{
+  "formatVersion": "1.1",
+  "component": {
+    "group": "host.exp.exponent",
+    "module": "expo.modules.filesystem",
+    "version": "18.2.0-canary-20250611-f0afe80",
+    "attributes": {
+      "org.gradle.status": "release"
+    }
+  },
+  "createdBy": {
+    "gradle": {
+      "version": "8.14"
+    }
+  },
+  "variants": [
+    {
+      "name": "releaseVariantReleaseApiPublication",
+      "attributes": {
+        "org.gradle.category": "library",
+        "org.gradle.dependency.bundling": "external",
+        "org.gradle.libraryelements": "aar",
+        "org.gradle.usage": "java-api"
+      },
+      "dependencies": [
+        {
+          "group": "commons-codec",
+          "module": "commons-codec",
+          "version": {
+            "requires": "1.10"
+          }
+        },
+        {
+          "group": "commons-io",
+          "module": "commons-io",
+          "version": {
+            "requires": "1.4"
+          }
+        },
+        {
+          "group": "com.squareup.okhttp3",
+          "module": "okhttp",
+          "version": {
+            "requires": "4.9.2"
+          }
+        },
+        {
+          "group": "com.squareup.okhttp3",
+          "module": "okhttp-urlconnection",
+          "version": {
+            "requires": "4.9.2"
+          }
+        },
+        {
+          "group": "com.squareup.okio",
+          "module": "okio",
+          "version": {
+            "requires": "2.9.0"
+          }
+        },
+        {
+          "group": "androidx.legacy",
+          "module": "legacy-support-v4",
+          "version": {
+            "requires": "1.0.0"
+          }
+        }
+      ],
+      "files": [
+        {
+          "name": "expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar",
+          "url": "expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar",
+          "size": 292094,
+          "sha512": "494bbd18c43c3ec7930e9a2b8b60519ddac51f0db0e76e8e9e8a79368feaf05fac925801adb040de753f19ac5c349fa68a4cab6b1304aedfe6e8da6467c4ea39",
+          "sha256": "f7b382e83d36d7223b0b107881bf1b629072140bf85d20416a5240edcf3b8ead",
+          "sha1": "da887e7fa639fe2b40319061b5ff4d13f0f2bd62",
+          "md5": "714afc053c77e63be31a31618d09495c"
+        }
+      ]
+    },
+    {
+      "name": "releaseVariantReleaseRuntimePublication",
+      "attributes": {
+        "org.gradle.category": "library",
+        "org.gradle.dependency.bundling": "external",
+        "org.gradle.libraryelements": "aar",
+        "org.gradle.usage": "java-runtime"
+      },
+      "dependencies": [
+        {
+          "group": "org.jetbrains.kotlin",
+          "module": "kotlin-stdlib-jdk7",
+          "version": {
+            "requires": "2.1.20"
+          }
+        },
+        {
+          "group": "commons-codec",
+          "module": "commons-codec",
+          "version": {
+            "requires": "1.10"
+          }
+        },
+        {
+          "group": "commons-io",
+          "module": "commons-io",
+          "version": {
+            "requires": "1.4"
+          }
+        },
+        {
+          "group": "com.squareup.okhttp3",
+          "module": "okhttp",
+          "version": {
+            "requires": "4.9.2"
+          }
+        },
+        {
+          "group": "com.squareup.okhttp3",
+          "module": "okhttp-urlconnection",
+          "version": {
+            "requires": "4.9.2"
+          }
+        },
+        {
+          "group": "com.squareup.okio",
+          "module": "okio",
+          "version": {
+            "requires": "2.9.0"
+          }
+        },
+        {
+          "group": "androidx.legacy",
+          "module": "legacy-support-v4",
+          "version": {
+            "requires": "1.0.0"
+          }
+        }
+      ],
+      "files": [
+        {
+          "name": "expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar",
+          "url": "expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.aar",
+          "size": 292094,
+          "sha512": "494bbd18c43c3ec7930e9a2b8b60519ddac51f0db0e76e8e9e8a79368feaf05fac925801adb040de753f19ac5c349fa68a4cab6b1304aedfe6e8da6467c4ea39",
+          "sha256": "f7b382e83d36d7223b0b107881bf1b629072140bf85d20416a5240edcf3b8ead",
+          "sha1": "da887e7fa639fe2b40319061b5ff4d13f0f2bd62",
+          "md5": "714afc053c77e63be31a31618d09495c"
+        }
+      ]
+    },
+    {
+      "name": "releaseVariantReleaseSourcePublication",
+      "attributes": {
+        "org.gradle.category": "documentation",
+        "org.gradle.dependency.bundling": "external",
+        "org.gradle.docstype": "sources",
+        "org.gradle.usage": "java-runtime"
+      },
+      "files": [
+        {
+          "name": "expo.modules.filesystem-18.2.0-canary-20250611-f0afe80-sources.jar",
+          "url": "expo.modules.filesystem-18.2.0-canary-20250611-f0afe80-sources.jar",
+          "size": 21472,
+          "sha512": "be40f9a68f6d8766f337229b387c4b9e019446c6b5034b222dbaeca22abe0aabc533f964aed61dc9bb32c251cfbf01def0ea36debbec0ee6ceb45e0fb271f414",
+          "sha256": "0756e1e7fc3ed6c758e60d571776d16a91d67682c788082fc50f6bee8a24900c",
+          "sha1": "411d53074267783a2c3abd5f70acc8ecfe206850",
+          "md5": "2003fc20bc6b10daed08f2422c631d05"
+        }
+      ]
+    }
+  ]
+}

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.module.md5

@@ -0,0 +1 @@
+86ee64ab445efdc2fdfe3929ba32efed

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.module.sha1

@@ -0,0 +1 @@
+4ea06e1c09cbe4991eec37a70264f4bd866ed64d

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.module.sha256

@@ -0,0 +1 @@
+4ab6b4b0d6b9c2cf7c04abfba21645ff1402d62b9f9e532859d06526e8edf1b7

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.module.sha512

@@ -0,0 +1 @@
+ddf7ac73db8a903cafffe83c7b6ff74635a83f8b0ae1b09d29581a1815b45d499ab4315b187e9e31b6d91494b612baeb3218520c57a5b6fc8067d8dc08096a19

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.pom

@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <!-- This module was also published with a richer model, Gradle metadata,  -->
+  <!-- which should be used instead. Do not delete the following line which  -->
+  <!-- is to indicate to Gradle or any Gradle module metadata file consumer  -->
+  <!-- that they should prefer consuming it instead. -->
+  <!-- do_not_remove: published-with-gradle-metadata -->
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>host.exp.exponent</groupId>
+  <artifactId>expo.modules.filesystem</artifactId>
+  <version>18.2.0-canary-20250611-f0afe80</version>
+  <packaging>aar</packaging>
+  <name>expo.modules.filesystem</name>
+  <url>https://github.com/expo/expo</url>
+  <licenses>
+    <license>
+      <name>MIT License</name>
+      <url>https://github.com/expo/expo/blob/main/LICENSE</url>
+    </license>
+  </licenses>
+  <scm>
+    <connection>https://github.com/expo/expo.git</connection>
+    <developerConnection>https://github.com/expo/expo.git</developerConnection>
+    <url>https://github.com/expo/expo</url>
+  </scm>
+  <dependencies>
+    <dependency>
+      <groupId>commons-codec</groupId>
+      <artifactId>commons-codec</artifactId>
+      <version>1.10</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>commons-io</groupId>
+      <artifactId>commons-io</artifactId>
+      <version>1.4</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.squareup.okhttp3</groupId>
+      <artifactId>okhttp</artifactId>
+      <version>4.9.2</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.squareup.okhttp3</groupId>
+      <artifactId>okhttp-urlconnection</artifactId>
+      <version>4.9.2</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.squareup.okio</groupId>
+      <artifactId>okio</artifactId>
+      <version>2.9.0</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>androidx.legacy</groupId>
+      <artifactId>legacy-support-v4</artifactId>
+      <version>1.0.0</version>
+      <scope>compile</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.jetbrains.kotlin</groupId>
+      <artifactId>kotlin-stdlib-jdk7</artifactId>
+      <version>2.1.20</version>
+      <scope>runtime</scope>
+    </dependency>
+  </dependencies>
+</project>

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.pom.md5

@@ -0,0 +1 @@
+7580b9e158bec1bfa30df5ba060ce920

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.pom.sha1

@@ -0,0 +1 @@
+e8085458c8f098f5e9c9d54327c741b7b0019025

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.pom.sha256

@@ -0,0 +1 @@
+c594b15b03a397a241565d9463a6c923d5640c3f7bd6ac79c675e0ca0ffe13f8

package/local-maven-repo/host/exp/exponent/expo.modules.filesystem/18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.pom.sha512

@@ -0,0 +1 @@
+0e3a64774f9f515403044f57fb7e37863190e880a6403b17c4c5c1cdd8b7d6eb3c20d2499b94b2a2963ef4d6af7f3194bc4c00557460135bf00647f7c220c591

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

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<metadata>
+  <groupId>host.exp.exponent</groupId>
+  <artifactId>expo.modules.filesystem</artifactId>
+  <versioning>
+    <latest>18.2.0-canary-20250611-f0afe80</latest>
+    <release>18.2.0-canary-20250611-f0afe80</release>
+    <versions>
+      <version>18.2.0-canary-20250611-f0afe80</version>
+    </versions>
+    <lastUpdated>20250611221459</lastUpdated>
+  </versioning>
+</metadata>

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

@@ -0,0 +1 @@
+99f7403f0db043b3803dcf428ae6fcd4

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

@@ -0,0 +1 @@
+3194ceb9b37c61dbc263a780fd0683acc0690748

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

@@ -0,0 +1 @@
+cfa55f422bcc6d2982f8e6c81db34f47259edc1b9a331b7cbddd668bea4b7508

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

@@ -0,0 +1 @@
+b118dd795bb8a1b6d82bee321aa08cadaf90e6a58489d80ac50da29a22ea4d11a8775bd4549797debc0ac795c86650ca4c86be07b61f90a3e5b4cbb69fc462ad

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "18.1.10",
+  "version": "18.2.0-canary-20250611-f0afe80",
   "description": "Provides access to the local file system on the device.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -35,12 +35,11 @@
     "preset": "expo-module-scripts"
   },
   "devDependencies": {
-    "expo-module-scripts": "^4.1.7",
-    "jest-expo": "~53.0.5"
+    "expo-module-scripts": "4.1.8-canary-20250611-f0afe80",
+    "jest-expo": "54.0.0-canary-20250611-f0afe80"
   },
   "peerDependencies": {
-    "expo": "*",
+    "expo": "54.0.0-canary-20250611-f0afe80",
     "react-native": "*"
-  },
-  "gitHead": "49c9d53cf0a9fc8179d1c8f5268beadd141f70ca"
+  }
 }

package/src/FileSystem.ts

@@ -286,7 +286,7 @@ export async function downloadAsync(
  *
  * **Server**
  *
- * Please refer to the "[Server: Handling multipart requests](#server-handling-multipart-requests)" example - there is code for a simple Node.js server.
+ * Refer to the "[Server: Handling multipart requests](#server-handling-multipart-requests)" example - there is code for a simple Node.js server.
  * @return Returns a Promise that resolves to `FileSystemUploadResult` object.
  */
 export async function uploadAsync(

package/src/next/ExpoFileSystem.ts

@@ -1,13 +1,17 @@
 import { isRunningInExpoGo } from 'expo';
 import { NativeModule, requireNativeModule } from 'expo-modules-core';
 
-import type { Directory, File } from './ExpoFileSystem.types';
+import type { Directory, File, DownloadOptions } from './ExpoFileSystem.types';
 import ExpoGoFileSystemNextStub from './ExpoGoFileSystemNextStub';
 
 declare class ExpoFileSystemNextModule extends NativeModule {
   FileSystemDirectory: typeof Directory;
   FileSystemFile: typeof File;
-  downloadFileAsync(url: string, destination: File | Directory): Promise<string>;
+  downloadFileAsync(
+    url: string,
+    destination: File | Directory,
+    options?: DownloadOptions
+  ): Promise<string>;
 }
 
 export default isRunningInExpoGo()

package/src/next/ExpoFileSystem.types.ts

@@ -76,6 +76,15 @@ export declare class Directory {
   list(): (Directory | File)[];
 }
 
+export type DownloadOptions = {
+  /**
+   * The headers to send with the request.
+   */
+  headers?: {
+    [key: string]: string;
+  };
+};
+
 /**
  * Represents a file on the file system.
  */
@@ -168,7 +177,11 @@ export declare class File {
    * const file = await File.downloadFileAsync("https://example.com/image.png", new Directory(Paths.document));
    * ```
    */
-  static downloadFileAsync(url: string, destination: Directory | File): Promise<File>;
+  static downloadFileAsync(
+    url: string,
+    destination: Directory | File,
+    options?: DownloadOptions
+  ): Promise<File>;
 
   /**
    * A size of the file in bytes. Null if the file does not exist, or it cannot be read.

package/src/next/FileSystem.ts

@@ -1,4 +1,5 @@
 import ExpoFileSystem from './ExpoFileSystem';
+import type { DownloadOptions } from './ExpoFileSystem.types';
 import { PathUtilities } from './pathUtilities';
 import { FileSystemReadableStreamSource, FileSystemWritableSink } from './streams';
 
@@ -20,7 +21,9 @@ export class Paths extends PathUtilities {
     const containers: Record<string, string> = ExpoFileSystem.appleSharedContainers ?? {};
     const result: Record<string, Directory> = {};
     for (const appGroupId in containers) {
-      result[appGroupId] = new Directory(containers[appGroupId]);
+      if (containers[appGroupId]) {
+        result[appGroupId] = new Directory(containers[appGroupId]);
+      }
     }
     return result;
   }
@@ -131,8 +134,12 @@ export class File extends ExpoFileSystem.FileSystemFile {
 }
 
 // Cannot use `static` keyword in class declaration because of a runtime error.
-File.downloadFileAsync = async function downloadFileAsync(url: string, to: File | Directory) {
-  const outputPath = await ExpoFileSystem.downloadFileAsync(url, to);
+File.downloadFileAsync = async function downloadFileAsync(
+  url: string,
+  to: File | Directory,
+  options?: DownloadOptions
+) {
+  const outputPath = await ExpoFileSystem.downloadFileAsync(url, to, options);
   return new File(outputPath);
 };
 

package/src/next/pathUtilities/path.ts

@@ -115,12 +115,12 @@ export function resolve(...args: string[]) {
     const path = i >= 0 ? args[i] : '';
 
     // Skip empty entries
-    if (path.length === 0) {
+    if (!path || path.length === 0) {
       continue;
     }
 
     resolvedPath = `${path}/${resolvedPath}`;
-    resolvedAbsolute = path.charAt(0) === '/';
+    resolvedAbsolute = !!(path && path.charAt(0) === '/');
   }
 
   // At this point the path should be resolved to a full absolute path, but
@@ -161,7 +161,7 @@ export function join(...args: string[]) {
   const path: string[] = [];
   for (let i = 0; i < args.length; ++i) {
     const arg = args[i];
-    if (arg.length > 0) {
+    if (arg && arg.length > 0) {
       path.push(arg);
     }
   }

package/src/next/streams.ts

@@ -37,7 +37,7 @@ export class FileSystemReadableStreamSource implements UnderlyingByteSource {
     } else {
       const array = new Uint8Array(theView.buffer);
       for (let i = 0; i < bytes.length; i++) {
-        array[i + theView.byteOffset] = bytes[i];
+        array[i + (theView.byteOffset ?? 0)] = bytes[i]!;
       }
     }
     controller.byobRequest.respond(bytes.length);