@capgo/capacitor-file-picker 8.0.0

package/CapgoCapacitorFilePicker.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapgoCapacitorFilePicker'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapgoCapacitorFilePicker",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapgoCapacitorFilePicker",
+            targets: ["CapgoFilePickerPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "CapgoFilePickerPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/CapgoFilePickerPlugin"),
+        .testTarget(
+            name: "CapgoFilePickerPluginTests",
+            dependencies: ["CapgoFilePickerPlugin"],
+            path: "ios/Tests/CapgoFilePickerPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,403 @@
+# @capgo/capacitor-file-picker
+ <a href="https://capgo.app/"><img src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/></a>
+
+<div align="center">
+  <h2><a href="https://capgo.app/?ref=plugin_file_picker"> ➡️ Get Instant updates for your App with Capgo</a></h2>
+  <h2><a href="https://capgo.app/consulting/?ref=plugin_file_picker"> Missing a feature? We'll build the plugin for you 💪</a></h2>
+</div>
+
+File picker Capacitor plugin - Pick files, images, videos, and directories
+
+## Why Capacitor File Picker?
+
+A comprehensive file picker plugin with **full native support** for iOS and Android:
+
+- **Pick Files** - Select any file type with MIME type filtering
+- **Pick Images** - Native photo library picker with multi-select
+- **Pick Videos** - Native video picker with duration and dimensions
+- **Pick Media** - Combined image and video picker
+- **Pick Directory** - Select folders (Android/iOS)
+- **HEIC to JPEG** - Convert HEIC images to JPEG (iOS only)
+- **Copy Files** - Copy files to new locations
+- **File Metadata** - Get size, dimensions, duration, and more
+
+## Documentation
+
+The most complete doc is available here: https://capgo.app/docs/plugins/file-picker/
+
+## Install
+
+```bash
+npm install @capgo/capacitor-file-picker
+npx cap sync
+```
+
+## Requirements
+
+- iOS: iOS 15.0+
+- Android: API 24+ (Android 7.0+)
+- Web: Modern browsers with File API support
+
+## API
+
+<docgen-index>
+
+* [`pickFiles(...)`](#pickfiles)
+* [`pickImages(...)`](#pickimages)
+* [`pickVideos(...)`](#pickvideos)
+* [`pickMedia(...)`](#pickmedia)
+* [`pickDirectory()`](#pickdirectory)
+* [`convertHeicToJpeg(...)`](#convertheictojpeg)
+* [`copyFile(...)`](#copyfile)
+* [`checkPermissions()`](#checkpermissions)
+* [`requestPermissions()`](#requestpermissions)
+* [`addListener('pickerDismissed', ...)`](#addlistenerpickerdismissed-)
+* [`removeAllListeners()`](#removealllisteners)
+* [`getPluginVersion()`](#getpluginversion)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+Capacitor File Picker Plugin interface for selecting files, images, videos, and directories.
+
+### pickFiles(...)
+
+```typescript
+pickFiles(options?: PickFilesOptions | undefined) => Promise<PickFilesResult>
+```
+
+Pick one or more files from the device.
+
+| Param         | Type                                                          | Description                 |
+| ------------- | ------------------------------------------------------------- | --------------------------- |
+| **`options`** | <code><a href="#pickfilesoptions">PickFilesOptions</a></code> | - Options for picking files |
+
+**Returns:** <code>Promise&lt;<a href="#pickfilesresult">PickFilesResult</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### pickImages(...)
+
+```typescript
+pickImages(options?: PickMediaOptions | undefined) => Promise<PickFilesResult>
+```
+
+Pick one or more images from the gallery.
+Android/iOS only.
+
+| Param         | Type                                                          | Description                  |
+| ------------- | ------------------------------------------------------------- | ---------------------------- |
+| **`options`** | <code><a href="#pickmediaoptions">PickMediaOptions</a></code> | - Options for picking images |
+
+**Returns:** <code>Promise&lt;<a href="#pickfilesresult">PickFilesResult</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### pickVideos(...)
+
+```typescript
+pickVideos(options?: PickMediaOptions | undefined) => Promise<PickFilesResult>
+```
+
+Pick one or more videos from the gallery.
+Android/iOS only.
+
+| Param         | Type                                                          | Description                  |
+| ------------- | ------------------------------------------------------------- | ---------------------------- |
+| **`options`** | <code><a href="#pickmediaoptions">PickMediaOptions</a></code> | - Options for picking videos |
+
+**Returns:** <code>Promise&lt;<a href="#pickfilesresult">PickFilesResult</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### pickMedia(...)
+
+```typescript
+pickMedia(options?: PickMediaOptions | undefined) => Promise<PickFilesResult>
+```
+
+Pick one or more images or videos from the gallery.
+Android/iOS only.
+
+| Param         | Type                                                          | Description                 |
+| ------------- | ------------------------------------------------------------- | --------------------------- |
+| **`options`** | <code><a href="#pickmediaoptions">PickMediaOptions</a></code> | - Options for picking media |
+
+**Returns:** <code>Promise&lt;<a href="#pickfilesresult">PickFilesResult</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### pickDirectory()
+
+```typescript
+pickDirectory() => Promise<PickDirectoryResult>
+```
+
+Pick a directory from the device.
+Android/iOS only.
+
+**Returns:** <code>Promise&lt;<a href="#pickdirectoryresult">PickDirectoryResult</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### convertHeicToJpeg(...)
+
+```typescript
+convertHeicToJpeg(options: ConvertHeicToJpegOptions) => Promise<ConvertHeicToJpegResult>
+```
+
+Convert a HEIC image to JPEG format.
+iOS only.
+
+| Param         | Type                                                                          | Description                  |
+| ------------- | ----------------------------------------------------------------------------- | ---------------------------- |
+| **`options`** | <code><a href="#convertheictojpegoptions">ConvertHeicToJpegOptions</a></code> | - Options for the conversion |
+
+**Returns:** <code>Promise&lt;<a href="#convertheictojpegresult">ConvertHeicToJpegResult</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### copyFile(...)
+
+```typescript
+copyFile(options: CopyFileOptions) => Promise<void>
+```
+
+Copy a file to a new location.
+
+| Param         | Type                                                        | Description                    |
+| ------------- | ----------------------------------------------------------- | ------------------------------ |
+| **`options`** | <code><a href="#copyfileoptions">CopyFileOptions</a></code> | - Options for copying the file |
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### checkPermissions()
+
+```typescript
+checkPermissions() => Promise<PermissionStatus>
+```
+
+Check permissions for reading files.
+Android only.
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### requestPermissions()
+
+```typescript
+requestPermissions() => Promise<PermissionStatus>
+```
+
+Request permissions for reading files.
+Android only.
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### addListener('pickerDismissed', ...)
+
+```typescript
+addListener(eventName: 'pickerDismissed', listenerFunc: PickerDismissedListener) => Promise<PluginListenerHandle>
+```
+
+Add a listener for the picker dismissed event.
+iOS only.
+
+| Param              | Type                                                                        | Description             |
+| ------------------ | --------------------------------------------------------------------------- | ----------------------- |
+| **`eventName`**    | <code>'pickerDismissed'</code>                                              | - The event name        |
+| **`listenerFunc`** | <code><a href="#pickerdismissedlistener">PickerDismissedListener</a></code> | - The listener function |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### removeAllListeners()
+
+```typescript
+removeAllListeners() => Promise<void>
+```
+
+Remove all listeners for this plugin.
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### getPluginVersion()
+
+```typescript
+getPluginVersion() => Promise<{ version: string; }>
+```
+
+Get the native Capacitor plugin version.
+
+**Returns:** <code>Promise&lt;{ version: string; }&gt;</code>
+
+**Since:** 8.0.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### PickFilesResult
+
+Result of picking files.
+
+| Prop        | Type                      | Description           |
+| ----------- | ------------------------- | --------------------- |
+| **`files`** | <code>PickedFile[]</code> | Array of picked files |
+
+
+#### PickedFile
+
+Represents a picked file.
+
+| Prop             | Type                | Description                                                             |
+| ---------------- | ------------------- | ----------------------------------------------------------------------- |
+| **`name`**       | <code>string</code> | The name of the file                                                    |
+| **`path`**       | <code>string</code> | The path to the file                                                    |
+| **`mimeType`**   | <code>string</code> | The MIME type of the file                                               |
+| **`size`**       | <code>number</code> | The size of the file in bytes                                           |
+| **`data`**       | <code>string</code> | The base64 encoded data of the file. Only present if readData was true. |
+| **`blob`**       | <code>Blob</code>   | The Blob instance of the file. Web only.                                |
+| **`width`**      | <code>number</code> | Width in pixels (images/videos only)                                    |
+| **`height`**     | <code>number</code> | Height in pixels (images/videos only)                                   |
+| **`duration`**   | <code>number</code> | Duration in seconds (videos only)                                       |
+| **`modifiedAt`** | <code>number</code> | Last modified timestamp in milliseconds                                 |
+
+
+#### PickFilesOptions
+
+Options for picking files.
+
+| Prop           | Type                  | Description                                                                                                                                         | Default            |
+| -------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
+| **`types`**    | <code>string[]</code> | List of accepted MIME types or file extensions. On iOS, only MIME types are supported. Examples: ['image/*'], ['application/pdf'], ['.pdf', '.doc'] |                    |
+| **`limit`**    | <code>number</code>   | Maximum number of files to pick. Set to 0 for unlimited (platform default).                                                                         | <code>0</code>     |
+| **`readData`** | <code>boolean</code>  | Whether to read the file data as base64. Note: Reading large files may cause memory issues.                                                         | <code>false</code> |
+
+
+#### PickMediaOptions
+
+Options for picking media (images/videos).
+
+| Prop                  | Type                 | Description                                                                                 | Default            |
+| --------------------- | -------------------- | ------------------------------------------------------------------------------------------- | ------------------ |
+| **`limit`**           | <code>number</code>  | Maximum number of files to pick. Set to 0 for unlimited (platform default).                 | <code>0</code>     |
+| **`readData`**        | <code>boolean</code> | Whether to read the file data as base64. Note: Reading large files may cause memory issues. | <code>false</code> |
+| **`skipTranscoding`** | <code>boolean</code> | iOS only: Skip transcoding of videos.                                                       | <code>false</code> |
+| **`ordered`**         | <code>boolean</code> | iOS 15+ only: Show ordered selection badges.                                                | <code>false</code> |
+
+
+#### PickDirectoryResult
+
+Result of picking a directory.
+
+| Prop       | Type                | Description                        |
+| ---------- | ------------------- | ---------------------------------- |
+| **`path`** | <code>string</code> | The path to the selected directory |
+
+
+#### ConvertHeicToJpegResult
+
+Result of HEIC to JPEG conversion.
+
+| Prop       | Type                | Description                         |
+| ---------- | ------------------- | ----------------------------------- |
+| **`path`** | <code>string</code> | The path to the converted JPEG file |
+
+
+#### ConvertHeicToJpegOptions
+
+Options for converting HEIC to JPEG.
+
+| Prop          | Type                | Description                                   | Default          |
+| ------------- | ------------------- | --------------------------------------------- | ---------------- |
+| **`path`**    | <code>string</code> | The path to the HEIC file to convert          |                  |
+| **`quality`** | <code>number</code> | The compression quality for JPEG (0.0 - 1.0). | <code>0.9</code> |
+
+
+#### CopyFileOptions
+
+Options for copying a file.
+
+| Prop            | Type                 | Description                                 | Default            |
+| --------------- | -------------------- | ------------------------------------------- | ------------------ |
+| **`from`**      | <code>string</code>  | Source file path                            |                    |
+| **`to`**        | <code>string</code>  | Destination file path                       |                    |
+| **`overwrite`** | <code>boolean</code> | Whether to overwrite if destination exists. | <code>false</code> |
+
+
+#### PermissionStatus
+
+Permission status for file access.
+
+| Prop                      | Type                                                        | Description                                            |
+| ------------------------- | ----------------------------------------------------------- | ------------------------------------------------------ |
+| **`readExternalStorage`** | <code><a href="#permissionstate">PermissionState</a></code> | Whether permission to read media files is granted      |
+| **`accessMediaLocation`** | <code><a href="#permissionstate">PermissionState</a></code> | Whether permission to access media location is granted |
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
+### Type Aliases
+
+
+#### PermissionState
+
+<code>'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'</code>
+
+
+#### PickerDismissedListener
+
+Listener callback for picker dismissed event.
+
+<code>(event: null): void</code>
+
+</docgen-api>

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "app.capgo.capacitor.filepicker"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>