@capgo/capacitor-contacts 7.1.1 → 8.0.1

package/ios/Sources/CapacitorContactsPlugin/CapacitorContactsPlugin.swift

@@ -1,9 +1,11 @@
 import Capacitor
 import Contacts
+import ContactsUI
 import UIKit
 
 @objc(CapacitorContactsPlugin)
 public class CapacitorContactsPlugin: CAPPlugin, CAPBridgedPlugin {
+    private let pluginVersion: String = "8.0.1"
     public let identifier = "CapacitorContactsPlugin"
     public let jsName = "CapacitorContacts"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -27,7 +29,8 @@ public class CapacitorContactsPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "pickContacts", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "updateContactById", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "checkPermissions", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise)
     ]
 
     private let contactStore = CNContactStore()
@@ -151,6 +154,10 @@ public class CapacitorContactsPlugin: CAPPlugin, CAPBridgedPlugin {
         }
     }
 
+    @objc func getPluginVersion(_ call: CAPPluginCall) {
+        call.resolve(["version": self.pluginVersion])
+    }
+
     @objc override public func checkPermissions(_ call: CAPPluginCall) {
         let status = authorizationStatus()
         call.resolve(status)
@@ -177,24 +184,284 @@ public class CapacitorContactsPlugin: CAPPlugin, CAPBridgedPlugin {
         })
     }
 
-    // MARK: - Not yet implemented operations
+    // MARK: - Write operations
+
+    @objc func createContact(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let contactData = options["contact"] as? JSObject else {
+            call.reject("Missing contact data.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            let newContact = CNMutableContact()
+            self.populateContact(newContact, from: contactData)
+
+            let saveRequest = CNSaveRequest()
+            saveRequest.add(newContact, toContainerWithIdentifier: nil)
 
-    private func notImplemented(_ call: CAPPluginCall) {
-        call.reject("Method not implemented yet.")
+            do {
+                try self.contactStore.execute(saveRequest)
+                call.resolve(["id": newContact.identifier])
+            } catch {
+                call.reject("Failed to create contact.", nil, error)
+            }
+        }
     }
 
-    @objc func createContact(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func createGroup(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func deleteContactById(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func deleteGroupById(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func displayContactById(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func displayCreateContact(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func displayUpdateContactById(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func getGroupById(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func getGroups(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func pickContact(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func pickContacts(_ call: CAPPluginCall) { notImplemented(call) }
-    @objc func updateContactById(_ call: CAPPluginCall) { notImplemented(call) }
+    @objc func updateContactById(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let identifier = options["id"] as? String,
+              let contactData = options["contact"] as? JSObject else {
+            call.reject("Missing contact identifier or data.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            do {
+                let keysToFetch: [CNKeyDescriptor] = [
+                    CNContactIdentifierKey as CNKeyDescriptor,
+                    CNContactGivenNameKey as CNKeyDescriptor,
+                    CNContactFamilyNameKey as CNKeyDescriptor,
+                    CNContactMiddleNameKey as CNKeyDescriptor,
+                    CNContactNamePrefixKey as CNKeyDescriptor,
+                    CNContactNameSuffixKey as CNKeyDescriptor,
+                    CNContactOrganizationNameKey as CNKeyDescriptor,
+                    CNContactJobTitleKey as CNKeyDescriptor,
+                    CNContactEmailAddressesKey as CNKeyDescriptor,
+                    CNContactPhoneNumbersKey as CNKeyDescriptor,
+                    CNContactPostalAddressesKey as CNKeyDescriptor,
+                    CNContactUrlAddressesKey as CNKeyDescriptor,
+                    CNContactBirthdayKey as CNKeyDescriptor,
+                    CNContactNoteKey as CNKeyDescriptor,
+                    CNContactImageDataKey as CNKeyDescriptor
+                ]
+
+                let contact = try self.contactStore.unifiedContact(withIdentifier: identifier, keysToFetch: keysToFetch)
+                let mutableContact = contact.mutableCopy() as! CNMutableContact
+
+                self.populateContact(mutableContact, from: contactData)
+
+                let saveRequest = CNSaveRequest()
+                saveRequest.update(mutableContact)
+
+                try self.contactStore.execute(saveRequest)
+                call.resolve()
+            } catch {
+                call.reject("Failed to update contact.", nil, error)
+            }
+        }
+    }
+
+    @objc func deleteContactById(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let identifier = options["id"] as? String else {
+            call.reject("Missing contact identifier.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            do {
+                let keysToFetch: [CNKeyDescriptor] = [CNContactIdentifierKey as CNKeyDescriptor]
+                let contact = try self.contactStore.unifiedContact(withIdentifier: identifier, keysToFetch: keysToFetch)
+                let mutableContact = contact.mutableCopy() as! CNMutableContact
+
+                let saveRequest = CNSaveRequest()
+                saveRequest.delete(mutableContact)
+
+                try self.contactStore.execute(saveRequest)
+                call.resolve()
+            } catch {
+                call.reject("Failed to delete contact.", nil, error)
+            }
+        }
+    }
+
+    // MARK: - Group operations
+
+    @objc func getGroups(_ call: CAPPluginCall) {
+        ensureAuthorized(call) {
+            do {
+                let groups = try self.contactStore.groups(matching: nil)
+                let serialized: [JSObject] = groups.map { group in
+                    var result: JSObject = [:]
+                    result["id"] = group.identifier
+                    result["name"] = group.name
+                    return result
+                }
+                call.resolve(["groups": serialized])
+            } catch {
+                call.reject("Failed to fetch groups.", nil, error)
+            }
+        }
+    }
+
+    @objc func getGroupById(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let identifier = options["id"] as? String else {
+            call.reject("Missing group identifier.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            do {
+                let groups = try self.contactStore.groups(matching: nil)
+                if let group = groups.first(where: { $0.identifier == identifier }) {
+                    var result: JSObject = [:]
+                    result["id"] = group.identifier
+                    result["name"] = group.name
+                    call.resolve(["group": result])
+                } else {
+                    call.resolve(["group": nil])
+                }
+            } catch {
+                call.reject("Failed to fetch group.", nil, error)
+            }
+        }
+    }
+
+    @objc func createGroup(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let groupData = options["group"] as? JSObject,
+              let name = groupData["name"] as? String else {
+            call.reject("Missing group name.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            let newGroup = CNMutableGroup()
+            newGroup.name = name
+
+            let saveRequest = CNSaveRequest()
+            saveRequest.add(newGroup, toContainerWithIdentifier: nil)
+
+            do {
+                try self.contactStore.execute(saveRequest)
+                call.resolve(["id": newGroup.identifier])
+            } catch {
+                call.reject("Failed to create group.", nil, error)
+            }
+        }
+    }
+
+    @objc func deleteGroupById(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let identifier = options["id"] as? String else {
+            call.reject("Missing group identifier.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            do {
+                let groups = try self.contactStore.groups(matching: nil)
+                if let group = groups.first(where: { $0.identifier == identifier }) {
+                    let mutableGroup = group.mutableCopy() as! CNMutableGroup
+                    let saveRequest = CNSaveRequest()
+                    saveRequest.delete(mutableGroup)
+                    try self.contactStore.execute(saveRequest)
+                    call.resolve()
+                } else {
+                    call.reject("Group not found.")
+                }
+            } catch {
+                call.reject("Failed to delete group.", nil, error)
+            }
+        }
+    }
+
+    // MARK: - UI picker and display operations
+
+    private var currentPickerCall: CAPPluginCall?
+
+    @objc func pickContact(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            self.currentPickerCall = call
+            let picker = CNContactPickerViewController()
+            picker.delegate = self
+            self.bridge?.viewController?.present(picker, animated: true)
+        }
+    }
+
+    @objc func pickContacts(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            self.currentPickerCall = call
+            let picker = CNContactPickerViewController()
+            picker.delegate = self
+            self.bridge?.viewController?.present(picker, animated: true)
+        }
+    }
+
+    @objc func displayContactById(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let identifier = options["id"] as? String else {
+            call.reject("Missing contact identifier.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            do {
+                let keysToFetch = self.keysToFetch(for: nil)
+                let contact = try self.contactStore.unifiedContact(withIdentifier: identifier, keysToFetch: keysToFetch)
+
+                DispatchQueue.main.async {
+                    let viewController = CNContactViewController(for: contact)
+                    viewController.allowsEditing = false
+                    let navController = UINavigationController(rootViewController: viewController)
+                    self.bridge?.viewController?.present(navController, animated: true)
+                    call.resolve()
+                }
+            } catch {
+                call.reject("Failed to display contact.", nil, error)
+            }
+        }
+    }
+
+    @objc func displayCreateContact(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            let newContact = CNMutableContact()
+
+            if let options = call.options["options"] as? JSObject,
+               let contactData = options["contact"] as? JSObject {
+                self.populateContact(newContact, from: contactData)
+            }
+
+            let viewController = CNContactViewController(forNewContact: newContact)
+            viewController.delegate = self
+            viewController.contactStore = self.contactStore
+
+            let navController = UINavigationController(rootViewController: viewController)
+            self.currentPickerCall = call
+            self.bridge?.viewController?.present(navController, animated: true)
+        }
+    }
+
+    @objc func displayUpdateContactById(_ call: CAPPluginCall) {
+        guard let options = call.options["options"] as? JSObject,
+              let identifier = options["id"] as? String else {
+            call.reject("Missing contact identifier.")
+            return
+        }
+
+        ensureAuthorized(call) {
+            do {
+                let keysToFetch = self.keysToFetch(for: nil)
+                let contact = try self.contactStore.unifiedContact(withIdentifier: identifier, keysToFetch: keysToFetch)
+
+                DispatchQueue.main.async {
+                    let mutableContact = contact.mutableCopy() as! CNMutableContact
+                    let viewController = CNContactViewController(for: mutableContact)
+                    viewController.allowsEditing = true
+                    viewController.contactStore = self.contactStore
+
+                    let navController = UINavigationController(rootViewController: viewController)
+                    self.bridge?.viewController?.present(navController, animated: true)
+                    call.resolve()
+                }
+            } catch {
+                call.reject("Failed to display contact for editing.", nil, error)
+            }
+        }
+    }
 
     // MARK: - Helpers
 
@@ -512,4 +779,230 @@ public class CapacitorContactsPlugin: CAPPlugin, CAPBridgedPlugin {
             return "unknown"
         }
     }
+
+    private func populateContact(_ contact: CNMutableContact, from data: JSObject) {
+        if let givenName = data["givenName"] as? String {
+            contact.givenName = givenName
+        }
+        if let familyName = data["familyName"] as? String {
+            contact.familyName = familyName
+        }
+        if let middleName = data["middleName"] as? String {
+            contact.middleName = middleName
+        }
+        if let namePrefix = data["namePrefix"] as? String {
+            contact.namePrefix = namePrefix
+        }
+        if let nameSuffix = data["nameSuffix"] as? String {
+            contact.nameSuffix = nameSuffix
+        }
+        if let organizationName = data["organizationName"] as? String {
+            contact.organizationName = organizationName
+        }
+        if let jobTitle = data["jobTitle"] as? String {
+            contact.jobTitle = jobTitle
+        }
+        if let note = data["note"] as? String {
+            contact.note = note
+        }
+
+        if let emailAddresses = data["emailAddresses"] as? [[String: Any]] {
+            contact.emailAddresses = emailAddresses.compactMap { emailData in
+                guard let value = emailData["value"] as? String else { return nil }
+                let label = emailData["type"] as? String ?? "OTHER"
+                let cnLabel = reverseMapEmailLabel(label, customLabel: emailData["label"] as? String)
+                return CNLabeledValue(label: cnLabel, value: value as NSString)
+            }
+        }
+
+        if let phoneNumbers = data["phoneNumbers"] as? [[String: Any]] {
+            contact.phoneNumbers = phoneNumbers.compactMap { phoneData in
+                guard let value = phoneData["value"] as? String else { return nil }
+                let label = phoneData["type"] as? String ?? "OTHER"
+                let cnLabel = reverseMapPhoneLabel(label, customLabel: phoneData["label"] as? String)
+                return CNLabeledValue(label: cnLabel, value: CNPhoneNumber(stringValue: value))
+            }
+        }
+
+        if let postalAddresses = data["postalAddresses"] as? [[String: Any]] {
+            contact.postalAddresses = postalAddresses.compactMap { addressData in
+                let postalAddress = CNMutablePostalAddress()
+                if let street = addressData["street"] as? String {
+                    postalAddress.street = street
+                }
+                if let city = addressData["city"] as? String {
+                    postalAddress.city = city
+                }
+                if let state = addressData["state"] as? String {
+                    postalAddress.state = state
+                }
+                if let postalCode = addressData["postalCode"] as? String {
+                    postalAddress.postalCode = postalCode
+                }
+                if let country = addressData["country"] as? String {
+                    postalAddress.country = country
+                }
+                if let isoCountryCode = addressData["isoCountryCode"] as? String {
+                    postalAddress.isoCountryCode = isoCountryCode
+                }
+                let label = addressData["type"] as? String ?? "OTHER"
+                let cnLabel = reverseMapPostalLabel(label, customLabel: addressData["label"] as? String)
+                return CNLabeledValue(label: cnLabel, value: postalAddress)
+            }
+        }
+
+        if let urlAddresses = data["urlAddresses"] as? [[String: Any]] {
+            contact.urlAddresses = urlAddresses.compactMap { urlData in
+                guard let value = urlData["value"] as? String else { return nil }
+                let label = urlData["type"] as? String ?? "OTHER"
+                let cnLabel = reverseMapURLLabel(label, customLabel: urlData["label"] as? String)
+                return CNLabeledValue(label: cnLabel, value: value as NSString)
+            }
+        }
+
+        if let birthdayData = data["birthday"] as? [String: Any] {
+            var dateComponents = DateComponents()
+            if let day = birthdayData["day"] as? Int {
+                dateComponents.day = day
+            }
+            if let month = birthdayData["month"] as? Int {
+                dateComponents.month = month
+            }
+            if let year = birthdayData["year"] as? Int {
+                dateComponents.year = year
+            }
+            contact.birthday = dateComponents
+        }
+
+        if let photoBase64 = data["photo"] as? String,
+           let photoData = Data(base64Encoded: photoBase64) {
+            contact.imageData = photoData
+        }
+    }
+
+    private func reverseMapEmailLabel(_ type: String, customLabel: String?) -> String {
+        switch type {
+        case "HOME":
+            return CNLabelHome
+        case "WORK":
+            return CNLabelWork
+        case "ICLOUD":
+            return CNLabelEmailiCloud
+        case "OTHER":
+            return CNLabelOther
+        case "CUSTOM":
+            return customLabel ?? CNLabelOther
+        default:
+            return CNLabelOther
+        }
+    }
+
+    private func reverseMapPhoneLabel(_ type: String, customLabel: String?) -> String {
+        switch type {
+        case "MOBILE":
+            return CNLabelPhoneNumberMobile
+        case "IPHONE":
+            return CNLabelPhoneNumberiPhone
+        case "MAIN":
+            return CNLabelPhoneNumberMain
+        case "HOME_FAX":
+            return CNLabelPhoneNumberHomeFax
+        case "WORK_FAX":
+            return CNLabelPhoneNumberWorkFax
+        case "OTHER_FAX":
+            return CNLabelPhoneNumberOtherFax
+        case "PAGER":
+            return CNLabelPhoneNumberPager
+        case "HOME":
+            return CNLabelHome
+        case "WORK":
+            return CNLabelWork
+        case "OTHER":
+            return CNLabelOther
+        case "CUSTOM":
+            return customLabel ?? CNLabelOther
+        default:
+            return CNLabelOther
+        }
+    }
+
+    private func reverseMapPostalLabel(_ type: String, customLabel: String?) -> String {
+        switch type {
+        case "HOME":
+            return CNLabelHome
+        case "WORK":
+            return CNLabelWork
+        case "OTHER":
+            return CNLabelOther
+        case "CUSTOM":
+            return customLabel ?? CNLabelOther
+        default:
+            return CNLabelOther
+        }
+    }
+
+    private func reverseMapURLLabel(_ type: String, customLabel: String?) -> String {
+        switch type {
+        case "HOMEPAGE":
+            return CNLabelURLAddressHomePage
+        case "HOME":
+            return CNLabelHome
+        case "WORK":
+            return CNLabelWork
+        case "OTHER":
+            return CNLabelOther
+        case "CUSTOM":
+            return customLabel ?? CNLabelOther
+        default:
+            return CNLabelOther
+        }
+    }
+}
+
+// MARK: - CNContactPickerDelegate
+
+extension CapacitorContactsPlugin: CNContactPickerDelegate {
+    public func contactPicker(_ picker: CNContactPickerViewController, didSelect contacts: [CNContact]) {
+        guard let call = currentPickerCall else { return }
+        currentPickerCall = nil
+
+        let includeGroupIds = true
+        var membership: [String: [String]] = [:]
+        let contactIds = contacts.map(\.identifier)
+        membership = groupMembershipMap(for: contactIds)
+
+        let serialized = contacts.map { serialize(contact: $0, fields: nil, membership: membership) }
+        call.resolve(["contacts": serialized])
+    }
+
+    public func contactPicker(_ picker: CNContactPickerViewController, didSelect contact: CNContact) {
+        guard let call = currentPickerCall else { return }
+        currentPickerCall = nil
+
+        let membership = groupMembershipMap(for: [contact.identifier])
+        let serialized = serialize(contact: contact, fields: nil, membership: membership)
+        call.resolve(["contacts": [serialized]])
+    }
+
+    public func contactPickerDidCancel(_ picker: CNContactPickerViewController) {
+        guard let call = currentPickerCall else { return }
+        currentPickerCall = nil
+        call.resolve(["contacts": []])
+    }
+}
+
+// MARK: - CNContactViewControllerDelegate
+
+extension CapacitorContactsPlugin: CNContactViewControllerDelegate {
+    public func contactViewController(_ viewController: CNContactViewController, didCompleteWith contact: CNContact?) {
+        viewController.dismiss(animated: true)
+        guard let call = currentPickerCall else { return }
+        currentPickerCall = nil
+
+        if let contact = contact {
+            call.resolve(["id": contact.identifier])
+        } else {
+            call.resolve([:])
+        }
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-contacts",
-  "version": "7.1.1",
+  "version": "8.0.1",
   "description": "Work with device contacts using Capacitor APIs",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -16,7 +16,7 @@
     "CapgoCapacitorContacts.podspec"
   ],
   "author": "Cap-go <contact@capgo.app>",
-  "license": "MIT",
+  "license": "MPL-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Cap-go/capacitor-contacts.git"
@@ -51,27 +51,27 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@capacitor/android": "^7.0.0",
-    "@capacitor/cli": "^7.0.0",
-    "@capacitor/core": "^7.0.0",
-    "@capacitor/docgen": "^0.3.0",
-    "@capacitor/ios": "^7.0.0",
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/cli": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.1",
+    "@capacitor/ios": "^8.0.0",
     "@ionic/eslint-config": "^0.4.0",
     "@ionic/prettier-config": "^4.0.0",
     "@ionic/swiftlint-config": "^2.0.0",
-    "@types/node": "^22.13.1",
-    "eslint": "^8.57.0",
+    "@types/node": "^24.10.1",
+    "eslint": "^8.57.1",
     "eslint-plugin-import": "^2.31.0",
     "husky": "^9.1.7",
-    "prettier": "^3.4.2",
-    "prettier-plugin-java": "^2.6.7",
-    "rimraf": "^6.0.1",
-    "rollup": "^4.34.6",
+    "prettier": "^3.6.2",
+    "prettier-plugin-java": "^2.7.7",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.53.2",
     "swiftlint": "^2.0.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@capacitor/core": ">=7.0.0"
+    "@capacitor/core": ">=8.0.0"
   },
   "eslintConfig": {
     "extends": "@ionic/eslint-config/recommended"