expo-document-picker 9.2.3 → 10.0.2

package/CHANGELOG.md

@@ -10,19 +10,32 @@
 
 ### 💡 Others
 
-## 9.2.3 — 2021-06-24
+## 10.0.2 — 2021-10-15
 
 _This version does not introduce any user-facing changes._
 
-## 9.2.2 — 2021-06-24
+## 10.0.1 — 2021-10-01
+
+_This version does not introduce any user-facing changes._
+
+## 10.0.0 — 2021-09-28
+
+### 🛠 Breaking changes
+
+- Dropped support for iOS 11.0 ([#14383](https://github.com/expo/expo/pull/14383) by [@cruzach](https://github.com/cruzach))
 
 ### 🐛 Bug fixes
 
 - Added `AndroidManifest.xml` queries for intent handling. ([#13388](https://github.com/expo/expo/pull/13388) by [@EvanBacon](https://github.com/EvanBacon))
+- Added possibility to pass mimetypes array in order to set multiple mimetypes, fix bug with default mimetype. ([#13751](https://github.com/expo/expo/pull/13751) by [@mstach60161](https://github.com/mstach60161))
+- Added mimetype to getDocumentAsync result. ([#13702](https://github.com/expo/expo/pull/13702) by [@mstach60161](https://github.com/mstach60161))
+- Fixed file uri. ([#13678](https://github.com/expo/expo/pull/13678) by [@mstach60161](https://github.com/mstach60161))
+- Fix building errors from use_frameworks! in Podfile. ([#14523](https://github.com/expo/expo/pull/14523) by [@kudo](https://github.com/kudo))
 
-## 9.2.1 — 2021-06-22
+### 💡 Others
 
-_This version does not introduce any user-facing changes._
+- Migrated from `@unimodules/core` to `expo-modules-core`. ([#13757](https://github.com/expo/expo/pull/13757) by [@tsapeta](https://github.com/tsapeta))
+- Updated `@expo/config-plugins` ([#14443](https://github.com/expo/expo/pull/14443) by [@EvanBacon](https://github.com/EvanBacon))
 
 ## 9.2.0 — 2021-06-16
 

package/android/build.gradle

@@ -3,7 +3,7 @@ apply plugin: 'kotlin-android'
 apply plugin: 'maven'
 
 group = 'host.exp.exponent'
-version = '9.2.3'
+version = '10.0.2'
 
 buildscript {
   // Simple helper that allows the root project to override versions declared by this library.
@@ -53,27 +53,23 @@ android {
     targetCompatibility JavaVersion.VERSION_1_8
   }
 
+  kotlinOptions {
+    jvmTarget = JavaVersion.VERSION_1_8
+  }
+
   defaultConfig {
     minSdkVersion safeExtGet("minSdkVersion", 21)
     targetSdkVersion safeExtGet("targetSdkVersion", 30)
     versionCode 17
-    versionName '9.2.3'
+    versionName '10.0.2'
   }
   lintOptions {
     abortOnError false
   }
 }
 
-if (new File(rootProject.projectDir.parentFile, 'package.json').exists()) {
-  apply from: project(':unimodules-core').file('../unimodules-core.gradle')
-} else {
-  throw new GradleException(
-      '\'unimodules-core.gradle\' was not found in the usual React Native dependency location. ' +
-          'This package can only be used in such projects. Are you sure you\'ve installed the dependencies properly?')
-}
-
 dependencies {
-  unimodule 'unimodules-core'
+  implementation project(':expo-modules-core')
 
   api "androidx.annotation:annotation:1.0.0"
   api 'commons-io:commons-io:2.6'

package/android/src/main/AndroidManifest.xml

@@ -1,4 +1,4 @@
-<manifest package="expo.modules.documentpicker">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="expo.modules.documentpicker">
 
     <queries>
         <!-- Query open documents -->

package/android/src/main/java/expo/modules/documentpicker/DocumentDetailsReader.kt

@@ -4,7 +4,7 @@ import android.content.Context
 import android.net.Uri
 import android.provider.OpenableColumns
 
-data class DocumentDetails(val name: String, val uri: String, val size: Int?)
+data class DocumentDetails(val name: String, val uri: String, val size: Int?, val mimeType: String?)
 
 class DocumentDetailsReader(private val context: Context) {
   fun read(uri: Uri): DocumentDetails? {
@@ -22,7 +22,8 @@ class DocumentDetailsReader(private val context: Context) {
             null
           }
         }
-        return DocumentDetails(name, uriString, size)
+        val mimeType = context.contentResolver.getType(uri)
+        return DocumentDetails(name, uriString, size, mimeType)
       }
     return null
   }

package/android/src/main/java/expo/modules/documentpicker/DocumentPickerModule.kt

@@ -7,15 +7,15 @@ import android.net.Uri
 import android.os.Bundle
 import org.apache.commons.io.FilenameUtils
 import org.apache.commons.io.IOUtils
-import org.unimodules.core.ExportedModule
-import org.unimodules.core.ModuleRegistry
-import org.unimodules.core.ModuleRegistryDelegate
-import org.unimodules.core.Promise
-import org.unimodules.core.interfaces.ActivityEventListener
-import org.unimodules.core.interfaces.ActivityProvider
-import org.unimodules.core.interfaces.ExpoMethod
-import org.unimodules.core.interfaces.services.UIManager
-import org.unimodules.core.utilities.FileUtilities
+import expo.modules.core.ExportedModule
+import expo.modules.core.ModuleRegistry
+import expo.modules.core.ModuleRegistryDelegate
+import expo.modules.core.Promise
+import expo.modules.core.interfaces.ActivityEventListener
+import expo.modules.core.interfaces.ActivityProvider
+import expo.modules.core.interfaces.ExpoMethod
+import expo.modules.core.interfaces.services.UIManager
+import expo.modules.core.utilities.FileUtilities
 import java.io.File
 import java.io.FileOutputStream
 import java.io.IOException
@@ -25,7 +25,7 @@ private const val OPEN_DOCUMENT_CODE = 4137
 
 class DocumentPickerModule(
   mContext: Context,
-  private val moduleRegistryDelegate: ModuleRegistryDelegate = ModuleRegistryDelegate(),
+  private val moduleRegistryDelegate: ModuleRegistryDelegate = ModuleRegistryDelegate()
 ) : ExportedModule(mContext), ActivityEventListener {
   private var mPromise: Promise? = null
   private var mCopyToCacheDirectory = true
@@ -48,17 +48,18 @@ class DocumentPickerModule(
       promise.reject("E_DOCUMENT_PICKER", "Different document picking in progress. Await other document picking first.")
       return
     }
-
     val pickerOptions = DocumentPickerOptions.optionsFromMap(options, promise) ?: return
-
     mPromise = promise
     mCopyToCacheDirectory = pickerOptions.copyToCacheDirectory
-
     val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
       addCategory(Intent.CATEGORY_OPENABLE)
-      type = pickerOptions.type
+      type = if (pickerOptions.types.size > 1) {
+        putExtra(Intent.EXTRA_MIME_TYPES, pickerOptions.types)
+        "*/*"
+      } else {
+        pickerOptions.types[0]
+      }
     }
-
     mActivityProvider.currentActivity.startActivityForResult(intent, OPEN_DOCUMENT_CODE)
   }
 
@@ -88,7 +89,6 @@ class DocumentPickerModule(
           }
         }
       }
-
       if (documentDetails == null) {
         promise.reject("E_DOCUMENT_PICKER", "Failed to read the selected document.")
       } else {
@@ -96,9 +96,10 @@ class DocumentPickerModule(
           putString("type", "success")
           putString("uri", documentDetails.uri)
           putString("name", documentDetails.name)
-          if (documentDetails.size == null) {
-            putParcelable("size", null)
-          } else {
+          documentDetails.mimeType?.let {
+            putString("mimeType", documentDetails.mimeType)
+          }
+          documentDetails.size?.let {
             putInt("size", documentDetails.size)
           }
         }
@@ -120,10 +121,10 @@ class DocumentPickerModule(
       "DocumentPicker",
       FilenameUtils.getExtension(name)
     )
-
+    val outputFile = File(outputFilePath)
     try {
       context.contentResolver.openInputStream(documentUri).use { inputStream ->
-        FileOutputStream(File(outputFilePath)).use { outputStream ->
+        FileOutputStream(outputFile).use { outputStream ->
           IOUtils.copy(inputStream, outputStream)
         }
       }
@@ -131,7 +132,6 @@ class DocumentPickerModule(
       e.printStackTrace()
       return null
     }
-
-    return outputFilePath
+    return Uri.fromFile(outputFile).toString()
   }
 }

package/android/src/main/java/expo/modules/documentpicker/DocumentPickerOptions.kt

@@ -1,19 +1,25 @@
 package expo.modules.documentpicker
 
-import org.unimodules.core.Promise
+import expo.modules.core.Promise
 
-data class DocumentPickerOptions(val type: String, val copyToCacheDirectory: Boolean) {
+data class DocumentPickerOptions(val copyToCacheDirectory: Boolean, val types: Array<String>) {
   companion object {
     fun optionsFromMap(options: Map<String, Any?>, promise: Promise): DocumentPickerOptions? {
-      val type = options["type"]?.let {
-        if (it is String) {
-          return@let it
-        }
-
-        promise.reject("ERR_INVALID_OPTION", "type must be a string")
+      if (options.containsKey("type") && options["type"] == null) {
+        promise.reject("ERR_INVALID_OPTION", "type must be a list of strings")
         return null
-      } ?: "*/*"
-
+      }
+      var mimeTypes = arrayListOf("*/*")
+      options["type"]?.let {
+        val types = it as ArrayList<*>
+        if (types.isEmpty() || types[0] !is String) {
+          promise.reject("ERR_INVALID_OPTION", "type must be a list of strings")
+          return null
+        } else {
+          @Suppress("UNCHECKED_CAST")
+          mimeTypes = types as ArrayList<String>
+        }
+      }
       val copyToCacheDirectory = options["copyToCacheDirectory"]?.let {
         if (it is Boolean) {
           return@let it
@@ -21,8 +27,25 @@ data class DocumentPickerOptions(val type: String, val copyToCacheDirectory: Boo
         promise.reject("ERR_INVALID_OPTION", "copyToCacheDirectory must be a boolean")
         return null
       } ?: true
-
-      return DocumentPickerOptions(type, copyToCacheDirectory)
+      return DocumentPickerOptions(copyToCacheDirectory, mimeTypes.toTypedArray())
     }
   }
+
+  override fun equals(other: Any?): Boolean {
+    if (this === other) return true
+    if (javaClass != other?.javaClass) return false
+
+    other as DocumentPickerOptions
+
+    if (copyToCacheDirectory != other.copyToCacheDirectory) return false
+    if (!types.contentEquals(other.types)) return false
+
+    return true
+  }
+
+  override fun hashCode(): Int {
+    var result = copyToCacheDirectory.hashCode()
+    result = 31 * result + types.contentHashCode()
+    return result
+  }
 }

package/android/src/main/java/expo/modules/documentpicker/DocumentPickerPackage.kt

@@ -1,7 +1,7 @@
 package expo.modules.documentpicker
 
 import android.content.Context
-import org.unimodules.core.BasePackage
+import expo.modules.core.BasePackage
 
 class DocumentPickerPackage : BasePackage() {
   override fun createExportedModules(context: Context) = listOf(DocumentPickerModule(context))

package/build/ExpoDocumentPicker.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("@unimodules/core").ProxyNativeModule;
+declare const _default: import("expo-modules-core").ProxyNativeModule;
 export default _default;

package/build/ExpoDocumentPicker.js

@@ -1,3 +1,3 @@
-import { NativeModulesProxy } from '@unimodules/core';
+import { NativeModulesProxy } from 'expo-modules-core';
 export default NativeModulesProxy.ExpoDocumentPicker;
 //# sourceMappingURL=ExpoDocumentPicker.js.map

package/build/ExpoDocumentPicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoDocumentPicker.js","sourceRoot":"","sources":["../src/ExpoDocumentPicker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,eAAe,kBAAkB,CAAC,kBAAkB,CAAC","sourcesContent":["import { NativeModulesProxy } from '@unimodules/core';\n\nexport default NativeModulesProxy.ExpoDocumentPicker;\n"]}
+{"version":3,"file":"ExpoDocumentPicker.js","sourceRoot":"","sources":["../src/ExpoDocumentPicker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAe,kBAAkB,CAAC,kBAAkB,CAAC","sourcesContent":["import { NativeModulesProxy } from 'expo-modules-core';\n\nexport default NativeModulesProxy.ExpoDocumentPicker;\n"]}

package/build/ExpoDocumentPicker.web.js

@@ -1,4 +1,4 @@
-import { Platform } from '@unimodules/core';
+import { Platform } from 'expo-modules-core';
 import { v4 as uuidv4 } from 'uuid';
 export default {
     get name() {
@@ -12,7 +12,7 @@ export default {
         const input = document.createElement('input');
         input.style.display = 'none';
         input.setAttribute('type', 'file');
-        input.setAttribute('accept', type);
+        input.setAttribute('accept', Array.isArray(type) ? type.join(',') : type);
         input.setAttribute('id', uuidv4());
         if (multiple) {
             input.setAttribute('multiple', 'multiple');
@@ -22,6 +22,7 @@ export default {
             input.addEventListener('change', () => {
                 if (input.files) {
                     const targetFile = input.files[0];
+                    const mimeType = targetFile.type;
                     const reader = new FileReader();
                     reader.onerror = () => {
                         reject(new Error(`Failed to read the selected media because the operation failed.`));
@@ -31,6 +32,7 @@ export default {
                         resolve({
                             type: 'success',
                             uri,
+                            mimeType,
                             name: targetFile.name,
                             file: targetFile,
                             lastModified: targetFile.lastModified,

package/build/ExpoDocumentPicker.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoDocumentPicker.web.js","sourceRoot":"","sources":["../src/ExpoDocumentPicker.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAIpC,eAAe;IACb,IAAI,IAAI;QACN,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,EACrB,IAAI,GAAG,KAAK,EACZ,QAAQ,GAAG,KAAK,GACM;QACtB,YAAY;QACZ,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE;YAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC3B;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC7B,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,IAAI,QAAQ,EAAE;YACZ,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;SAC5C;QAED,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACpC,IAAI,KAAK,CAAC,KAAK,EAAE;oBACf,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAClC,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;oBAChC,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;wBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC,CAAC;oBACvF,CAAC,CAAC;oBACF,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;wBAC7B,MAAM,GAAG,GAAI,MAAc,CAAC,MAAM,CAAC;wBACnC,OAAO,CAAC;4BACN,IAAI,EAAE,SAAS;4BACf,GAAG;4BACH,IAAI,EAAE,UAAU,CAAC,IAAI;4BACrB,IAAI,EAAE,UAAU;4BAChB,YAAY,EAAE,UAAU,CAAC,YAAY;4BACrC,IAAI,EAAE,UAAU,CAAC,IAAI;4BACrB,MAAM,EAAE,KAAK,CAAC,KAAK;yBACpB,CAAC,CAAC;oBACL,CAAC,CAAC;oBACF,6CAA6C;oBAC7C,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;iBAClC;qBAAM;oBACL,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;iBAC7B;gBAED,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;YACtC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC","sourcesContent":["import { Platform } from '@unimodules/core';\nimport { v4 as uuidv4 } from 'uuid';\n\nimport { DocumentPickerOptions, DocumentResult } from './types';\n\nexport default {\n  get name(): string {\n    return 'ExpoDocumentPicker';\n  },\n\n  async getDocumentAsync({\n    type = '*/*',\n    multiple = false,\n  }: DocumentPickerOptions): Promise<DocumentResult> {\n    // SSR guard\n    if (!Platform.isDOMAvailable) {\n      return { type: 'cancel' };\n    }\n\n    const input = document.createElement('input');\n    input.style.display = 'none';\n    input.setAttribute('type', 'file');\n    input.setAttribute('accept', type);\n    input.setAttribute('id', uuidv4());\n    if (multiple) {\n      input.setAttribute('multiple', 'multiple');\n    }\n\n    document.body.appendChild(input);\n\n    return new Promise((resolve, reject) => {\n      input.addEventListener('change', () => {\n        if (input.files) {\n          const targetFile = input.files[0];\n          const reader = new FileReader();\n          reader.onerror = () => {\n            reject(new Error(`Failed to read the selected media because the operation failed.`));\n          };\n          reader.onload = ({ target }) => {\n            const uri = (target as any).result;\n            resolve({\n              type: 'success',\n              uri,\n              name: targetFile.name,\n              file: targetFile,\n              lastModified: targetFile.lastModified,\n              size: targetFile.size,\n              output: input.files,\n            });\n          };\n          // Read in the image file as a binary string.\n          reader.readAsDataURL(targetFile);\n        } else {\n          resolve({ type: 'cancel' });\n        }\n\n        document.body.removeChild(input);\n      });\n\n      const event = new MouseEvent('click');\n      input.dispatchEvent(event);\n    });\n  },\n};\n"]}
+{"version":3,"file":"ExpoDocumentPicker.web.js","sourceRoot":"","sources":["../src/ExpoDocumentPicker.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAIpC,eAAe;IACb,IAAI,IAAI;QACN,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,EACrB,IAAI,GAAG,KAAK,EACZ,QAAQ,GAAG,KAAK,GACM;QACtB,YAAY;QACZ,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE;YAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC3B;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC7B,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1E,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,IAAI,QAAQ,EAAE;YACZ,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;SAC5C;QAED,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACpC,IAAI,KAAK,CAAC,KAAK,EAAE;oBACf,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAClC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;oBACjC,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;oBAChC,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;wBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC,CAAC;oBACvF,CAAC,CAAC;oBACF,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;wBAC7B,MAAM,GAAG,GAAI,MAAc,CAAC,MAAM,CAAC;wBACnC,OAAO,CAAC;4BACN,IAAI,EAAE,SAAS;4BACf,GAAG;4BACH,QAAQ;4BACR,IAAI,EAAE,UAAU,CAAC,IAAI;4BACrB,IAAI,EAAE,UAAU;4BAChB,YAAY,EAAE,UAAU,CAAC,YAAY;4BACrC,IAAI,EAAE,UAAU,CAAC,IAAI;4BACrB,MAAM,EAAE,KAAK,CAAC,KAAK;yBACpB,CAAC,CAAC;oBACL,CAAC,CAAC;oBACF,6CAA6C;oBAC7C,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;iBAClC;qBAAM;oBACL,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;iBAC7B;gBAED,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;YACtC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC","sourcesContent":["import { Platform } from 'expo-modules-core';\nimport { v4 as uuidv4 } from 'uuid';\n\nimport { DocumentPickerOptions, DocumentResult } from './types';\n\nexport default {\n  get name(): string {\n    return 'ExpoDocumentPicker';\n  },\n\n  async getDocumentAsync({\n    type = '*/*',\n    multiple = false,\n  }: DocumentPickerOptions): Promise<DocumentResult> {\n    // SSR guard\n    if (!Platform.isDOMAvailable) {\n      return { type: 'cancel' };\n    }\n\n    const input = document.createElement('input');\n    input.style.display = 'none';\n    input.setAttribute('type', 'file');\n    input.setAttribute('accept', Array.isArray(type) ? type.join(',') : type);\n    input.setAttribute('id', uuidv4());\n    if (multiple) {\n      input.setAttribute('multiple', 'multiple');\n    }\n\n    document.body.appendChild(input);\n\n    return new Promise((resolve, reject) => {\n      input.addEventListener('change', () => {\n        if (input.files) {\n          const targetFile = input.files[0];\n          const mimeType = targetFile.type;\n          const reader = new FileReader();\n          reader.onerror = () => {\n            reject(new Error(`Failed to read the selected media because the operation failed.`));\n          };\n          reader.onload = ({ target }) => {\n            const uri = (target as any).result;\n            resolve({\n              type: 'success',\n              uri,\n              mimeType,\n              name: targetFile.name,\n              file: targetFile,\n              lastModified: targetFile.lastModified,\n              size: targetFile.size,\n              output: input.files,\n            });\n          };\n          // Read in the image file as a binary string.\n          reader.readAsDataURL(targetFile);\n        } else {\n          resolve({ type: 'cancel' });\n        }\n\n        document.body.removeChild(input);\n      });\n\n      const event = new MouseEvent('click');\n      input.dispatchEvent(event);\n    });\n  },\n};\n"]}

package/build/index.d.ts

@@ -1,3 +1,14 @@
 import { DocumentPickerOptions, DocumentResult } from './types';
 export { DocumentPickerOptions, DocumentResult };
+/**
+ * Display the system UI for choosing a document. By default, the chosen file is copied to [the app's internal cache directory](filesystem.md#filesystemcachedirectory).
+ * > **Notes for Web:** The system UI can only be shown after user activation (e.g. a `Button` press).
+ * Therefore, calling `getDocumentAsync` in `componentDidMount`, for example, will **not** work as
+ * intended. The `cancel` event will not be returned in the browser due to platform restrictions and
+ * inconsistencies across browsers.
+ *
+ * @return On success returns a promise that fulfils with [`DocumentResult`](#documentresult) object.
+ *
+ * If the user cancelled the document picking, the promise resolves to `{ type: 'cancel' }`.
+ */
 export declare function getDocumentAsync({ type, copyToCacheDirectory, multiple, }?: DocumentPickerOptions): Promise<DocumentResult>;

package/build/index.js

@@ -1,5 +1,20 @@
 import ExpoDocumentPicker from './ExpoDocumentPicker';
+// @needsAudit
+/**
+ * Display the system UI for choosing a document. By default, the chosen file is copied to [the app's internal cache directory](filesystem.md#filesystemcachedirectory).
+ * > **Notes for Web:** The system UI can only be shown after user activation (e.g. a `Button` press).
+ * Therefore, calling `getDocumentAsync` in `componentDidMount`, for example, will **not** work as
+ * intended. The `cancel` event will not be returned in the browser due to platform restrictions and
+ * inconsistencies across browsers.
+ *
+ * @return On success returns a promise that fulfils with [`DocumentResult`](#documentresult) object.
+ *
+ * If the user cancelled the document picking, the promise resolves to `{ type: 'cancel' }`.
+ */
 export async function getDocumentAsync({ type = '*/*', copyToCacheDirectory = true, multiple = false, } = {}) {
+    if (typeof type === 'string') {
+        type = [type];
+    }
     return await ExpoDocumentPicker.getDocumentAsync({ type, copyToCacheDirectory, multiple });
 }
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAItD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,IAAI,GAAG,KAAK,EACZ,oBAAoB,GAAG,IAAI,EAC3B,QAAQ,GAAG,KAAK,MACS,EAAE;IAC3B,OAAO,MAAM,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7F,CAAC","sourcesContent":["import ExpoDocumentPicker from './ExpoDocumentPicker';\nimport { DocumentPickerOptions, DocumentResult } from './types';\nexport { DocumentPickerOptions, DocumentResult };\n\nexport async function getDocumentAsync({\n  type = '*/*',\n  copyToCacheDirectory = true,\n  multiple = false,\n}: DocumentPickerOptions = {}): Promise<DocumentResult> {\n  return await ExpoDocumentPicker.getDocumentAsync({ type, copyToCacheDirectory, multiple });\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAItD,cAAc;AACd;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,IAAI,GAAG,KAAK,EACZ,oBAAoB,GAAG,IAAI,EAC3B,QAAQ,GAAG,KAAK,MACS,EAAE;IAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC5B,IAAI,GAAG,CAAC,IAAI,CAAa,CAAC;KAC3B;IACD,OAAO,MAAM,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7F,CAAC","sourcesContent":["import ExpoDocumentPicker from './ExpoDocumentPicker';\nimport { DocumentPickerOptions, DocumentResult } from './types';\nexport { DocumentPickerOptions, DocumentResult };\n\n// @needsAudit\n/**\n * Display the system UI for choosing a document. By default, the chosen file is copied to [the app's internal cache directory](filesystem.md#filesystemcachedirectory).\n * > **Notes for Web:** The system UI can only be shown after user activation (e.g. a `Button` press).\n * Therefore, calling `getDocumentAsync` in `componentDidMount`, for example, will **not** work as\n * intended. The `cancel` event will not be returned in the browser due to platform restrictions and\n * inconsistencies across browsers.\n *\n * @return On success returns a promise that fulfils with [`DocumentResult`](#documentresult) object.\n *\n * If the user cancelled the document picking, the promise resolves to `{ type: 'cancel' }`.\n */\nexport async function getDocumentAsync({\n  type = '*/*',\n  copyToCacheDirectory = true,\n  multiple = false,\n}: DocumentPickerOptions = {}): Promise<DocumentResult> {\n  if (typeof type === 'string') {\n    type = [type] as string[];\n  }\n  return await ExpoDocumentPicker.getDocumentAsync({ type, copyToCacheDirectory, multiple });\n}\n"]}

package/build/types.d.ts

@@ -1,15 +1,48 @@
+/**
+ *
+ */
 export declare type DocumentPickerOptions = {
-    type?: string;
+    /**
+     * The [MIME type(s)](https://en.wikipedia.org/wiki/Media_type) of the documents that are available
+     * to be picked. Is also supports wildcards like `'image/*'` to choose any image. To allow any type
+     * of document you can use `'*/*'`.
+     * @default `'*/*'`
+     */
+    type?: string | string[];
+    /**
+     * If `true`, the picked file is copied to [`FileSystem.CacheDirectory`](filesystem.md#filesystemcachedirectory),
+     * which allows other Expo APIs to read the file immediately. This may impact performance for
+     * large files, so you should consider setting this to `false` if you expect users to pick
+     * particularly large files and your app does not need immediate read access.
+     * @default `true`
+     */
     copyToCacheDirectory?: boolean;
+    /**
+     * __Web Only.__ Allows multiple files to be selected from the system UI.
+     * @default `false`
+     */
     multiple?: boolean;
 };
 export declare type DocumentResult = {
     type: 'cancel';
 } | {
     type: 'success';
+    /**
+     * Document original name.
+     */
     name: string;
-    size: number;
+    /**
+     * Document size in bytes.
+     */
+    size?: number;
+    /**
+     * An URI to the local document file.
+     */
     uri: string;
+    /**
+     * Document MIME type.
+     */
+    mimeType?: string;
     lastModified?: number;
     file?: File;
     output?: FileList | null;

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type DocumentPickerOptions = {\n  type?: string;\n  copyToCacheDirectory?: boolean;\n  multiple?: boolean;\n};\n\nexport type DocumentResult =\n  | { type: 'cancel' }\n  | {\n      type: 'success';\n      name: string;\n      size: number;\n      uri: string;\n      lastModified?: number;\n      file?: File;\n      output?: FileList | null;\n    };\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["// @needsAudit\n/**\n *\n */\nexport type DocumentPickerOptions = {\n  /**\n   * The [MIME type(s)](https://en.wikipedia.org/wiki/Media_type) of the documents that are available\n   * to be picked. Is also supports wildcards like `'image/*'` to choose any image. To allow any type\n   * of document you can use `'*/*'`.\n   * @default `'*/*'`\n   */\n  type?: string | string[];\n  /**\n   * If `true`, the picked file is copied to [`FileSystem.CacheDirectory`](filesystem.md#filesystemcachedirectory),\n   * which allows other Expo APIs to read the file immediately. This may impact performance for\n   * large files, so you should consider setting this to `false` if you expect users to pick\n   * particularly large files and your app does not need immediate read access.\n   * @default `true`\n   */\n  copyToCacheDirectory?: boolean;\n  /**\n   * __Web Only.__ Allows multiple files to be selected from the system UI.\n   * @default `false`\n   */\n  multiple?: boolean;\n};\n\n// @needsAudit @docsMissing\nexport type DocumentResult =\n  | { type: 'cancel' }\n  | {\n      type: 'success';\n      /**\n       * Document original name.\n       */\n      name: string;\n      /**\n       * Document size in bytes.\n       */\n      size?: number;\n      /**\n       * An URI to the local document file.\n       */\n      uri: string;\n      /**\n       * Document MIME type.\n       */\n      mimeType?: string;\n      lastModified?: number;\n      file?: File;\n      output?: FileList | null;\n    };\n"]}

package/ios/EXDocumentPicker/EXDocumentPickerModule.h

@@ -1,7 +1,7 @@
 //  Copyright © 2018 650 Industries. All rights reserved.
 
-#import <UMCore/UMExportedModule.h>
-#import <UMCore/UMModuleRegistryConsumer.h>
+#import <ExpoModulesCore/EXExportedModule.h>
+#import <ExpoModulesCore/EXModuleRegistryConsumer.h>
 
-@interface EXDocumentPickerModule : UMExportedModule <UMModuleRegistryConsumer>
+@interface EXDocumentPickerModule : EXExportedModule <EXModuleRegistryConsumer>
 @end

package/ios/EXDocumentPicker/EXDocumentPickerModule.m

@@ -2,7 +2,7 @@
 
 
 #import <EXDocumentPicker/EXDocumentPickerModule.h>
-#import <UMCore/UMUtilitiesInterface.h>
+#import <ExpoModulesCore/EXUtilitiesInterface.h>
 #import <ExpoModulesCore/EXFileSystemInterface.h>
 
 #import <UIKit/UIKit.h>
@@ -20,7 +20,7 @@
     // UTType#typeWithMIMEType doesn't work with wildcard mimetypes
     // so support common top level types with wildcards here.
     if ([mimeType isEqualToString:@"*/*"]) {
-      return UTTypeData;
+      return UTTypeItem;
     } else if ([mimeType isEqualToString:@"image/*"]) {
       return UTTypeImage;
     } else if ([mimeType isEqualToString:@"video/*"]) {
@@ -43,7 +43,7 @@ static NSString * EXConvertMimeTypeToUTI(NSString *mimeType)
   // UTTypeCreatePreferredIdentifierForTag doesn't work with wildcard mimetypes
   // so support common top level types with wildcards here.
   if ([mimeType isEqualToString:@"*/*"]) {
-    uti = kUTTypeData;
+    uti = kUTTypeItem;
   } else if ([mimeType isEqualToString:@"image/*"]) {
     uti = kUTTypeImage;
   } else if ([mimeType isEqualToString:@"video/*"]) {
@@ -62,12 +62,12 @@ static NSString * EXConvertMimeTypeToUTI(NSString *mimeType)
 
 @interface EXDocumentPickerModule () <UIDocumentPickerDelegate, UIAdaptivePresentationControllerDelegate>
 
-@property (nonatomic, weak) UMModuleRegistry *moduleRegistry;
+@property (nonatomic, weak) EXModuleRegistry *moduleRegistry;
 @property (nonatomic, weak) id<EXFileSystemInterface> fileSystem;
-@property (nonatomic, weak) id<UMUtilitiesInterface> utilities;
+@property (nonatomic, weak) id<EXUtilitiesInterface> utilities;
 
-@property (nonatomic, strong) UMPromiseResolveBlock resolve;
-@property (nonatomic, strong) UMPromiseRejectBlock reject;
+@property (nonatomic, strong) EXPromiseResolveBlock resolve;
+@property (nonatomic, strong) EXPromiseRejectBlock reject;
 
 @property (nonatomic, assign) BOOL shouldCopyToCacheDirectory;
 
@@ -75,49 +75,60 @@ static NSString * EXConvertMimeTypeToUTI(NSString *mimeType)
 
 @implementation EXDocumentPickerModule
 
-UM_EXPORT_MODULE(ExpoDocumentPicker);
+EX_EXPORT_MODULE(ExpoDocumentPicker);
 
-- (void)setModuleRegistry:(UMModuleRegistry *)moduleRegistry
+- (void)setModuleRegistry:(EXModuleRegistry *)moduleRegistry
 {
   _moduleRegistry = moduleRegistry;
   
   if (_moduleRegistry != nil) {
     _fileSystem = [moduleRegistry getModuleImplementingProtocol:@protocol(EXFileSystemInterface)];
-    _utilities = [moduleRegistry getModuleImplementingProtocol:@protocol(UMUtilitiesInterface)];
+    _utilities = [moduleRegistry getModuleImplementingProtocol:@protocol(EXUtilitiesInterface)];
   }
 }
 
-UM_EXPORT_METHOD_AS(getDocumentAsync,
+EX_EXPORT_METHOD_AS(getDocumentAsync,
                     options:(NSDictionary *)options
-                    resolve:(UMPromiseResolveBlock)resolve
-                    reject:(UMPromiseRejectBlock)reject)
+                    resolve:(EXPromiseResolveBlock)resolve
+                    reject:(EXPromiseRejectBlock)reject)
 {
   if (_resolve != nil) {
     return reject(@"E_DOCUMENT_PICKER", @"Different document picking in progress. Await other document picking first.", nil);
   }
   _resolve = resolve;
   _reject = reject;
-  
-  NSString *mimeType = options[@"type"] ?: @"*/*";
-  
+    
+  NSArray *mimeTypes = options[@"type"] ?: @[@"*/*"];
+  if (mimeTypes.count == 0) {
+    reject(@"E_DOCUMENT_PICKER", @"type must be a list of strings.", nil);
+    _resolve = nil;
+    _reject = nil;
+    return;
+  }
   _shouldCopyToCacheDirectory = options[@"copyToCacheDirectory"] && [options[@"copyToCacheDirectory"] boolValue] == YES;
 
-  UM_WEAKIFY(self);
+  EX_WEAKIFY(self);
 
   dispatch_async(dispatch_get_main_queue(), ^{
-    UM_ENSURE_STRONGIFY(self);
+    EX_ENSURE_STRONGIFY(self);
     UIDocumentPickerViewController *documentPickerVC;
 
     @try {
       // TODO: drop #if macro once Xcode is updated to 12
 #if __IPHONE_OS_VERSION_MAX_ALLOWED >= 140000
       if (@available(iOS 14, *)) {
-        UTType* utType = EXConvertMimeTypeToUTType(mimeType);
-        documentPickerVC = [[UIDocumentPickerViewController alloc] initForOpeningContentTypes:@[utType] asCopy:YES];
+        NSMutableArray *utTypes = [mimeTypes mutableCopy];
+        for (int i = 0; i < [mimeTypes count]; i++) {
+          utTypes[i] = (NSString *)EXConvertMimeTypeToUTType(mimeTypes[i]);
+        }
+        documentPickerVC = [[UIDocumentPickerViewController alloc] initForOpeningContentTypes:utTypes asCopy:true];
       } else {
 #endif
-        NSString* type = EXConvertMimeTypeToUTI(mimeType);
-        documentPickerVC = [[UIDocumentPickerViewController alloc] initWithDocumentTypes:@[type]
+        NSMutableArray *utiTypes = [mimeTypes mutableCopy];
+        for (int i = 0; i < [mimeTypes count]; i++) {
+          utiTypes[i] = (NSString *)EXConvertMimeTypeToUTI(mimeTypes[i]);
+        }
+        documentPickerVC = [[UIDocumentPickerViewController alloc] initWithDocumentTypes:utiTypes
                                                                                   inMode:UIDocumentPickerModeImport];
         // TODO: drop #if macro once Xcode is updated to 12
 #if __IPHONE_OS_VERSION_MAX_ALLOWED >= 140000
@@ -172,12 +183,16 @@ UM_EXPORT_METHOD_AS(getDocumentAsync,
       return;
     }
   }
+    
+  NSString *extension = [url pathExtension];
+  NSString *mimeType = [EXDocumentPickerModule getMimeType:extension];
   
   _resolve(@{
              @"type": @"success",
              @"uri": [newUrl absoluteString],
              @"name": [url lastPathComponent],
              @"size": @(fileSize),
+             @"mimeType": mimeType
              });
   _resolve = nil;
   _reject = nil;
@@ -227,4 +242,10 @@ UM_EXPORT_METHOD_AS(getDocumentAsync,
   return folderSize;
 }
 
++ (NSString *)getMimeType:(NSString *)fileExtension{
+  NSString *UTI = (__bridge_transfer NSString *)UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (__bridge CFStringRef)fileExtension, NULL);
+  NSString *mimeType = (__bridge_transfer NSString *)UTTypeCopyPreferredTagWithClass((__bridge CFStringRef)UTI, kUTTagClassMIMEType);
+  return mimeType;
+}
+
 @end

package/ios/EXDocumentPicker.podspec

@@ -10,10 +10,10 @@ Pod::Spec.new do |s|
   s.license        = package['license']
   s.author         = package['author']
   s.homepage       = package['homepage']
-  s.platform       = :ios, '11.0'
+  s.platform       = :ios, '12.0'
   s.source         = { git: 'https://github.com/expo/expo.git' }
+  s.static_framework = true
 
-  s.dependency 'UMCore'
   s.dependency 'ExpoModulesCore'
 
   if !$ExpoUseSources&.include?(package['name']) && ENV['EXPO_USE_SOURCE'].to_i == 0 && File.exist?("#{s.name}.xcframework") && Gem::Version.new(Pod::VERSION) >= Gem::Version.new('1.10.0')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-document-picker",
-  "version": "9.2.3",
+  "version": "10.0.2",
   "description": "Provides access to the system's UI for selecting documents from the available providers on the user's device.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -30,20 +30,17 @@
   },
   "author": "650 Industries, Inc.",
   "license": "MIT",
-  "homepage": "https://docs.expo.io/versions/latest/sdk/document-picker/",
+  "homepage": "https://docs.expo.dev/versions/latest/sdk/document-picker/",
   "jest": {
     "preset": "expo-module-scripts/ios"
   },
   "dependencies": {
-    "@expo/config-plugins": "^3.0.0",
-    "expo-modules-core": "~0.2.0",
+    "@expo/config-plugins": "^3.1.0",
+    "expo-modules-core": "~0.4.3",
     "uuid": "^3.3.2"
   },
-  "unimodulePeerDependencies": {
-    "@unimodules/core": "*"
-  },
   "devDependencies": {
     "expo-module-scripts": "^2.0.0"
   },
-  "gitHead": "4fc9d282ff7ab2fa9040b775aeca7c30f5167b17"
+  "gitHead": "d23e1ac491da96b51c25eb2533efcd56499ee287"
 }

package/plugin/build/withDocumentPickerIOS.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setICloudEntitlments = exports.withDocumentPickerIOS = void 0;
 const config_plugins_1 = require("@expo/config-plugins");
-exports.withDocumentPickerIOS = (config, { appleTeamId }) => {
-    return config_plugins_1.withEntitlementsPlist(config, config => {
+const withDocumentPickerIOS = (config, { appleTeamId }) => {
+    return config_plugins_1.withEntitlementsPlist(config, (config) => {
         if (appleTeamId) {
             config.modResults = setICloudEntitlments(config, appleTeamId, config.modResults);
         }
@@ -13,6 +13,7 @@ exports.withDocumentPickerIOS = (config, { appleTeamId }) => {
         return config;
     });
 };
+exports.withDocumentPickerIOS = withDocumentPickerIOS;
 function setICloudEntitlments(config, appleTeamId, entitlements) {
     var _a;
     if ((_a = config.ios) === null || _a === void 0 ? void 0 : _a.usesIcloudStorage) {

package/plugin/src/withDocumentPickerIOS.ts

@@ -5,7 +5,7 @@ export const withDocumentPickerIOS: ConfigPlugin<{ appleTeamId?: string }> = (
   config,
   { appleTeamId }
 ) => {
-  return withEntitlementsPlist(config, config => {
+  return withEntitlementsPlist(config, (config) => {
     if (appleTeamId) {
       config.modResults = setICloudEntitlments(config, appleTeamId, config.modResults);
     } else {

package/src/ExpoDocumentPicker.ts

@@ -1,3 +1,3 @@
-import { NativeModulesProxy } from '@unimodules/core';
+import { NativeModulesProxy } from 'expo-modules-core';
 
 export default NativeModulesProxy.ExpoDocumentPicker;

package/src/ExpoDocumentPicker.web.ts

@@ -1,4 +1,4 @@
-import { Platform } from '@unimodules/core';
+import { Platform } from 'expo-modules-core';
 import { v4 as uuidv4 } from 'uuid';
 
 import { DocumentPickerOptions, DocumentResult } from './types';
@@ -20,7 +20,7 @@ export default {
     const input = document.createElement('input');
     input.style.display = 'none';
     input.setAttribute('type', 'file');
-    input.setAttribute('accept', type);
+    input.setAttribute('accept', Array.isArray(type) ? type.join(',') : type);
     input.setAttribute('id', uuidv4());
     if (multiple) {
       input.setAttribute('multiple', 'multiple');
@@ -32,6 +32,7 @@ export default {
       input.addEventListener('change', () => {
         if (input.files) {
           const targetFile = input.files[0];
+          const mimeType = targetFile.type;
           const reader = new FileReader();
           reader.onerror = () => {
             reject(new Error(`Failed to read the selected media because the operation failed.`));
@@ -41,6 +42,7 @@ export default {
             resolve({
               type: 'success',
               uri,
+              mimeType,
               name: targetFile.name,
               file: targetFile,
               lastModified: targetFile.lastModified,

package/src/index.ts

@@ -2,10 +2,25 @@ import ExpoDocumentPicker from './ExpoDocumentPicker';
 import { DocumentPickerOptions, DocumentResult } from './types';
 export { DocumentPickerOptions, DocumentResult };
 
+// @needsAudit
+/**
+ * Display the system UI for choosing a document. By default, the chosen file is copied to [the app's internal cache directory](filesystem.md#filesystemcachedirectory).
+ * > **Notes for Web:** The system UI can only be shown after user activation (e.g. a `Button` press).
+ * Therefore, calling `getDocumentAsync` in `componentDidMount`, for example, will **not** work as
+ * intended. The `cancel` event will not be returned in the browser due to platform restrictions and
+ * inconsistencies across browsers.
+ *
+ * @return On success returns a promise that fulfils with [`DocumentResult`](#documentresult) object.
+ *
+ * If the user cancelled the document picking, the promise resolves to `{ type: 'cancel' }`.
+ */
 export async function getDocumentAsync({
   type = '*/*',
   copyToCacheDirectory = true,
   multiple = false,
 }: DocumentPickerOptions = {}): Promise<DocumentResult> {
+  if (typeof type === 'string') {
+    type = [type] as string[];
+  }
   return await ExpoDocumentPicker.getDocumentAsync({ type, copyToCacheDirectory, multiple });
 }

package/src/types.ts

@@ -1,16 +1,51 @@
+// @needsAudit
+/**
+ *
+ */
 export type DocumentPickerOptions = {
-  type?: string;
+  /**
+   * The [MIME type(s)](https://en.wikipedia.org/wiki/Media_type) of the documents that are available
+   * to be picked. Is also supports wildcards like `'image/*'` to choose any image. To allow any type
+   * of document you can use `'*/*'`.
+   * @default `'*/*'`
+   */
+  type?: string | string[];
+  /**
+   * If `true`, the picked file is copied to [`FileSystem.CacheDirectory`](filesystem.md#filesystemcachedirectory),
+   * which allows other Expo APIs to read the file immediately. This may impact performance for
+   * large files, so you should consider setting this to `false` if you expect users to pick
+   * particularly large files and your app does not need immediate read access.
+   * @default `true`
+   */
   copyToCacheDirectory?: boolean;
+  /**
+   * __Web Only.__ Allows multiple files to be selected from the system UI.
+   * @default `false`
+   */
   multiple?: boolean;
 };
 
+// @needsAudit @docsMissing
 export type DocumentResult =
   | { type: 'cancel' }
   | {
       type: 'success';
+      /**
+       * Document original name.
+       */
       name: string;
-      size: number;
+      /**
+       * Document size in bytes.
+       */
+      size?: number;
+      /**
+       * An URI to the local document file.
+       */
       uri: string;
+      /**
+       * Document MIME type.
+       */
+      mimeType?: string;
       lastModified?: number;
       file?: File;
       output?: FileList | null;