{"_id":"@calvinckho/capacitor-contact-picker","_rev":"4-a8d28283280e67fdb5393748a37ee107","name":"@calvinckho/capacitor-contact-picker","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@calvinckho/capacitor-contact-picker","version":"1.0.0","description":"Allows users to select a single contact from their device.","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"author":{"name":"Calvin Ho"},"license":"MIT","dependencies":{"@capacitor/cli":"^2.0.2","@capacitor/core":"latest"},"devDependencies":{"@capacitor/android":"latest","@capacitor/ios":"latest","rimraf":"^3.0.0","typescript":"^3.2.4"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/calvinckho/capacitor-contact-picker.git"},"bugs":{"url":"https://github.com/calvinckho/capacitor-contact-picker/issues"},"gitHead":"97d567353b5db98bac607c4c621d19bee2c28a9e","homepage":"https://github.com/calvinckho/capacitor-contact-picker#readme","_id":"@calvinckho/capacitor-contact-picker@1.0.0","_nodeVersion":"12.19.0","_npmVersion":"6.14.8","dist":{"integrity":"sha512-Ry8Jm3pTZZgMMyP0My0/XGIWkcw/UgUtgWS30kz2bRTJ6zsncvaEP1ykozdyf/5yk8hbNwzoL96FcXEoTfcsWQ==","shasum":"11a8b6a3e76db8902af85c5d417c5a1a2337ca7e","tarball":"https://registry.npmjs.org/@calvinckho/capacitor-contact-picker/-/capacitor-contact-picker-1.0.0.tgz","fileCount":94,"unpackedSize":270906,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFRpYIJbwUxeeqaSGkymIc1owxfHhatB9LOt0gichMLCAiArWYHAXwldF0FM08bJfZruGsvO1oX3FMpVcMhRdusf9w=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiVSvGACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmodbg//bRG5FJH44jxBthfDB6iBK46jkn8XwBHAl7HiQsbmijE4hQdK\r\n81F0k2x0p4yla2x8EexfOVp2+pJb1ad5FVHQ9WyKJ4HI6IHNkLpoNjuSDn0i\r\nNkcRvMfypFgpEtITrcB7YBsFgF1poRenBqCbBuyTDy2u0m9R6/zsC2bAllrI\r\nodJqUSHqLSlM94zKrsn4p5U2Lxf/u6pD7luPoy+q+MTo+rVKawwsnMGVBowh\r\nZ79u9r2pPnH0tVxFNqnBKEdJjtAHsadhLAcIzi2WEJTIlCYBa5zd4Xf3jcdT\r\nso10NlqVj4+IN3uYYkbkP//nSjWLeBgP8l+4WtyzuBC4RnBhxYSBAPl7Mxaf\r\n5vqiZxoJOh2wgR20uok3ZuNtXW4EVlTK0WEtc0DHFdBl6YLYW1iIPuwtmEvn\r\ngvSDmNVTsZ/rosVijBlTO7eRKKc2MmDGqDTkaJrDobIBhamihJPqCRNHenkG\r\ndcac5/iamJU91W/gt4+UHt+0h9Gz8hH8MXuohcHkMmg7suIbN7J6sRTBivfV\r\nvahM/iwUTf9y6LAwV5Xwl2sKhqQXTt7pBrOA3gIockAmLo1Tv5VtsSv6BfVm\r\nb/8hUZLnejHO9ftgVie9s1GQRA4ZfxfWDKD+CUSTj0To+WNsoC2HFh7yI1TT\r\nGLAMU54sZTwcRq14T3tC8IJtHDdY4vRUtHQ=\r\n=9RPJ\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"calvinckho","email":"ch235@cornell.edu"},"directories":{},"maintainers":[{"name":"calvinckho","email":"ch235@cornell.edu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contact-picker_1.0.0_1649748933949_0.6290784793378021"},"_hasShrinkwrap":false},"1.0.1":{"name":"@calvinckho/capacitor-contact-picker","version":"1.0.1","description":"Allows users to select a single contact from their device.","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"author":{"name":"Calvin Ho"},"license":"MIT","dependencies":{"@capacitor/cli":"^2.0.2","@capacitor/core":"latest"},"devDependencies":{"@capacitor/android":"latest","@capacitor/ios":"latest","rimraf":"^3.0.0","typescript":"^3.2.4"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/calvinckho/capacitor-contact-picker.git"},"bugs":{"url":"https://github.com/calvinckho/capacitor-contact-picker/issues"},"gitHead":"dbdd35c6fd59c618b71f1bddaab5b07778654193","homepage":"https://github.com/calvinckho/capacitor-contact-picker#readme","_id":"@calvinckho/capacitor-contact-picker@1.0.1","_nodeVersion":"12.19.0","_npmVersion":"6.14.8","dist":{"integrity":"sha512-GZTzPcPfS0emHjDex0Gngo+7RkudSccaYQIASwWMDEB3gR+z8RM0UGnfDH55A6gPQAJ5xTLuyXsEPlUMEbin0A==","shasum":"2ce759ac1ab48591bf559d5a7f67783d315b620e","tarball":"https://registry.npmjs.org/@calvinckho/capacitor-contact-picker/-/capacitor-contact-picker-1.0.1.tgz","fileCount":94,"unpackedSize":270887,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIH7x35BOJwX5ISvU/uZJRuFUPYpIJUiZb7hbpkguEi0oAiBrcYzJzFMYFCDQyU2abaZtSNgxE6/09PWAC1iqrHMY7w=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiVS5fACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrwPg/+Oyc2KLGaqbVURMvrRCmaMr69DzU/hNOD6TI2IdNcWkFmSfKX\r\n8rwMCMTcF4KGXnzSt/isGUZXe64jpG7pvnB9Q22cj5VeAkgyn6HaOgCo2X/0\r\nhZ1hBYiojDwa08fU/1FOROWEu1Qx+Jbg2mQb8IucFP5uBBUwkFZH2CZB1Elf\r\nLSgClyAOzQ2TlJNOtB6yPf8yUAAXR3lKSZDiZZ44siulQlEnLwnp2rijYUKo\r\nWLRdYMChEGwJQyfV2yGuFTZ0Xl0l3C3xDUPp+Mf9SnKsDakkrnBBT8CQ7tIh\r\nJlrmJxhJvrd+XY8RzVpswNVRpzn+00hTXMFdzdSzUzJdFMFjEYmYLv91SVQz\r\n+fvM5H2fn2KgwrZXyLnpkNS3a8TLRVgkXmO2giQtu/pBkaL4iWDSiy5JK9wx\r\nLRJTT4lX/+dOMMtWMMdA1y1qfCexz72va+5cdBHidwtiR437YnlzWFRdUhYB\r\nQGuVgn+WNzjrcZ3ZlprZEz5DdpEduHLkCUz/k/1EKUEXDE9YXJp/jsd9OTTT\r\nSTruSFdq4V0e1BiOc3FXfoMdk6pAG0RJNNAzM7TcE++fnmH3vXNN89aAjczG\r\nwBxS0NInWcva0RAKymgKnojrM8QTWHcsWH2W1vsxEecnQRX8GOQMskuLW3fn\r\n3n7zKDi2FsM9EzHdyKS5+yQYsjiK/HgFRO4=\r\n=qYv8\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"calvinckho","email":"ch235@cornell.edu"},"directories":{},"maintainers":[{"name":"calvinckho","email":"ch235@cornell.edu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contact-picker_1.0.1_1649749599563_0.34614676672195976"},"_hasShrinkwrap":false},"1.0.2":{"name":"@calvinckho/capacitor-contact-picker","version":"1.0.2","description":"Allows users to select a single contact from their device.","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"author":{"name":"Calvin Ho"},"license":"MIT","dependencies":{"@capacitor/cli":"^2.0.2","@capacitor/core":"latest"},"devDependencies":{"@capacitor/android":"latest","@capacitor/ios":"latest","rimraf":"^3.0.0","typescript":"^3.2.4"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/calvinckho/capacitor-contact-picker.git"},"bugs":{"url":"https://github.com/calvinckho/capacitor-contact-picker/issues"},"gitHead":"cde8a8523c52e60d245c6f81b7bbb447f2a033c1","homepage":"https://github.com/calvinckho/capacitor-contact-picker#readme","_id":"@calvinckho/capacitor-contact-picker@1.0.2","_nodeVersion":"12.19.0","_npmVersion":"6.14.8","dist":{"integrity":"sha512-A+7SAjwITGkxG9qYj/uj6jfcs9QfuGelh4JRXah8xSo4NjfzqZbUb9ZYRFd+hnb1Gn0P8YNz2em3jNlzLqofaA==","shasum":"19407a8133d5d8131db420cb8828041590395f80","tarball":"https://registry.npmjs.org/@calvinckho/capacitor-contact-picker/-/capacitor-contact-picker-1.0.2.tgz","fileCount":94,"unpackedSize":270895,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCVh5XnHxf8bbWx3QrH2E5F6GQ3z2lxnlbM4oBYJ5Nc5wIgc93q9r35w9WFC6f+dX4tCqJM6HeXO2xjKvW9tYBo9K8="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiVdeGACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmpNYg//TJABf1ocUz6Et2rCaeonv+aHIVjXKY/JtQ6k56Ub0xLENb/u\r\nH00to8yULXUI6Z23ce6QZr50AGMCOX7VVfOuNYLT7pQE/+4e8XOiRQYiyBVg\r\nncjnuF8PqhyRAeRuMEXX2oXkcmRrq5tXyi6ik6vz5EUE1rzeHqKVV+C/SOcu\r\n2jPktFmxR23VPB01HC5QOktrbNivzPDJrHg70yPoNjHCWNxaAPeSvztN2epY\r\nwboB78Kh1JgE6OM2462M2VSPb/AyoDcbJ13j98s5EKhrvnmR5FpO0p4O65Si\r\nv5LAkG1xMJuIb31nVE/cw2waLD4icuhjTq9XkFMHFdTA04Fjj3vT+iYiaut+\r\nKNQNpHNbdZgJ8RFTmFEdASotHjpP9QNmlhd8LJhnHs6ltYobCQwPZ+zT58jm\r\n6vxuPmlwWza8KydJdvE9m+WFat8i0HX3JbpIPHY16hf7EYQrCrzUaq0S0blV\r\ntZWFzgSFkfriYOhp+clZAFOw2sQfeJpMkpOV17m7z5P0uqo1veyvfavvBCwO\r\nesJKHC5QAi+/IWnFIdkkSzAgaK6sRm+7rL2JYY1uOWJO9dNiu91/FOGO/sW1\r\n3ewZdszhnroeIlk+B6hiJ/09KSv+qclrhhH1i/2+59/+LPqBwcK8qGEOeXep\r\nuA4PGOwDZJrOGM58Qi0oT9S+gQ4xUwdhxbs=\r\n=XRX+\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"calvinckho","email":"ch235@cornell.edu"},"directories":{},"maintainers":[{"name":"calvinckho","email":"ch235@cornell.edu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contact-picker_1.0.2_1649792901909_0.6238660109014735"},"_hasShrinkwrap":false},"1.0.3":{"name":"@calvinckho/capacitor-contact-picker","version":"1.0.3","description":"Allows users to select a single contact from their device.","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"author":{"name":"Calvin Ho"},"license":"MIT","dependencies":{"@capacitor/cli":"^5.0.0","@capacitor/core":"^5.0.0"},"devDependencies":{"@capacitor/android":"^5.0.0","@capacitor/ios":"^5.0.0","rimraf":"^3.0.0","typescript":"^5.3.3"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/calvinckho/capacitor-contact-picker.git"},"bugs":{"url":"https://github.com/calvinckho/capacitor-contact-picker/issues"},"gitHead":"da1f751128590fe3c1d6193db0e059e2d5c29b99","homepage":"https://github.com/calvinckho/capacitor-contact-picker#readme","_id":"@calvinckho/capacitor-contact-picker@1.0.3","_nodeVersion":"16.20.2","_npmVersion":"8.19.4","dist":{"integrity":"sha512-rx0aW4JCK503vXuOfy+tlHrF47uWgLl2j112jLaa6PIy5sR4bmBVv0HkCIN+9mPIDLJZdAtFGzG1FuDxtvSLqA==","shasum":"293df2a79dd8a99fcac5d21bfaf51fba3d921e06","tarball":"https://registry.npmjs.org/@calvinckho/capacitor-contact-picker/-/capacitor-contact-picker-1.0.3.tgz","fileCount":109,"unpackedSize":403183,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICBQzMJdX/Kw2JqljuHHqrTKGovWnQDwPN3xqtboN2QyAiBpOQKV7AWYtdS26YMYpnDZWhI1pLi6zN4rOr1l2Qq6+g=="}]},"_npmUser":{"name":"calvinckho","email":"ch235@cornell.edu"},"directories":{},"maintainers":[{"name":"calvinckho","email":"ch235@cornell.edu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contact-picker_1.0.3_1702679558601_0.2058352941921069"},"_hasShrinkwrap":false},"1.0.4":{"name":"@calvinckho/capacitor-contact-picker","version":"1.0.4","description":"Allows users to select a single contact from their device.","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"author":{"name":"Calvin Ho"},"license":"MIT","dependencies":{"@capacitor/cli":"^5.0.0","@capacitor/core":"^5.0.0"},"devDependencies":{"@capacitor/android":"^5.0.0","@capacitor/ios":"^5.0.0","rimraf":"^3.0.0","typescript":"^5.3.3"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/calvinckho/capacitor-contact-picker.git"},"bugs":{"url":"https://github.com/calvinckho/capacitor-contact-picker/issues"},"gitHead":"5b8ed254564eb63ad2c90f9a22c66f07a1ce8f5a","homepage":"https://github.com/calvinckho/capacitor-contact-picker#readme","_id":"@calvinckho/capacitor-contact-picker@1.0.4","_nodeVersion":"16.20.2","_npmVersion":"8.19.4","dist":{"integrity":"sha512-ME/8ZtAwXVlhaX1iy75SRvAlMNQTUpxkOlwCc5XSUADURvpbHyLec0nVeGs01+nA+9fubN2nxefV71V0JZaTTQ==","shasum":"9c9a03c5772aa8aa104d2ef55b134bf5c9ec5ce3","tarball":"https://registry.npmjs.org/@calvinckho/capacitor-contact-picker/-/capacitor-contact-picker-1.0.4.tgz","fileCount":109,"unpackedSize":403183,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCpaLIzgZPSwlhhS6da3kKRUyfPgjZPYeyVXj2KEcP2pwIhAP9tAX+dX4tZPWAIbH+zHBzredc4Q6kidq2VQbG3k2dG"}]},"_npmUser":{"name":"calvinckho","email":"ch235@cornell.edu"},"directories":{},"maintainers":[{"name":"calvinckho","email":"ch235@cornell.edu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contact-picker_1.0.4_1702932108231_0.7617397063640909"},"_hasShrinkwrap":false}},"time":{"created":"2022-04-12T07:35:33.893Z","1.0.0":"2022-04-12T07:35:34.080Z","modified":"2023-12-18T20:41:48.678Z","1.0.1":"2022-04-12T07:46:39.703Z","1.0.2":"2022-04-12T19:48:22.067Z","1.0.3":"2023-12-15T22:32:38.874Z","1.0.4":"2023-12-18T20:41:48.496Z"},"maintainers":[{"name":"calvinckho","email":"ch235@cornell.edu"}],"description":"Allows users to select a single contact from their device.","homepage":"https://github.com/calvinckho/capacitor-contact-picker#readme","keywords":["capacitor","plugin","native"],"repository":{"type":"git","url":"git+https://github.com/calvinckho/capacitor-contact-picker.git"},"author":{"name":"Calvin Ho"},"bugs":{"url":"https://github.com/calvinckho/capacitor-contact-picker/issues"},"license":"MIT","readme":"

\n \n

\n\n# @calvinckho/capacitor-contact-picker\n\n\n\nThis 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. This project is a fork of [TeamMaestro's plugin](https://github.com/TeamMaestro/capacitor-contact-picker) made for Capacitor 2. The current repo supports Capacitor 5.\n\n## Installation\n\nInstall from NPM (release build):\n```\nnpm install @calvinckho/capacitor-contact-picker\n```\nInstall from Github. Make sure you insert the branch name at the end:\n```\nnpm i git+ssh://git@github.com:calvinckho/capacitor-contact-picker#[branch name]\n```\n\n### iOS\n\nFor iOS you need to set a usage description in your info.plist file. (Privacy Setting)\nOpen xCode search for your info.plist file and press the tiny \"+\". Add the following entry:\n\n```\nPrivacy - Contacts Usage Description\n```\n\nGive it a value like:\n\n```\n\"We need access to your contacts in order to do something.\"\n```\n\nAlso, on iOS it is a best practice to ask for permission twice. See [here](https://blog.prototypr.io/3-best-practices-for-in-app-permissions-dce7d36544a4). \n\n### Android\nAdd users permission in `AndroidManifest.xml`:\n```\n\n+ \n \n```\n\n## Capacitor 3+ Usage\n```ts\nimport { ContactPicker } from '@calvinckho/capacitor-contact-picker';\n\ntry {\n const contact: any = await ContactPicker.open();\n /* method returns a JSON contact object or undefined if no contact was selected\n sample contact object:\n {\n \"displayName\":\"John Appleseed\",\n \"contactId\":\"410FE041-5C4E-48DA-B4DE-04C15EA3DBAC\",\n \"organizationName\":\"\",\n \"jobTitle\":\"\",\n \"emailAddresses\":[{\"type\":\"work\",\"emailAddress\":\"John-Appleseed@mac.com\"}],\n \"givenName\":\"John\",\n \"note\":\"College roommate\",\n \"phoneNumbers\":[{\"type\":\"mobile\",\"phoneNumber\":\"888-555-5512\"},{\"type\":\"home\",\"phoneNumber\":\"888-555-1212\"}],\n \"familyName\":\"Appleseed\",\n \"postalAddresses\":[{\"postalCode\":\"30303\",\"street\":\"3494 Kuhl Avenue\",\"formattedAddress\":\"3494 Kuhl Avenue\\nAtlanta GA 30303\\nUSA\",\"type\":\"work\",\"state\":\"GA\",\"city\":\"Atlanta\",\"country\":\"USA\",\"isoCountryCode\":\"us\"},{\"city\":\"Atlanta\",\"street\":\"1234 Laurel Street\",\"formattedAddress\":\"1234 Laurel Street\\nAtlanta GA 30303\\nUSA\",\"type\":\"home\",\"state\":\"GA\",\"postalCode\":\"30303\",\"country\":\"USA\",\"isoCountryCode\":\"us\"}],\n \"departmentName\":\"\",\n \"nickname\":\"\"\n }*/\n} catch(err) {\n // handle method rejection when permission is not granted\n}\n\n```\n### Returned Object Properties:\n```\nexport interface Contact {\n identifier?: string;\n androidContactLookupKey?: string; // Android only\n contactId?: string; // iOS only\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 emailAddresses: [{\n type: String,\n emailAddress: String,\n }]\n phoneNumbers: [{\n type: String,\n phoneNumber: String,\n }]\n postalAddresses: [{\n type: String,\n formattedAddress: String,\n street: String,\n pobox: String, // Android only\n neighborhood: String, // Android only\n city: String,\n state: String,\n postalCode: String,\n country: String,\n isoCountryCode: String, // iOS only\n subAdministrativeArea: String, // iOS only\n subLocality: String, // iOS only\n }]\n}\n```\n","readmeFilename":"README.md"}