0.0.1 • Published 1 year ago

@laravelka/capacitor-contacts v0.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

@laravelka/capacitor-contacts

Capacitor plugin for accessing and managing device contacts.

Install

npm install @laravelka/capacitor-contacts
npx cap sync

API

getContacts()

getContacts() => Promise<{ contacts: Contact[]; }>

Returns: Promise<{ contacts: Contact[]; }>


requestPermissions()

requestPermissions() => Promise<PermissionStatus>

Returns: Promise<PermissionStatus>


Interfaces

Contact

PropType
idstring
displayNamestring
phoneNumbersPhoneNumber[]
emailstring
photoThumbnailstring

PhoneNumber

PropType
labelstring
numberstring

PermissionStatus

PropType
grantedboolean

Usage

import { Contacts } from '@laravelka/capacitor-contacts';

// Request permissions
const requestPermissions = async () => {
  const permission = await Contacts.requestPermissions();
  return permission.granted;
};

// Get contacts
const getContacts = async () => {
  const hasPermission = await requestPermissions();
  if (!hasPermission) {
    throw new Error('Permission denied');
  }
  
  const { contacts } = await Contacts.getContacts();
  return contacts;
};

Platform Support

  • ✅ Android
  • ✅ iOS
  • ❌ Web (coming soon)

License

MIT

Contributing

See CONTRIBUTING.md