@livx.cc/native-kit 0.25.0 → 0.27.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@livx.cc/native-kit",
-  "version": "0.25.0",
-  "description": "Isomorphic native-capabilities kit for PWAs — same API in browser and in an appwrap native shell. Zero dependencies.",
+  "version": "0.27.0",
+  "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",
   "homepage": "https://github.com/Livshitz/appwrap#readme",
@@ -37,7 +37,8 @@
     "src"
   ],
   "scripts": {
-    "build": "bun build src/index.ts --outdir=dist --format=esm && bun build src/index.ts --outfile=dist/native-kit.iife.js --format=iife --global-name=NativeKitLib"
+    "typecheck": "tsc --noEmit",
+    "build": "tsc --noEmit && bun build src/index.ts --outdir=dist --format=esm && bun build src/index.ts --outfile=dist/native-kit.iife.js --format=iife --global-name=NativeKitLib"
   },
   "devDependencies": {
     "typescript": "^5.4.0"

package/src/modules/oauth.ts

@@ -17,7 +17,10 @@ export interface OAuthResult {
 }
 
 /**
- * System-browser OAuth via ASWebAuthenticationSession (iOS). Provider-agnostic by design — the same
+ * System-browser OAuth — iOS ASWebAuthenticationSession / Android Chrome Custom Tabs. The Android
+ * tab returns the provider redirect via the app's urlScheme deep-link path (it doesn't auto-close
+ * like iOS); the shell matches the callbackScheme and resolves with the same { url } shape. A
+ * user-dismissed tab/sheet rejects with code 'CANCELLED'. Provider-agnostic by design — the same
  * philosophy as `kit.push`: the shell owns only the device-side primitive (run the auth handshake in
  * the OS-shared, policy-compliant browser), while the PWA builds the auth URL and does token exchange.
  *
@@ -36,6 +39,9 @@ export class OAuthModule {
   }
 
   authorize(params: OAuthAuthorizeParams): Promise<OAuthResult> {
-    return this.kit.invoke('oauth.authorize', params as unknown as Record<string, unknown>);
+    // 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 });
   }
 }

package/src/modules/reviews.ts

@@ -1,6 +1,8 @@
 import type { NativeKit } from '../core/NativeKit';
 
-/** Store review prompt — iOS SKStoreReviewController. The OS rate-limits display. */
+/** In-app store review prompt — iOS SKStoreReviewController / Android Play In-App Review (opt-in
+ *  `reviews` module). The OS rate-limits display; on Android it only surfaces for a Play-Store-track
+ *  install (a sideload/emulator no-ops without showing UI). Fire-and-forget either way. */
 export class ReviewsModule {
   constructor(private kit: NativeKit) {}
 

package/src/modules/scanner.ts

@@ -53,7 +53,9 @@ export class ScannerModule {
 
   /** Open the scanner; resolve the first code, or `{ cancelled: true }` if dismissed. */
   scan(opts: ScanOptions = {}): Promise<ScanResult | ScanCancelled> {
-    return this.kit.invoke('scanner.scan', opts);
+    // Open-ended: the camera stays up until a code is found or the user cancels — lining up a QR
+    // routinely takes longer than the 10s invoke default, which would abandon the scan mid-aim.
+    return this.kit.invoke('scanner.scan', opts, { timeoutMs: 300_000 });
   }
 
   /** Dismiss an in-progress {@link scan} (its promise then resolves `{ cancelled: true }`). */

package/src/modules/speech.ts

@@ -68,7 +68,9 @@ export class SpeechModule {
 
   /** Speak `text` aloud; resolves when the utterance finishes (or is stopped). */
   speak(text: string, opts: SpeakOptions = {}): Promise<void> {
-    return this.kit.invoke('speech.speak', { text, ...opts });
+    // Resolves only when the utterance (or its queue) finishes — easily exceeds the 10s invoke
+    // default for longer text or back-to-back speak() calls, dropping the result. Give it room.
+    return this.kit.invoke('speech.speak', { text, ...opts }, { timeoutMs: 120_000 });
   }
 
   /** Cancel the current/queued utterance immediately. */
@@ -84,7 +86,9 @@ export class SpeechModule {
   /** Start capturing the mic; resolves the FINAL transcript. With `{ partial:true }`, interim
    *  results stream via {@link onPartial}. Throws `KitError('UNSUPPORTED')` where STT is absent. */
   listen(opts: ListenOptions = {}): Promise<string> {
-    return this.kit.invoke('speech.listen', opts);
+    // Open-ended: resolves on the final result or when stopListening() is called — a person may take
+    // a while to speak, so it must not be cut off by the 10s invoke default.
+    return this.kit.invoke('speech.listen', opts, { timeoutMs: 600_000 });
   }
 
   /** Stop capture early; the pending {@link listen} resolves with the best transcript so far. */