@aalzehla/capacitor-contacts 0.0.5 → 8.0.1

package/dist/plugin.js

@@ -1,29 +1,88 @@
-var capacitorCapacitorContacts = (function (exports, core) {
+var capacitorContacts = (function (exports, core) {
     'use strict';
 
-    const CapacitorContacts$1 = core.registerPlugin('CapacitorContacts', {
-        web: () => Promise.resolve().then(function () { return web; }).then(m => new m.CapacitorContactsWeb()),
+    exports.PhoneType = void 0;
+    (function (PhoneType) {
+        // Home / Work
+        PhoneType["Home"] = "home";
+        PhoneType["Work"] = "work";
+        // Other / Custom
+        PhoneType["Other"] = "other";
+        PhoneType["Custom"] = "custom";
+        // Phone specific
+        PhoneType["Mobile"] = "mobile";
+        PhoneType["FaxWork"] = "fax_work";
+        PhoneType["FaxHome"] = "fax_home";
+        PhoneType["Pager"] = "pager";
+        PhoneType["Callback"] = "callback";
+        PhoneType["Car"] = "car";
+        PhoneType["CompanyMain"] = "company_main";
+        PhoneType["Isdn"] = "isdn";
+        PhoneType["Main"] = "main";
+        PhoneType["OtherFax"] = "other_fax";
+        PhoneType["Radio"] = "radio";
+        PhoneType["Telex"] = "telex";
+        PhoneType["TtyTdd"] = "tty_tdd";
+        PhoneType["WorkMobile"] = "work_mobile";
+        PhoneType["WorkPager"] = "work_pager";
+        PhoneType["Assistant"] = "assistant";
+        PhoneType["Mms"] = "mms";
+    })(exports.PhoneType || (exports.PhoneType = {}));
+    exports.EmailType = void 0;
+    (function (EmailType) {
+        // Home / Work
+        EmailType["Home"] = "home";
+        EmailType["Work"] = "work";
+        // Other / Custom
+        EmailType["Other"] = "other";
+        EmailType["Custom"] = "custom";
+        // Email specific
+        EmailType["Mobile"] = "mobile";
+    })(exports.EmailType || (exports.EmailType = {}));
+    exports.PostalAddressType = void 0;
+    (function (PostalAddressType) {
+        // Home / Work
+        PostalAddressType["Home"] = "home";
+        PostalAddressType["Work"] = "work";
+        // Other / Custom
+        PostalAddressType["Other"] = "other";
+        PostalAddressType["Custom"] = "custom";
+    })(exports.PostalAddressType || (exports.PostalAddressType = {}));
+
+    const Contacts = core.registerPlugin('Contacts', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.ContactsWeb()),
     });
 
-    class CapacitorContactsWeb extends core.WebPlugin {
-        constructor() {
-            super();
+    class ContactsWeb extends core.WebPlugin {
+        async checkPermissions() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async requestPermissions() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async getContact() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async getContacts() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async createContact() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async deleteContact() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async pickContact() {
+            throw this.unimplemented('Not implemented on web.');
         }
-        async close() { }
     }
-    const ContactPicker = new CapacitorContactsWeb();
-    const CapacitorContacts = ContactPicker;
 
     var web = /*#__PURE__*/Object.freeze({
         __proto__: null,
-        CapacitorContactsWeb: CapacitorContactsWeb,
-        ContactPicker: ContactPicker,
-        CapacitorContacts: CapacitorContacts
+        ContactsWeb: ContactsWeb
     });
 
-    exports.CapacitorContacts = CapacitorContacts$1;
-
-    Object.defineProperty(exports, '__esModule', { value: true });
+    exports.Contacts = Contacts;
 
     return exports;
 

package/dist/plugin.js.map

@@ -1 +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    }\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,EAAE,CAAC;IAChB,KAAK;IACL,IAAI,MAAM,KAAK,GAAG,GAAG;IACrB,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACjD,MAAM,iBAAiB,GAAG,aAAa;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["export var PhoneType;\n(function (PhoneType) {\n    // Home / Work\n    PhoneType[\"Home\"] = \"home\";\n    PhoneType[\"Work\"] = \"work\";\n    // Other / Custom\n    PhoneType[\"Other\"] = \"other\";\n    PhoneType[\"Custom\"] = \"custom\";\n    // Phone specific\n    PhoneType[\"Mobile\"] = \"mobile\";\n    PhoneType[\"FaxWork\"] = \"fax_work\";\n    PhoneType[\"FaxHome\"] = \"fax_home\";\n    PhoneType[\"Pager\"] = \"pager\";\n    PhoneType[\"Callback\"] = \"callback\";\n    PhoneType[\"Car\"] = \"car\";\n    PhoneType[\"CompanyMain\"] = \"company_main\";\n    PhoneType[\"Isdn\"] = \"isdn\";\n    PhoneType[\"Main\"] = \"main\";\n    PhoneType[\"OtherFax\"] = \"other_fax\";\n    PhoneType[\"Radio\"] = \"radio\";\n    PhoneType[\"Telex\"] = \"telex\";\n    PhoneType[\"TtyTdd\"] = \"tty_tdd\";\n    PhoneType[\"WorkMobile\"] = \"work_mobile\";\n    PhoneType[\"WorkPager\"] = \"work_pager\";\n    PhoneType[\"Assistant\"] = \"assistant\";\n    PhoneType[\"Mms\"] = \"mms\";\n})(PhoneType || (PhoneType = {}));\nexport var EmailType;\n(function (EmailType) {\n    // Home / Work\n    EmailType[\"Home\"] = \"home\";\n    EmailType[\"Work\"] = \"work\";\n    // Other / Custom\n    EmailType[\"Other\"] = \"other\";\n    EmailType[\"Custom\"] = \"custom\";\n    // Email specific\n    EmailType[\"Mobile\"] = \"mobile\";\n})(EmailType || (EmailType = {}));\nexport var PostalAddressType;\n(function (PostalAddressType) {\n    // Home / Work\n    PostalAddressType[\"Home\"] = \"home\";\n    PostalAddressType[\"Work\"] = \"work\";\n    // Other / Custom\n    PostalAddressType[\"Other\"] = \"other\";\n    PostalAddressType[\"Custom\"] = \"custom\";\n})(PostalAddressType || (PostalAddressType = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst Contacts = registerPlugin('Contacts', {\n    web: () => import('./web').then((m) => new m.ContactsWeb()),\n});\nexport * from './definitions';\nexport { Contacts };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class ContactsWeb extends WebPlugin {\n    async checkPermissions() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async requestPermissions() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getContact() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getContacts() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async createContact() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async deleteContact() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async pickContact() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["PhoneType","EmailType","PostalAddressType","registerPlugin","WebPlugin"],"mappings":";;;AAAWA;IACX,CAAC,UAAU,SAAS,EAAE;IACtB;IACA,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;IAC9B,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;IAC9B;IACA,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;IAChC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAClC;IACA,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAClC,IAAI,SAAS,CAAC,SAAS,CAAC,GAAG,UAAU;IACrC,IAAI,SAAS,CAAC,SAAS,CAAC,GAAG,UAAU;IACrC,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;IAChC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,UAAU;IACtC,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK;IAC5B,IAAI,SAAS,CAAC,aAAa,CAAC,GAAG,cAAc;IAC7C,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;IAC9B,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;IAC9B,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,WAAW;IACvC,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;IAChC,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;IAChC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS;IACnC,IAAI,SAAS,CAAC,YAAY,CAAC,GAAG,aAAa;IAC3C,IAAI,SAAS,CAAC,WAAW,CAAC,GAAG,YAAY;IACzC,IAAI,SAAS,CAAC,WAAW,CAAC,GAAG,WAAW;IACxC,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK;IAC5B,CAAC,EAAEA,iBAAS,KAAKA,iBAAS,GAAG,EAAE,CAAC,CAAC;AACtBC;IACX,CAAC,UAAU,SAAS,EAAE;IACtB;IACA,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;IAC9B,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;IAC9B;IACA,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;IAChC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAClC;IACA,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAClC,CAAC,EAAEA,iBAAS,KAAKA,iBAAS,GAAG,EAAE,CAAC,CAAC;AACtBC;IACX,CAAC,UAAU,iBAAiB,EAAE;IAC9B;IACA,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,MAAM;IACtC,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,MAAM;IACtC;IACA,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO;IACxC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAC1C,CAAC,EAAEA,yBAAiB,KAAKA,yBAAiB,GAAG,EAAE,CAAC,CAAC;;AC7C5C,UAAC,QAAQ,GAAGC,mBAAc,CAAC,UAAU,EAAE;IAC5C,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,CAAC;;ICFM,MAAM,WAAW,SAASC,cAAS,CAAC;IAC3C,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Plugin/BiMap.swift

@@ -0,0 +1,42 @@
+import Foundation
+
+// Helper to enable bidirectional mapping.
+public class BiMap<K: Hashable, V: Hashable> {
+    // The following map can be used for retrieving the key belonging to a certain value.
+    // This map is essentially the inverted version of `mapForValues`
+    private var mapForKeys: [V: K] = [:]
+    // The following map can be used for retrieving the value belonging to a certain key.
+    private var mapForValues: [K: V] = [:]
+
+    private var defaultKey: K
+    private var defaultValue: V
+
+    init(_ map: [K: V], _ defaultKey: K, _ defaultValue: V) {
+        self.mapForValues = map
+
+        for entry in map {
+            let key: K = entry.key
+            let value: V = entry.value
+            self.mapForKeys[value] = key
+        }
+
+        self.defaultKey = defaultKey
+        self.defaultValue = defaultValue
+    }
+
+    func getKey(_ v: V?) -> K {
+        let k: K? = self.mapForKeys[v ?? "" as! V]
+        guard let k = k else {
+            return self.defaultKey
+        }
+        return k
+    }
+
+    func getValue(_ k: K?) -> V {
+        let v: V? = self.mapForValues[k ?? "" as! K]
+        guard let v = v else {
+            return self.defaultValue
+        }
+        return v
+    }
+}

package/ios/Plugin/ContactPayload.swift

@@ -0,0 +1,227 @@
+import Foundation
+import Contacts
+import Capacitor
+
+public class ContactPayload {
+
+    // Id
+    private var contactId: String
+
+    // Name
+    private var name: JSObject = JSObject()
+
+    // Organization
+    private var organization: JSObject = JSObject()
+
+    // Birthday
+    private var birthday: JSObject = JSObject()
+
+    // Note
+    private var note: String?
+
+    // Phones
+    private var phones: JSArray = JSArray()
+
+    // Emails
+    private var emails: JSArray = JSArray()
+
+    // URLs
+    private var urls: JSArray = JSArray()
+
+    // Postal Addresses
+    private var postalAddresses: JSArray = JSArray()
+
+    // Image
+    private var image: JSObject = JSObject()
+
+    init(_ contactId: String) {
+        self.contactId = contactId
+    }
+
+    static func getMimetype(_ data: Data) -> String {
+        var b: UInt8 = 0
+        data.copyBytes(to: &b, count: 1)
+        switch b {
+        case 0xFF:
+            return "image/jpeg"
+        default:
+            return "image/png"
+        }
+    }
+
+    static func getLabel(_ type: String?, _ rawType: String?) -> String? {
+        // On Android, a custom label is saved with `type` set to "custom" and a separate `label` attribute.
+        // On iOS, on the contrary, the custom value is just saved into the `type` attribute.
+
+        if type == "custom" {
+            return rawType
+        }
+
+        return nil
+    }
+
+    public func fillData(_ contact: CNContact) {
+        // Name
+        if contact.isKeyAvailable(CNContactGivenNameKey) {
+            let displayName = CNContactFormatter.string(from: contact, style: .fullName)
+            self.name["display"] = displayName
+            self.name["given"] = contact.givenName
+            self.name["middle"] = contact.middleName
+            self.name["family"] = contact.familyName
+            self.name["prefix"] = contact.namePrefix
+            self.name["suffix"] = contact.nameSuffix
+        }
+
+        // Organization
+        if contact.isKeyAvailable(CNContactJobTitleKey) {
+            self.organization["company"] = contact.organizationName
+            self.organization["jobTitle"] = contact.jobTitle
+            self.organization["department"] = contact.departmentName
+        }
+
+        // Birthday
+        if contact.isKeyAvailable(CNContactBirthdayKey) {
+            if let dateComponents = contact.birthday {
+                self.birthday["year"] = dateComponents.year
+                self.birthday["month"] = dateComponents.month
+                self.birthday["day"] = dateComponents.day
+            }
+        }
+
+        // Note
+        if contact.isKeyAvailable(CNContactNoteKey) {
+            self.note = contact.note
+        }
+
+        // Phones
+        if contact.isKeyAvailable(CNContactPhoneNumbersKey) {
+            self.phones = contact.phoneNumbers.map { phone in
+                let type = Contacts.phoneTypeMap.getKey(phone.label)
+
+                var phoneObject: JSObject = [
+                    "type": type,
+                    "number": phone.value.stringValue
+                ]
+
+                if let label = ContactPayload.getLabel(type, phone.label) {
+                    phoneObject["label"] = label
+                }
+
+                return phoneObject
+            }
+        }
+
+        // Emails
+        if contact.isKeyAvailable(CNContactEmailAddressesKey) {
+            self.emails = contact.emailAddresses.map { email in
+                let type = Contacts.emailTypeMap.getKey(email.label)
+
+                var emailObject: JSObject = [
+                    "type": type,
+                    "address": email.value as String
+                ]
+
+                if let label = ContactPayload.getLabel(type, email.label) {
+                    emailObject["label"] = label
+                }
+
+                return emailObject
+            }
+        }
+
+        // URLs
+        if contact.isKeyAvailable(CNContactUrlAddressesKey) {
+            self.urls = contact.urlAddresses.map { url in
+                return url.value as String
+            }
+        }
+
+        // Postal Addresses
+        if contact.isKeyAvailable(CNContactPostalAddressesKey) {
+            self.postalAddresses = contact.postalAddresses.map { postalAddress in
+                let type = Contacts.postalAddressTypeMap.getKey(postalAddress.label)
+                let formatted = CNPostalAddressFormatter.string(from: postalAddress.value, style: .mailingAddress)
+
+                var postalAddressObject: JSObject = [
+                    "type": type,
+                    "formatted": formatted,
+                    "street": postalAddress.value.street,
+                    "neighborhood": postalAddress.value.subAdministrativeArea,
+                    "city": postalAddress.value.city,
+                    "region": postalAddress.value.state,
+                    "postcode": postalAddress.value.postalCode,
+                    "country": postalAddress.value.country
+                ]
+
+                if let label = ContactPayload.getLabel(type, postalAddress.label) {
+                    postalAddressObject["label"] = label
+                }
+
+                return postalAddressObject
+            }
+        }
+
+        // Image
+        if contact.isKeyAvailable(CNContactImageDataKey) {
+            if let image = contact.imageData {
+                let mimeType = ContactPayload.getMimetype(image)
+                let encodedImage = image.base64EncodedString()
+                self.image["base64String"] = "data:\(mimeType);base64,\(encodedImage)"
+            }
+        }
+    }
+
+    public func getJSObject() -> JSObject {
+        var contact = JSObject()
+
+        // Id
+        contact["contactId"] = self.contactId
+
+        // Name
+        if self.name.count > 0 {
+            contact["name"] = self.name
+        }
+
+        // Organization
+        if self.organization.count > 0 {
+            contact["organization"] = self.organization
+        }
+
+        // Birthday
+        if self.birthday.count > 0 {
+            contact["birthday"] = self.birthday
+        }
+
+        // Note
+        if self.note != nil {
+            contact["note"] = self.note
+        }
+
+        // Phones
+        if self.phones.count > 0 {
+            contact["phones"] = self.phones
+        }
+
+        // Emails
+        if self.emails.count > 0 {
+            contact["emails"] = self.emails
+        }
+
+        // URLs
+        if self.urls.count > 0 {
+            contact["urls"] = self.urls
+        }
+
+        // Postal Addresses
+        if self.postalAddresses.count > 0 {
+            contact["postalAddresses"] = self.postalAddresses
+        }
+
+        // Image
+        if self.image.count > 0 {
+            contact["image"] = self.image
+        }
+
+        return contact
+    }
+}

package/ios/Plugin/Contacts.swift

@@ -0,0 +1,227 @@
+import Foundation
+import Contacts
+
+public class Contacts: NSObject {
+    public static let phoneTypeMap = BiMap<String, String>([
+        // Home / Work
+        "home": CNLabelHome,
+        "work": CNLabelWork,
+        // Other
+        "other": CNLabelOther,
+        // Custom
+        "custom": "custom",
+        // Phone specific
+        "main": CNLabelPhoneNumberMain,
+        "mobile": CNLabelPhoneNumberMobile,
+        "pager": CNLabelPhoneNumberPager,
+        "fax_home": CNLabelPhoneNumberHomeFax,
+        "fax_work": CNLabelPhoneNumberWorkFax,
+        "fax_other": CNLabelPhoneNumberOtherFax,
+        //
+        //
+        // iOS only:
+        // School
+        // "school": CNLabelSchool, // (iOS ^13.x.x only)
+        // Phone specific
+        // "apple_watch": CNLabelPhoneNumberAppleWatch, // (iOS ^14.3.x only)
+        "iphone": CNLabelPhoneNumberiPhone
+    ], "custom", "custom")
+
+    public static let emailTypeMap = BiMap<String, String>([
+        // Home / Work
+        "home": CNLabelHome,
+        "work": CNLabelWork,
+        // Other
+        "other": CNLabelOther,
+        // Custom
+        "custom": "custom",
+        //
+        //
+        // iOS only:
+        // School
+        // "school": CNLabelSchool, // (iOS ^13.x.x only)
+        // Email specific
+        "icloud": CNLabelEmailiCloud
+    ], "custom", "custom")
+
+    public static let postalAddressTypeMap = BiMap<String, String>([
+        // Home / Work
+        "home": CNLabelHome,
+        "work": CNLabelWork,
+        // Other
+        "other": CNLabelOther,
+        // Custom
+        "custom": "custom"
+        //
+        //
+        // iOS only:
+        // School
+        // "school": CNLabelSchool, // (iOS ^13.x.x only)
+    ], "custom", "custom")
+
+    public func getContact(_ contactId: String, _ projection: GetContactsProjectionInput) -> ContactPayload? {
+        let projection = projection.getProjection()
+
+        let cs = CNContactStore()
+
+        do {
+            let contactResult = try cs.unifiedContact(withIdentifier: contactId, keysToFetch: projection)
+
+            let contact = ContactPayload(contactId)
+
+            contact.fillData(contactResult)
+
+            return contact
+        } catch {
+            return nil
+        }
+    }
+
+    public func getContacts(_ projection: GetContactsProjectionInput) -> [ContactPayload] {
+        let projection = projection.getProjection()
+
+        var contacts = [ContactPayload]()
+
+        let cs = CNContactStore()
+
+        do {
+            let request = CNContactFetchRequest(keysToFetch: projection)
+
+            try cs.enumerateContacts(with: request) { (contactData, _) in
+                let contact = ContactPayload(contactData.identifier)
+
+                contact.fillData(contactData)
+
+                contacts.append(contact)
+            }
+        } catch {
+            // oops
+        }
+
+        return contacts
+    }
+
+    public func createContact(_ contactInput: CreateContactInput) -> String? {
+        let newContact = CNMutableContact()
+
+        // Name
+        if let nameGiven = contactInput.nameGiven {
+            newContact.givenName = nameGiven
+        }
+        if let nameMiddle = contactInput.nameMiddle {
+            newContact.middleName = nameMiddle
+        }
+        if let nameFamily = contactInput.nameFamily {
+            newContact.familyName = nameFamily
+        }
+        if let namePrefix = contactInput.namePrefix {
+            newContact.namePrefix = namePrefix
+        }
+        if let nameSuffix = contactInput.nameSuffix {
+            newContact.nameSuffix = nameSuffix
+        }
+
+        // Organization
+        if let organizationName = contactInput.organizationName {
+            newContact.organizationName = organizationName
+        }
+        if let organizationJobTitle = contactInput.organizationJobTitle {
+            newContact.jobTitle = organizationJobTitle
+        }
+        if let organizationDepartment = contactInput.organizationDepartment {
+            newContact.departmentName = organizationDepartment
+        }
+
+        // Birthday
+        if let birthday = contactInput.birthday {
+            newContact.birthday = birthday
+        }
+
+        // Note
+        if let note = contactInput.note {
+            newContact.note = note
+        }
+
+        // Phones
+        newContact.phoneNumbers = contactInput.phones.map { phone in
+            return CNLabeledValue(
+                label: phone.type,
+                value: CNPhoneNumber(stringValue: phone.number ?? "")
+            )
+        }
+
+        // Email
+        newContact.emailAddresses = contactInput.emails.map { email in
+            return CNLabeledValue(
+                label: email.type,
+                value: email.address as? NSString ?? ""
+            )
+        }
+
+        // URLs
+        newContact.urlAddresses = contactInput.urls.map { url in
+            return CNLabeledValue(
+                label: nil,
+                value: url as NSString
+            )
+        }
+
+        // Postal Addresses
+        newContact.postalAddresses = contactInput.postalAddresses.map({ postalAddress in
+            let address = CNMutablePostalAddress()
+            address.street = postalAddress.street ?? ""
+            address.subAdministrativeArea = postalAddress.neighborhood ?? ""
+            address.city = postalAddress.city ?? ""
+            address.state = postalAddress.region ?? ""
+            address.postalCode = postalAddress.postcode ?? ""
+            address.country = postalAddress.country ?? ""
+
+            return CNLabeledValue(
+                label: postalAddress.type,
+                value: address
+            )
+        })
+
+        // Image
+        if let image = contactInput.image {
+            if let base64String = image.base64String {
+                if let data = Data(base64Encoded: base64String, options: .ignoreUnknownCharacters) {
+                    newContact.imageData = data
+                }
+            }
+        }
+
+        do {
+            let cs = CNContactStore()
+            let saveRequest = CNSaveRequest()
+            saveRequest.add(newContact, toContainerWithIdentifier: nil)
+
+            try cs.execute(saveRequest)
+
+            if newContact.isKeyAvailable(CNContactIdentifierKey) {
+                return newContact.identifier
+            }
+
+            return nil
+        } catch {
+            return nil
+        }
+    }
+
+    public func deleteContact(_ contactId: String) -> Bool {
+        let cs = CNContactStore()
+
+        do {
+            let contactResult = try cs.unifiedContact(withIdentifier: contactId, keysToFetch: [CNContactIdentifierKey] as [CNKeyDescriptor])
+
+            let saveRequest = CNSaveRequest()
+            saveRequest.delete(contactResult.mutableCopy() as! CNMutableContact)
+
+            try cs.execute(saveRequest)
+
+            return true
+        } catch {
+            return false
+        }
+    }
+}

package/ios/Plugin/ContactsPlugin.h

@@ -0,0 +1,10 @@
+#import <UIKit/UIKit.h>
+
+//! Project version number for Plugin.
+FOUNDATION_EXPORT double PluginVersionNumber;
+
+//! Project version string for Plugin.
+FOUNDATION_EXPORT const unsigned char PluginVersionString[];
+
+// In this header, you should import all the public headers of your framework using statements like #import <Plugin/PublicHeader.h>
+

package/ios/Plugin/ContactsPlugin.m

@@ -0,0 +1,14 @@
+#import <Foundation/Foundation.h>
+#import <Capacitor/Capacitor.h>
+
+// Define the plugin using the CAP_PLUGIN Macro, and
+// each method the plugin supports using the CAP_PLUGIN_METHOD macro.
+CAP_PLUGIN(ContactsPlugin, "Contacts",
+           CAP_PLUGIN_METHOD(checkPermissions, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(requestPermissions, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(getContact, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(getContacts, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(createContact, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(deleteContact, CAPPluginReturnPromise);
+           CAP_PLUGIN_METHOD(pickContact, CAPPluginReturnPromise);
+)