composer require srwiez/nativephp-mobile-contacts
php artisan vendor:publish --tag=nativephp-plugins-provider
php artisan native:plugin:register srwiez/nativephp-mobile-contacts

use SRWieZ\NativePHP\Mobile\Contacts\Facades\MobileContacts;
use SRWieZ\NativePHP\Mobile\Contacts\Data\ContactData;
use SRWieZ\NativePHP\Mobile\Contacts\Data\PhoneNumber;
use SRWieZ\NativePHP\Mobile\Contacts\Data\EmailAddress;
 
// Request permission
$result = MobileContacts::requestAccess();
 
// Query contacts
$contacts = MobileContacts::contacts()
    ->search('John')
    ->withPhoneNumber()
    ->limit(50)
    ->get();
 
// Create a contact
$contact = MobileContacts::createContact(
    ContactData::make()
        ->name('John', 'Doe')
        ->organization('Acme Inc')
        ->addPhone(PhoneNumber::mobile('+1234567890'))
        ->addEmail(EmailAddress::work('[email protected]'))
);
 
// Update a contact
$contact->update(
    ContactData::make()->jobTitle('Senior Developer')
);
 
// Delete a contact
$contact->delete();

use SRWieZ\NativePHP\Mobile\Contacts\Facades\MobileContacts;
 
$success = MobileContacts::manageContactAccess(); // true if picker was presented

import { mobileContacts } from '@srwiez/nativephp-mobile-contacts';
 
await mobileContacts.manageContactAccess();

use Native\Mobile\Attributes\OnNative;
use SRWieZ\NativePHP\Mobile\Contacts\Events\ContactCreated;
use SRWieZ\NativePHP\Mobile\Contacts\Events\ContactAccessUpdated;
 
#[OnNative(ContactCreated::class)]
public function handleContactCreated($contactId, $displayName)
{
    // Contact was created
}
 
#[OnNative(ContactAccessUpdated::class)]
public function handleContactAccessUpdated($identifiers, $contacts, $count, $timestamp)
{
    // $identifiers — array of native contact IDs the user selected
    // $contacts    — array of full contact data for each selected contact
    // $count       — number of contacts updated
    // $timestamp   — Unix timestamp of the selection
}