npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

react-native-paged-contacts

v3.0.1

Published

React Native Paged Contacts

Downloads

1,190

Readme

React Native Paged Contacts

Paged contacts manager for React Native.

Currently, only fetching contacts is supported.

Installation

iOS

  • Add RCTPagedContacts.xcodeproj to your project.
  • In you project's target, under Build PhasesTarget Dependencies, add RCTPagedContacts.
  • In you project's target, under Build PhasesLink Libraries With Libraries, add RCTPagedContacts.
  • Add NSContactsUsageDescription privacy key description to Info.plist

Android

  • Add the following to settings.gradle:

    include ':pagedcontacts'
    project(':pagedcontacts').projectDir = new File(
            rootProject.projectDir, '../node_modules/react-native-paged-contacts/android/')
  • Update dependencies in build.gradle.

    dependencies {
        compile fileTree(dir: 'libs', include: ['*.jar'])
        compile project(':pagedcontacts')  // <— Add this
        ...
    }

(The dependency will be satisfied after npm install on the Example project)

  • Add the package PagedContactsPackage, to MainApplication.java

        import com.wix.pagedcontacts.PagedContactsPackage; // <- Add this
    
        @Override
        protected List<ReactPackage> getPackages() {
        	return Arrays.<ReactPackage>asList(
        		new MainReactPackage(),
        		new PagedContactsPackage() // <- Add this
        	);
        }
  • FYI: The READ_CONTACTS permission will automatically be merged into your build's AndroidManifest.xml

    <uses-permission android:name="android.permission.READ_CONTACTS" />
  • The WRITE_CONTACTS permission is needed to use addContact method. and should be added to your build's AndroidManifest.xml

    <uses-permission android:name="android.permission.WRITE_CONTACTS" />

API

  • new PagedContacts() — Create a paged contacts manager for all device contacts.
  • new PagedContacts(nameMatch) — Create a paged contacts manager for contacts matching the provided name.
  • getAuthorizationStatus() — Returns the current authorization status to access the contact data.
  • requestAccess() — Request contacts access from the operating system. This must be called before calling other APIs.
  • setNameMatch(matchName) — Change the result set to filter contacts by matching name. Set to null to receive all contacts.
  • getContactsCount() — Get the count of the current contacts set.
  • getContactsWithRange(offset, batchSize, keysToFetch) — Get contacts within the requested batchSize, starting from offset. Only the keys requested in keysToFetch will be provided (contact identifiers are always provided).
  • getContactsWithIdentifiers(identifiers, keysToFetch) — Get contacts with the provided identifiers. Only the keys requested in keysToFetch will be provided (contact identifiers are always provided).
  • addContact(contact) - Add a contact to the device. Fields that can be set are the same as the keys described below. [1]
  • dispose() — Disposes the native components. Call this method when the manager object is no longer required. Must not call any other methods of the contacts manager after calling dispose.

Authorization Status

  • PagedContacts.notDetermined — The user has not yet made a choice regarding whether the application may access contact data.
  • PagedContacts.authorized — The application is authorized to access contact data.
  • PagedContacts.denied — The user explicitly denied access to contact data for the application.
  • PagedContacts.restricted — The application is not authorized to access contact data. The user cannot change this application’s status, possibly due to active restrictions such as parental controls being in place.

Available Keys to Fetch

  • PagedContacts.identifier — The contact’s unique identifier.
  • PagedContacts.displayName
  • PagedContacts.namePrefix — Name prefix.
  • PagedContacts.givenName — Given name.
  • PagedContacts.middleName — Middle name.
  • PagedContacts.familyName — Family prefix.
  • PagedContacts.previousFamilyName — Previous family name. (iOS only)
  • PagedContacts.nameSuffix — Name suffix.
  • PagedContacts.nickname — Nickname.
  • PagedContacts.organizationName — Organization name.
  • PagedContacts.departmentName — Department name.
  • PagedContacts.jobTitle — Job title.
  • PagedContacts.phoneticGivenName — Phonetic given name.
  • PagedContacts.phoneticMiddleName — Phonetic middle name.
  • PagedContacts.phoneticFamilyName — Phonetic family name.
  • PagedContacts.phoneticOrganizationName — Phonetic organization name.
  • PagedContacts.birthday — Birthday.
  • PagedContacts.nonGregorianBirthday — Non-Gregorian birthday. (iOS only)
  • PagedContacts.note — Note.
  • PagedContacts.imageData — Image data.
  • PagedContacts.thumbnailImageData — Thumbnail data.
  • PagedContacts.phoneNumbers — Phone numbers.
  • PagedContacts.emailAddresses — Email addresses.
  • PagedContacts.postalAddresses — Postal addresses.
  • PagedContacts.dates — Contact dates.
  • PagedContacts.urlAddresses — URL addresses.
  • PagedContacts.relations — Contact relations.
  • PagedContacts.socialProfiles — Social profiles. (iOS only)
  • PagedContacts.instantMessageAddresses — Instant message addresses.

Usage

Import the library and create a new PagedContacts instance.

import {PagedContacts} from 'react-native-paged-contacts';
let pg = new PagedContacts();

First request authorization, and, if granted, request the contacts. (iOS only)

pg.requestAccess().then((granted) => {
  if(granted !== true)
  {
    return; 
  }

  pg.getContactsCount().then( (count) => {
    pg.getContactsWithRange(0, count, [PagedContacts.displayName, PagedContacts.thumbnailImageData, PagedContacts.phoneNumbers, PagedContacts.emailAddresses]).then((contacts) => {
      //Use contacts here
    });
  });
});

This is a very intensive way of obtaining specific keys of all contacts. Instead, use the paging mechanism to obtain contacts within a range, and only request keys you need.

Example of a Contact Result

{
  "familyName": "Zakroff",
  "nonGregorianBirthday": "1961-12-25T22:00:00.000Z",
  "birthday": "1961-12-26T00:00:00.000Z",
  "contactRelations": [
    {
      "label": "sister",
      "value": "Kate Bell"
    }
  ],
  "nickname": "Hanky Panky",
  "displayName": "Prof. Hank M. Zakroff Esq.",
  "organizationName": "Financial Services Inc.",
  "departmentName": "Legal",
  "namePrefix": "Prof.",
  "nameSuffix": "Esq.",
  "socialProfiles": [
    {
      "label": "twitter",
      "value": {
        "urlString": "http:\/\/twitter.com\/HankyPanky",
        "username": "HankyPanky",
        "service": "Twitter"
      }
    },
    {
      "label": "facebook",
      "value": {
        "urlString": "http:\/\/www.facebook.com\/HankZakoff",
        "username": "HankZakoff",
        "service": "Facebook"
      }
    }
  ],
  "dates": [
    {
      "label": "anniversary",
      "value": "0001-12-01T00:00:00.000Z"
    },
    {
      "label": "other",
      "value": "2014-09-25T00:00:00.000Z"
    }
  ],
  "phoneNumbers": [
    {
      "label": "work",
      "value": "(555) 766-4823"
    },
    {
      "label": "other",
      "value": "(707) 555-1854"
    }
  ],
  "identifier": "60CB0169-0747-4494-9F10-22F387226676",
  "urlAddresses": [
    {
      "label": "homepage",
      "value": "https:\/\/google.com"
    }
  ],
  "postalAddresses": [
    {
      "label": "work",
      "value": {
        "ISOCountryCode": "us",
        "state": "CA",
        "street": "1741 Kearny Street",
        "city": "San Rafael",
        "country": "",
        "postalCode": "94901"
      }
    },
    {
      "label": "home",
      "value": {
        "ISOCountryCode": "il",
        "state": "",
        "street": "151 Jerusalem Avenue",
        "city": "Tel Aviv - Jaffa",
        "country": "Israel",
        "postalCode": "68152"
      }
    }
  ],
  "middleName": "M.",
  "jobTitle": "Partner",
  "note": "Best lawyer ever!",
  "emailAddresses": [
    {
      "label": "work",
      "value": "[email protected]"
    }
  ],
  "givenName": "Hank",
  "instantMessageAddresses": [
    {
      "label": "Facebook",
      "value": {
        "service": "Facebook",
        "username": "HankZakoff"
      }
    },
    {
      "label": "Skype",
      "value": {
        "service": "Skype",
        "username": "HZakoff"
      }
    }
  ]
}

1 : Contact's image can be set using an extra imageUrl field (iOS only)