expo-contacts 15.0.6 → 15.0.8

package/CHANGELOG.md

@@ -10,6 +10,22 @@
 
 ### 💡 Others
 
+## 15.0.8 — 2025-09-10
+
+### 🎉 New features
+
+- Added `addContactsChangeListener()` to detect contact changes with platform-specific behavior. . ([#39434](https://github.com/expo/expo/pull/39434) by [@hryhoriiK97](https://github.com/hryhoriiK97))
+
+### 💡 Others
+
+- Extracted the read permission check from `FileSystemUtilities` ([#39210](https://github.com/expo/expo/pull/39210) by [@kosmydel](https://github.com/kosmydel))
+
+## 15.0.7 — 2025-09-02
+
+### 💡 Others
+
+- Improved type safety with NewContact and ExistingContact types. ([#39269](https://github.com/expo/expo/pull/39269) by [@hryhoriiK97](https://github.com/hryhoriiK97))
+
 ## 15.0.6 — 2025-08-31
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '15.0.6'
+version = '15.0.8'
 
 android {
   namespace "expo.modules.contacts"
   defaultConfig {
     versionCode 29
-    versionName "15.0.6"
+    versionName "15.0.8"
   }
 }
 

package/android/src/main/java/expo/modules/contacts/ContactsModule.kt

@@ -4,9 +4,12 @@ import android.Manifest
 import android.app.Activity
 import android.content.ContentResolver
 import android.content.Intent
+import android.database.ContentObserver
 import android.database.Cursor
 import android.net.Uri
 import android.os.Bundle
+import android.os.Handler
+import android.os.HandlerThread
 import android.provider.ContactsContract
 import android.provider.ContactsContract.CommonDataKinds
 import expo.modules.contacts.models.BaseModel
@@ -29,6 +32,8 @@ import expo.modules.kotlin.records.Record
 import kotlinx.coroutines.launch
 import java.util.UUID
 
+const val onContactsChangeEventName = "onContactsChange"
+
 data class ContactPage(
   val data: List<Contact>,
   val hasPreviousPage: Boolean = false,
@@ -123,6 +128,9 @@ class QueryArguments(
 class ContactsModule : Module() {
   private var contactPickingPromise: Promise? = null
   private var contactManipulationPromise: Promise? = null
+  private var contactChangeObserver: ContentObserver? = null
+  private var contactsHandlerThread: HandlerThread? = null
+  private var contactsHandler: Handler? = null
 
   private val permissionsManager: Permissions
     get() = appContext.permissions ?: throw Exceptions.PermissionsModuleNotFound()
@@ -133,6 +141,21 @@ class ContactsModule : Module() {
   override fun definition() = ModuleDefinition {
     Name("ExpoContacts")
 
+    Events(onContactsChangeEventName)
+
+    OnDestroy {
+      stopObservingContactChanges()
+    }
+
+    OnStartObserving(onContactsChangeEventName) {
+      ensureReadPermission()
+      startObservingContactChanges()
+    }
+
+    OnStopObserving(onContactsChangeEventName) {
+      stopObservingContactChanges()
+    }
+
     AsyncFunction("requestPermissionsAsync") { promise: Promise ->
       if (permissionsManager.isPermissionPresentInManifest(Manifest.permission.WRITE_CONTACTS)) {
         Permissions.askForPermissionsWithPermissionsManager(permissionsManager, promise, Manifest.permission.READ_CONTACTS, Manifest.permission.WRITE_CONTACTS)
@@ -681,6 +704,54 @@ class ContactsModule : Module() {
     ensureReadPermission()
     ensureWritePermission()
   }
+
+  private fun startObservingContactChanges() {
+    if (contactChangeObserver != null) {
+      return
+    }
+
+    contactsHandlerThread = HandlerThread("ContactsObserverThread")
+    contactsHandlerThread?.start()
+    contactsHandler = Handler(contactsHandlerThread!!.looper)
+
+    val observer = object : ContentObserver(contactsHandler) {
+      override fun onChange(selfChange: Boolean, uri: Uri?) {
+        super.onChange(selfChange, uri)
+        handleContactChange()
+      }
+    }
+
+    val urisToObserve = listOf(
+      ContactsContract.Contacts.CONTENT_URI,
+      ContactsContract.RawContacts.CONTENT_URI
+    )
+
+    urisToObserve.forEach { uri ->
+      resolver.registerContentObserver(uri, true, observer)
+    }
+
+    contactChangeObserver = observer
+  }
+
+  private fun stopObservingContactChanges() {
+    contactChangeObserver?.let { observer ->
+      resolver.unregisterContentObserver(observer)
+      contactChangeObserver = null
+    }
+
+    contactsHandler = null
+    contactsHandlerThread?.quitSafely()
+    contactsHandlerThread = null
+  }
+
+  private fun handleContactChange() {
+    sendEvent(
+      onContactsChangeEventName,
+      mapOf(
+        "body" to null
+      )
+    )
+  }
 }
 
 fun <T> Map<String, Any>.safeGet(key: String): T? {

package/build/Contacts.d.ts

@@ -1,5 +1,6 @@
-import { PermissionResponse, PermissionStatus, PermissionExpiration } from 'expo-modules-core';
+import { PermissionResponse, PermissionStatus, PermissionExpiration, EventSubscription } from 'expo-modules-core';
 import { type ShareOptions } from 'react-native';
+export declare const onContactsChangeEventName = "onContactsChange";
 export type ContactsPermissionResponse = PermissionResponse & {
     /**
      * Indicates if your app has access to the whole or only part of the contact library. Possible values are:
@@ -238,13 +239,11 @@ export type Image = {
     base64?: string;
 };
 /**
- * A set of fields that define information about a single contact entity.
+ * Base contact type without ID. For better type safety, consider using:
+ * - `Contact` when creating new contacts (no ID needed)
+ * - `ExistingContact` when working with contacts returned from the system (ID guaranteed)
  */
 export type Contact = {
-    /**
-     * Immutable identifier used for querying and indexing. This value will be generated by the OS when the contact is created.
-     */
-    id?: string;
     /**
      * Denoting a person or company.
      */
@@ -372,6 +371,15 @@ export type Contact = {
      */
     isFavorite?: boolean;
 };
+/**
+ * Type for existing contacts returned from the system - guarantees the id field is present.
+ */
+export type ExistingContact = Contact & {
+    /**
+     * Immutable identifier used for querying and indexing. This value will be generated by the OS when the contact is created.
+     */
+    id: string;
+};
 /**
  * The return value for queried contact operations like `getContactsAsync`.
  */
@@ -379,7 +387,7 @@ export type ContactResponse = {
     /**
      * An array of contacts that match a particular query.
      */
-    data: Contact[];
+    data: ExistingContact[];
     /**
      * This will be `true` if there are more contacts to retrieve beyond what is returned.
      */
@@ -577,7 +585,7 @@ export declare function getPagedContactsAsync(contactQuery?: ContactQuery): Prom
  * }
  * ```
  */
-export declare function getContactByIdAsync(id: string, fields?: FieldType[]): Promise<Contact | undefined>;
+export declare function getContactByIdAsync(id: string, fields?: FieldType[]): Promise<ExistingContact | undefined>;
 /**
  * Creates a new contact and adds it to the system.
  * > **Note**: For Android users, the Expo Go app does not have the required `WRITE_CONTACTS` permission to write to Contacts.
@@ -612,7 +620,7 @@ export declare function addContactAsync(contact: Contact, containerId?: string):
  */
 export declare function updateContactAsync(contact: {
     id: string;
-} & Partial<Omit<Contact, 'id'>>): Promise<string>;
+} & Partial<ExistingContact>): Promise<string>;
 /**
  * Delete a contact from the system.
  * @param contactId ID of the contact you want to delete.
@@ -740,7 +748,7 @@ export declare function getGroupsAsync(groupQuery: GroupQuery): Promise<Group[]>
  * required to use this method.
  * @return A promise that fulfills with a single `Contact` object if a contact is selected or `null` if no contact is selected (when selection is canceled).
  */
-export declare function presentContactPickerAsync(): Promise<Contact | null>;
+export declare function presentContactPickerAsync(): Promise<ExistingContact | null>;
 /**
  * Get the default container's ID.
  * @return A promise that fulfills with default container ID.
@@ -782,6 +790,36 @@ export declare function requestPermissionsAsync(): Promise<ContactsPermissionRes
  * @platform ios 18.0+
  */
 export declare function presentAccessPickerAsync(): Promise<string[]>;
+/**
+ * Adds a listener for contact changes. The listener will be called whenever contacts are added, updated, or deleted.
+ *
+ * **Platform differences:**
+ * - **Android**: 5-7 second delay - uses `ContentObserver` with inherent system delays
+ * - **iOS**: Immediate response - uses `CNContactStoreDidChangeNotification`
+ *
+ * The Android delay is a system limitation that affects all apps using `ContentObserver` for contacts.
+ * This delay is by design to batch notifications for better performance and battery life.
+ * For more immediate updates, you can also listen to app state changes and refresh
+ * contacts when the app comes to the foreground. This ensures users see the latest contacts when
+ * returning from the native Contacts app.
+ *
+ * @param listener The function that will be executed when contacts change.
+ * This function accepts no arguments.
+ *
+ * @returns A subscription object with a `remove` method to stop listening.
+ * @example
+ * ```jsx
+ * const subscription = Contacts.addContactChangeListener(() => {
+ *   console.log('Contacts changed - refreshing contact list');
+ *   // Refresh your contact list when changes are detected
+ *   loadContacts();
+ * });
+ *
+ * // Later, remove the listener
+ * subscription.remove();
+ * ```
+ */
+export declare function addContactsChangeListener(listener: () => void): EventSubscription;
 /**
  * Possible fields to retrieve for a contact.
  */

package/build/Contacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Contacts.d.ts","sourceRoot":"","sources":["../src/Contacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Contacts.d.ts","sourceRoot":"","sources":["../src/Contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EAGpB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAIlE,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAE5D,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,GAAG;IAC5D;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,GAAG,eAAe,EAAE,CAAC;AAExE,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,GAAG,cAAc,EAAE,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,GAAG,YAAY,EAAE,CAAC;AAE3D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;AAE7C,MAAM,MAAM,IAAI,GAAG;IACjB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAGF;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf;;OAEG;IACH,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB;;OAEG;IACH,uBAAuB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClD;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,IAAI,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG;IACtC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,GAAG,SAAS,EAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,qBAAqB,CAAC,EAAE,SAAS,EAAE,CAAC;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzD;AAGD,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,GAAG,CAAC,CAgBd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,GAAE,YAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAKhG;AAED,wBAAsB,qBAAqB,CACzC,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAW1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,SAAS,EAAE,GACnB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAmBtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,CAAC,GACjD,OAAO,CAAC,MAAM,CAAC,CAKjB;AAGD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAKxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK7B;AAGD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,EACxB,WAAW,GAAE,WAAgB,GAC5B,OAAO,CAAC,GAAG,CAAC,CAwBd;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,CAMd;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW3F;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAM3F;AAGD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAMpE;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC,CAMd;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC,CAMd;AAGD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAM7E;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAKjF;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAMlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAM7F;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAM/E;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAMnF;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAElE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,iBAAiB,CAYjF;AAED;;GAEG;AACH,oBAAY,MAAM;IAChB,EAAE,OAAO;IACT,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,QAAQ,aAAa;IACrB;;OAEG;IACH,oBAAoB,yBAAyB;IAC7C,MAAM,WAAW;IACjB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB;;OAEG;IACH,cAAc,mBAAmB;IACjC,uBAAuB,4BAA4B;IACnD,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,aAAa,kBAAkB;IAC/B;;OAEG;IACH,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,SAAS,cAAc;IACvB;;OAEG;IACH,QAAQ,aAAa;IACrB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,mBAAmB,wBAAwB;IAC3C;;OAEG;IACH,iBAAiB,sBAAsB;IACvC;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,YAAY,iBAAiB;IAC7B;;OAEG;IACH,QAAQ,aAAa;IACrB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,eAAe,oBAAoB;IACnC;;OAEG;IACH,cAAc,mBAAmB;IACjC;;OAEG;IACH,gBAAgB,qBAAqB;CACtC;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,KAAK,UAAU;IACf;;OAEG;IACH,QAAQ,aAAa;IACrB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,UAAU,eAAe;CAC1B;AAED,oBAAY,SAAS;IACnB;;;OAGG;IACH,WAAW,gBAAgB;IAC3B;;OAEG;IACH,SAAS,cAAc;IACvB;;OAEG;IACH,QAAQ,aAAa;IACrB;;OAEG;IACH,IAAI,SAAS;CACd;AAED,oBAAY,YAAY;IACtB;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,OAAO,YAAY;CACpB"}

package/expo-module.config.json

@@ -8,7 +8,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.contacts",
-      "version": "15.0.6",
+      "version": "15.0.8",
       "repository": "local-maven-repo"
     }
   }

package/ios/ContactsModule.swift

@@ -2,6 +2,8 @@ import ExpoModulesCore
 import Contacts
 import ContactsUI
 
+let onContactsChangeEventName = "onContactsChange"
+
 public class ContactsModule: Module, OnContactPickingResultHandler {
   private let contactStore = CNContactStore()
   private let delegate = ContactControllerDelegate()
@@ -9,9 +11,11 @@ public class ContactsModule: Module, OnContactPickingResultHandler {
   private var contactPickerDelegate: ContactPickerControllerDelegate?
   private var contactPickingPromise: Promise?
   private var contactManipulationPromise: Promise?
+  private var contactChangeObserver: NSObjectProtocol?
 
   public func definition() -> ModuleDefinition {
     Name("ExpoContacts")
+    Events(onContactsChangeEventName)
 
     OnCreate {
       appContext?.permissions?.register([
@@ -19,6 +23,18 @@ public class ContactsModule: Module, OnContactPickingResultHandler {
       ])
     }
 
+    OnDestroy {
+      stopObservingContactChanges()
+    }
+
+    OnStartObserving(onContactsChangeEventName) {
+      startObservingContactChanges()
+    }
+
+    OnStopObserving(onContactsChangeEventName) {
+      stopObservingContactChanges()
+    }
+
     AsyncFunction("getDefaultContainerIdentifierAsync") {
       return contactStore.defaultContainerIdentifier()
     }
@@ -540,7 +556,7 @@ public class ContactsModule: Module, OnContactPickingResultHandler {
     let path = url.path
     let standardizedPath = NSString(string: path).standardizingPath
 
-    guard FileSystemUtilities.permissions(appContext, for: url).contains(.read) else {
+    guard FileSystemUtilities.permissions(appContext, for: url).contains(.read) && FileManager.default.isReadableFile(atPath: url.path) else {
       return nil
     }
 
@@ -638,4 +654,31 @@ public class ContactsModule: Module, OnContactPickingResultHandler {
 
     return fetchRequest
   }
+
+  private func startObservingContactChanges() {
+    guard contactChangeObserver == nil else { return }
+
+    contactChangeObserver = NotificationCenter.default.addObserver(
+      forName: .CNContactStoreDidChange,
+      object: nil,
+      queue: .main
+    ) { [weak self] _ in
+      self?.handleContactStoreChange()
+    }
+  }
+
+  private func stopObservingContactChanges() {
+    if let observer = contactChangeObserver {
+      NotificationCenter.default.removeObserver(observer)
+      contactChangeObserver = nil
+    }
+  }
+
+  private func handleContactStoreChange() {
+    // Send event when contacts change - CNContactStoreDidChangeNotification
+    // only tells us that something changed, not what specifically changed
+    sendEvent(onContactsChangeEventName, [
+      "body": nil
+    ])
+  }
 }

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8-sources.jar.md5

@@ -0,0 +1 @@
+dbdb06070a7f1acfbe77c416cdda21c8

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8-sources.jar.sha1

@@ -0,0 +1 @@
+325af909d1f86d6ed1b53bfc7ece14f6aac3bd89

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8-sources.jar.sha256

@@ -0,0 +1 @@
+0004c5348c39a530f8d5f27aed83a350e5e9951ba5cbb3cef3d0084d0df6aa7d

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8-sources.jar.sha512

@@ -0,0 +1 @@
+fa6ce97a32d7797872255a7138021ac335f9932259ef778c8d72e8612f409eb1f75ca4e33c71d480ea27e8e88ad25b27b637b75a4b269c2dd2bc35c75310c93e

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.aar.md5

@@ -0,0 +1 @@
+090541f37e9acd58aa7e32bd83e1b480

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.aar.sha1

@@ -0,0 +1 @@
+70a1418151d809587539343412d1b18c6050c714

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.aar.sha256

@@ -0,0 +1 @@
+87350fc991be2a1eef8a692cfb438d64fbabad25ad040530f0ffe732d347c09b

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.aar.sha512

@@ -0,0 +1 @@
+adad029ba7b8c4664f084e88186d58d2b84ec686e93984353270b3599d0cd8ee102041fe89238b0fbe2e32db649081b23fa93ea52c873fc45d40d4dd82f381d3

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/{15.0.6/expo.modules.contacts-15.0.6.module → 15.0.8/expo.modules.contacts-15.0.8.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.contacts",
-    "version": "15.0.6",
+    "version": "15.0.8",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,13 +24,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.contacts-15.0.6.aar",
-          "url": "expo.modules.contacts-15.0.6.aar",
-          "size": 110210,
-          "sha512": "9b4eb25c6973464079f6217fb1636fc94afca78a2fe1b34c815491a6f424d4700dabcc1192afec7ce70bcb3426e9517cceeaa64e5e3fd9568eb4087e73a3872e",
-          "sha256": "bf95197f5375c51a051ea0a2fc1e9706b1e0ca53b27b6bafdc54f3d9180882c8",
-          "sha1": "3e3ada292984968f3b3a0efff627541e214505b6",
-          "md5": "60da4805ae575641769712538ac47447"
+          "name": "expo.modules.contacts-15.0.8.aar",
+          "url": "expo.modules.contacts-15.0.8.aar",
+          "size": 114994,
+          "sha512": "adad029ba7b8c4664f084e88186d58d2b84ec686e93984353270b3599d0cd8ee102041fe89238b0fbe2e32db649081b23fa93ea52c873fc45d40d4dd82f381d3",
+          "sha256": "87350fc991be2a1eef8a692cfb438d64fbabad25ad040530f0ffe732d347c09b",
+          "sha1": "70a1418151d809587539343412d1b18c6050c714",
+          "md5": "090541f37e9acd58aa7e32bd83e1b480"
         }
       ]
     },
@@ -60,13 +60,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.contacts-15.0.6.aar",
-          "url": "expo.modules.contacts-15.0.6.aar",
-          "size": 110210,
-          "sha512": "9b4eb25c6973464079f6217fb1636fc94afca78a2fe1b34c815491a6f424d4700dabcc1192afec7ce70bcb3426e9517cceeaa64e5e3fd9568eb4087e73a3872e",
-          "sha256": "bf95197f5375c51a051ea0a2fc1e9706b1e0ca53b27b6bafdc54f3d9180882c8",
-          "sha1": "3e3ada292984968f3b3a0efff627541e214505b6",
-          "md5": "60da4805ae575641769712538ac47447"
+          "name": "expo.modules.contacts-15.0.8.aar",
+          "url": "expo.modules.contacts-15.0.8.aar",
+          "size": 114994,
+          "sha512": "adad029ba7b8c4664f084e88186d58d2b84ec686e93984353270b3599d0cd8ee102041fe89238b0fbe2e32db649081b23fa93ea52c873fc45d40d4dd82f381d3",
+          "sha256": "87350fc991be2a1eef8a692cfb438d64fbabad25ad040530f0ffe732d347c09b",
+          "sha1": "70a1418151d809587539343412d1b18c6050c714",
+          "md5": "090541f37e9acd58aa7e32bd83e1b480"
         }
       ]
     },
@@ -80,13 +80,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.contacts-15.0.6-sources.jar",
-          "url": "expo.modules.contacts-15.0.6-sources.jar",
-          "size": 19972,
-          "sha512": "b56feb83e945a7b4df2ca5a71da12aa5d4dc939082da448ab8548bc4967bb24eb48062902db6f3bb234e47d2ad2e55647c3b39f344af2cecd6d87f5b2b5f6aaa",
-          "sha256": "7805b5686f14c0034af179db4c28f3af823529d1f21fca8eac2355601cca4636",
-          "sha1": "b39c529ef7f2a0aa86fd98d627c8610b058f22c2",
-          "md5": "b03c91138ab3950fd241c862b7439b5f"
+          "name": "expo.modules.contacts-15.0.8-sources.jar",
+          "url": "expo.modules.contacts-15.0.8-sources.jar",
+          "size": 20364,
+          "sha512": "fa6ce97a32d7797872255a7138021ac335f9932259ef778c8d72e8612f409eb1f75ca4e33c71d480ea27e8e88ad25b27b637b75a4b269c2dd2bc35c75310c93e",
+          "sha256": "0004c5348c39a530f8d5f27aed83a350e5e9951ba5cbb3cef3d0084d0df6aa7d",
+          "sha1": "325af909d1f86d6ed1b53bfc7ece14f6aac3bd89",
+          "md5": "dbdb06070a7f1acfbe77c416cdda21c8"
         }
       ]
     }

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.module.md5

@@ -0,0 +1 @@
+c1c9272f344b19a39ec8c1f3531b7d64

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.module.sha1

@@ -0,0 +1 @@
+aab0e1cc2a1d8a6e8ca6d652d409036a0a2fcac0

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.module.sha256

@@ -0,0 +1 @@
+6b5505615754fa4a3ad18dbdf2c574187e52e0131e4c8ded017f8ce1c27e1e4e

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.module.sha512

@@ -0,0 +1 @@
+5303d97a8167b9213f313388144937b4d50033ab333b316028b78a347f00f7b10917256d6937ae993a53be3cbf82e502dcf57017a1659f396eff0cee2726ff6d

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/{15.0.6/expo.modules.contacts-15.0.6.pom → 15.0.8/expo.modules.contacts-15.0.8.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.contacts</artifactId>
-  <version>15.0.6</version>
+  <version>15.0.8</version>
   <packaging>aar</packaging>
   <name>expo.modules.contacts</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.pom.md5

@@ -0,0 +1 @@
+ee05c3d5bd7a540683b825c214134a6e

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.pom.sha1

@@ -0,0 +1 @@
+c649e07bd649ede948ab2ac35f05868e687a6343

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.pom.sha256

@@ -0,0 +1 @@
+0cd3a3db36f2cac6fc9ce6298c1afad2e4dc72ce28d6f2e372564a10f5b25102

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.8/expo.modules.contacts-15.0.8.pom.sha512

@@ -0,0 +1 @@
+6a2528ff39024c31f218327c29e6a4e66fdfb1b57bc510792181992e782ec372a2e0dce9315b3df218f55b53d5d9b942322bc658ac8210bf64a89cd77f5da8cb

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.contacts</artifactId>
   <versioning>
-    <latest>15.0.6</latest>
-    <release>15.0.6</release>
+    <latest>15.0.8</latest>
+    <release>15.0.8</release>
     <versions>
-      <version>15.0.6</version>
+      <version>15.0.8</version>
     </versions>
-    <lastUpdated>20250831124210</lastUpdated>
+    <lastUpdated>20250910183903</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/maven-metadata.xml.md5

@@ -1 +1 @@
-ac2e1d4d07cc3bb9674a8b4c328e2a30
+fdcc7d8ca088bcd87444520bcb34ca58

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/maven-metadata.xml.sha1

@@ -1 +1 @@
-9e401e9b0fdf5a6e8def44f96ad5e04910754feb
+2f052601c2e3227136413548f31519582baffd4f

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/maven-metadata.xml.sha256

@@ -1 +1 @@
-4e8f38aa201d8b2f877f50203c4f361aa90b27ed22d0a5e8c664cc0a01fd6074
+761e75654df429d8537838d82c1cc421197ed580f479409f4d3ac6bf823b12aa

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/maven-metadata.xml.sha512

@@ -1 +1 @@
-0e0e630226a3d058b20d2977e26a54837d67d52660b7e85c0dfcc5bd359f043c5726a63baeda9a2d0a9418295a4a10edb74dae525defac45e40c7bdd87e2815e
+204d8dd2ad8dd8cc5764c757f724d3a0d4c3b5e907d246bba1c1cae4ad33466ad0682b175fbe442260489ff5e1d825dd2ab0d6c236c22b6ecd89381c0302b410

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-contacts",
-  "version": "15.0.6",
+  "version": "15.0.8",
   "description": "Provides access to the phone's system contacts.",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -34,12 +34,12 @@
     "preset": "expo-module-scripts"
   },
   "devDependencies": {
-    "expo-module-scripts": "^5.0.5"
+    "expo-module-scripts": "^5.0.7"
   },
   "peerDependencies": {
     "expo": "*",
     "react": "*",
     "react-native": "*"
   },
-  "gitHead": "1dafdaa317c182191909a94a355c8b08a2654783"
+  "gitHead": "87186d10c8239c6469e055417e67bd4d0ed63efb"
 }

package/src/Contacts.ts

@@ -4,11 +4,14 @@ import {
   PermissionExpiration,
   UnavailabilityError,
   uuid,
+  EventSubscription,
 } from 'expo-modules-core';
 import { Platform, Share, type ShareOptions } from 'react-native';
 
 import ExpoContacts from './ExpoContacts';
 
+export const onContactsChangeEventName = 'onContactsChange';
+
 export type ContactsPermissionResponse = PermissionResponse & {
   /**
    * Indicates if your app has access to the whole or only part of the contact library. Possible values are:
@@ -262,13 +265,11 @@ export type Image = {
 };
 
 /**
- * A set of fields that define information about a single contact entity.
+ * Base contact type without ID. For better type safety, consider using:
+ * - `Contact` when creating new contacts (no ID needed)
+ * - `ExistingContact` when working with contacts returned from the system (ID guaranteed)
  */
 export type Contact = {
-  /**
-   * Immutable identifier used for querying and indexing. This value will be generated by the OS when the contact is created.
-   */
-  id?: string;
   /**
    * Denoting a person or company.
    */
@@ -397,6 +398,16 @@ export type Contact = {
   isFavorite?: boolean;
 };
 
+/**
+ * Type for existing contacts returned from the system - guarantees the id field is present.
+ */
+export type ExistingContact = Contact & {
+  /**
+   * Immutable identifier used for querying and indexing. This value will be generated by the OS when the contact is created.
+   */
+  id: string;
+};
+
 /**
  * The return value for queried contact operations like `getContactsAsync`.
  */
@@ -404,7 +415,7 @@ export type ContactResponse = {
   /**
    * An array of contacts that match a particular query.
    */
-  data: Contact[];
+  data: ExistingContact[];
   /**
    * This will be `true` if there are more contacts to retrieve beyond what is returned.
    */
@@ -659,7 +670,7 @@ export async function getPagedContactsAsync(
 export async function getContactByIdAsync(
   id: string,
   fields?: FieldType[]
-): Promise<Contact | undefined> {
+): Promise<ExistingContact | undefined> {
   if (!ExpoContacts.getContactsAsync) {
     throw new UnavailabilityError('Contacts', 'getContactsAsync');
   }
@@ -702,8 +713,7 @@ export async function addContactAsync(contact: Contact, containerId?: string): P
     throw new UnavailabilityError('Contacts', 'addContactAsync');
   }
 
-  const noIdContact = removeIds(contact);
-  return await ExpoContacts.addContactAsync(noIdContact, containerId);
+  return await ExpoContacts.addContactAsync(contact, containerId);
 }
 
 /**
@@ -721,7 +731,7 @@ export async function addContactAsync(contact: Contact, containerId?: string): P
  * ```
  */
 export async function updateContactAsync(
-  contact: { id: string } & Partial<Omit<Contact, 'id'>>
+  contact: { id: string } & Partial<ExistingContact>
 ): Promise<string> {
   if (!ExpoContacts.updateContactAsync) {
     throw new UnavailabilityError('Contacts', 'updateContactAsync');
@@ -970,7 +980,7 @@ export async function getGroupsAsync(groupQuery: GroupQuery): Promise<Group[]> {
  * required to use this method.
  * @return A promise that fulfills with a single `Contact` object if a contact is selected or `null` if no contact is selected (when selection is canceled).
  */
-export async function presentContactPickerAsync(): Promise<Contact | null> {
+export async function presentContactPickerAsync(): Promise<ExistingContact | null> {
   if (!ExpoContacts.presentContactPickerAsync) {
     throw new UnavailabilityError('Contacts', 'presentContactPickerAsync');
   }
@@ -1049,33 +1059,47 @@ export async function presentAccessPickerAsync(): Promise<string[]> {
   return await ExpoContacts.presentAccessPickerAsync();
 }
 
-/** @private */
-function removeIds(contact: Contact): Contact {
-  const updatedContact = { ...contact };
-  if (contact.id && __DEV__) {
-    console.warn(
-      `You have set an id = ${contact.id} for the contact. This value will be ignored, because the id will be generated by the OS`
-    );
-    delete updatedContact.id;
+/**
+ * Adds a listener for contact changes. The listener will be called whenever contacts are added, updated, or deleted.
+ *
+ * **Platform differences:**
+ * - **Android**: 5-7 second delay - uses `ContentObserver` with inherent system delays
+ * - **iOS**: Immediate response - uses `CNContactStoreDidChangeNotification`
+ *
+ * The Android delay is a system limitation that affects all apps using `ContentObserver` for contacts.
+ * This delay is by design to batch notifications for better performance and battery life.
+ * For more immediate updates, you can also listen to app state changes and refresh
+ * contacts when the app comes to the foreground. This ensures users see the latest contacts when
+ * returning from the native Contacts app.
+ *
+ * @param listener The function that will be executed when contacts change.
+ * This function accepts no arguments.
+ *
+ * @returns A subscription object with a `remove` method to stop listening.
+ * @example
+ * ```jsx
+ * const subscription = Contacts.addContactChangeListener(() => {
+ *   console.log('Contacts changed - refreshing contact list');
+ *   // Refresh your contact list when changes are detected
+ *   loadContacts();
+ * });
+ *
+ * // Later, remove the listener
+ * subscription.remove();
+ * ```
+ */
+export function addContactsChangeListener(listener: () => void): EventSubscription {
+  if (!ExpoContacts.addListener) {
+    throw new UnavailabilityError('Contacts', 'addContactChangeListener');
   }
 
-  for (const key of Object.keys(contact)) {
-    const prop = key as keyof Contact;
-    const value = contact[prop];
-    if (Array.isArray(value)) {
-      (updatedContact as any)[prop] = value.map((item, index) => {
-        if (typeof item === 'object' && item != null && 'id' in item) {
-          __DEV__ &&
-            console.warn(
-              `You have set an id "${item.id}" at index "${index}" for the key "${key}" of the contact. This value will be ignored, because the id will be generated by the OS`
-            );
-          return { ...item, id: null };
-        }
-        return item;
-      });
-    }
-  }
-  return updatedContact;
+  const eventSubscription = ExpoContacts.addListener(onContactsChangeEventName, listener);
+
+  return {
+    remove: () => {
+      eventSubscription?.remove();
+    },
+  };
 }
 
 /**

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6-sources.jar.md5

@@ -1 +0,0 @@
-b03c91138ab3950fd241c862b7439b5f

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6-sources.jar.sha1

@@ -1 +0,0 @@
-b39c529ef7f2a0aa86fd98d627c8610b058f22c2

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6-sources.jar.sha256

@@ -1 +0,0 @@
-7805b5686f14c0034af179db4c28f3af823529d1f21fca8eac2355601cca4636

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6-sources.jar.sha512

@@ -1 +0,0 @@
-b56feb83e945a7b4df2ca5a71da12aa5d4dc939082da448ab8548bc4967bb24eb48062902db6f3bb234e47d2ad2e55647c3b39f344af2cecd6d87f5b2b5f6aaa

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.aar.md5

@@ -1 +0,0 @@
-60da4805ae575641769712538ac47447

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.aar.sha1

@@ -1 +0,0 @@
-3e3ada292984968f3b3a0efff627541e214505b6

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.aar.sha256

@@ -1 +0,0 @@
-bf95197f5375c51a051ea0a2fc1e9706b1e0ca53b27b6bafdc54f3d9180882c8

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.aar.sha512

@@ -1 +0,0 @@
-9b4eb25c6973464079f6217fb1636fc94afca78a2fe1b34c815491a6f424d4700dabcc1192afec7ce70bcb3426e9517cceeaa64e5e3fd9568eb4087e73a3872e

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.module.md5

@@ -1 +0,0 @@
-9fac9437f2c09a64527f85ddaef9ef43

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.module.sha1

@@ -1 +0,0 @@
-6050751d847a4e88f0474330c9bc121efe40d21b

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.module.sha256

@@ -1 +0,0 @@
-673c47e1c20ab2b1e69b0bd2bb52f5b7717b83ea7faaf3dabb88fc059cc2c40e

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.module.sha512

@@ -1 +0,0 @@
-5846e7d6f8221a02d123f85242baa5a589ee0cf47b815fb269859edbcc885787f40adeea52cb0d3d9cdc84f4c790a08989fc881ad0498b5837f35ab7d2d491f7

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.pom.md5

@@ -1 +0,0 @@
-1aace678ec6b01f26247e93aff21e105

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.pom.sha1

@@ -1 +0,0 @@
-903b74c040cb682fa011a3be2be13ef4ec9ea936

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.pom.sha256

@@ -1 +0,0 @@
-ad2ea6203058f8101afc0ae026ee958322b314d0109d63728249b0cc5a6e92aa

package/local-maven-repo/host/exp/exponent/expo.modules.contacts/15.0.6/expo.modules.contacts-15.0.6.pom.sha512

@@ -1 +0,0 @@
-8f01a3ecee3e679c46964f4495bc926df415d84f8aefb2b4bfb93bea11fee479e48992e9fa076221a4c68b061ec386a06d634001e1240aeaa2ad12707fba3687