@aalzehla/capacitor-contacts 0.0.1

package/CapacitorContacts.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorContacts'
+  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  = '13.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: "CapacitorContacts",
+    platforms: [.iOS(.v13)],
+    products: [
+        .library(
+            name: "CapacitorContacts",
+            targets: ["CapacitorContactsPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", branch: "main")
+    ],
+    targets: [
+        .target(
+            name: "CapacitorContactsPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/CapacitorContactsPlugin"),
+        .testTarget(
+            name: "CapacitorContactsPluginTests",
+            dependencies: ["CapacitorContactsPlugin"],
+            path: "ios/Tests/CapacitorContactsPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,67 @@
+# capacitor-contacts
+
+This capacitor plugin allows you to use the native contact picker UI on Android or iOS for single contact selection. Both platforms will return the same payload structure, where the data exists.
+
+## Install
+
+```bash
+npm install @aalzehla/capacitor-contacts
+npx cap sync
+```
+
+## API
+
+<docgen-index>
+
+* [`open()`](#open)
+* [`close()`](#close)
+* [Interfaces](#interfaces)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### open()
+
+```typescript
+open() => Promise<Contact[]>
+```
+
+**Returns:** <code>Promise&lt;Contact[]&gt;</code>
+
+--------------------
+
+
+### close()
+
+```typescript
+close() => Promise<void>
+```
+
+--------------------
+
+
+### Interfaces
+
+
+#### Contact
+
+| Prop                          | Type                |
+| ----------------------------- | ------------------- |
+| **`identifier`**              | <code>string</code> |
+| **`androidContactLookupKey`** | <code>string</code> |
+| **`contactId`**               | <code>string</code> |
+| **`givenName`**               | <code>string</code> |
+| **`familyName`**              | <code>string</code> |
+| **`nickname`**                | <code>string</code> |
+| **`fullName`**                | <code>string</code> |
+| **`jobTitle`**                | <code>string</code> |
+| **`departmentName`**          | <code>string</code> |
+| **`organizationName`**        | <code>string</code> |
+| **`note`**                    | <code>string</code> |
+| **`phoneNumbers`**            | <code>any[]</code>  |
+| **`emailAddresses`**          | <code>any[]</code>  |
+| **`postalAddresses`**         | <code>any[]</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.6.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.5'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.5.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.2.1'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "com.aalzehla.capacitor.contacts"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 22
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 34
+        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_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+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>

package/android/src/main/java/com/aalzehla/capacitor/contacts/CapacitorContactsPlugin.java

@@ -0,0 +1,177 @@
+package com.aalzehla.capacitor.contacts;
+
+import android.Manifest;
+import android.content.Intent;
+import android.provider.ContactsContract;
+import android.provider.ContactsContract.CommonDataKinds;
+import android.util.Log;
+
+import androidx.activity.result.ActivityResult;
+
+import com.getcapacitor.JSArray;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.PermissionState;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import com.getcapacitor.annotation.Permission;
+import com.getcapacitor.annotation.PermissionCallback;
+import com.getcapacitor.annotation.ActivityCallback;
+
+import com.aalzehla.capacitor.contacts.contentQuery.ContentQuery;
+import com.aalzehla.capacitor.contacts.contentQuery.ContentQueryService;
+import com.aalzehla.capacitor.contacts.utils.Utils;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+// import android.util.Log;
+
+@CapacitorPlugin(
+    name = "CapacitorContacts",
+    permissions={
+        @Permission(strings = {Manifest.permission.READ_CONTACTS}, alias = "contacts"),
+    }
+)
+public class CapacitorContactsPlugin extends Plugin {
+
+    // Messages
+    public static final String ERROR_READ_CONTACT = "Unable to read contact data.";
+    public static final String ERROR_NO_PERMISSION = "User denied permission";
+
+    // Queries
+    public static final String CONTACT_DATA_SELECT_CLAUSE = ContactsContract.Data.LOOKUP_KEY + " = ? AND " + ContactsContract.Data.MIMETYPE + " IN('" + CommonDataKinds.Email.CONTENT_ITEM_TYPE + "', '" + CommonDataKinds.Phone.CONTENT_ITEM_TYPE + "', '" + CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE + "')"; //
+
+    @PluginMethod()
+    public void open(PluginCall call) {
+        if (getPermissionState("contacts") != PermissionState.GRANTED) {
+            //saveCall(call);
+            call.setKeepAlive(true);
+            requestPermissionForAlias("contacts", call, "contactsPermsCallback");
+            return;
+        }
+        //saveCall(call);
+        call.setKeepAlive(true);
+        Intent contactPickerIntent = new Intent(Intent.ACTION_PICK, ContactsContract.Contacts.CONTENT_URI);
+        startActivityForResult(call, contactPickerIntent, "activityCallback");
+    }
+
+    @PermissionCallback
+    private void contactsPermsCallback(PluginCall call) {
+        if (getPermissionState("contacts") == PermissionState.GRANTED) {
+            open(call);
+        } else {
+            call.reject(ERROR_NO_PERMISSION);
+        }
+    }
+
+    @ActivityCallback
+    private void activityCallback(PluginCall call, ActivityResult result) {
+        try {
+            //Log.v("File: ", String.valueOf(result));
+            JSObject contact = readContactData(result.getData(), call);
+            call.resolve(contact); // since it is just the contact object and not an array, no need to return the value field but instead just return the selected contact. use contact to replace Utils.wrapIntoResult(contact)
+        } catch (IOException e) {
+            call.reject(ERROR_READ_CONTACT);
+        }
+    }
+
+    @PluginMethod()
+    public void close(PluginCall call) {
+        call.unimplemented();
+    }
+
+    private JSObject readContactData(Intent intent, PluginCall savedCall) throws IOException {
+        final Map<String, String> projectionMap = getContactProjectionMap(); ////
+
+        try {
+            ContentQuery contactQuery = new ContentQuery.Builder()
+                .withUri(intent.getData())
+                .withProjection(projectionMap)
+                .build();
+
+
+            try (ContentQueryService.VisitableCursorWrapper contactVcw = ContentQueryService.query(getContext(), contactQuery)) {
+
+                ContactExtractorVisitor contactExtractor = new ContactExtractorVisitor(projectionMap);
+                contactVcw.accept(contactExtractor);
+                List<JSObject> contacts = contactExtractor.getContacts();
+
+                if (contacts.size() == 0) {
+                    return null;
+                } else {
+                    JSObject chosenContact = contacts.get(0);
+
+                    Map<String, String> dataProjectionMap = getContactDataProjectionMap(); ////////
+                    ContentQuery contactDataQuery = new ContentQuery.Builder()
+                        .withUri(ContactsContract.Data.CONTENT_URI)
+                        .withProjection(dataProjectionMap)
+                        .withSelection(CONTACT_DATA_SELECT_CLAUSE)
+                        .withSelectionArgs(new String[]{chosenContact.getString(PluginContactFields.ANDROID_CONTACT_LOOKUP_KEY)})
+                        .withSortOrder(ContactsContract.Data.MIMETYPE)
+                        .build();
+
+                    try (ContentQueryService.VisitableCursorWrapper dataVcw = ContentQueryService.query(getContext(), contactDataQuery)) {
+
+                        ContactDataExtractorVisitor contactDataExtractor = new ContactDataExtractorVisitor(dataProjectionMap);
+                        dataVcw.accept(contactDataExtractor);
+
+                        return transformContactObject(chosenContact, contactDataExtractor.getEmailAddresses(), contactDataExtractor.getPhoneNumbers(), contactDataExtractor.getPostalAddresses());
+                    }
+                }
+            }
+        }  catch (Exception e) {
+            return null;
+        }
+
+    }
+
+    private JSObject transformContactObject(JSObject tempContact, JSArray emailAddresses, JSArray phoneNumbers, JSArray postalAddresses) {
+        JSObject contact = new JSObject();
+        contact.put(PluginContactFields.IDENTIFIER, tempContact.getString(PluginContactFields.IDENTIFIER));
+        contact.put(PluginContactFields.ANDROID_CONTACT_LOOKUP_KEY, tempContact.getString(PluginContactFields.ANDROID_CONTACT_LOOKUP_KEY));
+        String displayName = tempContact.getString(PluginContactFields.DISPLAY_NAME);
+        contact.put(PluginContactFields.FULL_NAME, displayName);
+        if (displayName != null && displayName.contains(" ")) {
+            contact.put(PluginContactFields.DISPLAY_NAME, displayName);
+            contact.put(PluginContactFields.GIVEN_NAME, displayName.split(" ")[0]);
+            contact.put(PluginContactFields.FAMILY_NAME, displayName.split(" ")[1]);
+        }
+        contact.put(PluginContactFields.EMAIL_ADDRESSES, emailAddresses);
+        contact.put(PluginContactFields.PHONE_NUMBERS, phoneNumbers);
+        contact.put(PluginContactFields.POSTAL_ADDRESSES, postalAddresses);
+        //contact.put(PluginContactFields.PHOTO_URI, tempContact.getString(PluginContactFields.PHOTO_URI));
+        return contact;
+    }
+
+    private Map<String, String> getContactProjectionMap() {
+        Map<String, String> contactFieldsMap = new HashMap<>();
+        contactFieldsMap.put(ContactsContract.Contacts._ID, PluginContactFields.IDENTIFIER);
+        contactFieldsMap.put(ContactsContract.Contacts.LOOKUP_KEY, PluginContactFields.ANDROID_CONTACT_LOOKUP_KEY);
+        contactFieldsMap.put(ContactsContract.Contacts.DISPLAY_NAME_PRIMARY, PluginContactFields.DISPLAY_NAME);
+
+         contactFieldsMap.put(ContactsContract.Contacts.PHOTO_URI, PluginContactFields.PHOTO_URI);
+
+//        contactFieldsMap.put(ContactsContract.Contacts.Data.DATA15, PluginContactFields.PHOTO_URI);
+        return contactFieldsMap;
+    }
+
+    private Map<String, String> getContactDataProjectionMap() {
+        Map<String, String> contactFieldsMap = new HashMap<>();
+        contactFieldsMap.put(CommonDataKinds.Email.MIMETYPE, PluginContactFields.MIME_TYPE);
+        contactFieldsMap.put(ContactsContract.Data.DATA1, ContactsContract.Data.DATA1);
+        contactFieldsMap.put(ContactsContract.Data.DATA2, ContactsContract.Data.DATA2);
+        contactFieldsMap.put(ContactsContract.Data.DATA3, ContactsContract.Data.DATA3);
+        contactFieldsMap.put(ContactsContract.Data.DATA4, ContactsContract.Data.DATA4);
+        contactFieldsMap.put(ContactsContract.Data.DATA5, ContactsContract.Data.DATA5);
+        contactFieldsMap.put(ContactsContract.Data.DATA6, ContactsContract.Data.DATA6);
+        contactFieldsMap.put(ContactsContract.Data.DATA7, ContactsContract.Data.DATA7);
+        contactFieldsMap.put(ContactsContract.Data.DATA8, ContactsContract.Data.DATA8);
+        contactFieldsMap.put(ContactsContract.Data.DATA9, ContactsContract.Data.DATA9);
+        contactFieldsMap.put(ContactsContract.Data.DATA10, ContactsContract.Data.DATA10);
+        return contactFieldsMap;
+    }
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/ContactDataExtractorVisitor.java

@@ -0,0 +1,122 @@
+package com.aalzehla.capacitor.contacts;
+
+import android.database.Cursor;
+import android.provider.ContactsContract;
+import com.getcapacitor.JSArray;
+import com.getcapacitor.JSObject;
+import com.aalzehla.capacitor.contacts.contentQuery.ContentQueryService;
+import com.aalzehla.capacitor.contacts.utils.Visitor;
+
+import java.util.Map;
+import android.util.Log;
+
+public class ContactDataExtractorVisitor implements Visitor<Cursor> {
+
+    private Map<String, String> projectionMap;
+
+    private JSArray phoneNumbers = new JSArray();
+    private JSArray emailAddresses = new JSArray();
+    private JSArray postalAddresses = new JSArray();
+
+    public ContactDataExtractorVisitor(Map<String, String> projectionMap) {
+        this.projectionMap = projectionMap;
+    }
+
+    @Override
+    public void visit(Cursor cursor) {
+        JSObject currentDataRecord = ContentQueryService.extractDataFromResultSet(cursor, projectionMap);
+        String currentMimeType = currentDataRecord.getString(PluginContactFields.MIME_TYPE);
+
+        //Log.v("HELLO", String.valueOf(currentDataRecord));
+
+        if (ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE.equals(currentMimeType)) {
+            JSObject email = new JSObject();
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA1) != null) {
+                email.put("emailAddress", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA1));
+            }
+            switch (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA2)) {
+                case "1":
+                    email.put("type", "home");
+                    break;
+                case "2":
+                    email.put("type", "mobile");
+                    break;
+                case "3":
+                    email.put("type", "work");
+                    break;
+                default:
+                    email.put("type", "other");
+                    break;
+            }
+            emailAddresses.put(email);
+        } else if (ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE.equals(currentMimeType)) {
+            JSObject phone = new JSObject();
+            // https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.Phone
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA1) != null) {
+                phone.put("phoneNumber", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA1));
+            }
+            switch (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA2)) {
+                case "1":
+                    phone.put("type", "home");
+                    break;
+                case "2":
+                    phone.put("type", "mobile");
+                    break;
+                case "3":
+                    phone.put("type", "work");
+                    break;
+                default:
+                    phone.put("type", "other");
+                    break;
+            }
+            phoneNumbers.put(phone);
+        } else if (ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE.equals(currentMimeType)) {
+            JSObject address = new JSObject();
+            // https://developer.android.com/reference/android/provider/ContactsContract.CommonDataKinds.StructuredPostal
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA1) != null) {
+                address.put("formattedAddress", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA1));
+            }
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA4) != null) {
+                address.put("street", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA4));
+            }
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA5) != null) {
+                address.put("pobox", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA5));
+            }
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA6) != null) {
+                address.put("neighborhood", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA6));
+            }
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA7) != null) {
+                address.put("city", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA7));
+            }
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA8) != null) {
+                address.put("state", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA8));
+            }
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA9) != null) {
+                address.put("postalCode", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA9));
+            }
+            if (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA10) != null) {
+                address.put("country", currentDataRecord.getString(ContactsContract.Contacts.Data.DATA10));
+            }
+            switch (currentDataRecord.getString(ContactsContract.Contacts.Data.DATA2)) {
+                case "1":
+                    address.put("type", "home");
+                    break;
+                case "2":
+                    address.put("type", "work");
+                    break;
+                default:
+                    address.put("type", "other");
+                    break;
+            }
+            postalAddresses.put(address);
+        }
+    }
+
+    public JSArray getPhoneNumbers() {
+        return phoneNumbers;
+    }
+    public JSArray getEmailAddresses() {
+        return emailAddresses;
+    }
+    public JSArray getPostalAddresses() { return postalAddresses; }
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/ContactExtractorVisitor.java

@@ -0,0 +1,31 @@
+package com.aalzehla.capacitor.contacts;
+
+import android.database.Cursor;
+import com.getcapacitor.JSObject;
+import com.aalzehla.capacitor.contacts.contentQuery.ContentQueryService;
+import com.aalzehla.capacitor.contacts.utils.Visitor;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+public class ContactExtractorVisitor implements Visitor<Cursor> {
+
+    private Map<String, String> projectionMap;
+
+    private List<JSObject> contacts = new ArrayList<>();
+
+    public ContactExtractorVisitor(Map<String, String> projectionMap) {
+        this.projectionMap = projectionMap;
+    }
+
+    @Override
+    public void visit(Cursor cursor) {
+        JSObject contact = ContentQueryService.extractDataFromResultSet(cursor, projectionMap);
+        contacts.add(contact);
+    }
+
+    public List<JSObject> getContacts() {
+        return contacts;
+    }
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/PluginContactFields.java

@@ -0,0 +1,17 @@
+package com.aalzehla.capacitor.contacts;
+
+public class PluginContactFields {
+    public static final String IDENTIFIER = "identifier";
+    public static final String ANDROID_CONTACT_LOOKUP_KEY = "androidContactLookupKey";
+    public static final String DISPLAY_NAME = "displayName";
+    public static final String FULL_NAME = "fullName";
+    public static final String GIVEN_NAME = "givenName";
+    public static final String FAMILY_NAME = "familyName";
+    public static final String EMAIL_ADDRESSES = "emailAddresses";
+    public static final String PHONE_NUMBERS = "phoneNumbers";
+    public static final String PHONE_TYPES = "phoneNumberLabels";
+    public static final String POSTAL_ADDRESSES = "postalAddresses";
+    public static final String POSTAL_TYPES = "postalAddressLabels";
+    public static final String MIME_TYPE = "mimeType";
+    public static final String PHOTO_URI = "image";
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/contentQuery/ContentQuery.java

@@ -0,0 +1,83 @@
+package com.aalzehla.capacitor.contacts.contentQuery;
+
+import android.net.Uri;
+import android.os.CancellationSignal;
+
+import java.util.Map;
+
+public class ContentQuery {
+
+    private Uri uri;
+    private Map<String, String> projection;
+    private String selection;
+    private String[] selectionArgs;
+    private String sortOrder;
+    private CancellationSignal cancellationSignal;
+
+    private ContentQuery() {
+    }
+
+    public Uri getUri() {
+        return uri;
+    }
+
+    public Map<String, String> getProjection() {
+        return projection;
+    }
+
+    public String getSelection() {
+        return selection;
+    }
+
+    public String[] getSelectionArgs() {
+        return selectionArgs;
+    }
+
+    public String getSortOrder() {
+        return sortOrder;
+    }
+
+    public CancellationSignal getCancellationSignal() {
+        return cancellationSignal;
+    }
+
+    public static class Builder {
+
+        private ContentQuery contentQuery = new ContentQuery();
+
+        public Builder withUri(Uri uri) {
+            contentQuery.uri = uri;
+            return this;
+        }
+
+        public Builder withProjection(Map<String, String> projection) {
+            contentQuery.projection = projection;
+            return this;
+        }
+
+        public Builder withSelection(String selection) {
+            contentQuery.selection = selection;
+            return this;
+        }
+
+        public Builder withSelectionArgs(String[] selectionArgs) {
+            contentQuery.selectionArgs = selectionArgs;
+            return this;
+        }
+
+        public Builder withSortOrder(String sortOrder) {
+            contentQuery.sortOrder = sortOrder;
+            return this;
+        }
+
+        public Builder withCancellationSignal(CancellationSignal cancellationSignal) {
+            contentQuery.cancellationSignal = cancellationSignal;
+            return this;
+        }
+
+        public ContentQuery build() {
+            return contentQuery;
+        }
+
+    }
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/contentQuery/ContentQueryService.java

@@ -0,0 +1,60 @@
+package com.aalzehla.capacitor.contacts.contentQuery;
+
+import android.content.Context;
+import android.database.Cursor;
+import com.getcapacitor.JSObject;
+import com.aalzehla.capacitor.contacts.utils.Utils;
+import com.aalzehla.capacitor.contacts.utils.Visitable;
+import com.aalzehla.capacitor.contacts.utils.Visitor;
+
+import java.io.Closeable;
+import java.util.Map;
+
+public class ContentQueryService {
+
+    public static VisitableCursorWrapper query(Context context, ContentQuery query) {
+        try {
+            String[] projectionArray = Utils.getMapKeysAsArray(query.getProjection());
+            Cursor cursor = context.getContentResolver().query(query.getUri(), projectionArray, query.getSelection(), query.getSelectionArgs(), query.getSortOrder(), query.getCancellationSignal());
+            return new VisitableCursorWrapper(cursor);
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    public static JSObject extractDataFromResultSet(Cursor cursor, Map<String, String> projectionMap) {
+        try {
+            JSObject result = new JSObject();
+            for (Map.Entry<String, String> entry : projectionMap.entrySet()) {
+                int columnIndex = cursor.getColumnIndex(entry.getKey());
+                result.put(entry.getValue(), cursor.getString(columnIndex));
+            }
+            return result;
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    public static class VisitableCursorWrapper implements Visitable<Cursor>, Closeable, AutoCloseable {
+
+        private Cursor cursor;
+
+        private VisitableCursorWrapper(Cursor cursor) {
+            this.cursor = cursor;
+        }
+
+        public void accept(Visitor<Cursor> visitor) {
+            while (cursor != null && cursor.moveToNext()) {
+                visitor.visit(cursor);
+            }
+        }
+
+        @Override
+        public void close() {
+            if (cursor != null) {
+                cursor.close();
+            }
+        }
+    }
+
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/utils/Utils.java

@@ -0,0 +1,19 @@
+package com.aalzehla.capacitor.contacts.utils;
+
+import com.getcapacitor.JSObject;
+
+import java.util.Map;
+
+public class Utils {
+
+    public static String[] getMapKeysAsArray(Map<String, ?> map) {
+        return map.keySet().toArray(new String[]{});
+    }
+
+    public static JSObject wrapIntoResult(JSObject contact) {
+        JSObject result = new JSObject();
+        result.put("value", contact);
+        return result;
+    }
+
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/utils/Visitable.java

@@ -0,0 +1,5 @@
+package com.aalzehla.capacitor.contacts.utils;
+
+public interface Visitable<T> {
+    void accept(Visitor<T> visitor);
+}

package/android/src/main/java/com/aalzehla/capacitor/contacts/utils/Visitor.java

@@ -0,0 +1,5 @@
+package com.aalzehla.capacitor.contacts.utils;
+
+public interface Visitor<T> {
+    void visit(T element);
+}

package/dist/docs.json

@@ -0,0 +1,145 @@
+{
+  "api": {
+    "name": "CapacitorContactsPlugin",
+    "slug": "capacitorcontactsplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "open",
+        "signature": "() => Promise<Contact[]>",
+        "parameters": [],
+        "returns": "Promise<Contact[]>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [
+          "Contact"
+        ],
+        "slug": "open"
+      },
+      {
+        "name": "close",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [],
+        "slug": "close"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "Contact",
+      "slug": "contact",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "identifier",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "androidContactLookupKey",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "contactId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "givenName",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "familyName",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "nickname",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "fullName",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "jobTitle",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "departmentName",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "organizationName",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "note",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "phoneNumbers",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "any[] | undefined"
+        },
+        {
+          "name": "emailAddresses",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "any[] | undefined"
+        },
+        {
+          "name": "postalAddresses",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "any[] | undefined"
+        }
+      ]
+    }
+  ],
+  "enums": [],
+  "typeAliases": [],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,20 @@
+export interface CapacitorContactsPlugin {
+    open?(): Promise<Contact[]>;
+    close?(): Promise<void>;
+}
+export interface Contact {
+    identifier?: string;
+    androidContactLookupKey?: string;
+    contactId?: string;
+    givenName?: string;
+    familyName?: string;
+    nickname?: string;
+    fullName?: string;
+    jobTitle?: string;
+    departmentName?: string;
+    organizationName?: string;
+    note?: string;
+    phoneNumbers?: any[];
+    emailAddresses?: any[];
+    postalAddresses?: any[];
+}

package/dist/esm/definitions.js

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

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface CapacitorContactsPlugin {\n  open?(): Promise<Contact[]>;\n  close?(): Promise<void>;\n}\n\nexport interface Contact {\n  identifier?: string;\n  androidContactLookupKey?: string;\n  contactId?: string;\n  givenName?: string;\n  familyName?: string;\n  nickname?: string;\n  fullName?: string;\n  jobTitle?: string;\n  departmentName?: string;\n  organizationName?: string;\n  note?: string;\n  phoneNumbers?: any[];\n  emailAddresses?: any[]\n  postalAddresses?: any[]\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { CapacitorContactsPlugin } from './definitions';
+declare const CapacitorContacts: CapacitorContactsPlugin;
+export * from './definitions';
+export { CapacitorContacts };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const CapacitorContacts = registerPlugin('CapacitorContacts', {
+    web: () => import('./web').then(m => new m.CapacitorContactsWeb()),
+});
+export * from './definitions';
+export { CapacitorContacts };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,iBAAiB,GAAG,cAAc,CACtC,mBAAmB,EACnB;IACE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;CACnE,CACF,CAAC;AAEF,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { CapacitorContactsPlugin } from './definitions';\n\nconst CapacitorContacts = registerPlugin<CapacitorContactsPlugin>(\n  'CapacitorContacts',\n  {\n    web: () => import('./web').then(m => new m.CapacitorContactsWeb()),\n  },\n);\n\nexport * from './definitions';\nexport { CapacitorContacts };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,9 @@
+import { WebPlugin } from '@capacitor/core';
+import type { CapacitorContactsPlugin } from './definitions';
+export declare class CapacitorContactsWeb extends WebPlugin implements CapacitorContactsPlugin {
+    constructor();
+    close(): Promise<void>;
+}
+declare const ContactPicker: CapacitorContactsWeb;
+declare const CapacitorContacts: CapacitorContactsWeb;
+export { ContactPicker, CapacitorContacts };

package/dist/esm/web.js

@@ -0,0 +1,14 @@
+import { WebPlugin } from '@capacitor/core';
+export class CapacitorContactsWeb extends WebPlugin {
+    constructor() {
+        super({
+            name: 'CapacitorContacts',
+            platforms: ['web']
+        });
+    }
+    async close() { }
+}
+const ContactPicker = new CapacitorContactsWeb();
+const CapacitorContacts = ContactPicker;
+export { ContactPicker, CapacitorContacts };
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,oBACX,SAAQ,SAAS;IAGjB;QACE,KAAK,CAAC;YACF,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,KAAK,KAAI,CAAC;CACjB;AAED,MAAM,aAAa,GAAG,IAAI,oBAAoB,EAAE,CAAC;AACjD,MAAM,iBAAiB,GAAG,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { CapacitorContactsPlugin } from './definitions';\n\nexport class CapacitorContactsWeb\n  extends WebPlugin\n  implements CapacitorContactsPlugin\n{\n  constructor() {\n    super({\n        name: 'CapacitorContacts',\n        platforms: ['web']\n    });\n  }\n  async close() {}\n}\n\nconst ContactPicker = new CapacitorContactsWeb();\nconst CapacitorContacts = ContactPicker\nexport { ContactPicker, CapacitorContacts };\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,31 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@capacitor/core');
+
+const CapacitorContacts$1 = core.registerPlugin('CapacitorContacts', {
+    web: () => Promise.resolve().then(function () { return web; }).then(m => new m.CapacitorContactsWeb()),
+});
+
+class CapacitorContactsWeb extends core.WebPlugin {
+    constructor() {
+        super({
+            name: 'CapacitorContacts',
+            platforms: ['web']
+        });
+    }
+    async close() { }
+}
+const ContactPicker = new CapacitorContactsWeb();
+const CapacitorContacts = ContactPicker;
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    CapacitorContactsWeb: CapacitorContactsWeb,
+    ContactPicker: ContactPicker,
+    CapacitorContacts: CapacitorContacts
+});
+
+exports.CapacitorContacts = CapacitorContacts$1;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapacitorContacts = registerPlugin('CapacitorContacts', {\n    web: () => import('./web').then(m => new m.CapacitorContactsWeb()),\n});\nexport * from './definitions';\nexport { CapacitorContacts };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorContactsWeb extends WebPlugin {\n    constructor() {\n        super({\n            name: 'CapacitorContacts',\n            platforms: ['web']\n        });\n    }\n    async close() { }\n}\nconst ContactPicker = new CapacitorContactsWeb();\nconst CapacitorContacts = ContactPicker;\nexport { ContactPicker, CapacitorContacts };\n//# sourceMappingURL=web.js.map"],"names":["CapacitorContacts","registerPlugin","WebPlugin"],"mappings":";;;;;;AACK,MAACA,mBAAiB,GAAGC,mBAAc,CAAC,mBAAmB,EAAE;AAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACtE,CAAC;;ACFM,MAAM,oBAAoB,SAASC,cAAS,CAAC;AACpD,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,CAAC;AACd,YAAY,IAAI,EAAE,mBAAmB;AACrC,YAAY,SAAS,EAAE,CAAC,KAAK,CAAC;AAC9B,SAAS,CAAC,CAAC;AACX,KAAK;AACL,IAAI,MAAM,KAAK,GAAG,GAAG;AACrB,CAAC;AACD,MAAM,aAAa,GAAG,IAAI,oBAAoB,EAAE,CAAC;AACjD,MAAM,iBAAiB,GAAG,aAAa;;;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,34 @@
+var capacitorCapacitorContacts = (function (exports, core) {
+    'use strict';
+
+    const CapacitorContacts$1 = core.registerPlugin('CapacitorContacts', {
+        web: () => Promise.resolve().then(function () { return web; }).then(m => new m.CapacitorContactsWeb()),
+    });
+
+    class CapacitorContactsWeb extends core.WebPlugin {
+        constructor() {
+            super({
+                name: 'CapacitorContacts',
+                platforms: ['web']
+            });
+        }
+        async close() { }
+    }
+    const ContactPicker = new CapacitorContactsWeb();
+    const CapacitorContacts = ContactPicker;
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        CapacitorContactsWeb: CapacitorContactsWeb,
+        ContactPicker: ContactPicker,
+        CapacitorContacts: CapacitorContacts
+    });
+
+    exports.CapacitorContacts = CapacitorContacts$1;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapacitorContacts = registerPlugin('CapacitorContacts', {\n    web: () => import('./web').then(m => new m.CapacitorContactsWeb()),\n});\nexport * from './definitions';\nexport { CapacitorContacts };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorContactsWeb extends WebPlugin {\n    constructor() {\n        super({\n            name: 'CapacitorContacts',\n            platforms: ['web']\n        });\n    }\n    async close() { }\n}\nconst ContactPicker = new CapacitorContactsWeb();\nconst CapacitorContacts = ContactPicker;\nexport { ContactPicker, CapacitorContacts };\n//# sourceMappingURL=web.js.map"],"names":["CapacitorContacts","registerPlugin","WebPlugin"],"mappings":";;;AACK,UAACA,mBAAiB,GAAGC,mBAAc,CAAC,mBAAmB,EAAE;IAC9D,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACtE,CAAC;;ICFM,MAAM,oBAAoB,SAASC,cAAS,CAAC;IACpD,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,CAAC;IACd,YAAY,IAAI,EAAE,mBAAmB;IACrC,YAAY,SAAS,EAAE,CAAC,KAAK,CAAC;IAC9B,SAAS,CAAC,CAAC;IACX,KAAK;IACL,IAAI,MAAM,KAAK,GAAG,GAAG;IACrB,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACjD,MAAM,iBAAiB,GAAG,aAAa;;;;;;;;;;;;;;;;;;;"}

package/ios/Sources/CapacitorContactsPlugin/CapacitorContactsPlugin.swift

@@ -0,0 +1,166 @@
+import Foundation
+import Capacitor
+import ContactsUI
+
+/**
+ * Please read the Capacitor iOS Plugin Development Guide
+ * here: https://capacitorjs.com/docs/plugins/ios
+ */
+@objc(CapacitorContactsPlugin)
+public class CapacitorContactsPlugin: CAPPlugin, CAPBridgedPlugin, CNContactPickerDelegate {
+    public let identifier = "CapacitorContactsPlugin"
+    public let jsName = "CapacitorContacts"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "open", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "close", returnType: CAPPluginReturnPromise)
+    ]
+
+    var vc: CNContactPickerViewController?
+    var id: String?
+
+    @objc func open(_ call: CAPPluginCall) {
+        self.id = call.callbackId
+        call.keepAlive = true
+        Permissions.contactPermission { granted in
+            if granted {
+                DispatchQueue.main.async {
+                    self.vc = CNContactPickerViewController()
+                    self.vc!.delegate = self
+                    self.bridge?.viewController?.present(self.vc!, animated: true, completion: nil)
+                }
+            } else {
+                call.reject("User denied access to contacts")
+            }
+        }
+    }
+
+    @objc func close(_ call: CAPPluginCall) {
+        if vc == nil {
+            call.resolve()
+        }
+        DispatchQueue.main.async {
+            self.bridge?.dismissVC(animated: true) {
+                call.resolve()
+            }
+        }
+    }
+
+    func makeContact(_ contact: CNContact) -> Dictionary<String, Any> {
+        var res: [String:Any] = [:]
+        res["contactId"] = contact.identifier;
+        res["givenName"] = contact.givenName;
+        res["familyName"] = contact.familyName;
+        res["nickname"] = contact.nickname;
+        res["displayName"] = contact.givenName + " " + contact.familyName;
+        res["jobTitle"] = contact.jobTitle;
+        res["departmentName"] = contact.departmentName;
+        res["organizationName"] = contact.organizationName;
+        res["note"] = contact.note;
+
+        // process email addresses
+        var array: [JSObject] = [];
+        for emailAddress in contact.emailAddresses {
+            var object = JSObject()
+            object["type"] = CNLabeledValue<NSString>.localizedString(forLabel: emailAddress.label ?? "")
+            if emailAddress.value != "" {
+                object["emailAddress"] = emailAddress.value as String
+            }
+            array.append(object)
+        }
+        res["emailAddresses"] = array
+
+        // process phone numbers
+        array = [];
+        for phoneNumber in contact.phoneNumbers {
+            var object = JSObject()
+            object["type"] = CNLabeledValue<NSString>.localizedString(forLabel: phoneNumber.label ?? "")
+            if phoneNumber.value.stringValue != "" {
+                object["phoneNumber"] = phoneNumber.value.stringValue
+            }
+            array.append(object)
+        }
+        res["phoneNumbers"] = array
+
+        // process postal addresses
+        array = [];
+        for address in contact.postalAddresses {
+            var object = JSObject()
+            object["formattedAddress"] = CNPostalAddressFormatter().string(from: address.value)
+            object["type"] = CNLabeledValue<NSString>.localizedString(forLabel: address.label ?? "")
+            if address.value.street != "" {
+                object["street"] = address.value.street
+            }
+            if address.value.city != "" {
+                object["city"] = address.value.city
+            }
+            if address.value.state != "" {
+                object["state"] = address.value.state
+            }
+            if address.value.postalCode != "" {
+                object["postalCode"] = address.value.postalCode
+            }
+            if address.value.country != "" {
+                object["country"] = address.value.country
+            }
+            if address.value.isoCountryCode != "" {
+                object["isoCountryCode"] = address.value.isoCountryCode
+            }
+            if address.value.subAdministrativeArea != "" {
+                object["subAdministrativeArea"] = address.value.subAdministrativeArea
+            }
+            if address.value.subLocality != "" {
+                object["subLocality"] = address.value.subLocality
+            }
+            array.append(object)
+        }
+        res["postalAddresses"] = array
+
+        // temporarily disable returning contact imageData because base64 data overwhelms console log
+        /*if contact.imageData != nil {
+            let image = UIImage(data: contact.imageData!)?.pngData() ?? UIImage(data: contact.imageData!)?.jpegData(compressionQuality: 0);
+            res["image"] = image!.base64EncodedString(options: .lineLength64Characters);
+        }*/
+
+        return res
+    }
+
+    // didSelect contacts: [CNContact]
+    public func contactPicker(_ picker: CNContactPickerViewController, didSelect contact: CNContact) {
+        picker.dismiss(animated: true, completion: nil)
+        guard let call = self.bridge?.savedCall(withID: self.id!) else {
+            print("call was not loaded correctly")
+            return
+        }
+        //print("result: " + String(describing: contact))
+        call.resolve(makeContact(contact));
+    }
+
+    public func contactPickerDidCancel(_ picker: CNContactPickerViewController) {
+        //print("closed!")
+        picker.dismiss(animated: true, completion: nil)
+        guard let call = self.bridge?.savedCall(withID: self.id!) else { return }
+        call.resolve()
+    }
+}
+
+class Permissions {
+    class func contactPermission(completionHandler: @escaping (_ accessGranted: Bool) -> Void) {
+        let contactStore = CNContactStore()
+        switch CNContactStore.authorizationStatus(for: .contacts) {
+        case .authorized:
+            completionHandler(true)
+        case .denied:
+            completionHandler(false)
+        case .restricted, .notDetermined:
+            contactStore.requestAccess(for: .contacts) { granted, _ in
+                if granted {
+                    completionHandler(true)
+                } else {
+                    DispatchQueue.main.async {
+                        completionHandler(false)
+                    }
+                }
+            }
+        }
+    }
+}

package/ios/Tests/CapacitorContactsPluginTests/CapacitorContactsPluginTests.swift

@@ -0,0 +1,15 @@
+import XCTest
+@testable import CapacitorContactsPlugin
+
+class CapacitorContactsTests: XCTestCase {
+    func testEcho() {
+        // This is an example of a functional test case for a plugin.
+        // Use XCTAssert and related functions to verify your tests produce the correct results.
+
+        let implementation = CapacitorContacts()
+        let value = "Hello, World!"
+        let result = implementation.echo(value)
+
+        XCTAssertEqual(value, result)
+    }
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@aalzehla/capacitor-contacts",
+  "version": "0.0.1",
+  "description": "This capacitor plugin allows you to use the native contact picker UI on Android or iOS for single contact selection. Both platforms will return the same payload structure, where the data exists.",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapacitorContacts.podspec"
+  ],
+  "author": "Ateik Alzehla",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aalzehla/capacitor-contacts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aalzehla/capacitor-contacts/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapacitorContacts -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\"",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api CapacitorContactsPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.js",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^6.0.0",
+    "@capacitor/core": "^6.0.0",
+    "@capacitor/docgen": "^0.2.2",
+    "@capacitor/ios": "^6.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^1.0.1",
+    "@ionic/swiftlint-config": "^1.1.2",
+    "eslint": "^8.57.0",
+    "prettier": "~2.3.0",
+    "prettier-plugin-java": "~1.0.2",
+    "rimraf": "^3.0.2",
+    "rollup": "^2.32.0",
+    "swiftlint": "^1.0.1",
+    "typescript": "~4.1.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^6.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}