@livx.cc/native-kit 0.32.0 → 0.32.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.32.0",
+  "version": "0.32.3",
   "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/core/appwrap-adapter.ts

@@ -45,6 +45,12 @@ export class AppwrapAdapter implements NativeKitAdapter {
     return this.request<T>(method, params, opts?.timeoutMs ?? 10_000);
   }
 
+  /** `'none'` or `0` → no watchdog (dismiss-bound calls); otherwise the deadline in ms. */
+  private static resolveTimeout(timeoutMs: number | 'none'): number | null {
+    if (timeoutMs === 'none' || timeoutMs === 0) return null;
+    return timeoutMs;
+  }
+
   on(event: string, cb: (payload: unknown) => void): Unsubscribe {
     let set = this.listeners.get(event);
     if (!set) this.listeners.set(event, (set = new Set()));
@@ -52,14 +58,17 @@ export class AppwrapAdapter implements NativeKitAdapter {
     return () => set!.delete(cb);
   }
 
-  private request<T>(method: string, params: unknown, timeoutMs: number): Promise<T> {
+  private request<T>(method: string, params: unknown, timeoutMs: number | 'none'): Promise<T> {
     const id = `k${++this.seq}`;
     const envelope: RequestEnvelope = { v: 1, id, kind: 'request', method, params };
+    const deadline = AppwrapAdapter.resolveTimeout(timeoutMs);
     return new Promise<T>((resolve, reject) => {
-      const timer = setTimeout(() => {
+      // `null` deadline = dismiss-bound call: no watchdog, resolves only on the
+      // native response (e.g. the user closes the sheet).
+      const timer = deadline === null ? undefined : setTimeout(() => {
         this.pending.delete(id);
-        reject(new KitError('TIMEOUT', `${method} timed out after ${timeoutMs}ms`));
-      }, timeoutMs);
+        reject(new KitError('TIMEOUT', `${method} timed out after ${deadline}ms`));
+      }, deadline);
       this.pending.set(id, {
         resolve: (v) => { clearTimeout(timer); resolve(v as T); },
         reject: (e) => { clearTimeout(timer); reject(e); },

package/src/core/types.ts

@@ -71,9 +71,19 @@ export class KitError extends Error {
 export type Unsubscribe = () => void;
 
 export interface InvokeOptions {
-  /** Per-call response deadline. Interactive flows (pickers, dialogs, auth
-   * prompts) should pass a generous one — the user may take their time. */
-  timeoutMs?: number;
+  /** Per-call response deadline (default 10_000ms).
+   *
+   * Interactive flows (pickers, dialogs, auth prompts) should pass a generous
+   * value — the user may take their time.
+   *
+   * Pass `'none'` (or `0`) to DISABLE the watchdog entirely. Use this ONLY for
+   * dismiss-bound / present-and-wait calls: native UI that resolves solely when
+   * the user dismisses a sheet/modal (manage-subscriptions sheet,
+   * ASWebAuthenticationSession, share sheet, …). For these there is no
+   * meaningful deadline — a watchdog could only false-timeout mid-interaction
+   * and force a spurious fallback. Do NOT use it for fire-and-fast calls: a
+   * finite timeout is what surfaces a real native hang. */
+  timeoutMs?: number | 'none';
 }
 
 export interface NativeKitAdapter {

package/src/modules/billing/billing.ts

@@ -132,7 +132,9 @@ export class BillingModule {
     if (this.capability !== 'native') {
       throw new KitError('UNSUPPORTED', 'The in-app subscriptions sheet is iOS-only (StoreKit 2). Use manageSubscriptions() on web/Android.');
     }
-    return this.kit.invoke('billing.manageSubscriptionsSheet');
+    // Dismiss-bound: resolves only when the USER closes the sheet (no meaningful deadline).
+    // A watchdog could only false-timeout mid-sheet → spurious fallback, so disable it.
+    return this.kit.invoke('billing.manageSubscriptionsSheet', undefined, { timeoutMs: 'none' });
   }
 
   /** Out-of-band transactions (renewals, Ask-to-Buy, cross-device). Native streams only. */

package/src/modules/oauth.ts

@@ -39,9 +39,9 @@ export class OAuthModule {
   }
 
   authorize(params: OAuthAuthorizeParams): Promise<OAuthResult> {
-    // Long timeout: a real sign-in (password + 2FA + consent in the system browser) easily exceeds
-    // the 10s invoke default — without this the kit abandons the request id before the redirect
-    // returns and the login is silently dropped. Matches the other interactive flows (pickers 120s).
-    return this.kit.invoke('oauth.authorize', params as unknown as Record<string, unknown>, { timeoutMs: 300_000 });
+    // Dismiss-bound: the ASWebAuthenticationSession / Custom Tab resolves only when the user
+    // finishes (password + 2FA + consent) or cancels — there is no meaningful deadline. A watchdog
+    // would abandon the request id before the redirect returns and silently drop the login.
+    return this.kit.invoke('oauth.authorize', params as unknown as Record<string, unknown>, { timeoutMs: 'none' });
   }
 }

package/src/modules/push.ts

@@ -9,6 +9,11 @@ export type PushPlatform = 'apns' | 'fcm';
 export interface PushToken {
   platform: PushPlatform;
   token: string;
+  /** The app's bundle/package id. On iOS this is the APNs `apns-topic` your backend MUST send
+   * (APNs rejects a mismatch with `DeviceTokenNotForTopic`); on Android it's the package id —
+   * informational, since FCM doesn't use apns-topic. Optional: absent on web / un-provisioned
+   * builds and older shells that don't supply it (a missing topic is tolerated). */
+  topic?: string;
 }
 
 /** A remote message surfaced to the page. `data` is the sender's custom payload; `title`/`body`
@@ -27,8 +32,9 @@ export interface PushMessage {
  * ```ts
  * if (kit.push.capability === 'native') {
  *   if (await kit.push.requestPermission() === 'granted') {
- *     const { platform, token } = await kit.push.register();
- *     await fetch('/api/push/register', { method:'POST', body: JSON.stringify({ platform, token }) });
+ *     const { platform, token, topic } = await kit.push.register();
+ *     // `topic` = the iOS bundle id → your backend sets it as the APNs apns-topic header.
+ *     await fetch('/api/push/register', { method:'POST', body: JSON.stringify({ platform, token, topic }) });
  *   }
  *   kit.push.onMessage((m) => …);   // foreground delivery
  *   kit.push.onTap((m) => …);       // user opened a notification