@react-native-documents/picker 9.3.1

package/lib/typescript/keepLocalCopy.d.ts

@@ -0,0 +1,46 @@
+import type { NonEmptyArray } from './types';
+import { type LocalCopyResponse } from './spec/NativeDocumentPicker';
+/**
+ * Parameter of {@link keepLocalCopy}. Object type representing the file(s) whose copy should be kept in the app's storage.
+ * */
+export type FileToCopy = {
+    /**
+     * The uri to keep a local copy of. This would be a `content://` uri (Android), or a `file://` uri (iOS) that the user has previously picked.
+     * */
+    uri: string;
+    /**
+     * The name of the resulting file, with the file extension. You can use the `name` field from the response of the `pick()` method.
+     *
+     * Example: someFile.pdf
+     *
+     * */
+    fileName: string;
+    /**
+     * Only for Android virtual files: the type of the file to export to. For example, `application/pdf` or `text/plain`.
+     * Use one of the values from `convertibleToMimeTypes` from the response of the `pick()` method: {@link DocumentPickerResponse}.
+     * */
+    convertVirtualFileToType?: string;
+};
+/**
+ * options for {@link keepLocalCopy}
+ *
+ * */
+export type KeepLocalCopyOptions = {
+    files: NonEmptyArray<FileToCopy>;
+    destination: 'cachesDirectory' | 'documentDirectory';
+};
+/**
+ * Result of the call to {@link keepLocalCopy}. Please note the promise always resolves, even if there was an error processing any uri(s) (as indicated by the `status` field, and `copyError` field).
+ * */
+export type KeepLocalCopyResponse = NonEmptyArray<LocalCopyResponse>;
+/**
+ * Makes the file available in the app's storage. The behavior is different on iOS and Android, and for simple use cases (such as uploading file to remote server), you may not need to call this method at all.
+ *
+ * On Android, it can be used to "convert" a `content://` Uri into a local file. It also "exports" virtual files (such as Google docs or sheets) into local files.
+ *
+ * However, note that for some use cases, such as uploading the picked file to a server, you may not need to call `keepLocalCopy` at all. React Native's `fetch` can handle `content://` uris.
+ *
+ * @group DocumentPicker
+ * */
+export declare function keepLocalCopy(options: KeepLocalCopyOptions): Promise<KeepLocalCopyResponse>;
+//# sourceMappingURL=keepLocalCopy.d.ts.map

package/lib/typescript/keepLocalCopy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keepLocalCopy.d.ts","sourceRoot":"","sources":["../../src/keepLocalCopy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,6BAA6B,CAAA;AAE1F;;KAEK;AACL,MAAM,MAAM,UAAU,GAAG;IACvB;;SAEK;IACL,GAAG,EAAE,MAAM,CAAA;IACX;;;;;SAKK;IACL,QAAQ,EAAE,MAAM,CAAA;IAChB;;;SAGK;IACL,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC,CAAA;AACD;;;KAGK;AACL,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IAChC,WAAW,EAAE,iBAAiB,GAAG,mBAAmB,CAAA;CACrD,CAAA;AAED;;KAEK;AACL,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAA;AAEpE;;;;;;;;KAQK;AACL,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAG3F"}

package/lib/typescript/pick.d.ts

@@ -0,0 +1,84 @@
+import { PredefinedFileTypes } from './fileTypes';
+import type { BookmarkingResponse, DocumentPickerResponse, NonEmptyArray, TransitionStyle, PresentationStyle } from './types';
+/**
+ * Base options object for the document picker.
+ * You'd rarely use this type directly, but instead use one of
+ *
+ * {@link DocumentPickerOptionsImport}, {@link DocumentPickerOptionsOpenOnce} or {@link DocumentPickerOptionsOpenLongTerm}
+ *
+ * which extend this type
+ * @group pick() types
+ */
+export type DocumentPickerOptionsBase = {
+    /**
+     * Specify file type(s) that you want to pick. Use `types` for some predefined values.
+     * */
+    type?: string | PredefinedFileTypes | Array<PredefinedFileTypes | string>;
+    /**
+     * Whether to allow multiple files to be picked. False by default.
+     * */
+    allowMultiSelection?: boolean;
+    /**
+     * Android only - Whether to allow virtual files (such as Google docs or sheets) to be picked. False by default.
+     * */
+    allowVirtualFiles?: boolean;
+    /**
+     * iOS only - Controls how the picker is presented, e.g. on an iPad you may want to present it fullscreen. Defaults to `pageSheet`.
+     * */
+    presentationStyle?: PresentationStyle;
+    /**
+     * iOS only - Configures the transition style of the picker. Defaults to coverVertical, when the picker is presented, its view slides up from the bottom of the screen.
+     * */
+    transitionStyle?: TransitionStyle;
+};
+/**
+ * Present the document picker in import mode.
+ *
+ * @group pick() types
+ */
+export type DocumentPickerOptionsImport = DocumentPickerOptionsBase & {
+    mode?: 'import';
+    requestLongTermAccess?: never;
+};
+/**
+ * Present the document picker in open mode, with permissions to access the file for a limited time (until the app terminates).
+ *
+ * @group pick() types
+ */
+export type DocumentPickerOptionsOpenOnce = DocumentPickerOptionsBase & {
+    mode: 'open';
+    requestLongTermAccess?: false;
+};
+/**
+ * Present the document picker in open mode, with long-term permissions to access the opened file.
+ *
+ * @group pick() types
+ */
+export type DocumentPickerOptionsOpenLongTerm = DocumentPickerOptionsBase & {
+    mode: 'open';
+    requestLongTermAccess: true;
+};
+type DocumentPickerOptionsOpen = DocumentPickerOptionsOpenOnce | DocumentPickerOptionsOpenLongTerm;
+/**
+ * @hidden
+ */
+export type DocumentPickerOptions = DocumentPickerOptionsImport | DocumentPickerOptionsOpen;
+/**
+ * The result of calling {@link pick} with `mode: 'open'` and `requestLongTermAccess: true`
+ *
+ * @group pick() types
+ */
+export type DocumentPickerResponseOpenLongTerm = DocumentPickerResponse & BookmarkingResponse;
+type PickResponse<O extends DocumentPickerOptions> = Promise<O extends DocumentPickerOptionsOpenLongTerm ? NonEmptyArray<DocumentPickerResponseOpenLongTerm> : NonEmptyArray<DocumentPickerResponse>>;
+/**
+ * The method for picking a file, both for `import` and `open` modes.
+ *
+ * For result types, see {@link DocumentPickerResponse} or {@link DocumentPickerResponseOpenLongTerm}.
+ *
+ * For options, see {@link DocumentPickerOptionsImport}, {@link DocumentPickerOptionsOpenOnce} or {@link DocumentPickerOptionsOpenLongTerm}.
+ *
+ * @group DocumentPicker
+ * */
+export declare function pick<O extends DocumentPickerOptions>(options?: O): PickResponse<O>;
+export {};
+//# sourceMappingURL=pick.d.ts.map

package/lib/typescript/pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../src/pick.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAS,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,SAAS,CAAA;AAIhB;;;;;;;;GAQG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;SAEK;IACL,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,GAAG,MAAM,CAAC,CAAA;IAMzE;;SAEK;IACL,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAI7B;;SAEK;IACL,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;SAEK;IACL,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC;;SAEK;IACL,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,yBAAyB,GAAG;IACpE,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,qBAAqB,CAAC,EAAE,KAAK,CAAA;CAC9B,CAAA;AACD;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,GAAG;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB,CAAC,EAAE,KAAK,CAAA;CAC9B,CAAA;AACD;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG,yBAAyB,GAAG;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB,EAAE,IAAI,CAAA;CAC5B,CAAA;AAED,KAAK,yBAAyB,GAAG,6BAA6B,GAAG,iCAAiC,CAAA;AAClG;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,GAAG,yBAAyB,CAAA;AAE3F;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAAG,sBAAsB,GAAG,mBAAmB,CAAA;AAG7F,KAAK,YAAY,CAAC,CAAC,SAAS,qBAAqB,IAAI,OAAO,CAC1D,CAAC,SAAS,iCAAiC,GACvC,aAAa,CAAC,kCAAkC,CAAC,GACjD,aAAa,CAAC,sBAAsB,CAAC,CAC1C,CAAA;AAID;;;;;;;;KAQK;AACL,wBAAsB,IAAI,CAAC,CAAC,SAAS,qBAAqB,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAsCxF"}

package/lib/typescript/pickDirectory.d.ts

@@ -0,0 +1,62 @@
+import { BookmarkingResponse, PresentationStyle, type TransitionStyle } from './types';
+/**
+ * Base options object for the directory picker. They only slightly influence the appearance of the picker modal on iOS.
+ * You'd rarely use this type directly, but instead use {@link DirectoryPickerOptions}
+ *
+ * which extend this type
+ * @group pickDirectory() types
+ */
+export type DirectoryPickerOptionsBase = {
+    /**
+     * iOS only - Controls how the picker is presented, e.g. on an iPad you may want to present it fullscreen. Defaults to `pageSheet`.
+     * */
+    presentationStyle?: PresentationStyle;
+    /**
+     * iOS only - Configures the transition style of the picker. Defaults to coverVertical, when the picker is presented, its view slides up from the bottom of the screen.
+     * */
+    transitionStyle?: TransitionStyle;
+};
+/**
+ * @hidden
+ * */
+export type DirectoryPickerOptionsLongTerm = DirectoryPickerOptionsBase & {
+    requestLongTermAccess: true;
+};
+/**
+ * Options for {@link pickDirectory}.
+ *
+ * @group pickDirectory() types
+ * */
+export type DirectoryPickerOptions = DirectoryPickerOptionsBase & {
+    requestLongTermAccess: boolean;
+};
+/**
+ * This object represents the response from the directory picker, when long-term access was not requested.
+ *
+ * @group pickDirectory() types
+ * */
+export type DirectoryPickerResponse = {
+    /**
+     * The (percent-encoded) directory selected by user.
+     * */
+    uri: string;
+};
+/**
+ * This object represents the response from the directory picker, when long-term access was requested.
+ *
+ * @group pickDirectory() types
+ * */
+export type DirectoryPickerResponseLongTerm = DirectoryPickerResponse & BookmarkingResponse;
+/**
+ * You likely won't use this type directly, but instead use {@link DirectoryPickerResponse} or {@link DirectoryPickerResponseLongTerm}.
+ *
+ * @group pickDirectory() types
+ * */
+export type PickDirectoryResponse<O extends DirectoryPickerOptions> = Promise<O extends DirectoryPickerOptionsLongTerm ? DirectoryPickerResponseLongTerm : DirectoryPickerResponse>;
+/**
+ * Opens a directory picker.
+ *
+ * @group DocumentPicker
+ * */
+export declare function pickDirectory<O extends DirectoryPickerOptions>(options?: O): PickDirectoryResponse<O>;
+//# sourceMappingURL=pickDirectory.d.ts.map

package/lib/typescript/pickDirectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickDirectory.d.ts","sourceRoot":"","sources":["../../src/pickDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAItF;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;SAEK;IACL,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC;;SAEK;IACL,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAA;AACD;;KAEK;AACL,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,GAAG;IACxE,qBAAqB,EAAE,IAAI,CAAA;CAC5B,CAAA;AACD;;;;KAIK;AACL,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,GAAG;IAAE,qBAAqB,EAAE,OAAO,CAAA;CAAE,CAAA;AAEpG;;;;KAIK;AACL,MAAM,MAAM,uBAAuB,GAAG;IACpC;;SAEK;IACL,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AACD;;;;KAIK;AACL,MAAM,MAAM,+BAA+B,GAAG,uBAAuB,GAAG,mBAAmB,CAAA;AAG3F;;;;KAIK;AACL,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,sBAAsB,IAAI,OAAO,CAC3E,CAAC,SAAS,8BAA8B,GACpC,+BAA+B,GAC/B,uBAAuB,CAC5B,CAAA;AAED;;;;KAIK;AACL,wBAAsB,aAAa,CAAC,CAAC,SAAS,sBAAsB,EAClE,OAAO,CAAC,EAAE,CAAC,GACV,qBAAqB,CAAC,CAAC,CAAC,CAqB1B"}

package/lib/typescript/release.d.ts

@@ -0,0 +1,24 @@
+/**
+ * For each uri whose release was requested, the result will contain an object with the uri and a status.
+ * */
+export type ReleaseLongTermAccessResult = Array<{
+    uri: string;
+    status: 'success';
+} | {
+    uri: string;
+    status: 'error';
+    errorMessage: string;
+}>;
+/**
+ * Android only - Releases long-term access to the given URIs. There's no need to call this method on iOS - there's no iOS equivalent.
+ *
+ * See [Android documentation](https://developer.android.com/reference/android/content/ContentResolver#releasePersistableUriPermission(android.net.Uri,%20int)) for more information.
+ */
+export declare const releaseLongTermAccess: (uris: string[]) => Promise<ReleaseLongTermAccessResult>;
+/**
+ * iOS only - Releases (stops) secure access to the given URIs. Use with URIs obtained with Open mode or with the Directory Picker.
+ * See [iOS documentation](https://developer.apple.com/documentation/foundation/nsurl/1413736-stopaccessingsecurityscopedresou) for more information.
+ * There's no need to call this method on Android - there's no equivalent method on Android.
+ * */
+export declare const releaseSecureAccess: (uris: string[]) => Promise<null>;
+//# sourceMappingURL=release.d.ts.map

package/lib/typescript/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/release.ts"],"names":[],"mappings":"AAEA;;KAEK;AACL,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAC3C;IACE,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,SAAS,CAAA;CAClB,GACD;IACE,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB,CACJ,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,SAC1B,MAAM,EAAE,KACb,OAAO,CAAC,2BAA2B,CAErC,CAAA;AAED;;;;KAIK;AACL,eAAO,MAAM,mBAAmB,SAAgB,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAEtE,CAAA"}

package/lib/typescript/saveDocuments.d.ts

@@ -0,0 +1,55 @@
+import type { NonEmptyArray } from './types';
+/**
+ * Options object for the {@link saveDocuments} method. `sourceUris` is the only required field.
+ *
+ * @group saveDocuments() types
+ */
+export type SaveDocumentsOptions = {
+    /**
+     * The source URIs of the files to save, percentage-encoded. Android only allows to save one file at a time, iOS allows multiple.
+     * */
+    sourceUris: string[];
+    /**
+     * Android-only: The MIME type of the file to be stored.
+     * It is recommended to provide this value, otherwise the system will try to infer it from the sourceUri using ContentResolver.
+     * */
+    mimeType?: string;
+    /**
+     * Android-only: The suggested title of the file to be stored, which will be pre-filled in the UI.
+     * On iOS, the target name is taken from the source uri, and is changeable only when exactly one file is being saved.
+     * */
+    fileName?: string;
+    /**
+     * iOS-only: Whether to copy the file to a new location, or move it (default).
+     * On Android, file is always copied.
+     * */
+    copy?: boolean;
+};
+/**
+ * The result of calling {@link saveDocuments}. It is very unlikely that the metadata fields would be `null`, but in theory, it can happen.
+ *
+ * @group saveDocuments() types
+ */
+export type SaveDocumentsResponse = {
+    /**
+     * The target URI - the one user saved to. This is a percent-encoded `content://` uri (Android), or a `file://` uri (iOS).
+     * */
+    uri: string;
+    /**
+     * The name of the file that user entered, including extension.
+     * */
+    name: string | null;
+    /**
+     * Error in case the file could not be written or some metadata could not be obtained.
+     * */
+    error: string | null;
+};
+/**
+ * The method for opening a "save as" dialog and saving source file(s) to a new location.
+ *
+ * On Android, only one file can be saved at a time.
+ *
+ * @group DocumentPicker
+ * */
+export declare function saveDocuments(options: SaveDocumentsOptions): Promise<NonEmptyArray<SaveDocumentsResponse>>;
+//# sourceMappingURL=saveDocuments.d.ts.map

package/lib/typescript/saveDocuments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveDocuments.d.ts","sourceRoot":"","sources":["../../src/saveDocuments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA0B,aAAa,EAAE,MAAM,SAAS,CAAA;AAGpE;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;SAEK;IACL,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB;;;SAGK;IACL,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;SAGK;IACL,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;SAGK;IACL,IAAI,CAAC,EAAE,OAAO,CAAA;CAEf,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;SAEK;IACL,GAAG,EAAE,MAAM,CAAA;IACX;;SAEK;IACL,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB;;SAEK;IACL,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAQrB,CAAA;AAED;;;;;;KAMK;AACL,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC,CAmB/C"}

package/lib/typescript/spec/NativeDocumentPicker.d.ts

@@ -0,0 +1,29 @@
+import type { TurboModule } from 'react-native';
+import { DocumentPickerResponse } from '../types';
+/**
+ * Indicates, for each Uri that was passed to {@link keepLocalCopy}, whether the local copy was successfully created or not.
+ *
+ * If the copy was successful, the status field is `success` and `localUri` contains the local Uri.
+ * If the copy was not successful, the status field is `error` and `copyError` field contains the error message.
+ * */
+export type LocalCopyResponse = {
+    status: 'success';
+    sourceUri: string;
+    localUri: string;
+} | {
+    status: 'error';
+    sourceUri: string;
+    copyError: string;
+};
+export interface Spec extends TurboModule {
+    pick(options: Object): Promise<DocumentPickerResponse[]>;
+    saveDocument(options: Object): Promise<Object>;
+    writeDocuments(options: Object): Promise<Object[]>;
+    pickDirectory(options: Object): Promise<Object>;
+    keepLocalCopy(options: Object): Promise<LocalCopyResponse[]>;
+    isKnownType(kind: string, value: string): Object;
+    releaseSecureAccess(uris: string[]): Promise<null>;
+    releaseLongTermAccess(uris: string[]): Promise<Object>;
+}
+export declare const NativeDocumentPicker: Spec;
+//# sourceMappingURL=NativeDocumentPicker.d.ts.map

package/lib/typescript/spec/NativeDocumentPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeDocumentPicker.d.ts","sourceRoot":"","sources":["../../../src/spec/NativeDocumentPicker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEjD;;;;;KAKK;AACL,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,SAAS,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB,GACD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7D,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAA;IACxD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAClD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAC5D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAChD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvD;AAED,eAAO,MAAM,oBAAoB,MAA6D,CAAA"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,95 @@
+export type NonEmptyArray<T> = [T, ...Array<T>];
+import type { ModalPropsIOS } from 'react-native';
+/**
+ * If you've requested long-term access to a directory or file, this object will be returned in the response.
+ * In order to access the same directory or file in the future, you must store the `bookmark` opaque string,
+ * and then pass it to the document viewer if you want to preview the file.
+ *
+ * See the Document viewer source on how to retrieve the file from the bookmark, if you need to do that (advanced use case).
+ * */
+export type BookmarkingResponse = {
+    bookmarkStatus: 'success';
+    bookmark: string;
+} | {
+    bookmarkStatus: 'error';
+    bookmarkError: string;
+};
+/**
+ * @group pick() types
+ */
+export type VirtualFileMeta = {
+    /**
+     * The registered extension for the given MIME type. Note that some MIME types map to multiple extensions.
+     *
+     * This call will return the most common extension for the given MIME type.
+     *
+     * Example: `pdf`
+     */
+    extension: string | null;
+    /**
+     * The MIME type of the file. This is necessary to export the virtual file to a local file.
+     *
+     * Example: `application/pdf`
+     */
+    mimeType: string;
+};
+/**
+ * @group pick() types
+ */
+export type DocumentPickerResponse = {
+    /**
+     * The URI of the picked file. This is a percent-encoded `content://` uri (Android), or a `file://` uri (iOS).
+     * */
+    uri: string;
+    /**
+     * The name of the picked file, including the extension. It's very unlikely that it'd be `null` but in theory, it can happen.
+     * */
+    name: string | null;
+    /**
+     * Error in case the file metadata could not be obtained.
+     * */
+    error: string | null;
+    /**
+     * The MIME type of the picked file.
+     * */
+    type: string | null;
+    /**
+     * The "native" type of the picked file: on Android, this is the MIME type. On iOS, it is the UTType identifier.
+     * */
+    nativeType: string | null;
+    /**
+     * The size of the picked file in bytes.
+     * */
+    size: number | null;
+    /**
+     * Android: whether the file is a virtual file (such as Google docs or sheets). Will be `null` on pre-Android 7.0 devices. On iOS, it's always `false`.
+     * */
+    isVirtual: boolean | null;
+    /**
+     * Android: The target types the virtual file can be converted to. Useful for {@link keepLocalCopy}.
+     * This field is only present if `isVirtual` is true, and only on Android 7.0+. Always `null` on iOS.
+     * */
+    convertibleToMimeTypes: VirtualFileMeta[] | null;
+    /**
+     * Android: Some document providers on Android (especially those popular in Asia, it seems)
+     * do not respect the request for limiting selectable file types.
+     * `hasRequestedType` will be false if the user picked a file that does not have one of the requested types.
+     *
+     * You need to do your own post-processing and display an error to the user if this is important to your app.
+     *
+     * Always `true` on iOS.
+     * */
+    hasRequestedType: boolean;
+};
+/**
+ * iOS only. Configure the transition style of the picker.
+ * */
+export type TransitionStyle = 'coverVertical' | 'flipHorizontal' | 'crossDissolve' | 'partialCurl' | undefined;
+/**
+ * iOS only. Configure the presentation style of the picker.
+ * */
+export type PresentationStyle = 'fullScreen' | 'pageSheet' | 'formSheet' | 'overFullScreen' | undefined;
+type AreUnionsEqual<T, U> = [T] extends [U] ? ([U] extends [T] ? true : false) : false;
+export declare const typesAreEqual: AreUnionsEqual<PresentationStyle, ModalPropsIOS['presentationStyle']>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;;;;;KAMK;AACL,MAAM,MAAM,mBAAmB,GAC3B;IACE,cAAc,EAAE,SAAS,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;CACjB,GACD;IACE,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAEL;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;SAEK;IACL,GAAG,EAAE,MAAM,CAAA;IACX;;SAEK;IACL,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB;;SAEK;IACL,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;SAEK;IACL,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB;;SAEK;IACL,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;SAEK;IACL,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB;;SAEK;IACL,SAAS,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB;;;SAGK;IACL,sBAAsB,EAAE,eAAe,EAAE,GAAG,IAAI,CAAA;IAEhD;;;;;;;;SAQK;IACL,gBAAgB,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;KAEK;AACL,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,SAAS,CAAA;AAEb;;KAEK;AACL,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,SAAS,CAAA;AAMb,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA;AAEtF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,iBAAiB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAC1F,CAAA"}

package/lib/typescript/validateTypes.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentPickerResponse } from './types';
+export declare const safeValidate: (requestedTypes: string[], singlePickResult: Pick<DocumentPickerResponse, "nativeType">) => boolean;
+//# sourceMappingURL=validateTypes.d.ts.map

package/lib/typescript/validateTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateTypes.d.ts","sourceRoot":"","sources":["../../src/validateTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD,eAAO,MAAM,YAAY,mBACP,MAAM,EAAE,oBACN,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,YAI7D,CAAA"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@react-native-documents/picker",
+  "version": "9.3.1",
+  "description": "A react native interface to access documents from dropbox, google drive, iCloud...",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "windows",
+    "cpp",
+    "LICENSE.md",
+    "react-native-document-picker.podspec",
+    "!lib/typescript/example",
+    "!android/build",
+    "!ios/build",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "jest/build"
+  ],
+  "scripts": {
+    "build:mock": "tsc --build jest",
+    "prepare": "bob build && yarn build:mock",
+    "release": "yarn prepare && npx semantic-release"
+  },
+  "codegenConfig": {
+    "name": "rndocumentpickerCGen",
+    "type": "modules",
+    "jsSrcsDir": "src/spec",
+    "android": {
+      "javaPackageName": "com.reactnativedocumentpicker"
+    }
+  },
+  "keywords": [
+    "react-native",
+    "document",
+    "picker",
+    "uidocumentmenuviewcontroller",
+    "dropbox",
+    "google-drive",
+    "icloud"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/react-native-documents/document-picker.git"
+  },
+  "author": "Vojtech Novak (hello@react-native-training.eu)",
+  "license": "see LICENSE file",
+  "bugs": {
+    "url": "https://github.com/react-native-documents/document-picker/issues"
+  },
+  "homepage": "https://github.com/react-native-documents/document-picker#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@tsconfig/node18": "^18.2.4",
+    "react-native-builder-bob": "^0.30.2",
+    "typescript": "^5.6.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/lib/"
+    ]
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "packageManager": "yarn@4.5.1"
+}

package/react-native-document-picker.podspec

@@ -0,0 +1,30 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-document-picker"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => "14.0" }
+  s.source       = { :git => "https://github.com/react-native-documents/sponsors-only.git", :tag => "v#{s.version}" }
+
+  s.source_files = ["ios/**/*.{h,m,mm,swift}"]
+  s.frameworks = 'MobileCoreServices'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
+    # RN 71+
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+  end
+end

package/src/errors.ts

@@ -0,0 +1,49 @@
+export interface NativeModuleError extends Error {
+  code: string
+}
+
+const OPERATION_CANCELED = 'OPERATION_CANCELED'
+const IN_PROGRESS = 'ASYNC_OP_IN_PROGRESS'
+const UNABLE_TO_OPEN_FILE_TYPE = 'UNABLE_TO_OPEN_FILE_TYPE'
+
+/**
+ * Error codes that can be returned by the module, and are available on the `code` property of the error.
+ *
+ * @example
+ * ```ts
+ *   const handleError = (err: unknown) => {
+ *     if (isErrorWithCode(err)) {
+ *       switch (err.code) {
+ *         case errorCodes.IN_PROGRESS:
+ *           ...
+ *           break
+ *         case errorCodes.UNABLE_TO_OPEN_FILE_TYPE:
+ *           ...
+ *           break
+ *         case errorCodes.OPERATION_CANCELED:
+ *           // ignore
+ *           break
+ *         default:
+ *           console.error(err)
+ *       }
+ *     } else {
+ *        console.error(err)
+ *     }
+ *   }
+ * ```
+ * */
+export const errorCodes = Object.freeze({
+  OPERATION_CANCELED,
+  IN_PROGRESS,
+  UNABLE_TO_OPEN_FILE_TYPE,
+})
+
+/**
+ * TypeScript helper to check if an object has the `code` property.
+ * This is used to avoid `as` casting when you access the `code` property on errors returned by the module.
+ */
+export const isErrorWithCode = (error: any): error is NativeModuleError => {
+  // to account for https://github.com/facebook/react-native/issues/41950
+  const isNewArchErrorIOS = typeof error === 'object' && error != null
+  return (error instanceof Error || isNewArchErrorIOS) && 'code' in error
+}