@livx.cc/native-kit 0.18.0 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.18.0",
+  "version": "0.19.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

@@ -337,6 +337,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/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(