@elizaos/capacitor-contacts 2.0.0-beta.1 → 2.0.3-beta.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+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,109 @@
+# @elizaos/capacitor-contacts
+
+Capacitor plugin providing an Android `ContactsContract` bridge for elizaOS agents. Enables reading, creating, and importing contacts on Android from TypeScript/JavaScript code. On web and Node.js the plugin provides an explicit fallback that returns empty contact lists and rejects writes.
+
+## What it does
+
+- **List contacts** — query the device address book with optional text search and result limit.
+- **Create a contact** — insert a new contact with a display name, phone numbers, and email addresses.
+- **Import vCard** — parse RFC 6350 vCard text and bulk-insert the contacts.
+
+## Platform support
+
+| Platform | `listContacts` | `createContact` | `importVCard` |
+|----------|---------------|----------------|---------------|
+| Android  | Full          | Full           | Full          |
+| Web/Node | Returns `[]`  | Throws         | Throws        |
+
+## Requirements
+
+- `@capacitor/core ^8.3.1` in the host app.
+- Android runtime permissions must be granted by the host app:
+  - `READ_CONTACTS` — required for `listContacts`.
+  - `WRITE_CONTACTS` — required for `createContact` and `importVCard`.
+
+The permissions are declared in the plugin's `AndroidManifest.xml` and are merged automatically by the Android build system.
+
+## Installation
+
+```bash
+bun add @elizaos/capacitor-contacts
+```
+
+Then sync Capacitor:
+
+```bash
+npx cap sync android
+```
+
+## Usage
+
+```typescript
+import { Contacts } from "@elizaos/capacitor-contacts";
+
+// List contacts (optionally filtered)
+const { contacts } = await Contacts.listContacts({ query: "Alice", limit: 50 });
+
+// Create a contact
+const { id } = await Contacts.createContact({
+  displayName: "Alice Example",
+  phoneNumber: "+15555550100",
+  emailAddress: "alice@example.com",
+});
+
+// Import from vCard text
+const { imported } = await Contacts.importVCard({ vcardText: myVCardString });
+```
+
+## API
+
+### `listContacts(options?)`
+
+| Option  | Type     | Default | Description |
+|---------|----------|---------|-------------|
+| `query` | `string` | —       | Case-insensitive search across name, phone, and email. |
+| `limit` | `number` | `100`   | Max contacts to return. Must be 1–500. |
+
+Returns `{ contacts: ContactSummary[] }`.
+
+### `createContact(options)`
+
+| Option           | Type       | Required | Description |
+|------------------|------------|----------|-------------|
+| `displayName`    | `string`   | Yes      | Contact display name. |
+| `phoneNumber`    | `string`   | No       | Single phone number (convenience alias). |
+| `phoneNumbers`   | `string[]` | No       | Multiple phone numbers. |
+| `emailAddress`   | `string`   | No       | Single email address (convenience alias). |
+| `emailAddresses` | `string[]` | No       | Multiple email addresses. |
+
+Returns `{ id: string }` (the new contact's `ContactsContract` ID).
+
+### `importVCard(options)`
+
+| Option      | Type     | Required | Description |
+|-------------|----------|----------|-------------|
+| `vcardText` | `string` | Yes      | Raw vCard text (vCard 2.1 / 3.0 / 4.0). |
+
+Parses `FN`, `N`, `TEL`, and `EMAIL` fields. Photo data is not imported. Returns `{ imported: ImportedContactSummary[] }`.
+
+### `ContactSummary`
+
+```typescript
+interface ContactSummary {
+  id: string;
+  lookupKey: string;
+  displayName: string;
+  phoneNumbers: string[];
+  emailAddresses: string[];
+  photoUri?: string;
+  starred: boolean;
+}
+```
+
+## Building
+
+```bash
+bun run --cwd plugins/plugin-native-contacts build
+```
+
+Runs TypeScript compilation and Rollup to produce `dist/esm/` (ESM) and `dist/plugin.cjs.js` (CJS).

package/android/build.gradle

@@ -3,6 +3,11 @@ ext {
 }
 
 apply plugin: 'com.android.library'
+// Apply the Kotlin Android plugin so the plugin's .kt class is bundled into the
+// library AAR. Without it AGP's built-in kotlinc compiles the sources but does
+// NOT bundle the .class files, so the Capacitor plugin class is absent from the
+// app dex at runtime (PluginLoadException -> the whole plugin set fails to load).
+apply plugin: 'org.jetbrains.kotlin.android'
 android {
     namespace = "ai.eliza.plugins.contacts"
     compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
@@ -14,6 +19,9 @@ android {
         sourceCompatibility JavaVersion.VERSION_17
         targetCompatibility JavaVersion.VERSION_17
     }
+    kotlinOptions {
+        jvmTarget = "17"
+    }
 }
 
 repositories {

package/android/src/main/java/ai/eliza/plugins/contacts/ContactsPlugin.kt

@@ -9,8 +9,25 @@ import com.getcapacitor.Plugin
 import com.getcapacitor.PluginCall
 import com.getcapacitor.PluginMethod
 import com.getcapacitor.annotation.CapacitorPlugin
+import com.getcapacitor.annotation.Permission
 
-@CapacitorPlugin(name = "ElizaContacts")
+// Declares the `contacts` alias so the Capacitor base Plugin auto-provides
+// checkPermissions()/requestPermissions() — the app can REQUEST contacts access
+// on first use of the Contacts feature instead of only rejecting (which forced
+// the user to grant it from system Settings). Nothing requests this at launch;
+// it is feature-gated to the Contacts view.
+@CapacitorPlugin(
+    name = "ElizaContacts",
+    permissions = [
+        Permission(
+            alias = "contacts",
+            strings = [
+                Manifest.permission.READ_CONTACTS,
+                Manifest.permission.WRITE_CONTACTS,
+            ],
+        ),
+    ],
+)
 class ContactsPlugin : Plugin() {
     @PluginMethod
     fun listContacts(call: PluginCall) {

package/dist/esm/definitions.d.ts

@@ -1,3 +1,4 @@
+import type { PermissionState } from "@capacitor/core";
 export interface ContactSummary {
     id: string;
     lookupKey: string;
@@ -7,6 +8,10 @@ export interface ContactSummary {
     photoUri?: string;
     starred: boolean;
 }
+/** Runtime permission state for the contacts (READ/WRITE_CONTACTS) alias. */
+export interface ContactsPermissionStatus {
+    contacts: PermissionState;
+}
 export interface ListContactsOptions {
     query?: string;
     limit?: number;
@@ -34,5 +39,10 @@ export interface ContactsPlugin {
     importVCard(options: ImportVCardOptions): Promise<{
         imported: ImportedContactSummary[];
     }>;
+    /** Current contacts (READ/WRITE_CONTACTS) permission state. Web: granted. */
+    checkPermissions(): Promise<ContactsPermissionStatus>;
+    /** Prompt for contacts access (no-op grant on web). Feature-gated; never
+     *  requested at launch. */
+    requestPermissions(): Promise<ContactsPermissionStatus>;
 }
 //# sourceMappingURL=definitions.d.ts.map

package/dist/esm/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAChD,QAAQ,EAAE,sBAAsB,EAAE,CAAC;KACpC,CAAC,CAAC;CACJ"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAChD,QAAQ,EAAE,sBAAsB,EAAE,CAAC;KACpC,CAAC,CAAC;IACH,6EAA6E;IAC7E,gBAAgB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACtD;+BAC2B;IAC3B,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACzD"}

package/dist/esm/web.d.ts

@@ -1,14 +1,16 @@
 import { WebPlugin } from "@capacitor/core";
-import type { ContactSummary, ContactsPlugin, CreateContactOptions, ImportedContactSummary, ImportVCardOptions, ListContactsOptions } from "./definitions";
+import type { ContactsPermissionStatus, ContactSummary, ContactsPlugin, CreateContactOptions, ImportedContactSummary, ImportVCardOptions, ListContactsOptions } from "./definitions";
 export declare class ContactsWeb extends WebPlugin implements ContactsPlugin {
-    listContacts(_options?: ListContactsOptions): Promise<{
+    listContacts(options?: ListContactsOptions): Promise<{
         contacts: ContactSummary[];
     }>;
-    createContact(_options: CreateContactOptions): Promise<{
+    createContact(options: CreateContactOptions): Promise<{
         id: string;
     }>;
-    importVCard(_options: ImportVCardOptions): Promise<{
+    importVCard(options: ImportVCardOptions): Promise<{
         imported: ImportedContactSummary[];
     }>;
+    checkPermissions(): Promise<ContactsPermissionStatus>;
+    requestPermissions(): Promise<ContactsPermissionStatus>;
 }
 //# sourceMappingURL=web.d.ts.map

package/dist/esm/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB,qBAAa,WAAY,SAAQ,SAAU,YAAW,cAAc;IAC5D,YAAY,CAChB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAIpC,aAAa,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAItE,WAAW,CACf,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAA;KAAE,CAAC;CAGnD"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AA8BvB,qBAAa,WAAY,SAAQ,SAAU,YAAW,cAAc;IAC5D,YAAY,CAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAKpC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAKrE,WAAW,CACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAA;KAAE,CAAC;IAO5C,gBAAgB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAIrD,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC;CAG9D"}

package/dist/esm/web.js

@@ -1,13 +1,49 @@
 import { WebPlugin } from "@capacitor/core";
+function normalizeLimit(limit) {
+    if (limit === undefined)
+        return undefined;
+    if (typeof limit !== "number" || !Number.isFinite(limit)) {
+        throw new Error("limit must be between 1 and 500");
+    }
+    const normalized = Math.trunc(limit);
+    if (normalized < 1 || normalized > 500) {
+        throw new Error("limit must be between 1 and 500");
+    }
+    return normalized;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function validateCreateContactOptions(options) {
+    if (!nonEmptyString(options?.displayName)) {
+        throw new Error("displayName is required");
+    }
+}
+function validateImportVCardOptions(options) {
+    if (!nonEmptyString(options?.vcardText)) {
+        throw new Error("vcardText is required");
+    }
+}
 export class ContactsWeb extends WebPlugin {
-    async listContacts(_options) {
+    async listContacts(options) {
+        normalizeLimit(options?.limit);
         return { contacts: [] };
     }
-    async createContact(_options) {
+    async createContact(options) {
+        validateCreateContactOptions(options);
         throw new Error("Contacts are only available on Android.");
     }
-    async importVCard(_options) {
+    async importVCard(options) {
+        validateImportVCardOptions(options);
         throw new Error("Contact imports are only available on Android.");
     }
+    // Web has no contacts permission model; report granted so the shared view
+    // flow proceeds (listContacts then returns an empty list on web).
+    async checkPermissions() {
+        return { contacts: "granted" };
+    }
+    async requestPermissions() {
+        return { contacts: "granted" };
+    }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAW5C,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC,KAAK,CAAC,YAAY,CAChB,QAA8B;QAE9B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAA8B;QAChD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,WAAW,CACf,QAA4B;QAE5B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;CACF"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,4BAA4B,CAAC,OAA6B;IACjE,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,OAA2B;IAC7D,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC,KAAK,CAAC,YAAY,CAChB,OAA6B;QAE7B,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAA6B;QAC/C,4BAA4B,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAA2B;QAE3B,0BAA0B,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,0EAA0E;IAC1E,kEAAkE;IAClE,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/esm/web.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web.test.d.ts.map

package/dist/esm/web.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.test.d.ts","sourceRoot":"","sources":["../../src/web.test.ts"],"names":[],"mappings":""}

package/dist/esm/web.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, it } from "vitest";
+import { ContactsWeb } from "./web";
+describe("ContactsWeb fallback", () => {
+    it.each([
+        0,
+        -1,
+        501,
+        Number.POSITIVE_INFINITY,
+        Number.NaN,
+    ])("rejects malformed listContacts limit %s", async (limit) => {
+        const contacts = new ContactsWeb();
+        await expect(contacts.listContacts({ limit })).rejects.toThrow("limit must be between 1 and 500");
+    });
+    it("returns an empty contact list for valid web fallback queries", async () => {
+        const contacts = new ContactsWeb();
+        await expect(contacts.listContacts({ limit: 25.9, query: "../../ada" })).resolves.toEqual({ contacts: [] });
+    });
+    it("rejects malformed create/import payloads before Android-only fallback errors", async () => {
+        const contacts = new ContactsWeb();
+        await expect(contacts.createContact({ displayName: " \t\n " })).rejects.toThrow("displayName is required");
+        await expect(contacts.createContact({
+            displayName: ["Ada Lovelace"],
+        })).rejects.toThrow("displayName is required");
+        await expect(contacts.importVCard({ vcardText: "" })).rejects.toThrow("vcardText is required");
+        await expect(contacts.importVCard({
+            vcardText: { text: "BEGIN:VCARD" },
+        })).rejects.toThrow("vcardText is required");
+        await expect(contacts.createContact({ displayName: "Ada Lovelace" })).rejects.toThrow("Contacts are only available on Android.");
+        await expect(contacts.importVCard({ vcardText: "BEGIN:VCARD\nFN:Ada\nEND:VCARD" })).rejects.toThrow("Contact imports are only available on Android.");
+    });
+});
+//# sourceMappingURL=web.test.js.map

package/dist/esm/web.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.test.js","sourceRoot":"","sources":["../../src/web.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,IAAI,CAAC;QACN,CAAC;QACD,CAAC,CAAC;QACF,GAAG;QACH,MAAM,CAAC,iBAAiB;QACxB,MAAM,CAAC,GAAG;KACX,CAAC,CAAC,yCAAyC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC5D,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAEnC,MAAM,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC5D,iCAAiC,CAClC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAEnC,MAAM,MAAM,CACV,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAC3D,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAEnC,MAAM,MAAM,CACV,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAClD,CAAC,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC7C,MAAM,MAAM,CACV,QAAQ,CAAC,aAAa,CAAC;YACrB,WAAW,EAAE,CAAC,cAAc,CAAsB;SACnD,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC7C,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACnE,uBAAuB,CACxB,CAAC;QACF,MAAM,MAAM,CACV,QAAQ,CAAC,WAAW,CAAC;YACnB,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAuB;SACxD,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC3C,MAAM,MAAM,CACV,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CACxD,CAAC,OAAO,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;QAC7D,MAAM,MAAM,CACV,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,gCAAgC,EAAE,CAAC,CACtE,CAAC,OAAO,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/plugin.cjs.js

@@ -7,16 +7,52 @@ const Contacts = core.registerPlugin("ElizaContacts", {
     web: loadWeb,
 });
 
+function normalizeLimit(limit) {
+    if (limit === undefined)
+        return undefined;
+    if (typeof limit !== "number" || !Number.isFinite(limit)) {
+        throw new Error("limit must be between 1 and 500");
+    }
+    const normalized = Math.trunc(limit);
+    if (normalized < 1 || normalized > 500) {
+        throw new Error("limit must be between 1 and 500");
+    }
+    return normalized;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function validateCreateContactOptions(options) {
+    if (!nonEmptyString(options?.displayName)) {
+        throw new Error("displayName is required");
+    }
+}
+function validateImportVCardOptions(options) {
+    if (!nonEmptyString(options?.vcardText)) {
+        throw new Error("vcardText is required");
+    }
+}
 class ContactsWeb extends core.WebPlugin {
-    async listContacts(_options) {
+    async listContacts(options) {
+        normalizeLimit(options?.limit);
         return { contacts: [] };
     }
-    async createContact(_options) {
+    async createContact(options) {
+        validateCreateContactOptions(options);
         throw new Error("Contacts are only available on Android.");
     }
-    async importVCard(_options) {
+    async importVCard(options) {
+        validateImportVCardOptions(options);
         throw new Error("Contact imports are only available on Android.");
     }
+    // Web has no contacts permission model; report granted so the shared view
+    // flow proceeds (listContacts then returns an empty list on web).
+    async checkPermissions() {
+        return { contacts: "granted" };
+    }
+    async requestPermissions() {
+        return { contacts: "granted" };
+    }
 }
 
 var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.ContactsWeb());\nexport const Contacts = registerPlugin(\"ElizaContacts\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class ContactsWeb extends WebPlugin {\n    async listContacts(_options) {\n        return { contacts: [] };\n    }\n    async createContact(_options) {\n        throw new Error(\"Contacts are only available on Android.\");\n    }\n    async importVCard(_options) {\n        throw new Error(\"Contact imports are only available on Android.\");\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1D,MAAC,QAAQ,GAAGA,mBAAc,CAAC,eAAe,EAAE;AACxD,IAAI,GAAG,EAAE,OAAO;AAChB,CAAC;;ACJM,MAAM,WAAW,SAASC,cAAS,CAAC;AAC3C,IAAI,MAAM,YAAY,CAAC,QAAQ,EAAE;AACjC,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;AAC/B,IAAI;AACJ,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE;AAClC,QAAQ,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC;AAClE,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;AAChC,QAAQ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;AACzE,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.ContactsWeb());\nexport const Contacts = registerPlugin(\"ElizaContacts\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nfunction normalizeLimit(limit) {\n    if (limit === undefined)\n        return undefined;\n    if (typeof limit !== \"number\" || !Number.isFinite(limit)) {\n        throw new Error(\"limit must be between 1 and 500\");\n    }\n    const normalized = Math.trunc(limit);\n    if (normalized < 1 || normalized > 500) {\n        throw new Error(\"limit must be between 1 and 500\");\n    }\n    return normalized;\n}\nfunction nonEmptyString(value) {\n    return typeof value === \"string\" ? value.trim() : \"\";\n}\nfunction validateCreateContactOptions(options) {\n    if (!nonEmptyString(options?.displayName)) {\n        throw new Error(\"displayName is required\");\n    }\n}\nfunction validateImportVCardOptions(options) {\n    if (!nonEmptyString(options?.vcardText)) {\n        throw new Error(\"vcardText is required\");\n    }\n}\nexport class ContactsWeb extends WebPlugin {\n    async listContacts(options) {\n        normalizeLimit(options?.limit);\n        return { contacts: [] };\n    }\n    async createContact(options) {\n        validateCreateContactOptions(options);\n        throw new Error(\"Contacts are only available on Android.\");\n    }\n    async importVCard(options) {\n        validateImportVCardOptions(options);\n        throw new Error(\"Contact imports are only available on Android.\");\n    }\n    // Web has no contacts permission model; report granted so the shared view\n    // flow proceeds (listContacts then returns an empty list on web).\n    async checkPermissions() {\n        return { contacts: \"granted\" };\n    }\n    async requestPermissions() {\n        return { contacts: \"granted\" };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1D,MAAC,QAAQ,GAAGA,mBAAc,CAAC,eAAe,EAAE;AACxD,IAAI,GAAG,EAAE,OAAO;AAChB,CAAC;;ACJD,SAAS,cAAc,CAAC,KAAK,EAAE;AAC/B,IAAI,IAAI,KAAK,KAAK,SAAS;AAC3B,QAAQ,OAAO,SAAS;AACxB,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AAC9D,QAAQ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;AAC1D,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;AACxC,IAAI,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE;AAC5C,QAAQ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;AAC1D,IAAI;AACJ,IAAI,OAAO,UAAU;AACrB;AACA,SAAS,cAAc,CAAC,KAAK,EAAE;AAC/B,IAAI,OAAO,OAAO,KAAK,KAAK,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE;AACxD;AACA,SAAS,4BAA4B,CAAC,OAAO,EAAE;AAC/C,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;AAC/C,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ;AACA,SAAS,0BAA0B,CAAC,OAAO,EAAE;AAC7C,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE;AAC7C,QAAQ,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;AAChD,IAAI;AACJ;AACO,MAAM,WAAW,SAASC,cAAS,CAAC;AAC3C,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;AAChC,QAAQ,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC;AACtC,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;AAC/B,IAAI;AACJ,IAAI,MAAM,aAAa,CAAC,OAAO,EAAE;AACjC,QAAQ,4BAA4B,CAAC,OAAO,CAAC;AAC7C,QAAQ,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC;AAClE,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;AAC/B,QAAQ,0BAA0B,CAAC,OAAO,CAAC;AAC3C,QAAQ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;AACzE,IAAI;AACJ;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE;AACtC,IAAI;AACJ,IAAI,MAAM,kBAAkB,GAAG;AAC/B,QAAQ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE;AACtC,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -6,16 +6,52 @@ var capacitorContacts = (function (exports, core) {
         web: loadWeb,
     });
 
+    function normalizeLimit(limit) {
+        if (limit === undefined)
+            return undefined;
+        if (typeof limit !== "number" || !Number.isFinite(limit)) {
+            throw new Error("limit must be between 1 and 500");
+        }
+        const normalized = Math.trunc(limit);
+        if (normalized < 1 || normalized > 500) {
+            throw new Error("limit must be between 1 and 500");
+        }
+        return normalized;
+    }
+    function nonEmptyString(value) {
+        return typeof value === "string" ? value.trim() : "";
+    }
+    function validateCreateContactOptions(options) {
+        if (!nonEmptyString(options?.displayName)) {
+            throw new Error("displayName is required");
+        }
+    }
+    function validateImportVCardOptions(options) {
+        if (!nonEmptyString(options?.vcardText)) {
+            throw new Error("vcardText is required");
+        }
+    }
     class ContactsWeb extends core.WebPlugin {
-        async listContacts(_options) {
+        async listContacts(options) {
+            normalizeLimit(options?.limit);
             return { contacts: [] };
         }
-        async createContact(_options) {
+        async createContact(options) {
+            validateCreateContactOptions(options);
             throw new Error("Contacts are only available on Android.");
         }
-        async importVCard(_options) {
+        async importVCard(options) {
+            validateImportVCardOptions(options);
             throw new Error("Contact imports are only available on Android.");
         }
+        // Web has no contacts permission model; report granted so the shared view
+        // flow proceeds (listContacts then returns an empty list on web).
+        async checkPermissions() {
+            return { contacts: "granted" };
+        }
+        async requestPermissions() {
+            return { contacts: "granted" };
+        }
     }
 
     var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.ContactsWeb());\nexport const Contacts = registerPlugin(\"ElizaContacts\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class ContactsWeb extends WebPlugin {\n    async listContacts(_options) {\n        return { contacts: [] };\n    }\n    async createContact(_options) {\n        throw new Error(\"Contacts are only available on Android.\");\n    }\n    async importVCard(_options) {\n        throw new Error(\"Contact imports are only available on Android.\");\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1D,UAAC,QAAQ,GAAGA,mBAAc,CAAC,eAAe,EAAE;IACxD,IAAI,GAAG,EAAE,OAAO;IAChB,CAAC;;ICJM,MAAM,WAAW,SAASC,cAAS,CAAC;IAC3C,IAAI,MAAM,YAAY,CAAC,QAAQ,EAAE;IACjC,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC/B,IAAI;IACJ,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE;IAClC,QAAQ,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC;IAClE,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;IAChC,QAAQ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;IACzE,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.ContactsWeb());\nexport const Contacts = registerPlugin(\"ElizaContacts\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nfunction normalizeLimit(limit) {\n    if (limit === undefined)\n        return undefined;\n    if (typeof limit !== \"number\" || !Number.isFinite(limit)) {\n        throw new Error(\"limit must be between 1 and 500\");\n    }\n    const normalized = Math.trunc(limit);\n    if (normalized < 1 || normalized > 500) {\n        throw new Error(\"limit must be between 1 and 500\");\n    }\n    return normalized;\n}\nfunction nonEmptyString(value) {\n    return typeof value === \"string\" ? value.trim() : \"\";\n}\nfunction validateCreateContactOptions(options) {\n    if (!nonEmptyString(options?.displayName)) {\n        throw new Error(\"displayName is required\");\n    }\n}\nfunction validateImportVCardOptions(options) {\n    if (!nonEmptyString(options?.vcardText)) {\n        throw new Error(\"vcardText is required\");\n    }\n}\nexport class ContactsWeb extends WebPlugin {\n    async listContacts(options) {\n        normalizeLimit(options?.limit);\n        return { contacts: [] };\n    }\n    async createContact(options) {\n        validateCreateContactOptions(options);\n        throw new Error(\"Contacts are only available on Android.\");\n    }\n    async importVCard(options) {\n        validateImportVCardOptions(options);\n        throw new Error(\"Contact imports are only available on Android.\");\n    }\n    // Web has no contacts permission model; report granted so the shared view\n    // flow proceeds (listContacts then returns an empty list on web).\n    async checkPermissions() {\n        return { contacts: \"granted\" };\n    }\n    async requestPermissions() {\n        return { contacts: \"granted\" };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1D,UAAC,QAAQ,GAAGA,mBAAc,CAAC,eAAe,EAAE;IACxD,IAAI,GAAG,EAAE,OAAO;IAChB,CAAC;;ICJD,SAAS,cAAc,CAAC,KAAK,EAAE;IAC/B,IAAI,IAAI,KAAK,KAAK,SAAS;IAC3B,QAAQ,OAAO,SAAS;IACxB,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;IAC9D,QAAQ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;IAC1D,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IACxC,IAAI,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE;IAC5C,QAAQ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;IAC1D,IAAI;IACJ,IAAI,OAAO,UAAU;IACrB;IACA,SAAS,cAAc,CAAC,KAAK,EAAE;IAC/B,IAAI,OAAO,OAAO,KAAK,KAAK,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE;IACxD;IACA,SAAS,4BAA4B,CAAC,OAAO,EAAE;IAC/C,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;IAC/C,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ;IACA,SAAS,0BAA0B,CAAC,OAAO,EAAE;IAC7C,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE;IAC7C,QAAQ,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC;IAChD,IAAI;IACJ;IACO,MAAM,WAAW,SAASC,cAAS,CAAC;IAC3C,IAAI,MAAM,YAAY,CAAC,OAAO,EAAE;IAChC,QAAQ,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC;IACtC,QAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC/B,IAAI;IACJ,IAAI,MAAM,aAAa,CAAC,OAAO,EAAE;IACjC,QAAQ,4BAA4B,CAAC,OAAO,CAAC;IAC7C,QAAQ,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC;IAClE,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;IAC/B,QAAQ,0BAA0B,CAAC,OAAO,CAAC;IAC3C,QAAQ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;IACzE,IAAI;IACJ;IACA;IACA,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE;IACtC,IAAI;IACJ,IAAI,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE;IACtC,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/capacitor-contacts",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.3",
   "description": "Android ContactsContract bridge for ElizaOS.",
   "main": "./dist/plugin.cjs.js",
   "module": "./dist/esm/index.js",
@@ -8,6 +8,8 @@
   "exports": {
     ".": {
       "types": "./dist/esm/index.d.ts",
+      "bun": "./src/index.ts",
+      "development": "./src/index.ts",
       "import": "./dist/esm/index.js",
       "require": "./dist/plugin.cjs.js"
     },
@@ -20,9 +22,11 @@
     "dist"
   ],
   "scripts": {
-    "build": "bun run clean && tsc && bun --bun rollup -c rollup.config.mjs",
-    "clean": "node ../../../scripts/rm-path-recursive.mjs dist",
-    "prepublishOnly": "bun run build"
+    "build": "node ../../packages/scripts/with-package-build-lock.mjs plugins/plugin-native-contacts -- bun run build:unlocked",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
+    "test": "vitest run",
+    "prepublishOnly": "bun run build",
+    "build:unlocked": "bun run clean && tsc && bunx rollup -c rollup.config.mjs"
   },
   "license": "MIT",
   "capacitor": {
@@ -31,11 +35,10 @@
     }
   },
   "devDependencies": {
-    "@capacitor/cli": "^8.0.0",
     "@capacitor/core": "^8.3.1",
-    "rimraf": "^6.0.0",
     "rollup": "^4.60.2",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.0"
   },
   "peerDependencies": {
     "@capacitor/core": "^8.3.1"
@@ -53,5 +56,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "gitHead": "f54b0f4eaed317d59fa7dbcdce20f4cdb0734420"
 }