@symbiote-native/document-picker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+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/README.md

@@ -0,0 +1,147 @@
+# @symbiote-native/document-picker
+
+Let users attach a PDF, a spreadsheet or any other file from wherever it lives: local storage,
+iCloud, Google Drive. One API for every [SymbioteNative](../../README.md) adapter (React, Vue,
+Svelte, Solid and Angular).
+
+It wraps [`expo-document-picker`](https://github.com/expo/expo/tree/main/packages/expo-document-picker),
+which opens the system's own document UI, the same way [`@symbiote-native/print`](../print) wraps
+its upstream: `expo-modules-core` is a direct dependency, never the `expo` meta-package, and the
+upstream JS is hand-ported into `core/`. The mechanics live in the `symbiote-expo-native-module`
+project skill.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --document-picker
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --document-picker
+```
+
+Either way: installs `@symbiote-native/document-picker` and wires the native autolinking
+automatically - see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/document-picker
+```
+
+`expo-document-picker` and `expo-modules-core` come along as regular, pinned dependencies - never
+install either yourself, and never add the `expo` meta-package to this project (it bundles its
+own Metro/Babel pipeline that conflicts with this project's own).
+
+### Required one-time step: native autolinking wiring
+
+Unlike a plain RN native module, `expo-document-picker`'s native code is discovered by
+`expo-modules-autolinking` - this needs wiring into the native host app **once**, covering this
+package and every other `expo-modules-core` package with zero further changes:
+
+| Platform | Touches                                                                               |
+| -------- | ------------------------------------------------------------------------------------- |
+| iOS      | `ios/Podfile` - add `use_expo_modules!`                                               |
+| iOS      | `AppDelegate.swift` - Expo's runtime-bootstrap hook                                   |
+| Android  | `settings.gradle` / `app/build.gradle` - resolve and include the Expo Gradle projects |
+| Android  | `MainApplication.kt` - Expo's bootstrap hook, plus a native-module name map           |
+
+Full mechanics live in the `symbiote-expo-native-module` skill. The per-package half of that
+table - the Gradle dependency and the module map entry - is generated by
+[`@symbiote-native/expo-modules-link`](../expo-modules-link) from this package's
+`native-link.json` on every install.
+
+### No runtime permission, no manifest edit
+
+- **No runtime permission on either platform.** The system document picker is the OS's own UI;
+  it runs outside the app's own permission surface.
+- **No manifest edit.** `expo-document-picker`'s own `AndroidManifest.xml` declares only a
+  `<queries>` block for Android 11+ package-visibility rules; it merges in automatically once the
+  Gradle project is included.
+- **iCloud entitlements are opt-in and not generated.** Upstream's config plugin sets
+  `com.apple.developer.icloud-container-environment` and related iCloud/ubiquity entitlement
+  keys, but only when the app's Expo config sets `ios.usesIcloudStorage` - off by default, and
+  this project has no Expo config to read it from in the first place (same reasoning as
+  `expo-notifications`' `aps-environment` entitlement - see that package's own README). If your
+  app needs iCloud-backed document picking, add those entitlement keys to your own
+  `Info.plist`/`.entitlements` file by hand; there is nothing here to enable.
+
+</details>
+
+## Shape
+
+```
+src/core/                 the whole API: getDocumentAsync. native-module.ts resolves
+                          ExpoDocumentPicker through expo-modules-core's requireNativeModule.
+src/angular/              @symbiote-native/document-picker/angular
+```
+
+`./react`, `./vue`, `./svelte`, and `./solid` are `exports`-map aliases straight onto `src/core/` -
+no physical per-framework file, same reason [`@symbiote-native/print`](../print) does the same:
+the whole surface is one stateless free function, nothing to wrap in a hook, composable, or
+service. `./angular` stays a physical file/subpath since Angular ships through a separate
+`ngc`/AOT build (`build-ngc/`).
+
+## Use it
+
+```ts
+import { getDocumentAsync } from '@symbiote-native/document-picker';
+
+const result = await getDocumentAsync({ type: 'application/pdf', multiple: true });
+if (!result.canceled) {
+  for (const asset of result.assets) {
+    console.log(asset.name, asset.uri, asset.size);
+  }
+}
+```
+
+## API
+
+| Export             | Signature                                                        | Notes                                    |
+| ------------------ | ------------------------------------------------------------------ | ------------------------------------------ |
+| `getDocumentAsync` | `(options?: IDocumentPickerOptions) => Promise<IDocumentPickerResult>` | Default `type` is any MIME type. |
+
+`IDocumentPickerOptions`: `type` (string or string array, wildcards allowed), `copyToCacheDirectory`
+(default `true`), `multiple` (default `false`).
+`IDocumentPickerResult`: `{ canceled: true; assets: null }` or
+`{ canceled: false; assets: IDocumentPickerAsset[] }`.
+`IDocumentPickerAsset`: `name`, `uri`, `lastModified`, plus optional `size` and `mimeType`.
+
+## Notes
+
+- **Check `canceled` before reading `assets`.** The result is a union: `assets` is `null` when the
+  user backs out.
+- **`size` and `mimeType` can be missing.** Not every provider reports them.
+- **Web-only fields dropped.** Upstream's `base64`/`file`/`output` fields only exist on the web
+  platform; this package targets iOS/Android only, so they're not part of the port (matching
+  `expo-module.config.json`'s own `platforms: ["apple", "android"]`).
+
+## Common questions
+
+- **`uri` is `content://` on Android and unreadable.** It happens with
+  `copyToCacheDirectory: false`; keep the default `true` so `uri` is a readable cache path.
+- **`size` is missing.** Some Android providers do not report it; read the copied file instead.
+- **Limit to PDFs or images.** Pass `type` (`'application/pdf'`, `'image/*'`, or an array).
+- **Permission?** None needed. **Several files?** `multiple: true`.
+
+Sources: [Expo docs: DocumentPicker](https://docs.expo.dev/versions/latest/sdk/document-picker/),
+[expo/expo#11075](https://github.com/expo/expo/issues/11075).
+
+## Test it
+
+```bash
+pnpm vitest run packages/document-picker
+```
+
+The core tests fake the native module in place of `requireNativeModule`'s runtime resolution -
+`ExpoDocumentPicker` only exists on a device, so a headless run would otherwise throw at import.
+Upstream's only test suite (`plugin/src/__tests__/withDocumentPickerIOS-test.ts`) exercises the
+config-plugin's `setICloudEntitlements` function - build-time code this project doesn't carry
+over (native config here is static `native-link.json`, not a plugin we run), so it isn't ported.
+The tests here cover the runtime API instead: option defaults, the string→array `type` coercion,
+and result delegation.

package/build/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build/angular/index.js

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core/index.js';

package/build/core/document-picker.d.ts

@@ -0,0 +1,3 @@
+import type { IDocumentPickerOptions, IDocumentPickerResult } from './types';
+/** Opens the system UI for picking one or more documents. */
+export declare function getDocumentAsync(options?: IDocumentPickerOptions): Promise<IDocumentPickerResult>;

package/build/core/document-picker.js

@@ -0,0 +1,10 @@
+import { expoDocumentPicker } from './native-module.js';
+/** Opens the system UI for picking one or more documents. */
+export async function getDocumentAsync(options = {}) {
+    const { type = '*/*', copyToCacheDirectory = true, multiple = false, } = options;
+    return await expoDocumentPicker.getDocumentAsync({
+        type: typeof type === 'string' ? [type] : type,
+        copyToCacheDirectory,
+        multiple,
+    });
+}

package/build/core/index.d.ts

@@ -0,0 +1,2 @@
+export { getDocumentAsync } from './document-picker';
+export type { IDocumentPickerAsset, IDocumentPickerCanceledResult, IDocumentPickerOptions, IDocumentPickerResult, IDocumentPickerSuccessResult, } from './types';

package/build/core/index.js

@@ -0,0 +1 @@
+export { getDocumentAsync } from './document-picker.js';

package/build/core/native-module.d.ts

@@ -0,0 +1,5 @@
+import type { IDocumentPickerOptions, IDocumentPickerResult } from './types';
+export type INativeDocumentPickerModule = {
+    getDocumentAsync(options: IDocumentPickerOptions): Promise<IDocumentPickerResult>;
+};
+export declare const expoDocumentPicker: INativeDocumentPickerModule;

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_DOCUMENT_PICKER_MODULE_NAME = 'ExpoDocumentPicker';
+export const expoDocumentPicker = requireNativeModule(EXPO_DOCUMENT_PICKER_MODULE_NAME);

package/build/core/types.d.ts

@@ -0,0 +1,24 @@
+export type IDocumentPickerOptions = {
+    /** MIME type(s) to allow, wildcards included (`'image/*'`). Default: any type. */
+    type?: string | string[];
+    /** Copy the picked file into the app's cache dir. iOS + Android. Default `true`. */
+    copyToCacheDirectory?: boolean;
+    /** Allow multiple files. Default `false`. */
+    multiple?: boolean;
+};
+export type IDocumentPickerAsset = {
+    name: string;
+    size?: number;
+    uri: string;
+    mimeType?: string;
+    lastModified: number;
+};
+export type IDocumentPickerSuccessResult = {
+    canceled: false;
+    assets: IDocumentPickerAsset[];
+};
+export type IDocumentPickerCanceledResult = {
+    canceled: true;
+    assets: null;
+};
+export type IDocumentPickerResult = IDocumentPickerSuccessResult | IDocumentPickerCanceledResult;

package/build/core/types.js

@@ -0,0 +1 @@
+export {};

package/build-ngc/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,3 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,cAAc,SAAS,CAAC"}

package/build-ngc/core/document-picker.d.ts

@@ -0,0 +1,3 @@
+import type { IDocumentPickerOptions, IDocumentPickerResult } from './types';
+/** Opens the system UI for picking one or more documents. */
+export declare function getDocumentAsync(options?: IDocumentPickerOptions): Promise<IDocumentPickerResult>;

package/build-ngc/core/document-picker.js

@@ -0,0 +1,11 @@
+import { expoDocumentPicker } from './native-module';
+/** Opens the system UI for picking one or more documents. */
+export async function getDocumentAsync(options = {}) {
+    const { type = '*/*', copyToCacheDirectory = true, multiple = false, } = options;
+    return await expoDocumentPicker.getDocumentAsync({
+        type: typeof type === 'string' ? [type] : type,
+        copyToCacheDirectory,
+        multiple,
+    });
+}
+//# sourceMappingURL=document-picker.js.map

package/build-ngc/core/document-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-picker.js","sourceRoot":"","sources":["../../src/core/document-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkC,EAAE;IAEpC,MAAM,EACJ,IAAI,GAAG,KAAK,EACZ,oBAAoB,GAAG,IAAI,EAC3B,QAAQ,GAAG,KAAK,GACjB,GAAG,OAAO,CAAC;IACZ,OAAO,MAAM,kBAAkB,CAAC,gBAAgB,CAAC;QAC/C,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9C,oBAAoB;QACpB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/build-ngc/core/index.d.ts

@@ -0,0 +1,2 @@
+export { getDocumentAsync } from './document-picker';
+export type { IDocumentPickerAsset, IDocumentPickerCanceledResult, IDocumentPickerOptions, IDocumentPickerResult, IDocumentPickerSuccessResult, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,2 @@
+export { getDocumentAsync } from './document-picker';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,5 @@
+import type { IDocumentPickerOptions, IDocumentPickerResult } from './types';
+export type INativeDocumentPickerModule = {
+    getDocumentAsync(options: IDocumentPickerOptions): Promise<IDocumentPickerResult>;
+};
+export declare const expoDocumentPicker: INativeDocumentPickerModule;

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_DOCUMENT_PICKER_MODULE_NAME = 'ExpoDocumentPicker';
+export const expoDocumentPicker = requireNativeModule(EXPO_DOCUMENT_PICKER_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,gCAAgC,GAAG,oBAAoB,CAAC;AAQ9D,MAAM,CAAC,MAAM,kBAAkB,GAC7B,mBAAmB,CACjB,gCAAgC,CACjC,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,24 @@
+export type IDocumentPickerOptions = {
+    /** MIME type(s) to allow, wildcards included (`'image/*'`). Default: any type. */
+    type?: string | string[];
+    /** Copy the picked file into the app's cache dir. iOS + Android. Default `true`. */
+    copyToCacheDirectory?: boolean;
+    /** Allow multiple files. Default `false`. */
+    multiple?: boolean;
+};
+export type IDocumentPickerAsset = {
+    name: string;
+    size?: number;
+    uri: string;
+    mimeType?: string;
+    lastModified: number;
+};
+export type IDocumentPickerSuccessResult = {
+    canceled: false;
+    assets: IDocumentPickerAsset[];
+};
+export type IDocumentPickerCanceledResult = {
+    canceled: true;
+    assets: null;
+};
+export type IDocumentPickerResult = IDocumentPickerSuccessResult | IDocumentPickerCanceledResult;

package/build-ngc/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-document-picker",
+    "modules": [
+      {
+        "importPath": "expo.modules.documentpicker.DocumentPickerModule",
+        "className": "DocumentPickerModule",
+        "nativeName": "ExpoDocumentPicker"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@symbiote-native/document-picker",
+  "version": "0.1.0",
+  "description": "expo-document-picker wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Opens the system UI for picking a document from any provider installed on the device.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-document-picker",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "document-picker",
+    "file-picker"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/document-picker"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/document-picker#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./react": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./svelte": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./solid": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-document-picker": "57.0.2",
+    "expo-modules-core": "57.0.20"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/angular": "^3.1.3",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/svelte": "^3.0.5",
+    "@symbiote-native/solid": "^3.0.5",
+    "@symbiote-native/vue": "^3.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/solid": "3.0.5",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/test-utils": "0.4.5",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/vue": "3.1.0",
+    "@symbiote-native/svelte": "3.0.5"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core';

package/src/core/document-picker.ts

@@ -0,0 +1,18 @@
+import { expoDocumentPicker } from './native-module';
+import type { IDocumentPickerOptions, IDocumentPickerResult } from './types';
+
+/** Opens the system UI for picking one or more documents. */
+export async function getDocumentAsync(
+  options: IDocumentPickerOptions = {},
+): Promise<IDocumentPickerResult> {
+  const {
+    type = '*/*',
+    copyToCacheDirectory = true,
+    multiple = false,
+  } = options;
+  return await expoDocumentPicker.getDocumentAsync({
+    type: typeof type === 'string' ? [type] : type,
+    copyToCacheDirectory,
+    multiple,
+  });
+}

package/src/core/index.ts

@@ -0,0 +1,8 @@
+export { getDocumentAsync } from './document-picker';
+export type {
+  IDocumentPickerAsset,
+  IDocumentPickerCanceledResult,
+  IDocumentPickerOptions,
+  IDocumentPickerResult,
+  IDocumentPickerSuccessResult,
+} from './types';

package/src/core/native-module.ts

@@ -0,0 +1,15 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type { IDocumentPickerOptions, IDocumentPickerResult } from './types';
+
+const EXPO_DOCUMENT_PICKER_MODULE_NAME = 'ExpoDocumentPicker';
+
+export type INativeDocumentPickerModule = {
+  getDocumentAsync(
+    options: IDocumentPickerOptions,
+  ): Promise<IDocumentPickerResult>;
+};
+
+export const expoDocumentPicker =
+  requireNativeModule<INativeDocumentPickerModule>(
+    EXPO_DOCUMENT_PICKER_MODULE_NAME,
+  );

package/src/core/types.ts

@@ -0,0 +1,29 @@
+export type IDocumentPickerOptions = {
+  /** MIME type(s) to allow, wildcards included (`'image/*'`). Default: any type. */
+  type?: string | string[];
+  /** Copy the picked file into the app's cache dir. iOS + Android. Default `true`. */
+  copyToCacheDirectory?: boolean;
+  /** Allow multiple files. Default `false`. */
+  multiple?: boolean;
+};
+
+export type IDocumentPickerAsset = {
+  name: string;
+  size?: number;
+  uri: string;
+  mimeType?: string;
+  lastModified: number;
+};
+
+export type IDocumentPickerSuccessResult = {
+  canceled: false;
+  assets: IDocumentPickerAsset[];
+};
+
+export type IDocumentPickerCanceledResult = {
+  canceled: true;
+  assets: null;
+};
+
+export type IDocumentPickerResult =
+  IDocumentPickerSuccessResult | IDocumentPickerCanceledResult;