@symbiote-native/contacts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# @symbiote-native/contacts
+
+Look up a person, add a contact, edit one in the system form, or let the user grant access to just
+the contacts you need (iOS 18). One API for every [SymbioteNative](../../README.md) adapter (React,
+Vue, Svelte, Solid and Angular).
+
+It wraps [`expo-contacts`](https://github.com/expo/expo/tree/main/packages/expo-contacts) the same
+way [`@symbiote-native/print`](../print) wraps its upstream: `expo-modules-core` is a direct
+dependency and the upstream JS is hand-ported into `core/`. See the `symbiote-expo-native-module`
+project skill for the full mechanism.
+
+**Both of upstream's API surfaces are ported**, matching its own layout: the modern
+`SharedObject`-class `Contact`/`Group`/`Container` API (default entry) and the legacy
+function-based API (`/legacy` subpath). Unlike `@symbiote-native/calendar` (which ships only its
+modern surface, since upstream's `next` API had no real JS reference to port), `expo-contacts`
+ships complete, real JS for both surfaces at sdk-57 - so both are ported here.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --contacts
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --contacts
+```
+
+Either way: installs `@symbiote-native/contacts` and wires the native autolinking
+automatically, see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/contacts
+```
+
+`expo-contacts` and `expo-modules-core` come along as regular, pinned dependencies, never
+install either yourself, and never add the `expo` meta-package to this project.
+
+### Required one-time step: native autolinking wiring
+
+Same one-time app wiring every `expo-modules-core` package shares, see
+[`@symbiote-native/print`'s README](../print/README.md#required-one-time-step-native-autolinking-wiring)
+for the full table; nothing package-specific here.
+
+### Permissions and config plugin
+
+`native-link.json` declares:
+
+- **Android**: `READ_CONTACTS`/`WRITE_CONTACTS` permissions. Two native modules are registered:
+  `ExpoContacts` (legacy surface) and `ExpoContactsNext` (modern surface) - both are genuinely
+  called by our JS, since both surfaces are ported.
+- **iOS**: `NSContactsUsageDescription` (custom wording; reword to fit the app).
+
+</details>
+
+## ContactAccessButton
+
+Every adapter exports `ContactAccessButton` from its own entry (`/react`, `/vue`, `/solid`,
+`/svelte`, `/angular`), plus `ContactAccessButton.isAvailable()`. The button is a native view,
+iOS 18+ only, and renders nothing on any other platform or version.
+
+Props: `query`, `caption` (`default` / `email` / `phone`), `ignoredEmails`,
+`ignoredPhoneNumbers`, `tintColor`, `backgroundColor`, `textColor`, `style`, `testID`,
+`nativeID`, `onLayout`, the accessibility and aria props and the responder props.
+
+The view is registered lazily, at the first render: bundlers that inline requires drop a barrel's
+load-time side effects. Verifying it on a real iOS 18 device is the app owner's step.
+
+## Notes
+
+- **Request permission first.** Reads and writes fail without it. On iOS 18 a `'limited'`
+  `accessPrivileges` means the app sees only the contacts the user shared.
+- **`Group` and `Container` are iOS only.** On Android they fall back to a stub that throws
+  `Not implemented`.
+- **`ContactAccessButton` needs iOS 18.** It renders nothing elsewhere; call
+  `ContactAccessButton.isAvailable()` to check.
+
+## What's not ported
+
+Nothing from `expo-contacts`' public surface.
+
+## Platform availability (next API)
+
+| Member | iOS | Android |
+|---|---|---|
+| `Contact` (all CRUD, static finders, field getters/setters) | yes | yes |
+| `Contact.presentAccessPicker` | yes (18+) | no |
+| `contact.getMaidenName/setMaidenName/getNickname/setNickname/getBirthday/setBirthday/getNonGregorianBirthday/setNonGregorianBirthday` | yes | no |
+| `contact.getSocialProfiles/addSocialProfile/updateSocialProfile/deleteSocialProfile` | yes | no |
+| `contact.getImAddresses/addImAddress/updateImAddress/deleteImAddress` | yes | no |
+| `contact.getIsFavourite/setIsFavourite` | no | yes |
+| `contact.getExtraNames/addExtraName/updateExtraName/deleteExtraName` | no | yes |
+| `Group`/`Container` (whole classes) | yes | no - falls back to a stub that throws `Not implemented` |
+
+An unavailable member throws `UnavailabilityError` (function-shaped) or is simply absent
+(class-shaped optional method) on the other platform - check for presence before calling if the
+call site must run on both.
+
+## Shape
+
+```
+src/core/          modern SharedObject API (default entry)
+  enums.ts          ContactField, ContactsSortOrder, NonGregorianCalendar
+  types.ts          all record/patch/query types
+  native-module.ts  declare class ambients for Contact/Group/Container + module functions
+  contact.ts        export class Contact extends expoContactsNext.Contact {}
+  group.ts          export class Group extends (expoContactsNext.Group ?? FallbackGroup) {}
+  container.ts      export class Container extends (expoContactsNext.Container ?? FallbackContainer) {}
+  permissions.ts     get/requestPermissionsAsync
+  listeners.ts       add/removeAllContactsChangeListeners
+src/legacy/         legacy function-based API (/legacy subpath)
+  enums.ts           Fields, CalendarFormats, ContainerTypes, SortTypes, ContactTypes
+  types.ts           legacy record/query types
+  native-module.ts   requireNativeModule('ExpoContacts')
+  contacts.ts        get/add/update/removeContactAsync, groups, containers, permissions
+src/angular/        @symbiote-native/contacts/angular
+```
+
+`./react`, `./vue`, `./svelte`, and `./solid` are `exports`-map aliases straight onto
+`src/core/`. `./legacy` aliases onto `src/legacy/`; there is no separate Angular build for it,
+matching `@symbiote-native/file-system`'s and `@symbiote-native/media-library`'s dual-surface
+precedent.
+
+`Contact`/`Group`/`Container` extend their native `SharedObject` base directly with no added
+sugar - every method already exists on the native class, so the wrapper's only job is being a
+named, `instanceof`-checkable subclass. iOS registers the next class as `ContactNext` (distinct
+from the deprecated legacy `Contact` JS class); Android registers it directly as `Contact`.
+`native-module.ts` aliases `.ContactNext` onto `.Contact` at import time on iOS so both
+platforms expose the same `expoContactsNext.Contact`.
+
+## Use it
+
+```ts
+import { Contact, requestPermissionsAsync } from '@symbiote-native/contacts';
+
+await requestPermissionsAsync();
+const contact = await Contact.create({ givenName: 'Jane', familyName: 'Doe' });
+await contact.addEmail({ label: 'work', address: 'jane@example.com' });
+```
+
+```ts
+// legacy surface
+import { getContactsAsync, requestPermissionsAsync } from '@symbiote-native/contacts/legacy';
+
+await requestPermissionsAsync();
+const { data } = await getContactsAsync({ name: 'Jane' });
+```
+
+## Common questions
+
+- **`getAll` returns too few contacts.** Check the permission; on iOS 18 `'limited'` means the user
+  shared only some. Use `ContactAccessButton` or `Contact.presentAccessPicker()`.
+- **Slow with many contacts.** Page with `limit` / `offset` and use `Contact.getAllDetails(fields)`
+  for only the fields you show.
+- **No phone or email in a list row.** Fetch `getPhones()` / `getEmails()` per contact when needed.
+- **Writes fail on Android.** Request `WRITE_CONTACTS` via `requestPermissionsAsync()` first.
+- **Own picker?** Prefer `Contact.presentPicker()` or `ContactAccessButton`.
+
+Sources: [Expo docs: Contacts](https://docs.expo.dev/versions/latest/sdk/contacts/),
+[expo/expo#386](https://github.com/expo/expo/issues/386),
+[expo/expo#200](https://github.com/expo/expo/issues/200),
+[expo/expo#29224](https://github.com/expo/expo/issues/29224).
+
+## Test it
+
+```bash
+pnpm vitest run packages/contacts
+```

package/build/angular/contact-access-button/index.d.ts

@@ -0,0 +1,18 @@
+import { NativeViewBase } from '@symbiote-native/angular';
+import type { IDescriptor } from '@symbiote-native/components';
+import { isContactAccessButtonAvailable } from '../../core/contact-access-button';
+import type { IContactAccessButtonProps } from '../../core/contact-access-button';
+/** Angular twin of `expo-contacts`' `ContactAccessButton`, iOS 18+ only, nothing elsewhere */
+export declare class ContactAccessButton extends NativeViewBase {
+    /** True only on iOS 18.0 and newer */
+    static readonly isAvailable: typeof isContactAccessButtonAvailable;
+    query?: string;
+    caption?: IContactAccessButtonProps['caption'];
+    ignoredEmails?: string[];
+    ignoredPhoneNumbers?: string[];
+    tintColor?: IContactAccessButtonProps['tintColor'];
+    backgroundColor?: IContactAccessButtonProps['backgroundColor'];
+    textColor?: IContactAccessButtonProps['textColor'];
+    protected readonly propNames: readonly ["query", "caption", "ignoredEmails", "ignoredPhoneNumbers", "tintColor", "backgroundColor", "textColor"];
+    protected renderView(props: object): IDescriptor | null;
+}

package/build/angular/contact-access-button/index.js

@@ -0,0 +1,123 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { ChangeDetectionStrategy, Component, Input } from '@angular/core';
+import { DescriptorOutlet, NativeViewBase } from '@symbiote-native/angular';
+import { isContactAccessButtonAvailable, renderContactAccessButton, } from '../../core/contact-access-button.js';
+/** Angular twin of `expo-contacts`' `ContactAccessButton`, iOS 18+ only, nothing elsewhere */
+let ContactAccessButton = (() => {
+    let _classDecorators = [Component({
+            selector: 'ContactAccessButton',
+            standalone: true,
+            imports: [DescriptorOutlet],
+            changeDetection: ChangeDetectionStrategy.OnPush,
+            template: `@if (descriptor; as node) {
+    <symbiote-descriptor-outlet [node]="node" />
+  }`,
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = NativeViewBase;
+    let _query_decorators;
+    let _query_initializers = [];
+    let _query_extraInitializers = [];
+    let _caption_decorators;
+    let _caption_initializers = [];
+    let _caption_extraInitializers = [];
+    let _ignoredEmails_decorators;
+    let _ignoredEmails_initializers = [];
+    let _ignoredEmails_extraInitializers = [];
+    let _ignoredPhoneNumbers_decorators;
+    let _ignoredPhoneNumbers_initializers = [];
+    let _ignoredPhoneNumbers_extraInitializers = [];
+    let _tintColor_decorators;
+    let _tintColor_initializers = [];
+    let _tintColor_extraInitializers = [];
+    let _backgroundColor_decorators;
+    let _backgroundColor_initializers = [];
+    let _backgroundColor_extraInitializers = [];
+    let _textColor_decorators;
+    let _textColor_initializers = [];
+    let _textColor_extraInitializers = [];
+    var ContactAccessButton = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _query_decorators = [Input()];
+            _caption_decorators = [Input()];
+            _ignoredEmails_decorators = [Input()];
+            _ignoredPhoneNumbers_decorators = [Input()];
+            _tintColor_decorators = [Input()];
+            _backgroundColor_decorators = [Input()];
+            _textColor_decorators = [Input()];
+            __esDecorate(null, null, _query_decorators, { kind: "field", name: "query", static: false, private: false, access: { has: obj => "query" in obj, get: obj => obj.query, set: (obj, value) => { obj.query = value; } }, metadata: _metadata }, _query_initializers, _query_extraInitializers);
+            __esDecorate(null, null, _caption_decorators, { kind: "field", name: "caption", static: false, private: false, access: { has: obj => "caption" in obj, get: obj => obj.caption, set: (obj, value) => { obj.caption = value; } }, metadata: _metadata }, _caption_initializers, _caption_extraInitializers);
+            __esDecorate(null, null, _ignoredEmails_decorators, { kind: "field", name: "ignoredEmails", static: false, private: false, access: { has: obj => "ignoredEmails" in obj, get: obj => obj.ignoredEmails, set: (obj, value) => { obj.ignoredEmails = value; } }, metadata: _metadata }, _ignoredEmails_initializers, _ignoredEmails_extraInitializers);
+            __esDecorate(null, null, _ignoredPhoneNumbers_decorators, { kind: "field", name: "ignoredPhoneNumbers", static: false, private: false, access: { has: obj => "ignoredPhoneNumbers" in obj, get: obj => obj.ignoredPhoneNumbers, set: (obj, value) => { obj.ignoredPhoneNumbers = value; } }, metadata: _metadata }, _ignoredPhoneNumbers_initializers, _ignoredPhoneNumbers_extraInitializers);
+            __esDecorate(null, null, _tintColor_decorators, { kind: "field", name: "tintColor", static: false, private: false, access: { has: obj => "tintColor" in obj, get: obj => obj.tintColor, set: (obj, value) => { obj.tintColor = value; } }, metadata: _metadata }, _tintColor_initializers, _tintColor_extraInitializers);
+            __esDecorate(null, null, _backgroundColor_decorators, { kind: "field", name: "backgroundColor", static: false, private: false, access: { has: obj => "backgroundColor" in obj, get: obj => obj.backgroundColor, set: (obj, value) => { obj.backgroundColor = value; } }, metadata: _metadata }, _backgroundColor_initializers, _backgroundColor_extraInitializers);
+            __esDecorate(null, null, _textColor_decorators, { kind: "field", name: "textColor", static: false, private: false, access: { has: obj => "textColor" in obj, get: obj => obj.textColor, set: (obj, value) => { obj.textColor = value; } }, metadata: _metadata }, _textColor_initializers, _textColor_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            ContactAccessButton = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        /** True only on iOS 18.0 and newer */
+        static isAvailable = isContactAccessButtonAvailable;
+        query = __runInitializers(this, _query_initializers, void 0);
+        caption = (__runInitializers(this, _query_extraInitializers), __runInitializers(this, _caption_initializers, void 0));
+        ignoredEmails = (__runInitializers(this, _caption_extraInitializers), __runInitializers(this, _ignoredEmails_initializers, void 0));
+        ignoredPhoneNumbers = (__runInitializers(this, _ignoredEmails_extraInitializers), __runInitializers(this, _ignoredPhoneNumbers_initializers, void 0));
+        tintColor = (__runInitializers(this, _ignoredPhoneNumbers_extraInitializers), __runInitializers(this, _tintColor_initializers, void 0));
+        backgroundColor = (__runInitializers(this, _tintColor_extraInitializers), __runInitializers(this, _backgroundColor_initializers, void 0));
+        textColor = (__runInitializers(this, _backgroundColor_extraInitializers), __runInitializers(this, _textColor_initializers, void 0));
+        propNames = (__runInitializers(this, _textColor_extraInitializers), [
+            'query',
+            'caption',
+            'ignoredEmails',
+            'ignoredPhoneNumbers',
+            'tintColor',
+            'backgroundColor',
+            'textColor',
+        ]);
+        renderView(props) {
+            return renderContactAccessButton(props);
+        }
+        static {
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return ContactAccessButton = _classThis;
+})();
+export { ContactAccessButton };

package/build/angular/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../core';
+export { ContactAccessButton } from './contact-access-button';

package/build/angular/index.js

@@ -0,0 +1,3 @@
+// No per-instance state or event stream to wrap in an injectable service - plain re-export.
+export * from '../core/index.js';
+export { ContactAccessButton } from './contact-access-button/index.js';

package/build/core/contact-access-button.d.ts

@@ -0,0 +1,29 @@
+import type { IAccessibilityProps, IAriaProps, IDescriptor, IResponderProps } from '@symbiote-native/components';
+import type { IColorValue, IStyleProp, ISymbioteEvent, IViewStyle } from '@symbiote-native/engine';
+export declare const CONTACT_ACCESS_BUTTON_MODULE_NAME = "ExpoContactAccessButton";
+export type IContactAccessButtonCaption = 'default' | 'email' | 'phone';
+export type IContactAccessButtonProps = IAccessibilityProps & IAriaProps & IResponderProps & {
+    /** Matched against contacts not yet exposed to the app, typically from a search field */
+    query?: string;
+    /** Caption under the contact name when the query has one match, nothing by default */
+    caption?: IContactAccessButtonCaption;
+    /** Contacts matching `query` that also match one of these emails are left out */
+    ignoredEmails?: string[];
+    /** Contacts matching `query` that also match one of these phone numbers are left out */
+    ignoredPhoneNumbers?: string[];
+    /** Tint of the button and of the modal shown when there is more than one match */
+    tintColor?: IColorValue;
+    /** Button background, keep it opaque to satisfy the platform legibility rules */
+    backgroundColor?: IColorValue;
+    /** Button title color, a dimmed version of it is used for the caption */
+    textColor?: IColorValue;
+    style?: IStyleProp<IViewStyle>;
+    testID?: string;
+    nativeID?: string;
+    onLayout?: (event: ISymbioteEvent) => void;
+};
+export declare function contactAccessButtonViewName(): string;
+/** True only on iOS 18.0 and newer, where the native module reports the button as available */
+export declare function isContactAccessButtonAvailable(): boolean;
+export declare function ensureContactAccessButtonRegistered(): boolean;
+export declare function renderContactAccessButton(props: object): IDescriptor | null;

package/build/core/contact-access-button.js

@@ -0,0 +1,27 @@
+import { Platform, requireNativeViewManager, requireOptionalNativeModule, } from 'expo-modules-core';
+import { el } from '@symbiote-native/components';
+import { expoViewManagerName, tryRegisterNativeView, } from '@symbiote-native/engine';
+export const CONTACT_ACCESS_BUTTON_MODULE_NAME = 'ExpoContactAccessButton';
+export function contactAccessButtonViewName() {
+    return expoViewManagerName(CONTACT_ACCESS_BUTTON_MODULE_NAME);
+}
+/** True only on iOS 18.0 and newer, where the native module reports the button as available */
+export function isContactAccessButtonAvailable() {
+    return (Platform.OS === 'ios' &&
+        (requireOptionalNativeModule(CONTACT_ACCESS_BUTTON_MODULE_NAME)?.isAvailable ??
+            false));
+}
+// Registers the view config in React Native's registry, which the engine derives the view's events
+// and prop processors from. Called at render, not at import: a registration that only a barrel's
+// load-time side effect performs is dropped by Metro's `inlineRequires` in release
+export function ensureContactAccessButtonRegistered() {
+    if (Platform.OS !== 'ios')
+        return false;
+    return tryRegisterNativeView(() => requireNativeViewManager(CONTACT_ACCESS_BUTTON_MODULE_NAME));
+}
+// `object`, not the props type: Vue and Angular hand over an untyped attribute bag
+export function renderContactAccessButton(props) {
+    if (!ensureContactAccessButtonRegistered())
+        return null;
+    return el(contactAccessButtonViewName(), { ...props });
+}

package/build/core/contact.d.ts

@@ -0,0 +1,3 @@
+import { expoContactsNext } from './native-module';
+export declare class Contact extends expoContactsNext.Contact {
+}

package/build/core/contact.js

@@ -0,0 +1,3 @@
+import { expoContactsNext } from './native-module.js';
+export class Contact extends expoContactsNext.Contact {
+}

package/build/core/container.d.ts

@@ -0,0 +1,5 @@
+declare const Container_base: typeof import("./native-module").NativeContainer;
+/** @platform ios - Android has no Container concept in expo-contacts. */
+export declare class Container extends Container_base {
+}
+export {};

package/build/core/container.js

@@ -0,0 +1,5 @@
+import { expoContactsNext, FallbackContainer } from './native-module.js';
+/** @platform ios - Android has no Container concept in expo-contacts. */
+export class Container extends (expoContactsNext.Container ??
+    FallbackContainer) {
+}

package/build/core/enums.d.ts

@@ -0,0 +1,53 @@
+export declare enum ContactField {
+    IS_FAVOURITE = "isFavourite",
+    FULL_NAME = "fullName",
+    GIVEN_NAME = "givenName",
+    MIDDLE_NAME = "middleName",
+    FAMILY_NAME = "familyName",
+    MAIDEN_NAME = "maidenName",
+    NICKNAME = "nickname",
+    PREFIX = "prefix",
+    SUFFIX = "suffix",
+    PHONETIC_GIVEN_NAME = "phoneticGivenName",
+    PHONETIC_MIDDLE_NAME = "phoneticMiddleName",
+    PHONETIC_FAMILY_NAME = "phoneticFamilyName",
+    COMPANY = "company",
+    PHONETIC_COMPANY_NAME = "phoneticCompanyName",
+    DEPARTMENT = "department",
+    JOB_TITLE = "jobTitle",
+    NOTE = "note",
+    IMAGE = "image",
+    THUMBNAIL = "thumbnail",
+    BIRTHDAY = "birthday",
+    NON_GREGORIAN_BIRTHDAY = "nonGregorianBirthday",
+    EMAILS = "emails",
+    PHONES = "phones",
+    ADDRESSES = "addresses",
+    EXTRA_NAMES = "extraNames",
+    DATES = "dates",
+    RELATIONS = "relations",
+    URL_ADDRESSES = "urlAddresses",
+    SOCIAL_PROFILES = "socialProfiles",
+    IM_ADDRESSES = "imAddresses"
+}
+export declare enum ContactsSortOrder {
+    UserDefault = "userDefault",
+    GivenName = "givenName",
+    FamilyName = "familyName",
+    None = "none"
+}
+/** @platform ios */
+export declare enum NonGregorianCalendar {
+    buddhist = "buddhist",
+    chinese = "chinese",
+    coptic = "coptic",
+    ethiopicAmeteMihret = "ethiopicAmeteMihret",
+    ethiopicAmeteAlem = "ethiopicAmeteAlem",
+    hebrew = "hebrew",
+    indian = "indian",
+    islamic = "islamic",
+    islamicCivil = "islamicCivil",
+    japanese = "japanese",
+    persian = "persian",
+    republicOfChina = "republicOfChina"
+}

package/build/core/enums.js

@@ -0,0 +1,56 @@
+export var ContactField;
+(function (ContactField) {
+    ContactField["IS_FAVOURITE"] = "isFavourite";
+    ContactField["FULL_NAME"] = "fullName";
+    ContactField["GIVEN_NAME"] = "givenName";
+    ContactField["MIDDLE_NAME"] = "middleName";
+    ContactField["FAMILY_NAME"] = "familyName";
+    ContactField["MAIDEN_NAME"] = "maidenName";
+    ContactField["NICKNAME"] = "nickname";
+    ContactField["PREFIX"] = "prefix";
+    ContactField["SUFFIX"] = "suffix";
+    ContactField["PHONETIC_GIVEN_NAME"] = "phoneticGivenName";
+    ContactField["PHONETIC_MIDDLE_NAME"] = "phoneticMiddleName";
+    ContactField["PHONETIC_FAMILY_NAME"] = "phoneticFamilyName";
+    ContactField["COMPANY"] = "company";
+    ContactField["PHONETIC_COMPANY_NAME"] = "phoneticCompanyName";
+    ContactField["DEPARTMENT"] = "department";
+    ContactField["JOB_TITLE"] = "jobTitle";
+    ContactField["NOTE"] = "note";
+    ContactField["IMAGE"] = "image";
+    ContactField["THUMBNAIL"] = "thumbnail";
+    ContactField["BIRTHDAY"] = "birthday";
+    ContactField["NON_GREGORIAN_BIRTHDAY"] = "nonGregorianBirthday";
+    ContactField["EMAILS"] = "emails";
+    ContactField["PHONES"] = "phones";
+    ContactField["ADDRESSES"] = "addresses";
+    ContactField["EXTRA_NAMES"] = "extraNames";
+    ContactField["DATES"] = "dates";
+    ContactField["RELATIONS"] = "relations";
+    ContactField["URL_ADDRESSES"] = "urlAddresses";
+    ContactField["SOCIAL_PROFILES"] = "socialProfiles";
+    ContactField["IM_ADDRESSES"] = "imAddresses";
+})(ContactField || (ContactField = {}));
+export var ContactsSortOrder;
+(function (ContactsSortOrder) {
+    ContactsSortOrder["UserDefault"] = "userDefault";
+    ContactsSortOrder["GivenName"] = "givenName";
+    ContactsSortOrder["FamilyName"] = "familyName";
+    ContactsSortOrder["None"] = "none";
+})(ContactsSortOrder || (ContactsSortOrder = {}));
+/** @platform ios */
+export var NonGregorianCalendar;
+(function (NonGregorianCalendar) {
+    NonGregorianCalendar["buddhist"] = "buddhist";
+    NonGregorianCalendar["chinese"] = "chinese";
+    NonGregorianCalendar["coptic"] = "coptic";
+    NonGregorianCalendar["ethiopicAmeteMihret"] = "ethiopicAmeteMihret";
+    NonGregorianCalendar["ethiopicAmeteAlem"] = "ethiopicAmeteAlem";
+    NonGregorianCalendar["hebrew"] = "hebrew";
+    NonGregorianCalendar["indian"] = "indian";
+    NonGregorianCalendar["islamic"] = "islamic";
+    NonGregorianCalendar["islamicCivil"] = "islamicCivil";
+    NonGregorianCalendar["japanese"] = "japanese";
+    NonGregorianCalendar["persian"] = "persian";
+    NonGregorianCalendar["republicOfChina"] = "republicOfChina";
+})(NonGregorianCalendar || (NonGregorianCalendar = {}));

package/build/core/group.d.ts

@@ -0,0 +1,5 @@
+declare const Group_base: typeof import("./native-module").NativeGroup;
+/** @platform ios - Android has no Group concept in expo-contacts. */
+export declare class Group extends Group_base {
+}
+export {};

package/build/core/group.js

@@ -0,0 +1,4 @@
+import { expoContactsNext, FallbackGroup } from './native-module.js';
+/** @platform ios - Android has no Group concept in expo-contacts. */
+export class Group extends (expoContactsNext.Group ?? FallbackGroup) {
+}

package/build/core/index.d.ts

@@ -0,0 +1,8 @@
+export * from './enums';
+export * from './types';
+export type { IContactAccessButtonCaption, IContactAccessButtonProps, } from './contact-access-button';
+export { Contact } from './contact';
+export { Group } from './group';
+export { Container } from './container';
+export { getPermissionsAsync, requestPermissionsAsync } from './permissions';
+export { addContactsChangeListener, removeAllContactsChangeListeners, } from './listeners';

package/build/core/index.js

@@ -0,0 +1,7 @@
+export * from './enums.js';
+export * from './types.js';
+export { Contact } from './contact.js';
+export { Group } from './group.js';
+export { Container } from './container.js';
+export { getPermissionsAsync, requestPermissionsAsync } from './permissions.js';
+export { addContactsChangeListener, removeAllContactsChangeListeners, } from './listeners.js';

package/build/core/listeners.d.ts

@@ -0,0 +1,3 @@
+import type { EventSubscription } from 'expo-modules-core';
+export declare function addContactsChangeListener(listener: () => void): EventSubscription;
+export declare function removeAllContactsChangeListeners(): void;

package/build/core/listeners.js

@@ -0,0 +1,11 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import { expoContactsNext, ON_CONTACTS_CHANGE_EVENT_NAME, } from './native-module.js';
+export function addContactsChangeListener(listener) {
+    if (!expoContactsNext.addListener) {
+        throw new UnavailabilityError('Contacts', 'addContactsChangeListener');
+    }
+    return expoContactsNext.addListener(ON_CONTACTS_CHANGE_EVENT_NAME, listener);
+}
+export function removeAllContactsChangeListeners() {
+    expoContactsNext.removeAllListeners?.(ON_CONTACTS_CHANGE_EVENT_NAME);
+}