expo-file-system 18.0.2 → 18.0.4

package/CHANGELOG.md

@@ -10,6 +10,18 @@
 
 ### 💡 Others
 
+## 18.0.4 — 2024-11-19
+
+### 🎉 New features
+
+- [next] Added `.bytes()` and writing a `Uint8Array`. ([#33020](https://github.com/expo/expo/pull/33020) by [@aleqsio](https://github.com/aleqsio))
+
+## 18.0.3 — 2024-11-13
+
+### 🎉 New features
+
+- [next] Add file handles. ([#31738](https://github.com/expo/expo/pull/31738) by [@aleqsio](https://github.com/aleqsio))
+
 ## 18.0.2 — 2024-11-11
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'host.exp.exponent'
-version = '18.0.2'
+version = '18.0.4'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -14,7 +14,7 @@ android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "18.0.2"
+    versionName "18.0.4"
   }
 }
 

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

@@ -53,7 +53,7 @@ class FileSystemFile(file: File) : FileSystemPath(file) {
       create()
     }
     FileOutputStream(file).use {
-      it.write(content.toDirectBuffer().array())
+      it.channel.write(content.toDirectBuffer())
     }
   }
 
@@ -74,6 +74,12 @@ class FileSystemFile(file: File) : FileSystemPath(file) {
     return Base64.encodeToString(file.readBytes(), Base64.NO_WRAP)
   }
 
+  fun bytes(): ByteArray {
+    validateType()
+    validatePermission(Permission.READ)
+    return file.readBytes()
+  }
+
   @OptIn(ExperimentalStdlibApi::class)
   val md5: String get() {
     validatePermission(Permission.READ)

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

@@ -0,0 +1,68 @@
+package expo.modules.filesystem.next
+
+import expo.modules.kotlin.sharedobjects.SharedRef
+import java.io.RandomAccessFile
+import java.nio.ByteBuffer
+import java.nio.channels.FileChannel
+class FileSystemFileHandle(file: FileSystemFile) : SharedRef<FileChannel>(RandomAccessFile(file.file, "rw").channel), AutoCloseable {
+  private val fileChannel: FileChannel = ref
+
+  private fun ensureIsOpen() {
+    if (!fileChannel.isOpen) {
+      throw UnableToReadHandleException("file handle is closed")
+    }
+  }
+
+  override fun sharedObjectDidRelease() {
+    close()
+  }
+
+  override fun close() {
+    fileChannel.close()
+  }
+
+  fun read(length: Int): ByteArray {
+    ensureIsOpen()
+    try {
+      val buffer = ByteBuffer.allocate(length.coerceAtMost((fileChannel.size() - fileChannel.position()).toInt()))
+      fileChannel.read(buffer)
+      return buffer.array()
+    } catch (e: Exception) {
+      throw UnableToReadHandleException(e.message ?: "unknown error")
+    }
+  }
+
+  fun write(data: ByteArray) {
+    ensureIsOpen()
+    try {
+      val buffer = ByteBuffer.wrap(data)
+      fileChannel.write(buffer)
+    } catch (e: Exception) {
+      throw UnableToWriteHandleException(e.message ?: "unknown error")
+    }
+  }
+
+  var offset: Long?
+    get() {
+      return try {
+        fileChannel.position()
+      } catch (e: Exception) {
+        null
+      }
+    }
+    set(value) {
+      if (value == null) {
+        return
+      }
+      fileChannel.position(value)
+    }
+
+  val size: Long?
+    get() {
+      return try {
+        fileChannel.size()
+      } catch (e: Exception) {
+        null
+      }
+    }
+}

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

@@ -29,6 +29,16 @@ internal class InvalidPermissionException(permission: Permission) :
     "Missing '${permission.name}' permission for accessing the file."
   )
 
+internal class UnableToReadHandleException(reason: String) :
+  CodedException(
+    "Unable to read from a file handle: '$reason'"
+  )
+
+internal class UnableToWriteHandleException(reason: String) :
+  CodedException(
+    "Unable to write to a file handle: '$reason'"
+  )
+
 internal class DestinationAlreadyExistsException :
   CodedException(
     "Destination already exists"

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

@@ -102,6 +102,10 @@ class FileSystemNextModule : Module() {
         file.base64()
       }
 
+      Function("bytes") { file: FileSystemFile ->
+        file.bytes()
+      }
+
       Property("exists") { file: FileSystemFile ->
         file.exists
       }
@@ -133,6 +137,33 @@ class FileSystemNextModule : Module() {
           null
         }
       }
+
+      Function("open") { file: FileSystemFile ->
+        FileSystemFileHandle(file)
+      }
+    }
+
+    Class(FileSystemFileHandle::class) {
+      Constructor { file: FileSystemFile ->
+        FileSystemFileHandle(file)
+      }
+      Function("readBytes") { fileHandle: FileSystemFileHandle, bytes: Int ->
+        fileHandle.read(bytes)
+      }
+      Function("writeBytes") { fileHandle: FileSystemFileHandle, data: ByteArray ->
+        fileHandle.write(data)
+      }
+      Function("close") { fileHandle: FileSystemFileHandle ->
+        fileHandle.close()
+      }
+      Property("offset") { fileHandle: FileSystemFileHandle ->
+        fileHandle.offset
+      }.set { fileHandle: FileSystemFileHandle, offset: Long ->
+        fileHandle.offset = offset
+      }
+      Property("size") { fileHandle: FileSystemFileHandle ->
+        fileHandle.size
+      }
     }
 
     Class(FileSystemDirectory::class) {

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

@@ -11,7 +11,7 @@ import kotlin.io.path.moveTo
 // The Path class might be better, but `java.nio.file.Path` class is not available in API 23.
 // The URL, URI classes seem like a less suitable choice.
 // https://stackoverflow.com/questions/27845223/whats-the-difference-between-a-resource-uri-url-path-and-file-in-java
-abstract class FileSystemPath(var file: File) : SharedObject() {
+abstract class FileSystemPath(public var file: File) : SharedObject() {
   fun delete() {
     if (!file.exists()) {
       throw UnableToDeleteException("path does not exist")

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

@@ -85,11 +85,16 @@ export declare class File {
      * @returns The contents of the file as a base64 string.
      */
     base64(): string;
+    /**
+     * Retrieves byte content of the entire file.
+     * @returns The contents of the file as a Uint8Array.
+     */
+    bytes(): Uint8Array;
     /**
      * Writes content to the file.
      * @param content - The content to write into the file.
      */
-    write(content: string): void;
+    write(content: string | Uint8Array): void;
     /**
      * Deletes a file.
      *
@@ -115,6 +120,11 @@ export declare class File {
      * Moves a directory. Updates the `uri` property that now points to the new location.
      */
     move(destination: Directory | File): any;
+    /**
+     * Returns a FileHandle object that can be used to read and write data to the file.
+     * @throws Error if the file does not exist or cannot be opened.
+     */
+    open(): FileHandle;
     /**
      * A static method that downloads a file from the network.
      * @param url - The URL of the file to download.
@@ -135,4 +145,11 @@ export declare class File {
      */
     md5: string | null;
 }
+export declare class FileHandle {
+    close(): void;
+    readBytes(length: number): Uint8Array;
+    writeBytes(bytes: Uint8Array): void;
+    offset: number | null;
+    size: number | null;
+}
 //# sourceMappingURL=ExpoFileSystem.types.d.ts.map

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,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,IAAI,IAAI;IAEd;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;;;OAIG;IACH,aAAa,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAExD;;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,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAE5B;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAEd;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAEd;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;;;;;;;;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;CACpB"}
+{"version":3,"file":"ExpoFileSystem.types.d.ts","sourceRoot":"","sources":["../../src/next/ExpoFileSystem.types.ts"],"names":[],"mappings":"AAAA,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,IAAI,IAAI;IAEd;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;;;OAIG;IACH,aAAa,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAExD;;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,IAAI,IAAI;IAEd;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI;IAElC;;;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;CACpB;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

@@ -1,3 +1,4 @@
+import { ReadableStream, WritableStream } from 'web-streams-polyfill';
 import ExpoFileSystem from './ExpoFileSystem';
 import { PathUtilities } from './pathUtilities';
 export declare class Paths extends PathUtilities {
@@ -31,6 +32,8 @@ export declare class File extends ExpoFileSystem.FileSystemFile {
      * File name. Includes the extension.
      */
     get name(): string;
+    readableStream(): ReadableStream<Uint8Array>;
+    writableStream(): WritableStream<Uint8Array>;
 }
 /**
  * Represents a directory on the filesystem.

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;AAEhD,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,qBAAa,IAAK,SAAQ,cAAc,CAAC,cAAc;IACrD;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,IAAI,eAAe,cAElB;IAED;;;OAGG;IACH,IAAI,SAAS,WAEZ;IAED;;OAEG;IACH,IAAI,IAAI,WAEP;CACF;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,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtE,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,qBAAa,IAAK,SAAQ,cAAc,CAAC,cAAc;IACrD;;;;;;;OAOG;gBACS,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE;IAQlD,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"}

package/build/next/streams.d.ts

@@ -0,0 +1,17 @@
+import type { FileHandle } from './ExpoFileSystem.types';
+export declare class FileSystemReadableStreamSource implements UnderlyingByteSource {
+    handle: FileHandle;
+    size: number;
+    type: "bytes";
+    constructor(handle: any);
+    cancel(): void;
+    pull(controller: ReadableByteStreamController): void;
+}
+export declare class FileSystemWritableSink implements UnderlyingSink {
+    handle: FileHandle;
+    constructor(handle: any);
+    abort(): void;
+    close(): void;
+    write(chunk: Uint8Array): void;
+}
+//# sourceMappingURL=streams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/next/streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,qBAAa,8BAA+B,YAAW,oBAAoB;IACzE,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAQ;IACpB,IAAI,UAAoB;gBAEZ,MAAM,KAAA;IAIlB,MAAM;IAIN,IAAI,CAAC,UAAU,EAAE,4BAA4B;CA4B9C;AAED,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,MAAM,EAAE,UAAU,CAAC;gBAEP,MAAM,KAAA;IAIlB,KAAK;IAIL,KAAK;IAIL,KAAK,CAAC,KAAK,EAAE,UAAU;CAGxB"}

package/ios/Next/FileSystemFile.swift

@@ -73,8 +73,11 @@ internal final class FileSystemFile: FileSystemPath {
     try content.write(to: url, atomically: false, encoding: .utf8) // TODO: better error handling
   }
 
-  // TODO: typedarray, blobs, others support
+  // TODO: blob support
   func write(_ content: TypedArray) throws {
+    try validateType()
+    try validatePermission(.write)
+    try Data(bytes: content.rawPointer, count: content.byteLength).write(to: url)
   }
 
   func text() throws -> String {
@@ -83,6 +86,12 @@ internal final class FileSystemFile: FileSystemPath {
     return try String(contentsOf: url)
   }
 
+  func bytes() throws -> Data {
+    try validateType()
+    try validatePermission(.read)
+    return try Data(contentsOf: url)
+  }
+
   func base64() throws -> String {
     try validatePermission(.read)
     return try Data(contentsOf: url).base64EncodedString()

package/ios/Next/FileSystemFileHandle.swift

@@ -0,0 +1,53 @@
+import Foundation
+import ExpoModulesCore
+
+internal final class FileSystemFileHandle: SharedRef<FileHandle> {
+  let file: FileSystemFile
+  let handle: FileHandle
+
+  init(file: FileSystemFile) throws {
+    self.file = file
+    handle = try FileHandle(forUpdating: file.url)
+    super.init(handle)
+  }
+
+  func read(_ length: Int) throws -> Data {
+    do {
+      let data = try handle.read(upToCount: length)
+      return data ?? Data()
+    } catch {
+      throw UnableToReadHandleException(error.localizedDescription)
+    }
+  }
+
+  func write(_ bytes: Data) throws {
+    try handle.write(contentsOf: bytes)
+  }
+
+  func close() throws {
+    try handle.close()
+  }
+
+  var offset: UInt64? {
+    get {
+      try? handle.offset()
+    }
+    set(newOffset) {
+      guard let newOffset else {
+        return
+      }
+      handle.seek(toFileOffset: newOffset)
+    }
+  }
+
+  var size: UInt64? {
+    do {
+      let offset = try handle.offset()
+      let size = try handle.seekToEnd()
+      handle.seek(toFileOffset: offset)
+      return size
+    } catch {
+      return nil
+    }
+  }
+}

package/ios/Next/FileSystemNextExceptions.swift

@@ -49,6 +49,12 @@ internal class UnableToCreateFileException: GenericException<String> {
   }
 }
 
+internal class UnableToReadHandleException: GenericException<String> {
+  override var reason: String {
+    "Unable to read from a file handle: \(param)"
+  }
+}
+
 internal class DestinationAlreadyExistsException: Exception {
   override var reason: String {
     "Destination already exists"

package/ios/Next/FileSystemNextModule.swift

@@ -72,6 +72,14 @@ public final class FileSystemNextModule: Module {
         return try file.base64()
       }
 
+      Function("bytes") { file in
+        return try file.bytes()
+      }
+
+      Function("open") { file in
+        return try FileSystemFileHandle(file: file)
+      }
+
       Function("write") { (file, content: Either<String, TypedArray>) in
         if let content: String = content.get() {
           try file.write(content)
@@ -114,6 +122,30 @@ public final class FileSystemNextModule: Module {
       }
     }
 
+    Class(FileSystemFileHandle.self) {
+      Function("readBytes") { (fileHandle, bytes: Int) in
+        try fileHandle.read(bytes)
+      }
+
+      Function("writeBytes") { (fileHandle, bytes: Data) in
+        try fileHandle.write(bytes)
+      }
+
+      Function("close") { fileHandle in
+        try fileHandle.close()
+      }
+
+      Property("offset") { fileHandle in
+        fileHandle.offset
+      }.set { (fileHandle, volume: UInt64) in
+        fileHandle.offset = volume
+      }
+
+      Property("size") { fileHandle in
+        fileHandle.size
+      }
+    }
+
     Class(FileSystemDirectory.self) {
       Constructor { (url: URL) in
         return FileSystemDirectory(url: url.standardizedFileURL)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-file-system",
-  "version": "18.0.2",
+  "version": "18.0.4",
   "description": "Provides access to the local file system on the device.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -42,5 +42,8 @@
     "expo": "*",
     "react-native": "*"
   },
-  "gitHead": "8f11fad6f46b878de4746b49b18599fc57b5729f"
+  "dependencies": {
+    "web-streams-polyfill": "^3.3.2"
+  },
+  "gitHead": "128718d43bac2eaed764b3551469b95400f2363e"
 }

package/src/next/ExpoFileSystem.types.ts

@@ -97,11 +97,17 @@ export declare class File {
    */
   base64(): string;
 
+  /**
+   * Retrieves byte content of the entire file.
+   * @returns The contents of the file as a Uint8Array.
+   */
+  bytes(): Uint8Array;
+
   /**
    * Writes content to the file.
    * @param content - The content to write into the file.
    */
-  write(content: string): void;
+  write(content: string | Uint8Array): void;
 
   /**
    * Deletes a file.
@@ -133,6 +139,12 @@ export declare class File {
    */
   move(destination: Directory | File);
 
+  /**
+   * Returns a FileHandle object that can be used to read and write data to the file.
+   * @throws Error if the file does not exist or cannot be opened.
+   */
+  open(): FileHandle;
+
   /**
    * A static method that downloads a file from the network.
    * @param url - The URL of the file to download.
@@ -155,3 +167,30 @@ export declare class File {
    */
   md5: string | null;
 }
+
+export declare class FileHandle {
+  /*
+   * Closes the file handle. This allows the file to be deleted, moved or read by a different process. Subsequent calls to `readBytes` or `writeBytes` will throw an error.
+   */
+  close(): void;
+  /*
+   * Reads the specified amount of bytes from the file at the current offset.
+   * @param length - The number of bytes to read.
+   */
+  readBytes(length: number): Uint8Array;
+  /*
+   * Writes the specified bytes to the file at the current offset.
+   * @param bytes - A Uint8Array array containing bytes to write.
+   */
+  writeBytes(bytes: Uint8Array): void;
+  /*
+   * A property that indicates the current byte offset in the file. Calling `readBytes` or `writeBytes` will read or write a specified amount of bytes starting from this offset. The offset is incremented by the number of bytes read or written.
+   * The offset can be set to any value within the file size. If the offset is set to a value greater than the file size, the next write operation will append data to the end of the file.
+   * Null if the file handle is closed.
+   */
+  offset: number | null;
+  /*
+   * A size of the file in bytes or `null` if the file handle is closed.
+   */
+  size: number | null;
+}

package/src/next/FileSystem.ts

@@ -1,5 +1,8 @@
+import { ReadableStream, WritableStream } from 'web-streams-polyfill';
+
 import ExpoFileSystem from './ExpoFileSystem';
 import { PathUtilities } from './pathUtilities';
+import { FileSystemReadableStreamSource, FileSystemWritableSink } from './streams';
 
 export class Paths extends PathUtilities {
   /**
@@ -60,6 +63,14 @@ export class File extends ExpoFileSystem.FileSystemFile {
   get name() {
     return Paths.basename(this.uri);
   }
+
+  readableStream() {
+    return new ReadableStream<Uint8Array>(new FileSystemReadableStreamSource(super.open()));
+  }
+
+  writableStream() {
+    return new WritableStream<Uint8Array>(new FileSystemWritableSink(super.open()));
+  }
 }
 
 // Cannot use `static` keyword in class declaration because of a runtime error.

package/src/next/streams.ts

@@ -0,0 +1,64 @@
+import type { FileHandle } from './ExpoFileSystem.types';
+
+export class FileSystemReadableStreamSource implements UnderlyingByteSource {
+  handle: FileHandle;
+  size: number = 1024;
+  type = 'bytes' as const;
+
+  constructor(handle) {
+    this.handle = handle;
+  }
+
+  cancel() {
+    this.handle.close();
+  }
+
+  pull(controller: ReadableByteStreamController) {
+    const theView = controller.byobRequest?.view;
+    if (!theView) {
+      const bytes = this.handle.readBytes(this.size);
+      if (bytes.length === 0) {
+        controller.close();
+        return;
+      }
+      controller.enqueue(bytes);
+      return;
+    }
+
+    // TODO: Optimize by adding a native method that can write into a TypedArray at a given offset.
+    const bytes = this.handle.readBytes(theView.byteLength - theView.byteOffset);
+    if (bytes.length === 0) {
+      controller.close();
+      controller.byobRequest.respond(0);
+      return;
+    }
+    if (theView instanceof Uint8Array) {
+      theView.set(bytes, theView.byteOffset);
+    } else {
+      for (let i = 0; i < bytes.length; i++) {
+        theView[i + theView.byteOffset] = bytes[i];
+      }
+    }
+    controller.byobRequest.respond(bytes.length);
+  }
+}
+
+export class FileSystemWritableSink implements UnderlyingSink {
+  handle: FileHandle;
+
+  constructor(handle) {
+    this.handle = handle;
+  }
+
+  abort() {
+    this.close();
+  }
+
+  close() {
+    this.handle.close();
+  }
+
+  write(chunk: Uint8Array) {
+    this.handle.writeBytes(chunk);
+  }
+}