@livx.cc/native-kit 0.31.1 → 0.32.1

package/package.json

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

package/src/modules/billing/billing.ts

@@ -117,6 +117,27 @@ export class BillingModule {
     return this.kit.invoke('billing.manageSubscriptions');
   }
 
+  /**
+   * iOS 15+ native-only: present StoreKit 2's **in-app** subscription-management sheet
+   * (`AppStore.showManageSubscriptions(in:)`). Unlike {@link manageSubscriptions} (which deep-links
+   * out to the App Store account page, StoreKit 1), this stays inside the app AND shows sandbox /
+   * TestFlight subscriptions — so it's the path to verify/cancel a sub during testing. Opt-in: the
+   * default `manageSubscriptions()` deep-link is unchanged; call this explicitly to use the sheet.
+   *
+   * Throws `UNSUPPORTED` on the web or Android (no StoreKit), and `NATIVE_ERROR` on iOS <15 / no
+   * presentable scene / a StoreKit error. Resolves once the user dismisses the sheet.
+   */
+  async showManageSubscriptionsSheet(): Promise<void> {
+    await this.kit.ready();
+    if (this.capability !== 'native') {
+      throw new KitError('UNSUPPORTED', 'The in-app subscriptions sheet is iOS-only (StoreKit 2). Use manageSubscriptions() on web/Android.');
+    }
+    // The sheet resolves only when the USER dismisses it (seconds to minutes), so the default 10s
+    // invoke timeout would fire mid-sheet and make the caller think it failed → a spurious fallback.
+    // Give it a long window; a dismissed-but-unreported sheet just leaves the promise pending (harmless).
+    return this.kit.invoke('billing.manageSubscriptionsSheet', undefined, { timeoutMs: 600_000 });
+  }
+
   /** Out-of-band transactions (renewals, Ask-to-Buy, cross-device). Native streams only. */
   onTransaction(cb: (receipt: PurchaseReceipt) => void): Unsubscribe {
     return this.kit.on('billing.transaction', (p) => cb(p as PurchaseReceipt));