@livx.cc/native-kit 0.18.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.18.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');
 
@@ -337,6 +340,7 @@ export class WebAdapter implements NativeKitAdapter {
       case 'billing.purchase':
       case 'billing.restore':
       case 'billing.entitlements':
+      case 'billing.appReceipt':
       case 'billing.manageSubscriptions':
         throw new KitError('UNSUPPORTED', 'No in-app purchases on web — use a web checkout');
 

package/src/modules/billing/billing.ts

@@ -79,6 +79,26 @@ export class BillingModule {
     return out;
   }
 
+  /**
+   * Confirm entitlements **silently** from the on-device App Store receipt — no Apple-ID
+   * prompt and no `restore()` round-trip (unlike {@link restore}/{@link entitlements} on
+   * StoreKit 1). For an in-place update of the SAME bundle id the receipt already holds the
+   * user's active/grandfathered subscriptions, so this is the zero-user-action path for
+   * migrating existing subscribers into a new build.
+   *
+   * Native iOS only, and only meaningful with a **server validator** (the bare receipt has no
+   * product id — a client-trusted validator can't interpret it). Resolves `[]` on the web,
+   * on Android (no StoreKit-1 receipt), or when no receipt is present (e.g. a dev build).
+   */
+  async entitlementsFromReceipt(): Promise<Entitlement[]> {
+    await this.kit.ready();
+    if (this.capability !== 'native') return []; // web, or a shell with no native store handler (Android today)
+    if (this.validator instanceof ClientTrustedValidator) return []; // bare receipt has no product id → would grant a bogus active entitlement; needs a server validator
+    const receipt = await this.kit.invoke<PurchaseReceipt>('billing.appReceipt');
+    if (!receipt?.appReceipt) return [];
+    return this.validator.validate(receipt); // server-of-record turns the receipt into entitlements
+  }
+
   /** Current entitlements from the configured server-of-record (web provider or validator). */
   async entitlements(): Promise<Entitlement[]> {
     await this.kit.ready();

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 });
+  }
 }

package/src/modules/updates.ts

@@ -44,6 +44,9 @@ export class UpdatesModule {
   private timer: ReturnType<typeof setInterval> | null = null;
   private unsubs: Unsubscribe[] = [];
   private listeners = new Set<(s: UpdateStatus) => void>();
+  /** The auto banner is shown at most once per JS session — so a dismissed prompt doesn't nag on
+   * every poll. A reload (the intended response) boots a fresh bundle/context and resets this; until
+   * then, {@link onAvailable} listeners still fire each check so an app can re-surface it itself. */
   private prompted = false;
 
   constructor(private kit: NativeKit) {}
@@ -110,7 +113,7 @@ export class UpdatesModule {
       this.stop(/* keepStarted */ true);
     }
     this.started = true;
-    // A reload picks up the new bundle → allow a fresh prompt next time.
+    // Re-check whenever the app returns to the foreground (catches a deploy made while backgrounded).
     this.unsubs.push(this.kit.on('app.resume', () => void this.check()));
     // Banner tap (or any 'appwrap.update' action) → reload.
     this.unsubs.push(