@amazon-devices/expo-file-system 2.0.1758683737

package/README.md

@@ -0,0 +1,46 @@
+<p>
+  <a href="https://docs.expo.dev/versions/latest/sdk/filesystem/">
+    <img
+      src="../../.github/resources/expo-file-system.svg"
+      alt="expo-file-system"
+      height="64" />
+  </a>
+</p>
+
+Provides access to the local file system on the device.
+
+# API documentation
+
+- [Documentation for the main branch](https://github.com/expo/expo/blob/main/docs/pages/versions/unversioned/sdk/filesystem.mdx)
+- [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/filesystem/)
+
+# API usage clarification
+
+- Symbolic links of the directory entries are not followed in `readDirectoryAsync`
+
+# Installation in managed Expo projects
+
+For [managed](https://docs.expo.dev/archive/managed-vs-bare/) Expo projects, please follow the installation instructions in the [API documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/filesystem/).
+
+# Installation in bare React Native projects
+
+For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
+
+## Installation in bare iOS React Native project
+
+No additional set up necessary.
+
+## Installation in bare Android React Native project
+
+This module requires permissions to interact with the filesystem and create resumable downloads. The `READ_EXTERNAL_STORAGE`, `WRITE_EXTERNAL_STORAGE` and `INTERNET` permissions are automatically added.
+
+```xml
+<!-- Added permissions -->
+<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+<uses-permission android:name="android.permission.INTERNET" />
+```
+
+# Contributing
+
+Contributions are very welcome! Please refer to guidelines described in the [contributing guide](https://github.com/expo/expo#contributing).

package/THIRD_PARTY_NOTICES.txt

@@ -0,0 +1,24 @@
+License from package.json:
+==============================
+
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/android/build.gradle

@@ -0,0 +1,118 @@
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+apply plugin: 'maven-publish'
+
+group = 'host.exp.exponent'
+version = '15.8.0'
+
+def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
+if (expoModulesCorePlugin.exists()) {
+  apply from: expoModulesCorePlugin
+  applyKotlinExpoModulesCorePlugin()
+  // Remove this check, but keep the contents after SDK49 support is dropped
+  if (safeExtGet("expoProvidesDefaultConfig", false)) {
+    useExpoPublishing()
+    useCoreDependencies()
+  }
+}
+
+buildscript {
+  // Simple helper that allows the root project to override versions declared by this library.
+  ext.safeExtGet = { prop, fallback ->
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+  }
+
+  // Ensures backward compatibility
+  ext.getKotlinVersion = {
+    if (ext.has("kotlinVersion")) {
+      ext.kotlinVersion()
+    } else {
+      ext.safeExtGet("kotlinVersion", "1.8.10")
+    }
+  }
+
+  repositories {
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:${getKotlinVersion()}")
+  }
+}
+
+// Remove this if and it's contents, when support for SDK49 is dropped
+if (!safeExtGet("expoProvidesDefaultConfig", false)) {
+  afterEvaluate {
+    publishing {
+      publications {
+        release(MavenPublication) {
+          from components.release
+        }
+      }
+      repositories {
+        maven {
+          url = mavenLocal().url
+        }
+      }
+    }
+  }
+}
+
+android {
+  // Remove this if and it's contents, when support for SDK49 is dropped
+  if (!safeExtGet("expoProvidesDefaultConfig", false)) {
+    compileSdkVersion safeExtGet("compileSdkVersion", 33)
+
+    defaultConfig {
+      minSdkVersion safeExtGet("minSdkVersion", 23)
+      targetSdkVersion safeExtGet("targetSdkVersion", 33)
+    }
+
+    publishing {
+      singleVariant("release") {
+        withSourcesJar()
+      }
+    }
+
+    lintOptions {
+      abortOnError false
+    }
+  }
+
+  def agpVersion = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION
+  if (agpVersion.tokenize('.')[0].toInteger() < 8) {
+    compileOptions {
+      sourceCompatibility JavaVersion.VERSION_11
+      targetCompatibility JavaVersion.VERSION_11
+    }
+
+    kotlinOptions {
+      jvmTarget = JavaVersion.VERSION_11.majorVersion
+    }
+  }
+
+  namespace "expo.modules.filesystem"
+  defaultConfig {
+    versionCode 30
+    versionName "15.8.0"
+  }
+}
+
+repositories {
+  mavenCentral()
+}
+
+dependencies {
+  // Remove this if and it's contents, when support for SDK49 is dropped
+  if (!safeExtGet("expoProvidesDefaultConfig", false)) {
+    implementation project(':expo-modules-core')
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${getKotlinVersion()}"
+  }
+
+  api 'commons-codec:commons-codec:1.10'
+  api 'commons-io:commons-io:1.4'
+  api 'com.squareup.okhttp3:okhttp:4.9.2'
+  api 'com.squareup.okhttp3:okhttp-urlconnection:4.9.2'
+  api 'com.squareup.okio:okio:2.9.0'
+  api "androidx.legacy:legacy-support-v4:1.0.0"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,17 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+    <application>
+        <provider tools:replace="android:authorities" android:name=".FileSystemFileProvider" android:authorities="${applicationId}.FileSystemFileProvider" android:exported="false" android:grantUriPermissions="true">
+            <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_system_provider_paths" />
+        </provider>
+    </application>
+
+    <queries>
+        <!-- Query open documents -->
+        <intent>
+            <action android:name="android.intent.action.OPEN_DOCUMENT_TREE" />
+        </intent>
+    </queries>
+</manifest>

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

@@ -0,0 +1,26 @@
+package expo.modules.filesystem
+
+import android.content.Context
+import expo.modules.core.interfaces.InternalModule
+import expo.modules.interfaces.filesystem.AppDirectoriesModuleInterface
+import java.io.File
+
+/*
+New Sweet API modules don't have an easy way to access scoped context. We can't initialize them with scoped context as they need a ReactApplicationContext instead.
+We can't make ScopedContext inherit from ReactApplicationContext as that would require moving ScopedContext to versioned and a large refactor.
+
+This module is a stopgap solution to provide modules with a way to access ScopedContext directories using the filesystem module, only for our internal modules.
+ */
+
+// The class needs to be 'open', because it's inherited in expoview
+open class AppDirectoriesModule(private val context: Context) : AppDirectoriesModuleInterface, InternalModule {
+
+  override fun getExportedInterfaces(): List<Class<*>> =
+    listOf(AppDirectoriesModuleInterface::class.java)
+
+  override val cacheDirectory: File
+    get() = context.cacheDir
+
+  override val persistentFilesDirectory: File
+    get() = context.filesDir
+}

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

@@ -0,0 +1,52 @@
+package expo.modules.filesystem
+
+import okhttp3.RequestBody
+import okio.Buffer
+import okio.BufferedSink
+import okio.ForwardingSink
+import okio.Sink
+import okio.buffer
+import java.io.IOException
+
+@FunctionalInterface
+fun interface RequestBodyDecorator {
+  fun decorate(requestBody: RequestBody): RequestBody
+}
+
+@FunctionalInterface
+interface CountingRequestListener {
+  fun onProgress(bytesWritten: Long, contentLength: Long)
+}
+
+private class CountingSink(
+  sink: Sink,
+  private val requestBody: RequestBody,
+  private val progressListener: CountingRequestListener
+) : ForwardingSink(sink) {
+  private var bytesWritten = 0L
+
+  override fun write(source: Buffer, byteCount: Long) {
+    super.write(source, byteCount)
+
+    bytesWritten += byteCount
+    progressListener.onProgress(bytesWritten, requestBody.contentLength())
+  }
+}
+
+class CountingRequestBody(
+  private val requestBody: RequestBody,
+  private val progressListener: CountingRequestListener
+) : RequestBody() {
+  override fun contentType() = requestBody.contentType()
+
+  @Throws(IOException::class)
+  override fun contentLength() = requestBody.contentLength()
+
+  override fun writeTo(sink: BufferedSink) {
+    val countingSink = CountingSink(sink, this, progressListener)
+
+    val bufferedSink = countingSink.buffer()
+    requestBody.writeTo(bufferedSink)
+    bufferedSink.flush()
+  }
+}

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

@@ -0,0 +1,48 @@
+package expo.modules.filesystem
+
+import android.content.Context
+import expo.modules.interfaces.filesystem.FilePermissionModuleInterface
+import expo.modules.core.interfaces.InternalModule
+import expo.modules.interfaces.filesystem.Permission
+import java.io.File
+import java.io.IOException
+import java.util.*
+
+// The class needs to be 'open', because it's inherited in expoview
+open class FilePermissionModule : FilePermissionModuleInterface, InternalModule {
+  override fun getExportedInterfaces(): List<Class<*>> =
+    listOf(FilePermissionModuleInterface::class.java)
+
+  override fun getPathPermissions(context: Context, path: String): EnumSet<Permission> =
+    getInternalPathPermissions(path, context) ?: getExternalPathPermissions(path)
+
+  private fun getInternalPathPermissions(path: String, context: Context): EnumSet<Permission>? {
+    return try {
+      val canonicalPath = File(path).canonicalPath
+      getInternalPaths(context)
+        .firstOrNull { dir -> canonicalPath.startsWith("$dir/") || dir == canonicalPath }
+        ?.let { EnumSet.of(Permission.READ, Permission.WRITE) }
+    } catch (e: IOException) {
+      EnumSet.noneOf(Permission::class.java)
+    }
+  }
+
+  protected open fun getExternalPathPermissions(path: String): EnumSet<Permission> {
+    val file = File(path)
+    return EnumSet.noneOf(Permission::class.java).apply {
+      if (file.canRead()) {
+        add(Permission.READ)
+      }
+      if (file.canWrite()) {
+        add(Permission.WRITE)
+      }
+    }
+  }
+
+  @Throws(IOException::class)
+  private fun getInternalPaths(context: Context): List<String> =
+    listOf(
+      context.filesDir.canonicalPath,
+      context.cacheDir.canonicalPath
+    )
+}

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

@@ -0,0 +1,48 @@
+package expo.modules.filesystem
+
+import android.net.Uri
+import expo.modules.kotlin.exception.CodedException
+
+internal class FileSystemOkHttpNullException :
+  CodedException("okHttpClient is null")
+
+internal class FileSystemCannotReadDirectoryException(uri: Uri?) :
+  CodedException("Uri '$uri' doesn't exist or isn't a directory")
+
+internal class FileSystemCannotCreateDirectoryException(uri: Uri?) :
+  CodedException(
+    uri?.let {
+      "Directory '$it' could not be created or already exists"
+    } ?: "Unknown error"
+  )
+
+internal class FileSystemUnreadableDirectoryException(uri: String) :
+  CodedException("No readable files with the uri '$uri'. Please use other uri")
+
+internal class FileSystemCannotCreateFileException(uri: Uri?) :
+  CodedException(
+    uri?.let {
+      "Provided uri '$it' is not pointing to a directory"
+    } ?: "Unknown error"
+  )
+
+internal class FileSystemFileNotFoundException(uri: Uri?) :
+  CodedException("File '$uri' could not be deleted because it could not be found")
+
+internal class FileSystemPendingPermissionsRequestException :
+  CodedException("You have an unfinished permission request")
+
+internal class FileSystemCannotMoveFileException(fromUri: Uri, toUri: Uri) :
+  CodedException("File '$fromUri' could not be moved to '$toUri'")
+
+internal class FileSystemUnsupportedSchemeException :
+  CodedException("Can't read Storage Access Framework directory, use StorageAccessFramework.readDirectoryAsync() instead")
+
+internal class FileSystemCannotFindTaskException :
+  CodedException("Cannot find task")
+
+internal class FileSystemCopyFailedException(uri: Uri?) :
+  CodedException("File '$uri' could not be copied because it could not be found")
+
+internal class CookieHandlerNotFoundException :
+  CodedException("Failed to find CookieHandler")

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

@@ -0,0 +1,5 @@
+package expo.modules.filesystem
+
+import androidx.core.content.FileProvider
+
+class FileSystemFileProvider : FileProvider()