@livx.cc/native-kit 0.19.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Isomorphic native-capabilities kit for PWAs — same API in browser and in an appwrap native shell. Zero dependencies.",
   "license": "MIT",
   "author": "Elya Livshitz",

package/src/core/web-adapter.ts

@@ -297,6 +297,9 @@ export class WebAdapter implements NativeKitAdapter {
         return { picked: true, name: c.name?.[0], phones: c.tel, emails: c.email } as T;
       }
 
+      case 'contacts.getAll':
+        throw new KitError('UNSUPPORTED', 'No bulk contacts read on web — use contacts.pick');
+
       case 'calendar.createEvent':
         throw new KitError('UNSUPPORTED', 'No calendar access on web');
 

package/src/modules/contacts.ts

@@ -7,6 +7,12 @@ export interface PickedContact {
   emails?: string[];
 }
 
+export interface Contact {
+  name?: string;
+  phones?: string[];
+  emails?: string[];
+}
+
 /** Contact picker — native: CNContactPicker (no permission needed); web: Contact Picker API where present. */
 export class ContactsModule {
   constructor(private kit: NativeKit) {}
@@ -19,4 +25,9 @@ export class ContactsModule {
   pick(): Promise<PickedContact> {
     return this.kit.invoke('contacts.pick', undefined, { timeoutMs: 120_000 });
   }
+
+  /** Read the full address book; native-only (requires permission), unsupported on web. */
+  getAll(): Promise<{ contacts: Contact[] }> {
+    return this.kit.invoke('contacts.getAll', undefined, { timeoutMs: 120_000 });
+  }
 }