@cap-kit/people 8.0.0

package/dist/plugin.cjs

@@ -0,0 +1,300 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+/// <reference types="@capacitor/cli" />
+/**
+ * Standardized error codes used by the People plugin.
+ *
+ * These codes are returned when a Promise is rejected and can be caught
+ * via try/catch blocks.
+ *
+ * @since 8.0.0
+ */
+exports.PeopleErrorCode = void 0;
+(function (PeopleErrorCode) {
+    /** The device does not have the requested hardware or the feature is not available on this platform. */
+    PeopleErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+    /** The user cancelled an interactive flow. */
+    PeopleErrorCode["CANCELLED"] = "CANCELLED";
+    /** The user denied the permission or the feature is disabled by the OS. */
+    PeopleErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** The plugin failed to initialize or perform an operation. */
+    PeopleErrorCode["INIT_FAILED"] = "INIT_FAILED";
+    /** The input provided to the plugin method is invalid, missing, or malformed. */
+    PeopleErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    /** The requested type is not valid or supported. */
+    PeopleErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+    /** The requested resource does not exist. */
+    PeopleErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    /** The operation conflicts with the current state. */
+    PeopleErrorCode["CONFLICT"] = "CONFLICT";
+    /** The operation did not complete within the expected time. */
+    PeopleErrorCode["TIMEOUT"] = "TIMEOUT";
+})(exports.PeopleErrorCode || (exports.PeopleErrorCode = {}));
+
+/**
+ * @file index.ts
+ * Main entry point for the People Capacitor Plugin.
+ * This file handles the registration of the plugin with the Capacitor core runtime
+ * and exports all necessary types for consumers.
+ */
+/**
+ * The People plugin instance.
+ * It automatically lazy-loads the web implementation if running in a browser environment.
+ * Use this instance to access all people functionality.
+ */
+const People = core.registerPlugin('People', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.PeopleWeb()),
+});
+
+/**
+ * Class representing the web implementation of the PeoplePlugin.
+ * This class extends the WebPlugin class and implements the PeoplePlugin interface.
+ * It provides a base implementation for web-based functionality of the plugin.
+ */
+class PeopleWeb extends core.WebPlugin {
+    constructor() {
+        super();
+    }
+    // -----------------------------------------------------------------------------
+    // Capabilities
+    // -----------------------------------------------------------------------------
+    /**
+     * Retrieves the capabilities of the People plugin on the web platform.
+     *
+     * @returns A promise resolving to the PeopleCapabilities object.
+     */
+    async getCapabilities() {
+        return {
+            canRead: false, // Web cannot bulk read the address book
+            canWrite: false,
+            canObserve: false,
+            canManageGroups: false,
+            canPickContact: true, // Only the Zero-Permission picker is supported via Contact Picker API
+        };
+    }
+    // -----------------------------------------------------------------------------
+    // Permissions
+    // -----------------------------------------------------------------------------
+    /**
+     * Checks the permission status for the plugin.
+     *
+     * @returns A promise resolving to an object containing the permission states.
+     */
+    async checkPermissions() {
+        return { contacts: 'prompt' };
+    }
+    /**
+     * Requests the necessary permissions for the plugin.
+     *
+     * @returns A promise resolving to an object containing the updated permission states.
+     */
+    async requestPermissions() {
+        return { contacts: 'prompt' };
+    }
+    // -----------------------------------------------------------------------------
+    // Contact Picking
+    // -----------------------------------------------------------------------------
+    /**
+     * Launches the OS contact picker UI.
+     * On Web this uses the Contact Picker API if available.
+     * * Architectural rules:
+     * - Rejects with CANCELLED on user cancellation to match native behavior.
+     */
+    async pickContact(options) {
+        var _a, _b, _c, _d;
+        const contactsNavigator = navigator;
+        const props = (options === null || options === void 0 ? void 0 : options.projection) || ['name', 'phones', 'emails'];
+        const supportedProjection = new Set([
+            'name',
+            'organization',
+            'birthday',
+            'phones',
+            'emails',
+            'addresses',
+            'urls',
+            'note',
+        ]);
+        for (const field of props) {
+            if (!supportedProjection.has(field)) {
+                return Promise.reject({
+                    message: `Unsupported projection field: ${field}`,
+                    code: 'UNKNOWN_TYPE',
+                });
+            }
+        }
+        // Support for the modern Web Contact Picker API
+        if ((_a = contactsNavigator.contacts) === null || _a === void 0 ? void 0 : _a.select) {
+            try {
+                // Marshalling: Map plugin projections to Web API properties
+                const webProps = props.map((p) => {
+                    if (p === 'phones')
+                        return 'tel';
+                    if (p === 'emails')
+                        return 'email';
+                    return p;
+                });
+                const contacts = await contactsNavigator.contacts.select(webProps, { multiple: false });
+                // Some browsers return an empty array instead of throwing on cancel; normalize to CANCELLED.
+                if (!contacts || contacts.length === 0) {
+                    return Promise.reject({
+                        message: 'User cancelled selection',
+                        code: 'CANCELLED',
+                    });
+                }
+                const raw = contacts[0];
+                return {
+                    contact: {
+                        id: 'web-ref',
+                        name: { display: ((_b = raw.name) === null || _b === void 0 ? void 0 : _b[0]) || 'Unknown' },
+                        phones: ((_c = raw.tel) === null || _c === void 0 ? void 0 : _c.map((t) => ({ number: t }))) || [],
+                        emails: ((_d = raw.email) === null || _d === void 0 ? void 0 : _d.map((e) => ({ address: e }))) || [],
+                    },
+                };
+            }
+            catch (e) {
+                const err = e;
+                // Map specific Web API cancellation to the standardized CANCELLED code
+                if (err.name === 'AbortError') {
+                    return Promise.reject({
+                        message: 'User cancelled selection',
+                        code: 'CANCELLED',
+                    });
+                }
+                throw this.unavailable(err.message || 'Web Contact Picker API failed');
+            }
+        }
+        throw this.unavailable('Native Contact Picker not available in this browser.');
+    }
+    // -----------------------------------------------------------------------------
+    // Directory Access (Not supported on Web)
+    // -----------------------------------------------------------------------------
+    /**
+     * Retrieves contacts from the system directory.
+     * @param _options - Options for retrieving contacts.
+     *
+     * @returns A promise resolving to the contacts result.
+     */
+    async getContacts() {
+        throw this.unimplemented('getContacts is not available on Web.');
+    }
+    /**
+     * Retrieves a single contact by ID.
+     * @param _options - Options containing the contact ID.
+     *
+     * @returns A promise resolving to the contact.
+     */
+    async getContact() {
+        throw this.unimplemented('getContact is not available on Web.');
+    }
+    /**
+     * Searches contacts in the system directory.
+     * @param _options - Options for searching contacts.
+     *
+     * @returns A promise resolving to the contacts result.
+     */
+    async searchPeople() {
+        throw this.unimplemented('searchPeople is not available on Web.');
+    }
+    // -----------------------------------------------------------------------------
+    // Group Management (Not supported on Web)
+    // -----------------------------------------------------------------------------
+    /**
+     * Lists all available contact groups.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async listGroups() {
+        throw this.unimplemented('listGroups is not available on Web.');
+    }
+    /**
+     * Creates a new contact group.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async createGroup(_options) {
+        throw this.unimplemented('createGroup is not available on Web.');
+    }
+    /**
+     * Deletes a contact group.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async deleteGroup(_options) {
+        throw this.unimplemented('deleteGroup is not available on Web.');
+    }
+    /**
+     * Adds contacts to a group.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async addPeopleToGroup(_options) {
+        throw this.unimplemented('addPeopleToGroup is not available on Web.');
+    }
+    /**
+     * Removes contacts from a group.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async removePeopleFromGroup(_options) {
+        throw this.unimplemented('removePeopleFromGroup is not available on Web.');
+    }
+    // -----------------------------------------------------------------------------
+    // CRUD (Not supported on Web)
+    // -----------------------------------------------------------------------------
+    /**
+     * Creates a new contact.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async createContact(_options) {
+        throw this.unimplemented('createContact is not available on Web.');
+    }
+    /**
+     * Updates an existing contact.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async updateContact(_options) {
+        throw this.unimplemented('updateContact is not available on Web.');
+    }
+    /**
+     * Deletes a contact.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async deleteContact(_options) {
+        throw this.unimplemented('deleteContact is not available on Web.');
+    }
+    /**
+     * Merges two contacts.
+     * @returns A promise that is rejected because this feature is not available on Web.
+     */
+    async mergeContacts(_options) {
+        throw this.unimplemented('mergeContacts is not available on Web.');
+    }
+    // -----------------------------------------------------------------------------
+    // Plugin Info
+    // -----------------------------------------------------------------------------
+    /**
+     * Returns the plugin version.
+     *
+     * On the Web, this value represents the JavaScript package version
+     * rather than a native implementation.
+     */
+    async getPluginVersion() {
+        return { version: 'web' };
+    }
+    // -----------------------------------------------------------------------------
+    // Listener Handling
+    // -----------------------------------------------------------------------------
+    /**
+     * Cleanup all listeners
+     *
+     * @returns A promise that resolves when all listeners are removed.
+     */
+    async removeAllListeners() {
+        super.removeAllListeners();
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    PeopleWeb: PeopleWeb
+});
+
+exports.People = People;
+//# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n/**\n * Standardized error codes used by the People plugin.\n *\n * These codes are returned when a Promise is rejected and can be caught\n * via try/catch blocks.\n *\n * @since 8.0.0\n */\nexport var PeopleErrorCode;\n(function (PeopleErrorCode) {\n    /** The device does not have the requested hardware or the feature is not available on this platform. */\n    PeopleErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user cancelled an interactive flow. */\n    PeopleErrorCode[\"CANCELLED\"] = \"CANCELLED\";\n    /** The user denied the permission or the feature is disabled by the OS. */\n    PeopleErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The plugin failed to initialize or perform an operation. */\n    PeopleErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The input provided to the plugin method is invalid, missing, or malformed. */\n    PeopleErrorCode[\"INVALID_INPUT\"] = \"INVALID_INPUT\";\n    /** The requested type is not valid or supported. */\n    PeopleErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n    /** The requested resource does not exist. */\n    PeopleErrorCode[\"NOT_FOUND\"] = \"NOT_FOUND\";\n    /** The operation conflicts with the current state. */\n    PeopleErrorCode[\"CONFLICT\"] = \"CONFLICT\";\n    /** The operation did not complete within the expected time. */\n    PeopleErrorCode[\"TIMEOUT\"] = \"TIMEOUT\";\n})(PeopleErrorCode || (PeopleErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","/**\n * @file index.ts\n * Main entry point for the People Capacitor Plugin.\n * This file handles the registration of the plugin with the Capacitor core runtime\n * and exports all necessary types for consumers.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * The People plugin instance.\n * It automatically lazy-loads the web implementation if running in a browser environment.\n * Use this instance to access all people functionality.\n */\nconst People = registerPlugin('People', {\n    web: () => import('./web').then((m) => new m.PeopleWeb()),\n});\nexport * from './definitions';\nexport { People };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Class representing the web implementation of the PeoplePlugin.\n * This class extends the WebPlugin class and implements the PeoplePlugin interface.\n * It provides a base implementation for web-based functionality of the plugin.\n */\nexport class PeopleWeb extends WebPlugin {\n    constructor() {\n        super();\n    }\n    // -----------------------------------------------------------------------------\n    // Capabilities\n    // -----------------------------------------------------------------------------\n    /**\n     * Retrieves the capabilities of the People plugin on the web platform.\n     *\n     * @returns A promise resolving to the PeopleCapabilities object.\n     */\n    async getCapabilities() {\n        return {\n            canRead: false, // Web cannot bulk read the address book\n            canWrite: false,\n            canObserve: false,\n            canManageGroups: false,\n            canPickContact: true, // Only the Zero-Permission picker is supported via Contact Picker API\n        };\n    }\n    // -----------------------------------------------------------------------------\n    // Permissions\n    // -----------------------------------------------------------------------------\n    /**\n     * Checks the permission status for the plugin.\n     *\n     * @returns A promise resolving to an object containing the permission states.\n     */\n    async checkPermissions() {\n        return { contacts: 'prompt' };\n    }\n    /**\n     * Requests the necessary permissions for the plugin.\n     *\n     * @returns A promise resolving to an object containing the updated permission states.\n     */\n    async requestPermissions() {\n        return { contacts: 'prompt' };\n    }\n    // -----------------------------------------------------------------------------\n    // Contact Picking\n    // -----------------------------------------------------------------------------\n    /**\n     * Launches the OS contact picker UI.\n     * On Web this uses the Contact Picker API if available.\n     * * Architectural rules:\n     * - Rejects with CANCELLED on user cancellation to match native behavior.\n     */\n    async pickContact(options) {\n        var _a, _b, _c, _d;\n        const contactsNavigator = navigator;\n        const props = (options === null || options === void 0 ? void 0 : options.projection) || ['name', 'phones', 'emails'];\n        const supportedProjection = new Set([\n            'name',\n            'organization',\n            'birthday',\n            'phones',\n            'emails',\n            'addresses',\n            'urls',\n            'note',\n        ]);\n        for (const field of props) {\n            if (!supportedProjection.has(field)) {\n                return Promise.reject({\n                    message: `Unsupported projection field: ${field}`,\n                    code: 'UNKNOWN_TYPE',\n                });\n            }\n        }\n        // Support for the modern Web Contact Picker API\n        if ((_a = contactsNavigator.contacts) === null || _a === void 0 ? void 0 : _a.select) {\n            try {\n                // Marshalling: Map plugin projections to Web API properties\n                const webProps = props.map((p) => {\n                    if (p === 'phones')\n                        return 'tel';\n                    if (p === 'emails')\n                        return 'email';\n                    return p;\n                });\n                const contacts = await contactsNavigator.contacts.select(webProps, { multiple: false });\n                // Some browsers return an empty array instead of throwing on cancel; normalize to CANCELLED.\n                if (!contacts || contacts.length === 0) {\n                    return Promise.reject({\n                        message: 'User cancelled selection',\n                        code: 'CANCELLED',\n                    });\n                }\n                const raw = contacts[0];\n                return {\n                    contact: {\n                        id: 'web-ref',\n                        name: { display: ((_b = raw.name) === null || _b === void 0 ? void 0 : _b[0]) || 'Unknown' },\n                        phones: ((_c = raw.tel) === null || _c === void 0 ? void 0 : _c.map((t) => ({ number: t }))) || [],\n                        emails: ((_d = raw.email) === null || _d === void 0 ? void 0 : _d.map((e) => ({ address: e }))) || [],\n                    },\n                };\n            }\n            catch (e) {\n                const err = e;\n                // Map specific Web API cancellation to the standardized CANCELLED code\n                if (err.name === 'AbortError') {\n                    return Promise.reject({\n                        message: 'User cancelled selection',\n                        code: 'CANCELLED',\n                    });\n                }\n                throw this.unavailable(err.message || 'Web Contact Picker API failed');\n            }\n        }\n        throw this.unavailable('Native Contact Picker not available in this browser.');\n    }\n    // -----------------------------------------------------------------------------\n    // Directory Access (Not supported on Web)\n    // -----------------------------------------------------------------------------\n    /**\n     * Retrieves contacts from the system directory.\n     * @param _options - Options for retrieving contacts.\n     *\n     * @returns A promise resolving to the contacts result.\n     */\n    async getContacts() {\n        throw this.unimplemented('getContacts is not available on Web.');\n    }\n    /**\n     * Retrieves a single contact by ID.\n     * @param _options - Options containing the contact ID.\n     *\n     * @returns A promise resolving to the contact.\n     */\n    async getContact() {\n        throw this.unimplemented('getContact is not available on Web.');\n    }\n    /**\n     * Searches contacts in the system directory.\n     * @param _options - Options for searching contacts.\n     *\n     * @returns A promise resolving to the contacts result.\n     */\n    async searchPeople() {\n        throw this.unimplemented('searchPeople is not available on Web.');\n    }\n    // -----------------------------------------------------------------------------\n    // Group Management (Not supported on Web)\n    // -----------------------------------------------------------------------------\n    /**\n     * Lists all available contact groups.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async listGroups() {\n        throw this.unimplemented('listGroups is not available on Web.');\n    }\n    /**\n     * Creates a new contact group.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async createGroup(_options) {\n        void _options;\n        throw this.unimplemented('createGroup is not available on Web.');\n    }\n    /**\n     * Deletes a contact group.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async deleteGroup(_options) {\n        void _options;\n        throw this.unimplemented('deleteGroup is not available on Web.');\n    }\n    /**\n     * Adds contacts to a group.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async addPeopleToGroup(_options) {\n        void _options;\n        throw this.unimplemented('addPeopleToGroup is not available on Web.');\n    }\n    /**\n     * Removes contacts from a group.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async removePeopleFromGroup(_options) {\n        void _options;\n        throw this.unimplemented('removePeopleFromGroup is not available on Web.');\n    }\n    // -----------------------------------------------------------------------------\n    // CRUD (Not supported on Web)\n    // -----------------------------------------------------------------------------\n    /**\n     * Creates a new contact.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async createContact(_options) {\n        void _options;\n        throw this.unimplemented('createContact is not available on Web.');\n    }\n    /**\n     * Updates an existing contact.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async updateContact(_options) {\n        void _options;\n        throw this.unimplemented('updateContact is not available on Web.');\n    }\n    /**\n     * Deletes a contact.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async deleteContact(_options) {\n        void _options;\n        throw this.unimplemented('deleteContact is not available on Web.');\n    }\n    /**\n     * Merges two contacts.\n     * @returns A promise that is rejected because this feature is not available on Web.\n     */\n    async mergeContacts(_options) {\n        void _options;\n        throw this.unimplemented('mergeContacts is not available on Web.');\n    }\n    // -----------------------------------------------------------------------------\n    // Plugin Info\n    // -----------------------------------------------------------------------------\n    /**\n     * Returns the plugin version.\n     *\n     * On the Web, this value represents the JavaScript package version\n     * rather than a native implementation.\n     */\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n    // -----------------------------------------------------------------------------\n    // Listener Handling\n    // -----------------------------------------------------------------------------\n    /**\n     * Cleanup all listeners\n     *\n     * @returns A promise that resolves when all listeners are removed.\n     */\n    async removeAllListeners() {\n        super.removeAllListeners();\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["PeopleErrorCode","registerPlugin","WebPlugin"],"mappings":"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"}

package/dist/plugin.js

@@ -0,0 +1,303 @@
+var capacitorPeople = (function (exports, core) {
+    'use strict';
+
+    /// <reference types="@capacitor/cli" />
+    /**
+     * Standardized error codes used by the People plugin.
+     *
+     * These codes are returned when a Promise is rejected and can be caught
+     * via try/catch blocks.
+     *
+     * @since 8.0.0
+     */
+    exports.PeopleErrorCode = void 0;
+    (function (PeopleErrorCode) {
+        /** The device does not have the requested hardware or the feature is not available on this platform. */
+        PeopleErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+        /** The user cancelled an interactive flow. */
+        PeopleErrorCode["CANCELLED"] = "CANCELLED";
+        /** The user denied the permission or the feature is disabled by the OS. */
+        PeopleErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+        /** The plugin failed to initialize or perform an operation. */
+        PeopleErrorCode["INIT_FAILED"] = "INIT_FAILED";
+        /** The input provided to the plugin method is invalid, missing, or malformed. */
+        PeopleErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+        /** The requested type is not valid or supported. */
+        PeopleErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+        /** The requested resource does not exist. */
+        PeopleErrorCode["NOT_FOUND"] = "NOT_FOUND";
+        /** The operation conflicts with the current state. */
+        PeopleErrorCode["CONFLICT"] = "CONFLICT";
+        /** The operation did not complete within the expected time. */
+        PeopleErrorCode["TIMEOUT"] = "TIMEOUT";
+    })(exports.PeopleErrorCode || (exports.PeopleErrorCode = {}));
+
+    /**
+     * @file index.ts
+     * Main entry point for the People Capacitor Plugin.
+     * This file handles the registration of the plugin with the Capacitor core runtime
+     * and exports all necessary types for consumers.
+     */
+    /**
+     * The People plugin instance.
+     * It automatically lazy-loads the web implementation if running in a browser environment.
+     * Use this instance to access all people functionality.
+     */
+    const People = core.registerPlugin('People', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.PeopleWeb()),
+    });
+
+    /**
+     * Class representing the web implementation of the PeoplePlugin.
+     * This class extends the WebPlugin class and implements the PeoplePlugin interface.
+     * It provides a base implementation for web-based functionality of the plugin.
+     */
+    class PeopleWeb extends core.WebPlugin {
+        constructor() {
+            super();
+        }
+        // -----------------------------------------------------------------------------
+        // Capabilities
+        // -----------------------------------------------------------------------------
+        /**
+         * Retrieves the capabilities of the People plugin on the web platform.
+         *
+         * @returns A promise resolving to the PeopleCapabilities object.
+         */
+        async getCapabilities() {
+            return {
+                canRead: false, // Web cannot bulk read the address book
+                canWrite: false,
+                canObserve: false,
+                canManageGroups: false,
+                canPickContact: true, // Only the Zero-Permission picker is supported via Contact Picker API
+            };
+        }
+        // -----------------------------------------------------------------------------
+        // Permissions
+        // -----------------------------------------------------------------------------
+        /**
+         * Checks the permission status for the plugin.
+         *
+         * @returns A promise resolving to an object containing the permission states.
+         */
+        async checkPermissions() {
+            return { contacts: 'prompt' };
+        }
+        /**
+         * Requests the necessary permissions for the plugin.
+         *
+         * @returns A promise resolving to an object containing the updated permission states.
+         */
+        async requestPermissions() {
+            return { contacts: 'prompt' };
+        }
+        // -----------------------------------------------------------------------------
+        // Contact Picking
+        // -----------------------------------------------------------------------------
+        /**
+         * Launches the OS contact picker UI.
+         * On Web this uses the Contact Picker API if available.
+         * * Architectural rules:
+         * - Rejects with CANCELLED on user cancellation to match native behavior.
+         */
+        async pickContact(options) {
+            var _a, _b, _c, _d;
+            const contactsNavigator = navigator;
+            const props = (options === null || options === void 0 ? void 0 : options.projection) || ['name', 'phones', 'emails'];
+            const supportedProjection = new Set([
+                'name',
+                'organization',
+                'birthday',
+                'phones',
+                'emails',
+                'addresses',
+                'urls',
+                'note',
+            ]);
+            for (const field of props) {
+                if (!supportedProjection.has(field)) {
+                    return Promise.reject({
+                        message: `Unsupported projection field: ${field}`,
+                        code: 'UNKNOWN_TYPE',
+                    });
+                }
+            }
+            // Support for the modern Web Contact Picker API
+            if ((_a = contactsNavigator.contacts) === null || _a === void 0 ? void 0 : _a.select) {
+                try {
+                    // Marshalling: Map plugin projections to Web API properties
+                    const webProps = props.map((p) => {
+                        if (p === 'phones')
+                            return 'tel';
+                        if (p === 'emails')
+                            return 'email';
+                        return p;
+                    });
+                    const contacts = await contactsNavigator.contacts.select(webProps, { multiple: false });
+                    // Some browsers return an empty array instead of throwing on cancel; normalize to CANCELLED.
+                    if (!contacts || contacts.length === 0) {
+                        return Promise.reject({
+                            message: 'User cancelled selection',
+                            code: 'CANCELLED',
+                        });
+                    }
+                    const raw = contacts[0];
+                    return {
+                        contact: {
+                            id: 'web-ref',
+                            name: { display: ((_b = raw.name) === null || _b === void 0 ? void 0 : _b[0]) || 'Unknown' },
+                            phones: ((_c = raw.tel) === null || _c === void 0 ? void 0 : _c.map((t) => ({ number: t }))) || [],
+                            emails: ((_d = raw.email) === null || _d === void 0 ? void 0 : _d.map((e) => ({ address: e }))) || [],
+                        },
+                    };
+                }
+                catch (e) {
+                    const err = e;
+                    // Map specific Web API cancellation to the standardized CANCELLED code
+                    if (err.name === 'AbortError') {
+                        return Promise.reject({
+                            message: 'User cancelled selection',
+                            code: 'CANCELLED',
+                        });
+                    }
+                    throw this.unavailable(err.message || 'Web Contact Picker API failed');
+                }
+            }
+            throw this.unavailable('Native Contact Picker not available in this browser.');
+        }
+        // -----------------------------------------------------------------------------
+        // Directory Access (Not supported on Web)
+        // -----------------------------------------------------------------------------
+        /**
+         * Retrieves contacts from the system directory.
+         * @param _options - Options for retrieving contacts.
+         *
+         * @returns A promise resolving to the contacts result.
+         */
+        async getContacts() {
+            throw this.unimplemented('getContacts is not available on Web.');
+        }
+        /**
+         * Retrieves a single contact by ID.
+         * @param _options - Options containing the contact ID.
+         *
+         * @returns A promise resolving to the contact.
+         */
+        async getContact() {
+            throw this.unimplemented('getContact is not available on Web.');
+        }
+        /**
+         * Searches contacts in the system directory.
+         * @param _options - Options for searching contacts.
+         *
+         * @returns A promise resolving to the contacts result.
+         */
+        async searchPeople() {
+            throw this.unimplemented('searchPeople is not available on Web.');
+        }
+        // -----------------------------------------------------------------------------
+        // Group Management (Not supported on Web)
+        // -----------------------------------------------------------------------------
+        /**
+         * Lists all available contact groups.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async listGroups() {
+            throw this.unimplemented('listGroups is not available on Web.');
+        }
+        /**
+         * Creates a new contact group.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async createGroup(_options) {
+            throw this.unimplemented('createGroup is not available on Web.');
+        }
+        /**
+         * Deletes a contact group.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async deleteGroup(_options) {
+            throw this.unimplemented('deleteGroup is not available on Web.');
+        }
+        /**
+         * Adds contacts to a group.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async addPeopleToGroup(_options) {
+            throw this.unimplemented('addPeopleToGroup is not available on Web.');
+        }
+        /**
+         * Removes contacts from a group.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async removePeopleFromGroup(_options) {
+            throw this.unimplemented('removePeopleFromGroup is not available on Web.');
+        }
+        // -----------------------------------------------------------------------------
+        // CRUD (Not supported on Web)
+        // -----------------------------------------------------------------------------
+        /**
+         * Creates a new contact.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async createContact(_options) {
+            throw this.unimplemented('createContact is not available on Web.');
+        }
+        /**
+         * Updates an existing contact.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async updateContact(_options) {
+            throw this.unimplemented('updateContact is not available on Web.');
+        }
+        /**
+         * Deletes a contact.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async deleteContact(_options) {
+            throw this.unimplemented('deleteContact is not available on Web.');
+        }
+        /**
+         * Merges two contacts.
+         * @returns A promise that is rejected because this feature is not available on Web.
+         */
+        async mergeContacts(_options) {
+            throw this.unimplemented('mergeContacts is not available on Web.');
+        }
+        // -----------------------------------------------------------------------------
+        // Plugin Info
+        // -----------------------------------------------------------------------------
+        /**
+         * Returns the plugin version.
+         *
+         * On the Web, this value represents the JavaScript package version
+         * rather than a native implementation.
+         */
+        async getPluginVersion() {
+            return { version: 'web' };
+        }
+        // -----------------------------------------------------------------------------
+        // Listener Handling
+        // -----------------------------------------------------------------------------
+        /**
+         * Cleanup all listeners
+         *
+         * @returns A promise that resolves when all listeners are removed.
+         */
+        async removeAllListeners() {
+            super.removeAllListeners();
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        PeopleWeb: PeopleWeb
+    });
+
+    exports.People = People;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map