{"_id":"@byrds/capacitor-contacts","_rev":"31-32240cc58618ecc0f1640bdf0e337859","time":{"0.0.1":"2020-05-16T11:24:15.391Z","0.0.2":"2020-05-16T11:24:15.391Z","0.0.3":"2020-05-16T11:24:15.391Z","0.0.4":"2020-05-16T11:24:15.391Z","0.0.5":"2020-05-16T11:24:15.391Z","0.0.6":"2020-05-16T11:24:15.391Z","0.0.7":"2020-05-16T11:24:15.391Z","0.0.8":"2020-05-16T11:24:15.391Z","0.0.9":"2020-05-16T11:24:15.391Z","0.1.0":"2020-05-16T11:24:15.391Z","0.1.1":"2020-05-16T11:24:15.391Z","0.1.2":"2020-05-16T11:24:15.391Z","0.1.3":"2020-05-16T11:24:15.391Z","0.1.4":"2020-05-16T11:24:15.391Z","0.1.5":"2020-05-16T11:24:15.391Z","0.1.6":"2020-05-16T11:24:15.391Z","0.1.7":"2020-05-16T11:24:15.391Z","0.1.8":"2020-05-16T11:24:15.391Z","0.2.0":"2020-05-16T11:24:15.391Z","0.2.2":"2020-05-16T11:24:15.391Z","1.0.0":"2020-05-16T11:24:15.391Z","created":"2020-05-16T11:25:15.813Z","1.0.1":"2020-05-16T11:25:16.039Z","modified":"2022-04-04T21:20:22.613Z","1.0.2":"2020-05-16T12:17:05.960Z","1.0.3":"2020-05-16T13:37:02.939Z","1.1.0":"2020-06-10T08:45:18.136Z"},"name":"@byrds/capacitor-contacts","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.1":{"name":"@byrds/capacitor-contacts","version":"1.0.1","description":"A capacitor plugin to fetch contacts","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepublishOnly":"npm run build"},"author":{"name":"Byrds & Bytes Gmbh / Idrimi / Jonathan Gerber"},"license":"MIT","dependencies":{"@capacitor/core":"latest"},"devDependencies":{"rimraf":"^3.0.0","typescript":"^3.2.4","@capacitor/ios":"latest","@capacitor/android":"latest"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/byrdsandbytes/capacitor-contacts-plugin.git"},"bugs":{"url":"https://github.com/byrdsandbytes/capacitor-contacts-plugin.git/issues"},"gitHead":"03037c3f86f29bf4d854c1e83d67d757db1db801","homepage":"https://github.com/byrdsandbytes/capacitor-contacts-plugin#readme","_id":"@byrds/capacitor-contacts@1.0.1","_nodeVersion":"12.16.1","_npmVersion":"6.14.4","dist":{"integrity":"sha512-ThO1OMNzPxyW0aQVB1TVZ7lctSMJ5+SRoZtqw3F5Y+MApRbULVSfYBojBDSqPRCQp4wCFc5SAWG6ADLGUZA/jA==","shasum":"cc99e8e914e20c7a68bb634833e6153737bc326f","tarball":"https://registry.npmjs.org/@byrds/capacitor-contacts/-/capacitor-contacts-1.0.1.tgz","fileCount":93,"unpackedSize":337625,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJev82cCRA9TVsSAnZWagAAjiEP/3/3XQUTafPeO3qHOUKz\nyS8uEphV3xZVNZhW2sdU/ipRv46S0ylRNOr1gXORhx+Dj5SSo7VV0ccjsQ0+\nkXobW6r4mct7a3fGhIT2Hl8yC4h7pWW/LTz/KZFxv72xN1vNmu5UA0hNPEY2\ncYy+CxwRxfuzO2eSZB5vpSnyxjHa9N0367FVA9Po9bTRX+XssNo5y1wguldt\n70Z8iQIXx7s8IrR/bQRSE0mpPYtDzUinYEpvnvGhJ50gc3g2sjxhkv/4NlQW\nC1Lm0EP6SDr0sf/EqwZFNVIlNXtckPxq8yu7wT9oA47CtWORCQ1BUNdOO7XL\nY4vw9qBSgQXeqQ68WIdqKBoJJ4FqRXO+dsJQJCTmUe4/i7cCUcE7AWYPd/Vx\noKu9g6RE1Y3mwXNRGK1m9shDBPVvwbn8pkoTnkulrSpaxz3GKmyouFUbm5Bd\nBPlMH2xhgmeQNnLeLOYVUoraPwDRGk4ZXFgWRVQV+1zob148fmNvOvaM4jx+\nHgu+340g0x3dDdeETS3FxSQqbeDXGMzStD4EhWqOl1Da56LSRn5G7KwZhQEy\nZDCGXyQrIrVEMzEvUTBP8ylYDcpN8mj0Ej4WfhU0FFVHOq/KyCnCiJVOFeJR\nXuV6iayxRWCW+x2ruI+qtf3tbnxIpAHCk1dwa5PT6mX65wNpaK+iOu2yjgTw\nJK2D\r\n=+h7L\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCqIk7aPeDqLiSEt0e5Zr7A9BNHdiGe2DAi25gsd6LQ2AIgZs0jwWLzEcsa7zWlDkITHtCdNrNW1Xlser+qRDVP3yM="}]},"maintainers":[{"name":"byrds","email":"info@byrds.ch"}],"_npmUser":{"name":"byrds","email":"info@byrds.ch"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contacts_1.0.1_1589628315850_0.6235332981608208"},"_hasShrinkwrap":false},"1.0.2":{"name":"@byrds/capacitor-contacts","version":"1.0.2","description":"A capacitor plugin to fetch contacts","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepublishOnly":"npm run build"},"author":{"name":"Byrds & Bytes Gmbh / Idrimi / Jonathan Gerber"},"license":"MIT","dependencies":{"@capacitor/core":"latest"},"devDependencies":{"rimraf":"^3.0.0","typescript":"^3.2.4","@capacitor/ios":"latest","@capacitor/android":"latest"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/byrdsandbytes/capacitor-contacts-plugin.git"},"bugs":{"url":"https://github.com/byrdsandbytes/capacitor-contacts-plugin.git/issues"},"gitHead":"d291f4192d0d400a016dfc0bd7e69a60c5f89741","homepage":"https://github.com/byrdsandbytes/capacitor-contacts-plugin#readme","_id":"@byrds/capacitor-contacts@1.0.2","_nodeVersion":"12.16.1","_npmVersion":"6.14.4","dist":{"integrity":"sha512-LI5ao4ZA5ztZTBmCnX20KZpwSalncR8vkAH+mXXh5LCFP9uRurD6ZRBpy0XaAj5Rvgr3jsIjSUTENv2CYaQPCQ==","shasum":"2501bd498db3f4476b964b482be2ab6f3c77667d","tarball":"https://registry.npmjs.org/@byrds/capacitor-contacts/-/capacitor-contacts-1.0.2.tgz","fileCount":93,"unpackedSize":338194,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJev9nCCRA9TVsSAnZWagAAJZsQAIn0kozUdzaOzZ0tZYyA\nJ9rv2RrhnpFnJMFSqALCYc7CM0I1RgtusPVuga/CsmKQoCy4VnvWaehYv/nK\nfrmFEI7VXuT3lLeHydnvB5wfVD42uNeq2ufryYBuN2HGswRv5wkjVH6CJSgG\nfAsy9+YFciJa9XWp512MirPp99ZHRgyEWrRoWByuo7JRnUEfR6Ze3EuSlY9P\nH1TpLm97xi3tFFaTlzO366jQa/mHIayGFCRI8DMwTQ/UhaKYFRBy9enPFAuk\n92h+hmIRmr+7B0CKeW3dyBjA0SAeCNioSIl4gN2AgzLE62Kb8DCFlrWw+Mzg\nor1KlTAvgXrKZZhaIG2G9uT/IsJdeVyCwUNB/0yOQG/9vJpf+nn3Na7MqT5L\nkPmul/ZOaqKWGsJW1NyxHsFL3p5vGTuTiU7Qh4T9QvGgUbBbgJTqiq64CqBH\nFYv/WpRWo3KzsdRIJMRzJWGq3sRHvhtl4yEhn3ubbo7dOxmD2TsyFNc5KZoi\ny2H9R5U/9J1z/FzN4HDMMceVN0h6GaY1ynkEiIrfFcWPJcJxamgU7R4EBEyk\nsBWtM9S0y6l57Mj96eJuhDFaX7Xl9Smc+CKWbVmggZCxrGWIhAa3TT8ZeVZx\n6+aH5oVNqiTgQrFOr4DBxkEAbwXVBbJkU3XOMJ+9yxF9ul4W2ggqzJxMx3ez\n8ZAv\r\n=GfOG\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIC4LbQjQNRR49r8MFuZGDbf2bvRDpnda1nWYQmjIzt8wAiBQHqV4VbUGvis5hk4vpFhhg5NRnEmN/vOWwtsuHYFqhw=="}]},"maintainers":[{"name":"byrds","email":"info@byrds.ch"}],"_npmUser":{"name":"byrds","email":"info@byrds.ch"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contacts_1.0.2_1589631425803_0.5123202051399618"},"_hasShrinkwrap":false},"1.0.3":{"name":"@byrds/capacitor-contacts","version":"1.0.3","description":"A capacitor plugin to fetch contacts","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepublishOnly":"npm run build"},"author":{"name":"Byrds & Bytes Gmbh / Idrimi / Jonathan Gerber"},"license":"MIT","dependencies":{"@capacitor/core":"latest"},"devDependencies":{"rimraf":"^3.0.0","typescript":"^3.2.4","@capacitor/ios":"latest","@capacitor/android":"latest"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/byrdsandbytes/capacitor-contacts-plugin.git"},"bugs":{"url":"https://github.com/byrdsandbytes/capacitor-contacts-plugin.git/issues"},"gitHead":"d291f4192d0d400a016dfc0bd7e69a60c5f89741","homepage":"https://github.com/byrdsandbytes/capacitor-contacts-plugin#readme","_id":"@byrds/capacitor-contacts@1.0.3","_nodeVersion":"12.16.1","_npmVersion":"6.14.4","dist":{"integrity":"sha512-LwvRB9m0pP3eY8/f/m2XgmvG1y0DrhPqqJM5Mg0GzxEnmBEA+Z9xEIoA2rjmUZTpmpcjSqAX0yiMA7a1eXV1Gg==","shasum":"43d02a4b4fa7c1f04dbe247523ede0c2a40e734e","tarball":"https://registry.npmjs.org/@byrds/capacitor-contacts/-/capacitor-contacts-1.0.3.tgz","fileCount":93,"unpackedSize":338194,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJev+x/CRA9TVsSAnZWagAAbUYP/0gstDIkUbR6xluHlMtl\nsJB1A6jfN7rokkVOLwfy4xzMeIZC3tdWrl0ESyMU5gVvjuBPPJnwYP3xxWzq\nQHWIhVrWyDqYokFc50yUegrSoaR2F3ghD4dDekxPz9Shl82naxWrl7DtJE7p\nZqDwHL48w/VMZSsiPT7g5LYZWUnGmflHlN0Ld3dlp8SisRN8GSbMJNDKdkwH\nilP32rQwNW/YdjyOmu8ov1hr07fhvVcsYD/WhqPBITXr4Th/pM0mOhiB7v59\n/ciukgcUuwyGjAMv/zdXU6kaNa86un0KkVQf3EuYYAERqC9jrYpQi3EbiKAZ\niZzM6NoLEx+RwESVT3g/i3MgM17o7XyvC3XDeyBXkxXqShrxenMQ+quPRTcB\n8HsvbUzvEOv7YSb9Y7znvumdtgxokR6v9xPd89MkZsvpp/cdxB4kdpocv30c\nuJE7iD/7Rgf+m8ZGcBkNwD++nZt0NWmr5S1/rP7b+comHjYYok5Qs5wpNHLE\ndoko3BzjkCbcZnB53dOW6ZiskVIQ/8FARNkFD91b0GwoihSReqshg4kcAC3F\nfPN+eELNRE5Qrl0PasyPdgDT3cDd6jJGGLgcBxXcqKboqzX2s9WNwc0HuWll\nujrc0P4Xcf+z2ZSluq0V9Vbi7xjMP3AtrTnZFNz1Y3PxodMmiCQp42zwvICG\npWbb\r\n=3oWB\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFWUX0xV1H0Pnf16Oc5cUsSv122dUwyR9iLhjBrRtkZNAiEA5wG6mP52cRhtrpqtGUeu9VTnNTk9crB5qHVRS03a1GI="}]},"maintainers":[{"name":"byrds","email":"info@byrds.ch"}],"_npmUser":{"name":"byrds","email":"info@byrds.ch"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contacts_1.0.3_1589636222800_0.3049961094170388"},"_hasShrinkwrap":false},"1.1.0":{"name":"@byrds/capacitor-contacts","version":"1.1.0","description":"A capacitor plugin to fetch contacts","main":"dist/esm/index.js","types":"dist/esm/index.d.ts","scripts":{"build":"npm run clean && tsc","clean":"rimraf ./dist","watch":"tsc --watch","prepublishOnly":"npm run build"},"author":{"name":"Byrds & Bytes Gmbh / Idrimi / Jonathan Gerber"},"license":"GPLv3","dependencies":{"@capacitor/core":"latest"},"devDependencies":{"rimraf":"^3.0.0","typescript":"^3.2.4","@capacitor/ios":"latest","@capacitor/android":"latest"},"keywords":["capacitor","plugin","native"],"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"type":"git","url":"git+https://github.com/byrdsandbytes/capacitor-contacts-plugin.git"},"bugs":{"url":"https://github.com/byrdsandbytes/capacitor-contacts-plugin.git/issues"},"gitHead":"b1445c2c2379ef25de9db8d7b7982e3cec743379","homepage":"https://github.com/byrdsandbytes/capacitor-contacts-plugin#readme","_id":"@byrds/capacitor-contacts@1.1.0","_nodeVersion":"12.16.1","_npmVersion":"6.14.4","dist":{"integrity":"sha512-OOzsrcmoKDqHV4sQfHufZRBSH9A+5BgQrTt/0h8HfmQ7mXulfTO9SIy0V2Y31liHNgJrvJ7LliifO8cDWaZsUg==","shasum":"758d044a79ef80d43860310831133b203af8acd5","tarball":"https://registry.npmjs.org/@byrds/capacitor-contacts/-/capacitor-contacts-1.1.0.tgz","fileCount":95,"unpackedSize":373740,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe4J2eCRA9TVsSAnZWagAAJAAP+gLst9S34ZlHBWs08UXG\nDxbafRJhIoiEZ4sSjqZs/lT1rYimTsefeDYIErIZakHfj/nev82PalkVrbsR\nFa1NfHt5TPxREUDy0qkT2TwUPEk2D/k5kGqsX0pDCxvgzv3Cg77pigkikSKM\nuABNKe7Df89UbgTq7Z9tPhIIFoAVrVMXZWABkDFWXPu/yUYUwnFIcp6NBSU0\naM39hFVdkuzZBsr6ypsOskSJMHcmTA/gos7md7Q25cPP9A6s2BWeUndiJ6vd\nLoI2WU0kkZpTcxfX8oEJzvTu8kxXmfJQg4OLP5TXeRmZ2NB9G94bV4KtxTfZ\nnMiftYI4WwpXC33xXPiClmzO+trUitP3yjHFYSawFOHkv233DmYSMzIFG7I/\n+NE8BJ2SSFFQaMvuriIHlCCXSrZalYcmP/SiWaJKhbPRVs7791VlXZkvtYZx\noLw/96XVKyqExQqlw/Jyx+gas9rlqgFutlMK966TMWu+W9Ux/acL+I+g8K+N\nIV56n2o2be2E11FBMGCqAiisRvHVG1pPbZmC7+sJNwuvd0xife2o1uzIub/M\ndSdfLZ5OnlEWq8bZ91WsYayrvDtCgMbYjSByAT9mumwktg95LOMTc6dhKmks\n664VBR0eRsZ0/nx9QZjnS7veEXVUPANSjus1EV8DP2jQKWuv8o5T2/karfpc\nDLO2\r\n=Tufe\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCV6TUbKRpz1LOtnH3FYLNwcOf/9uRTKZ1VaftVvSxd7gIgIQOxFMk0h3L3f8QyjO2LKAZ7xAWutXE+IFLBy71wp1A="}]},"maintainers":[{"name":"byrds","email":"info@byrds.ch"}],"_npmUser":{"name":"byrds","email":"info@byrds.ch"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/capacitor-contacts_1.1.0_1591778717993_0.04199584482364549"},"_hasShrinkwrap":false}},"maintainers":[{"name":"byrds","email":"info@byrds.ch"}],"description":"A capacitor plugin to fetch contacts","homepage":"https://github.com/byrdsandbytes/capacitor-contacts-plugin#readme","keywords":["capacitor","plugin","native"],"repository":{"type":"git","url":"git+https://github.com/byrdsandbytes/capacitor-contacts-plugin.git"},"author":{"name":"Byrds & Bytes Gmbh / Idrimi / Jonathan Gerber"},"bugs":{"url":"https://github.com/byrdsandbytes/capacitor-contacts-plugin.git/issues"},"license":"GPLv3","readme":"# Capacitor Contacts\n\nA native Capcitor plugin to manage phone contacts. Built for Angular hybrid apps.\n\n## Demo\n\nYou can find a working Ionic App using the Byrds' Capacitor Contacts plugin here:\nhttps://github.com/byrdsandbytes/capContactsDemo\n\n## Getting Started\n\n### Prerequisites\n\nSetup your project with Capacitor. For details check here: https://capacitor.ionicframework.com/docs/\n\n```\ncd my-app\nnpm install --save @capacitor/core @capacitor/cli\n```\n\nInitalize Capacitor\n\n```\nnpx cap init\n```\n\nAdd the platforms you want to use.\n\n```\nnpx cap add android\nnpx cap add ios\nnpx cap add electron\n```\n\n### Installing\n\nInstall:\n```\nnpm i --save @byrds/capacitor-contacts\n```\nSync:\n````\nionic capacitor sync\n````\nRun iOS using livereload:\n````\nionic capacitor run ios --l\n````\n\n## Usage / Examples\n\nYou have the following Methods available: \n\n```\nexport interface CapContactsPlugin {\n  getPermissions(): Promise<PermissionStatus>;\n  getContacts(): Promise<{contacts: Contact[]}>;\n}\n```\nIf you're considering to use this plugin you most likely want to retrive contatacts probably want to retrive a users contacts. Here's how I do that: \n\nImport the Plugin in your TS file: \n\n```\nimport { Plugins } from \"@capacitor/core\";\nconst  {CapContacts} = Plugins;\n```\n\nNext use it and console log the result: \n````\nCapContacts.getContacts().then(result => {\n    console.log(result);\n    for (const contact of result.contacts) {\n    console.log(contact);\n    }\n});\n\n````\n\nThat's it. Do Whatever you want with the retrived contacts now result now. \n\nIf you're trying to build something like \"contacts matching\" based on phone numbers i recommend using google libphonenumber: https://www.npmjs.com/package/google-libphonenumber\n\nIn order to match them properly you need to format them before you can match or store them properly.\n\n### Interfaces\n`````\nexport interface PermissionStatus {\n  granted: boolean;\n}\n\nexport interface Contact {\n  contactId: string;\n  displayName?: string;\n  phoneNumbers: string[];\n  emails: string[];\n  organizationName?: string;\n  organizationRole?: string;\n  birthday?: string;\n}\n`````\n\n\n## iOS Notes\n\nFor iOS you need to set use description in your info.plist file.\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````\nWe need access to your contacts in order to do something. \n````\n\n## Android Notes\n\nFor Android you have to add the permision in you AndroidManifest.xml. Add the following permission before the closing of the \"manifest\" tag.\n\n````\n<uses-permission android:name=\"android.permission.READ_CONTACTS\" />\n<uses-permission android:name=\"android.permission.WRITE_CONTACTS\"/>\n````\n\nNext import the capContacts class to your MainActivity\n\n`````\n// Initializes the Bridge\n    this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{\n      // Additional plugins you've installed go here\n      // Ex: add(TotallyAwesomePlugin.class);\n      add(CapContacts.class);\n    }});\n`````\n\nMake sure to import it properly as well.\n\n``````\nimport ch.byrds.capacitorContacts.CapContacts;\n``````\n\n**NOTE**: On Android you have to ask for permission first, before you can fetch the contacts. Use the `getPermissions()` method before you try to fetch contacts using `getContacts()`.\n\n\n\n\n\n## Built With\n- Swift 5 \n- Java\n- Angular\n- Capacitor \n\n## Authors\n-Idrimi (Jonathan Gerber)\n\n## License\nGPL v3\n## Acknowledgments\n\n\n\n","readmeFilename":"README.md"}