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

package/CHANGELOG.md

@@ -6,10 +6,22 @@
 
 ### 🎉 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
+
+- Fix the `UploadTask.uploadAsync` method's return type did not indicate that the method could resolve to `null`. ([#36476](https://github.com/expo/expo/pull/36476) by [@DoctorJohn](https://github.com/DoctorJohn))
+
 ## 18.1.9 — 2025-05-03
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '18.1.9'
+version = '18.2.0-canary-20250611-f0afe80'
 
 android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "18.1.9"
+    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>;
@@ -185,7 +185,7 @@ export declare class UploadTask extends FileSystemCancellableNetworkTask<UploadP
     constructor(url: string, fileUri: string, options?: FileSystemUploadOptions, callback?: FileSystemNetworkTaskProgressCallback<UploadProgressData> | undefined);
     protected getEventName(): string;
     protected getCallback(): FileSystemNetworkTaskProgressCallback<UploadProgressData> | undefined;
-    uploadAsync(): Promise<FileSystemUploadResult | undefined>;
+    uploadAsync(): Promise<FileSystemUploadResult | undefined | null>;
 }
 export declare class DownloadResumable extends FileSystemCancellableNetworkTask<DownloadProgressData> {
     private url;

package/build/FileSystem.d.ts.map

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

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

@@ -12,7 +12,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.filesystem",
-      "version": "18.1.9",
+      "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.1.9/expo.modules.filesystem-18.1.9.module → 18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.module}

@@ -3,14 +3,14 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.filesystem",
-    "version": "18.1.9",
+    "version": "18.2.0-canary-20250611-f0afe80",
     "attributes": {
       "org.gradle.status": "release"
     }
   },
   "createdBy": {
     "gradle": {
-      "version": "8.13"
+      "version": "8.14"
     }
   },
   "variants": [
@@ -68,13 +68,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-18.1.9.aar",
-          "url": "expo.modules.filesystem-18.1.9.aar",
-          "size": 289641,
-          "sha512": "21173389c01c041fcb43d25d72873cdd96fd4f00d0b0cad250d37c6b391d81a7e1f37010d4ac312660a66514c206829a2aeb2752c9ccfce642da0cd3a283d6ba",
-          "sha256": "bdd86090d95548fd75ec4d7f782443f5554390a327c4c230a25cfcb6a3ae6f33",
-          "sha1": "db64b2e9d31492a96a8976a0f062f07c0a9e8e8b",
-          "md5": "2c1416051f9a66607afe11a9d6d4b71a"
+          "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"
         }
       ]
     },
@@ -91,7 +91,7 @@
           "group": "org.jetbrains.kotlin",
           "module": "kotlin-stdlib-jdk7",
           "version": {
-            "requires": "2.0.21"
+            "requires": "2.1.20"
           }
         },
         {
@@ -139,13 +139,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.filesystem-18.1.9.aar",
-          "url": "expo.modules.filesystem-18.1.9.aar",
-          "size": 289641,
-          "sha512": "21173389c01c041fcb43d25d72873cdd96fd4f00d0b0cad250d37c6b391d81a7e1f37010d4ac312660a66514c206829a2aeb2752c9ccfce642da0cd3a283d6ba",
-          "sha256": "bdd86090d95548fd75ec4d7f782443f5554390a327c4c230a25cfcb6a3ae6f33",
-          "sha1": "db64b2e9d31492a96a8976a0f062f07c0a9e8e8b",
-          "md5": "2c1416051f9a66607afe11a9d6d4b71a"
+          "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"
         }
       ]
     },
@@ -159,13 +159,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.filesystem-18.1.9-sources.jar",
-          "url": "expo.modules.filesystem-18.1.9-sources.jar",
-          "size": 21383,
-          "sha512": "a25e17199607459bc17961f70927fae632824312b10a36884baf1bcf444f2e9a2b7af63d9258625b13b3830aee357b7369d278b64857cffe78c3a6a0c97100d9",
-          "sha256": "ae6b3dbefd4db1d09f0107bd1c737035dd2fae41afb45bbdb84729349f330801",
-          "sha1": "f364bfeee6c89df87a522071524e8cabff62f4d0",
-          "md5": "692b579f8230ae74f4dc759941f4cc08"
+          "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.1.9/expo.modules.filesystem-18.1.9.pom → 18.2.0-canary-20250611-f0afe80/expo.modules.filesystem-18.2.0-canary-20250611-f0afe80.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.filesystem</artifactId>
-  <version>18.1.9</version>
+  <version>18.2.0-canary-20250611-f0afe80</version>
   <packaging>aar</packaging>
   <name>expo.modules.filesystem</name>
   <url>https://github.com/expo/expo</url>
@@ -64,7 +64,7 @@
     <dependency>
       <groupId>org.jetbrains.kotlin</groupId>
       <artifactId>kotlin-stdlib-jdk7</artifactId>
-      <version>2.0.21</version>
+      <version>2.1.20</version>
       <scope>runtime</scope>
     </dependency>
   </dependencies>

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

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.filesystem</artifactId>
   <versioning>
-    <latest>18.1.9</latest>
-    <release>18.1.9</release>
+    <latest>18.2.0-canary-20250611-f0afe80</latest>
+    <release>18.2.0-canary-20250611-f0afe80</release>
     <versions>
-      <version>18.1.9</version>
+      <version>18.2.0-canary-20250611-f0afe80</version>
     </versions>
-    <lastUpdated>20250503164730</lastUpdated>
+    <lastUpdated>20250611221459</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-e2c03307fddf803bdaf2f4813e81139b
+99f7403f0db043b3803dcf428ae6fcd4

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

@@ -1 +1 @@
-e54d1e92675e460c11ac62c82bb477e7f96f6e63
+3194ceb9b37c61dbc263a780fd0683acc0690748

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

@@ -1 +1 @@
-de2ef883a9c5f0a30e51840221a580ac382effa7f1c5b28061574b3e43ac982a
+cfa55f422bcc6d2982f8e6c81db34f47259edc1b9a331b7cbddd668bea4b7508

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

@@ -1 +1 @@
-4a7a8faf2616d880b7f54e7ae80f5ba3d059d25a07413c8d1abc78760fe3f609231a660c0a24e8ea150deb0bd7fa4f6039332cb19214a5db284f90b4b1f3cb13
+b118dd795bb8a1b6d82bee321aa08cadaf90e6a58489d80ac50da29a22ea4d11a8775bd4549797debc0ac795c86650ca4c86be07b61f90a3e5b4cbb69fc462ad

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "18.1.9",
+  "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.6",
-    "jest-expo": "~53.0.4"
+    "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": "a142a9fed1d84934aa4d54b500ad9c6d8d803c63"
+  }
 }

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(
@@ -433,7 +433,7 @@ export class UploadTask extends FileSystemCancellableNetworkTask<UploadProgressD
   }
 
   // @docsMissing
-  public async uploadAsync(): Promise<FileSystemUploadResult | undefined> {
+  public async uploadAsync(): Promise<FileSystemUploadResult | undefined | null> {
     if (!ExponentFileSystem.uploadTaskStartAsync) {
       throw new UnavailabilityError('expo-file-system', 'uploadTaskStartAsync');
     }

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);

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

@@ -1 +0,0 @@
-692b579f8230ae74f4dc759941f4cc08

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

@@ -1 +0,0 @@
-f364bfeee6c89df87a522071524e8cabff62f4d0

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

@@ -1 +0,0 @@
-ae6b3dbefd4db1d09f0107bd1c737035dd2fae41afb45bbdb84729349f330801

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

@@ -1 +0,0 @@
-a25e17199607459bc17961f70927fae632824312b10a36884baf1bcf444f2e9a2b7af63d9258625b13b3830aee357b7369d278b64857cffe78c3a6a0c97100d9

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

@@ -1 +0,0 @@
-2c1416051f9a66607afe11a9d6d4b71a

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

@@ -1 +0,0 @@
-db64b2e9d31492a96a8976a0f062f07c0a9e8e8b

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

@@ -1 +0,0 @@
-bdd86090d95548fd75ec4d7f782443f5554390a327c4c230a25cfcb6a3ae6f33

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

@@ -1 +0,0 @@
-21173389c01c041fcb43d25d72873cdd96fd4f00d0b0cad250d37c6b391d81a7e1f37010d4ac312660a66514c206829a2aeb2752c9ccfce642da0cd3a283d6ba

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

@@ -1 +0,0 @@
-34de927e20fa715fd5e79a8c879a2ed5

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

@@ -1 +0,0 @@
-d8346996ecafbec04e8d6d18e097fbb42d280789

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

@@ -1 +0,0 @@
-7d276fb8fde9fa5a370a70b5dfb07da31160d06904cab92814c3ff75f1285900

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

@@ -1 +0,0 @@
-7e5d9497b5efd9f145d0d1d312f077d2f679643c3bc5264c74f64f8bf048ef301ada2e6ca02feb834383bf42209de9bccfdbbeb5f175f67090ab1ebe66273b9b

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

@@ -1 +0,0 @@
-555785fc5ca1719bc1f12d68672874b0

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

@@ -1 +0,0 @@
-837a51d69397eb4d9f507c07a432e7260618a36a

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

@@ -1 +0,0 @@
-1e73700a2b9484606cba2ad099d3ebe9954c35f0dcaaf7cdeab27d39a1c22297

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

@@ -1 +0,0 @@
-7896375b51c641eec1c1aa752a1f6025dc34099c04363dfa441fb0ffd741adca7b1405de304fca468165738faf4c0a7f0d924a2f8193f59bbda249778cab28cf